java.security
클래스 AlgorithmParameters

java.lang.Object 
  java.security.AlgorithmParameters

public class AlgorithmParameters
extends Object 

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

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

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 - delegate

provider - 프로바이더

algorithm - 알고리즘

메소드의 상세

getAlgorithm

public final String  getAlgorithm()

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

반환값:

알고리즘명

getInstance

public static AlgorithmParameters  getInstance(String  algorithm)
                                       throws NoSuchAlgorithmException 

지정된 알고리즘의 파라미터 객체를 돌려줍니다.

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

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

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

파라미터:

algorithm - 요구하는 알고리즘의 이름 알고리즘의 표준명에 대해서는,「Java 암호화 아키텍쳐(architecture) API 스펙 & 레퍼런스」의 부록 A 를 참조

반환값:

새로운 파라미터 객체

예외:

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

관련 항목:

Provider

getInstance

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

지정된 알고리즘의 파라미터 객체를 돌려줍니다.

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

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

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

파라미터:

algorithm - 요구하는 알고리즘의 이름 알고리즘의 표준명에 대해서는,「Java 암호화 아키텍쳐(architecture) API 스펙 & 레퍼런스」의 부록 A 를 참조

provider - 프로바이더명

반환값:

새로운 파라미터 객체

예외:

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

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

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

관련 항목:

Provider

getInstance

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

지정된 알고리즘의 파라미터 객체를 돌려줍니다.

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

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

파라미터:

algorithm - 요구하는 알고리즘의 이름 알고리즘의 표준명에 대해서는,「Java 암호화 아키텍쳐(architecture) API 스펙 & 레퍼런스」의 부록 A 를 참조

provider - 프로바이더명

반환값:

새로운 파라미터 객체

예외:

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

IllegalArgumentException - 프로바이더가 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 스펙이 존재하는 경우는, primary 복호화 형식은, 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