|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface FileSystemCardService
Interface defining creational methods for file system based smartcards.
Creational methods are methods that support file creation, deletion, and
invalidation. These methods are extensions to the file access methods
specified in ISO 7816-4. A card service has to implement these methods
in order to support the corresponding methods in class CardFile.
For the CardFilePath arguments in the methods defined here, the
restrictions described in FileAccessCardService apply, too.
CardFile
,
FileAccessCardService
Field Summary |
---|
Fields inherited from interface opencard.opt.iso.fs.FileAccessCardService |
---|
READ_SEVERAL |
Method Summary | |
---|---|
void |
create(CardFilePath parent,
byte[] data)
Creates a file on the smartcard. |
void |
delete(CardFilePath file)
Deletes a file on the smartcard. |
void |
invalidate(CardFilePath file)
Invalidates a file on the smartcard. |
void |
rehabilitate(CardFilePath file)
Rehabilitates a file on the smartcard. |
Methods inherited from interface opencard.opt.iso.fs.FileAccessCardService |
---|
appendRecord, exists, getFileInfo, getRoot, read, readRecord, readRecords, write, write, writeRecord |
Methods inherited from interface opencard.opt.service.CardServiceInterface |
---|
getCard, setCHVDialog |
Methods inherited from interface opencard.opt.security.SecureService |
---|
provideCredentials |
Method Detail |
---|
void create(CardFilePath parent, byte[] data) throws CardServiceException, CardTerminalException
This method is intended to be used in a scenario where new applications have to be downloaded on a smartcard. Typically, a server will be contacted to retrieve the information about the directories and files that have to be created. This server can be supplied with the card's ATR, which is encapsulated by class CardID. The server will then be able to send parameter blocks that are appropriate arguments for this method and the respective card.
parent
- the path to the directory in which to create a new filedata
- the parameters specifying the file to create.
This argument is card-specific. Refer to the documentation
of the card-specific service for details.
CardServiceException
- if the service encountered an error
CardTerminalException
- if the terminal encountered an errorFileAccessCardService.getFileInfo(opencard.opt.iso.fs.CardFilePath)
,
CardFileInfo.getHeader()
,
CardID
,
SmartCard.getCardID()
void delete(CardFilePath file) throws CardServiceException, CardTerminalException
file
- the path to the file to delete
CardServiceException
- if the service encountered an error
CardTerminalException
- if the terminal encountered an errorvoid invalidate(CardFilePath file) throws CardServiceInabilityException, CardServiceException, CardTerminalException
This method should not be implemented by setting all access conditions of the file to NEVER. Files with access condition NEVER are often used for internal purposes, for example to hold keys or application specific executable code. Invalidating a file should make the card OS ignore the file's contents.
file
- the path to the file to invalidate
CardServiceInabilityException
- if the service does not support this operation
CardServiceException
- if the service encountered an error
CardTerminalException
- if the terminal encountered an errorvoid rehabilitate(CardFilePath file) throws CardServiceInabilityException, CardServiceException, CardTerminalException
file
- the path to the file to rehabilitate
CardServiceInabilityException
- if the service does not support this operation
CardServiceException
- if the service encountered an error
CardTerminalException
- if the terminal encountered an error
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |