java.security
클래스 AlgorithmParameterGenerator

java.lang.Object 
  java.security.AlgorithmParameterGenerator

public class AlgorithmParameterGenerator
extends Object 

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

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

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

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

클라이언트가 init 메서드의 호출로 명시적으로 AlgorithmParameterGenerator를 초기화하지 않는 경우에는 각 프로바이더는 디폴트에 한 초기화를 제공해, 문서화할 필요가 있습니다. 예를 들어 Sun 프로바이더는 1,024 비트의 모쥬라스프라임사이즈를 디폴트로서 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) 특정의 사이즈와 난수의 발생원에 대해서 파라미터 제네레이터를 초기화합니다.

클래스 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 - 위양처

provider - 프로바이더

algorithm - 알고리즘

메서드의 상세

getAlgorithm

public final String  getAlgorithm()

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

반환값:

알고리즘의 캐릭터 라인명

getInstance

public static AlgorithmParameterGenerator  getInstance(String  algorithm)
                                               throws NoSuchAlgorithmException 

지정된 다이제스트 알고리즘을 구현하는 AlgorithmParameterGenerator 객체를 작성합니다. 요구되는 다이제스트 알고리즘의 구현을 디폴트의 프로바이더 패키지가 제공하는 경우는 그 구현을 포함한 AlgorithmParameterGenerator 인스턴스가 리턴됩니다 . 디폴트 패키지로 목적의 알고리즘이 제공되어 있지 않은 경우에는 다른 패키지가 검색됩니다.

파라미터:

algorithm - 이 파라미터 제네레이터에 관련한 알고리즘의 캐릭터 라인명

반환값:

새로운 AlgorithmParameterGenerator 객체

예외:

NoSuchAlgorithmException - 알고리즘이 그 환경에서 사용할 수 없는 경우

getInstance

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

                                                      NoSuchProviderException 

지정된 프로바이더로부터 제공된다, 요구한 알고리즘의 AlgorithmParameterGenerator 객체를 작성합니다. 다만, 그러한 파라미터 제네레이터가 프로바이더로부터 사용 가능한 경우에 한정합니다.

파라미터:

algorithm - 알고리즘의 캐릭터 라인명

provider - 프로바이더명의 캐릭터 라인

반환값:

새로운 AlgorithmParameterGenerator 객체

예외:

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

NoSuchProviderException - 프로바이더가 그 환경에서 사용할 수 없는 경우

IllegalArgumentException - 프로바이더의 이름이 null 또는 비어있는 경우

관련 항목:

Provider

getInstance

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

지정된 프로바이더로부터 제공된다, 요구한 알고리즘의 AlgorithmParameterGenerator 객체를 작성합니다. 다만, 그러한 파라미터 제네레이터가 프로바이더로부터 사용 가능한 경우에 한정합니다. 주: provider를 등록할 필요는 없습니다.

파라미터:

algorithm - 알고리즘의 캐릭터 라인명

provider - 프로바이더

반환값:

새로운 AlgorithmParameterGenerator 객체

예외:

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

IllegalArgumentException - provider가 null인 경우

도입된 버전 :

1.4

관련 항목:

Provider

getProvider

public final Provider  getProvider()

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

반환값:

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

init

public final void init(int size)

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

파라미터:

size - 사이즈 (비트수)

init

public final void init(int size,
                       SecureRandom  random)

특정의 사이즈와 난수의 발생원에 대해서 파라미터 제네레이터를 초기화합니다.

파라미터:

size - 사이즈 (비트수)

random - 난수의 발생원

init

public final void init(AlgorithmParameterSpec  genParamSpec)
                throws InvalidAlgorithmParameterException 

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

파라미터:

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

예외:

InvalidAlgorithmParameterException - 지정된 파라미터 생성값이 파라미터 제네레이터에 부적절한 경우

init

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

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

파라미터:

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

random - 난수의 발생원

예외:

InvalidAlgorithmParameterException - 지정된 파라미터 생성값이 파라미터 제네레이터에 부적절한 경우

generateParameters

public final AlgorithmParameters  generateParameters()

파라미터를 생성합니다.

반환값:

새로운 AlgorithmParameters 객체