javax.xml.crypto
인터페이스 XMLCryptoContext

기존의 서브 인터페이스의 일람:

XMLSignContext , XMLValidateContext

기존의 구현 클래스의 일람:

DOMCryptoContext , DOMSignContext , DOMValidateContext

public interface XMLCryptoContext

XML 암호화 처리에 대한 공통 문맥 정보를 포함합니다. 　

이 인터페이스에는, XML 서명 또는 XML 암호화된 구조의 처리에 영향을 주는 프로퍼티을, 설정 또는 취득하기 위한 메소드가 포함됩니다. 　

XMLCryptoContext 인스턴스에는 ,함께 사용되는 XML 암호화 구조에 고유의 정보 및 상태를 포함할 수 있습니다. XMLCryptoContext 가 복수의 구조와 함께 사용되었을 경우, 예상외의 결과가 됩니다. 예를 들어, 같은 XMLValidateContext 인스턴스를 사용해 2 개(살)이 다른 XMLSignature 객체를 검증해야 하지는 않습니다.

도입된 버젼:

1.6

메소드의 개요

Object	get (Object key) 이 문맥이 지정된 키에 맵 되는 값을 돌려줍니다.
String	getBaseURI () 베이스 URI 를 돌려줍니다.
String	getDefaultNamespacePrefix () 디폴트의 이름 공간 접두사를 돌려줍니다.
KeySelector	getKeySelector () 키의 검색용의 키 셀렉터를 돌려줍니다.
String	getNamespacePrefix (String namespaceURI, String defaultPrefix) 지정한 이름 공간 URI 를 관련지을 수 있는 이름 공간 접두사를 돌려줍니다.
Object	getProperty (String name) 지정된 프로퍼티의 값을 돌려줍니다.
URIDereferencer	getURIDereferencer () URIReference 의 사이접참조에 사용되는 URIDereferencer 를 돌려줍니다.
Object	put (Object key, Object value) 이 문맥으로, 지정된 값이 지정된 키에 관련짓습니다.
String	putNamespacePrefix (String namespaceURI, String prefix) 지정한 이름 공간 URI 를 지정한 접두사에 매핑 합니다.
void	setBaseURI (String baseURI) 베이스 URI 를 설정합니다.
void	setDefaultNamespacePrefix (String defaultPrefix) 디폴트의 이름 공간 접두사를 설정합니다.
void	setKeySelector (KeySelector ks) 키의 검색용의 키 셀렉터를 설정합니다.
Object	setProperty (String name, Object value) 지정한 프로퍼티을 설정합니다.
void	setURIDereferencer (URIDereferencer dereferencer) URIReference 의 사이접참조에 사용되는 URIDereferencer 를 설정합니다.

메소드의 상세

getBaseURI

String  getBaseURI()

베이스 URI 를 돌려줍니다.

반환값:

베이스 URI. 또는 지정되지 않는 경우는 null

관련 항목:

setBaseURI(String)

setBaseURI

void setBaseURI(String  baseURI)

베이스 URI 를 설정합니다.

파라미터:

baseURI - 베이스 URI. 또는 현재의 값을 삭제하는 경우는 null

예외:

IllegalArgumentException - baseURI 가 RFC 2396 준거가 아닌 경우

관련 항목:

getBaseURI()

getKeySelector

KeySelector  getKeySelector()

키의 검색용의 키 셀렉터를 돌려줍니다.

반환값:

키 셀렉터. 또는 지정되지 않는 경우는 null

관련 항목:

setKeySelector(KeySelector)

setKeySelector

void setKeySelector(KeySelector  ks)

키의 검색용의 키 셀렉터를 설정합니다.

파라미터:

ks - 키 셀렉터. 또는 현재의 설정을 삭제하는 경우는 null

관련 항목:

getKeySelector()

getURIDereferencer

URIDereferencer  getURIDereferencer()

URIReference 의 사이접참조에 사용되는 URIDereferencer 를 돌려줍니다.

반환값:

URIDereferencer. 지정되어 있지 않은 경우는 null

관련 항목:

setURIDereferencer(URIDereferencer)

setURIDereferencer

void setURIDereferencer(URIDereferencer  dereferencer)

URIReference 의 사이접참조에 사용되는 URIDereferencer 를 설정합니다. 지정한 URIDereferencer 는, 구현의 디폴트 URIDereferencer 대신에 사용됩니다.

파라미터:

dereferencer - URIDereferencer, 또는 현재의 설정을 삭제하는 경우는 null

관련 항목:

getURIDereferencer()

getNamespacePrefix

String  getNamespacePrefix(String  namespaceURI,
                          String  defaultPrefix)

지정한 이름 공간 URI 를 관련지을 수 있는 이름 공간 접두사를 돌려줍니다. 지정한 이름 공간 URI 가 접두사에 바인드되어 있지 않은 경우, 지정한 디폴트의 접두사를 돌려줍니다. 이름 공간 URI 를 접두사에 바인드 하려면 ,putNamespacePrefix 메소드를 호출합니다.

파라미터:

namespaceURI - 이름 공간 URI

defaultPrefix - 지정한 이름 공간 URI 가 접두사에 바인드되어 있지 않은 경우에 반환되는 접두사

반환값:

지정한 이름 공간 URI 와 관련지을 수 있었던 접두사, 또는 URI 가 등록되지 않은 경우는 defaultPrefix. 이름 공간 URI 가 등록되어 있어 접두사가 없는 경우, 빈 상태(empty)의 캐릭터 라인 ("")(이)가 돌려주어집니다.

예외:

NullPointerException - namespaceURI 가 null 의 경우

관련 항목:

putNamespacePrefix(String, String)

putNamespacePrefix

String  putNamespacePrefix(String  namespaceURI,
                          String  prefix)

지정한 이름 공간 URI 를 지정한 접두사에 매핑 합니다. 지정한 이름 공간 URI 와 관련지을 수 있었던 접두사가 벌써 존재하는 경우, 낡은 접두사는 지정된 접두사로 옮겨집니다.

파라미터:

namespaceURI - 이름 공간 URI

prefix - 이름 공간 접두사 (기존의 매핑을 모두 삭제하는 경우는 null. 빈 상태(empty)의 캐릭터 라인 ("")을 지정하면(자), 접두사는 이름 공간 URI 에 바인드 되지 않습니다.

반환값:

지정한 이름 공간 URI 와 관련지을 수 있었던 이전의 접두사, 또는 1 개(살)도 없는 경우는 null

예외:

NullPointerException - namespaceURI 가 null 의 경우

관련 항목:

getNamespacePrefix(String, String)

getDefaultNamespacePrefix

String  getDefaultNamespacePrefix()

디폴트의 이름 공간 접두사를 돌려줍니다. 디폴트의 이름 공간 접두사는,putNamespacePrefix 메소드에 의해 명시적으로 설정되어 있지 않은, 모든 이름 공간 URI 용의 접두사입니다.

반환값:

디폴트의 이름 공간 접두사, 또는 설정된 것이 없는 경우는 null

관련 항목:

setDefaultNamespacePrefix(String)

setDefaultNamespacePrefix

void setDefaultNamespacePrefix(String  defaultPrefix)

디폴트의 이름 공간 접두사를 설정합니다. 이것은,putNamespacePrefix 메소드에 의해 명시적으로 설정되어 있지 않은, 모든 이름 공간 URI 용의 이름 공간 접두사를 설정합니다.

파라미터:

defaultPrefix - 디폴트의 이름 공간 접두사, 또는 현재의 설정을 삭제하는 경우는 null. 빈 상태(empty)의 캐릭터 라인 ("")(을)를 지정하면(자), 접두사를 바인드 하지 않습니다.

관련 항목:

getDefaultNamespacePrefix()

setProperty

Object  setProperty(String  name,
                   Object  value)

지정한 프로퍼티을 설정합니다.

파라미터:

name - 프로퍼티의 이름

value - 설정하는 프로퍼티의 값

반환값:

지정된 프로퍼티의 이전의 값, 또는 값이 없었던 경우는 null

예외:

NullPointerException - name 가 null 의 경우

관련 항목:

getProperty(String)

getProperty

Object  getProperty(String  name)

지정된 프로퍼티의 값을 돌려줍니다.

파라미터:

name - 프로퍼티의 이름

반환값:

지정된 프로퍼티의 현재의 값, 또는 값이 없는 경우는 null

예외:

NullPointerException - name 가 null 의 경우

관련 항목:

setProperty(String, Object)

get

Object  get(Object  key)

이 문맥이 지정된 키에 맵 되는 값을 돌려줍니다. 　

즉, 이 문맥에 (key==null ? k==null :key.equals(k)) 라고 하는 조건으로, 키 k 로부터 값 v 에의 매핑이 포함되는 경우, 이 메소드는 v 를 돌려줍니다. 포함되지 않는 경우는 null 를 돌려줍니다. 이러한 매핑이 1 개만 있습니다. 　

이 메소드는, 이 문맥이 사용되는 암호화 처리에 고유하다, 임의의 정보를 취득하는데 편리합니다.

파라미터:

key - 관련지을 수 있었던 값이 반환되는 키

반환값:

이 문맥이, 지정된 키에 매핑 하고 있는 값. 또는, 키의 매핑이 없는 경우는 null

관련 항목:

put(Object, Object)

put

Object  put(Object  key,
           Object  value)

이 문맥으로, 지정된 값이 지정된 키에 관련짓습니다. 문맥에 벌써 이 키에 대한 매핑이 있는 경우, 낡은 값은 지정된 값으로 옮겨집니다. 　

이 메소드는, 이 문맥이 사용되는 암호화 처리에 고유하다, 임의의 정보를 포함하는데 편리합니다.

파라미터:

key - 지정되는 값을 관련지을 수 있는 키

value - 지정되는 키에 관련지을 수 있는 값

반환값:

키에 관련지을 수 있었던 이전의 값 또는, 키의 매핑이 없는 경우는 null

예외:

IllegalArgumentException - 이 키 또는 값의 일부의 특성을 위해서(때문에) 이 문맥에 포함할 수 없는 경우

관련 항목:

get(Object)