org.eclipse.keyple.calypso.transaction.sammanager

Class SamResourceManagerDefault

java.lang.Object

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

org.eclipse.keyple.calypso.transaction.sammanager.SamResourceManagerDefault

Deprecated.

public class SamResourceManagerDefault
extends SamResourceManager

Implementation of Sam Resource Manager working a Plugin (either Stub or Pcsc) It is meant to work with a Keyple Pcsc Plugin or a Keyple Stub Plugin.

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.keyple.calypso.transaction.sammanager.SamResourceManager

SamResourceManager.AllocationMode

Field Summary

Fields

Modifier and Type	Field and Description
protected org.eclipse.keyple.core.service.Plugin	samReaderPlugin Deprecated.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SamResourceManagerDefault(org.eclipse.keyple.core.service.Plugin plugin, java.lang.String samReaderFilter, int maxBlockingTime, int sleepTime) Deprecated. Protected constructor, use the SamResourceManagerFactory

Method Summary

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

Methods inherited from class org.eclipse.keyple.calypso.transaction.sammanager.SamResourceManager

createSamResource

Methods inherited from class java.lang.Object

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

Field Detail

samReaderPlugin

protected final org.eclipse.keyple.core.service.Plugin samReaderPlugin

Deprecated.

Constructor Detail

SamResourceManagerDefault

protected SamResourceManagerDefault(org.eclipse.keyple.core.service.Plugin plugin,
                                    java.lang.String samReaderFilter,
                                    int maxBlockingTime,
                                    int sleepTime)

Deprecated.

Protected constructor, use the SamResourceManagerFactory

Parameters:

plugin - the plugin through which SAM readers are accessible

samReaderFilter - the regular expression defining how to identify SAM readers among others.

maxBlockingTime - the maximum duration for which the allocateSamResource method will attempt to allocate a new reader by retrying (in milliseconds)

sleepTime - the duration to wait between two retries

Throws:

org.eclipse.keyple.core.service.exception.KeypleReaderException - thrown if an error occurs while getting the readers list.

Method Detail

removeResource

protected void removeResource(org.eclipse.keyple.core.service.Reader samReader)

Deprecated.

Remove a CardResource from the current CardResource CalypsoSam> list

Parameters:

samReader - the SAM reader of the resource to remove from the list.

allocateSamResource

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

Deprecated.

Description copied from class: SamResourceManager

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.

Specified by:

allocateSamResource in class SamResourceManager

Parameters:

allocationMode - the blocking/non-blocking mode

samIdentifier - the targeted SAM identifier

Returns:

a SAM resource

freeSamResource

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

Deprecated.

Description copied from class: SamResourceManager

Free a previously allocated SAM resource.

Specified by:

freeSamResource in class SamResourceManager

Parameters:

samResource - the SAM resource reference to free