javax.xml.crypto
클래스 KeySelector

java.lang.Object 
  javax.xml.crypto.KeySelector

public abstract class KeySelector
extends Object 

KeyInfo 객체에 포함되는 데이터를 사용해, 열쇠를 검색해 돌려주는 셀렉터입니다. 이 클래스의 구현의 예는,KeyInfo 에 포함되는 정보에 일치하는 신뢰할 수 있는 열쇠로 KeyStore 를 검색하는 경우입니다. 　

반환된 열쇠를 신뢰할 수 있을지 어떨지, 및 그 검출에 기구가 사용될지 어떨지는, 구현에 고유가 됩니다.

도입된 버젼:

1.6

상자의 클래스의 개요

static class

KeySelector.Purpose 선택되는 열쇠의 목적입니다.

생성자 의 개요

protected

KeySelector () 디폴트는 인수가 없는 생성자 으로, 서브 클래스에 의한 호출만을 상정하고 있습니다.

메소드의 개요

abstract KeySelectorResult	select (KeyInfo keyInfo, KeySelector.Purpose purpose, AlgorithmMethod method, XMLCryptoContext context) 지정된 제약을 채우는 열쇠의 검색을 시도합니다.
static KeySelector	singletonKeySelector (Key key) 건네받는 KeyInfo 에 관계없이, 항상 지정한 열쇠를 선택하는 KeySelector 를 돌려줍니다.

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

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

생성자 의 상세

KeySelector

protected KeySelector()

디폴트는 인수가 없는 생성자 으로, 서브 클래스에 의한 호출만을 상정하고 있습니다.

메소드의 상세

select

public abstract KeySelectorResult  select(KeyInfo  keyInfo,
                                         KeySelector.Purpose  purpose,
                                         AlgorithmMethod  method,
                                         XMLCryptoContext  context)
                                  throws KeySelectorException 

지정된 제약을 채우는 열쇠의 검색을 시도합니다.

파라미터:

keyInfo - KeyInfo 객체. null 도 가능

purpose - 열쇠의 목적 (KeySelector.Purpose.SIGN , KeySelector.Purpose.VERIFY ,KeySelector.Purpose.ENCRYPT , 또는 KeySelector.Purpose.DECRYPT )

method - 이 열쇠가 사용되는 대상의 알고리즘 메소드. 알고리즘과 호환성이 있어, 지정한 알고리즘의 제약을 채우는 열쇠만이 반환되는

context - XMLCryptoContext 에는, 적절한 열쇠를 검색하는데 유익한 정보가 포함되어 있습니다. 이 열쇠 셀렉터가 RetrievalMethod 형의 해결을 지원하는 경우, 문맥의 baseURI 및 dereferencer 파라미터 (지정되었을 경우)를 셀렉터가 사용해, URI 를 해결 및 간접 참조할 필요가 있습니다

반환값:

열쇠 셀렉터의 결과

예외:

KeySelectorException - 열쇠의 검색의 시행중에 예외 조건이 발생했을 경우. 열쇠를 검색할 수 없는 것이 예외이라고 보여질 것은 없습니다 (이 경우,null 하지만 돌려주어질 필요가 있다). 다만,KeySelector 하지만 가능성이 있는 열쇠의 검색을 방해하는 에러 조건 (예: 네트워크 통신 장해)은, 예외라고 보여질 필요가 있습니다.

ClassCastException - method 의 데이터형이 이 열쇠 셀렉터에 의해 지원되어 있지 않은 경우

singletonKeySelector

public static KeySelector  singletonKeySelector(Key  key)

건네받는 KeyInfo 에 관계없이, 항상 지정한 열쇠를 선택하는 KeySelector 를 돌려줍니다.

파라미터:

key - 열쇠 셀렉터에 포함되고 있는 유일한 키

반환값:

항상 지정한 열쇠를 선택하는 열쇠 셀렉터

예외:

NullPointerException - key 가 null 의 경우