Package uicc.connection

Interface SCP81Connection

All Superinterfaces:
Observable
@Deprecated public interface SCP81Connection extends Observable
Deprecated.
This interface is obsolete use SCP8XConnection instead
The SCP81Connection interface represents an SCP81 connection to a remote entity. Objects implementing SCP81Connectioninterface and returned by the ConnectionServer.getConnection method are Permanent Entry Point Objects.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    close()
    Deprecated.
    Close the SCP81 Connection.
    void
    open(byte[] triggeringParameters, short parameterOffset, short parameterLength, byte[] contentType, short contentTypeOffset, short contentTypeLength)
    Deprecated.
    Request to open the SCP81 connection.
    void
    send(byte[] baData, short sOffset, short sLength)
    Deprecated.
    Sends data on the SCP81 Connection.

  • Method Details

    • open

      void open(byte[] triggeringParameters, short parameterOffset, short parameterLength, byte[] contentType, short contentTypeOffset, short contentTypeLength) throws ConnectionException
      Deprecated.
      Request to open the SCP81 connection.

      The associated (directly or indirectly) Security Domain of the calling application will handle the PSK TLS security of the communication.

      The calling application will be notified once the connection is opened or once the setup failed. This method is non-blocking. Note:

      • On invocation of this method, the Security Domain shall register this request. Once resources are available, the RTE/OPEN tries to open the connection, manage the underlying protocol layers and performs the TLS handshake. The observer is then notified with the SCP81ConnectionStatus event.
      Parameters:
      triggeringParameters - this buffer contains the administration session triggering parameters as defined in table 4-3 of Amendment B of Global Platform Card Specification version 2.2. Tag '81' and Length shall be present. Connection parameters defined in Tag '84' may be used if TCP/IP transport is provided by the Bearer Independent Protocol of TS 102 223 [4]. Note: If a direct IP connection as specified in TS 102 483 [YY] is used these parameters will be ignored.
      parameterOffset - the starting offset of the parameters in the triggeringParameters byte array
      parameterLength - the length of the parameters
      contentType - this buffer contains the Content-Type header value to be used when sending an HTTP POST request through this connection.
      contentTypeOffset - the starting offset of the content-type in the contentType byte array
      contentTypeLength - the length of the content-type
      Throws:
      ConnectionException - with the following reason code:
      • INVALID_STATE if the connection is already opened.
      • INVALID_PARAMETERS if the triggering parameters are not correct or if the Content-Type header value defined in the parameters is reserved (for example for RAM/RFM over HTTP or for SCWS remote administration).
      • SCP81_KEY_NOT_FOUNDif this requested SCP81 key could no be found in the associated (directly or indirectly) Security Domain of the calling application.
      • INVALID_HEADER_FIELDif Content-Type header field does not conform with the rules defined in this specification.
      • TOOLKIT_RESOURCE_NOT_AVAILABLE if the proactive command could not be issued.
      ArrayIndexOutOfBoundsException - if parameterOffset and parameterLength are causing access outside of triggeringParameters array bounds or if contentTypeOffset and contentTypeLength are causing access outside of contentType array bounds.
      NullPointerException - if triggeringParameters or contentType are equal to null

    • close

      void close() throws ConnectionException
      Deprecated.
      Close the SCP81 Connection. The calling application will be notified once the connection is closed. This method is non-blocking.
      Throws:
      ConnectionException - with the following reason code:
      • INVALID_STATE if the connection is not open.
      • TOOLKIT_RESOURCE_NOT_AVAILABLE if the proactive command could not be issued.

    • send

      void send(byte[] baData, short sOffset, short sLength) throws ArrayIndexOutOfBoundsException, ConnectionException, NullPointerException
      Deprecated.
      Sends data on the SCP81 Connection.

      Note: The applet execution is resumed once the HTTP POST request containing the data has been sent.

      Note: The chunked transfer coding may be used if necessary.

      Parameters:
      baData - byte array containing the data to be sent
      sOffset - the starting offset of the data to be sent in the baData byte array
      sLength - the length of the data to be sent
      Throws:
      ArrayIndexOutOfBoundsException - if sOffset and sLength are causing access outside of baData array bounds
      ConnectionException - with the following reason code:
      • INVALID_STATE if
        • the connection is not open
        • or if data has been sent through the HTTP POST request and the related HTTP POST response has not yet been delivered to the applet with the DataReceived event
        • or if an HTTP POST response has been delivered to the applet but all received have not been received or discarded.
      • TOOLKIT_RESOURCE_NOT_AVAILABLE if the proactive command could not be issued.
      NullPointerException - if baData is equal to null