java.security
클래스 AlgorithmParameters

java.lang.Object 
  |
  +--java.security.AlgorithmParameters

public class AlgorithmParameters

extends Object

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

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

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

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

돌려주어진 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) 지정된 프로바이더에 의해 제공되는 지정된 알고리즘의 파라미터 오브젝트를 작성합니다.
AlgorithmParameterSpec	getParameterSpec (Class paramSpec) 파라미터 오브젝트의 투명한 사양을 돌려줍니다.
Provider	getProvider () 파라미터 오브젝트의 프로바이더를 돌려줍니다.
void	init (AlgorithmParameterSpec paramSpec) paramSpec 로 지정된 파라미터로, 파라미터 오브젝트를 초기화합니다.
void	init (byte[] params) 지정된 파라미터를 임포트 해, 파라미터의 일차 복호화(decode) 형식에 따라 복호화(decode) 합니다.
void	init (byte[] params, String format) params 로부터 파라미터를 임포트 해, 지정된 복호화(decode) 방식에 따라 복호화(decode) 합니다.
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 

지정된 알고리즘에 대한 파라미터 오브젝트를 작성합니다.

요구된 알고리즘의 구현을 디폴트의 프로바이더 패키지가 제공하고 있는 경우는 그 구현을 포함한 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 

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

파라미터:

params - encode 된 파라미터

예외:

IOException - 복호화(decode) 에러가 발생했을 경우, 혹은 이 파라미터 오브젝트가 벌써 초기화되고 있는 경우

init

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

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

파라미터:

params - encode 된 파라미터

format - 복호화(decode) 방식의 이름

예외:

IOException - 복호화(decode) 에러가 발생했을 경우, 혹은 이 파라미터 오브젝트가 벌써 초기화되고 있는 경우

getParameterSpec

public final AlgorithmParameterSpec  getParameterSpec(Class  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