|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.sun.javacard.spi.cardmgmt.Application
@TransactionType(value=NOT_SUPPORTED) public class Application
Application object encapsulate the runtime characteristics of an application instance.
An application instance is assigned and registered at creation time with a unique application URI.
Applications instances are bound to the group context of their application group.
Application objects are permanent Java Card runtime environment Entry Point Objects.
Some operations on application instances are subject to permission checks.
ApplicationGroup
,
Event
,
CardManagementPermission
,
JCREPermission
Field Summary | |
---|---|
protected String |
appURI
This application instance URI. |
Constructor Summary | |
---|---|
protected |
Application(ApplicationGroup applicationGroup,
String moduleName,
String appURI)
Creates and registers a new application instance with the provided application URI. |
Method Summary | |
---|---|
boolean |
delete()
Attempts to unregister and delete this application instance. |
static boolean |
delete(Application[] applications)
Attempts to unregister and delete atomically a set of inter-dependent application instances. |
ApplicationGroup |
getApplicationGroup()
Returns this applications instance's application group. |
String |
getAppURI()
Returns this applications instance's application URI. |
String |
getModuleName()
Returns this application instance's module name. |
byte |
getType()
Returns this applications instance's application type. |
static Application |
lookup(String appURI)
Looks up an application instance using its assigned URI. |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected String appURI
Constructor Detail |
---|
protected Application(ApplicationGroup applicationGroup, String moduleName, String appURI)
After creating and registering an application instance, all applications
which registered for such event (event:///standard/app/created
)
are notified.
applicationGroup
- the application groupmoduleName
- the module nameappURI
- the application URI this application instance will be
registered with.
IllegalArgumentException
- appURI
is not a well-formed
application URI.appURI
was already assigned or
overlaps or is overlapped by an already assigned application
URI.appURI
is illegal - that is: it is in
the platform or standard namespace.NullPointerException
- applicationGroup
is null.moduleName
is null.appURI
is null.Event
Method Detail |
---|
public static Application lookup(String appURI)
appURI
- the application URI to be looked up
public static boolean delete(Application[] applications)
Before attempting to delete each application instance in the set, any
other application which registered for such event (event:///standard/app/deleting
)
is notified.
After successfully deleting all application instances in the set, any
application which registered for such event (event:///standard/app/deleted
)
is notified.
Any failed attempt must roll back any partially completed deletion steps.
applications
- the set of application instances to be deleted.
NullPointerException
- if applications
is null.
SecurityException
- if deleting an application instance is not granted.Event
public boolean delete()
Before attempting to delete an application instance, any application
which registered for such event (event:///standard/app/deleting
)
is notified.
After successfully deleting an application instance, any application
which registered for such event (event:///standard/app/deleted
)
is notified.
SecurityException
- if deleting an application instance is not granted.Event
public final ApplicationGroup getApplicationGroup()
public final String getAppURI()
public String getModuleName()
public final byte getType()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |