com.sun.enterprise.deployment.archivist

Class AppClientArchivist

java.lang.Object

com.sun.enterprise.deployment.archivist.Archivist<ApplicationClientDescriptor>

com.sun.enterprise.deployment.archivist.AppClientArchivist

Direct Known Subclasses:

ACCAppClientArchivist

@Service
 @PerLookup
public class AppClientArchivist
extends Archivist<ApplicationClientDescriptor>

This class is responsible for handling J2EE app client files.

Author:

Sheetal Vartak

Field Summary

Fields

Modifier and Type	Field and Description
static Attributes.Name	GLASSFISH_ANCHOR_DIR
static Attributes.Name	GLASSFISH_APPCLIENT
static Attributes.Name	GLASSFISH_CLIENT_PU_SCAN_TARGETS_NAME
static Attributes.Name	GLASSFISH_GROUP_FACADE

Fields inherited from class com.sun.enterprise.deployment.archivist.Archivist

annotationProcessingRequested, APPCLIENT_EXTENSION, APPLICATION_EXTENSION, classLoader, confDDFiles, CONNECTOR_EXTENSION, descriptor, EJB_EXTENSION, extensionsArchivists, habitat, handleRuntimeInfo, locator, logger, manifest, MANIFEST_VERSION_VALUE, path, standardDD, UPLOAD_EXTENSION, WEB_EXTENSION, WEB_FRAGMENT_EXTENSION

Constructor Summary

Constructors

Constructor and Description
AppClientArchivist() Creates new ApplicationClientArchvisit

Method Summary

Modifier and Type	Method and Description
protected String	getArchiveExtension()
List<ConfigurationDeploymentDescriptorFile>	getConfigurationDDFiles()
ApplicationClientDescriptor	getDefaultBundleDescriptor()
String	getMainClassName(Manifest m)
ArchiveType	getModuleType()
DeploymentDescriptorFile<ApplicationClientDescriptor>	getStandardDDFile()
ApplicationClientDescriptor	open(ReadableArchive archive, String mainClassNameToRun)
protected boolean	postHandles(ReadableArchive archive) Returns true if this archivist is capable of handling the archive type Here we check for the existence of the deployment descriptors
protected void	postOpen(ApplicationClientDescriptor descriptor, ReadableArchive archive) perform any post deployment descriptor reading action
protected void	postStandardDDsRead(ApplicationClientDescriptor descriptor, ReadableArchive archive, Map<ExtensionsArchivist,RootDeploymentDescriptor> extensions) perform any action after all standard DDs is read
void	setDescriptor(Application application)
void	validate(ClassLoader aClassLoader) validates the DOL Objects associated with this archivist, usually it requires that a class loader being set on this archivist or passed as a parameter
protected void	writeContents(ReadableArchive in, WritableArchive out, Vector entriesToSkip) writes the content of an archive to a JarFile

Methods inherited from class com.sun.enterprise.deployment.archivist.Archivist

addFileToArchive, copyAnEntry, copyExtraElements, copyInto, copyInto, copyInto, copyInto, copyInto, copyJarElements, copyStandardDeploymentDescriptors, createModuleDescriptor, extractEntry, getAllWebservicesDeploymentDescriptorPaths, getAnnotationErrorHandler, getClassLoader, getClassPath, getDeploymentDescriptorPath, getDescriptor, getExtensionArchivists, getLibraries, getListOfFilesToSkip, getManifest, getPath, getRuntimeDeploymentDescriptorPath, getRuntimeXMLValidation, getRuntimeXMLValidationLevel, getScanner, getTempFile, getTempFile, getUniqueEntryFilenameFor, getXMLValidation, getXMLValidationLevel, handles, hasRuntimeDeploymentDescriptor, hasStandardDeploymentDescriptor, initializeContext, isAnnotationProcessingRequested, isHandlingRuntimeInfo, isProcessAnnotation, open, open, open, open, open, open, openWith, performOptionalPkgDependenciesCheck, postAnnotationProcess, postRuntimeDDsRead, postValidate, printDescriptor, processAnnotations, processAnnotations, readAnnotations, readAnnotations, readMetaInfo, readRuntimeDeploymentDescriptor, readRuntimeDeploymentDescriptor, readStandardDeploymentDescriptor, renameTmp, setAnnotationErrorHandler, setAnnotationProcessingRequested, setArchiveUri, setClassLoader, setClassPath, setDescriptor, setExtensionArchivists, setHandleRuntimeInfo, setManifest, setModuleDescriptor, setRuntimeXMLValidation, setRuntimeXMLValidationLevel, setXMLValidation, setXMLValidationLevel, write, write, write, write, writeContents, writeContents, writeDeploymentDescriptors, writeExtensionDeploymentDescriptors, writeRuntimeDeploymentDescriptors, writeStandardDeploymentDescriptors

Methods inherited from class java.lang.Object

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

Field Detail

GLASSFISH_APPCLIENT

public static final Attributes.Name GLASSFISH_APPCLIENT

GLASSFISH_CLIENT_PU_SCAN_TARGETS_NAME

public static final Attributes.Name GLASSFISH_CLIENT_PU_SCAN_TARGETS_NAME

GLASSFISH_GROUP_FACADE

public static final Attributes.Name GLASSFISH_GROUP_FACADE

GLASSFISH_ANCHOR_DIR

public static final Attributes.Name GLASSFISH_ANCHOR_DIR

Constructor Detail

AppClientArchivist

public AppClientArchivist()

Creates new ApplicationClientArchvisit

Method Detail

getModuleType

public ArchiveType getModuleType()

Specified by:

getModuleType in class Archivist<ApplicationClientDescriptor>

Returns:

the module type handled by this archivist as defined in the application DTD

open

public ApplicationClientDescriptor open(ReadableArchive archive,
                                        String mainClassNameToRun)
                                 throws IOException,
                                        SAXParseException

Throws:

IOException

SAXParseException

setDescriptor

public void setDescriptor(Application application)

getStandardDDFile

public DeploymentDescriptorFile<ApplicationClientDescriptor> getStandardDDFile()

Specified by:

getStandardDDFile in class Archivist<ApplicationClientDescriptor>

Returns:

the DeploymentDescriptorFile responsible for handling standard deployment descriptor

getConfigurationDDFiles

public List<ConfigurationDeploymentDescriptorFile> getConfigurationDDFiles()

Specified by:

getConfigurationDDFiles in class Archivist<ApplicationClientDescriptor>

Returns:

the list of the DeploymentDescriptorFile responsible for handling the configuration deployment descriptors

getDefaultBundleDescriptor

public ApplicationClientDescriptor getDefaultBundleDescriptor()

Specified by:

getDefaultBundleDescriptor in class Archivist<ApplicationClientDescriptor>

Returns:

a default BundleDescriptor for this archivist

validate

public void validate(ClassLoader aClassLoader)

validates the DOL Objects associated with this archivist, usually it requires that a class loader being set on this archivist or passed as a parameter

Overrides:

validate in class Archivist<ApplicationClientDescriptor>

postStandardDDsRead

protected void postStandardDDsRead(ApplicationClientDescriptor descriptor,
                                   ReadableArchive archive,
                                   Map<ExtensionsArchivist,RootDeploymentDescriptor> extensions)
                            throws IOException

perform any action after all standard DDs is read

Overrides:

postStandardDDsRead in class Archivist<ApplicationClientDescriptor>

Parameters:

descriptor - the deployment descriptor for the module

archive - the module archive

extensions - map of extension archivists

Throws:

IOException

postOpen

protected void postOpen(ApplicationClientDescriptor descriptor,
                        ReadableArchive archive)
                 throws IOException

perform any post deployment descriptor reading action

Overrides:

postOpen in class Archivist<ApplicationClientDescriptor>

Parameters:

descriptor - the deployment descriptor for the module

archive - the module archive

Throws:

IOException

writeContents

protected void writeContents(ReadableArchive in,
                             WritableArchive out,
                             Vector entriesToSkip)
                      throws IOException

writes the content of an archive to a JarFile

Overrides:

writeContents in class Archivist<ApplicationClientDescriptor>

Parameters:

in - the input archive

out - the archive output stream to write to

entriesToSkip - the files to not write from the original archive

Throws:

IOException

getMainClassName

public String getMainClassName(Manifest m)

Returns:

the manifest attribute Main-class

postHandles

protected boolean postHandles(ReadableArchive archive)
                       throws IOException

Description copied from class: Archivist

Returns true if this archivist is capable of handling the archive type Here we check for the existence of the deployment descriptors

Specified by:

postHandles in class Archivist<ApplicationClientDescriptor>

Returns:

true if the archivist is handling the provided archive

Throws:

IOException

getArchiveExtension

protected String getArchiveExtension()

Specified by:

getArchiveExtension in class Archivist<ApplicationClientDescriptor>

Returns:

The archive extension handled by a specific archivist