org.globalplatform
Interface Personalization

All Superinterfaces:
javacard.framework.Shareable

public interface Personalization
extends javacard.framework.Shareable

This interface defines a method through which an Application may forward input data to another Application and retrieve output data from that Application.

This interface shall be implemented by an Application that wishes to receive personalization data forwarded by its associated Security Domain and request outputting response data. In such a scenario, if the Application implements both the Application and the Personalization interface, then the Security Domain shall use the Personalization interface.

Since:
export file version 1.2
See Also:
Application

Method Summary
 short processData(byte[] inBuffer, short inOffset, short inLength, byte[] outBuffer, short outOffset)
          Processes application specific data received from another on-card entity.
 

Method Detail

processData

short processData(byte[] inBuffer,
                  short inOffset,
                  short inLength,
                  byte[] outBuffer,
                  short outOffset)
Processes application specific data received from another on-card entity.

If the Application invoking this method is a Security Domain then it shall be assumed that:

Notes:

Parameters:
inBuffer - byte array containing input data. Must be a global byte array.
inOffset - offset of input data within inBuffer.
inLength - length of input data.
outBuffer - byte array where output data shall be written. Must be a global byte array.
outOffset - offset where output data shall be written within inBuffer.
Returns:
the number of bytes written to outBuffer.
Throws:
java.lang.SecurityException - if inBuffer or outBuffer is not a global byte array.
java.lang.NullPointerException - if inBuffer or outBuffer is null.
java.lang.ArrayIndexOutOfBoundsException - if reading intput data or writing output data would cause access of data outside array bounds.


Copyright © 2003-2014 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.