|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavacard.framework.AID
@TransactionType(value=NOT_SUPPORTED) public class AID
This class encapsulates the Application Identifier (AID) associated with an applet. An AID is defined in ISO 7816-5 to be a sequence of bytes between 5 and 16 bytes in length.
The Java Card runtime environment creates instances of AID
class to identify and manage every applet on the card. Applets need not
create instances of this class. An applet may request and use the Java Card
runtime environment-owned instances to identify itself and other applet
instances.
Java Card runtime environment-owned instances of AID
are
permanent Java Card runtime environment Entry Point Objects and can be
accessed from any applet context. References to these permanent objects can
be stored and re-used.
An applet instance can obtain a reference to Java Card runtime
environment-owned instances of its own AID
object by using the
JCSystem.getAID()
method and another applet's AID
object via the JCSystem.lookupAID()
method.
An applet uses AID
instances to request to share another
applet's object or to control access to its own shared object from another
applet. See
Runtime Environment Specification, Java Card Platform, Connected Edition,
chapter 6 for details.
JCSystem
,
SystemException
Constructor Summary | |
---|---|
AID(byte[] bArray,
short offset,
byte length)
The Java Card runtime environment uses this constructor to create a new AID instance encapsulating the specified AID bytes. |
Method Summary | |
---|---|
boolean |
equals(byte[] bArray,
short offset,
byte length)
Checks if the specified AID bytes in bArray are the same
as those encapsulated in this AID object. |
boolean |
equals(Object anObject)
Compares the AID bytes in this AID instance
to the AID bytes in the specified object. |
byte |
getBytes(byte[] dest,
short offset)
Called to get all the AID bytes encapsulated within AID
object. |
byte |
getPartialBytes(short aidOffset,
byte[] dest,
short oOffset,
byte oLength)
Called to get part of the AID bytes encapsulated within the AID object starting at the specified offset for the
specified length. |
int |
hashCode()
Returns a hash code value for the object. |
boolean |
partialEquals(byte[] bArray,
short offset,
byte length)
Checks if the specified partial AID byte sequence matches the first length bytes of the encapsulated AID bytes within
this AID object. |
boolean |
RIDEquals(AID otherAID)
Checks if the RID (National Registered Application provider identifier) portion of the encapsulated AID bytes within the otherAID
object matches that of this AID object. |
Methods inherited from class java.lang.Object |
---|
getClass, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public AID(byte[] bArray, short offset, byte length) throws SystemException, NullPointerException, ArrayIndexOutOfBoundsException, SecurityException
AID
instance encapsulating the specified AID bytes.
bArray
- the byte array containing the AID bytesoffset
- the start of AID bytes in bArraylength
- the length of the AID bytes in bArray
SecurityException
- if the bArray
array is not accessible in
the caller's context
SystemException
- with the following reason code:
SystemException.ILLEGAL_VALUE
if the
length
parameter is less than
5
or greater than 16
NullPointerException
- if the bArray
parameter is null
ArrayIndexOutOfBoundsException
- if the offset
parameter or length
parameter is negative or if offset+length
is
greater than the length of the bArray
parameterMethod Detail |
---|
public final byte getBytes(byte[] dest, short offset) throws NullPointerException, ArrayIndexOutOfBoundsException, SecurityException
AID
object.
dest
- byte array to copy the AID bytesoffset
- within dest where the AID bytes begin
SecurityException
- if the dest
array is not accessible in the
caller's context
NullPointerException
- if the dest
parameter is null
ArrayIndexOutOfBoundsException
- if the offset
parameter is negative or
offset+
length of AID bytes is greater than
the length of the dest
arraypublic final boolean equals(Object anObject) throws SecurityException
this
AID
instance
to the AID bytes in the specified object. The result is true
if and only if the argument is not null
and is an
AID
object that encapsulates the same AID bytes as
this
object.
This method does not throw NullPointerException
.
equals
in class Object
anObject
- the object to compare this
AID
against
true
if the AID byte values are equal,
false
otherwise
SecurityException
- if anObject
object is not accessible in the
caller's contextBoolean.hashCode()
,
Hashtable
public int hashCode()
Object
java.util.Hashtable
.
The general contract of hashCode
is:
hashCode
method on each of the
two objects must produce the same integer result.
Object.equals(java.lang.Object)
method, then calling the hashCode method on each of the two
objects must produce distinct integer results. However, the programmer
should be aware that producing distinct integer results for unequal
objects may improve the performance of hashtables.
As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (This is typically implemented by converting the internal address of the object into an integer, but this implementation technique is not required by the JavaTM programming language.)
hashCode
in class Object
Object.equals(java.lang.Object)
,
Hashtable
public final boolean equals(byte[] bArray, short offset, byte length) throws ArrayIndexOutOfBoundsException, SecurityException
bArray
are the same
as those encapsulated in this
AID
object.
The result is true
if and only if the bArray
argument is not null
and the AID bytes encapsulated in
this
AID
object are equal to the specified
AID bytes in bArray
.
This method does not throw NullPointerException
.
bArray
- containing the AID bytesoffset
- within bArray to beginlength
- of AID bytes in bArray
true
if equal, false
otherwise
SecurityException
- if the bArray
array is not accessible in
the caller's context
ArrayIndexOutOfBoundsException
- if the offset
parameter or length
parameter is negative or if offset+length
is
greater than the length of the bArray
parameterpublic final boolean partialEquals(byte[] bArray, short offset, byte length) throws ArrayIndexOutOfBoundsException, SecurityException
length
bytes of the encapsulated AID bytes within
this
AID
object. The result is
true
if and only if the bArray
argument is
not null
and the input length
is less than
or equal to the length of the encapsulated AID bytes within
this
AID
object and the specified bytes
match.
This method does not throw NullPointerException
.
bArray
- containing the partial AID byte sequenceoffset
- within bArray to beginlength
- of partial AID bytes in bArray
true
if equal, false
otherwise
SecurityException
- if the bArray
array is not accessible in
the caller's context
ArrayIndexOutOfBoundsException
- if the offset
parameter or length
parameter is negative or if offset+length
is
greater than the length of the bArray
parameterpublic final boolean RIDEquals(AID otherAID) throws SecurityException
otherAID
object matches that of this
AID
object. The
first 5 bytes of an AID byte sequence is the RID. See ISO 7816-5 for
details. The result is true
if and only if the argument is
not null
and is an AID
object that
encapsulates the same RID bytes as this
object.
This method does not throw NullPointerException
.
otherAID
- the AID
to compare against
true
if the RID bytes match, false
otherwise
SecurityException
- if the otherAID
object is not accessible in
the caller's contextpublic final byte getPartialBytes(short aidOffset, byte[] dest, short oOffset, byte oLength) throws NullPointerException, ArrayIndexOutOfBoundsException, SecurityException
AID
object starting at the specified offset for the
specified length.
aidOffset
- offset within AID array to begin copying bytesdest
- the destination byte array to copy the AID bytes intooOffset
- offset within dest where the output bytes beginoLength
- the length of bytes requested in dest
.
0
implies a request to copy all remaining AID
bytes.
dest
SecurityException
- if the dest
array is not accessible in the
caller's context
NullPointerException
- if the dest
parameter is null
ArrayIndexOutOfBoundsException
- if the aidOffset
parameter is negative or
greater than the length of the encapsulated AID bytes or the
oOffset
parameter is negative or
oOffset+length
of bytes requested is greater
than the length of the dest
array
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |