javax.crypto.spec
클래스 SecretKeySpec

java.lang.Object 
  javax.crypto.spec.SecretKeySpec

모든 구현된 인터페이스:

Serializable, Key, KeySpec, SecretKey

public class SecretKeySpec
extends Object 
implements KeySpec,
 SecretKey 

프로바이더에 존하지 않는 형식에서 비밀키를 지정합니다.

이 클래스를 사용해, 바이트 배열로부터 SecretKey를 구축할 수가 있어 프로바이더 베이스의 SecretKeyFactory를 사용할 필요가 없습니다.

이 클래스는 바이트 배열로서 나타낼 수가 있어 DES 나 Triple DES 키 등, 비밀키에 관련한 키 파라미터가 없는 원시비밀키에 대해서만 유효합니다.

도입된 버전 :

1.4

관련 항목:

SecretKey, SecretKeyFactory, 직렬화 된 형식

필드 개요

인터페이스 javax.crypto. SecretKey 로부터 상속된 필드

serialVersionUID

생성자 개요

SecretKeySpec (byte[] key, int offset, int len, String algorithm)
offset로 부터 시작되는 key 최초의 len 바이트를 사용해, 지정된 바이트 배열로부터 비밀키를 구축합니다.

SecretKeySpec (byte[] key, String algorithm)
지정된 바이트 배열로부터 비밀키를 구축합니다.

메서드 개요

boolean	equals (Object obj) 지정의 객체와 이 객체의 사이의 등가성을 테스트합니다.
String	getAlgorithm () 이 비밀키에 관련한 알고리즘의 이름을 리턴합니다.
byte[]	getEncoded () 이 비밀키의 키 데이터를 리턴합니다.
String	getFormat () 이 비밀키의 encode 형식의 이름을 리턴합니다.
int	hashCode () 객체의 해시 코드값을 계산합니다.

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

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

생성자 상세

SecretKeySpec

public SecretKeySpec(byte[] key,
                     String  algorithm)

지정된 바이트 배열로부터 비밀키를 구축합니다.

이 생성자는 지정된 바이트가 지정된 알고리즘의 비밀키를 실제로 지정할지 어떨지는 판정하지 않습니다. 예를 들어 알고리즘이 DES인 경우, 이 생성자는 key가 8 바이트의 길이일지 어떨지를 판정하지 않고, 미만 또는 반약의 키일지 어떨지도 판정하지 않습니다. 이러한 판정을 실시하기 위해서는 알고리즘에 특정의 「키 사양」클래스 (이 경우는 DESKeySpec )를 사용할 필요가 있습니다.

파라미터:

key - 비밀키의 키 데이터. 배열의 내용은 향후 변경되지 않게 보호하는 목적으로 카피되는

algorithm - 지정된 키 데이터에 관련된 비밀키 알고리즘의 이름. 알고리즘의 표준명에 대해서는 「Java Cryptography Extension Reference Guide」의 부록 A를 참조

예외:

IllegalArgumentException - algorithm가 null 또는 key가 null 또는 비어있는 경우

SecretKeySpec

public SecretKeySpec(byte[] key,
                     int offset,
                     int len,
                     String  algorithm)

offset로 부터 시작되는 key 최초의 len 바이트를 사용해, 지정된 바이트 배열로부터 비밀키를 구축합니다.

비밀키를 구성하는 바이트는 key[offset]로 부터 key[offset+len-1] 까지의 바이트입니다.

이 생성자는 지정된 바이트가 지정된 알고리즘의 비밀키를 실제로 지정할지 어떨지는 판정하지 않습니다. 예를 들어 알고리즘이 DES인 경우, 이 생성자는 key가 8 바이트의 길이일지 어떨지를 판정하지 않고, 미만 또는 반약의 키일지 어떨지도 판정하지 않습니다. 이러한 판정을 실시하기 위해서는 알고리즘에 특정의 「키 사양」클래스 (이 경우는 DESKeySpec )를 사용할 필요가 있습니다.

파라미터:

key - 비밀키의 키 데이터. offset로 시작되는 배열의 최초의 len 바이트는 향후 변경되지 않게 보호하는 목적으로 카피되는

offset - 키 데이터가 시작되는 key 내의 오프셋(offset)

len - 키 데이터의 길이

algorithm - 지정된 키 데이터에 관련된 비밀키 알고리즘의 이름. 알고리즘의 표준명에 대해서는 「Java Cryptography Extension Reference Guide」의 부록 A를 참조

예외:

IllegalArgumentException - algorithm가 null 또는 key가 null, 공백, 또는 너무 짧은 경우. 예: key.length-offset.

ArrayIndexOutOfBoundsException - offset 또는 len인덱스 바이트가 key 외부의 경우는 Throw 된다

메서드의 상세

getAlgorithm

public String  getAlgorithm()

이 비밀키에 관련한 알고리즘의 이름을 리턴합니다.

정의:

인터페이스 Key 내의 getAlgorithm

반환값:

비밀키 알고리즘

getFormat

public String  getFormat()

이 비밀키의 encode 형식의 이름을 리턴합니다.

정의:

인터페이스 Key 내의 getFormat

반환값:

「생의」캐릭터 라인

getEncoded

public byte[] getEncoded()

이 비밀키의 키 데이터를 리턴합니다.

정의:

인터페이스 Key 내의 getEncoded

반환값:

키 데이터. 이 메서드가 불려 갈 때마다 새로운의 배열을 돌려준다

hashCode

public int hashCode()

객체의 해시 코드값을 계산합니다. 동일한 객체는 해시 코드도 같습니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object  obj)

지정의 객체와 이 객체의 사이의 등가성을 테스트합니다. 2개의 SecretKeySpec 객체가 문자의 대소의 비반영형 알고리즘명을 가져, 키의 encode가 같은 SecretKey 인스턴스를 가지는 경우는 양자가 동일하다고 보여집니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 이 객체와 동일한지 어떤지가 판정되는 객체

반환값:

객체가 동일하다고 보여졌을 경우는 true, obj가 null 또는 그 외의 경우는 false

관련 항목:

Object.hashCode(), Hashtable