iaik.pkcs.pkcs11

Class SlotInfo

java.lang.Object

iaik.pkcs.pkcs11.SlotInfo

public class SlotInfo
extends Object

Objects of this call provide information about a slot. A slot can be a smart card reader, for instance. Notice that this object is immutable; i.e. it gets its state at object creation and does not alter afterwards. Thus, all information this object provides, is a snapshot at the object creation. This is especially important when calling isTokenPresent().

Version:

1.0

Author:

Karl Scheibelhofer

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SlotInfo(sun.security.pkcs11.wrapper.CK_SLOT_INFO ckSlotInfo) Constructor that takes the CK_SLOT_INFO object as given by PKCS11.C_GetSlotInfo().

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object otherObject) Compares all member variables of this object with the other object.
Version	getFirmwareVersion() Get the version of the slot's firmware.
Version	getHardwareVersion() Get the version of the slot's hardware.
String	getManufacturerID() Get an identifier for the manufacturer of this slot.
String	getSlotDescription() Get a short description of this slot.
int	hashCode() The overriding of this method should ensure that the objects of this class work correctly in a hashtable.
boolean	isHwSlot() Indicate, if the token is a hardware device or if it is just a pure software implementation; e.g.
boolean	isRemovableDevice() Indicate, if the token is removable from this slot or not.
boolean	isTokenPresent() Indicates, if there is a token present in this slot.
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

SlotInfo

protected SlotInfo(sun.security.pkcs11.wrapper.CK_SLOT_INFO ckSlotInfo)

Constructor that takes the CK_SLOT_INFO object as given by PKCS11.C_GetSlotInfo().

Parameters:

ckSlotInfo - The CK_SLOT_INFO object as given by PKCS11.C_GetSlotInfo().

Method Detail

getSlotDescription

public String getSlotDescription()

Get a short description of this slot.

Returns:

A string describing this slot.

getManufacturerID

public String getManufacturerID()

Get an identifier for the manufacturer of this slot.

Returns:

A string identifying the manufacturer of this slot.

getHardwareVersion

public Version getHardwareVersion()

Get the version of the slot's hardware.

Returns:

The version of the hardware of this slot.

getFirmwareVersion

public Version getFirmwareVersion()

Get the version of the slot's firmware.

Returns:

The version of the firmware of this slot.

isTokenPresent

public boolean isTokenPresent()

Indicates, if there is a token present in this slot. Notice, that this refers to the time this object was created and not when this method is invoked.

Returns:

True, if there is a (compatible) token in the slot. False, otherwise.

isRemovableDevice

public boolean isRemovableDevice()

Indicate, if the token is removable from this slot or not. In some cases slot and token will be one device.

Returns:

True, if the tokens are removable. False, otherwise.

isHwSlot

public boolean isHwSlot()

Indicate, if the token is a hardware device or if it is just a pure software implementation; e.g. in case of a pure software token.

Returns:

True, if it is a hardware slot. False, otherwise.

toString

public String toString()

Returns the string representation of this object.

Overrides:

toString in class Object

Returns:

the string representation of object

equals

public boolean equals(Object otherObject)

Compares all member variables of this object with the other object. Returns only true, if all are equal in both objects.

Overrides:

equals in class Object

Parameters:

otherObject - The other SlotInfo object.

Returns:

True, if other is an instance of Info and all member variables of both objects are equal. False, otherwise.

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 slotDescription, manufacturerID, hardwareVersion and firmwareVersion.