java.lang
클래스 Package

java.lang.Object 
  |
  +--java.lang.Package

public class Package

extends Object

Package 오브젝트는 Java 패키지의 구현 및 사양에 대한 버젼 정보를 보관 유지합니다. 이 버젼 정보는 클래스를 로드한 클래스 로더에 의해 꺼내져, 이용할 수 있게 됩니다. 통상, 버젼 정보는 클래스와 함께 배포되는 마니페스트에 저장되고 있습니다.

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

사양 버젼의 번호에는 정의 10 진정수를 피리어드 (. )(으)로 단락짓는 구문의 「듀이 10 진분류법」을 사용합니다. 예를 들어, 「2.0」이나 「1.2. 3.4. 5.6. 7」과 같은 버젼 번호를 사용합니다. 이것에 의해 숫자를 확장해, 메이저 버젼, 마이너 버젼, 마이크로 버젼등을 나타낼 수가 있습니다. 버젼 번호는 숫자로 시작되지 않으면 안됩니다.

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

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

관련 항목:

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)

메소드의 개요

String	getImplementationTitle () 이 패키지의 타이틀을 돌려줍니다.
String	getImplementationVendor () 이 구현을 제공한 조직, 벤더, 또는 기업의 이름을 돌려줍니다.
String	getImplementationVersion () 이 구현의 버젼을 돌려줍니다.
String	getName () 패키지의 이름을 돌려줍니다.
static Package	getPackage (String name) 호출원의 클래스 로더내로부터, 패키지를 이름으로 검색합니다.
static Package []	getPackages () 호출원의 클래스 로더가 인식하는 모든 패키지를 취득합니다.
String	getSpecificationTitle () 이 패키지가 구현하는 사양의 타이틀을 돌려줍니다.
String	getSpecificationVendor () 이 패키지를 구현하는 클래스의 사양을 소유 및 관리하고 있는 조직, 벤더, 또는 기업의 이름을 돌려줍니다.
String	getSpecificationVersion () 이 패키지가 구현하는 사양의 버젼 번호를 돌려줍니다.
int	hashCode () 패키지명으로부터 해시 코드를 요구해 돌려줍니다.
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)

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

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

파라미터:

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

반환값:

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

getPackages

public static Package [] getPackages()

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

반환값:

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

hashCode

public int hashCode()

패키지명으로부터 해시 코드를 요구해 돌려줍니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

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

관련 항목:

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

toString

public String  toString()

이 Package 의 캐릭터 라인 표현을 돌려줍니다. 값은 캐릭터 라인 "package" 및 패키지의 이름입니다. 패키지의 타이틀이 정의되고 있는 경우는 캐릭터 라인에 추가됩니다. 패키지의 버젼이 정의되고 있는 경우는 캐릭터 라인에 추가됩니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

패키지의 캐릭터 라인 표현