java/lang/Package.java

52  * when the {@code Package} is defined. An application can ask if the
53  * {@code Package} is compatible with a particular specification version
54  * by using the {@link #isCompatibleWith Package.isCompatibleWith(String)}
56  * run-time package can be provided when the Package is defined.
60  * A {@code Package} may be explicitly defined with
66  * If a {@code Package} is not explicitly defined for a run-time package when
67  * a class in that run-time package is defined, then a {@code Package} is
70  * A {@code Package} automatically defined for classes in a named module has
84  * A {@code Package} automatically defined for classes in an unnamed module
98  * A {@code Package} can be obtained with the {@link Package#getPackage
99  * Package.getPackage(String)} and {@link ClassLoader#getDefinedPackage
101  * Every {@code Package} defined by a class loader can be obtained
102  * with the {@link Package#getPackages Package.getPackages()} and
107  * do not explicitly define {@code Package} objects for packages in
113  * The JAR File Specification: Package Sealing</a>
120 public class Package extends NamedPackage implements java.lang.reflect.AnnotatedElement {
316      * If the caller's class loader defines a {@code Package} of the given name,
317      * the {@code Package} is returned. Otherwise, the ancestors of the
319      * for a {@code Package} of the given name.
325      * @return The {@code Package} of the given name defined by the caller's
334      * behavior of {@code getPackage} to return a {@code Package} from
335      * a parent loader, then the properties exposed by the {@code Package}
337      * For example, the {@code Package} will only expose annotations from the
342      * a {@code Package} for the specified class loader.
352     public static Package getPackage(String name) {
358      * Returns all of the {@code Package}s defined by the caller's class loader
360      * {@code Package} object of the same package name, each defined by
366      * @return  The array of {@code Package} objects defined by this
375     public static Package[] getPackages() {
377         return cl != null ? cl.getPackages() : BootLoader.packages().toArray(Package[]::new);
390      * Returns the string representation of this Package.
500      * This method should not be called to define a Package for named module.
509      * @param sealbase code source where this Package comes from
512     Package(String name,
527     Package(String name, Module module) {