proposed changes for the TEC meeting December 2025 (4534f3cf) · Commits · SET - Secure Elements Technologies / TS 102 267 Connection Oriented Service API

src/uicc/connection/ConnectionException.java

+3 −0

Original line number	Original line	Diff line number	Diff line
	@@ -48,6 +48,9 @@ public class ConnectionException extends CardRuntimeException
	/** Reason code to indicate that invalid header fields set by application */		/** Reason code to indicate that invalid header fields set by application */
	public final static short INVALID_HEADER_FIELD = (short) 12;		public final static short INVALID_HEADER_FIELD = (short) 12;

			/** Reason code to indicate that no SCP82 key could be found to establish the DTLS session: 13 */
			public final static short SCP82_KEY_NOT_FOUND = (short) 13;

	/**		/**
	* Construct a ConnectionException instance with the specified reason. To		* Construct a ConnectionException instance with the specified reason. To
	* conserve on resources use <code>throwIt()</code> method to re-use the		* conserve on resources use <code>throwIt()</code> method to re-use the

src/uicc/connection/ConnectionServer.java

+19 −1

Original line number	Original line	Diff line number	Diff line
	@@ -122,6 +122,7 @@ public class ConnectionServer
	* Returns an instance providing an SCP81 connection.		* Returns an instance providing an SCP81 connection.
	* The returned object is a Permanent Entry Point Object.		* The returned object is a Permanent Entry Point Object.
	*		*
			* @deprecated
	* @param oObserver the Observer to be used for notifications about state changes		* @param oObserver the Observer to be used for notifications about state changes
	* @return a <code>SCP81Connection</code> instance.		* @return a <code>SCP81Connection</code> instance.
	* @throws ConnectionException with the following reason code:		* @throws ConnectionException with the following reason code:
	@@ -130,7 +131,24 @@ public class ConnectionServer
	* </ul>		* </ul>
	* @throws NullPointerException if<code>oObserver</code> is equal to <code>null</code>		* @throws NullPointerException if<code>oObserver</code> is equal to <code>null</code>
	*/		*/
	public static SCP81Connection createSCP81Connection(Observer oOserver) throws NullPointerException,ConnectionException		public static SCP81Connection createSCP81Connection(Observer oObserver) throws NullPointerException,ConnectionException
			{
			return null;
			}

			/**
			* Returns an instance providing an SCP8X connection.
			* The returned object is a Permanent Entry Point Object.
			*
			* @param oObserver the Observer to be used for notifications about state changes
			* @return a <code>SCP8XConnection</code> instance.
			* @throws ConnectionException with the following reason code:
			* <ul>
			* <li><code>TRANSPORT_PROTOCOL_NOT_SUPPORTED</code> if this type of connection is not supported. </li>
			* </ul>
			* @throws NullPointerException if<code>oObserver</code> is equal to <code>null</code>
			*/
			public static SCP8XConnection createSCP8XConnection(Observer oObserver) throws NullPointerException,ConnectionException
	{		{
	return null;		return null;
	}		}

src/uicc/connection/DataReceived.java

+3 −1

Original line number	Original line	Diff line number	Diff line
	@@ -13,12 +13,14 @@ public interface DataReceived extends Event
	/**		/**
	* Returns the amount of data received, or -1 if data length is unknown (chunked transfer encoding is used),		* Returns the amount of data received, or -1 if data length is unknown (chunked transfer encoding is used),
	* or 0 if all received data have been read or discarded by the <code>Observer</code>.		* or 0 if all received data have been read or discarded by the <code>Observer</code>.
			*
			* @return data length received or 0 if all data have been received or -1 if data length is unknown
	*/		*/
	public int getReceivedDataLength();		public int getReceivedDataLength();

	/**		/**
	* Copy the received data in a buffer. Data are handled as a stream, and are received upon applet request.		* Copy the received data in a buffer. Data are handled as a stream, and are received upon applet request.
	* It is not possible to move backward in the data by using the <code>srcOffset>/code> parameter.		* It is not possible to move backward in the data by using the <code>srcOffset</code> parameter.
	* This is a non-blocking methid.		* This is a non-blocking methid.
	*		*
	* @param srcOffset the offset of the first byte to copy in the received data		* @param srcOffset the offset of the first byte to copy in the received data

src/uicc/connection/SCP81Connection.java

+2 −3

Original line number	Original line	Diff line number	Diff line
	@@ -22,12 +22,11 @@ public interface SCP81Connection extends Observable {
	*		*
	* Note:		* Note:
	* <ul>		* <ul>
	* <li><em>On invocation of this method, the Security Domain shall register this request.		* <li><em>On invocation of this method, the Security Domain shall register this request.</em>
	* Once resources are available, the RTE/OPEN tries to open the connection, manage		* 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 underlying protocol layers and performs the TLS handshake. The observer is then notified with
	* the </em><code>SCP81ConnectionStatus</code><em> event.		* the <code>SCP81ConnectionStatus</code> event.
	* </ul>		* </ul>
	* <p>
	*		*
	* @param triggeringParameters this buffer contains the administration session triggering parameters		* @param 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		* as defined in table 4-3 of Amendment B of Global Platform Card Specification version 2.2. Tag '81' and

src/uicc/connection/SCP81ConnectionStatus.java

+1 −1

Original line number	Original line	Diff line number	Diff line
	@@ -10,7 +10,7 @@ package uicc.connection;
	* server switch to other application (corresponds to server selecting another application via Content-Type header field)		* server switch to other application (corresponds to server selecting another application via Content-Type header field)
	* The object implementing <code>SCP81ConnectionStatus</code> interface is a <b>Temporary Entry Point Object</b>.		* The object implementing <code>SCP81ConnectionStatus</code> interface is a <b>Temporary Entry Point Object</b>.
	*		*
	* * @deprecated This interface is obsolte use SCP8XConnectionStatus instead		* * @deprecated This interface os obsolte use SCP8XConnection instead
	*/		*/
	@Deprecated		@Deprecated
	public interface SCP81ConnectionStatus extends Event		public interface SCP81ConnectionStatus extends Event