Package org.codehaus.plexus.archiver.jar

Class Manifest

java.lang.Object

java.util.jar.Manifest

org.codehaus.plexus.archiver.jar.Manifest

All Implemented Interfaces:

java.lang.Cloneable, java.lang.Iterable<java.lang.String>

public class Manifest
extends java.util.jar.Manifest
implements java.lang.Iterable<java.lang.String>

Holds the data of a jar manifest.

Manifests are processed according to the Jar file specification. Specifically, a manifest element consists of a set of attributes and sections. These sections in turn may contain attributes. Note in particular that this may result in manifest lines greater than 72 bytes (including line break) being wrapped and continued on the next line. If an application can not handle the continuation mechanism, it is a defect in the application, not this task.

Since:

Ant 1.4

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Manifest.Attribute	An attribute for the manifest.
static class	Manifest.BaseAttribute
class	Manifest.ExistingAttribute
class	Manifest.ExistingSection
static class	Manifest.Section	A manifest section - you can nest attribute elements into sections.

Constructor Summary

Constructors

Constructor	Description
Manifest()	Construct an empty manifest
Manifest(java.io.InputStream is)
Manifest(java.io.Reader r)	Deprecated. This constructor does not properly map characters to bytes.

Method Summary

Modifier and Type	Method	Description
void	addConfiguredAttribute(Manifest.Attribute attribute)	Add an attribute to the manifest - it is added to the main section.
void	addConfiguredSection(Manifest.Section section)	Add a section to the manifest
static Manifest	getDefaultManifest()
static Manifest	getDefaultManifest(boolean minimalDefaultManifest)	Construct a manifest from Ant's default manifest file.
Manifest.ExistingSection	getMainSection()	Get the main section of the manifest
java.lang.String	getManifestVersion()	Get the version of the manifest
Manifest.ExistingSection	getSection(java.lang.String name)	Get a particular section from the manifest
java.util.Iterator<java.lang.String>	iterator()
static java.lang.String	remap(java.util.jar.Attributes backingAttributes, Manifest.Attribute attribute)
java.lang.String	toString()	Convert the manifest to its string representation
void	write(java.io.Writer writer)	Writes the manifest out to a writer.

Methods inherited from class java.util.jar.Manifest

clear, clone, equals, getAttributes, getEntries, getMainAttributes, hashCode, read, write

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

Manifest

public Manifest()

Construct an empty manifest

Manifest

@Deprecated
public Manifest(java.io.Reader r)
         throws ManifestException,
                java.io.IOException

Deprecated.

This constructor does not properly map characters to bytes. Use Manifest(InputStream). Will be removed in 4.0.

Read a manifest file from the given reader

Parameters:

r - is the reader from which the Manifest is read

Throws:

ManifestException - if the manifest is not valid according to the JAR spec

java.io.IOException - if the manifest cannot be read from the reader.

Manifest

public Manifest(java.io.InputStream is)
         throws java.io.IOException

Throws:

java.io.IOException

Method Detail

iterator

public java.util.Iterator<java.lang.String> iterator()

Specified by:

iterator in interface java.lang.Iterable<java.lang.String>

getDefaultManifest

public static Manifest getDefaultManifest(boolean minimalDefaultManifest)
                                   throws ArchiverException

Construct a manifest from Ant's default manifest file.

Parameters:

minimalDefaultManifest - indicates whether a minimal manifest will be created, thus having only Manifest-Version: 1.0 in it.

Returns:

the default manifest.

Throws:

ArchiverException - if there is a problem loading the default manifest

getDefaultManifest

public static Manifest getDefaultManifest()
                                   throws ArchiverException

Throws:

ArchiverException

See Also:

getDefaultManifest(boolean)

addConfiguredSection

public void addConfiguredSection(Manifest.Section section)
                          throws ManifestException

Add a section to the manifest

Parameters:

section - the manifest section to be added

Throws:

ManifestException - if the secti0on is not valid.

addConfiguredAttribute

public void addConfiguredAttribute(Manifest.Attribute attribute)
                            throws ManifestException

Add an attribute to the manifest - it is added to the main section.

Parameters:

attribute - the attribute to be added.

Throws:

ManifestException - if the attribute is not valid.

write

public void write(java.io.Writer writer)
           throws java.io.IOException

Writes the manifest out to a writer.

Parameters:

writer - the Writer to which the manifest is written

Throws:

java.io.IOException - if the manifest cannot be written

toString

public java.lang.String toString()

Convert the manifest to its string representation

Overrides:

toString in class java.lang.Object

Returns:

a multiline string with the Manifest as it appears in a Manifest file.

getManifestVersion

public java.lang.String getManifestVersion()

Get the version of the manifest

Returns:

the manifest's version string

getMainSection

public Manifest.ExistingSection getMainSection()

Get the main section of the manifest

Returns:

the main section of the manifest

getSection

public Manifest.ExistingSection getSection(java.lang.String name)

Get a particular section from the manifest

Parameters:

name - the name of the section desired.

Returns:

the specified section or null if that section does not exist in the manifest

remap

public static java.lang.String remap(java.util.jar.Attributes backingAttributes,
                                     Manifest.Attribute attribute)
                              throws ManifestException

Throws:

ManifestException