Provider - JRE Emulation | JRE Emulation
public abstract class

Provider

extends Properties
java.lang.Object
   ↳ java.util.Dictionary<java.lang.Objectjava.lang.Object>
     ↳ java.util.Hashtable<java.lang.Objectjava.lang.Object>
       ↳ java.util.Properties
         ↳ java.security.Provider

Class Overview

Provider is the abstract superclass for all security providers in the Java security infrastructure.

Summary

Nested Classes
class Provider.Service Service represents a service in the Java Security infrastructure. 
[Expand]
Inherited Fields
From class java.util.Properties
Protected Constructors
Provider(String name, double version, String info)
Constructs a new instance of Provider with its name, version and description.
Public Methods
synchronized void clear()
Clears all properties used to look up services implemented by this Provider.
synchronized Set<Entry<ObjectObject>> entrySet()
Returns a Set view of the mappings contained in this map.
String getInfo()
Returns a description of the services being provided.
String getName()
Returns the name of this provider.
synchronized Provider.Service getService(String type, String algorithm)
Returns the service with the specified type implementing the specified algorithm, or null if no such implementation exists.
synchronized Set<Provider.Service> getServices()
Returns an unmodifiable Set of all services registered by this provider.
double getVersion()
Returns the version number for the services being provided.
Set<Object> keySet()
Returns a Set view of the keys contained in this map.
synchronized void load(InputStream inStream)
Reads a property list (key and element pairs) from the input byte stream.
synchronized Object put(Object key, Object value)
Maps the specified key property name to the specified value.
synchronized void putAll(Map<?, ?> t)
Copies all from the provided map to this Provider.
synchronized Object remove(Object key)
Removes the specified key and its associated value from this Provider.
String toString()
Returns a string containing a concise, human-readable description of this Provider including its name and its version.
Collection<Object> values()
Returns a Collection view of the values contained in this map.
Protected Methods
synchronized void putService(Provider.Service s)
Adds a Service to this Provider.
synchronized void removeService(Provider.Service s)
Removes a previously registered Service from this Provider.
Inherited Methods
[Expand]
From class java.util.Properties
From class java.util.Hashtable
From class java.util.Dictionary
From class java.lang.Object
From interface java.util.Map

Protected Constructors

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

Constructs a new instance of Provider with its name, version and description.

Parameters
name the name of the provider.
version the version of the provider.
info a description of the provider.

Public Methods

public synchronized void clear ()

Clears all properties used to look up services implemented by this Provider.

public synchronized Set<Entry<ObjectObject>> entrySet ()

Returns a Set view of the mappings contained in this map. The set is backed by the map, so changes to the map are reflected in the set, and vice-versa. If the map is modified while an iteration over the set is in progress (except through the iterator's own remove operation, or through the setValue operation on a map entry returned by the iterator) the results of the iteration are undefined. The set supports element removal, which removes the corresponding mapping from the map, via the Iterator.remove, Set.remove, removeAll, retainAll and clear operations. It does not support the add or addAll operations.

Returns
  • a set view of the mappings contained in this map

public String getInfo ()

Returns a description of the services being provided.

Returns
  • a description of the services being provided.

public String getName ()

Returns the name of this provider.

Returns
  • the name of this provider.

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

Returns the service with the specified type implementing the specified algorithm, or null if no such implementation exists.

If two services match the requested type and algorithm, the one added with the putService(Service) is returned (as opposed to the one added via put(Object, Object).

Parameters
type the type of the service (for example KeyPairGenerator)
algorithm the algorithm name (case insensitive)
Returns
  • the requested service, or null if no such implementation exists

public synchronized Set<Provider.Service> getServices ()

Returns an unmodifiable Set of all services registered by this provider.

Returns
  • an unmodifiable Set of all services registered by this provider

public double getVersion ()

Returns the version number for the services being provided.

Returns
  • the version number for the services being provided.

public Set<Object> keySet ()

Returns a Set view of the keys contained in this map. The set is backed by the map, so changes to the map are reflected in the set, and vice-versa. If the map is modified while an iteration over the set is in progress (except through the iterator's own remove operation), the results of the iteration are undefined. The set supports element removal, which removes the corresponding mapping from the map, via the Iterator.remove, Set.remove, removeAll, retainAll, and clear operations. It does not support the add or addAll operations.

Returns
  • a set view of the keys contained in this map

public synchronized void load (InputStream inStream)

Reads a property list (key and element pairs) from the input byte stream. The input stream is in a simple line-oriented format as specified in load(Reader) and is assumed to use the ISO 8859-1 character encoding; that is each byte is one Latin1 character. Characters not in Latin1, and certain special characters, are represented in keys and elements using Unicode escapes as defined in section 3.3 of The Java™ Language Specification.

The specified stream remains open after this method returns.

Parameters
inStream the input stream.
Throws
IOException

public synchronized Object put (Object key, Object value)

Maps the specified key property name to the specified value.

Parameters
key the name of the property.
value the value of the property.
Returns
  • the value that was previously mapped to the specified key ,or null if it did not have one.

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

Copies all from the provided map to this Provider.

Parameters
t the mappings to copy to this provider.

public synchronized Object remove (Object key)

Removes the specified key and its associated value from this Provider.

Parameters
key the name of the property
Returns
  • the value that was mapped to the specified key ,or null if no mapping was present

public String toString ()

Returns a string containing a concise, human-readable description of this Provider including its name and its version.

Returns
  • a printable representation for this Provider.

public Collection<Object> values ()

Returns a Collection view of the values contained in this map. The collection is backed by the map, so changes to the map are reflected in the collection, and vice-versa. If the map is modified while an iteration over the collection is in progress (except through the iterator's own remove operation), the results of the iteration are undefined. The collection supports element removal, which removes the corresponding mapping from the map, via the Iterator.remove, Collection.remove, removeAll, retainAll and clear operations. It does not support the add or addAll operations.

Returns
  • a collection view of the values contained in this map

Protected Methods

protected synchronized void putService (Provider.Service s)

Adds a Service to this Provider. If a service with the same name was registered via this method, it is replace.

Parameters
s the Service to register

protected synchronized void removeService (Provider.Service s)

Removes a previously registered Service from this Provider.

Parameters
s the Service to remove
Throws
NullPointerException if s is null