java.security
클래스 Provider

java.lang.Object 
  java.util.Dictionary <K, V>
      java.util.Hashtable <Object,
Object >
          java.util.Properties 
              java.security.Provider

모든 구현된 인터페이스:

Serializable, Cloneable, Map <Object, Object >

알려진 직계 서브 클래스:

AuthProvider

public abstract class Provider
extends Properties 

이 클래스는 Java Security API 「프로바이더」를 나타냅니다. 프로바이더란 Java 시큐러티의 전체 또는 일부를 구현하는 것입니다. 프로바이더가 구현하는 것은 다음과 같은 서비스입니다.

• 알고리즘 (DSA, RSA, MD5, SHA-1 등)
• 키 생성, 키 변환 및 (알고리즘 고유의 키에 대한다) 관리 기능

각 프로바이더에는 이름과 버전 번호가 있어, 인스톨 되고 있는 런타임 클래스 마다 설정됩니다.

프로바이더의 특정의 형태, 암호화 서비스 프로바이더의 처리 및 인스톨 방법에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」의 Provider Class 를 참조하십시오. 그 때, 프로바이더가 하층에 적절한 구현을 선택해, 플러그 인 가능한 아키텍쳐를 사용하고 있으면, Java 목의 시큐러티 서비스의 구현에도 사용할 수 있습니다.

프로바이더 구현에 따라서는 시큐러티 토큰과의 통신 에러등의, 처리중에 복구할 수 없는 내부 에러가 발생할 가능성이 있습니다. 그러한 에러를 통지하려면 ProviderException를 사용해 주세요.

서비스 타입 Provider는 시큐러티 체제용으로 예약되고 있습니다. 이 타입의 서비스를 어플리케이션으로부터 추가 삭제, 또는 변경할 수 없습니다. 각 Provider 객체내에는 다음의 속성이 자동적으로 포함됩니다.

이름	치
Provider.id name	String.valueOf(provider.getName())
Provider.id version	String.valueOf(provider.getVersion())
Provider.id info	String.valueOf(provider.getInfo())
Provider.id className	provider.getClass(). getName()

관련 항목:

직렬화 된 형식

중첩(Nested) 클래스 개요

static class

Provider.Service 특정의 시큐러티 서비스를 기술한 것입니다.

필드 개요

클래스 java.util. Properties 로부터 상속된 필드

defaults

생성자 개요

protected

Provider (String name, double version, String info) 지정된 이름, 버전 번호 및 정보를 사용해 프로바이더를 구축합니다.

메서드 개요

void	clear () 이 프로바이더를 클리어 해, 프로바이더가 구현한 기능을 검색할 경우에 사용하는 프로퍼티를 포함하지 않게 합니다.
Set <Map.Entry <Object, Object >>	entrySet () 이 프로바이더에 포함되는 프로퍼티 엔트리의 변경 불가능한 Set 뷰를 리턴합니다.
String	getInfo () 프로바이더와 그 서비스 내용을 인간이 읽을 수 있는 형식에서 리턴합니다.
String	getName () 이 프로바이더의 이름을 리턴합니다.
Provider.Service	getService (String type, String algorithm) 지정된 타입의 지정된 알고리즘 또는 별명에 대한 이 Provider 구현을 기술한 서비스를 취득합니다.
Set <Provider.Service >	getServices () 이 Provider가 지원하는 모든 서비스의 변경 불가능한 Set를 취득합니다.
double	getVersion () 이 프로바이더의 버전 번호를 리턴합니다.
Set <Object >	keySet () 이 프로바이더에 포함되는 프로퍼티 키의 변경 불가능한 Set 뷰를 리턴합니다.
void	load (InputStream inStream) 입력 스트림로부터 키와 요소가 대가 된 프로퍼티 리스트를 읽어냅니다.
Object	put (Object key, Object value) key 라고 하는 프로퍼티가 지정된 value 라고 하는 값을 가지도록 설정합니다.
void	putAll (Map <?,?> t) 지정된 Map 로부터 이 프로바이더에 모든 매핑을 카피합니다.
protected void	putService (Provider.Service s) 서비스를 추가합니다.
Object	remove (Object key) key 프로퍼티와 거기에 대응하는 value를 삭제합니다.
protected void	removeService (Provider.Service s) 이전에 putService()를 사용해 추가된 서비스를 삭제합니다.
String	toString () 이 프로바이더의 이름과 버전 번호를 캐릭터 라인으로 리턴합니다.
Collection <Object >	values () 이 프로바이더에 포함되는 프로퍼티치의 변경 불가능한 Collection 뷰를 리턴합니다.

클래스 java.util. Properties 로부터 상속된 메서드

getProperty, getProperty, list, list, loadFromXML, propertyNames, save, setProperty, store, storeToXML, storeToXML

클래스 java.util. Hashtable 로부터 상속된 메서드

clone, contains, containsKey, containsValue, elements, equals, get, hashCode, isEmpty, keys, rehash, size

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

finalize, getClass, notify, notifyAll, wait, wait, wait

생성자 상세

Provider

protected Provider(String  name,
                   double version,
                   String  info)

지정된 이름, 버전 번호 및 정보를 사용해 프로바이더를 구축합니다.

파라미터:

name - 프로바이더의 이름

version - 프로바이더의 버전 번호

info - 프로바이더와 그 서비스의 기술

메서드의 상세

getName

public String  getName()

이 프로바이더의 이름을 리턴합니다.

반환값:

이 프로바이더의 이름

getVersion

public double getVersion()

이 프로바이더의 버전 번호를 리턴합니다.

반환값:

이 프로바이더의 버전 번호

getInfo

public String  getInfo()

프로바이더와 그 서비스 내용을 인간이 읽을 수 있는 형식에서 리턴합니다. 관련된 링크를 가지는 HTML 페이지를 돌려주는 일도 있습니다.

반환값:

프로바이더와 그 서비스의 기술

toString

public String  toString()

이 프로바이더의 이름과 버전 번호를 캐릭터 라인으로 리턴합니다.

오버라이드(override):

클래스 Hashtable <Object, Object > 내의 toString

반환값:

이 프로바이더의 이름과 버전 번호의 캐릭터 라인

clear

public void clear()

이 프로바이더를 클리어 해, 프로바이더가 구현한 기능을 검색할 경우에 사용하는 프로퍼티를 포함하지 않게 합니다.

시큐러티 매니저가 존재하는 경우, 우선 시큐러티 매니저의 checkSecurityAccess 메서드가 캐릭터 라인 "clearProviderProperties. "+name (name는 프로바이더의 이름)를 지정해 불려가 이 프로바이더를 클리어 해도 괜찮은지 어떤지가 확인됩니다. checkSecurityAccess 디폴트 구현이 사용되는 경우 (즉, 이 메서드가 오버라이드(override)되어 있지 않은 경우), 이 메서드의 호출에의해 시큐러티 매니저의 checkPermission 메서드가 SecurityPermission("clearProviderProperties. "+name) 접근 권한을 지정해 호출합니다.

정의:

인터페이스 Map <Object, Object > 내의 clear

오버라이드(override):

클래스 Hashtable <Object, Object > 내의 clear

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 SecurityManager.checkSecurityAccess(java.lang.String) 메서드가 이 프로바이더를 클리어 하는 액세스를 허가하지 않을 때

도입된 버전 :

1.2

load

public void load(InputStream  inStream)
          throws IOException 

입력 스트림로부터 키와 요소가 대가 된 프로퍼티 리스트를 읽어냅니다.

오버라이드(override):

클래스 Properties 내의 load

파라미터:

inStream - 입력 스트림

예외:

IOException - 입력 스트림로부터의 독해중에 에러가 발생했을 경우

관련 항목:

Properties.load(java.io.InputStream)

putAll

public void putAll(Map <?,?> t)

지정된 Map 로부터 이 프로바이더에 모든 매핑을 카피합니다. 이러한 매핑은 지정된 Map 내에 존재하는 모든 키에 대응하는 프로퍼티를, 이 프로바이더가 가지고 있는 프로퍼티와 옮겨놓습니다.

정의:

인터페이스 Map <Object, Object > 내의 putAll

오버라이드(override):

클래스 Hashtable <Object, Object > 내의 putAll

파라미터:

t - 맵에 포함되는 매핑

도입된 버전 :

1.2

entrySet

public Set <Map.Entry <Object,
Object >> entrySet()

이 프로바이더에 포함되는 프로퍼티 엔트리의 변경 불가능한 Set 뷰를 리턴합니다.

정의:

인터페이스 Map <Object, Object > 내의 entrySet

오버라이드(override):

클래스 Hashtable <Object, Object > 내의 entrySet

반환값:

맵내에 보관 유지되고 있는 매핑의 셋트뷰

도입된 버전 :

1.2

관련 항목:

Map.Entry

keySet

public Set <Object > keySet()

이 프로바이더에 포함되는 프로퍼티 키의 변경 불가능한 Set 뷰를 리턴합니다.

정의:

인터페이스 Map <Object, Object > 내의 keySet

오버라이드(override):

클래스 Hashtable <Object, Object > 내의 keySet

반환값:

맵에 포함되어 있는 키의 셋트뷰

도입된 버전 :

1.2

values

public Collection <Object > values()

이 프로바이더에 포함되는 프로퍼티치의 변경 불가능한 Collection 뷰를 리턴합니다.

정의:

인터페이스 Map <Object, Object > 내의 values

오버라이드(override):

클래스 Hashtable <Object, Object > 내의 values

반환값:

맵내에 포함되어 있는 값의 코레크션뷰

도입된 버전 :

1.2

put

public Object  put(Object  key,
                  Object  value)

key 라고 하는 프로퍼티가 지정된 value 라고 하는 값을 가지도록 설정합니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkSecurityAccess 메서드가 인수로서 "putProviderProperty. "+name (name는 프로바이더의 이름)라고 하는 캐릭터 라인을 지정해 불려가 이 프로바이더의 프로퍼티치를 설정해도 괜찮은지 어떤지를 확인합니다. 디폴트의 checkSecurityAccess 구현이 사용되는 경우 (즉, checkSecurityAccess 메서드가 오버라이드(override)되어 있지 않은 경우), 이 메서드의 결과는 시큐러티 매니저의 checkPermission 메서드가 인수로서 SecurityPermission("putProviderProperty. "+name) 접근 권한을 지정해 불려 갔을 경우와 같습니다.

정의:

인터페이스 Map <Object, Object > 내의 put

오버라이드(override):

클래스 Hashtable <Object, Object > 내의 put

파라미터:

key - 프로퍼티 키

value - 프로퍼티의 값

반환값:

지정된 프로퍼티 (key)에 그것까지 설정되어 있던 값. 값이 설정되어 있지 않았던 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 SecurityManager.checkSecurityAccess(java.lang.String) 메서드가 이 프로바이더의 프로퍼티치를 설정하는 액세스를 허가하지 않을 때

도입된 버전 :

1.2

관련 항목:

Object.equals(Object), Hashtable.get(Object)

remove

public Object  remove(Object  key)

key 프로퍼티와 거기에 대응하는 value를 삭제합니다.

시큐러티 매니저가 존재하는 경우, 우선 시큐러티 매니저의 checkSecurityAccess 메서드가 캐릭터 라인 "removeProviderProperty. "+name (name는 프로바이더의 이름)를 지정해 불려가 이 프로바이더의 프로퍼티치를 삭제해도 괜찮은지 어떤지가 확인됩니다. checkSecurityAccess 디폴트 구현이 사용되는 경우 (즉, 이 메서드가 오버라이드(override)되어 있지 않은 경우), 이 메서드의 호출에의해 시큐러티 매니저의 checkPermission 메서드가 SecurityPermission("removeProviderProperty. "+name) 접근 권한을 지정해 호출합니다.

정의:

인터페이스 Map <Object, Object > 내의 remove

오버라이드(override):

클래스 Hashtable <Object, Object > 내의 remove

파라미터:

key - 삭제하는 프로퍼티의 키

반환값:

키에 할당할 수 있고 있던 값. 할당할 수 있지 않았던 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 SecurityManager.checkSecurityAccess(java.lang.String) 메서드가 이 프로바이더의 프로퍼티치를 삭제하는 액세스를 허가하지 않을 때

도입된 버전 :

1.2

getService

public Provider.Service  getService(String  type,
                                   String  algorithm)

지정된 타입의 지정된 알고리즘 또는 별명에 대한 이 Provider 구현을 기술한 서비스를 취득합니다. 그러한 구현이 존재하지 않는 경우, 이 메서드는 null을 리턴합니다. 조건에 일치하는 서비스로서putService()를 사용해 이 프로바이더에 추가된 것과put() 경유로 추가된 것의 2개이 발견되었을 경우, putService() 경유로 추가된 서비스가 리턴됩니다 .

파라미터:

type - 요구되는서비스 타입 (MessageDigest 등)

algorithm - 요구되는 서비스의, 대문자와 소문자를 구별하는 알고리즘명 또는 별명 (SHA-1 등)

반환값:

이 Provider 조건에 일치하는 서비스를 기술한 서비스. 그러한 서비스가 존재하지 않는 경우는 null

예외:

NullPointerException - type, algorithm 중 한쪽이 null 인 경우

도입된 버전 :

1.5

getServices

public Set <Provider.Service > getServices()

이 Provider가 지원하는 모든 서비스의 변경 불가능한 Set를 취득합니다.

반환값:

이 Provider가 지원하는 모든 서비스의 변경 불가능한 Set

도입된 버전 :

1.5

putService

protected void putService(Provider.Service  s)

서비스를 추가합니다. 같은 타입과 알고리즘명을 가지는 서비스가 이미 존재하고 있어, 그것이 putService()를 사용해 추가되고 있었을 경우, 그 서비스는 새로운 서비스로 치환됩니다. 또, 이 메서드는 프로바이더의 Hashtable 값의 이 서비스에 관한 정보의 설정도 실시합니다. 그 때의 형식에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」를 참조하십시오.

또, 시큐러티 매니저가 존재하는 경우, 시큐러티 매니저의 checkSecurityAccess 메서드가 캐릭터 라인 "putProviderProperty. "+name (name는 프로바이더의 이름)를 지정해 불려가 이 프로바이더의 프로퍼티치를 설정해도 괜찮은지 어떤지가 확인됩니다. checkSecurityAccess 디폴트 구현이 사용되는 경우 (즉, 이 메서드가 오버라이드(override)되어 있지 않은 경우), 이 메서드의 호출에의해 시큐러티 매니저의 checkPermission 메서드가 SecurityPermission("putProviderProperty. "+name) 접근 권한을 지정해 호출합니다.

파라미터:

s - 추가하는 서비스

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 SecurityManager.checkSecurityAccess(java.lang.String) 메서드가 이 프로바이더의 프로퍼티치를 설정하는 액세스를 허가하지 않을 때

NullPointerException - s가 null 인 경우

도입된 버전 :

1.5

removeService

protected void removeService(Provider.Service  s)

이전에 putService()를 사용해 추가된 서비스를 삭제합니다. 지정된 서비스는 이 프로바이더로부터 삭제되어getService()를 호출해도 돌려주고지고 없어집니다. 이 프로바이더의 Hashtable 로부터 그 정보가 삭제됩니다.

또, 시큐러티 매니저가 존재하는 경우, 시큐러티 매니저의 checkSecurityAccess 메서드가 캐릭터 라인 "removeProviderProperty. "+name (name는 프로바이더의 이름)를 지정해 불려가 이 프로바이더의 프로퍼티치를 삭제해도 괜찮은지 어떤지가 확인됩니다. checkSecurityAccess 디폴트 구현이 사용되는 경우 (즉, 이 메서드가 오버라이드(override)되어 있지 않은 경우), 이 메서드의 호출에의해 시큐러티 매니저의 checkPermission 메서드가 SecurityPermission("removeProviderProperty. "+name) 접근 권한을 지정해 호출합니다.

파라미터:

s - 삭제되는 서비스

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 SecurityManager.checkSecurityAccess(java.lang.String) 메서드가 이 프로바이더의 프로퍼티치를 삭제하는 액세스를 허가하지 않을 때

NullPointerException - s가 null 인 경우

도입된 버전 :

1.5