java.lang.Package
This class must be implemented by the vm vendor.
An instance of class Package contains information about a Java package. This
includes implementation and specification versions. Typically this
information is retrieved from the manifest.
Packages are managed by class loaders. All classes loaded by the same loader
from the same package share a Package instance.
Summary
Public Methods
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
Details
Public Methods
public
T
getAnnotation(Class<T> annotationType)
Gets the annotation associated with the given annotation type and this
package.
Gets all of the annotations associated with this package.
Returns
- An array of Annotation instances, which may be empty.
public
Annotation[]
getDeclaredAnnotations()
Gets all of the annotations directly declared on this element.
Returns
- An array of Annotation instances, which may be empty.
public
String
getImplementationTitle()
Return the title of the implementation of this package, or null if this
is unknown. The format of this string is unspecified.
Returns
- The implementation title, or null
public
String
getImplementationVendor()
Return the name of the vendor or organization that provided this
implementation of the package, or null if this is unknown. The format of
this string is unspecified.
Returns
- The implementation vendor name, or null
public
String
getImplementationVersion()
Return the version of the implementation of this package, or null if this
is unknown. The format of this string is unspecified.
Returns
- The implementation version, or null
public
String
getName()
Return the name of this package in the standard dot notation; for
example: "java.lang".
public
static
Package
getPackage(String packageName)
Attempt to locate the requested package in the caller's class loader. If
no package information can be located, null is returned.
Parameters
packageName
| The name of the package to find |
Returns
- The package requested, or null
public
static
Package[]
getPackages()
Return all the packages known to the caller's class loader.
Returns
- All the packages known to the caller's classloader
public
String
getSpecificationTitle()
Return the title of the specification this package implements, or null if
this is unknown.
Returns
- The specification title, or null
public
String
getSpecificationVendor()
Return the name of the vendor or organization that owns and maintains the
specification this package implements, or null if this is unknown.
Returns
- The specification vendor name, or null
public
String
getSpecificationVersion()
Return the version of the specification this package implements, or null
if this is unknown. The version string is a sequence of non-negative
integers separated by dots; for example: "1.2.3".
Returns
- The specification version string, or null
public
int
hashCode()
Returns an integer hash code for the receiver. Any two objects which
answer
true
when passed to
equals
must
answer the same value for this method.
public
boolean
isAnnotationPresent(Class<? extends Annotation> annotationType)
Indicates whether or not the given annotation is present.
Returns
- A value of
true
if the annotation is present,
otherwise false
.
public
boolean
isCompatibleWith(String version)
Return true if this package's specification version is compatible with
the specified version string. Version strings are compared by comparing
each dot separated part of the version as an integer.
Parameters
version
| The version string to compare against |
Returns
- true if the package versions are compatible, false otherwise
public
boolean
isSealed()
Return true if this package is sealed, false otherwise.
Returns
- true if this package is sealed, false otherwise
public
boolean
isSealed(URL url)
Return true if this package is sealed with respect to the specified URL,
false otherwise.
Returns
- true if this package is sealed, false otherwise
public
String
toString()
Returns a string containing a concise, human-readable description of the
receiver.
Returns
- a printable representation for the receiver.