javax.net.ssl
클래스 KeyManagerFactory

java.lang.Object 
  |
  +--javax.net.ssl.KeyManagerFactory

public class KeyManagerFactory

extends Object

이 클래스는 열쇠 데이터의 소스에 근거해, 열쇠 매니저의 팩토리로서 기능합니다. 각 열쇠 매니저는 시큐어 소켓이 사용하는 열쇠 데이터를 관리합니다. 열쇠 데이터는 키스트아, 또는 프로바이더 고유의 소스, 혹은 그 양쪽 모두에 근거합니다.

도입된 버젼:

1.4

관련 항목:

KeyManager

생성자의 개요

protected

KeyManagerFactory (KeyManagerFactorySpi factorySpi, Provider provider, String algorithm) KeyManagerFactory 오브젝트를 작성합니다.

메소드의 개요

String	getAlgorithm () 이 KeyManagerFactory 오브젝트의 알고리즘명을 돌려줍니다.
static String	getDefaultAlgorithm () 디폴트의 KeyManagerFactory 알고리즘명을 취득합니다.
static KeyManagerFactory	getInstance (String algorithm) 지정된 열쇠 관리 알고리즘을 구현하는 KeyManagerFactory 오브젝트를 생성합니다.
static KeyManagerFactory	getInstance (String algorithm, Provider provider) 지정된 프로바이더로부터, 지정된 열쇠 관리 알고리즘의 KeyManagerFactory 오브젝트를 작성합니다.
static KeyManagerFactory	getInstance (String algorithm, String provider) 지정된 프로바이더로부터, 지정된 열쇠 관리 알고리즘의 KeyManagerFactory 오브젝트를 작성합니다.
KeyManager []	getKeyManagers () 열쇠 데이터의 종류 마다 1 개의 열쇠 매니저를 돌려줍니다.
Provider	getProvider () 이 KeyManagerFactory 오브젝트의 프로바이더를 돌려줍니다.
void	init (KeyStore ks, char[] password) 열쇠 데이터의 소스를 사용해 이 팩토리를 초기화합니다.
void	init (ManagerFactoryParameters spec) 프로바이더 고유의 열쇠 데이터의 소스를 사용해, 이 팩토리를 초기화합니다.

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

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

생성자의 상세

KeyManagerFactory

protected KeyManagerFactory(KeyManagerFactorySpi  factorySpi,
                            Provider  provider,
                            String  algorithm)

KeyManagerFactory 오브젝트를 작성합니다.

파라미터:

factorySpi - delegate처

provider - 프로바이더

algorithm - 알고리즘

메소드의 상세

getDefaultAlgorithm

public static final String  getDefaultAlgorithm()

디폴트의 KeyManagerFactory 알고리즘명을 취득합니다.

디폴트의 알고리즘은 ssl.KeyManagerFactory.algorithm 시큐러티 프로퍼티의 값을 목적의 알고리즘명으로 설정하는 것에 의해, 실행시로 변경할 수 있습니다. 알고리즘명은 Java 시큐러티 프로퍼티 파일로 설정하는지 Security.setProperty(java.lang.String, java.lang.String) 를 호출하는 것에 의해 설정합니다.

반환값:

Java 시큐러티 프로퍼티 파일로 지정되고 있는 디폴트의 알고리즘명. 프로퍼티가 존재하지 않는 경우는 구현 고유의 디폴트

관련 항목:

Security.setProperty(java.lang.String, java.lang.String)

getAlgorithm

public final String  getAlgorithm()

이 KeyManagerFactory 오브젝트의 알고리즘명을 돌려줍니다.

이 KeyManagerFactory 오브젝트를 작성한 getInstance 호출로 지정된 알고리즘명이 돌려주어집니다.

반환값:

이 KeyManagerFactory 오브젝트의 알고리즘명

getInstance

public static final KeyManagerFactory  getInstance(String  algorithm)
                                           throws NoSuchAlgorithmException 

지정된 열쇠 관리 알고리즘을 구현하는 KeyManagerFactory 오브젝트를 생성합니다.

요구된 열쇠 관리 알고리즘의 구현을 디폴트의 프로바이더 패키지가 제공하고 있는 경우는 그 구현을 포함한 KeyManagerFactory 의 인스턴스가 돌려주어집니다. 디폴트의 프로바이더 패키지로 목적의 알고리즘이 제공되어 있지 않은 경우에는 다른 프로바이더 패키지가 검색됩니다.

파라미터:

algorithm - 요구된 알고리즘의 표준명

반환값:

새로운 KeyManagerFactory 오브젝트

예외:

NoSuchAlgorithmException - 지정된 알고리즘이, 디폴트의 프로바이더 패키지에도, 검색한 것 외의 프로바이더 패키지에도 없는 경우

getInstance

public static final KeyManagerFactory  getInstance(String  algorithm,
                                                  String  provider)
                                           throws NoSuchAlgorithmException ,
                                                  NoSuchProviderException 

지정된 프로바이더로부터, 지정된 열쇠 관리 알고리즘의 KeyManagerFactory 오브젝트를 작성합니다.

파라미터:

algorithm - 요구된 알고리즘의 표준명

provider - 프로바이더명

반환값:

새로운 KeyManagerFactory 오브젝트

예외:

NoSuchAlgorithmException - 지정된 프로바이더로 지정된 알고리즘이 없는 경우

NoSuchProviderException - 지정된 프로바이더가 설정되어 있지 않은 경우

IllegalArgumentException - 프로바이더가 지정되어 있지 않은 경우

getInstance

public static final KeyManagerFactory  getInstance(String  algorithm,
                                                  Provider  provider)
                                           throws NoSuchAlgorithmException 

지정된 프로바이더로부터, 지정된 열쇠 관리 알고리즘의 KeyManagerFactory 오브젝트를 작성합니다.

파라미터:

algorithm - 요구된 알고리즘의 표준명

provider - 프로바이더의 인스턴스

반환값:

새로운 KeyManagerFactory 오브젝트

예외:

NoSuchAlgorithmException - 지정된 프로바이더로 지정된 알고리즘이 없는 경우

IllegalArgumentException - 프로바이더가 지정되어 있지 않은 경우

getProvider

public final Provider  getProvider()

이 KeyManagerFactory 오브젝트의 프로바이더를 돌려줍니다.

반환값:

이 KeyManagerFactory 오브젝트의 프로바이더

init

public final void init(KeyStore  ks,
                       char[] password)
                throws KeyStoreException ,
                       NoSuchAlgorithmException ,
                       UnrecoverableKeyException 

열쇠 데이터의 소스를 사용해 이 팩토리를 초기화합니다.

많은 경우, 프로바이더는 키스트아를 사용해, 시큐어 소켓의 네고시에이션중에 사용하는 열쇠 데이터를 취득합니다. 키스트아는 통상 패스워드로 보호되고 있습니다.

보다 유연하게 초기화를 실시하려면 ,init(ManagerFactoryParameters) 를 참조해 주세요.

파라미터:

ks - 키스트아 또는 null

password - 키스트아의 열쇠를 복원하기 위한 패스워드

예외:

KeyStoreException - 이 처리가 실패했을 경우

NoSuchAlgorithmException - 지정된 프로바이더로 지정된 알고리즘이 없는 경우

UnrecoverableKeyException - 지정된 패스워드가 잘못되어 있는 경우 등, 열쇠를 복원할 수 없는 경우

init

public final void init(ManagerFactoryParameters  spec)
                throws InvalidAlgorithmParameterException 

프로바이더 고유의 열쇠 데이터의 소스를 사용해, 이 팩토리를 초기화합니다.

일부의 프로바이더에서는 키스트아와 패스워드 이외에, 초기화 파라미터를 필요로 하는 일이 있습니다. 이러한 프로바이더의 경우는 프로바이더에 정의된 ManagerFactoryParameters 구현을 건네줄 필요가 있습니다. 프로바이더는 ManagerFactoryParameters 구현의 메소드를 호출해, 필요한 정보를 취득합니다.

파라미터:

spec - 프로바이더 고유의 파라미터 사양의 구현

예외:

InvalidAlgorithmParameterException - 에러가 발생했을 경우

getKeyManagers

public final KeyManager [] getKeyManagers()

열쇠 데이터의 종류 마다 1 개의 열쇠 매니저를 돌려줍니다.

반환값:

열쇠 매니저