Contactless Communication API - Oracle Software Delivery Cloud

More documents

Recommendations

Info

Package javax.microedition.contactlessProvides functionality common to all contactless targets.Interface summaryTagConnectionTargetListenerTargetPropertiesTransactionListenerClass summaryDiscoveryManagerTargetTypeException summaryContactlessExceptionThis is a marker interface for all RFID tag and smart card related connections in theContactless Communication API .The TargetListener provides a mechanism for the application to be notified, whencontactless targets are discovered by the device hardware.This interface collects the properties that are common for all contactless targetssupported by this specification.This interface provides a notification to the application about secure element activityin card emulation mode.The DiscoveryManager class offers the mechanism to discover targets for contactlesscommunication.This class collects the contactless target types supported by the ContactlessCommunication API .This ContactlessException is thrown when an unsupported operation is attempted.Package DocumentationProvides functionality common to all contactless targets.Discovering contactless targets is the starting point of this API. Once a target is discovered, an application can communicatewith it. This package contains the contactless target discovery. It provides a mechanism to request notification abouttargets appearing to the proximity of the device. The following diagram gives an overview to the target discovery and tothe whole structure of the Contactless Communication API . It also shows the relationships between different packages inthis API.7
Package javax.microedition.contactlessApplications can use classes and interfaces in this package to discover contactless targets. By getting an instance ofDiscoveryManager class, the application can register to receive notifications about contactless targets appearing into theproximity of the device. Based on the appearing targets, the application can use a target-specific connection defined inthe subpackages to communicate with the target. The URL needed to open the connection to the target is provided in theTargetProperties parameter in the notification. This target-specific connection can be for example ISO14443Connection, when external smart card is available. These target-specific connection objects contain methods to access and manipulatedata on the target.This API defines the basic connection interfaces to the most common targets. However the API implementation shouldprovide additional and more detailed target-specific connection interfaces to the physical targets it supports.Connections to different contactless targets are designed on top of Generic Connection Framework (GCF). Each differenttarget type defines a new protocol to the GCF. However only one of these protocols is visible in this specification and therest are left to the API implementation. The visual tag related protocol is visible and all the RFID related protocols arehidden. The reason to hide the protocols is the nature of RFID communication. It is impossible to know what kind of targetappears to the proximity of the device and therefore the URL needed to open a connection to the target is not revealedbeforehand to the application developer. Instead the URL is provided to the application in the notification about thediscovered target.An application does not have any means to control the time the target is available in the proximity of the device. It can beseveral seconds or just a touch to the target. Since the communication with the contactless targets should happen infraction of a second, applications should take this into consideration in the design phase and try to perform connectionrelated operations accordingly.The following code example illustrates how the contactless targets can be discovered. The examples later in this specificationsupplement this example.import java.io.IOException;import javax.microedition.contactless.*;import javax.microedition.contactless.ndef.*;import javax.microedition.io.Connector;8
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: API Reference
Page 15 and 16: ContactlessExceptionInheritanceCont
Page 17 and 18: Package javax.microedition.contactl
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 and 48: NDEFTagConnectionNDEFTagConnection
Page 51 and 52: PlainTagConnectionPlainTagConnectio
Page 59 and 60: ImagePropertiesImageProperties —
Page 63 and 64:
Package javax.microedition.contactl
Page 65 and 66:
SymbologyManagerSymbologyManager
Page 67 and 68:
VisualTagCodingExceptionInheritance
Page 69 and 70:
Package javax.microedition.contactl
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?