Merge "Added NdefFormatable tag, initial class with supported methods." into gingerbread

core/java/android/nfc/technology/NdefFormatable.java

@@ -0,0 +1,62 @@
+/*
+ * Copyright (C) 2010 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package android.nfc.technology;
+
+import android.nfc.ErrorCodes;
+import android.nfc.FormatException;
+import android.nfc.NdefMessage;
+import android.nfc.NfcAdapter;
+import android.nfc.Tag;
+import android.os.Bundle;
+import android.os.RemoteException;
+
+import java.io.IOException;
+
+/**
+ * An interface to a {@link Tag} allowing to format the tag as NDEF.
+ *
+ * <p>You can acquire this kind of interface with {@link Tag#getTechnology(int)}.
+ *
+ * <p class="note"><strong>Note:</strong>
+ * Use of this class requires the {@link android.Manifest.permission#NFC}
+ * permission.
+ */
+public final class NdefFormatable extends BasicTagTechnology {
+    /**
+     * Internal constructor, to be used by NfcAdapter
+     * @hide
+     */
+    public NdefFormatable(NfcAdapter adapter, Tag tag, int tech, Bundle extras) throws RemoteException {
+        super(adapter, tag, tech);
+    }
+
+    /**
+     * Returns whether a tag can be formatted with {@link
+     * NdefFormatable#format(NdefMessage)}
+     */
+    public boolean canBeFormatted() throws IOException {
+      throw new UnsupportedOperationException();
+    }
+
+    /**
+     * Formats a tag as NDEF, if possible. You may supply a first
+     * NdefMessage to be written on the tag.
+     */
+    public void format(NdefMessage firstMessage) throws IOException {
+      throw new UnsupportedOperationException();
+    }
+}

core/java/android/nfc/technology/TagTechnology.java

@@ -66,6 +66,11 @@ public interface TagTechnology {
      */
     public static final int TYPE_4 = 104;
 
+    /**
+     * This object is an instance of {@link NdefFormatable}
+     */
+    public static final int NDEF_FORMATABLE = 110;
+
     /**
      * This object is an instance of {@link MifareClassic}
      */