class Akenti::Provider

A Provider object is a reference-count pointer that wraps a ProviderImpl object.

Inheritance:


Public Methods

[more] Provider (ProviderImpl* impl = NULL)
Constructs a Provider given a ProviderImpl object.
[more] ~Provider ()
Destroys this object.
[more]static void setProvider (const Provider& prov)
Installs a Provider.
[more]static Provider& getProvider ()
Returns the installed providerThis call will fail if a provider has not been installed.


Documentation

A Provider object is a reference-count pointer that wraps a ProviderImpl object. It provides applications, albeit indirectly, with objects that implement security algorithms such as MessageDigest, Base64encoding and Signature. At start-up a Provider is instantiated from a selected ProviderImpl, e.g. OpenSSLProviderImpl, and installed as the single static provider. Any attempt to reinstall a provider will fail. As a result, the code can call static methods to perform various security algorithms, but there is still some flexibilty as to what implementations to use for these algorithms.

o Provider(ProviderImpl* impl = NULL)
Constructs a Provider given a ProviderImpl object. Typically, an application installs a provider at start-up using the the setProvider(Provider&) method. Clients need never hold a reference to this installed provider. The static getProvider() method can be used to get a reference to the installed provider.

Parameters:
impl - wrapped ProviderImpl object
See Also:
ref_ptr
ProviderImpl
setProvider(Provider&)
getProvider()

o ~Provider()
Destroys this object.

See Also:
ref_ptr

ostatic void setProvider(const Provider& prov)
Installs a Provider. This can only be called once in the lifetime of a program. Usually, this call should be made at start-up.

Throws:
SecurityException if a provider is already installed
Parameters:
prov - the provider to be installed.

ostatic Provider& getProvider()
Returns the installed providerThis call will fail if a provider has not been installed.

Throws:
Error if no provider has been installed
Returns:
the pre-installed provider
See Also:
setProvider(Provider&)


This class has no child classes.
Author:
Srilekha Mudumbai Abdelilah Essiari
Version:
1.1 00/05/01
See Also:
ref_ptr
ProviderImpl
MessageDigest
Signature
KeyFactory
CertificateFactory
SecurityException
Error

Alphabetic index HTML hierarchy of classes or Java



This page was generated with the help of DOC++.