OpenJDK 27 · java.util.jar.JarEntry · APIdia, the JavaDoc alternative

Modifier and Type	Field and Description
pack-priv Attributes	attr
pack-priv Certificate[]	certs
pack-priv CodeSigner[]	signers

Access	Constructor and Description
public	JarEntry(String the JAR file entry name name) Creates a new `JarEntry` for the specified JAR file entry name.
public	JarEntry(ZipEntry the `ZipEntry` object to create the `JarEntry` from ze) Creates a new `JarEntry` with fields taken from the specified `ZipEntry` object.
public	JarEntry(JarEntry the `JarEntry` to copy je) Creates a new `JarEntry` with fields taken from the specified `JarEntry` object.

Method Summary

Modifier and Type	Method and Description
public Attributes	Returns: the `Manifest` `Attributes` for this entry, or `null` if none getAttributes() Returns the `Manifest` `Attributes` for this entry, or `null` if none.
public Certificate[]	Returns: the `Certificate` objects for this entry, or `null` if none. getCertificates() Returns the `Certificate` objects for this entry, or `null` if none.
public CodeSigner[]	Returns: the `CodeSigner` objects for this entry, or `null` if none. getCodeSigners() Returns the `CodeSigner` objects for this entry, or `null` if none.
public String	Returns: the real name of the JarEntry getRealName() Returns the real name of this `JarEntry`.

Field Detail

attr	back to summary
pack-priv Attributes attr

certs	back to summary
pack-priv Certificate[] certs

signers	back to summary
pack-priv CodeSigner[] signers

Constructor Detail

JarEntry back to summary

JarEntry	back to summary
public JarEntry(String name) Creates a new `JarEntry` for the specified JAR file entry name. Parameters name:String the JAR file entry name Exceptions NullPointerException: if the entry name is `null` IllegalArgumentException: if the entry name is longer than 0xFFFF bytes.

public JarEntry(String name)

Creates a new JarEntry for the specified JAR file entry name.

Parameters

name:String: the JAR file entry name

Exceptions

NullPointerException:: if the entry name is null
IllegalArgumentException:: if the entry name is longer than 0xFFFF bytes.

JarEntry back to summary

JarEntry	back to summary
public JarEntry(ZipEntry ze) Creates a new `JarEntry` with fields taken from the specified `ZipEntry` object. Parameters ze:ZipEntry the `ZipEntry` object to create the `JarEntry` from Exceptions NullPointerException: if `ze` is null

public JarEntry(ZipEntry ze)

Creates a new JarEntry with fields taken from the specified ZipEntry object.

Parameters

ze:ZipEntry: the ZipEntry object to create the JarEntry from

Exceptions

NullPointerException:: if ze is null

JarEntry back to summary

JarEntry	back to summary
public JarEntry(JarEntry je) Creates a new `JarEntry` with fields taken from the specified `JarEntry` object. Parameters je:JarEntry the `JarEntry` to copy Exceptions NullPointerException: if `je` is null

public JarEntry(JarEntry je)

Creates a new JarEntry with fields taken from the specified JarEntry object.

Parameters

je:JarEntry: the JarEntry to copy

Exceptions

NullPointerException:: if je is null

Method Detail

getAttributes back to summary

getAttributes	back to summary
public Attributes getAttributes() throws IOException Returns the `Manifest` `Attributes` for this entry, or `null` if none. Returns:Attributes the `Manifest` `Attributes` for this entry, or `null` if none Exceptions IOException: if an I/O error has occurred

public Attributes getAttributes() throws IOException

Returns the Manifest Attributes for this entry, or null if none.

Returns:Attributes

the Manifest Attributes for this entry, or null if none

Exceptions

IOException:: if an I/O error has occurred

getCertificates back to summary

getCertificates	back to summary
public Certificate[] getCertificates() Returns the `Certificate` objects for this entry, or `null` if none. This method can only be called once the `JarEntry` has been completely verified by reading from the entry input stream until the end of the stream has been reached. Otherwise, this method will return `null`. It is recommended to use the `getCodeSigners` method instead, which returns an array of `CodeSigner`s. The returned certificate array comprises all the signer certificates that were used to verify this entry. Each signer certificate is followed by its supporting certificate chain (which may be empty). Each signer certificate and its supporting certificate chain are ordered bottom-to-top (i.e., with the signer certificate first and the (root) certificate authority last). API Note The verification process does not include validating or establishing trust in the code signers. A caller should perform additional checks, such as using a `java.security.cert.CertPathValidator` to validate each signer's certificate chain, and determining whether to trust the entry signed by the signers. Implementation Specification If non-null, this implementation returns a new array each time this method is invoked. Returns:Certificate[] the `Certificate` objects for this entry, or `null` if none.

public Certificate[] getCertificates()

Returns the Certificate objects for this entry, or null if none. This method can only be called once the JarEntry has been completely verified by reading from the entry input stream until the end of the stream has been reached. Otherwise, this method will return null.

It is recommended to use the getCodeSigners method instead, which returns an array of CodeSigners.

The returned certificate array comprises all the signer certificates that were used to verify this entry. Each signer certificate is followed by its supporting certificate chain (which may be empty). Each signer certificate and its supporting certificate chain are ordered bottom-to-top (i.e., with the signer certificate first and the (root) certificate authority last).

API Note

The verification process does not include validating or establishing trust in the code signers. A caller should perform additional checks, such as using a java.security.cert.CertPathValidator to validate each signer's certificate chain, and determining whether to trust the entry signed by the signers.

Implementation Specification

If non-null, this implementation returns a new array each time this method is invoked.

Returns:Certificate[]: the Certificate objects for this entry, or null if none.

getCodeSigners back to summary

getCodeSigners	back to summary
public CodeSigner[] getCodeSigners() Returns the `CodeSigner` objects for this entry, or `null` if none. This method can only be called once the `JarEntry` has been completely verified by reading from the entry input stream until the end of the stream has been reached. Otherwise, this method will return `null`. The returned array comprises all the code signers that have signed this entry. API Note The verification process does not include validating or establishing trust in the code signers. A caller should perform additional checks, such as using a `java.security.cert.CertPathValidator` to validate each signer's certificate chain, and determining whether to trust the entry signed by the signers. Implementation Specification If non-null, this implementation returns a new array each time this method is invoked. Returns:CodeSigner[] the `CodeSigner` objects for this entry, or `null` if none. Since 1.5

public CodeSigner[] getCodeSigners()

Returns the CodeSigner objects for this entry, or null if none. This method can only be called once the JarEntry has been completely verified by reading from the entry input stream until the end of the stream has been reached. Otherwise, this method will return null.

The returned array comprises all the code signers that have signed this entry.

API Note

Implementation Specification

If non-null, this implementation returns a new array each time this method is invoked.

Returns:CodeSigner[]: the CodeSigner objects for this entry, or null if none.
Since: 1.5

getRealName back to summary

getRealName	back to summary
public String getRealName() Returns the real name of this `JarEntry`. If this `JarEntry` is an entry of a multi-release jar file and the `JarFile` is configured to be processed as such, the name returned by this method is the path name of the versioned entry that the `JarEntry` represents, rather than the path name of the base entry that `getName()` returns. If the `JarEntry` does not represent a versioned entry of a multi-release `JarFile` or the `JarFile` is not configured for processing a multi-release jar file, this method returns the same name that `getName()` returns. Returns:String the real name of the JarEntry Since 10

public String getRealName()

Returns the real name of this JarEntry. If this JarEntry is an entry of a multi-release jar file and the JarFile is configured to be processed as such, the name returned by this method is the path name of the versioned entry that the JarEntry represents, rather than the path name of the base entry that getName() returns. If the JarEntry does not represent a versioned entry of a multi-release JarFile or the JarFile is not configured for processing a multi-release jar file, this method returns the same name that getName() returns.

Returns:String: the real name of the JarEntry
Since: 10

public Class JarEntry

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail