Package uicc.connection

Class ConnectionServer

  • public class ConnectionServer
extends java.lang.Object
    This ConnectionServer factory class provides methods to create objects implementing Connection, BIPLink and UICCTransportLink. or SCP81Connction.
    Any object instanciated by the ConnectionServer is a Permanent Entry Point Object.

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static byte CAT_TP
      Indicating the usage of CAT_TP as transport protocol: 0

    • Field Detail

      • CAT_TP

        public static final byte CAT_TP
        Indicating the usage of CAT_TP as transport protocol: 0
        See Also:
        Constant Field Values

    • Method Detail

      • getConnection

        public static Connection getConnection()
        Returns an instance providing a data link connection. This instance has to be configured by providing connection parameters before usage. The returned object is a Permanent Entry Point Object. Connection objects created by this methods implictly does not allow multiplexing.
        Returns:
        Connection instance or null if the connection resources are exceeded

      • getConnection

        public static Connection getConnection​(byte[] baConnectionParameters,
                                       short sOffset,
                                       short sLength,
                                       boolean multiplexingAllowed)
                                throws java.lang.ArrayIndexOutOfBoundsException,
                                       java.lang.NullPointerException
        Returns an instance providing a data link connection. This instance is configured according to the provided connection parameters. The returned object is a Permanent Entry Point Object.
        Parameters:
        baConnectionParameters - the parameters to build up an OPEN CHANNEL command according to ETSI TS 102 223
        sOffset - the offset to the parameters in the byte array
        sLength - the length of the parameters
        multiplexingAllowed - if true, indicates whether an already existing Connection with the same parameters can be returned, or if the newly created Connection object can be re-used by another entity. If false, an new Connection object is created.
        Returns:
        a Connection instance or null if the connection resources are exceeded
        Throws:
        java.lang.NullPointerException - if baConnectionParameters is equal to null
        java.lang.ArrayIndexOutOfBoundsException - if sOffset and sLength are causing access outside of baConnectionParameters array bounds

      • createUICCTransportLink

        public static UICCTransportLink createUICCTransportLink​(byte bLinkType,
                                                        Connection oConnection,
                                                        Observer oObserver)
                                                 throws java.lang.ArrayIndexOutOfBoundsException,
                                                        ConnectionException,
                                                        java.lang.NullPointerException
        Returns an instance providing a connection service which implements a reliable transport protocol. The returned object is a Permanent Entry Point Object.
        Parameters:
        bLinkType - the kind of reliable mechanism which shall be used for that link
        oConnection - the connection to create the reliable link on
        oObserver - the Observer to be used for notification about state changes
        Returns:
        a UICCTransportLink instance based on the delivered connection or null if the connection ressources are exceeded
        Throws:
        ConnectionException - with the following reason code:
        • TRANSPORT_PROTOCOL_NOT_SUPPORTEDif the requested transport protocol type bLinkType is not supported.
        • INVALID_PARAMETERS if oConnection is already in use and does not support multiplexing.
        • RESOURCE_NOT_AVAILABLE if there are not sufficient resources available (on the UICC or on the terminal).
        java.lang.NullPointerException - if oConnection or oObserver is equal to null
        java.lang.ArrayIndexOutOfBoundsException

      • createBIPLink

        public static BIPLink createBIPLink​(Connection oConnection,
                                    Observer oObserver)
                             throws ConnectionException,
                                    java.lang.NullPointerException
        Returns an instance providing a connection service without any additional reliable protocol. The returned object is a Permanent Entry Point Object.
        Parameters:
        oConnection - the connection to create the reliable link on
        oObserver - the Observer to be used for notification about state changes
        Returns:
        a BIPLink instance based on the delivered connection or null if the connection resources are exceeded
        Throws:
        ConnectionException - with the following reason code:
        • INVALID_PARAMETERS if oConnection is already in use or it supports multiplexing.
        • TRANSPORT_PROTOCOL_NOT_SUPPORTED if this type of connection is not supported
        java.lang.NullPointerException - if oConnection or oObserver is equal to null

      • createSCP81Connection

        public static SCP81Connection createSCP81Connection​(Observer oOserver)
                                             throws java.lang.NullPointerException,
                                                    ConnectionException
        Returns an instance providing an SCP81 connection. The returned object is a Permanent Entry Point Object.
        Parameters:
        oObserver - the Observer to be used for notifications about state changes
        Returns:
        a SCP81Connection instance.
        Throws:
        ConnectionException - with the following reason code:
        • TRANSPORT_PROTOCOL_NOT_SUPPORTED if this type of connection is not supported.
        java.lang.NullPointerException - ifoObserver is equal to null