Pr22

Class ECard

java.lang.Object

Pr22.ECard

public class ECard
extends java.lang.Object

Electronically readable card (Smart Card, RFID card or Magnetic stripe card).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ECard.Information Class for storing information on an ECard.

Field Summary

Fields

Modifier and Type	Field and Description
java.lang.String	Serial Serial number of the card.

Method Summary

Modifier and Type	Method and Description
void	authenticate(AuthProcess authentication, BinData additionalData, int selector) Executes an authentication process.
boolean	checkHash(File fileId) Checks the integrity of a file.
boolean	checkHash(FileId fileId) Checks the integrity of a file.
File	convertFileId(File file) Converts file identifier values: general IDs to data group number and vice versa.
void	disconnect() Finishes usage of the ECard.
java.util.ArrayList<Application>	getApplications() Returns a list of available ECard applications.
BinData	getAuthReferenceData() Returns data necessary for the next authentication process.
Document	getAuthResult() Returns the ECard authentication results in document form.
Certificates	getCertificateManager() Returns the certificate manager that stores certificates for the current ECard only.
BinData	getFile(File fileId) Returns the data of a file.
BinData	getFile(FileId fileId) Returns the data of a file.
java.util.ArrayList<File>	getFiles() Returns a list of identifiers of the available files.
ECard.Information	getInfo() Returns the card information.
AuthProcess	getNextAuthentication(boolean forceNext) Returns the identifier of the next suggested authentication to proceed.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

Serial

public final java.lang.String Serial

Serial number of the card. In numerous cases, the serial number is random. In some other cases, cards have no serial at all. For such cards, the system generates a fictional number.

Method Detail

getAuthReferenceData

public BinData getAuthReferenceData()

Returns data necessary for the next authentication process.

Returns:

Authentication data.

getInfo

public ECard.Information getInfo()
                          throws General

Returns the card information.

Returns:

The card information.

Throws:

General

disconnect

public void disconnect()
                throws General

Finishes usage of the ECard.

Throws:

General

getApplications

public java.util.ArrayList<Application> getApplications()
                                                 throws General

Returns a list of available ECard applications. When the list is empty or contains only Application.None that means that the list cannot be requested from the ECard, but the system tries to select application on card.

Returns:

The list of available ECard applications.

Throws:

General

getFiles

public java.util.ArrayList<File> getFiles()
                                   throws General

Returns a list of identifiers of the available files.

Returns:

The list of the available files.

Throws:

General

getFile

public BinData getFile(FileId fileId)
                throws General

Returns the data of a file.

Parameters:

fileId - File identifier.

Returns:

Binary data.

Throws:

General

getFile

public BinData getFile(File fileId)
                throws General

Returns the data of a file.

Parameters:

fileId - File identifier.

Returns:

Binary data.

Throws:

General

checkHash

public boolean checkHash(FileId fileId)
                  throws General

Checks the integrity of a file.

Parameters:

fileId - File identifier.

Returns:

Ok or failed.

Throws:

General

checkHash

public boolean checkHash(File fileId)
                  throws General

Checks the integrity of a file.

Parameters:

fileId - File identifier.

Returns:

Ok or failed.

Throws:

General

getNextAuthentication

public AuthProcess getNextAuthentication(boolean forceNext)
                                  throws General

Returns the identifier of the next suggested authentication to proceed.

Parameters:

forceNext - Skip the next authentication and return the one suggested after that.

Returns:

Authentication identifier.

Throws:

General

authenticate

public void authenticate(AuthProcess authentication,
                         BinData additionalData,
                         int selector)
                  throws General

Executes an authentication process. In some special cases, additional system information is necessary for computing additionalData. These pieces of information can be requested by the getAuthReferenceData() method.

Parameters:

authentication - Authentication identifier.

additionalData - Data needed for authentication.

selector - Selector parameter for certain authentications.

Throws:

General

getCertificateManager

public Certificates getCertificateManager()
                                   throws General

Returns the certificate manager that stores certificates for the current ECard only.

Returns:

The certificate manager.

Throws:

General

convertFileId

public File convertFileId(File file)
                   throws General

Converts file identifier values: general IDs to data group number and vice versa.

Parameters:

file - File Id to convert.

Returns:

Converted file Id.

Throws:

General

getAuthResult

public Document getAuthResult()
                       throws General

Returns the ECard authentication results in document form.

Returns:

ECard authentication results in Document form.

Throws:

General