org.glassfish.api.deployment.archive
Interface WritableArchive

All Superinterfaces:

Archive

@Contract
public interface WritableArchive
extends Archive

Interface for implementing write access to an underlying archive on a unspecified medium

Author:

Jerome Dochez

Method Summary

void	closeEntry() closes the current entry
void	closeEntry(WritableArchive subArchive) Close a previously returned sub archive
void	create(URI uri) creates a new abstract archive with the given path
WritableArchive	createSubArchive(String name) Returns an instance of this archive abstraction for an embedded archive within this archive.
OutputStream	putNextEntry(String name) Create a new entry in the archive

Methods inherited from interface org.glassfish.api.deployment.archive.Archive

close, entries, entries, getArchiveSize, getDirectories, getManifest, getName, getURI, isDirectory

Method Detail

create

void create(URI uri)
            throws IOException

creates a new abstract archive with the given path

Parameters:

uri - the path to create the archive

Throws:

IOException

closeEntry

void closeEntry(WritableArchive subArchive)
                throws IOException

Close a previously returned sub archive

Parameters:

subArchive - output stream to close

Throws:

IOException

putNextEntry

OutputStream putNextEntry(String name)
                          throws IOException

Create a new entry in the archive

Parameters:

name - the entry name

Throws:

IOException

closeEntry

void closeEntry()
                throws IOException

closes the current entry

Throws:

IOException

createSubArchive

WritableArchive createSubArchive(String name)
                                 throws IOException

Returns an instance of this archive abstraction for an embedded archive within this archive.

Parameters:

name - is the entry name relative to the root for the archive

Returns:

the Archive instance for this abstraction

Throws:

IOException