diff --git a/samples/ApiDemos/AndroidManifest.xml b/samples/ApiDemos/AndroidManifest.xml index d8a85a7af..55a04f052 100644 --- a/samples/ApiDemos/AndroidManifest.xml +++ b/samples/ApiDemos/AndroidManifest.xml @@ -1232,6 +1232,15 @@ + + + + + + + diff --git a/samples/ApiDemos/res/values/strings.xml b/samples/ApiDemos/res/values/strings.xml index 21835cb83..8db2c966f 100644 --- a/samples/ApiDemos/res/values/strings.xml +++ b/samples/ApiDemos/res/values/strings.xml @@ -463,6 +463,8 @@ Send IR Get Carrier Frequencies + Content/Storage/Documents + diff --git a/samples/ApiDemos/src/com/example/android/apis/content/DocumentsSample.java b/samples/ApiDemos/src/com/example/android/apis/content/DocumentsSample.java new file mode 100644 index 000000000..544e63752 --- /dev/null +++ b/samples/ApiDemos/src/com/example/android/apis/content/DocumentsSample.java @@ -0,0 +1,352 @@ +/* + * Copyright (C) 2013 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 com.example.android.apis.content; + +import android.app.Activity; +import android.content.ContentResolver; +import android.content.Context; +import android.content.Intent; +import android.database.Cursor; +import android.net.Uri; +import android.os.Bundle; +import android.provider.DocumentsContract; +import android.provider.DocumentsContract.Document; +import android.util.Log; +import android.view.View; +import android.view.View.OnClickListener; +import android.widget.Button; +import android.widget.CheckBox; +import android.widget.LinearLayout; +import android.widget.ScrollView; +import android.widget.TextView; + +import java.io.ByteArrayOutputStream; +import java.io.IOException; +import java.io.InputStream; +import java.io.OutputStream; + +/** + * Example that exercises client side of {@link DocumentsContract}. + */ +public class DocumentsSample extends Activity { + private static final String TAG = "DocumentsSample"; + + private static final int CODE_READ = 42; + private static final int CODE_WRITE = 43; + private static final int CODE_PICK = 44; + + private TextView mResult; + + @Override + public void onCreate(Bundle icicle) { + super.onCreate(icicle); + + final Context context = this; + + final LinearLayout view = new LinearLayout(context); + view.setOrientation(LinearLayout.VERTICAL); + + mResult = new TextView(context); + view.addView(mResult); + + final CheckBox multiple = new CheckBox(context); + multiple.setText("ALLOW_MULTIPLE"); + view.addView(multiple); + final CheckBox localOnly = new CheckBox(context); + localOnly.setText("LOCAL_ONLY"); + view.addView(localOnly); + + Button button; + button = new Button(context); + button.setText("OPEN_DOC */*"); + button.setOnClickListener(new OnClickListener() { + @Override + public void onClick(View v) { + Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT); + intent.addCategory(Intent.CATEGORY_OPENABLE); + intent.setType("*/*"); + if (multiple.isChecked()) { + intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true); + } + if (localOnly.isChecked()) { + intent.putExtra(Intent.EXTRA_LOCAL_ONLY, true); + } + startActivityForResult(intent, CODE_READ); + } + }); + view.addView(button); + + button = new Button(context); + button.setText("OPEN_DOC image/*"); + button.setOnClickListener(new OnClickListener() { + @Override + public void onClick(View v) { + Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT); + intent.addCategory(Intent.CATEGORY_OPENABLE); + intent.setType("image/*"); + if (multiple.isChecked()) { + intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true); + } + if (localOnly.isChecked()) { + intent.putExtra(Intent.EXTRA_LOCAL_ONLY, true); + } + startActivityForResult(intent, CODE_READ); + } + }); + view.addView(button); + + button = new Button(context); + button.setText("OPEN_DOC audio/ogg"); + button.setOnClickListener(new OnClickListener() { + @Override + public void onClick(View v) { + Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT); + intent.addCategory(Intent.CATEGORY_OPENABLE); + intent.setType("audio/ogg"); + if (multiple.isChecked()) { + intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true); + } + if (localOnly.isChecked()) { + intent.putExtra(Intent.EXTRA_LOCAL_ONLY, true); + } + startActivityForResult(intent, CODE_READ); + } + }); + view.addView(button); + + button = new Button(context); + button.setText("OPEN_DOC text/plain, application/msword"); + button.setOnClickListener(new OnClickListener() { + @Override + public void onClick(View v) { + Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT); + intent.addCategory(Intent.CATEGORY_OPENABLE); + intent.setType("*/*"); + intent.putExtra(Intent.EXTRA_MIME_TYPES, new String[] { + "text/plain", "application/msword" }); + if (multiple.isChecked()) { + intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true); + } + if (localOnly.isChecked()) { + intent.putExtra(Intent.EXTRA_LOCAL_ONLY, true); + } + startActivityForResult(intent, CODE_READ); + } + }); + view.addView(button); + + button = new Button(context); + button.setText("CREATE_DOC text/plain"); + button.setOnClickListener(new OnClickListener() { + @Override + public void onClick(View v) { + Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT); + intent.addCategory(Intent.CATEGORY_OPENABLE); + intent.setType("text/plain"); + intent.putExtra(Intent.EXTRA_TITLE, "foobar.txt"); + if (localOnly.isChecked()) { + intent.putExtra(Intent.EXTRA_LOCAL_ONLY, true); + } + startActivityForResult(intent, CODE_WRITE); + } + }); + view.addView(button); + + button = new Button(context); + button.setText("CREATE_DOC image/png"); + button.setOnClickListener(new OnClickListener() { + @Override + public void onClick(View v) { + Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT); + intent.addCategory(Intent.CATEGORY_OPENABLE); + intent.setType("image/png"); + intent.putExtra(Intent.EXTRA_TITLE, "mypicture.png"); + if (localOnly.isChecked()) { + intent.putExtra(Intent.EXTRA_LOCAL_ONLY, true); + } + startActivityForResult(intent, CODE_WRITE); + } + }); + view.addView(button); + + button = new Button(context); + button.setText("GET_CONTENT */*"); + button.setOnClickListener(new OnClickListener() { + @Override + public void onClick(View v) { + Intent intent = new Intent(Intent.ACTION_GET_CONTENT); + intent.addCategory(Intent.CATEGORY_OPENABLE); + intent.setType("*/*"); + if (multiple.isChecked()) { + intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true); + } + if (localOnly.isChecked()) { + intent.putExtra(Intent.EXTRA_LOCAL_ONLY, true); + } + startActivityForResult(Intent.createChooser(intent, "Kittens!"), CODE_READ); + } + }); + view.addView(button); + + button = new Button(context); + button.setText("PICK_DIRECTORY"); + button.setOnClickListener(new OnClickListener() { + @Override + public void onClick(View v) { + Intent intent = new Intent(Intent.ACTION_PICK_DIRECTORY); + if (localOnly.isChecked()) { + intent.putExtra(Intent.EXTRA_LOCAL_ONLY, true); + } + startActivityForResult(Intent.createChooser(intent, "Kittens!"), CODE_PICK); + } + }); + view.addView(button); + + final ScrollView scroll = new ScrollView(context); + scroll.addView(view); + + setContentView(scroll); + } + + @Override + protected void onActivityResult(int requestCode, int resultCode, Intent data) { + final ContentResolver cr = getContentResolver(); + + clearLog(); + + log("resultCode=" + resultCode); + log("data=" + String.valueOf(data)); + + final Uri uri = data != null ? data.getData() : null; + if (uri != null) { + log("isDocumentUri=" + DocumentsContract.isDocumentUri(this, uri)); + } else { + log("missing URI?"); + return; + } + + if (requestCode == CODE_READ) { + try { + cr.takePersistableUriPermission(uri, Intent.FLAG_GRANT_READ_URI_PERMISSION); + } catch (SecurityException e) { + log("FAILED TO TAKE PERMISSION", e); + } + InputStream is = null; + try { + is = cr.openInputStream(uri); + log("read length=" + readFullyNoClose(is).length); + } catch (Exception e) { + log("FAILED TO READ", e); + } finally { + closeQuietly(is); + } + } else if (requestCode == CODE_WRITE) { + try { + cr.takePersistableUriPermission(uri, Intent.FLAG_GRANT_WRITE_URI_PERMISSION); + } catch (SecurityException e) { + log("FAILED TO TAKE PERMISSION", e); + } + OutputStream os = null; + try { + os = cr.openOutputStream(uri); + os.write("THE COMPLETE WORKS OF SHAKESPEARE".getBytes()); + log("wrote data"); + } catch (Exception e) { + log("FAILED TO WRITE", e); + } finally { + closeQuietly(os); + } + } else if (requestCode == CODE_PICK) { + // Find existing docs + Uri doc = DocumentsContract.buildDocumentViaUri(uri, + DocumentsContract.getViaDocumentId(uri)); + Uri child = DocumentsContract.buildChildDocumentsViaUri(uri, + DocumentsContract.getViaDocumentId(uri)); + Cursor c = cr.query(child, new String[] { + Document.COLUMN_DISPLAY_NAME, Document.COLUMN_MIME_TYPE }, null, null, null); + try { + while (c.moveToNext()) { + log("found child=" + c.getString(0) + ", mime=" + c.getString(1)); + } + } finally { + closeQuietly(c); + } + + // Create some documents + Uri pic = DocumentsContract.createDocument(cr, doc, "image/png", "pic.png"); + Uri dir = DocumentsContract.createDocument(cr, doc, Document.MIME_TYPE_DIR, "my dir"); + Uri dirPic = DocumentsContract.createDocument(cr, dir, "image/png", "pic2.png"); + + log("created " + pic); + log("created " + dir); + log("created " + dirPic); + + // Write to one of them + OutputStream os = null; + try { + os = cr.openOutputStream(dirPic); + os.write("THE COMPLETE WORKS OF SHAKESPEARE".getBytes()); + log("wrote data"); + } catch (Exception e) { + log("FAILED TO WRITE", e); + } finally { + closeQuietly(os); + } + + // And delete the first pic + if (DocumentsContract.deleteDocument(cr, pic)) { + log("deleted untouched pic"); + } else { + log("FAILED TO DELETE PIC"); + } + } + } + + private void clearLog() { + mResult.setText(null); + } + + private void log(String msg) { + log(msg, null); + } + + private void log(String msg, Throwable t) { + Log.d(TAG, msg, t); + mResult.setText(mResult.getText() + "\n" + msg); + } + + public static byte[] readFullyNoClose(InputStream in) throws IOException { + ByteArrayOutputStream bytes = new ByteArrayOutputStream(); + byte[] buffer = new byte[1024]; + int count; + while ((count = in.read(buffer)) != -1) { + bytes.write(buffer, 0, count); + } + return bytes.toByteArray(); + } + + public static void closeQuietly(AutoCloseable closeable) { + if (closeable != null) { + try { + closeable.close(); + } catch (RuntimeException rethrown) { + throw rethrown; + } catch (Exception ignored) { + } + } + } +}