java.security.cert
클래스 CertificateFactorySpi

java.lang.Object 
  |
  +--java.security.cert.CertificateFactorySpi

public abstract class CertificateFactorySpi

extends Object

CertificateFactory 클래스의 Service Provider Interface (SPI)를 정의합니다. 이 클래스의 모든 abstract 메소드는 X. 509 등의 특정의 증명서형의 증명서 팩토리의 구현을 제공하는 각 암호화 서비스 프로바이더에 의해 구현될 필요가 있습니다.

증명서 팩토리는 증명서 오브젝트, 증명서 패스 (CertPath) 및 증명서의 취소 리스트 (CRL) 오브젝트를 부호로부터 생성하기 위해서 사용합니다.

X. 509 의 증명서 팩토리는 java.security.cert.X509Certificate 의 인스턴스인 증명서와java.security.cert.X509CRL 의 인스턴스인 CRL 를 돌려줄 필요가 있습니다.

도입된 버젼:

1.2

관련 항목:

CertificateFactory , Certificate , X509Certificate , CertPath , CRL , X509CRL

생성자의 개요

CertificateFactorySpi ()

메소드의 개요

abstract Certificate	engineGenerateCertificate (InputStream inStream) 증명서 오브젝트를 생성해, 입력 스트림 inStream 로부터 읽어내진 데이터를 사용해 그 증명서 오브젝트를 초기화합니다.
abstract Collection	engineGenerateCertificates (InputStream inStream) 지정된 입력 스트림 inStream 로부터 읽어내진 증명서의 코레크션뷰를 돌려줍니다.
CertPath	engineGenerateCertPath (InputStream inStream) CertPath 오브젝트를 생성해,InputStream 인 inStream 로부터 읽힌 데이터로 초기화합니다.
CertPath	engineGenerateCertPath (InputStream inStream, String encoding) CertPath 오브젝트를 생성해,InputStream 인 inStream 로부터 읽힌 데이터로 초기화합니다.
CertPath	engineGenerateCertPath (List certificates) CertPath 오브젝트를 생성해,Certificate 의 List 로 초기화합니다.
abstract CRL	engineGenerateCRL (InputStream inStream) 증명서의 취소 리스트 (CRL) 오브젝트를 생성해, 입력 스트림 inStream 로부터 읽어내진 데이터를 사용해 초기화합니다.
abstract Collection	engineGenerateCRLs (InputStream inStream) 지정된 입력 스트림 inStream 로부터 읽어내진 CRL 의 코레크션뷰를 돌려줍니다.
Iterator	engineGetCertPathEncodings () 이 증명서 팩토리로 서포트하는 CertPath 의 encode의 반복을 돌려줍니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

CertificateFactorySpi

public CertificateFactorySpi()

메소드의 상세

engineGenerateCertificate

public abstract Certificate  engineGenerateCertificate(InputStream  inStream)
                                               throws CertificateException 

증명서 오브젝트를 생성해, 입력 스트림 inStream 로부터 읽어내진 데이터를 사용해 그 증명서 오브젝트를 초기화합니다.

이 증명서 팩토리에 의해 서포트되고 있는 특수 형식의 증명서를 이용하기 위해서, 돌려주어진 증명서 오브젝트를 대응하는 증명서 클래스에 형태 캐스트 할 수 있습니다. 예를 들어, 이 증명서 팩토리가 X. 509 증명서를 구현하는 경우, 돌려주어진 증명서 오브젝트를 X509Certificate 클래스에 형태 캐스트 할 수 있습니다.

X. 509 증명서의 증명서 팩토리의 경우는 inStream 로 제공되는 증명서는 DER 로 encode 될 필요가 있어, 바이너리 또는 프린트 가능 (Base64)인 부호로 제공되는 일도 있습니다. 증명서가 Base64 의 부호로 제공되었을 경우, 선두는 -----BEGIN CERTIFICATE----- 에 의해 단락지어져 종단은 -----END CERTIFICATE----- 에 의해 단락지어질 필요가 있습니다.

지정된 입력 스트림이 mark 및 reset 를 서포트하고 있지 않는 경우, 이 메소드는 입력 스트림 전체를 사용합니다. 그렇지 않은 경우, 이 메소드가 불려 갈 때마다 증명서를 1 개 소비해, 입력 스트림의 read 위치는 고유의 end-of-certificate 마커의 나중에 다음에 사용 가능한 바이트로 설정됩니다. 고유의 end-of-certificate 마커 (EOF 이외)가 입력 스트림의 데이터에 포함되지 않고 증명서가 구문 분석 된 후에 데이터가 계속되는 경우는 CertificateException 가 슬로우 됩니다.

파라미터:

inStream - 증명서 데이터를 가지는 입력 스트림

반환값:

입력 스트림의 데이터를 사용해 초기화된 증명서 오브젝트

예외:

CertificateException - 구문 분석 에러의 경우

engineGenerateCertPath

public CertPath  engineGenerateCertPath(InputStream  inStream)
                                throws CertificateException 

CertPath 오브젝트를 생성해,InputStream 인 inStream 로부터 읽힌 데이터로 초기화합니다. 데이터는 디폴트의 encode가 되고 있으면(자) 가정됩니다.

파라미터:

inStream - 데이터가 포함되는 InputStream

반환값:

InputStream 로부터의 데이터로 초기화된 CertPath

예외:

CertificateException - 복호화(decode)중에 예외가 발생했을 경우

도입된 버젼:

1.4

engineGenerateCertPath

public CertPath  engineGenerateCertPath(InputStream  inStream,
                                       String  encoding)
                                throws CertificateException 

CertPath 오브젝트를 생성해,InputStream 인 inStream 로부터 읽힌 데이터로 초기화합니다. 데이터는 지정한 encode가 되고 있으면(자) 가정됩니다.

이 메소드는 Java 2 Platform Standard Edition 의 버젼 1.4 로 추가되었습니다. 기존의 서비스 프로바이더와의 하위 호환성을 유지하기 위해서,abstract 에는 하지 못하고, 디폴트로 UnsupportedOperationException 를 슬로우 합니다.

파라미터:

inStream - 데이터가 포함되는 InputStream

encoding - 데이터로 사용되는 encode

반환값:

InputStream 로부터의 데이터로 초기화된 CertPath

예외:

CertificateException - 복호화(decode)중에 예외가 발생했을 경우, 혹은 지정한 encode가 서포트되어 있지 않은 경우

UnsupportedOperationException - 메소드가 서포트되어 있지 않은 경우

도입된 버젼:

1.4

engineGenerateCertPath

public CertPath  engineGenerateCertPath(List  certificates)
                                throws CertificateException 

CertPath 오브젝트를 생성해,Certificate 의 List 로 초기화합니다.

제공되는 증명서는 CertificateFactory 로 서포트되고 있는 종류가 아니면 안됩니다.

이 메소드는 Java 2 Platform Standard Edition 의 버젼 1.4 로 추가되었습니다. 기존의 서비스 프로바이더와의 하위 호환성을 유지하기 위해서,abstract 에는 하지 못하고, 디폴트로 UnsupportedOperationException 를 슬로우 합니다.

파라미터:

certificates - Certificate 의 List

반환값:

제공된 증명서의 리스트로 초기화된 CertPath

예외:

CertificateException - 에러가 발생하는 경우

UnsupportedOperationException - 메소드가 서포트되어 있지 않은 경우

도입된 버젼:

1.4

engineGetCertPathEncodings

public Iterator  engineGetCertPathEncodings()

이 증명서 팩토리로 서포트하는 CertPath 의 encode의 반복을 돌려줍니다. 반복의 처음은 디폴트의 encode가 됩니다. 표준의 encode명에 대해서는 「Java Certification Path API Programmer's Guide」 의 부록 A 를 참조해 주세요.

돌려주어진 Iterator 를 remove 메소드로 변경하려고 하면(자),UnsupportedOperationException 가 슬로우 됩니다.

이 메소드는 Java 2 Platform Standard Edition 의 버젼 1.4 로 추가되었습니다. 기존의 서비스 프로바이더와의 하위 호환성을 유지하기 위해서,abstract 에는 하지 못하고, 디폴트로 UnsupportedOperationException 를 슬로우 합니다.

반환값:

서포트되는 CertPath 의 encode (String 로서)의 이름에 있어서의 Iterator

예외:

UnsupportedOperationException - 메소드가 서포트되어 있지 않은 경우

도입된 버젼:

1.4

engineGenerateCertificates

public abstract Collection  engineGenerateCertificates(InputStream  inStream)
                                               throws CertificateException 

지정된 입력 스트림 inStream 로부터 읽어내진 증명서의 코레크션뷰를 돌려줍니다. 코레크션뷰는 비었을 경우도 있습니다.

이 증명서 팩토리에 의해 서포트되고 있는 특수한 형식의 증명서를 이용하기 위해서, 돌려주어진 코레크션뷰의 각 요소를 대응하는 증명서 클래스에 형태 캐스트 할 수 있습니다. 예를 들어, 이 증명서 팩토리가 X. 509 증명서를 구현하는 경우, 돌려주어진 콜렉션내의 요소를 X509Certificate 클래스에 형태 캐스트 할 수 있습니다.

X. 509 증명서의 증명서 팩토리의 경우는 inStream 에는 generateCertificate 로 설명되고 있는 형식의, DER 로 encode 된 단일의 증명서가 저장됩니다. 또,inStream 에는 PKCS#7 증명 연쇄가 저장됩니다. 이것은 PKCS#7 SignedData 오브젝트로, 상위 필드는 certificates 뿐입니다. 특히, 서명과 내용은 무시됩니다. 이 형식의 경우, 복수의 증명서를 1 회에 다운로드할 수 있습니다. 증명서가 없는 경우는 하늘의 콜렉션이 돌려주어집니다.

지정된 입력 스트림이 mark 및 reset 를 서포트하고 있지 않는 경우, 이 메소드는 입력 스트림 전체를 사용합니다.

파라미터:

inStream - 증명서를 가지는 입력 스트림

반환값:

입력 스트림으로부터 의 데이터를 사용해 초기화된 java.security.cert.Certificate 오브젝트의 코레크션뷰. 비었을 경우도 있다

예외:

CertificateException - 구문 분석 에러의 경우

engineGenerateCRL

public abstract CRL  engineGenerateCRL(InputStream  inStream)
                               throws CRLException 

증명서의 취소 리스트 (CRL) 오브젝트를 생성해, 입력 스트림 inStream 로부터 읽어내진 데이터를 사용해 초기화합니다.

이 증명서 팩토리에 의해 서포트되고 있는 특수한 형식의 CRL 를 이용하기 위해서, 돌려주어진 CRL 오브젝트를 대응하는 CRL 클래스에 형태 캐스트 할 수 있습니다. 예를 들어, 이 증명서 팩토리가 X. 509 CRL 를 구현하는 경우, 돌려주어진 CRL 오브젝트를 X509CRL 클래스에 형태 캐스트 할 수 있습니다.

지정된 입력 스트림이 mark 및 reset 를 서포트하고 있지 않는 경우, 이 메소드는 입력 스트림 전체를 사용합니다. 그렇지 않은 경우, 이 메소드가 불려 갈 때마다 CRL 를 1 개 소비해, 입력 스트림의 read 위치는 고유의 end-of-CRL 마커의 나중에 다음에 사용 가능한 바이트로 설정됩니다. 고유의 end-of-CRL 마커 (EOF 이외)가 입력 스트림의 데이터에 포함되지 않고 증명서가 구문 분석 된 후에 데이터가 계속되는 경우는 CRLException 가 슬로우 됩니다.

파라미터:

inStream - CRL 데이터를 가지는 입력 스트림

반환값:

입력 스트림의 데이터를 사용해 초기화된 CRL 오브젝트

예외:

CRLException - 구문 분석 에러의 경우

engineGenerateCRLs

public abstract Collection  engineGenerateCRLs(InputStream  inStream)
                                       throws CRLException 

지정된 입력 스트림 inStream 로부터 읽어내진 CRL 의 코레크션뷰를 돌려줍니다. 코레크션뷰는 비었을 경우도 있습니다.

이 증명서 팩토리에 의해 서포트되고 있는 특수한 형식의 CRL 를 이용하기 위해서, 돌려주어진 코레크션뷰의 각 요소를 대응하는 CRL 클래스에 형태 캐스트 할 수 있습니다. 예를 들어, 이 증명서 팩토리가 X. 509 CRL 를 구현하는 경우, 돌려주어진 콜렉션내의 요소를 X509CRL 클래스에 형태 캐스트 할 수 있습니다.

X. 509 CRL 의 증명서 팩토리의 경우는 inStream 에는 DER 로 encode 된 1 개의 CRL 가 저장됩니다. 또,inStream 에는 PKCS#7 CRL 세트가 저장됩니다. 이것은 PKCS#7 SignedData 오브젝트로, 상위 필드는 crls 뿐입니다. 특히, 서명과 내용은 무시됩니다. 이 형식의 경우, 복수의 CRL 를 1 회에 다운로드할 수 있습니다. CRL 가 없는 경우는 하늘의 콜렉션이 돌려주어집니다.

지정된 입력 스트림이 mark 및 reset 를 서포트하고 있지 않는 경우, 이 메소드는 입력 스트림 전체를 사용합니다.

파라미터:

inStream - CRL 를 가지는 입력 스트림

반환값:

입력 스트림으로부터 의 데이터를 사용해 초기화된 java.security.cert.Certificate 오브젝트의 코레크션뷰. 비었을 경우도 있다

예외:

CRLException - 구문 분석 에러의 경우