public interface BrokerListener
extends javacard.framework.Shareable
Modifier and Type | Field and Description |
---|---|
static byte |
SIO_BROKER_LISTENER
Constant used to retrieve an implementation of this interface from an Application (0xB0).
|
Modifier and Type | Method and Description |
---|---|
void |
initBrokerRequest(short request)
Initializes the processing of a Broker Request.
|
void |
onBrokerEvent(short event,
short info,
short environment,
short device,
short security,
short assurance,
short discretionary)
Notifies a Broker Event.
|
short |
processBrokerRequest(byte[] inBuffer,
short inOffset,
short inLength,
byte[] outBuffer,
short outOffset)
Finalizes the processing of a Broker Request.
|
void |
updateBrokerRequest(byte[] inBuffer,
short inOffset,
short inLength)
Accumulates the data of a Broker Request.
|
static final byte SIO_BROKER_LISTENER
This constant is a generic constant telling the Application that the
requested SIO (if available) shall be of type BrokerListener
.
Subtypes of BrokerListener
may define additional constants that
should be used instead to tell the Application that a specific subtype of
BrokerListener
is requested. If such constants are not used and the
Application implements several subtypes of BrokerListener
, the
Application may return null
or return an object of an incorrect
type (i.e. leading to a ClassCastException
or other errors).
JCSystem.getAppletShareableInterfaceObject(javacard.framework.AID, byte)
,
Constant Field Valuesvoid onBrokerEvent(short event, short info, short environment, short device, short security, short assurance, short discretionary)
event
- type of eventinfo
- additional information pertaining to the asset to which the notified event relatesenvironment
- information about the environment in which the event was generateddevice
- information about the device on which the event was generatedsecurity
- information about the security of the environment and
conditions under which the event was received by the Brokerassurance
- information about the environment in which the event was generateddiscretionary
- additional discretionary informationjavacard.framework.ISOException
- with a reason code indicating the type of error (if any)void initBrokerRequest(short request)
request
- type of requestjavacard.framework.ISOException
- with reason code '6A81' if the request is not
supported or unknown to the Application.void updateBrokerRequest(byte[] inBuffer, short inOffset, short inLength)
inBuffer
- byte array containing intermediary input datainOffset
- offset of intermediary input datainLength
- length of intermediary input datajavacard.framework.ISOException
- (ISO7816.SW_CONDITIONS_NOT_SATISFIED
) if
the initBrokerRequest(short)
method was not previously invoked, or if the
caller Application is not the same as the one that last invoked the initBrokerRequest(short)
.java.lang.NullPointerException
- if inBuffer
is null.java.lang.ArrayIndexOutOfBoundsException
- if inBuffer
would be accessed out of bounds.java.lang.SecurityException
- if inBuffer
cannot be read by the Application implementing this interface.initBrokerRequest(short)
,
JCSystem.getAID()
short processBrokerRequest(byte[] inBuffer, short inOffset, short inLength, byte[] outBuffer, short outOffset)
inBuffer
- byte array containing final input datainOffset
- offset of final input datainLength
- length of final input dataoutBuffer
- byte array where output data shall be written (if any)outOffset
- offset of output data (if any)javacard.framework.ISOException
- (ISO7816.SW_CONDITIONS_NOT_SATISFIED
) if
the initBrokerRequest(short)
method was not previously invoked, or if the
caller Application is not the same as the one that last invoked the initBrokerRequest(short)
.java.lang.NullPointerException
- if inBuffer
or outBuffer
is null.java.lang.ArrayIndexOutOfBoundsException
- if inBuffer
or outBuffer
would be accessed out of bounds.java.lang.SecurityException
- if inBuffer
cannot be read or
outBuffer
cannot be written by the Application implementing
this interface.initBrokerRequest(short)
,
updateBrokerRequest(byte[], short, short)
,
JCSystem.getAID()
Copyright © 2003-2019 GlobalPlatform, Inc. All rights reserved. The technology provided or described in this specification is subject to updates, revisions, and extensions by GlobalPlatform. Recipients of this document are invited to submit, with their comments, notification of any relevant patent rights or other intellectual property rights of which they may be aware which might be necessarily infringed by the implementation of the specification or other work product set forth in this document, and to provide supporting documentation.
THIS SPECIFICATION OR OTHER WORK PRODUCT IS BEING OFFERED WITHOUT ANY WARRANTY WHATSOEVER, AND IN PARTICULAR, ANY WARRANTY OF NON-INFRINGEMENT IS EXPRESSLY DISCLAIMED. ANY IMPLEMENTATION OF THIS SPECIFICATION OR OTHER WORK PRODUCT SHALL BE MADE ENTIRELY AT THE IMPLEMENTER'S OWN RISK, AND NEITHER THE COMPANY, NOR ANY OF ITS MEMBERS OR SUBMITTERS, SHALL HAVE ANY LIABILITY WHATSOEVER TO ANY IMPLEMENTER OR THIRD PARTY FOR ANY DAMAGES OF ANY NATURE WHATSOEVER DIRECTLY OR INDIRECTLY ARISING FROM THE IMPLEMENTATION OF THIS SPECIFICATION OR OTHER WORK PRODUCT.