java.security.cert
클래스 CertPath

java.lang.Object 
  java.security.cert.CertPath

모든 구현된 인터페이스:

Serializable

public abstract class CertPath
extends Object 
implements Serializable 

불변인 인증서 의 순서 (인증서 패스)입니다.

이것은 모든 CertPath에 공통된 메서드를 정의하는 abstract 클래스입니다. 서브 클래스에서는 다양한 종류의 인증서 (X. 509, PGP 등)을 처리할 수 있습니다.

모든 CertPath에는 타입, Certificate 리스트, 지원 되는 1개 이상의 encode가 있습니다. CertPath 클래스는 불변이기 때문에 구축 후에 외부로부터 눈에 보이는 형태로 CertPath를 변경할 수 없습니다. 이 제한은 이 클래스의 모든 public 필드와 메서드, 그리고 서브 클래스에서 추가 또는 오버라이드(override) 된 public 필드와 메서드에 들어맞읍니다.

타입은 String로 인증서 패스로 Certificate 타입을 특정합니다. 인증서 패스 certPath 각 인증서 cert에 서는 cert.getType(). equals(certPath.getType())는 true가 아니면 안됩니다.

Certificate 리스트는 0 개 이상의 Certificate로 부터 되는 순서 첨부의 List 입니다. 이 List와 포함되는 Certificate는 불변일 필요가 있습니다.

각각의 CertPath객체는 다른 상대에게 포함하거나 전송하거나 하기 위해서 바이트 배열로 변환할 수 있도록, 1개 이상의 encode를 지원 하고 있지 않으면 안됩니다. 가능한 한 그 encode는 PKCS#7와 같이 명확하게 문서화 되고 있는 표준으로 합니다. CertPath로 지원 되고 있는 encode 가운데 1개를, 디폴트의 encode로 합니다. encode를 명시적으로 요구하지 않는 경우 (예를 들어 getEncoded() 메서드)에 디폴트의 encode가 사용됩니다.

모든 CertPath객체는 Serializable 이기도 합니다. 직렬화중에 CertPath객체는 대체 CertPathRep 객체로 해석 처리됩니다. 이것에 의해 CertPath객체는 기본이 되는 구현에 관계없이 등가인 표현에 직렬화 됩니다.

CertPath객체는 CertificateFactory로 작성됩니다만, CertPathBuilder와 같은 다른 클래스로부터 리턴된 일도 있습니다.

규칙에서는 X509Certificate로 구성되어 있는 X. 509 CertPath는 타겟 인증서 로 시작되어, 트러스트 엥커가 발행한 인증서 로 끝나도록 정렬 되고 있습니다. 즉, 어느 인증서 의 발행자는 다음의 인증서 의 피인증자가 됩니다. TrustAnchor를 나타내는 인증서는 인증서 패스에 포함되지 않습니다. 미검사의 X. 509 CertPath는 이 규칙에 따르지 않습니다. 인증서 패스가 무효가 되는 원인이 되는 이 규칙으로부터의 일탈을 PKIX CertPathValidator는 검출해, CertPathValidatorException을 Throw 합니다.

병행 액세스

모든 CertPath객체는 thread에 대해서 안전하지 않으면 안됩니다. 즉, 이 클래스에서 정의된 메서드는 악영향을 주는 일 없이, 복수 thread가 병행해 단일 CertPath 객체 (또는 1개 이상) 상에서 호출할 수 있습니다 . 이것은 CertPath.getCertificates가 돌려주는 List에 대해서도 들어맞읍니다.

CertPath객체는 불변으로 한편 thread에 대해서 안전하지 않으면 안 되기 때문에 액세스의 동기의 걱정을 하는 일 없이, 다양한 코드에 이 객체를 건네줄 수가 있습니다.

도입된 버전 :

1.4

관련 항목:

CertificateFactory, CertPathBuilder, 직렬화 된 형식

중첩(Nested) 클래스 개요

protected static class

CertPath.CertPathRep 직렬화의 대체 CertPath 클래스입니다.

생성자 개요

protected

CertPath (String type) 지정된 타입의 CertPath를 작성합니다.

메서드 개요

boolean	equals (Object other) 지정된 객체와 이 인증서 패스가 동일한지 어떤지를 비교합니다.
abstract List <? extends Certificate >	getCertificates () 이 인증서 패스내의 인증서 의 리스트를 리턴합니다.
abstract byte[]	getEncoded () 디폴트의 encode를 사용해, 이 인증서 패스의 encode 된 형식을 리턴합니다.
abstract byte[]	getEncoded (String encoding) 지정한 encode를 사용해, 이 인증서 패스의 encode 된 형식을 리턴합니다.
abstract Iterator <String >	getEncodings () 이 인증서 패스로 지원하는 encode의 반복을 리턴합니다.
String	getType () 이 인증서 패스내의 Certificate 타입을 리턴합니다.
int	hashCode () 이 인증서 패스의 해시 코드를 리턴합니다.
String	toString () 이 인증서 패스의 캐릭터 라인 표현을 리턴합니다.
protected Object	writeReplace () 직렬화 되는 CertPath를 CertPathRep 객체에 옮겨놓습니다.

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

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

생성자 상세

CertPath

protected CertPath(String  type)

지정된 타입의 CertPath를 작성합니다.

대부분의 사용자는 CertificateFactory를 사용해 CertPath를 작성하기 위해, 이 생성자는 보호되고 있습니다.

파라미터:

type - 이 패스내의 Certificate 타입의 표준명

메서드의 상세

getType

public String  getType()

이 인증서 패스내의 Certificate 타입을 리턴합니다. 이것은 인증서 패스내의 모든 Certificate에 대한 cert.getType() 로 리턴된 캐릭터 라인과 같습니다.

반환값:

이 인증서 패스내의 Certificate 타입 (null은 되지 않는다)

getEncodings

public abstract Iterator <String > getEncodings()

이 인증서 패스로 지원하는 encode의 반복을 리턴합니다. 반복의 처음은 디폴트의 encode가 됩니다. 리턴된 Iterator를 remove 메서드로 변경하려고 하면, UnsupportedOperationException가 발생 됩니다.

반환값:

지원 되는 encode (String 로서)의 이름에 대한 Iterator

equals

public boolean equals(Object  other)

지정된 객체와 이 인증서 패스가 동일한지 어떤지를 비교합니다. 2개의 CertPath 타입이 동일하고, 인증서 의 List이 (즉 List 내의 Certificate가 암묵적으로) 동일한 경우, 이러한 CertPath는 동일하게 됩니다. CertPath는 CertPath가 아닌 객체와 동일해질 것은 없습니다.

이 알고리즘은 이 메서드에 구현되고 있습니다. 오버라이드(override) 할 때는 여기서 설명한 동작이 유지되도록 하지 않으면 안됩니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

other - 이 인증서 패스와 동일한지 어떤지가 판정되는 객체

반환값:

지정한 객체가 이 인증서 패스에 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

이 인증서 패스의 해시 코드를 리턴합니다. 인증서 패스의 해시 코드는 다음의 계산의 결과로서 정의됩니다.

  hashCode = path.getType(). hashCode();
  hashCode = 31*hashCode + path.getCertificates(). hashCode();
 

이것에 의해 Object.hashCode 일반 규약에 의해 요구되도록, 임의의 2개의 인증서 패스 path1와 path2로 path1.equals(path2) 이면 path1.hashCode() ==path2.hashCode()가 되는 것이 보증됩니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 인증서 패스에 있어서의 해시 코드값

관련 항목:

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

toString

public String  toString()

이 인증서 패스의 캐릭터 라인 표현을 리턴합니다. 패스의 각 Certificate로 toString 메서드를 호출합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 인증서 패스의 캐릭터 라인 표현

getEncoded

public abstract byte[] getEncoded()
                           throws CertificateEncodingException 

디폴트의 encode를 사용해, 이 인증서 패스의 encode 된 형식을 리턴합니다.

반환값:

encode 된 바이트

예외:

CertificateEncodingException - encode 에러가 발생했을 경우

getEncoded

public abstract byte[] getEncoded(String  encoding)
                           throws CertificateEncodingException 

지정한 encode를 사용해, 이 인증서 패스의 encode 된 형식을 리턴합니다.

파라미터:

encoding - 사용하는 encode명

반환값:

encode 된 바이트

예외:

CertificateEncodingException - encode의 에러가 발생했을 경우, 혹은 지정한 encode가 지원 되어 있지 않은 경우

getCertificates

public abstract List <?  extends Certificate > getCertificates()

이 인증서 패스내의 인증서 의 리스트를 리턴합니다. 리턴된 List는 불변으로 thread에 대해서 안전하지 않으면 안됩니다.

반환값:

Certificate 불변인 List (빈 리스트는 가능, null은 불가)

writeReplace

protected Object  writeReplace()
                       throws ObjectStreamException 

직렬화 되는 CertPath를 CertPathRep 객체에 옮겨놓습니다.

반환값:

직렬화 되는 CertPathRep

예외:

ObjectStreamException - 이 인증서 패스를 나타내는 CertPathRep를 생성할 수 없었던 경우