Contactless Communication API - Oracle Software Delivery Cloud

More documents

Recommendations

Info

NDEFRecordNDEFRecord — class in package javax.microedition.contactless.ndefpublic class NDEFRecord extends java.lang.ObjectConstructor summaryNDEFRecord(NDEFRecordType recordType,byte[] id,byte[] payload)NDEFRecord(byte[] data,int offset)Method summaryvoidbyte[]NDEFMessagebyte[]longNDEFRecordTypevoidbyte[]appendPayload(byte[] payload)getId()getNestedNDEFMessage(int offset)getPayload()getPayloadLength()getRecordType()setId(byte[] id)toByteArray()InheritanceDescriptionjava.lang.Object → NDEFRecordMethods inherited from class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitThis class represents an NDEF record. An NDEF record consists of type, type format, identifier for the payload and the actualpayload in a byte array. This class is an abstraction of the NDEF record defined by the NFC Forum NDEF specification and ithides some of the fields defined in that specification and leaves them to the API implementation. NDEF record may containsubrecords. Nested records can be accessed by getting the record payload and then parsing that payload into new NDEFrecords.A record type gives an identity to the payload in the record. Based on the record type information the application knowsthe meaning of the record payload. This information is used to guide the processing of the payload, like for example inthe application start as described in the appendix B. The type of the first NDEF record inside NDEF message, by convention,should provide the processing context not only for the first record but for the whole NDEF message.The NDEF record also contains an optional identifier for the payload. This identifier may be used to refer to the payload inother records. The value of the ID field is an identifier in the form of a URI RFC (3986). This class provides methods forgetting and setting this identifier. Character encoding used in identifier field must be UTF-8.The chunking feature defined in the NDEF specification must be handled below the Java API level. Only complete NDEFrecords are provided to the Java application. This means that the device implementing this API should have enough memoryto handle complete NDEF records.33
Package javax.microedition.contactless.ndefNDEFRecordConstructorsNDEFRecord( NDEFRecordType , byte[], byte[])public NDEFRecord ( NDEFRecordTyperecordType, byte[] id, byte[] payload)ParametersThrowsCreates a new NDEFRecord with specified record type, identifier and payload. The constructor implementation mustmake a copy from the original identifier and payload.Record identifier is given in the URL format and it may be null . In this case it must be omitted from the NDEF record.Payload of the NDEF record may be null or a zero-length array. Both these cases mean that payload must be omittedfrom the NDEF record.If record type format is NDEFRecordType.EMPTY the identifier and the payload must be omitted from the NDEF record.recordType - record type of the NDEF recordid - payload identifierpayload - payload of the record as byte arrayjava.lang.NullPointerException - if recordType is nullNDEFRecord(byte[], int)ParametersThrowsMethodspublic NDEFRecord (byte[] data, int offset)Formulates a new NDEF record from the given byte array starting from the specified index. The byte array should containthe record type name, type format, identifier, length and the payload of the record. The offset must be a value greaterthan or equal to 0 and less than the length of the payload byte array.data - the byte array containing the NDEF recordoffset - start index of the NDEF record data in the payload byte arrayjava.lang.NullPointerException - if data is nulljava.lang.ArrayIndexOutOfBoundsException - if the offset is invalidjava.lang.IllegalArgumentException - if the data cannot be formulated to NDEF recordappendPayload(byte[])ParametersThrowspublic void appendPayload(byte[] payload)This method appends payload into the end of the NDEF record payload. If payload is an empty array or null , this methodreturns without any additions to the existing payload. If the record type format is EMPTY , the payload must be omittedfrom the NDEF record and using this method causes an IllegalArgumentException to the thrown.payload - payload to be addedjava.lang.IllegalArgumentException - if record type format is EMPTY and this method is called34
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 37: Package javax.microedition.contactl
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?