org.dihedron.crypto.providers.smartcard.discovery

Class DataBaseLoader

java.lang.Object

org.dihedron.crypto.providers.smartcard.discovery.DataBaseLoader

@License
public final class DataBaseLoader
extends Object

The class responsible of loading the database of supported smart cards, along with info about their their supporting PKCS#11 drivers.

Author:

Andrea Funto'

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_SMARTCARDS_XML The name of the file containing the default smart cards database.
static String	SMARTCARDS_XSD The name of the smart cards database schema.

Constructor Summary

Constructors

Constructor and Description
DataBaseLoader()

Method Summary

Methods

Modifier and Type	Method and Description
static DataBase	load() Loads the default smart cards database from the default XML on the class path.
static DataBase	load(InputStream input) Initialises the database by parsing the XML file passed in as an input stream.
static DataBase	load(String specification) Loads the smart card database from the URL represented by the given specification.
static DataBase	load(URL url) Loads a database trying to open the stream from the given URL.

Methods inherited from class java.lang.Object

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

Field Detail

SMARTCARDS_XSD

public static final String SMARTCARDS_XSD

The name of the smart cards database schema.

See Also:

Constant Field Values

DEFAULT_SMARTCARDS_XML

public static final String DEFAULT_SMARTCARDS_XML

The name of the file containing the default smart cards database.

See Also:

Constant Field Values

Constructor Detail

DataBaseLoader

public DataBaseLoader()

Method Detail

load

public static DataBase load()
                     throws SmartCardException

Loads the default smart cards database from the default XML on the class path.

Returns:

a smart card database loaded with the default information from the JAR.

Throws:

SmartCardException - if any error occurs: the method will not return null and will throw instead.

load

public static DataBase load(String specification)
                     throws SmartCardException

Loads the smart card database from the URL represented by the given specification.

Parameters:

specification - an URL specification (including "classpath:" extension); if null, the default database will be loaded.

Returns:

a smart card database.

Throws:

SmartCardException - if any error occurs: the method will not return null and will throw instead.

load

public static DataBase load(URL url)
                     throws SmartCardException

Loads a database trying to open the stream from the given URL.

Parameters:

url - the URL from which the database will be read; if null, the default database will be loaded.

Returns:

a smart card database.

Throws:

SmartCardException - if any error occurs: the method will not return null and will throw instead.

load

public static DataBase load(InputStream input)
                     throws SmartCardException

Initialises the database by parsing the XML file passed in as an input stream.

Parameters:

input - the database file as a stream; the stream will always be closed by the time the method returns. If the stream is null, the method exits immediately without any complaint, in order to make smart cards loading optional.

Throws:

SmartCardException - if any error occurs: the method will not return null and will throw instead.