6.2.11 Class ToolkitException

3GPP51.013Release 17Test specification for Subscriber Identity Module (SIM) Application Programming Interface (API) for Java CardTS

6.2.11.1 Exception Constants

Test Area Reference: API_2_TKE_CONS

6.2.11.1.1 Conformance requirement:

There is no API, only constants.

6.2.11.1.1.1 Normal execution

  • CRRN1: The Constants of the class ToolkitException shall all have the same name and value defined in the 3GPP TS 43.019 [7].

6.2.11.1.1.2 Parameters error

No requirements.

6.2.11.1.1.3 Context errors

No requirements.

6.2.11.1.2 Test suite files

None.

6.2.11.1.3 Test procedure

The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be performed.

6.2.11.2 Constructor ToolkitException

Test Area Reference: API_2_TKE_COORS

6.2.11.2.1 Conformance requirement:

The constructor with following headershall compliant to its definition in the API.

public ToolkitException(short reason)

6.2.11.2.1.1 Normal execution

  • CRRN1: Construct a ToolkitException instance with the specified reason.

6.2.11.2.1.2 Parameters error

No requirements.

6.2.11.2.1.3 Context errors

No requirements.

6.2.11.2.2 Test suite files

No additional requirements for the GSM personalization:

Test Script: API_2_TKE_COORS_1.scr

Test Applet: API_2_TKE_COORS_1.java

Load Script: API_2_TKE_COORS_1.ldr

Cleanup script: API_2_TKE_COORS_1.clr

Parameter File: API_2_TKE_COORS_1.par

6.2.11.2.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

reason = (short) 19

ToolkitException.getReason() = (short)19

6.2.11.2.4 Test Coverage

CRR number

Test case number

N1

1

6.2.11.3 Method throwIt

Test Area Reference: API_2_TKE_THITS

6.2.11.3.1 Conformance requirement:

The method with following header shall compliant to its definition in the API.

public static void throwIt(short reason)

throws ToolkitException

6.2.11.3.1.1 Normal execution

  • CRRN1: Throws the JCRE instance of the ToolkitException class with the specified reason.
  • CRRN2: extends javacard.framework.CardRuntimeException

6.2.11.3.1.2 Parameters error

No requirements.

6.2.11.3.1.3 Context errors

No requirements.

6.2.11.3.2 Test suite files

No additional requirements for the GSM personalization:

Test Script: API_2_TKE_THITS_1.scr

Test Applet: API_2_TKE_THITS_1.java

Load Script: API_2_TKE_THITS_1.ldr

Cleanup Script: API_2_TKE_THITS_1.clr

Parameter File: API_2_TKE_THITS_1.par

6.2.11.3.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

Throws the JCRE instance of ToolkitException with the specified reason

Reason = 0

2

Throws the JCRE instance of ToolkitException with the specified reason

Reason = 1

3

Throws the JCRE instance of ToolkitException with the specified reason

Reason = 15

4

ToolkitException extends javacard.framework.CardRuntimeException

Reason = 0

5

ToolkitException extends javacard.framework.CardRuntimeException

Reason = 1

6

ToolkitException extends javacard.framework.CardRuntimeException

Reason = 15

6.2.11.3.4 Test Coverage

CRR number

Test case number

N1

1, 2, 3

N2

4, 5, 6