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 |