java.security

Class Security

java.lang.Object

java.security.Security

public final class Security
extends Object

Security is the central class in the Java Security API. It manages the list of security Provider that have been installed into this runtime environment.

Method Summary

Modifier and Type	Method and Description
static int	addProvider(Provider provider) Adds the given provider to the collection of providers at the next available position.
static String	getAlgorithmProperty(String algName, String propName) Deprecated. Use AlgorithmParameters and KeyFactory instead.
static Set<String>	getAlgorithms(String serviceName) Returns a Set of all registered algorithms for the specified cryptographic service.
static String	getProperty(String key) Returns the value of the security property named by the argument.
static Provider	getProvider(String name) Returns the Provider with the specified name.
static Provider[]	getProviders() Returns an array containing all installed providers.
static Provider[]	getProviders(Map<String,String> filter) Returns the array of providers which meet the user supplied set of filters.
static Provider[]	getProviders(String filter) Returns the array of providers which meet the user supplied string filter.
static int	insertProviderAt(Provider provider, int position) Insert the given Provider at the specified position.
static void	removeProvider(String name) Removes the Provider with the specified name form the collection of providers.
static void	setProperty(String key, String value) Sets the value of the specified security property.

Methods inherited from class java.lang.Object

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

Method Detail

getAlgorithmProperty

@Deprecated
public static String getAlgorithmProperty(String algName,
                                                      String propName)

Deprecated. Use AlgorithmParameters and KeyFactory instead.

Returns value for the specified algorithm with the specified name.

Parameters:

algName - the name of the algorithm.

propName - the name of the property.

Returns:

value of the property.

insertProviderAt

public static int insertProviderAt(Provider provider,
                                   int position)

Insert the given Provider at the specified position. The positions define the preference order in which providers are searched for requested algorithms.

Parameters:

provider - the provider to insert.

position - the position (starting from 1).

Returns:

the actual position or -1 if the given provider was already in the list. The actual position may be different from the desired position.

addProvider

public static int addProvider(Provider provider)

Adds the given provider to the collection of providers at the next available position.

Parameters:

provider - the provider to be added.

Returns:

the actual position or -1 if the given provider was already in the list.

removeProvider

public static void removeProvider(String name)

Removes the Provider with the specified name form the collection of providers. If the the Provider with the specified name is removed, all provider at a greater position are shifted down one position.

Returns silently if name is null or no provider with the specified name is installed.

Parameters:

name - the name of the provider to remove.

getProviders

public static Provider[] getProviders()

Returns an array containing all installed providers. The providers are ordered according their preference order.

Returns:

an array containing all installed providers.

getProvider

public static Provider getProvider(String name)

Returns the Provider with the specified name. Returns null if name is null or no provider with the specified name is installed.

Parameters:

name - the name of the requested provider.

Returns:

the provider with the specified name, maybe null.

getProviders

public static Provider[] getProviders(String filter)

Returns the array of providers which meet the user supplied string filter. The specified filter must be supplied in one of two formats:

CRYPTO_SERVICE_NAME.ALGORITHM_OR_TYPE

(for example: "MessageDigest.SHA")

CRYPTO_SERVICE_NAME.ALGORITHM_OR_TYPE ATTR_NAME:ATTR_VALUE

(for example: "Signature.MD2withRSA KeySize:512")

Parameters:

filter - case-insensitive filter.

Returns:

the providers which meet the user supplied string filter filter. A null value signifies that none of the installed providers meets the filter specification.

Throws:

InvalidParameterException - if an unusable filter is supplied.

NullPointerException - if filter is null.

getProviders

public static Provider[] getProviders(Map<String,String> filter)

Returns the array of providers which meet the user supplied set of filters. The filter must be supplied in one of two formats:

CRYPTO_SERVICE_NAME.ALGORITHM_OR_TYPE

for example: "MessageDigest.SHA" The value associated with the key must be an empty string.

CRYPTO_SERVICE_NAME.ALGORITHM_OR_TYPE ATTR_NAME:ATTR_VALUE

for example: "Signature.MD2withRSA KeySize:512" where "KeySize:512" is the value of the filter map entry.