java.security
public final class Security extends Object
Method Summary | |
---|---|
static int | addProvider(Provider provider) |
static String | getAlgorithmProperty(String algName, String propName)
Returns the value associated to a designated property name for a given
algorithm.
|
static Set<String> | getAlgorithms(String serviceName)
For a given service (e.g. |
static String | getProperty(String key)
Returns the value associated with a Security propery.
|
static Provider | getProvider(String name)
Returns an already installed Provider given its name.
|
static Provider[] | getProviders()
Returns the current list of installed Providers as an array
ordered according to their installation preference order.
|
static Provider[] | getProviders(String filter)
Returns an array of currently installed Providers, ordered
according to their installation preference order, which satisfy a given
selection criterion.
|
static Provider[] | getProviders(Map<String,String> filter)
Returns an array of currently installed Providers which satisfy a
set of selection criteria.
|
static int | insertProviderAt(Provider provider, int position) |
static void | removeProvider(String name) |
static void | setProperty(String key, String datum)
Sets or changes a designated Security property to a designated value.
|
Parameters: provider the new Provider to append.
Returns: the position (starting from 1) of provider
in the
current list of Providers, or -1
if
provider
was already there.
Throws: SecurityException if a SecurityManager is installed and it disallows this operation.
See Also: getProvider removeProvider SecurityPermission
Deprecated: Use the provider-based and algorithm-independent AlgorithmParameters and KeyFactory engine classes instead.
Returns the value associated to a designated property name for a given algorithm.Parameters: algName the algorithm name. propName the name of the property to return.
Returns: the value of the specified property or null
if none
found.
Parameters: serviceName the case-insensitive name of a service (e.g. Signature, MessageDigest, etc).
Returns: a Set of Strings containing the names of all algorithm names provided by all of the currently installed Providers.
Since: 1.4
Parameters: key the key of the property to fetch.
Returns: the value of the Security property associated with
key
. Returns null
if no such property
was found.
Throws: SecurityException if a SecurityManager is installed and it disallows this operation.
See Also: Security SecurityPermission
Parameters: name the name of an already installed Provider.
Returns: the Provider known by name
. Returns
null
if the current list of Providers does
not include one named name
.
See Also: removeProvider addProvider
Returns: an array of all the installed providers.
This implementation recognizes a selection criterion written in one of two following forms:
For example, "CertificateFactory.X.509" would return all the installed Providers which provide a CertificateFactory implementation of X.509.
For example, "Signature.Sha1WithDSS KeySize:1024" would return all the installed Providers which declared their ability to provide Signature services, using the Sha1WithDSS algorithm with key sizes of 1024.
Parameters: filter the selection criterion for selecting among the installed Providers.
Returns: all the installed Providers which satisfy the selection
criterion. Returns null
if no installed
Providers were found which satisfy the selection
criterion. Returns ALL installed Providers if
filter
is null
or is an empty string.
Throws: InvalidParameterException
if an exception occurs while parsing the filter
.
See Also: getProviders
The selection criteria are defined in a Map where each element specifies a selection querry. The Keys in this Map must be in one of the two following forms:
null
or an empty string. Providers which
declare the designated attribute_name and value for the
designated service algorithm are included in the result.Parameters: filter a Map of selection querries.
Returns: all currently installed Providers which satisfy ALL the
selection criteria defined in filter
.
Returns ALL installed Providers if filter
is null
or empty.
Throws: InvalidParameterException if an exception is encountered while parsing the syntax of the Map's keys.
See Also: getProviders
Parameters: provider
the new Provider to add. position
the position (starting from 1) of where to install
provider
.
Returns: the actual position, in the list of installed Providers. Returns
-1
if provider
was laready in the
list. The actual position may be different than the desired
position
.
Throws: SecurityException if a SecurityManager is installed and it disallows this operation.
See Also: getProvider removeProvider SecurityPermission
Parameters: name the name of an already installed Provider to remove.
Throws: SecurityException if a SecurityManager is installed and it disallows this operation.
See Also: getProvider addProvider
Parameters: key the name of the property to set. datum the new value of the property.
Throws: SecurityException if a SecurityManager is installed and it disallows this operation.
See Also: getProperty SecurityPermission