java.security
클래스 AlgorithmParameters

java.lang.Object 
  java.security.AlgorithmParameters

public class AlgorithmParameters
extends Object 

암호화 파라미터의 불투명한 표시로서 사용합니다.

특정의 알고리즘의 파라미터를 관리하기 위한 AlgorithmParameters 객체를 취득하려면, getInstance 팩토리 메서드 (지정된 클래스의 인스턴스를 돌려주는 static 메서드)의 어떤 것인지를 호출합니다.

그 구현을 요구하려면, 2개의 방법이 있습니다. 1개는 알고리즘명만을 지정하는 방법으로 이제(이미 ) 1개는 알고리즘명과 패키지 프로바이더의 양쪽 모두를 지정하는 방법입니다.

• 알고리즘명만을 지정하면, 시스템은 요구한 알고리즘의 AlgorithmParameters 구현이 환경에서 제공되고 있는지 어떤지, 또 복수의 구현이 있는 경우에는 우선 순위의 높은 구현이 있을지 어떨지를 조사합니다.
• 알고리즘명과 패키지 프로바이더의 양쪽 모두를 지정하면, 시스템은 요구한 패키지에 구현이 있을지 어떨지를 조사하지 않은 경우에는 예외를 Throw 합니다.

리턴된 AlgorithmParameters객체는 적절한 파라미터 사양 또는 파라미터의 encode에의해 init를 호출하는 것으로 초기화할 필요가 있습니다.

투명한 파라미터 사양을 AlgorithmParameters 객체로부터 취득하려면, getParameterSpec를 호출합니다. 파라미터의 바이트 encode를 실시하려면, getEncoded를 호출합니다.

도입된 버전 :

1.2

관련 항목:

AlgorithmParameterSpec, DSAParameterSpec, KeyPairGenerator

생성자 개요

protected

AlgorithmParameters (AlgorithmParametersSpi paramSpi, Provider provider, String algorithm) AlgorithmParameters 객체를 작성합니다.

메서드 개요

String	getAlgorithm () 이 파라미터 객체에 관련한 알고리즘의 이름을 리턴합니다.
byte[]	getEncoded () 일차 encode 형식에서 파라미터를 리턴합니다.
byte[]	getEncoded (String format) 지정된 방식에서 encode 된 파라미터를 리턴합니다.
static AlgorithmParameters	getInstance (String algorithm) 지정된 알고리즘에 대한 파라미터 객체를 작성합니다.
static AlgorithmParameters	getInstance (String algorithm, Provider provider) 지정된 프로바이더에 의해 제공되는 지정된 알고리즘의 파라미터 객체를 작성합니다.
static AlgorithmParameters	getInstance (String algorithm, String provider) 지정된 프로바이더에 의해 제공되는 지정된 알고리즘의 파라미터 객체를 작성합니다.
<T extends AlgorithmParameterSpec > T	getParameterSpec (Class <T> paramSpec) 파라미터 객체의 투명한 사양을 리턴합니다.
Provider	getProvider () 파라미터 객체의 프로바이더를 리턴합니다.
void	init (AlgorithmParameterSpec paramSpec) paramSpec로 지정된 파라미터로 파라미터 객체를 초기화합니다.
void	init (byte[] params) 지정된 파라미터를 임포트 해, 파라미터의 일차 복호화 형식에 따라 복호화 합니다.
void	init (byte[] params, String format) params로 부터 파라미터를 임포트 해, 지정된 복호화 방식에 따라 복호화 합니다.
String	toString () 파라미터를 설명하는 서식 첨부 캐릭터 라인을 리턴합니다.

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

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

생성자 상세

AlgorithmParameters

protected AlgorithmParameters(AlgorithmParametersSpi  paramSpi,
                              Provider  provider,
                              String  algorithm)

AlgorithmParameters 객체를 작성합니다.

파라미터:

paramSpi - 위양처

provider - 프로바이더

algorithm - 알고리즘

메서드의 상세

getAlgorithm

public final String  getAlgorithm()

이 파라미터 객체에 관련한 알고리즘의 이름을 리턴합니다.

반환값:

알고리즘명

getInstance

public static AlgorithmParameters  getInstance(String  algorithm)
                                       throws NoSuchAlgorithmException 

지정된 알고리즘에 대한 파라미터 객체를 작성합니다.

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

리턴된 파라미터 객체는 적절한 파라미터 사양 또는 파라미터의 encode에의해 init를 호출하는 것으로 초기화할 필요가 있습니다.

파라미터:

algorithm - 요구하는 알고리즘의 이름

반환값:

새로운 파라미터 객체

예외:

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

getInstance

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

                                              NoSuchProviderException 

지정된 프로바이더에 의해 제공되는 지정된 알고리즘의 파라미터 객체를 작성합니다. 다만, 그 프로바이더가 지정된 알고리즘을 제공하고 있는 경우에 한정합니다.

리턴된 파라미터 객체는 적절한 파라미터 사양 또는 파라미터의 encode에의해 init를 호출하는 것으로 초기화할 필요가 있습니다.

파라미터:

algorithm - 요구하는 알고리즘의 이름

provider - 프로바이더명

반환값:

새로운 파라미터 객체

예외:

NoSuchAlgorithmException - 요구된 프로바이더가 제공하는 패키지에서는 알고리즘을 사용할 수 없는 경우

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

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

관련 항목:

Provider

getInstance

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

지정된 프로바이더에 의해 제공되는 지정된 알고리즘의 파라미터 객체를 작성합니다. 다만, 그 프로바이더가 지정된 알고리즘을 제공하고 있는 경우에 한정합니다. 주: provider를 등록할 필요는 없습니다.

리턴된 파라미터 객체는 적절한 파라미터 사양 또는 파라미터의 encode에의해 init를 호출하는 것으로 초기화할 필요가 있습니다.

파라미터:

algorithm - 요구하는 알고리즘의 이름

provider - 프로바이더명

반환값:

새로운 파라미터 객체

예외:

NoSuchAlgorithmException - 요구된 프로바이더가 제공하는 패키지에서는 알고리즘을 사용할 수 없는 경우

IllegalArgumentException - provider가 null인 경우

도입된 버전 :

1.4

관련 항목:

Provider

getProvider

public final Provider  getProvider()

파라미터 객체의 프로바이더를 리턴합니다.

반환값:

이 파라미터 객체의 프로바이더

init

public final void init(AlgorithmParameterSpec  paramSpec)
                throws InvalidParameterSpecException 

paramSpec로 지정된 파라미터로 파라미터 객체를 초기화합니다.

파라미터:

paramSpec - 파라미터 사양

예외:

InvalidParameterSpecException - 지정된 파라미터 사양이 파라미터 객체의 초기화에 부적절한 경우, 혹은 이 파라미터 객체가 이미 초기화되고 있는 경우

init

public final void init(byte[] params)
                throws IOException 

지정된 파라미터를 임포트 해, 파라미터의 일차 복호화 형식에 따라 복호화 합니다. 이러한 파라미터의 ASN. 1 사양이 있는 경우에는 파라미터의 일차 복호화 형식은 ASN. 1 입니다.

파라미터:

params - encode 된 파라미터

예외:

IOException - 복호화 에러가 발생했을 경우, 혹은 이 파라미터 객체가 이미 초기화되고 있는 경우

init

public final void init(byte[] params,
                       String  format)
                throws IOException 

params로 부터 파라미터를 임포트 해, 지정된 복호화 방식에 따라 복호화 합니다. format이 null인 경우에는 파라미터의 일차 복호화 형식이 사용됩니다. 이러한 파라미터의 ASN. 1 사양이 있는 경우에는 일차 복호화 형식은 ASN. 1 입니다.

파라미터:

params - encode 된 파라미터

format - 복호화 방식의 이름

예외:

IOException - 복호화 에러가 발생했을 경우, 혹은 이 파라미터 객체가 이미 초기화되고 있는 경우

getParameterSpec

public final <T extends AlgorithmParameterSpec > T getParameterSpec(Class <T> paramSpec)
                                                        throws InvalidParameterSpecException 

파라미터 객체의 투명한 사양을 리턴합니다. paramSpec는 파라미터가 리턴된 사양 클래스를 식별합니다. 예를 들어 그것이 DSAParameterSpec.class인 경우에는 파라미터가 DSAParameterSpec 클래스의 인스턴스에 리턴된 것을 나타냅니다.

파라미터:

paramSpec - 파라미터가 리턴된 사양 클래스

반환값:

파라미터 사양

예외:

InvalidParameterSpecException - 요구한 파라미터 사양이 파라미터 객체에 부적절한 경우, 혹은 이 파라미터 객체가 초기화되어 있지 않은 경우

getEncoded

public final byte[] getEncoded()
                        throws IOException 

일차 encode 형식에서 파라미터를 리턴합니다. 이러한 파라미터의 ASN. 1 사양이 있는 경우에는 파라미터의 일차 encode 형식은 ASN. 1 입니다.

반환값:

파라미터의 일차 encode 방식에서 encode 된 파라미터

예외:

IOException - encode 에러가 발생했을 경우, 혹은 이 파라미터 객체가 초기화되어 있지 않은 경우

getEncoded

public final byte[] getEncoded(String  format)
                        throws IOException 

지정된 방식에서 encode 된 파라미터를 리턴합니다. format이 null인 경우에는 파라미터의 일차 encode 형식이 사용됩니다. 이러한 파라미터의 ASN. 1 사양이 있는 경우에는 일차 encode 형식은 ASN. 1 입니다.

파라미터:

format - encode 형식의 이름

반환값:

지정된 encode 방식에서 encode 된 파라미터

예외:

IOException - encode 에러가 발생했을 경우, 혹은 이 파라미터 객체가 초기화되어 있지 않은 경우

toString

public final String  toString()

파라미터를 설명하는 서식 첨부 캐릭터 라인을 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

파라미터를 설명하는 서식 첨부 캐릭터 라인. 이 파라미터 객체가 초기화되어 있지 않은 경우는 null