sun.security.jca

Class ProviderList

java.lang.Object

sun.security.jca.ProviderList

public final class ProviderList
extends java.lang.Object

List of Providers. Used to represent the provider preferences. The system starts out with a ProviderList that only has the classNames of the Providers. Providers are loaded on demand only when needed. For compatibility reasons, Providers that could not be loaded are ignored and internally presented as the instance EMPTY_PROVIDER. However, those objects cannot be presented to applications. Call the convert() method to force all Providers to be loaded and to obtain a ProviderList with invalid entries removed. All this is handled by the Security class. Note that all indices used by this class are 0-based per general Java convention. These must be converted to the 1-based indices used by the Security class externally when needed. Instances of this class are immutable. This eliminates the need for cloning and synchronization in consumers. The add() and remove() style methods are static in order to avoid confusion about the immutability.

Since:

1.5

Author:

Andreas Sterbenz

Method Summary

Methods

Modifier and Type	Method and Description
static ProviderList	add(ProviderList providerList, java.security.Provider p)
int	getIndex(java.lang.String name) Return the index at which the provider with the specified name is installed or -1 if it is not present in this ProviderList.
java.security.Provider	getProvider(java.lang.String name)
java.security.Provider.Service	getService(java.lang.String type, java.lang.String name) Return a Service describing an implementation of the specified algorithm from the Provider with the highest precedence that supports that algorithm.
java.util.List<java.security.Provider.Service>	getServices(java.util.List<ServiceId> ids)
java.util.List<java.security.Provider.Service>	getServices(java.lang.String type, java.util.List<java.lang.String> algorithms) Deprecated. use getServices(List) instead
java.util.List<java.security.Provider.Service>	getServices(java.lang.String type, java.lang.String algorithm) Return a List containing all the Services describing implementations of the specified algorithms in precedence order.
static ProviderList	insertAt(ProviderList providerList, java.security.Provider p, int position)
static ProviderList	newList(java.security.Provider... providers)
java.util.List<java.security.Provider>	providers() Return an unmodifiable List of all Providers in this List.
static ProviderList	remove(ProviderList providerList, java.lang.String name)
int	size()
java.security.Provider[]	toArray()
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

add

public static ProviderList add(ProviderList providerList,
               java.security.Provider p)

insertAt

public static ProviderList insertAt(ProviderList providerList,
                    java.security.Provider p,
                    int position)

remove

public static ProviderList remove(ProviderList providerList,
                  java.lang.String name)

newList

public static ProviderList newList(java.security.Provider... providers)

size

public int size()

providers

public java.util.List<java.security.Provider> providers()

Return an unmodifiable List of all Providers in this List. The individual Providers are loaded on demand. Elements that could not be initialized are replaced with EMPTY_PROVIDER.

getProvider

public java.security.Provider getProvider(java.lang.String name)

getIndex

public int getIndex(java.lang.String name)

Return the index at which the provider with the specified name is installed or -1 if it is not present in this ProviderList.

toArray

public java.security.Provider[] toArray()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getService

public java.security.Provider.Service getService(java.lang.String type,
                                        java.lang.String name)

Return a Service describing an implementation of the specified algorithm from the Provider with the highest precedence that supports that algorithm. Return null if no Provider supports this algorithm.

getServices

public java.util.List<java.security.Provider.Service> getServices(java.lang.String type,
                                                         java.lang.String algorithm)

Return a List containing all the Services describing implementations of the specified algorithms in precedence order. If no implementation exists, this method returns an empty List. The elements of this list are determined lazily on demand. The List returned is NOT thread safe.

getServices

@Deprecated
public java.util.List<java.security.Provider.Service> getServices(java.lang.String type,
                                                                    java.util.List<java.lang.String> algorithms)

Deprecated. use getServices(List) instead

This method exists for compatibility with JCE only. It will be removed once JCE has been changed to use the replacement method.

getServices

public java.util.List<java.security.Provider.Service> getServices(java.util.List<ServiceId> ids)