Class JarContent

java.lang.Object

org.apache.felix.framework.cache.JarContent

All Implemented Interfaces:

Content

public class JarContent
extends Object
implements Content

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	JarContent.DevNullRunnable
private static class	JarContent.EntriesEnumeration

Field Summary

Fields

Modifier and Type	Field	Description
private static final int	BUFSIZE
private static final String	EMBEDDED_DIRECTORY
private static final String	LIBRARY_DIRECTORY
private final Map	m_configMap
private final File	m_file
private final boolean	m_isZipFileOwner
private final Logger	m_logger
private Map	m_nativeLibMap
private final Object	m_revisionLock
private final File	m_rootDir
private final WeakZipFileFactory	m_zipFactory
private final WeakZipFileFactory.WeakZipFile	m_zipFile

Constructor Summary

Constructors

Constructor	Description
JarContent(Logger logger, Map configMap, WeakZipFileFactory zipFactory, Object revisionLock, File rootDir, File file, WeakZipFileFactory.WeakZipFile zipFile)

Method Summary

Modifier and Type	Method	Description
void	close()	This method must be called when the content is no longer needed so that any resourses being used (e.g., open files) can be closed.
private void	extractEmbeddedJar(String jarPath)	This method extracts an embedded JAR file from the bundle's JAR file.
protected void	finalize()
Enumeration<String>	getEntries()	Returns an enumeration of entry names as String objects.
byte[]	getEntryAsBytes(String name)	This method returns the named entry as an array of bytes.
Content	getEntryAsContent(String entryName)	This method returns the named entry as an IContent Typically, this method only makes sense for entries that correspond to some form of aggregated resource (e.g., an embedded JAR file or directory), but implementations are free to interpret this however makes sense.
String	getEntryAsNativeLibrary(String entryName)	This method returns the named entry as a file in the file system for use as a native library.
InputStream	getEntryAsStream(String name)	This method returns the named entry as an input stream.
URL	getEntryAsURL(String name)	This method allows retrieving an entry as a local URL.
File	getFile()
boolean	hasEntry(String name)	This method determines if the specified named entry is contained in the associated content.
String	toString()

Methods inherited from class Object

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

Field Details

BUFSIZE

private static final int BUFSIZE

See Also:

• Constant Field Values

EMBEDDED_DIRECTORY

private static final transient String EMBEDDED_DIRECTORY

See Also:

• Constant Field Values

LIBRARY_DIRECTORY

private static final transient String LIBRARY_DIRECTORY

See Also:

• Constant Field Values

m_logger

private final Logger m_logger

m_configMap

private final Map m_configMap

m_zipFactory

private final WeakZipFileFactory m_zipFactory

m_revisionLock

private final Object m_revisionLock

m_rootDir

private final File m_rootDir

m_file

private final File m_file

m_zipFile

private final WeakZipFileFactory.WeakZipFile m_zipFile

m_isZipFileOwner

private final boolean m_isZipFileOwner

m_nativeLibMap

private Map m_nativeLibMap

Constructor Details

JarContent

public JarContent(Logger logger,
 Map configMap,
 WeakZipFileFactory zipFactory,
 Object revisionLock,
 File rootDir,
 File file,
 WeakZipFileFactory.WeakZipFile zipFile)

Method Details

finalize

protected void finalize()

Overrides:

finalize in class Object

close

public void close()

Description copied from interface: Content

This method must be called when the content is no longer needed so that any resourses being used (e.g., open files) can be closed. Once this method is called, the content is no longer usable. If the content is already closed, then calls on this method should have no effect.

Specified by:

close in interface Content

hasEntry

public boolean hasEntry(String name)
                 throws IllegalStateException

Description copied from interface: Content

This method determines if the specified named entry is contained in the associated content. The entry name is a relative path with '/' separators.

Specified by:

hasEntry in interface Content

Parameters:

name - The name of the entry to find.

Returns:

true if a corresponding entry was found, false otherwise.

Throws:

IllegalStateException

getEntries

public Enumeration<String> getEntries()

Description copied from interface: Content

Returns an enumeration of entry names as String objects. An entry name is a path constructed with '/' as path element separators and is relative to the root of the content. Entry names for entries that represent directories should end with the '/' character.

Specified by:

getEntries in interface Content

getEntryAsBytes

public byte[] getEntryAsBytes(String name)
                       throws IllegalStateException

Description copied from interface: Content

This method returns the named entry as an array of bytes.

Specified by:

getEntryAsBytes in interface Content

Parameters:

name - The name of the entry to retrieve as a byte array.

Returns:

An array of bytes if the corresponding entry was found, null otherwise.

Throws:

IllegalStateException

getEntryAsStream

public InputStream getEntryAsStream(String name)
                             throws IllegalStateException,
IOException

Description copied from interface: Content

This method returns the named entry as an input stream.

Specified by:

getEntryAsStream in interface Content

Parameters:

name - The name of the entry to retrieve as an input stream.

Returns:

An input stream if the corresponding entry was found, null otherwise.

Throws:

IllegalStateException

IOException

getEntryAsURL

public URL getEntryAsURL(String name)

Description copied from interface: Content

This method allows retrieving an entry as a local URL.

Specified by:

getEntryAsURL in interface Content

Parameters:

name - The name of the entry to retrieve as a URL

Returns:

A URL using a local protocol such as file, jar or null if not possible.

getEntryAsContent

public Content getEntryAsContent(String entryName)

Description copied from interface: Content

This method returns the named entry as an IContent Typically, this method only makes sense for entries that correspond to some form of aggregated resource (e.g., an embedded JAR file or directory), but implementations are free to interpret this however makes sense. This method should return a new IContent instance for every invocation and the caller is responsible for opening and closing the returned content object.

Specified by:

getEntryAsContent in interface Content

Parameters:

entryName - The name of the entry to retrieve as an IContent.

Returns:

An IContent instance if a corresponding entry was found, null otherwise.

getEntryAsNativeLibrary

public String getEntryAsNativeLibrary(String entryName)

Description copied from interface: Content

This method returns the named entry as a file in the file system for use as a native library. It may not be possible for all content implementations (e.g., memory only) to implement this method, in which case it is acceptable to return null. Since native libraries can only be associated with a single class loader, this method should return a unique file per request.

Specified by:

getEntryAsNativeLibrary in interface Content

Parameters:

entryName - The name of the entry to retrieve as a file.

Returns:

A string corresponding to the absolute path of the file if a corresponding entry was found, null otherwise.

toString

public String toString()

Overrides:

toString in class Object

getFile

public File getFile()

extractEmbeddedJar

private void extractEmbeddedJar(String jarPath)
                         throws Exception

This method extracts an embedded JAR file from the bundle's JAR file.

Parameters:

jarPath - the path to the embedded JAR file inside the bundle JAR file.

id - the identifier of the bundle that owns the embedded JAR file.

Throws:

Exception