org.glassfish.appclient.server.core

Class NestedAppClientDeployerHelper

java.lang.Object

org.glassfish.appclient.server.core.AppClientDeployerHelper

org.glassfish.appclient.server.core.NestedAppClientDeployerHelper

public class NestedAppClientDeployerHelper
extends AppClientDeployerHelper

Nested Class Summary

Nested classes/interfaces inherited from class org.glassfish.appclient.server.core.AppClientDeployerHelper

AppClientDeployerHelper.Proxy

Field Summary

Fields inherited from class org.glassfish.appclient.server.core.AppClientDeployerHelper

ACC_MAIN_LOGGER, archivist, LOG_MESSAGE_RESOURCE

Method Summary

Modifier and Type	Method and Description
protected void	addClientPolicyFiles(OutputJarArchive clientFacadeArchive) Adds the client policy files to the top-level generated JAR.
protected void	addTopLevelContentToClientFacade(OutputJarArchive facadeArchive)
URI	appClientServerOriginalAnchor(DeploymentContext dc) Returns the URI on the server to the original location of the app client.
URI	appClientServerURI(DeploymentContext dc) Returns the URI to the server's copy of the developer's original app client JAR.
URI	appClientURIWithinApp(DeploymentContext dc) Returns the URI within the enclosing app of the app client JAR.
URI	appClientUserURI(DeploymentContext dc) Returns the URI to the developer's original app client JAR within the download directory the user specifies in "deploy --retrieve" or "get-client-stubs."
URI	appClientUserURIForFacade(DeploymentContext dc) Returns the URI to be used for the GlassFish-AppClient manifest entry in the facade.
String	appLibraryExtensions()
protected Set<Artifacts.FullAndPartURIs>	clientLevelDownloads()
protected void	copyFileToTopLevelJAR(OutputJarArchive clientFacadeArchive, File f, String path) Adds a file to the EAR-level group facade JAR.
void	createAndAddLibraryJNLPs(AppClientDeployerHelper helper, TokenHelper tHelper, Map<String,DynamicContent> dynamicContent)
Set<Artifacts.FullAndPartURIs>	earLevelDownloads()
protected String	facadeClassPath() Returns the class path to be stored in the manifest for the generated facade JAR file.
protected String	facadeFileNameAndType(DeploymentContext dc) Returns the file name (and type) for the facade, excluding any directory information.
URI	facadeServerURI(DeploymentContext dc) Returns the URI to the server's copy of the facade JAR file.
URI	facadeUserURI(DeploymentContext dc) Returns the URI for the facade JAR, relative to the download directory to which the user will fetch the relevant JARs (either as part of "deploy --retrieve" or "get-client-stubs."
FixedContent	fixedContentWithinEAR(String uriString) Returns a FixedContent object for the file, within the EAR, at the specified relative location.
URI	groupFacadeServerURI(DeploymentContext dc)
URI	groupFacadeUserURI(DeploymentContext dc) Returns the URI for the group facade JAR, relative to the download directory to which the user will fetch the relevant JARs (either as part of "deploy --retrieve" or "get-client-stubs."
String	pathToAppclientWithinApp(DeploymentContext dc) Returns the relative path to the app client within the enclosing app.
protected void	prepareJARs()
protected String	PUScanTargets()
File	rootForSignedFilesInApp() Returns the root directory for signed files in the applications.
ApplicationSignedJARManager	signedJARManager()
Map<String,Map<URI,StaticContent>>	signingAliasToJar()
URI	URIWithinAppDir(DeploymentContext dc, URI absoluteURI) Returns a relative URI within the app directory for the specified absolute URI.

Methods inherited from class org.glassfish.appclient.server.core.AppClientDeployerHelper

appClientDesc, appName, appName, clientName, dc, generateAppClientFacade, openByteCodeStream, relativeURIToGroupFacade

Methods inherited from class java.lang.Object

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

Method Detail

prepareJARs

protected void prepareJARs()
                    throws IOException,
                           URISyntaxException

Overrides:

prepareJARs in class AppClientDeployerHelper

Throws:

IOException

URISyntaxException

addTopLevelContentToClientFacade

protected void addTopLevelContentToClientFacade(OutputJarArchive facadeArchive)
                                         throws IOException

Specified by:

addTopLevelContentToClientFacade in class AppClientDeployerHelper

Throws:

IOException

fixedContentWithinEAR

public FixedContent fixedContentWithinEAR(String uriString)

Description copied from class: AppClientDeployerHelper

Returns a FixedContent object for the file, within the EAR, at the specified relative location.

Specified by:

fixedContentWithinEAR in class AppClientDeployerHelper

Parameters:

uriString - relative path within the EAR

Returns:

FixedContent object for the file

appLibraryExtensions

public String appLibraryExtensions()

signingAliasToJar

public Map<String,Map<URI,StaticContent>> signingAliasToJar()

Overrides:

signingAliasToJar in class AppClientDeployerHelper

createAndAddLibraryJNLPs

public void createAndAddLibraryJNLPs(AppClientDeployerHelper helper,
                                     TokenHelper tHelper,
                                     Map<String,DynamicContent> dynamicContent)
                              throws IOException

Specified by:

createAndAddLibraryJNLPs in class AppClientDeployerHelper

Throws:

IOException

earLevelDownloads

public Set<Artifacts.FullAndPartURIs> earLevelDownloads()

Specified by:

earLevelDownloads in class AppClientDeployerHelper

rootForSignedFilesInApp

public File rootForSignedFilesInApp()

Description copied from class: AppClientDeployerHelper

Returns the root directory for signed files in the applications.

Specified by:

rootForSignedFilesInApp in class AppClientDeployerHelper

Returns:

File object for the signed JAR root directory

signedJARManager

public ApplicationSignedJARManager signedJARManager()

Overrides:

signedJARManager in class AppClientDeployerHelper

copyFileToTopLevelJAR

protected void copyFileToTopLevelJAR(OutputJarArchive clientFacadeArchive,
                                     File f,
                                     String path)
                              throws IOException

Adds a file to the EAR-level group facade JAR.

Specified by:

copyFileToTopLevelJAR in class AppClientDeployerHelper

Parameters:

clientFacadeArchive - - ignored for nested app clients

Throws:

IOException

addClientPolicyFiles

protected void addClientPolicyFiles(OutputJarArchive clientFacadeArchive)
                             throws IOException

Description copied from class: AppClientDeployerHelper

Adds the client policy files to the top-level generated JAR.

For a stand-alone client (not in an EAR) this implementation adds the policy files to the generated app client facade JAR.

Overrides:

addClientPolicyFiles in class AppClientDeployerHelper

Parameters:

clientFacadeArchive - the generated app client facade JAR

Throws:

IOException

facadeServerURI

public URI facadeServerURI(DeploymentContext dc)

Description copied from class: AppClientDeployerHelper

Returns the URI to the server's copy of the facade JAR file.

Specified by:

facadeServerURI in class AppClientDeployerHelper

Parameters:

dc - the deployment context for the current deployment

Returns:

clientLevelDownloads

protected Set<Artifacts.FullAndPartURIs> clientLevelDownloads()
                                                       throws IOException

Specified by:

clientLevelDownloads in class AppClientDeployerHelper

Throws:

IOException

facadeClassPath

protected String facadeClassPath()

Description copied from class: AppClientDeployerHelper

Returns the class path to be stored in the manifest for the generated facade JAR file.

Specified by:

facadeClassPath in class AppClientDeployerHelper

Returns:

PUScanTargets

protected String PUScanTargets()

Specified by:

PUScanTargets in class AppClientDeployerHelper

facadeUserURI

public URI facadeUserURI(DeploymentContext dc)

Description copied from class: AppClientDeployerHelper

Returns the URI for the facade JAR, relative to the download directory to which the user will fetch the relevant JARs (either as part of "deploy --retrieve" or "get-client-stubs."

Specified by:

facadeUserURI in class AppClientDeployerHelper

Parameters:

dc - the deployment context for the current deployment

Returns:

groupFacadeUserURI

public URI groupFacadeUserURI(DeploymentContext dc)

Description copied from class: AppClientDeployerHelper

Returns the URI for the group facade JAR, relative to the download directory to which the user will fetch the relevant JARs (either as part of "deploy --retrieve" or "get-client-stubs."

Specified by:

groupFacadeUserURI in class AppClientDeployerHelper

Parameters:

dc - the deployment context for the current deployment

Returns:

groupFacadeServerURI

public URI groupFacadeServerURI(DeploymentContext dc)

Specified by:

groupFacadeServerURI in class AppClientDeployerHelper

facadeFileNameAndType

protected String facadeFileNameAndType(DeploymentContext dc)

Description copied from class: AppClientDeployerHelper

Returns the file name (and type) for the facade, excluding any directory information.

Specified by:

facadeFileNameAndType in class AppClientDeployerHelper

Parameters:

dc - the deployment context for the current deployment

Returns:

appClientUserURI

public URI appClientUserURI(DeploymentContext dc)

Description copied from class: AppClientDeployerHelper

Returns the URI to the developer's original app client JAR within the download directory the user specifies in "deploy --retrieve" or "get-client-stubs."

Specified by:

appClientUserURI in class AppClientDeployerHelper

Returns:

appClientUserURIForFacade

public URI appClientUserURIForFacade(DeploymentContext dc)

Description copied from class: AppClientDeployerHelper

Returns the URI to be used for the GlassFish-AppClient manifest entry in the facade.

Specified by:

appClientUserURIForFacade in class AppClientDeployerHelper

Returns:

appClientServerURI

public URI appClientServerURI(DeploymentContext dc)

Description copied from class: AppClientDeployerHelper

Returns the URI to the server's copy of the developer's original app client JAR.

Specified by:

appClientServerURI in class AppClientDeployerHelper

Returns:

appClientServerOriginalAnchor

public URI appClientServerOriginalAnchor(DeploymentContext dc)

Description copied from class: AppClientDeployerHelper

Returns the URI on the server to the original location of the app client.

This is distinct from the appClientServerURI which could be in the generated directory (in the case of a directory deployment, for example). In some cases we need the original location of the app client on the server (for example, to resolve relative references from the app client JAR's manifest Class-Path).

Specified by:

appClientServerOriginalAnchor in class AppClientDeployerHelper

Returns:

appClientURIWithinApp

public URI appClientURIWithinApp(DeploymentContext dc)

Description copied from class: AppClientDeployerHelper

Returns the URI within the enclosing app of the app client JAR. Stand-alone app clients are considered to lie within an "implied" containing app; the URI for such app clients is just the file name and type. The URI for nested app clients within an EAR is the module URI to the app client.

Specified by:

appClientURIWithinApp in class AppClientDeployerHelper

Returns:

URIWithinAppDir

public URI URIWithinAppDir(DeploymentContext dc,
                           URI absoluteURI)

Description copied from class: AppClientDeployerHelper

Returns a relative URI within the app directory for the specified absolute URI.

Specified by:

URIWithinAppDir in class AppClientDeployerHelper

Returns:

pathToAppclientWithinApp

public String pathToAppclientWithinApp(DeploymentContext dc)

Description copied from class: AppClientDeployerHelper

Returns the relative path to the app client within the enclosing app. The result will be an empty string for a stand-alone app clients because it has no such path, in reality. The result will be the relative URI within the EAR for a nested app client.

Specified by:

pathToAppclientWithinApp in class AppClientDeployerHelper

Returns: