File	Doc	Category	Size	Date	Package
Tag.java	API Doc	Android 5.1 API	18708	Thu Mar 12 22:22:10 GMT 2015	android.nfc

Tag

• java.lang.Object

Fields Summary
final byte[]	mId
final int[]	mTechList
final String[]	mTechStringList
final android.os.Bundle[]	mTechExtras
final int	mServiceHandle
final INfcTag	mTagService
int	mConnectedTechnology
public static final Parcelable.Creator	CREATOR

Constructors Summary

public Tag(byte[] id, int[] techList, android.os.Bundle[] techListExtras, int serviceHandle, INfcTag tagService) Hidden constructor to be used by NFC service and internal classes. hide if (techList == null) { throw new IllegalArgumentException("rawTargets cannot be null"); } mId = id; mTechList = Arrays.copyOf(techList, techList.length); mTechStringList = generateTechStringList(techList); // Ensure mTechExtras is as long as mTechList mTechExtras = Arrays.copyOf(techListExtras, techList.length); mServiceHandle = serviceHandle; mTagService = tagService; mConnectedTechnology = -1;

Methods Summary
public static android.nfc.Tag	createMockTag(byte[] id, int[] techList, android.os.Bundle[] techListExtras) Construct a mock Tag. This is an application constructed tag, so NfcAdapter methods on this Tag may fail with {@link IllegalArgumentException} since it does not represent a physical Tag. This constructor might be useful for mock testing. param id The tag identifier, can be null param techList must not be null return freshly constructed tag hide // set serviceHandle to 0 and tagService to null to indicate mock tag return new Tag(id, techList, techListExtras, 0, null);
public int	describeContents() return 0;
private java.lang.String[]	generateTechStringList(int[] techList) final int size = techList.length; String[] strings = new String[size]; for (int i = 0; i < size; i++) { switch (techList[i]) { case TagTechnology.ISO_DEP: strings[i] = IsoDep.class.getName(); break; case TagTechnology.MIFARE_CLASSIC: strings[i] = MifareClassic.class.getName(); break; case TagTechnology.MIFARE_ULTRALIGHT: strings[i] = MifareUltralight.class.getName(); break; case TagTechnology.NDEF: strings[i] = Ndef.class.getName(); break; case TagTechnology.NDEF_FORMATABLE: strings[i] = NdefFormatable.class.getName(); break; case TagTechnology.NFC_A: strings[i] = NfcA.class.getName(); break; case TagTechnology.NFC_B: strings[i] = NfcB.class.getName(); break; case TagTechnology.NFC_F: strings[i] = NfcF.class.getName(); break; case TagTechnology.NFC_V: strings[i] = NfcV.class.getName(); break; case TagTechnology.NFC_BARCODE: strings[i] = NfcBarcode.class.getName(); break; default: throw new IllegalArgumentException("Unknown tech type " + techList[i]); } } return strings;
public int	getConnectedTechnology() For internal use only. hide return mConnectedTechnology;
public byte[]	getId() Get the Tag Identifier (if it has one). The tag identifier is a low level serial number, used for anti-collision and identification. Most tags have a stable unique identifier (UID), but some tags will generate a random ID every time they are discovered (RID), and there are some tags with no ID at all (the byte array will be zero-sized). The size and format of an ID is specific to the RF technology used by the tag. This function retrieves the ID as determined at discovery time, and does not perform any further RF communication or block. return ID as byte array, never null return mId;
public int	getServiceHandle() For use by NfcService only. hide return mServiceHandle;
public INfcTag	getTagService() hide return mTagService;
public int[]	getTechCodeList() For use by NfcService only. hide return mTechList;
static int[]	getTechCodesFromStrings(java.lang.String[] techStringList) if (techStringList == null) { throw new IllegalArgumentException("List cannot be null"); } int[] techIntList = new int[techStringList.length]; HashMap<String, Integer> stringToCodeMap = getTechStringToCodeMap(); for (int i = 0; i < techStringList.length; i++) { Integer code = stringToCodeMap.get(techStringList[i]); if (code == null) { throw new IllegalArgumentException("Unknown tech type " + techStringList[i]); } techIntList[i] = code.intValue(); } return techIntList;
public android.os.Bundle	getTechExtras(int tech) hide int pos = -1; for (int idx = 0; idx < mTechList.length; idx++) { if (mTechList[idx] == tech) { pos = idx; break; } } if (pos < 0) { return null; } return mTechExtras[pos];
public java.lang.String[]	getTechList() Get the technologies available in this tag, as fully qualified class names. A technology is an implementation of the {@link TagTechnology} interface, and can be instantiated by calling the static get(Tag) method on the implementation with this Tag. The {@link TagTechnology} object can then be used to perform advanced, technology-specific operations on a tag. Android defines a mandatory set of technologies that must be correctly enumerated by all Android NFC devices, and an optional set of proprietary technologies. See {@link TagTechnology} for more details. The ordering of the returned array is undefined and should not be relied upon. return an array of fully-qualified {@link TagTechnology} class-names. return mTechStringList;
private static java.util.HashMap	getTechStringToCodeMap() HashMap<String, Integer> techStringToCodeMap = new HashMap<String, Integer>(); techStringToCodeMap.put(IsoDep.class.getName(), TagTechnology.ISO_DEP); techStringToCodeMap.put(MifareClassic.class.getName(), TagTechnology.MIFARE_CLASSIC); techStringToCodeMap.put(MifareUltralight.class.getName(), TagTechnology.MIFARE_ULTRALIGHT); techStringToCodeMap.put(Ndef.class.getName(), TagTechnology.NDEF); techStringToCodeMap.put(NdefFormatable.class.getName(), TagTechnology.NDEF_FORMATABLE); techStringToCodeMap.put(NfcA.class.getName(), TagTechnology.NFC_A); techStringToCodeMap.put(NfcB.class.getName(), TagTechnology.NFC_B); techStringToCodeMap.put(NfcF.class.getName(), TagTechnology.NFC_F); techStringToCodeMap.put(NfcV.class.getName(), TagTechnology.NFC_V); techStringToCodeMap.put(NfcBarcode.class.getName(), TagTechnology.NFC_BARCODE); return techStringToCodeMap;
public boolean	hasTech(int techType) hide for (int tech : mTechList) { if (tech == techType) return true; } return false;
static byte[]	readBytesWithNull(android.os.Parcel in) int len = in.readInt(); byte[] result = null; if (len >= 0) { result = new byte[len]; in.readByteArray(result); } return result;
public android.nfc.Tag	rediscover() Rediscover the technologies available on this tag. The technologies that are available on a tag may change due to operations being performed on a tag. For example, formatting a tag as NDEF adds the {@link Ndef} technology. The {@link rediscover} method reenumerates the available technologies on the tag and returns a new {@link Tag} object containing these technologies. You may not be connected to any of this {@link Tag}'s technologies when calling this method. This method guarantees that you will be returned the same Tag if it is still in the field. May cause RF activity and may block. Must not be called from the main application thread. A blocked call will be canceled with {@link IOException} by calling {@link #close} from another thread. Does not remove power from the RF field, so a tag having a random ID should not change its ID. return the rediscovered tag object. throws IOException if the tag cannot be rediscovered hide if (getConnectedTechnology() != -1) { throw new IllegalStateException("Close connection to the technology first!"); } if (mTagService == null) { throw new IOException("Mock tags don't support this operation."); } try { Tag newTag = mTagService.rediscover(getServiceHandle()); if (newTag != null) { return newTag; } else { throw new IOException("Failed to rediscover tag"); } } catch (RemoteException e) { throw new IOException("NFC service dead"); }
public synchronized void	setConnectedTechnology(int technology) For internal use only. hide if (mConnectedTechnology == -1) { mConnectedTechnology = technology; } else { throw new IllegalStateException("Close other technology first!"); }
public void	setTechnologyDisconnected() For internal use only. hide mConnectedTechnology = -1;
public java.lang.String	toString() Human-readable description of the tag, for debugging. StringBuilder sb = new StringBuilder("TAG: Tech ["); String[] techList = getTechList(); int length = techList.length; for (int i = 0; i < length; i++) { sb.append(techList[i]); if (i < length - 1) { sb.append(", "); } } sb.append("]"); return sb.toString();
static void	writeBytesWithNull(android.os.Parcel out, byte[] b) if (b == null) { out.writeInt(-1); return; } out.writeInt(b.length); out.writeByteArray(b);
public void	writeToParcel(android.os.Parcel dest, int flags) // Null mTagService means this is a mock tag int isMock = (mTagService == null)?1:0; writeBytesWithNull(dest, mId); dest.writeInt(mTechList.length); dest.writeIntArray(mTechList); dest.writeTypedArray(mTechExtras, 0); dest.writeInt(mServiceHandle); dest.writeInt(isMock); if (isMock == 0) { dest.writeStrongBinder(mTagService.asBinder()); }