CommandAPDU JDK 1.6)

Description

publicfinal class CommandAPDU

A command APDU following the structure defined in ISO/IEC 7816-4.

See also: ResponseAPDU CardChannel.transmit

Constructors

public CommandAPDU (byte[] apdu)

Constructs a CommandAPDU from a byte array containing the complete APDU contents (header and body).

public CommandAPDU (byte[] apdu, int apduOffset, int apduLength)

Constructs a CommandAPDU from a byte array containing the complete APDU contents (header and body).

Constructs a CommandAPDU from a byte array containing the complete APDU contents (header and body). The APDU starts at the index apduOffset in the byte array and is apduLength bytes long.

Note that the apdu bytes are copied to protect against subsequent modification.
Parameters:
- apdu - the complete command APDU
- apduOffset - the offset in the byte array at which the apdu data begins
- apduLength - the length of the APDU
Throws:
- NullPointerException - if apdu is null
- IllegalArgumentException - if apduOffset or apduLength are negative or if apduOffset + apduLength are greater than apdu.length, or if the specified bytes are not a valid APDU

public CommandAPDU (ByteBuffer apdu)

Creates a CommandAPDU from the ByteBuffer containing the complete APDU contents (header and body).

Creates a CommandAPDU from the ByteBuffer containing the complete APDU contents (header and body). The buffer's position must be set to the start of the APDU, its limit to the end of the APDU. Upon return, the buffer's position is equal to its limit; its limit remains unchanged.

Note that the data in the ByteBuffer is copied to protect against subsequent modification.
Parameters:
- apdu - the ByteBuffer containing the complete APDU
Throws:
- NullPointerException - if apdu is null
- IllegalArgumentException - if apdu does not contain a valid command APDU

public CommandAPDU (int cla, int ins, int p1, int p2)

Constructs a CommandAPDU from the four header bytes.

public CommandAPDU (int cla, int ins, int p1, int p2, byte[] data)

Constructs a CommandAPDU from the four header bytes and command data.

Constructs a CommandAPDU from the four header bytes and command data. This is case 3 in ISO 7816, command data present and Ne absent. The value Nc is taken as data.length. If data is null or its length is 0, the APDU is encoded as ISO 7816 case 1.

public CommandAPDU (int cla, int ins, int p1, int p2, byte[] data, int ne)

Constructs a CommandAPDU from the four header bytes, command data, and expected response data length.

Constructs a CommandAPDU from the four header bytes, command data, and expected response data length. This is case 4 in ISO 7816, command data and Ne present. The value Nc is taken as data.length if data is non-null and as 0 otherwise. If Ne or Nc are zero, the APDU is encoded as case 1, 2, or 3 per ISO 7816.

public CommandAPDU (int cla, int ins, int p1, int p2, byte[] data, int dataOffset, int dataLength)

Constructs a CommandAPDU from the four header bytes and command data.

Constructs a CommandAPDU from the four header bytes and command data. This is case 3 in ISO 7816, command data present and Ne absent. The value Nc is taken as dataLength. If dataLength is 0, the APDU is encoded as ISO 7816 case 1.

Note that the data bytes are copied to protect against subsequent modification.
Parameters:
- cla - the class byte CLA
- ins - the instruction byte INS
- p1 - the parameter byte P1
- p2 - the parameter byte P2
- data - the byte array containing the data bytes of the command body
- dataOffset - the offset in the byte array at which the data bytes of the command body begin
- dataLength - the number of the data bytes in the command body
Throws:
- NullPointerException - if data is null and dataLength is not 0
- IllegalArgumentException - if dataOffset or dataLength are negative or if dataOffset + dataLength are greater than data.length or if dataLength is greater than 65535

public CommandAPDU (int cla, int ins, int p1, int p2, byte[] data, int dataOffset, int dataLength, int ne)

Constructs a CommandAPDU from the four header bytes, command data, and expected response data length.

Constructs a CommandAPDU from the four header bytes, command data, and expected response data length. This is case 4 in ISO 7816, command data and Le present. The value Nc is taken as dataLength. If Ne or Nc are zero, the APDU is encoded as case 1, 2, or 3 per ISO 7816.

Note that the data bytes are copied to protect against subsequent modification.
Parameters:
- cla - the class byte CLA
- ins - the instruction byte INS
- p1 - the parameter byte P1
- p2 - the parameter byte P2
- data - the byte array containing the data bytes of the command body
- dataOffset - the offset in the byte array at which the data bytes of the command body begin
- dataLength - the number of the data bytes in the command body
- ne - the maximum number of expected data bytes in a response APDU
Throws:
- NullPointerException - if data is null and dataLength is not 0
- IllegalArgumentException - if dataOffset or dataLength are negative or if dataOffset + dataLength are greater than data.length, or if ne is negative or greater than 65536, or if dataLength is greater than 65535

public CommandAPDU (int cla, int ins, int p1, int p2, int ne)

Constructs a CommandAPDU from the four header bytes and the expected response data length.

Methods

Hide/Show inherited methods

public boolean equals (Object obj)

Compares the specified object with this command APDU for equality.

public byte getBytes ()

Returns a copy of the bytes in this APDU.

public int getCLA ()

Returns the value of the class byte CLA.

public byte getData ()

Returns a copy of the data bytes in the command body.

public int getINS ()

Returns the value of the instruction byte INS.

public int getNc ()

Returns the number of data bytes in the command body (Nc) or 0 if this APDU has no body.

Returns the number of data bytes in the command body (Nc) or 0 if this
APDU has no body. This call is equivalent to
getData().length.
Returns: the number of data bytes in the command body or 0 if this APDU has no body.

public int getNe ()

Returns the maximum number of expected data bytes in a response APDU (Ne).

public int getP1 ()

Returns the value of the parameter byte P1.

public int getP2 ()

Returns the value of the parameter byte P2.

public int hashCode ()

Returns the hash code value for this command APDU.

public String toString ()

Returns a string representation of this command APDU.