java.util.jar

Class Attributes.Name

java.lang.Object

java.util.jar.Attributes.Name

Enclosing class:

Attributes

public static class Attributes.Name
extends Object

Represents a name of a Manifest Attribute. Defines a couple of well know names for the general main attributes, stand alone application attributes, applet attributes, extension identification attributes, package versioning and sealing attributes, file contents attributes, bean objects attribute and signing attributes. See the

The characters of a Name must obey the following restrictions:

• Must contain at least one character
• The first character must be alphanumeric (a-z, A-Z, 0-9)
• All other characters must be alphanumeric, a '-' or a '_'

When comparing Names (with equals) all characters are converted to lowercase. But you can get the original case sensitive string with the toString() method.

Most important attributes have a constant defined in this class. Some other attributes used in Manifest files are:

• "Created-By" - General main attribute, tool and version that created this Manifest file.
• "Java-Bean" - Bean objects attribute, whether the entry is a Bean. Value is either "true" or "false".
• "Magic" - Signing attribute, application specific signing attribute. Must be understood by the manifest parser when present to validate the jar (entry).

Since:

1.2

Field Summary

Fields

Modifier and Type	Field and Description
static Attributes.Name	CLASS_PATH General main attribute - (relative) file paths of the libraries/classpaths that the Classes in this jar file depend on.
static Attributes.Name	CONTENT_TYPE File contents attribute - Mime type and subtype for the jar entry.
static Attributes.Name	EXTENSION_INSTALLATION Extension identification attribute - synonym for EXTENSTION_NAME.
static Attributes.Name	EXTENSION_LIST Applet attribute - a list of extension libraries that the applet in this jar file depends on.
static Attributes.Name	EXTENSION_NAME Extension identification attribute - the name if the extension library contained in the jar.
static Attributes.Name	IMPLEMENTATION_TITLE Package versioning - name of extension library contained in this jar.
static Attributes.Name	IMPLEMENTATION_URL Package versioning - location where this implementation can be downloaded.
static Attributes.Name	IMPLEMENTATION_VENDOR Package versioning - name of extension library creator contained in this jar.
static Attributes.Name	IMPLEMENTATION_VENDOR_ID Package versioning - unique id of extension library creator.
static Attributes.Name	IMPLEMENTATION_VERSION Package versioning - version of the extension library contained in this jar.
static Attributes.Name	MAIN_CLASS Stand alone application attribute - the entry (without the .class ending) that is the main class of this jar file.
static Attributes.Name	MANIFEST_VERSION General main attribute - the version of this Manifest file.
static Attributes.Name	SEALED Package sealing - whether (all) package(s) is(/are) sealed.
static Attributes.Name	SIGNATURE_VERSION General main attribute - the version of the jar file signature.
static Attributes.Name	SPECIFICATION_TITLE Package versioning - title of the specification contained in this jar.
static Attributes.Name	SPECIFICATION_VENDOR Package versioning - organisation that maintains the specification contains in this jar.
static Attributes.Name	SPECIFICATION_VERSION Package versioning - version of the specification contained in this jar.

Constructor Summary

Constructors

Constructor and Description
Attributes.Name(String name) Creates a new Name from the given String.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object o) Checks if another object is equal to this Name object.
int	hashCode() Returns the hash code of the (lowercase) String representation of this Name.
String	toString() Returns the string representation of this Name as given to the constructor (not neccesarily the lower case representation).

Methods inherited from class java.lang.Object

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

Field Detail

MANIFEST_VERSION

public static final Attributes.Name MANIFEST_VERSION

General main attribute - the version of this Manifest file.

SIGNATURE_VERSION

public static final Attributes.Name SIGNATURE_VERSION

General main attribute - the version of the jar file signature.

CLASS_PATH

public static final Attributes.Name CLASS_PATH

General main attribute - (relative) file paths of the libraries/classpaths that the Classes in this jar file depend on. Paths are separated by spaces.

MAIN_CLASS

public static final Attributes.Name MAIN_CLASS

Stand alone application attribute - the entry (without the .class ending) that is the main class of this jar file.

EXTENSION_LIST

public static final Attributes.Name EXTENSION_LIST

Applet attribute - a list of extension libraries that the applet in this jar file depends on. For every named extension there should be some Attributes in the Manifest manifest file with the following Names:

• <extension>-Extension-Name: unique name of the extension
• <extension>-Specification-Version: minimum specification version
• <extension>-Implementation-Version: minimum implementation version
• <extension>-Implementation-Vendor-Id: unique id of implementation vendor
• <extension>-Implementation-URL: where the latest version of the extension library can be found

EXTENSION_NAME

public static final Attributes.Name EXTENSION_NAME

Extension identification attribute - the name if the extension library contained in the jar.

EXTENSION_INSTALLATION

public static final Attributes.Name EXTENSION_INSTALLATION

Extension identification attribute - synonym for EXTENSTION_NAME.

IMPLEMENTATION_TITLE

public static final Attributes.Name IMPLEMENTATION_TITLE

Package versioning - name of extension library contained in this jar.

IMPLEMENTATION_VERSION

public static final Attributes.Name IMPLEMENTATION_VERSION

Package versioning - version of the extension library contained in this jar.

IMPLEMENTATION_VENDOR

public static final Attributes.Name IMPLEMENTATION_VENDOR

Package versioning - name of extension library creator contained in this jar.

IMPLEMENTATION_VENDOR_ID

public static final Attributes.Name IMPLEMENTATION_VENDOR_ID

Package versioning - unique id of extension library creator.

IMPLEMENTATION_URL

public static final Attributes.Name IMPLEMENTATION_URL

Package versioning - location where this implementation can be downloaded.

SPECIFICATION_TITLE

public static final Attributes.Name SPECIFICATION_TITLE

Package versioning - title of the specification contained in this jar.

SPECIFICATION_VERSION

public static final Attributes.Name SPECIFICATION_VERSION

Package versioning - version of the specification contained in this jar.

SPECIFICATION_VENDOR

public static final Attributes.Name SPECIFICATION_VENDOR

Package versioning - organisation that maintains the specification contains in this jar.

SEALED

public static final Attributes.Name SEALED

Package sealing - whether (all) package(s) is(/are) sealed. Value is either "true" or "false".

CONTENT_TYPE

public static final Attributes.Name CONTENT_TYPE

File contents attribute - Mime type and subtype for the jar entry.

Constructor Detail

Attributes.Name

public Attributes.Name(String name)
                throws IllegalArgumentException,
                       NullPointerException

Creates a new Name from the given String. Throws an IllegalArgumentException if the given String is empty or contains any illegal Name characters.

Parameters:

name - the name of the new Name

Throws:

IllegalArgumentException - if name isn't a valid String representation of a Name

NullPointerException - if name is null

Method Detail

hashCode

public int hashCode()

Returns the hash code of the (lowercase) String representation of this Name.

Overrides:

hashCode in class Object

Returns:

the hash code for this Object

See Also:

Object.equals(Object), System.identityHashCode(Object)

equals

public boolean equals(Object o)

Checks if another object is equal to this Name object. Another object is equal to this Name object if it is an instance of Name and the (lowercase) string representation of the name is equal.

Overrides:

equals in class Object

Parameters:

o - the Object to compare to

Returns:

whether this Object is semantically equal to another

See Also:

Object.hashCode()

toString

public String toString()

Returns the string representation of this Name as given to the constructor (not neccesarily the lower case representation).

Overrides:

toString in class Object

Returns:

the String representing this Object, which may be null

See Also:

Object.getClass(), Object.hashCode(), Class.getName(), Integer.toHexString(int)