org.eclipse.keyple.calypso.transaction.sammanager

Class SamResourceManager

java.lang.Object

org.eclipse.keyple.calypso.transaction.sammanager.SamResourceManager

Direct Known Subclasses:

SamResourceManagerDefault, SamResourceManagerPool

public abstract class SamResourceManager
extends java.lang.Object

Management of SAM resources:

Provides methods fot the allocation/deallocation of SAM resources

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SamResourceManager.AllocationMode

Constructor Summary

Constructors

Constructor and Description
SamResourceManager()

Method Summary

Modifier and Type	Method and Description
abstract org.eclipse.keyple.core.card.selection.CardResource<CalypsoSam>	allocateSamResource(SamResourceManager.AllocationMode allocationMode, SamIdentifier samIdentifier) Allocate a SAM resource from the specified SAM group.
protected org.eclipse.keyple.calypso.transaction.sammanager.SamResourceManagerDefault.ManagedSamResource	createSamResource(org.eclipse.keyple.core.service.Reader samReader) Deprecated.
abstract void	freeSamResource(org.eclipse.keyple.core.card.selection.CardResource<CalypsoSam> samResource) Free a previously allocated SAM resource.

Methods inherited from class java.lang.Object

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

Constructor Detail

SamResourceManager

public SamResourceManager()

Method Detail

allocateSamResource

public abstract org.eclipse.keyple.core.card.selection.CardResource<CalypsoSam> allocateSamResource(SamResourceManager.AllocationMode allocationMode,
                                                                                                    SamIdentifier samIdentifier)

Allocate a SAM resource from the specified SAM group.

In the case where the allocation mode is BLOCKING, this method will wait until a SAM resource becomes free and then return the reference to the allocated resource. However, the BLOCKING mode will wait a maximum time defined in milliseconds by MAX_BLOCKING_TIME.

In the case where the allocation mode is NON_BLOCKING and no SAM resource is available, this method will return an exception.

If the samGroup argument is null, the first available SAM resource will be selected and returned regardless of its group.

Parameters:

allocationMode - the blocking/non-blocking mode

samIdentifier - the targeted SAM identifier

Returns:

a SAM resource

Throws:

CalypsoNoSamResourceAvailableException - if no resource is available

org.eclipse.keyple.core.service.exception.KeypleReaderException - if a reader error occurs

org.eclipse.keyple.core.service.exception.KeypleAllocationReaderException - if reader allocation fails

freeSamResource

public abstract void freeSamResource(org.eclipse.keyple.core.card.selection.CardResource<CalypsoSam> samResource)

Free a previously allocated SAM resource.

Parameters:

samResource - the SAM resource reference to free

createSamResource

protected org.eclipse.keyple.calypso.transaction.sammanager.SamResourceManagerDefault.ManagedSamResource createSamResource(org.eclipse.keyple.core.service.Reader samReader)

Deprecated.

Create a SAM resource from the provided SAM reader.

Proceed with the SAM selection and combine the SAM reader and the Calypso SAM resulting from the selection.

Parameters:

samReader - the SAM reader with which the APDU exchanges will be done.

Returns:

a CardResource

Throws:

CalypsoNoSamResourceAvailableException - if an error occurs while doing the selection