uicc.hci.services.connectivity
Interface ConnectivityMessage

All Superinterfaces:

HCIMessage

public interface ConnectivityMessage
extends HCIMessage

The ConnectivityMessage Message offers specialized methods to generate connectivity commands or events.

Field Summary

Fields inherited from interface uicc.hci.framework.HCIMessage

INS_ANY_CLOSE_PIPE, INS_ANY_GET_PARAMETER, INS_ANY_OPEN_PIPE, INS_ANY_SET_PARAMETER, RESP_ADM_E_NO_PIPES_AVAILABLE, RESP_ANY_E_CMD_NOT_SUPPORTED, RESP_ANY_E_CMD_PAR_UNKNOWN, RESP_ANY_E_INHIBITED, RESP_ANY_E_NOK, RESP_ANY_E_NOT_CONNECTED, RESP_ANY_E_PIPE_ACCESS_DENIED, RESP_ANY_E_PIPE_NOT_OPENED, RESP_ANY_E_REG_ACCESS_DENIED, RESP_ANY_E_REG_PAR_UNKNOWN, RESP_ANY_OK, TYPE_COMMAND, TYPE_EVENT, TYPE_RESPONSE

Method Summary

void	prepareAndSendConnectivityEvent() This method builds the HCI event EVT_CONNECTIVITY which notifies the terminal host that it shall send a "HCI connectivity event" as defined in TS 102 223.
void	prepareAndSendTransactionEvent(byte[] aid, short aidOffset, short aidLen, byte[] parameters, short parametersOffset, short parametersLen) This method builds the HCI event EVT_TRANSACTION which notifies the terminal host that it shall launch an application on the terminal which is associated to an Applet in the UICC host identified.

Methods inherited from interface uicc.hci.framework.HCIMessage

getInstruction, getReceiveBuffer, getReceiveLength, getReceiveOffset, getType, isComplete, isHeading

Method Detail

prepareAndSendConnectivityEvent

void prepareAndSendConnectivityEvent()
                                     throws HCIException

This method builds the HCI event EVT_CONNECTIVITY which notifies the terminal host that it shall send a "HCI connectivity event" as defined in TS 102 223.

Throws:

HCIException

prepareAndSendTransactionEvent

void prepareAndSendTransactionEvent(byte[] aid,
                                    short aidOffset,
                                    short aidLen,
                                    byte[] parameters,
                                    short parametersOffset,
                                    short parametersLen)
                                    throws HCIException,
                                           java.lang.ArrayIndexOutOfBoundsException

This method builds the HCI event EVT_TRANSACTION which notifies the terminal host that it shall launch an application on the terminal which is associated to an Applet in the UICC host identified. editor's note: It needs to be discussed if the HCI framework is required to check that the aid belongs to the calling application (or insert it on its own) for security reasons.

Parameters:

aid - buffer with the AID of the Applet or null, if null the framework will use the AID of the Applet instance that calls this method

aidOffset - offset in the buffer with the AID

aidLen - AID length

parameters - buffer with the parameters

parametersOffset - offset in the buffer with the parameters

parametersLen - length of the parameters

Throws:

HCIException

java.lang.ArrayIndexOutOfBoundsException - if operation would cause access of data outside array bounds.