Module iu.util.type.impl

Package iu.type

Class ArchiveSource

java.lang.Object

iu.type.ArchiveSource

All Implemented Interfaces:

AutoCloseable

class ArchiveSource
extends Object
implements AutoCloseable

Reads entries from a JarInputStream for validating and initializing a ComponentArchive.

Constructor Summary

Constructors

Constructor	Description
ArchiveSource(InputStream in)	Constructs an ArchiveSource for an InputStream.

Method Summary

Modifier and Type	Method	Description
(package private) List<String>	classPath()	Gets the class path defined in the Manifest.
void	close()
(package private) List<ComponentVersion>	dependencies()	Gets the component's dependencies named in the Extension-List manifest main attributes.
(package private) boolean	hasNext()	Same behavior as Iterator.hasNext(), but can throw IOException if there is an error reading from the jar file.
(package private) ComponentEntry	next()	Same behavior as Iterator.next(), but can throw IOException if there is an error reading from the jar file.
(package private) boolean	sealed()	If packages in this archive should be sealed.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Details

ArchiveSource

ArchiveSource(InputStream in)
       throws IOException

Constructs an ArchiveSource for an InputStream.

The input stream provided is opened and validated as a jar file with a valid manifest. The source is considered sealed if Sealed appears in the manifest. If the manifest provides a class path or extension list, those attributes are processed.

Parameters:

in - input stream; this method is not responsible for closing the stream

Throws:

IOException - If an I/O error occurs

Method Details

sealed

boolean sealed()

If packages in this archive should be sealed.

Returns:

true if packages should be sealed; else false

classPath

List<String> classPath()

Gets the class path defined in the Manifest.

Returns:

Attributes.Name.CLASS_PATH mainfest main attribute.

dependencies

List<ComponentVersion> dependencies()

Gets the component's dependencies named in the Extension-List manifest main attributes.

Returns:

dependency versions

hasNext

boolean hasNext()
         throws IOException

Same behavior as Iterator.hasNext(), but can throw IOException if there is an error reading from the jar file.

Note that this method closes the last entry returned from next() and positions the jar file for reading the next entry as part of determining whether or not there is a next entry. So, this should only be called after all interactions with the last entry are complete.

Returns:

see Iterator.hasNext()

Throws:

IOException - If there is an error reading the next entry from the jar file.

next

ComponentEntry next()
             throws IOException

Same behavior as Iterator.next(), but can throw IOException if there is an error reading from the jar file.

Returns:

see Iterator.next()

Throws:

IOException - from hasNext()

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Throws:

IOException

toString

public String toString()

Overrides:

toString in class Object