All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.glassfish.appclient.client.acc.CommandLaunchInfo Maven / Gradle / Ivy

There is a newer version: 4.1.2.181
Show newest version
/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright (c) 1997-2012 Oracle and/or its affiliates. All rights reserved.
 *
 * The contents of this file are subject to the terms of either the GNU
 * General Public License Version 2 only ("GPL") or the Common Development
 * and Distribution License("CDDL") (collectively, the "License").  You
 * may not use this file except in compliance with the License.  You can
 * obtain a copy of the License at
 * https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
 * or packager/legal/LICENSE.txt.  See the License for the specific
 * language governing permissions and limitations under the License.
 *
 * When distributing the software, include this License Header Notice in each
 * file and include the License file at packager/legal/LICENSE.txt.
 *
 * GPL Classpath Exception:
 * Oracle designates this particular file as subject to the "Classpath"
 * exception as provided by Oracle in the GPL Version 2 section of the License
 * file that accompanied this code.
 *
 * Modifications:
 * If applicable, add the following below the License Header, with the fields
 * enclosed by brackets [] replaced by your own identifying information:
 * "Portions Copyright [year] [name of copyright owner]"
 *
 * Contributor(s):
 * If you wish your version of this file to be governed by only the CDDL or
 * only the GPL Version 2, indicate your decision by adding "[Contributor]
 * elects to include this software in this distribution under the [CDDL or GPL
 * Version 2] license."  If you don't indicate a single choice of license, a
 * recipient has the option to distribute your version of this file under
 * either the CDDL, the GPL Version 2 or to extend the choice of license to
 * its licensees as provided above.  However, if you add GPL Version 2 code
 * and therefore, elected the GPL Version 2 license, then the option applies
 * only if the new code is made subject to such option by the copyright
 * holder.
 */

package org.glassfish.appclient.client.acc;

import java.util.List;

/**
 * Encapsulates all the details of handling the ACC agent arguments.
 * 

* The agent accepts agent arguments, mostly to find out: *

    *
  • what type of client * the user specified (JAR, directory, class, or class file) and the path or * name for the file, and *
  • the appclient command arguments from the appclient command. *
* Each word that is an appclient script argument appears in the agent * arguments as "arg=..." which distinguishes them from arguments intended * directly for the agent. Note that the appclient script does not pass * through the user's -client xxx option and value. Instead it passes * client=... intended for the agent (note the lack of the - sign). * * @author tjquinn */ public class CommandLaunchInfo { /* agent argument names */ private static final String CLIENT_AGENT_ARG_NAME = "client"; private static final String APPCPATH = "appcpath"; /* records the type of launch the user requested: jar, directory, class, or class file*/ private ClientLaunchType clientLaunchType; /* records the client JAR file path, directory path, class name, or class file path */ private String clientName; private String appcPath = null; // /** // * Creates and returns a new CommandLaunchInfo instance. // *

// * Typically the caller is the agent which will pass the agent arguments // * it received when the VM invoked its premain method. // * // * @param agentArgs string of agent arguments // * @return new CommandLaunchInfo object // */ // public static CommandLaunchInfo newInstance(final String agentArgs) throws UserError { // CommandLaunchInfo result = new CommandLaunchInfo(agentArgs); // return result; // } public static CommandLaunchInfo newInstance(final AgentArguments agentArgs) throws UserError { final CommandLaunchInfo result = new CommandLaunchInfo(agentArgs); return result; } private CommandLaunchInfo(final AgentArguments agentArgs) throws UserError { clientLaunchType = saveArgInfo(agentArgs); } /** * Returns the name part of the client selection expression. This can be * the file path to a JAR, a file path to a directory, the fully-qualified * class name for the main class, or the file path to a .class file. * * @return the name */ public String getClientName() { return clientName; } /** * Returns which type of launch the user has triggered given the combination * of options he or she specified. * @return */ public ClientLaunchType getClientLaunchType() { return clientLaunchType; } public String getAppcPath() { return appcPath; } private ClientLaunchType saveArgInfo( final AgentArguments agentArgs) throws UserError { if (agentArgs == null){ return ClientLaunchType.UNKNOWN; } ClientLaunchType result = ClientLaunchType.UNKNOWN; String s; if ((s = lastFromList(agentArgs.namedValues(CLIENT_AGENT_ARG_NAME))) != null) { result = processClientArg(s); } if ((s = lastFromList(agentArgs.namedValues(APPCPATH))) != null) { processAppcPath(s); } return result; } private String lastFromList(final List list) { return (list.isEmpty() ? null : list.get(list.size() - 1)); } private ClientLaunchType processClientArg(final String clientSpec) { /* * We are in the process of handling the agent argument * "client=(type)=(value). clientSpec contains (type)=(value). */ final int equalsSign = clientSpec.indexOf('='); final String clientType = clientSpec.substring(0, equalsSign); clientName = clientSpec.substring(equalsSign + 1); if (clientName.startsWith("\"") && clientName.endsWith("\"")) { clientName = clientName.substring(1, clientName.length() - 1); } ClientLaunchType type = ClientLaunchType.byType(clientType); return type; } private void processAppcPath(final String appcPath) { this.appcPath = appcPath; } /** * Represents the types of client launches. */ public enum ClientLaunchType { JAR, DIR(true), CLASSFILE(true), CLASS, URL, UNKNOWN; private final boolean usesAppClientCommandForMainProgram; ClientLaunchType() { this(false); } ClientLaunchType(final boolean usesAppClientCommandForMainProgram) { this.usesAppClientCommandForMainProgram = usesAppClientCommandForMainProgram; } boolean usesAppClientCommandForMainProgram() { return usesAppClientCommandForMainProgram; } /** * Returns the ClientLaunchType for the specified launch type name. * @param lowerCaseType launch type name (in lower-case) * @return relevant ClientLaunchType for the type; null if no match */ static ClientLaunchType byType(final String lowerCaseType) { for (ClientLaunchType t : values()) { if (t.name().equalsIgnoreCase(lowerCaseType)) { return t; } } return UNKNOWN; } } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy