iaik.pkcs.pkcs11

Class Slot

java.lang.Object

iaik.pkcs.pkcs11.Slot

public class Slot
extends Object

Objects of this class represent slots that can accept tokens. The application can get a token object, if there is one present, by calling getToken. This may look like this:

   Token token = slot.getToken();

   // to ensure that there is a token present in the slot
   if (token != null) {
     // ... work with the token
   }
 

Version:

1.0

Author:

Karl Scheibelhofer

See Also:

SlotInfo, Token

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Slot(Module module, long slotID) The constructor that takes a reference to the module and the slot ID.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object otherObject) Compares the slot ID and the module_ of this object with the slot ID and module_ of the other object.
Module	getModule() Get the module that created this Slot object.
long	getSlotID() Get the ID of this slot.
SlotInfo	getSlotInfo() Get information about this slot object.
Token	getToken() Get an object for handling the token that is currently present in this slot, or null, if there is no token present.
int	hashCode() The overriding of this method should ensure that the objects of this class work correctly in a hashtable.
boolean	isUseUtf8Encoding() Returns whether UTF8 encoding is set.
void	setUseUtf8Encoding(boolean useUtf8Encoding) Specify, whether UTF8 character encoding shall be used for character array attributes and PINs.
String	toString() Returns the string representation of this object.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Slot

protected Slot(Module module,
               long slotID)

The constructor that takes a reference to the module and the slot ID.

Parameters:

module - The reference to the module of this slot.

slotID - The identifier of the slot.

Method Detail

equals

public boolean equals(Object otherObject)

Compares the slot ID and the module_ of this object with the slot ID and module_ of the other object. Returns only true, if both are equal.

Overrides:

equals in class Object

Parameters:

otherObject - The other Slot object.

Returns:

True, if other is an instance of Slot and the slot ID and module_ of both objects are equal. False, otherwise.

setUseUtf8Encoding

public void setUseUtf8Encoding(boolean useUtf8Encoding)

Specify, whether UTF8 character encoding shall be used for character array attributes and PINs.

Parameters:

useUtf8Encoding - true, if UTF8 shall be used

isUseUtf8Encoding

public boolean isUseUtf8Encoding()

Returns whether UTF8 encoding is set.

Returns:

true, if UTF8 is used as character encoding for character array attributes and PINs.

getModule

public Module getModule()

Get the module that created this Slot object.

Returns:

The module of this slot.

getSlotID

public long getSlotID()

Get the ID of this slot. This is the ID returned by the PKCS#11 module.

Returns:

The ID of this slot.

getSlotInfo

public SlotInfo getSlotInfo()
                     throws TokenException

Get information about this slot object.

Returns:

An object that contains information about this slot.

Throws:

TokenException - If reading the information fails.

getToken

public Token getToken()
               throws TokenException

Get an object for handling the token that is currently present in this slot, or null, if there is no token present.

Returns:

The object for accessing the token. Or null, if none is present in this slot.

Throws:

TokenException - If determining if a token is present fails.

hashCode

public int hashCode()

The overriding of this method should ensure that the objects of this class work correctly in a hashtable.

Overrides:

hashCode in class Object

Returns:

The hash code of this object. Gained from the slot ID.

toString

public String toString()

Returns the string representation of this object.

Overrides:

toString in class Object

Returns:

the string representation of this object