java.security
클래스 AlgorithmParameterGenerator

java.lang.Object 
  java.security.AlgorithmParameterGenerator

public class AlgorithmParameterGenerator
extends Object 

AlgorithmParameterGenerator 클래스는, 특정의 알고리즘으로 사용되는 파라미터세트를 생성하기 위해서 사용됩니다. 파라미터 제네레이터는,getInstance 팩토리 메소드 (지정한 클래스의 인스턴스를 돌려주는 static 메소드)를 사용해 구축됩니다.

파라미터를 생성하는 객체는, 알고리즘 독립형, 또는 알고리즘 특정형의 방법의 2 통과해 방법으로 초기화할 수 있습니다.

• 알고리즘 독립형의 방법에서는, 모든 파라미터 제네레이터가 「사이즈」 및 random number generation의 원이라고 하는 개념을 공유한다고 하는 특성을 이용합니다. 사이즈의 단위는, 모두 알고리즘 파라미터로 보편적으로 공통되고 있습니다만, 그 해석은 알고리즘에 의해 다릅니다. 예를 들어, DSA 알고리즘의 파라미터의 경우, 「사이즈」는 비트로 나타낸 프라임계수(modulus)의 사이즈에 일치합니다. 이 방법을 사용하면(자), 알고리즘 특정형의 파라미터 생성치가 (있는 경우), 그것들은 지정한 사이즈로부터 얻을 수 있던 값이 아닌 한, 디폴트로 표준치가 됩니다.

• 이제(벌써) 1 개의 방법에서는, 알고리즘 특정형의 시멘틱스를 사용해, 파라미터 제네레이터 객체를 초기화합니다. 이러한 시멘틱스는, 알고리즘 특정형의 파라미터 생성치세트로 나타내집니다. 예를 들어, Diffie-Hellman 시스템 파라미터를 생성하려면 , 일반적으로, 파라미터 생성치는, 프라임계수(modulus) 및 랜덤 지수의 사이즈로 구성됩니다. 어느 쪽의 사이즈도 비트수로 지정합니다.

클라이언트가 init 메소드의 호출로, 명시적으로 AlgorithmParameterGenerator 를 초기화하지 않는 경우에는, 각 프로바이더는 디폴트에 의한 초기화를 제공해, 문서화할 필요가 있습니다. 예를 들어 Sun 의 프로바이더는, 1,024 비트의 계수(modulus)프라임사이즈를 디폴트로서 DSA 파라미터를 생성합니다.

도입된 버젼:

1.2

관련 항목:

AlgorithmParameters , AlgorithmParameterSpec

생성자 의 개요

protected

AlgorithmParameterGenerator (AlgorithmParameterGeneratorSpi paramGenSpi, Provider provider, String algorithm) AlgorithmParameterGenerator 객체를 작성합니다.

메소드의 개요

AlgorithmParameters	generateParameters () 파라미터를 생성합니다.
String	getAlgorithm () 파라미터 제네레이터에 관련한 알고리즘의 표준명을 돌려줍니다.
static AlgorithmParameterGenerator	getInstance (String algorithm) 지정된 알고리즘으로 사용되는 파라미터세트를 생성하는, AlgorithmParameterGenerator 객체를 돌려줍니다.
static AlgorithmParameterGenerator	getInstance (String algorithm, Provider provider) 지정된 알고리즘으로 사용되는 파라미터세트를 생성하는, AlgorithmParameterGenerator 객체를 돌려줍니다.
static AlgorithmParameterGenerator	getInstance (String algorithm, String provider) 지정된 알고리즘으로 사용되는 파라미터세트를 생성하는, AlgorithmParameterGenerator 객체를 돌려줍니다.
Provider	getProvider () 알고리즘 파라미터 제네레이터 객체의 프로바이더를 돌려줍니다.
void	init (AlgorithmParameterSpec genParamSpec) 알고리즘 특정형의 파라미터 생성치세트로, 파라미터 제네레이터를 초기화합니다.
void	init (AlgorithmParameterSpec genParamSpec, SecureRandom random) 알고리즘 특정형의 파라미터 생성치세트로, 파라미터 제네레이터를 초기화합니다.
void	init (int size) 특정의 사이즈에 대해서, 파라미터 제네레이터를 초기화합니다.
void	init (int size, SecureRandom random) 특정의 사이즈와 random number generation의 바탕으로 대해, 파라미터 제네레이터를 초기화합니다.

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

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

생성자 의 상세

AlgorithmParameterGenerator

protected AlgorithmParameterGenerator(AlgorithmParameterGeneratorSpi  paramGenSpi,
                                      Provider  provider,
                                      String  algorithm)

AlgorithmParameterGenerator 객체를 작성합니다.

파라미터:

paramGenSpi - delegate

provider - 프로바이더

algorithm - 알고리즘

메소드의 상세

getAlgorithm

public final String  getAlgorithm()

파라미터 제네레이터에 관련한 알고리즘의 표준명을 돌려줍니다.

반환값:

알고리즘의 캐릭터 라인명

getInstance

public static AlgorithmParameterGenerator  getInstance(String  algorithm)
                                               throws NoSuchAlgorithmException 

지정된 알고리즘으로 사용되는 파라미터세트를 생성하는, AlgorithmParameterGenerator 객체를 돌려줍니다.

이 메소드는, 최우선의 Provider 로부터 순서에, 등록을 마친 시큐리티 Provider 의 리스트를 횡단(traverse) 합니다. 지정된 알고리즘을 지원하는 최초의 Provider 의 AlgorithmParameterGeneratorSpi 구현을 캡슐화하는 새로운 AlgorithmParameterGenerator 객체가 돌려주어집니다.

등록이 끝난 프로바이더의 리스트는,Security.getProviders() 메소드 경유로 취득할 수 있습니다.

파라미터:

algorithm - 이 파라미터 제네레이터에 관련지을 수 있었던 알고리즘의 이름. 알고리즘의 표준명에 대해서는,「Java 암호화 아키텍쳐(architecture) API 스펙 & 레퍼런스」의 부록 A 를 참조

반환값:

새로운 AlgorithmParameterGenerator 객체

예외:

NoSuchAlgorithmException - 지정된 알고리즘의 AlgorithmParameterGeneratorSpi 구현을 지원하는 Provider 가 존재하지 않는 경우

관련 항목:

Provider

getInstance

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

지정된 알고리즘으로 사용되는 파라미터세트를 생성하는, AlgorithmParameterGenerator 객체를 돌려줍니다.

지정된 프로바이더의 AlgorithmParameterGeneratorSpi 구현을 캡슐화하는 새로운 AlgorithmParameterGenerator 객체가 돌려주어집니다. 지정한 프로바이더는, 시큐리티 프로바이더 리스트에 등록할 필요가 있습니다.

등록이 끝난 프로바이더의 리스트는,Security.getProviders() 메소드 경유로 취득할 수 있습니다.

파라미터:

algorithm - 이 파라미터 제네레이터에 관련지을 수 있었던 알고리즘의 이름. 알고리즘의 표준명에 대해서는,「Java 암호화 아키텍쳐(architecture) API 스펙 & 레퍼런스」의 부록 A 를 참조

provider - Provider 의 캐릭터 라인명

반환값:

새로운 AlgorithmParameterGenerator 객체

예외:

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

NoSuchProviderException - 지정된 프로바이더가 시큐리티 프로바이더 리스트에 등록되지 않은 경우

IllegalArgumentException - 프로바이더의 이름이 null 나 빈 상태(empty)의 경우

관련 항목:

Provider

getInstance

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

지정된 알고리즘으로 사용되는 파라미터세트를 생성하는, AlgorithmParameterGenerator 객체를 돌려줍니다.

지정된 Provider 객체의 AlgorithmParameterGeneratorSpi 구현을 캡슐화하는 새로운 AlgorithmParameterGenerator 객체가 돌려주어집니다. 지정된 Provider 객체는, 프로바이더 리스트에 등록할 필요는 없습니다.

파라미터:

algorithm - 이 파라미터 제네레이터에 관련지을 수 있었던 알고리즘의 캐릭터 라인명. 알고리즘의 표준명에 대해서는,「Java 암호화 아키텍쳐(architecture) API 스펙 & 레퍼런스」의 부록 A 를 참조

provider - Provider 객체

반환값:

새로운 AlgorithmParameterGenerator 객체

예외:

NoSuchAlgorithmException - 지정된 Provider 객체로 지정된 알고리즘의 AlgorithmParameterGeneratorSpi 구현이 없는 경우

IllegalArgumentException - 지정된 프로바이더가 null 의 경우

도입된 버젼:

1.4

관련 항목:

Provider

getProvider

public final Provider  getProvider()

알고리즘 파라미터 제네레이터 객체의 프로바이더를 돌려줍니다.

반환값:

이 알고리즘 파라미터 제네레이터 객체의 프로바이더

init

public final void init(int size)

특정의 사이즈에 대해서, 파라미터 제네레이터를 초기화합니다. 파라미터를 생성하려면 , 인스톨 되고 있는 프로바이더 가운데, 가장 우선 순위의 높은 프로바이더의 SecureRandom 의 구현이, random number generation의 원으로서 사용됩니다. SecureRandom 를 제공하는 프로바이더가 1 개나 인스톨되어 있지 않은 경우는, 시스템이 제공하는 random number generation의 원이 사용됩니다.

파라미터:

size - 사이즈 (비트수)

init

public final void init(int size,
                       SecureRandom  random)

특정의 사이즈와 random number generation의 바탕으로 대해, 파라미터 제네레이터를 초기화합니다.

파라미터:

size - 사이즈 (비트수)

random - random number generation의 원

init

public final void init(AlgorithmParameterSpec  genParamSpec)
                throws InvalidAlgorithmParameterException 

알고리즘 특정형의 파라미터 생성치세트로, 파라미터 제네레이터를 초기화합니다. 파라미터를 생성하려면 , 인스톨 되고 있는 프로바이더 가운데, 가장 우선 순위의 높은 프로바이더의 SecureRandom 의 구현이, random number generation의 원으로서 사용됩니다. SecureRandom 를 제공하는 프로바이더가 1 개나 인스톨되어 있지 않은 경우는, 시스템이 제공하는 random number generation의 원이 사용됩니다.

파라미터:

genParamSpec - 알고리즘 특정형의 파라미터 생성치세트

예외:

InvalidAlgorithmParameterException - 지정된 파라미터 생성치가 이 파라미터 제네레이터에 올바르지 않은 경우

init

public final void init(AlgorithmParameterSpec  genParamSpec,
                       SecureRandom  random)
                throws InvalidAlgorithmParameterException 

알고리즘 특정형의 파라미터 생성치세트로, 파라미터 제네레이터를 초기화합니다.

파라미터:

genParamSpec - 알고리즘 특정형의 파라미터 생성치세트

random - random number generation의 원

예외:

InvalidAlgorithmParameterException - 지정된 파라미터 생성치가 이 파라미터 제네레이터에 올바르지 않은 경우

generateParameters

public final AlgorithmParameters  generateParameters()

파라미터를 생성합니다.

반환값:

새로운 AlgorithmParameters 객체