org.eclipse.keyple.calypso.command.po.builder.storedvalue

Class SvReloadCmdBuild

java.lang.Object

org.eclipse.keyple.core.card.command.AbstractApduCommandBuilder

org.eclipse.keyple.core.card.command.AbstractIso7816CommandBuilder

org.eclipse.keyple.calypso.command.po.AbstractPoCommandBuilder<SvReloadRespPars>

org.eclipse.keyple.calypso.command.po.builder.storedvalue.SvReloadCmdBuild

public final class SvReloadCmdBuild
extends AbstractPoCommandBuilder<SvReloadRespPars>

Builds the SV Reload command.

Since:

0.9

Field Summary

Fields inherited from class org.eclipse.keyple.core.card.command.AbstractApduCommandBuilder

commandRef, request

Constructor Summary

Constructors

Constructor and Description
SvReloadCmdBuild(PoClass poClass, PoRevision poRevision, int amount, byte kvc, byte[] date, byte[] time, byte[] free) Instantiates a new SvReloadCmdBuild.

Method Summary

Modifier and Type	Method and Description
SvReloadRespPars	createResponseParser(org.eclipse.keyple.core.card.message.ApduResponse apduResponse) Create the response parser.
void	finalizeBuilder(byte[] reloadComplementaryData) Complete the construction of the APDU to be sent to the PO with the elements received from the SAM:
byte[]	getSvReloadData() Gets the SV Reload part of the data to include in the SAM SV Prepare Load command
boolean	isSessionBufferUsed() Indicates if the session buffer is used when executing this command.

Methods inherited from class org.eclipse.keyple.calypso.command.po.AbstractPoCommandBuilder

getCommandRef

Methods inherited from class org.eclipse.keyple.core.card.command.AbstractIso7816CommandBuilder

setApduRequest

Methods inherited from class org.eclipse.keyple.core.card.command.AbstractApduCommandBuilder

addSubName, getApduRequest, getName

Methods inherited from class java.lang.Object

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

Constructor Detail

SvReloadCmdBuild

public SvReloadCmdBuild(PoClass poClass,
                        PoRevision poRevision,
                        int amount,
                        byte kvc,
                        byte[] date,
                        byte[] time,
                        byte[] free)

Instantiates a new SvReloadCmdBuild.

The process is carried out in two steps: first to check and store the PO and application data, then to create the final APDU with the data from the SAM (see finalizeBuilder).

Parameters:

poClass - the PO class

poRevision - the PO revision

amount - amount to debit (signed integer from -8388608 to 8388607)

kvc - debit key KVC (not checked by the PO)

date - debit date (not checked by the PO)

time - debit time (not checked by the PO)

free - 2 free bytes stored in the log but not processed by the PO

Throws:

java.lang.IllegalArgumentException - - if the command is inconsistent

Since:

0.9

Method Detail

finalizeBuilder

public void finalizeBuilder(byte[] reloadComplementaryData)

Complete the construction of the APDU to be sent to the PO with the elements received from the SAM:

4-byte SAM id

3-byte challenge

3-byte transaction number

5 or 10 byte signature (hi part)

Parameters:

reloadComplementaryData - the sam id and the data out from the SvPrepareReload SAM command

Since:

0.9

getSvReloadData

public byte[] getSvReloadData()

Gets the SV Reload part of the data to include in the SAM SV Prepare Load command

Returns:

a byte array containing the SV reload data

Since:

0.9

createResponseParser

public SvReloadRespPars createResponseParser(org.eclipse.keyple.core.card.message.ApduResponse apduResponse)

Create the response parser.

A check is made to see if the object has been finalized. If not, an exception IllegalStateException is thrown.

Specified by:

createResponseParser in class AbstractPoCommandBuilder<SvReloadRespPars>

Parameters:

apduResponse - the response data from the the card

Returns:

a SvReloadRespPars object

Since:

0.9

isSessionBufferUsed

public boolean isSessionBufferUsed()

Indicates if the session buffer is used when executing this command.

Allows the management of the overflow of this buffer.

This command modified the contents of the PO and therefore uses the session buffer.

Specified by:

isSessionBufferUsed in class AbstractPoCommandBuilder<SvReloadRespPars>

Returns:

true

Since:

0.9