src/share/classes/java/lang/Package.java

Print this page
rev 10175 : 8047721: @since should have JDK version
Reviewed-by:


  90  *
  91  * <dt><i>Digit:</i>
  92  * <dd>any character for which {@link Character#isDigit} returns {@code true},
  93  * e.g. 0, 1, 2, ...
  94  * </dl>
  95  * </blockquote>
  96  *
  97  * <p>The implementation title, version, and vendor strings identify an
  98  * implementation and are made available conveniently to enable accurate
  99  * reporting of the packages involved when a problem occurs. The contents
 100  * all three implementation strings are vendor specific. The
 101  * implementation version strings have no specified syntax and should
 102  * only be compared for equality with desired version identifiers.
 103  *
 104  * <p>Within each {@code ClassLoader} instance all classes from the same
 105  * java package have the same Package object.  The static methods allow a package
 106  * to be found by name or the set of all packages known to the current class
 107  * loader to be found.
 108  *
 109  * @see ClassLoader#definePackage

 110  */
 111 public class Package implements java.lang.reflect.AnnotatedElement {
 112     /**
 113      * Return the name of this package.
 114      *
 115      * @return  The fully-qualified name of this package as defined in section 6.5.3 of
 116      *          <cite>The Java&trade; Language Specification</cite>,
 117      *          for example, {@code java.lang}
 118      */
 119     public String getName() {
 120         return pkgName;
 121     }
 122 
 123 
 124     /**
 125      * Return the title of the specification that this package implements.
 126      * @return the specification title, null is returned if it is not known.
 127      */
 128     public String getSpecificationTitle() {
 129         return specTitle;




  90  *
  91  * <dt><i>Digit:</i>
  92  * <dd>any character for which {@link Character#isDigit} returns {@code true},
  93  * e.g. 0, 1, 2, ...
  94  * </dl>
  95  * </blockquote>
  96  *
  97  * <p>The implementation title, version, and vendor strings identify an
  98  * implementation and are made available conveniently to enable accurate
  99  * reporting of the packages involved when a problem occurs. The contents
 100  * all three implementation strings are vendor specific. The
 101  * implementation version strings have no specified syntax and should
 102  * only be compared for equality with desired version identifiers.
 103  *
 104  * <p>Within each {@code ClassLoader} instance all classes from the same
 105  * java package have the same Package object.  The static methods allow a package
 106  * to be found by name or the set of all packages known to the current class
 107  * loader to be found.
 108  *
 109  * @see ClassLoader#definePackage
 110  * @since 1.2
 111  */
 112 public class Package implements java.lang.reflect.AnnotatedElement {
 113     /**
 114      * Return the name of this package.
 115      *
 116      * @return  The fully-qualified name of this package as defined in section 6.5.3 of
 117      *          <cite>The Java&trade; Language Specification</cite>,
 118      *          for example, {@code java.lang}
 119      */
 120     public String getName() {
 121         return pkgName;
 122     }
 123 
 124 
 125     /**
 126      * Return the title of the specification that this package implements.
 127      * @return the specification title, null is returned if it is not known.
 128      */
 129     public String getSpecificationTitle() {
 130         return specTitle;