Contactless Communication API - Oracle Software Delivery Cloud

More documents

Recommendations

Info

TransactionListenerTransactionListener — interface in package javax.microedition.contactlesspublic interface TransactionListenerField summarystatic byteUNKNOWN_SLOTMethod summaryvoidexternalReaderDetected(byte slot)DescriptionFieldsUNKNOWN_SLOTMethodsThis interface provides a notification to the application about secure element activity in card emulation mode. When anactivity has happened between the secure element on the device and an external reader device through the RFID hardware,this notification is sent to the application registered to receive it. Applications must implement this interface to receivethe notifications. Applications are not participating to these transactions.The application is responsible for any possible synchronization required in the listener methods. The listener methodsmust return quickly and should not perform any extensive processing. The method calls are intended as triggers for theapplication. The application should do all necessary extensive processing in a separate thread and only use these methodsto initiate the processing.public static final byte UNKNOWN_SLOTA constant to use when the slot number is not known.Value: -1externalReaderDetected(byte)Parameterspublic void externalReaderDetected(byte slot)Called by the platform, when a card emulation event has happened on the RFID hardware. This notification informs theapplication, that there might be changes in the data on the secure element.If the application displays for example the number of metro tickets left in the device, after receiving this notification theapplication can update the number of available tickets shown on the screen. How the number of tickets is acquired fromthe secure element is out of scope for this specification.slot - the slot needed to open the APDUConnection defined in JSR 177 to the internal secure element, may beUNKNOWN_SLOT constant defined in this interface, if the slot can not be identified25
Package javax.microedition.contactless.ndefProvides functionality to exchange NDEF formatted data with other contactless targets.Interface summaryNDEFRecordListenerNDEFTagConnectionClass summaryNDEFMessageNDEFRecordNDEFRecordTypeThe NDEFRecordListener provides a mechanism for the application to be notified,when NDEF records are discovered from the contactless targets.The NDEFTagConnection interface defines the basic functionality for exchanging NFCForum formatted data with RFID tags and contactless smart cards.This class represents an NDEF message.This class represents an NDEF record.This class encapsulates the type of an NDEF record.Package DocumentationProvides functionality to exchange NDEF formatted data with other contactless targets.The NFC Forum specifies a data packaging format to exchange information between an NFC device and another NFC deviceor a tag. The data formatting is based on NDEF records that contain type, type format, identifier and the actual data. ThisAPI takes advantage of this data formatting by providing a connection to any physical target that supports NDEF dataformatting defined by the NFC Forum. Using this data format, the application developer does not have to know the physicaltype of the target to exchange NDEF messages with it. This package provides means to generate and manipulate NDEFmessages and NDEF records.Applications can request a notification when the discovered target contains a specified NDEF record type. This is done bysetting an NDEFRecordListener with DiscoveryManager.addNDEFRecordListener method. When a target containing therequested NDEF record type is detected, a notification is sent to the registered application(s). The data from the target isprovided to the application(s) in the notification.This API supports the possibility to request application startup based on the data on the target appearing to the proximityof the device. The application startup is supported for the NDEF record types and for the secure element activity in cardemulation mode. For more information see Appendix B: Launching applications with MIDP 2.x PushRegistry .The following code example shows how to read data from an NDEF_TAG target.import java.io.IOException;import javax.microedition.contactless.*;import javax.microedition.contactless.ndef.*;import javax.microedition.io.Connector;// Example class of how to read data from NDEF_TAG target// using JSR 257 Contactless Communication API//public class CCAPIExample implements TargetListener {private NDEFTagConnection conn = null;public CCAPIExample() {registerTargetToDiscovery();}public void registerTargetToDiscovery() {// do the target discovery registration}public void targetDetected(TargetProperties[] prop) {// Select first found targetTargetProperties target = prop[0];26
Page 1 and 2: Contactless Communication APIJSR 25
Page 3 and 4: 2.2 You shall not be allowed to rem
Page 5 and 6: PrefaceThis specification was produ
Page 7 and 8: OverviewIntroductionGoalsThis speci
Page 9 and 10: Related documentation[CDC] Connecte
Page 11 and 12: API Reference
Page 13 and 14: Package javax.microedition.contactl
Page 15 and 16: ContactlessExceptionInheritanceCont
Page 23 and 24: TagConnectionInheritanceTagConnecti
Page 25 and 26: TargetPropertiesTargetProperties
Page 29: Package javax.microedition.contactl
Page 33 and 34: NDEFMessageNDEFMessage — class in
Page 43 and 44: NDEFRecordTypeNDEFRecordType — cl
Page 47 and 48: NDEFTagConnectionNDEFTagConnection
Page 51 and 52: PlainTagConnectionPlainTagConnectio
Page 59 and 60: ImagePropertiesImageProperties —
Page 65 and 66: SymbologyManagerSymbologyManager
Page 67 and 68: VisualTagCodingExceptionInheritance
Page 71 and 72: Appendix A. SecurityThis appendix d
Page 73 and 74: }* Creates a new ContactlessPermiss
Page 75 and 76: }/*** Returns the hash code value f
Page 77 and 78: import javax.microedition.io.GCFPer
Page 79 and 80: * @author Nokia Corporation* @versi
Page 81 and 82:
Appendix B. Launching applications
Page 83 and 84:
Appendix C. Unique identifiers of t
Page 85 and 86:
Appendix E. Examples of RFID commun
Page 87 and 88:
}if (target != null) {// do the com
Page 89 and 90:
equals, 40exchangeData, 50externalR
show all

Contactless Communication API - Oracle Software Delivery Cloud

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?