Пакет (Платформа Java SE 7)

java.lang. Объект
- java.lang. Пакет

Все Реализованные Интерфейсы:

AnnotatedElement
```
public class Package
extends Object
implements AnnotatedElement
```
Package объекты содержат информацию о версии о реализации и спецификации пакета Java. Эта информация об управлении версиями получается и делается доступный ClassLoader экземпляр, который загрузил класс (ы). Как правило, это сохранено в декларации, которая распределяется с классами.
Набор классов, которые составляют пакет, может реализовать определенную спецификацию и раз так заголовок спецификации, номер версии, и строки поставщика идентифицируют ту спецификацию. Приложение может спросить, является ли пакет совместимым с определенной версией, см. isCompatibleWith метод для деталей.
Номера версий спецификации используют синтаксис, который состоит из неотрицательных десятичных целых чисел, разделенных периодами ".", например "2.0" или "1.2.3.4.5.6.7". Это позволяет расширяемому числу использоваться, чтобы представить главный, незначительный, микро, и т.д. версии. Спецификация версии описывается следующей формальной грамматикой:

SpecificationVersion:
Цифры _{RefinedVersionopt}
RefinedVersion:
. Цифры
. Цифры RefinedVersion
Цифры:
Цифра
Цифры
Цифра:
любой символ тот, для который Character.isDigit(char) возвраты true, например, 0, 1, 2...

Заголовок реализации, версия, и строки поставщика идентифицируют реализацию и делаются доступными удобно, чтобы включить точному созданию отчетов пакетов, включенных, когда проблема происходит. Содержание все три строки реализации является определенным поставщиком. Строки версии реализации не имеют никакого указанного синтаксиса и должны только быть сравнены для равенства с требуемыми идентификаторами версии.
В пределах каждого ClassLoader у экземпляра все классы от того же самого пакета java есть тот же самый объект Пакета. Статические методы позволяют пакету быть найденным по имени или набор всех пакетов, которые, как известно текущему загрузчику класса, были найдены.

См. Также:
ClassLoader.definePackage(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.net.URL)

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`<A extends Annotation> A`	`getAnnotation(Class<A> annotationClass)` Возвраты аннотация этого элемента для указанного типа, если такая аннотация присутствует, еще нуль.
`Аннотация[]`	`getAnnotations()` Возвраты все аннотации представляют на этом элементе.
`Аннотация[]`	`getDeclaredAnnotations()` Возвраты все аннотации, которые непосредственно присутствуют на этом элементе.
`Строка`	`getImplementationTitle()` Возвратите заголовок этого пакета.
`Строка`	`getImplementationVendor()` Возвращает имя организации, поставщика или компании, которая обеспечила эту реализацию.
`Строка`	`getImplementationVersion()` Возвратите версию этой реализации.
`Строка`	`getName()` Возвратите имя этого пакета.
`static Package`	`getPackage(String name)` Найдите пакет по имени в вызывающих сторонах `ClassLoader` экземпляр.
`static Package[]`	`getPackages()` Получите все пакеты, в настоящий момент известные вызывающей стороной `ClassLoader` экземпляр.
`Строка`	`getSpecificationTitle()` Возвратите заголовок спецификации, которую реализует этот пакет.
`Строка`	`getSpecificationVendor()` Возвратите имя организации, поставщика, или компании, которая имеет и поддерживает спецификацию классов, которые реализуют этот пакет.
`Строка`	`getSpecificationVersion()` Возвращает номер версии спецификации, которую реализует этот пакет.
`int`	`hashCode()` Возвратите хэш-код, вычисленный из имени пакета.
`boolean`	`isAnnotationPresent(Class<? extends Annotation> annotationClass)` Возвращает true, если аннотация для указанного типа присутствует на этом элементе, еще ложь.
`boolean`	`isCompatibleWith(String desired)` Сравните версию спецификации этого пакета с требуемой версией.
`boolean`	`isSealed()` Возвращает true, если этот пакет изолируется.
`boolean`	`isSealed(URL url)` Возвращает true, если этот пакет изолируется относительно указанного исходного url кода.
`Строка`	`toString()` Возвращает строковое представление этого Пакета.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, notify, notifyAll, wait, wait, wait

- Деталь метода
  - getName
```
public String getName()
```
    Возвратите имя этого пакета.
    
    Возвраты:
    Полностью определенное имя этого пакета как определено в разделе 6.5.3 из Спецификации языка Java™, например, java.lang
  - getSpecificationTitle
```
public String getSpecificationTitle()
```
    Возвратите заголовок спецификации, которую реализует этот пакет.
    
    Возвраты:
    заголовок спецификации, нуль возвращается, если это не известно.
  - getSpecificationVersion
```
public String getSpecificationVersion()
```
    Возвращает номер версии спецификации, которую реализует этот пакет. Эта строка версии должна быть последовательностью неотрицательных десятичных целых чисел, разделенных ". "'s и может иметь начальные нули. Когда строки версии сравниваются, старшие значащие числа сравниваются.
    
    Возвраты:
    версия спецификации, нуль возвращается, если это не известно.
  - getSpecificationVendor
```
public String getSpecificationVendor()
```
    Возвратите имя организации, поставщика, или компании, которая имеет и поддерживает спецификацию классов, которые реализуют этот пакет.
    
    Возвраты:
    поставщик спецификации, нуль возвращается, если он не известен.
  - getImplementationTitle
```
public String getImplementationTitle()
```
    Возвратите заголовок этого пакета.
    
    Возвраты:
    заголовок реализации, нуль возвращается, если это не известно.
  - getImplementationVersion
```
public String getImplementationVersion()
```
    Возвратите версию этой реализации. Это состоит из любой строки, присвоенной поставщиком этой реализации, и не имеет никакого определенного синтаксиса определенным или ожидаемым Средой выполнения Java. Это может быть сравнено для равенства с другими строками версии пакета, используемыми для этой реализации этим поставщиком для этого пакета.
    
    Возвраты:
    версия реализации, нуль возвращается, если это не известно.
  - getImplementationVendor
```
public String getImplementationVendor()
```
    Возвращает имя организации, поставщика или компании, которая обеспечила эту реализацию.
    
    Возвраты:
    поставщик, который реализовывал этот пакет..
  - isSealed
```
public boolean isSealed()
```
    Возвращает true, если этот пакет изолируется.
    
    Возвраты:
    истина, если пакет изолируется, ложь иначе
  - isSealed
```
public boolean isSealed(URL url)
```
    Возвращает true, если этот пакет изолируется относительно указанного исходного url кода.
    
    Параметры:
    url - исходный url кода
    
    Возвраты:
    истина, если этот пакет изолируется относительно url
  - isCompatibleWith
```
public boolean isCompatibleWith(String desired)
                         throws NumberFormatException
```
    Сравните версию спецификации этого пакета с требуемой версией. Это возвращает true, если этот номер версии спецификации пакетов больше чем или равен требуемому номеру версии.
    Номера версий сравниваются, последовательно сравнивая соответствующие компоненты строк спецификации и требуемого. Каждый компонент преобразовывается как десятичное целое число и сравненные значения. Если значение спецификации больше, чем true требуемого значения возвращается. Если значение менее ложно, возвращается. Если значения равны, период пропускается, и следующая пара компонентов сравнивается.
    
    Параметры:
    desired - строка версии требуемой версии.
    
    Возвраты:
    истина, если номер версии этого пакета больше чем или равен требуемому номеру версии
    
    Броски:
    
    NumberFormatException - если требуемая или текущая версия не имеет корректной точечной формы.
  - getPackage
```
public static Package getPackage(String name)
```
    Найдите пакет по имени в вызывающих сторонах ClassLoader экземпляр. Вызывающие стороны ClassLoader экземпляр используется, чтобы найти экземпляр пакета, соответствующий именованному классу. Если вызывающие стороны ClassLoader экземпляр является нулем тогда набор пакетов, загруженных системой ClassLoader экземпляр ищется, чтобы найти именованный пакет.
    У пакетов есть атрибуты для версий и спецификаций только если загрузчик класса, создаваемый экземпляр пакета с соответствующими атрибутами. Как правило, те атрибуты определяются в декларациях, которые сопровождают классы.
    
    Параметры:
    name - имя пакета, например, java.lang.
    
    Возвраты:
    пакет требуемого имени. Это может быть нуль, если никакая информация о пакете не доступна от архива или кодовой базы.
  - getPackages
```
public static Package[] getPackages()
```
    Получите все пакеты, в настоящий момент известные вызывающей стороной ClassLoader экземпляр. Те пакеты соответствуют классам, загруженным через или доступный по имени для этого ClassLoader экземпляр. Если вызывающая сторона ClassLoader экземпляр является начальной загрузкой ClassLoader экземпляр, который может быть представлен null в некоторых реализациях только пакеты, соответствующие классам, загружались начальной загрузкой ClassLoader экземпляр будет возвращен.
    
    Возвраты:
    новый массив пакетов, известных вызывающим сторонам ClassLoader экземпляр. Нулевой массив длины возвращается, если ни один не известен.
  - хэш-код
```
public int hashCode()
```
    Возвратите хэш-код, вычисленный из имени пакета.
    
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    хэш-код вычисляется из имени пакета.
    См. Также:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    Возвращает строковое представление этого Пакета. Его значение является строкой "пакет" и имя пакета. Если заголовок пакета определяется, он добавляется. Если версия пакета определяется, она добавляется.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    строковое представление пакета.
  - getAnnotation
```
public <A extends Annotation> A getAnnotation(Class<A> annotationClass)
```
    Описание скопировало с интерфейса: AnnotatedElement
    
    Возвраты аннотация этого элемента для указанного типа, если такая аннотация присутствует, еще нуль.
    
    Определенный:
    
    getAnnotation в интерфейсе AnnotatedElement
    
    Параметры:
    annotationClass - соответствие объекта Класса типу аннотации
    
    Возвраты:
    аннотация этого элемента для указанной аннотации вводит если существующий на этом элементе, еще нуль
    
    Броски:
    
    NullPointerException - если данный класс аннотации является нулем
    С тех пор:
    
    1.5
  - isAnnotationPresent
```
public boolean isAnnotationPresent(Class<? extends Annotation> annotationClass)
```
    Описание скопировало с интерфейса: AnnotatedElement
    
    Возвращает true, если аннотация для указанного типа присутствует на этом элементе, еще ложь. Этот метод разрабатывается прежде всего для удобного доступа к аннотациям маркера.
    
    Определенный:
    
    isAnnotationPresent в интерфейсе AnnotatedElement
    
    Параметры:
    annotationClass - соответствие объекта Класса типу аннотации
    
    Возвраты:
    истина, если аннотация для указанного типа аннотации присутствует на этом элементе, еще ложь
    
    Броски:
    
    NullPointerException - если данный класс аннотации является нулем
    С тех пор:
    
    1.5
  - getAnnotations
```
public Annotation[] getAnnotations()
```
    Описание скопировало с интерфейса: AnnotatedElement
    
    Возвраты все аннотации представляют на этом элементе. (Возвращает массив нуля длины, если у этого элемента нет никаких аннотаций.) Вызывающая сторона этого метода свободна изменить возвращенный массив; это не будет иметь никакого эффекта на массивы, возвращенные к другим вызывающим сторонам.
    
    Определенный:
    
    getAnnotations в интерфейсе AnnotatedElement
    
    Возвраты:
    все аннотации представляют на этом элементе
    С тех пор:
    
    1.5
  - getDeclaredAnnotations
```
public Annotation[] getDeclaredAnnotations()
```
    Описание скопировало с интерфейса: AnnotatedElement
    
    Возвраты все аннотации, которые непосредственно присутствуют на этом элементе. В отличие от других методов в этом интерфейсе, этот метод игнорирует наследованные аннотации. (Возвращает массив нуля длины, если никакие аннотации непосредственно не присутствуют на этом элементе.) Вызывающая сторона этого метода свободна изменить возвращенный массив; это не будет иметь никакого эффекта на массивы, возвращенные к другим вызывающим сторонам.
    
    Определенный:
    
    getDeclaredAnnotations в интерфейсе AnnotatedElement
    
    Возвраты:
    Все аннотации, непосредственно существующие на этом элементе
    С тех пор:
    
    1.5

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Пакет класса

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь метода

getName

getSpecificationTitle

getSpecificationVersion

getSpecificationVendor

getImplementationTitle

getImplementationVersion

getImplementationVendor

isSealed

isSealed

isCompatibleWith

getPackage

getPackages

хэш-код

toString

getAnnotation

isAnnotationPresent

getAnnotations

getDeclaredAnnotations