org.apache.jackrabbit.vault.fs.io

Interface Archive

All Known Implementing Classes:

FileArchive, JcrArchive, MemoryArchive, SubArchive, ZipArchive

public interface Archive

Specifies a read-only archive.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Archive.Entry Entry of an archive

Method Summary

Modifier and Type	Method and Description
void	close() closes the archive
Archive.Entry	getEntry(String path) Returns the entry specified by path.
VaultInputSource	getInputSource(Archive.Entry entry) Returns an input source for the given entry
Archive.Entry	getJcrRoot() Returns the entry that specifies the "jcr_root".
MetaInf	getMetaInf() Returns the meta inf.
Archive.Entry	getRoot() Returns the root entry.
Archive	getSubArchive(String root, boolean asJcrRoot) Returns a sub archive that is rooted at the given path.
void	open(boolean strict) Opens the archive.
InputStream	openInputStream(Archive.Entry entry) Opens an input stream for the given entry

Method Detail

open

void open(boolean strict)
   throws IOException

Opens the archive.

Parameters:

strict - if true open will fail if there was an internal error while parsing meta data.

Throws:

IOException - if an error occurs

openInputStream

InputStream openInputStream(Archive.Entry entry)
                     throws IOException

Opens an input stream for the given entry

Parameters:

entry - the entry

Returns:

the input stream

Throws:

IOException - if an error occurs

getInputSource

VaultInputSource getInputSource(Archive.Entry entry)
                         throws IOException

Returns an input source for the given entry

Parameters:

entry - the entry

Returns:

the input source

Throws:

IOException - if an error occurs

getJcrRoot

Archive.Entry getJcrRoot()
                  throws IOException

Returns the entry that specifies the "jcr_root". if no such entry exists, null is returned.

Returns:

the jcr_root entry or null

Throws:

IOException - if an error occurs

getRoot

Archive.Entry getRoot()
               throws IOException

Returns the root entry.

Returns:

the root entry.

Throws:

IOException - if an error occurs

getMetaInf

MetaInf getMetaInf()

Returns the meta inf. If the archive provides no specific meta data, a default, empty meta inf is returned.

Returns:

the meta inf.

getEntry

Archive.Entry getEntry(String path)
                throws IOException

Returns the entry specified by path.

Parameters:

path - the path

Returns:

the entry or null if not found.

Throws:

IOException - if an error occurs

getSubArchive

Archive getSubArchive(String root,
                      boolean asJcrRoot)
               throws IOException

Returns a sub archive that is rooted at the given path. Note that sub archives currently can't have they own meta inf and are closed automatically if they base is closed.

Parameters:

root - root path

asJcrRoot - if true the given root is the jcr_root

Returns:

the archive or null if entry specified by root does not exist.

Throws:

IOException - if an error occurs

close

void close()

closes the archive