org.glassfish.api.deployment.archive

Interface WritableArchive

All Superinterfaces:

Archive

All Known Implementing Classes:

FileArchive, OutputJarArchive

@Contract
public interface WritableArchive
extends Archive

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

Author:

Jerome Dochez

Method Summary

Modifier and Type	Method and Description
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