org.glassfish.appclient.server.core.jws

Class ExtensionFileManager

java.lang.Object

org.glassfish.appclient.server.core.jws.ExtensionFileManager

All Implemented Interfaces:

org.glassfish.hk2.api.PostConstruct

@Service
 @Singleton
public class ExtensionFileManager
extends Object
implements org.glassfish.hk2.api.PostConstruct

Manages a data structure of all extension jars known to the app server.

This class builds a map of extension name to an instance of the inner class Extension that records information about that extension jar. An Extension is created for every jar file in any of the directories specified by java.ext.dirs.

Later, a caller can use the findExtensionTransitiveClosure method, passing a jar file manifest's main attributes and receiving back a List of Extension objects representing all extension jars referenced directly or indirectly from that jar.

Author:

tjquinn

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ExtensionFileManager.Extension Records information about an extension jar file known to the app server.
static class	ExtensionFileManager.ExtensionKey The key for identifying extension jar Extension objects in the Map.

Field Summary

Fields

Modifier and Type	Field and Description
static String	EXT_ERROR

Constructor Summary

Constructors

Constructor and Description
ExtensionFileManager()

Method Summary

Modifier and Type	Method and Description
Set<ExtensionFileManager.Extension>	findExtensionTransitiveClosure(File origAnchorDir, Attributes mainAttrs) Constructs a List of Extension objects corresponding to jars required to satisfy an extension chain.
Map<ExtensionFileManager.ExtensionKey,ExtensionFileManager.Extension>	getExtensionFileEntries()
void	postConstruct()

Methods inherited from class java.lang.Object

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

Field Detail

EXT_ERROR

public static final String EXT_ERROR

See Also:

Constant Field Values

Constructor Detail

ExtensionFileManager

public ExtensionFileManager()

Method Detail

postConstruct

public void postConstruct()

Specified by:

postConstruct in interface org.glassfish.hk2.api.PostConstruct

getExtensionFileEntries

public Map<ExtensionFileManager.ExtensionKey,ExtensionFileManager.Extension> getExtensionFileEntries()
                                                                                              throws IOException

Throws:

IOException

findExtensionTransitiveClosure

public Set<ExtensionFileManager.Extension> findExtensionTransitiveClosure(File origAnchorDir,
                                                                          Attributes mainAttrs)
                                                                   throws IOException

Constructs a List of Extension objects corresponding to jars required to satisfy an extension chain.

The transitive closure includes any extensions required by the initial jar, its Class-Path jars, and any extensions required by extensions.

Parameters:

anchorDir - the directory relative to which Class-Path manifest entries are evaluated (if relative)

mainAttrs - the main attributes from a jar file whose extensions are to be satisfied

Returns:

List containing an Extension object for each required jar

Throws:

IOException - in case of errors building the extension jar file data structure