com.licel.jcardsim.smartcardio

Class CardTerminalSimulator

java.lang.Object

com.licel.jcardsim.smartcardio.CardTerminalSimulator

public final class CardTerminalSimulator
extends Object

A simulated TerminalFactory.

Example: Obtaining a Card

 // create card simulator
 CardSimulator cardSimulator = new CardSimulator();

 // connect to a card
 CardTerminal terminal =
   CardTerminalSimulator.terminal(cardSimulator);
 Card card = terminal.connect("*");
 

Example: Inserting/ejecting a Card

 // create card simulator
 CardSimulator cardSimulator = new CardSimulator();

 // create CardTerminal
 CardTerminals terminals = CardTerminalSimulator.terminals("my terminal")
 CardTerminal terminal = terminals.getTerminal("my terminal");

 // insert Card
 cardSimulator.assignToTerminal(terminal);

 // eject Card
 cardSimulator.assignToTerminal(null);
 

See Also:

CardSimulator

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CardTerminalSimulator.Factory TerminalFactorySpi implementation.
static class	CardTerminalSimulator.SecurityProvider Security provider.

Method Summary

Modifier and Type	Method and Description
static CardTerminal	terminal(CardSimulator cardSimulator) Create a CardTerminal with name "jCardSim.Terminal".
static CardTerminal	terminal(CardSimulator cardSimulator, String name) Create a single CardTerminal.
static CardTerminals	terminals(String... names) Create CardTerminals.

Methods inherited from class java.lang.Object

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

Method Detail

terminal

public static CardTerminal terminal(CardSimulator cardSimulator,
                                    String name)

Create a single CardTerminal.

Parameters:

cardSimulator - card to insert

name - the terminal name

Returns:

a new CardTerminal instance

Throws:

NullPointerException - if name or cardSimulator is null

terminal

public static CardTerminal terminal(CardSimulator cardSimulator)

Create a CardTerminal with name "jCardSim.Terminal".

Parameters:

cardSimulator - card to insert

Returns:

a new CardTerminal instance

Throws:

NullPointerException - if name or cardSimulator is null

terminals

public static CardTerminals terminals(String... names)

Create CardTerminals.

Example:

  CardTerminals terminals = CardTerminalSimulator.terminals("1","2");
  CardTerminal terminal = terminals.getTerminal("1");

  // assign simulator
  CardSimulator cardSimulator = new CardSimulator();
  cardSimulator.assignToTerminal(terminal);
 

Parameters:

names - the terminal names

Returns:

a new CardTerminals instance

Throws:

NullPointerException - if names is null

IllegalArgumentException - if any name is null or duplicated

See Also:

CardTerminals