java.lang
클래스 Package

java.lang.Object 
  java.lang.Package

모든 구현된 인터페이스:

AnnotatedElement

public class Package
extends Object 
implements AnnotatedElement 

Package객체는 Java 패키지의 구현 및 사양에 대한 버전 정보를 보관 유지합니다. 이 버전 정보는 클래스를 로드한 ClassLoader 인스턴스에 의해 꺼내져, 이용할 수 있게 됩니다. 보통, 버전 정보는 클래스와 함께 배포되는 MANIFEST에 포함되어 있습니다.

패키지를 구성하는 클래스의 집합이, 특정의 사양을 구현하고 있는 경우가 있습니다. 그 경우, 사양의 타이틀, 버전 번호, 벤더를 나타내는 캐릭터 라인이 그 사양을 식별합니다. 어플리케이션은 패키지가 있는 사양의 특정의 버전과 호환성이 있을지 어떨지를 문의할 수 있습니다 . 자세한 내용은 isCompatibleWith 메서드의 설명을 참조하십시오.

RefinedVersion:

. Digits

. Digits RefinedVersion

Digits:

Digit

Digits

Digit:

Character.isDigit(char) 가 true를 돌려주는 임의의 문자 (0, 1, 2 등)

구현의 타이틀, 버전 및 벤더를 나타내는 캐릭터 라인은 구현을 식별합니다. 이러한 캐릭터 라인은 문제가 발생했을 경우에 관련된 패키지의 정확한 리포트를 유효하게 하기 위해서 이용할 수 있습니다. 구현에 관한 3개의 캐릭터 라인의 내용은 모두 벤더에 고유의 것입니다. 구현 버전 캐릭터 라인에는 특정의 구문은 없습니다. 따라서, 필요한 버전의 식별자와 동일한지 어떤지를 조사해 호환성의 체크를의해 주세요.

각각의 ClassLoader인스턴스내에서는 같은 Java 패키지에 유래하는 클래스는 모두 동일한 Package 객체를 가집니다. 이 클래스의 static 메서드군을 사용하면, 이름으로 패키지를 찾거나 현재의 클래스 로더가 인식하는 모든 패키지를 취득하거나 할 수 있습니다 .

관련 항목:

메서드 개요

<A extends Annotation > A	getAnnotation (Class <A> annotationClass) 지정된 형태의 주석이 존재하는 경우는 지정된 형태의 요소의 주석을 리턴합니다.
Annotation []	getAnnotations () 이 요소에 존재하는 모든 주석을 리턴합니다 (이 요소에 주석이 없는 경우는 길이 제로의 배열을 리턴합니다).
Annotation []	getDeclaredAnnotations () 이 요소에 직접 존재하는 모든 주석을 리턴합니다.
String	getImplementationTitle () 이 패키지의 타이틀을 리턴합니다.
String	getImplementationVendor () 이 구현을 제공한 조직, 벤더, 또는 기업의 이름을 리턴합니다.
String	getImplementationVersion () 이 구현의 버전을 리턴합니다.
String	getName () 이 패키지의 이름을 리턴합니다.
static Package	getPackage (String name) 호출원의 ClassLoader인스턴스내로부터, 패키지를 이름으로 검색합니다.
static Package []	getPackages () 호출원의 ClassLoader인스턴스가 인식하는 모든 패키지를 취득합니다.
String	getSpecificationTitle () 이 패키지가 구현하는 사양의 타이틀을 리턴합니다.
String	getSpecificationVendor () 이 패키지를 구현하는 클래스의 사양을 소유 및 관리하고 있는 조직, 벤더, 또는 기업의 이름을 리턴합니다.
String	getSpecificationVersion () 이 패키지가 구현하는 사양의 버전 번호를 리턴합니다.
int	hashCode () 패키지명으로부터 해시 코드를 요구해 리턴합니다.
boolean	isAnnotationPresent (Class <? extends Annotation > annotationClass) 지정된 형태의 주석이 이 요소에 존재하는 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다.
boolean	isCompatibleWith (String desired) 이 패키지의 사양 버전을 desired 로 지정한 버전과 비교합니다.
boolean	isSealed () 이 패키지가 씰 되고 있는 경우에 true를 리턴합니다.
boolean	isSealed (URL url) 이 패키지가 지정된 원시 코드 URL에 관해서 씰 되고 있는 경우에 true를 리턴합니다.
String	toString () 이 Package 캐릭터 라인 표현을 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, notify, notifyAll, wait, wait, wait

메서드의 상세

getName

public String  getName()

이 패키지의 이름을 리턴합니다.

반환값:

Java 언어로 패키지에 사용하는 닷 기법에 따르는 이 패키지의 이름. 예를 들어 java.lang

getSpecificationTitle

public String  getSpecificationTitle()

이 패키지가 구현하는 사양의 타이틀을 리턴합니다.

반환값:

사양의 타이틀, 불명한 경우는 null

getSpecificationVersion

public String  getSpecificationVersion()

이 패키지가 구현하는 사양의 버전 번호를 리턴합니다. 이 버전 캐릭터 라인은 「.」(으)로 단락지어진 정의 10 진정수의 순서가 아니면 안됩니다. 캐릭터 라인의 선두에 0을 붙일 수가 있습니다. 버전 캐릭터 라인을 비교하려면, 가장 중량감의 큰 숫자를 비교합니다.

반환값:

사양의 버전 번호, 불명한 경우는 null

getSpecificationVendor

public String  getSpecificationVendor()

이 패키지를 구현하는 클래스의 사양을 소유 및 관리하고 있는 조직, 벤더, 또는 기업의 이름을 리턴합니다.

반환값:

사양의 벤더, 불명한 경우는 null

getImplementationTitle

public String  getImplementationTitle()

이 패키지의 타이틀을 리턴합니다.

반환값:

구현의 타이틀. 불명의 경우는 null

getImplementationVersion

public String  getImplementationVersion()

이 구현의 버전을 리턴합니다. 리턴된 버전 번호는 이 구현의 벤더에 의해 할당할 수 있었던 임의의 캐릭터 라인으로부터 구성되어 정해진 구문이나 Java 런타임이 기대하는 구문이라고 한 것은 없습니다. 리턴된 버전 번호는 이 벤더에 의해 이 패키지의 이 구현에 사용되고 있는 다른 패키지 버전과 동일한지 어떤지를 비교하는데 사용할 수 있습니다.

반환값:

구현의 버전 번호. 불명의 경우는 null

getImplementationVendor

public String  getImplementationVendor()

이 구현을 제공한 조직, 벤더, 또는 기업의 이름을 리턴합니다.

반환값:

이 패키지를 구현한 벤더

isSealed

public boolean isSealed()

이 패키지가 씰 되고 있는 경우에 true를 리턴합니다.

반환값:

이 패키지가 씰 되고 있는 경우는 true, 그렇지 않은 경우는 false

isSealed

public boolean isSealed(URL  url)

이 패키지가 지정된 원시 코드 URL에 관해서 씰 되고 있는 경우에 true를 리턴합니다.

파라미터:

url - 원시 코드 URL

반환값:

이 패키지가 지정된 URL에 관해서 씰 되고 있는 경우는 true

isCompatibleWith

public boolean isCompatibleWith(String  desired)
                         throws NumberFormatException 

이 패키지의 사양 버전을 desired 로 지정한 버전과 비교합니다. 이 메서드는 패키지의 사양 버전이 지정된 버전 번호와 동등 또는 그 이상의 경우에 true를 리턴합니다.

버전 번호의 비교는 캐릭터 라인 desired와 사양 버전의 캐릭터 라인의 대응하는 요소를 차례로 비교하는 방법으로 실시합니다. 각 요소는 10 진정수에 변환되고 값이 비교됩니다. 사양 버전의 값이 desired 보다 큰 경우는 true가 리턴됩니다 . desired 보다 작은 경우는 false가 리턴됩니다 . 값이 동일한 경우는 피리어드를 스킵의해 다음의 요소의 페어를 비교합니다.

파라미터:

desired - 필요로 하는 버전의 버전 캐릭터 라인

반환값:

이 패키지의 버전 번호가 필요한 버전 번호 이상의 경우는 true

예외:

NumberFormatException - 필요한 버전 또는 이 패키지의 버전이 올바른 닷 단락의 형식이 아닌 경우

getPackage

public static Package  getPackage(String  name)

호출원의 ClassLoader인스턴스내로부터, 패키지를 이름으로 검색합니다. 지정된 클래스에 대응하는 패키지의 인스턴스의 검색에는 호출원의 ClassLoader인스턴스를 사용합니다. 호출원의 ClassLoader인스턴스가 null인 경우는 시스템의 ClassLoader인스턴스에 의해 로드 된 패키지세트로부터, 지정된 패키지를 검색합니다.

클래스 로더가 적절한 속성을 받아 패키지의 인스턴스를 생성했을 경우에만, 패키지는 버전 및 사양의 속성을 가집니다. 보통, 이러한 속성은 클래스에 부수 하는 MANIFEST 내에서 정의되고 있습니다.

파라미터:

name - 패키지의 이름. 예: java.lang

반환값:

요구된 이름의 패키지. 어카이브(archive) 또는 코드 베이스로부터 패키지의 정보를 얻을 수 없었던 경우는 null 가능성도 있다

getPackages

public static Package [] getPackages()

호출원의 ClassLoader인스턴스가 인식하는 모든 패키지를 취득합니다. 리턴된 패키지는 그 ClassLoader인스턴스를 개입시켜 로드 된 클래스, 또는 그 ClassLoader인스턴스로부터 이름으로 액세스 할 수 있는 클래스에 대응하고 있습니다. 호출원의 ClassLoader인스턴스가 bootstrap ClassLoader인스턴스인 경우 (구현에 따라서는 null 로 나타내진다)는 bootstrap ClassLoader인스턴스에 의해 로드 된 클래스에 대응하는 패키지만이 리턴됩니다 .

반환값:

호출원의 ClassLoader인스턴스가 인식하는 모든 패키지의 새로운 배열. 인식하는 패키지가 없는 경우는 길이 0 배열

hashCode

public int hashCode()

패키지명으로부터 해시 코드를 요구해 리턴합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

패키지명으로부터 요구한 해시 코드

관련 항목:

Object.equals(java.lang.Object), Hashtable

toString

public String  toString()

이 Package 캐릭터 라인 표현을 리턴합니다. 값은 캐릭터 라인 「package」 및 패키지의 이름입니다. 패키지의 타이틀이 정의되고 있는 경우는 캐릭터 라인에 추가됩니다. 패키지의 버전이 정의되고 있는 경우는 캐릭터 라인에 추가됩니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

패키지의 캐릭터 라인 표현

getAnnotation

public <A extends Annotation > A getAnnotation(Class <A> annotationClass)

인터페이스 AnnotatedElement 기술:

지정된 형태의 주석이 존재하는 경우는 지정된 형태의 요소의 주석을 리턴합니다. 그렇지 않은 경우는 null을 리턴합니다.

정의:

인터페이스 AnnotatedElement 내의 getAnnotation

파라미터:

annotationClass - 어노테이션에 대응하는 Class 객체

반환값:

존재하는 경우는 지정된 어노테이션의 요소의 주석. 그렇지 않은 경우는 null

isAnnotationPresent

public boolean isAnnotationPresent(Class <?  extends Annotation > annotationClass)

인터페이스 AnnotatedElement 기술:

지정된 형태의 주석이 이 요소에 존재하는 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다. 이 메서드는 주로 마커 주석에의 간이 액세스를 목적으로 설계되고 있습니다.

정의:

인터페이스 AnnotatedElement 내의 isAnnotationPresent

파라미터:

annotationClass - 어노테이션에 대응하는 Class 객체

반환값:

지정된 어노테이션의 주석이 이 요소에 존재하는 경우는 true, 그렇지 않은 경우는 false

getAnnotations

public Annotation [] getAnnotations()

인터페이스 AnnotatedElement 기술:

이 요소에 존재하는 모든 주석을 리턴합니다 (이 요소에 주석이 없는 경우는 길이 제로의 배열을 리턴합니다). 이 메서드의 호출원래는 리턴된 배열을 자유롭게 변경할 수 있습니다. 이 변경은 다른 호출 바탕으로 리턴된 배열에 영향을 미치지 않습니다.

정의:

인터페이스 AnnotatedElement 내의 getAnnotations

반환값:

이 요소에 존재하는 모든 주석

getDeclaredAnnotations

public Annotation [] getDeclaredAnnotations()

인터페이스 AnnotatedElement 기술:

이 요소에 직접 존재하는 모든 주석을 리턴합니다. 이 인터페이스에 있는 다른 메서드와는 달라, 이 메서드는 상속된 주석을 무시합니다 (이 요소에 주석이 직접 존재하지 않는 경우는 길이 제로의 배열을 돌려준다). 이 메서드의 호출원래는 리턴된 배열을 자유롭게 변경할 수 있습니다. 이 변경은 다른 호출 바탕으로 리턴된 배열에 영향을 미치지 않습니다.

정의:

인터페이스 AnnotatedElement 내의 getDeclaredAnnotations

반환값:

이 요소에 직접 존재하는 모든 주석