|
JavaTM Platform Standard Ed. 6 |
|||||||||
앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
java.lang.Object java.security.cert.CertPathBuilder
public class CertPathBuilder
증명서 패스 (증명서 체인이라고도 불린다)를 구축하기 위한 클래스입니다.
이 클래스는, 프로바이더 베이스의 아키텍쳐(architecture)를 사용합니다. CertPathBuilder
를 작성하려면 , static getInstance
메소드 가운데 1 개를 호출해, 작성하는 CertPathBuilder
의 알고리즘명과 프로바이더명 (생략 가능)을 건네줍니다.
CertPathBuilder
객체가 작성되면(자),build
메소드를 호출해 알고리즘에 특정의 파라미터 세트를 건네주는 것으로, 증명서 패스가 구축됩니다. 증명서 패스의 구축에 성공하면(자),CertPathBuilderResult
인터페이스를 구현하는 객체에 그 결과 (구축한 CertPath
를 포함한다)가 돌려주어집니다.
병행 액세스
이 클래스의 static 메소드는, thread 세이프인 것이 보증되고 있습니다. 이 클래스에서 정의되고 있는 static 메소드는, 악영향을 주는 일 없이, 복수 thread가 병행해 호출할 수가 있습니다.
그러나 이것은, 이 클래스에서 정의되고 있는 비 static 메소드에는 들어맞지 않습니다. 특정의 프로바이더로 특히 설명이 없는 한, 단일 CertPathBuilder
인스턴스에 병행해 액세스 할 필요가 있는 복수 thread는, thread간에 동기를 잡아, 필요에 따라서 잠그지 않으면 안됩니다. 다른 CertPathBuilder
인스턴스를 조작하는 복수 thread간으로는, 동기를 잡을 필요는 없습니다.
CertPath
생성자 의 개요 | |
---|---|
protected |
CertPathBuilder (CertPathBuilderSpi builderSpi,
Provider provider,
String algorithm)
지정된 알고리즘의 CertPathBuilder 객체를 작성해, 지정된 프로바이더의 구현 (SPI 객체)을 거기에 캡슐화합니다. |
메소드의 개요 | |
---|---|
CertPathBuilderResult |
build (CertPathParameters params)
지정한 알고리즘의 파라미터 세트를 사용해, 증명서 패스를 구축하려고 합니다. |
String |
getAlgorithm ()
이 CertPathBuilder 의 알고리즘명을 돌려줍니다. |
static String |
getDefaultType ()
Java 시큐리티 프로퍼티 파일로 지정되고 있는 디폴트의 CertPathBuilder 타입을 돌려줍니다. |
static CertPathBuilder |
getInstance (String algorithm)
지정한 알고리즘을 구현하는 CertPathBuilder 객체를 돌려줍니다. |
static CertPathBuilder |
getInstance (String algorithm,
Provider provider)
지정한 알고리즘을 구현하는 CertPathBuilder 객체를 돌려줍니다. |
static CertPathBuilder |
getInstance (String algorithm,
String provider)
지정한 알고리즘을 구현하는 CertPathBuilder 객체를 돌려줍니다. |
Provider |
getProvider ()
이 CertPathBuilder 의 프로바이더를 돌려줍니다. |
클래스 java.lang. Object 로부터 상속된 메소드 |
---|
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait |
생성자 의 상세 |
---|
protected CertPathBuilder(CertPathBuilderSpi builderSpi, Provider provider, String algorithm)
CertPathBuilder
객체를 작성해, 지정된 프로바이더의 구현 (SPI 객체)을 거기에 캡슐화합니다.
builderSpi
- 프로바이더의 구현provider
- 프로바이더algorithm
- 알고리즘명메소드의 상세 |
---|
public static CertPathBuilder getInstance(String algorithm) throws NoSuchAlgorithmException
CertPathBuilder
객체를 돌려줍니다.
이 메소드는, 최우선의 Provider 로부터 순서에, 등록을 마친 시큐리티 Provider 의 리스트를 횡단(traverse) 합니다. 지정된 알고리즘을 지원하는 최초의 Provider 의 CertPathBuilderSpi 구현을 캡슐화하는 새로운 CertPathBuilder 객체가 돌려주어집니다.
등록이 끝난 프로바이더의 리스트는,Security.getProviders()
메소드 경유로 취득할 수 있습니다.
algorithm
- 요구된 CertPathBuilder
알고리즘의 이름. 표준의 알고리즘명에 대해서는,「Java Certification Path API 개발자 안내」 의 부록 A 를 참조
CertPathBuilder
객체
NoSuchAlgorithmException
- 지정된 알고리즘의 CertPathBuilderSpi 구현을 지원하는 Provider 가 존재하지 않는 경우Provider
public static CertPathBuilder getInstance(String algorithm, String provider) throws NoSuchAlgorithmException , NoSuchProviderException
CertPathBuilder
객체를 돌려줍니다.
지정된 프로바이더의 CertPathBuilderSpi 구현을 캡슐화하는 새로운 CertPathBuilder 객체가 돌려주어집니다. 지정한 프로바이더는, 시큐리티 프로바이더 리스트에 등록할 필요가 있습니다.
등록이 끝난 프로바이더의 리스트는,Security.getProviders()
메소드 경유로 취득할 수 있습니다.
algorithm
- 요구된 CertPathBuilder
알고리즘의 이름. 표준의 알고리즘명에 대해서는,「Java Certification Path API 개발자 안내」 의 부록 A 를 참조provider
- 프로바이더명
CertPathBuilder
객체
NoSuchAlgorithmException
- 지정된 프로바이더로 지정된 알고리즘의 CertPathBuilderSpi 구현이 없는 경우
NoSuchProviderException
- 지정된 프로바이더가 시큐리티 프로바이더 리스트에 등록되지 않은 경우
IllegalArgumentException
- provider
가 null 나 빈 상태(empty)의 경우Provider
public static CertPathBuilder getInstance(String algorithm, Provider provider) throws NoSuchAlgorithmException
CertPathBuilder
객체를 돌려줍니다.
지정된 Provider 객체의 CertPathBuilderSpi 구현을 캡슐화하는 새로운 CertPathBuilder 객체가 돌려주어집니다. 지정된 Provider 객체는, 프로바이더 리스트에 등록할 필요는 없습니다.
algorithm
- 요구된 CertPathBuilder
알고리즘의 이름. 표준의 알고리즘명에 대해서는,「Java Certification Path API 개발자 안내」 의 부록 A 를 참조provider
- 프로바이더
CertPathBuilder
객체
NoSuchAlgorithmException
- 지정된 Provider 객체로 지정된 알고리즘의 CertPathBuilderSpi 구현이 없는 경우
IllegalArgumentException
- provider
가 null 의 경우Provider
public final Provider getProvider()
CertPathBuilder
의 프로바이더를 돌려줍니다.
CertPathBuilder
의 프로바이더public final String getAlgorithm()
CertPathBuilder
의 알고리즘명을 돌려줍니다.
CertPathBuilder
의 알고리즘명public final CertPathBuilderResult build(CertPathParameters params) throws CertPathBuilderException , InvalidAlgorithmParameterException
params
- 알고리즘 파라미터
CertPathBuilderException
- 지정된 파라미터를 채우는 증명서 패스를 구축할 수 없었던 경우
InvalidAlgorithmParameterException
- 지정된 파라미터가 이 CertPathBuilder
에 대해서 올바르지 않은 경우public static final String getDefaultType()
CertPathBuilder
타입을 돌려줍니다. 디폴트의 CertPathBuilder
타입을 나타내는 프로퍼티이 없는 경우는, 캐릭터 라인 「PKIX」를 돌려줍니다. Java 시큐리티 프로퍼티 파일은, <JAVA_HOME>/lib/security/java.security 라는 이름의 파일에 포함되고 있습니다. <JAVA_HOME> 는 java.home 시스템 프로퍼티의 값을 참조하고 있어, JRE 의 인스톨 디렉토리를 나타냅니다.
디폴트의 CertPathBuilder
타입을 사용하는 것은, 어플리케이션으로 getInstance
메소드를 호출할 때 하드 코드 된 타입을 사용하지 않는 경우, 및 사용자가 독자적인 타입을 지정하지 않을 때에 디폴트의 타입을 제공하는 경우입니다.
디폴트의 CertPathBuilder
타입을 변경하려면 , Java 시큐리티 프로퍼티 파일의 certpathbuilder.type 시큐리티 프로퍼티의 값을 목적의 타입으로 설정합니다.
CertPathBuilder
타입. 해당하는 프로퍼티이 존재하지 않는 경우는, 캐릭터 라인 「PKIX」
|
JavaTM Platform Standard Ed. 6 |
|||||||||
앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.