ch.fhnw.imvs.smartcard

Class ResponseAPDU

java.lang.Object

ch.fhnw.imvs.smartcard.ResponseAPDU

public class ResponseAPDU
extends java.lang.Object

The Response APDU consists of two Parts: An optional Body of variable length and a Trailer with two status bytes.
Extended APDU can be split in multiple standard APDUs.

Author:

Christof Arnosti (christof.arnosti@fhnw.ch), Jonas Lauener (jonas.lauener@fhnw.ch)

Field Summary

Fields

Modifier and Type	Field and Description
private byte[]	data Contains the bytearray-Representation of this APDU
private static short	MAXIMUM_STAND_APDU_ARGUMENT_LENGTH
static byte	STATUS_B1_OK_BYTES_AVAILABLE
static short	STATUS_COMMAND_NOT_ALLOWED
static short	STATUS_COMMAND_RUNNING
static short	STATUS_INS_NOT_SUPPORTED
static short	STATUS_OK
static short	STATUS_RECORD_NOT_FOUND
static short	STATUS_UNKNOWN_ERROR

Constructor Summary

Constructors

Constructor and Description
ResponseAPDU(byte[] data) Creates a ResponseAPDU object out of the raw bytes of an APDU.
ResponseAPDU(byte[] body, short statuscode) Create a ResponseAPDU out of a body and a statuscode
ResponseAPDU(short statuscode) Create a ResponseAPDU only with a statuscode

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object o) Returns true if the underlying bytearray is equal.
byte[]	getArgumentData() Returns a bytearray of the Argument Data.
int	getArgumentDataLength() Returns length of the Argument Data.
byte[]	getRaw() Returns a Copy of the underlying bytearray.
ResponseAPDU	getStandardResponseAPDU(int parcelNumber) Returns a non-extended ResponseAPDU.
int	getStandardResponseAPDUCount()
byte	getStatusByte1() The first status byte.
byte	getStatusByte2() The second status byte.
short	getStatusBytes() The status bytes as an integer..
boolean	isExtendedAPDU() Check if this is a extended response APDU.
boolean	isValidAPDU() Checks if this is a valid response APDU.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

MAXIMUM_STAND_APDU_ARGUMENT_LENGTH

private static final short MAXIMUM_STAND_APDU_ARGUMENT_LENGTH

See Also:

Constant Field Values

STATUS_OK

public static final short STATUS_OK

See Also:

Constant Field Values

STATUS_B1_OK_BYTES_AVAILABLE

public static final byte STATUS_B1_OK_BYTES_AVAILABLE

See Also:

Constant Field Values

STATUS_UNKNOWN_ERROR

public static final short STATUS_UNKNOWN_ERROR

See Also:

Constant Field Values

STATUS_INS_NOT_SUPPORTED

public static final short STATUS_INS_NOT_SUPPORTED

See Also:

Constant Field Values

STATUS_RECORD_NOT_FOUND

public static final short STATUS_RECORD_NOT_FOUND

See Also:

Constant Field Values

STATUS_COMMAND_RUNNING

public static final short STATUS_COMMAND_RUNNING

See Also:

Constant Field Values

STATUS_COMMAND_NOT_ALLOWED

public static final short STATUS_COMMAND_NOT_ALLOWED

See Also:

Constant Field Values

data

private final byte[] data

Contains the bytearray-Representation of this APDU

Constructor Detail

ResponseAPDU

public ResponseAPDU(short statuscode)

Create a ResponseAPDU only with a statuscode

Parameters:

statuscode - The last two bytes of the integer will be used as status code.

ResponseAPDU

public ResponseAPDU(byte[] data)

Creates a ResponseAPDU object out of the raw bytes of an APDU.

Parameters:

data - The Bytearray containing the Response APDU

ResponseAPDU

public ResponseAPDU(byte[] body,
            short statuscode)

Create a ResponseAPDU out of a body and a statuscode

Parameters:

body - bytearray of arbitary length or null. Null is treated as no body

statuscode - The last two bytes of the integer will be used as status code.

Method Detail

isValidAPDU

public boolean isValidAPDU()

Checks if this is a valid response APDU.

Returns:

true if this is a valid response APDU, false otherwise.

isExtendedAPDU

public boolean isExtendedAPDU()

Check if this is a extended response APDU.

Returns:

true if argument data length is greater than 256, false otherwise.

getStatusByte1

public byte getStatusByte1()

The first status byte.

Returns:

the first status byte.

getStatusByte2

public byte getStatusByte2()

The second status byte.

Returns:

the second status byte.

getStatusBytes

public short getStatusBytes()

The status bytes as an integer..

Returns:

status byte.

getArgumentData

public byte[] getArgumentData()

Returns a bytearray of the Argument Data. If no Argument Data is present, an array of length 0 is returned.

Returns:

Argument Data

getArgumentDataLength

public int getArgumentDataLength()

Returns length of the Argument Data. If no Argument Data is present, 0 is returned.

Returns:

length of Argument Data

getRaw

public byte[] getRaw()

Returns a Copy of the underlying bytearray.

Returns:

A Copy of the byte[]-Representation of this APDU.

getStandardResponseAPDU

public ResponseAPDU getStandardResponseAPDU(int parcelNumber)

Returns a non-extended ResponseAPDU. The status bytes indicate if more ResponseAPDU are following.

Parameters:

parcelNumber - An extended ResponseAPDU has to be parceled in multiple non-extended ResponseAPDUs. Starting from zero.

Returns:

A non-extended ResponseAPDU.

getStandardResponseAPDUCount

public int getStandardResponseAPDUCount()

equals

public boolean equals(java.lang.Object o)

Returns true if the underlying bytearray is equal.

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object