org.glassfish.appclient.client

Class AppClientFacade

java.lang.Object

org.glassfish.appclient.client.AppClientFacade

public class AppClientFacade
extends Object

Author:

tjquinn

Constructor Summary

Constructors

Constructor and Description
AppClientFacade()

Method Summary

Modifier and Type	Method and Description
static AppClientContainer	acc()
static void	launch(String[] args)
static void	main(String[] args) Prepares the ACC (if not already done by the agent) and then transfers control to the ACC.
static void	prepareACC(String agentArgsText, Instrumentation inst)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AppClientFacade

public AppClientFacade()

Method Detail

main

public static void main(String[] args)

Prepares the ACC (if not already done by the agent) and then transfers control to the ACC.

Eventually, the Java runtime will invoke this method as the main method of the application, whether or not the command line specified the Java agent. If the agent has already run, then it will have prepared the ACC already. If the agent has not already run, then this method prepares it.

If the user has run the generated app client JAR directly - not using the appclient script - then the Java runtime will invoke this method directly and the command-line arguments should be intended for the client only; no agent or ACC settings are possible. If the user has used the appclient script, then the script will have created a Java command which specifies the agent, constructs an agent argument string, and passes as command line arguments only those values which should be passed to the client. The net result is that, no matter how the app client was launched, the args array contains only the arguments that are for the client's consumption, without any agent or ACC arguments.

Parameters:

args - the command line arguments

acc

public static AppClientContainer acc()

launch

public static void launch(String[] args)
                   throws NoSuchMethodException,
                          ClassNotFoundException,
                          IllegalAccessException,
                          IllegalArgumentException,
                          InvocationTargetException,
                          IOException,
                          SAXParseException,
                          InjectionException,
                          UserError

Throws:

NoSuchMethodException

ClassNotFoundException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

IOException

SAXParseException

InjectionException

UserError

prepareACC

public static void prepareACC(String agentArgsText,
                              Instrumentation inst)
                       throws UserError,
                              MalformedURLException,
                              URISyntaxException,
                              JAXBException,
                              FileNotFoundException,
                              ParserConfigurationException,
                              SAXException,
                              IOException,
                              Exception

Throws:

UserError

MalformedURLException

URISyntaxException

JAXBException

FileNotFoundException

ParserConfigurationException

SAXException

IOException

Exception