net.sf.scuba.smartcards

Class WrappingCardService

java.lang.Object

net.sf.scuba.smartcards.CardService

net.sf.scuba.smartcards.WrappingCardService

public class WrappingCardService
extends CardService

CardService for easy wrapping of APDU messages.

Field Summary

Fields inherited from class net.sf.scuba.smartcards.CardService

SESSION_STARTED_STATE, SESSION_STOPPED_STATE, state

Constructor Summary

Constructors

Constructor and Description
WrappingCardService(CardService service, APDUWrapper wrapper)

Method Summary

Modifier and Type	Method and Description
void	close() Closes the session with the card.
void	disable()
void	enable()
byte[]	getATR() Gets the answer to reset.
boolean	isConnectionLost(Exception e) Determines whether an exception indicates a tag is lost event.
boolean	isEnabled()
boolean	isOpen() Whether there is a session started with the card.
void	open() Opens a session with the card.
ResponseAPDU	transmit(CommandAPDU capdu) Sends an APDU to the card.

Methods inherited from class net.sf.scuba.smartcards.CardService

addAPDUListener, getAPDUListeners, getInstance, isExtendedAPDULengthSupported, notifyExchangedAPDU, removeAPDUListener

Methods inherited from class java.lang.Object

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

Constructor Detail

WrappingCardService

public WrappingCardService(CardService service,
                           APDUWrapper wrapper)

Method Detail

open

public void open()
          throws CardServiceException

Description copied from class: CardService

Opens a session with the card. Selects a reader. Connects to the card. Notifies any interested apduListeners.

Specified by:

open in class CardService

Throws:

CardServiceException - on error

isOpen

public boolean isOpen()

Description copied from class: CardService

Whether there is a session started with the card.

Specified by:

isOpen in class CardService

Returns:

a boolean indicating whether sessions has started

transmit

public ResponseAPDU transmit(CommandAPDU capdu)
                      throws CardServiceException

Description copied from class: CardService

Sends an APDU to the card. Notifies any interested apduListeners. This method does not throw a CardServiceException if the ResponseAPDU is status word indicating error.

Specified by:

transmit in class CardService

Parameters:

capdu - the Command APDU to send

Returns:

the Response APDU from the card, including the status word

Throws:

CardServiceException - if the card operation failed

getATR

public byte[] getATR()
              throws CardServiceException

Description copied from class: CardService

Gets the answer to reset.

Specified by:

getATR in class CardService

Returns:

the answer to reset

Throws:

CardServiceException - on error

close

public void close()

Description copied from class: CardService

Closes the session with the card. Disconnects from the card and reader. Notifies any interested apduListeners.

Specified by:

close in class CardService

enable

public void enable()

isEnabled

public boolean isEnabled()

disable

public void disable()

isConnectionLost

public boolean isConnectionLost(Exception e)

Description copied from class: CardService

Determines whether an exception indicates a tag is lost event.

Specified by:

isConnectionLost in class CardService

Parameters:

e - an exception

Returns:

whether the exception indicates a tag is lost event