Package org.glassfish.api.deployment.archive

Interface WritableArchive

All Superinterfaces:

Archive, AutoCloseable

@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	Description
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.
WritableArchiveEntry	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 Details

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

putNextEntry

WritableArchiveEntry putNextEntry(String name)
                           throws IOException

Create a new entry in the archive. Caller is responsible for closing the entry.

Parameters:

name - the entry name

Returns:

an WritableArchiveEntry for a new entry in this current abstract archive.

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