Contactless Communication API - Oracle Software Delivery Cloud

More documents

Recommendations

Info

Package javax.microedition.contactless.ndefNDEFTagConnectionwriteNDEF( NDEFMessage )ParametersThrowspublic void writeNDEF( NDEFMessage message) throwsjavax.microedition.contactless.ContactlessException, java.io.IOExceptionWrites NFC Forum formatted data in the NDEF message to the target. This method overwrites all the existing data on thetarget and it blocks until writing is completed or the connection to target is lost.Writing data to the target may fail for various reasons. The API implementation must read the newly written data rightafter the write operation and make sure that all data was written correctly to the target. Returning from this method mustmean that writing was successful. If writing failed an IOException is thrown.message - NDEF message to be written to the targetContactlessException - if NFC Forum formatting is not supported by the targetjava.lang.NullPointerException - if message is nulljava.lang.IllegalArgumentException - if message does not contain any NDEF recordsjava.lang.IllegalStateException - if other write operation is ongoingjava.io.IOException - if writing data to the target failed, connection to the target is lost or it has been closedjava.lang.SecurityException - if the application does not have permission to write to a targetjavax.microedition.contactless.ContactlessException43
Package javax.microedition.contactless.rfProvides interfaces for physical RF targets.Interface summaryPlainTagConnectionThis interface defines the basic mechanism to communicate with the different RFIDtags that contain non-NFC Forum formatted data.Package DocumentationProvides interfaces for physical RF targets.This package defines a high level interface for accessing the most common contactless RF targets. These interfaces providea physical level access to the targets.Features of different contactless targets vary a lot. It would be impossible for this API to support all these features. ThisAPI provides a high level interface to access RFID_TAG targets. PlainTagConnection can be used with physical RFID targetsthat do not support NDEF and do not have target-specific interface defined by the API implementation. This still requiresthat the API implementation supports handling of that physical target type. Since PlainTagConnection interface mightbe inconvenient to use, it should be extended with target-specific connection interfaces to enable the efficient use of thefeatures of the target.The following example shows how to open a PlainTagConnection to the discovered target.import java.io.IOException;import javax.microedition.contactless.*;import javax.microedition.contactless.rf.PlainTagConnection;import javax.microedition.io.Connector;// Example class of how to use PlainTagConnection of// JSR 257 Contactless Communication APIpublic class CCAPIExample implements TargetListener {private DiscoveryManager dm;public CCAPIExample() {registerTargetToDiscovery();}public void registerTargetToDiscovery() {// Register RFID_TAG target to discovery}public void targetDetected(TargetProperties[] prop) {// Select first found targetTargetProperties target = prop[0];try {Class[] connNames = target.getConnectionNames();String url = target.getUrl(connNames[0]);if (connNames[0].equals(Class.forName("javax.microedition.contactless.rf.PlainPlainTagConnection"))) {String mapping = target.getMapping();PlainTagConnection conn =(PlainTagConnection)Connector.open(url);// Construct input vector based on the mapping// and begin communication}}catch (ClassNotFoundException e) {// handle exception}44
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 33 and 34: NDEFMessageNDEFMessage — class in
Page 43 and 44: NDEFRecordTypeNDEFRecordType — cl
Page 47: 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

Contactless Communication API - Oracle Software Delivery Cloud

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

Delete template?

Save as template?