ExternalStorage.

java
The file containing the source code shown below is located in the corresponding directory in
<sdk>/platforms/android-<version>/samples/...

/*
 * 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 com.example.android.apis.content;

//Need the following import to get access to

the app resources, since this
//class is in a sub-package.
import com.example.android.apis.R;

import android.app.Activity;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.media.MediaScannerConnection;
import android.net.Uri;
import android.os.Bundle;
import android.os.Environment;
import android.util.Log;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.Button;
import android.widget.TextView;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;

/**
* Demonstration of styled text resources.
*/
public class ExternalStorage extends
Activity {
    ViewGroup mLayout;

    static class Item {

        View mRoot;
        Button mCreate;
        Button mDelete;
    }

    Item mExternalStoragePublicPicture;
    Item mExternalStoragePrivatePicture;
    Item mExternalStoragePrivateFile;

    @Override
    protected void onCreate(Bundle
savedInstanceState) {
        super.onCreate(savedInstanceState);

       
setContentView(R.layout.external_storage);
        mLayout =
(ViewGroup)findViewById(R.id.layout);
        mExternalStoragePublicPicture =
createStorageControls(
                "Picture:
getExternalStoragePublicDirectory",
               
Environment.getExternalStoragePublicDirector
y(
                       
Environment.DIRECTORY_PICTURES),
                new View.OnClickListener() {
                    public void onClick(View
v) {
                       
createExternalStoragePublicPicture();
                       
updateExternalStorageState();
                    }
                },
                new View.OnClickListener() {
                    public void onClick(View
v) {
                       
deleteExternalStoragePublicPicture();
                       
updateExternalStorageState();
                    }
                });
       
mLayout.addView(mExternalStoragePublicPictur
e.mRoot);
        mExternalStoragePrivatePicture =
createStorageControls(
                "Picture
getExternalFilesDir",
               
getExternalFilesDir(Environment.DIRECTORY_PI
CTURES),
                new View.OnClickListener() {
                    public void onClick(View
v) {
                       
createExternalStoragePrivatePicture();
                       
updateExternalStorageState();
                    }
                },
                new View.OnClickListener() {
                    public void onClick(View
v) {
                       
deleteExternalStoragePrivatePicture();
                       
updateExternalStorageState();
                    }
                });
       
mLayout.addView(mExternalStoragePrivatePictu
re.mRoot);
        mExternalStoragePrivateFile =
createStorageControls(
                "File getExternalFilesDir",
                getExternalFilesDir(null),
                new View.OnClickListener() {
                    public void onClick(View
v) {
                       
createExternalStoragePrivateFile();
                       
updateExternalStorageState();
                    }
                },
                new View.OnClickListener() {
                    public void onClick(View
v) {
                       
deleteExternalStoragePrivateFile();
                       
updateExternalStorageState();
                    }
                });
       
mLayout.addView(mExternalStoragePrivateFile.
mRoot);

        startWatchingExternalStorage();
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        stopWatchingExternalStorage();
    }

    void handleExternalStorageState(boolean
available, boolean writeable) {
        boolean has =
hasExternalStoragePublicPicture();
       
mExternalStoragePublicPicture.mCreate.setEna
bled(writeable && !has);
       
mExternalStoragePublicPicture.mDelete.setEna
bled(writeable && has);
        has =
hasExternalStoragePrivatePicture();
       
mExternalStoragePrivatePicture.mCreate.setEn
abled(writeable && !has);
       
mExternalStoragePrivatePicture.mDelete.setEn
abled(writeable && has);
        has =
hasExternalStoragePrivateFile();
       
mExternalStoragePrivateFile.mCreate.setEnabl
ed(writeable && !has);
       
mExternalStoragePrivateFile.mDelete.setEnabl
ed(writeable && has);
    }

    BroadcastReceiver
mExternalStorageReceiver;
    boolean mExternalStorageAvailable =
false;
    boolean mExternalStorageWriteable =
false;

    void updateExternalStorageState() {
        String state =
Environment.getExternalStorageState();
        if
(Environment.MEDIA_MOUNTED.equals(state)) {
            mExternalStorageAvailable =
mExternalStorageWriteable = true;
        } else if
(Environment.MEDIA_MOUNTED_READ_ONLY.equals(
state)) {
            mExternalStorageAvailable =
true;
            mExternalStorageWriteable =
false;
        } else {
            mExternalStorageAvailable =
mExternalStorageWriteable = false;
        }
       
handleExternalStorageState(mExternalStorageA
vailable,
                mExternalStorageWriteable);
    }

    void startWatchingExternalStorage() {
        mExternalStorageReceiver = new
BroadcastReceiver() {
            @Override
            public void onReceive(Context
context, Intent intent) {
                Log.i("test", "Storage: " +
intent.getData());
               
updateExternalStorageState();
            }
        };
        IntentFilter filter = new
IntentFilter();
       
filter.addAction(Intent.ACTION_MEDIA_MOUNTED
);
       
filter.addAction(Intent.ACTION_MEDIA_REMOVED
);
       
registerReceiver(mExternalStorageReceiver,
filter);
        updateExternalStorageState();
    }

    void stopWatchingExternalStorage() {
       
unregisterReceiver(mExternalStorageReceiver)
;
    }

    void
createExternalStoragePublicPicture() {
        // Create a path where we will place
our picture in the user's
        // public pictures directory.  Note
that you should be careful about
        // what you place here, since the
user often manages these files.  For
        // pictures and other media owned by
the application, consider
        // Context.getExternalMediaDir().
        File path =
Environment.getExternalStoragePublicDirector
y(
               
Environment.DIRECTORY_PICTURES);
        File file = new File(path,
"DemoPicture.jpg");

        try {
            // Make sure the Pictures
directory exists.
            path.mkdirs();

            // Very simple code to copy a

picture from the application's
            // resource into the external
file.  Note that this code does
            // no error checking, and
assumes the picture is small (does not
            // try to copy it in chunks).
Note that if external storage is
            // not currently mounted this
will silently fail.
            InputStream is =
getResources().openRawResource(R.drawable.ba
lloons);
            OutputStream os = new
FileOutputStream(file);
            byte[] data = new
byte[is.available()];
            is.read(data);
            os.write(data);
            is.close();
            os.close();

            // Tell the media scanner about

the new file so that it is
            // immediately available to the
user.
           
MediaScannerConnection.scanFile(this,
                    new String[]
{ file.toString() }, null,
                    new
MediaScannerConnection.OnScanCompletedListen
er() {
                public void
onScanCompleted(String path, Uri uri) {
                    Log.i("ExternalStorage",
"Scanned " + path + ":");
                    Log.i("ExternalStorage",
"-> uri=" + uri);
                }
            });
        } catch (IOException e) {
            // Unable to create file, likely
because external storage is
            // not currently mounted.
            Log.w("ExternalStorage", "Error
writing " + file, e);
        }
    }

    void
deleteExternalStoragePublicPicture() {
        // Create a path where we will place
our picture in the user's
        // public pictures directory and
delete the file.  If external
        // storage is not currently mounted
this will fail.
        File path =
Environment.getExternalStoragePublicDirector
y(
               
Environment.DIRECTORY_PICTURES);
        File file = new File(path,
"DemoPicture.jpg");
        file.delete();
    }

    boolean
hasExternalStoragePublicPicture() {
        // Create a path where we will place
our picture in the user's
        // public pictures directory and
check if the file exists.  If
        // external storage is not currently
mounted this will think the
        // picture doesn't exist.
        File path =
Environment.getExternalStoragePublicDirector
y(
               
Environment.DIRECTORY_PICTURES);
        File file = new File(path,
"DemoPicture.jpg");
        return file.exists();
    }

    void
createExternalStoragePrivatePicture() {
        // Create a path where we will place
our picture in our own private
        // pictures directory.  Note that we
don't really need to place a
        // picture in DIRECTORY_PICTURES,
since the media scanner will see
        // all media in these directories;
this may be useful with other
        // media types such as
DIRECTORY_MUSIC however to help it classify
        // your media for display to the
user.
        File path =
getExternalFilesDir(Environment.DIRECTORY_PI
CTURES);
        File file = new File(path,
"DemoPicture.jpg");

        try {
            // Very simple code to copy a
picture from the application's
            // resource into the external
file.  Note that this code does
            // no error checking, and
assumes the picture is small (does not
            // try to copy it in chunks).
Note that if external storage is
            // not currently mounted this
will silently fail.
            InputStream is =
getResources().openRawResource(R.drawable.ba
lloons);
            OutputStream os = new
FileOutputStream(file);
            byte[] data = new
byte[is.available()];
            is.read(data);
            os.write(data);
            is.close();
            os.close();

            // Tell the media scanner about

the new file so that it is
            // immediately available to the
user.
           
MediaScannerConnection.scanFile(this,
                    new String[]
{ file.toString() }, null,
                    new
MediaScannerConnection.OnScanCompletedListen
er() {
                public void
onScanCompleted(String path, Uri uri) {
                    Log.i("ExternalStorage",
"Scanned " + path + ":");
                    Log.i("ExternalStorage",
"-> uri=" + uri);
                }
            });
        } catch (IOException e) {
            // Unable to create file, likely
because external storage is
            // not currently mounted.
            Log.w("ExternalStorage", "Error
writing " + file, e);
        }
    }

    void
deleteExternalStoragePrivatePicture() {
        // Create a path where we will place
our picture in the user's
        // public pictures directory and
delete the file.  If external
        // storage is not currently mounted
this will fail.
        File path =
getExternalFilesDir(Environment.DIRECTORY_PI
CTURES);
        if (path != null) {
            File file = new File(path,
"DemoPicture.jpg");
            file.delete();
        }
    }

    boolean
hasExternalStoragePrivatePicture() {
        // Create a path where we will place
our picture in the user's
        // public pictures directory and
check if the file exists.  If
        // external storage is not currently
mounted this will think the
        // picture doesn't exist.
        File path =
getExternalFilesDir(Environment.DIRECTORY_PI
CTURES);
        if (path != null) {
            File file = new File(path,
"DemoPicture.jpg");
            return file.exists();
        }
        return false;
    }

     void createExternalStoragePrivateFile()
{
         // Create a path where we will
place our private file on external
         // storage.
         File file = new
File(getExternalFilesDir(null),
"DemoFile.jpg");

         try {
             // Very simple code to copy a
picture from the application's
             // resource into the external
file.  Note that this code does
             // no error checking, and
assumes the picture is small (does not
             // try to copy it in chunks).
Note that if external storage is
             // not currently mounted this
will silently fail.
             InputStream is =
getResources().openRawResource(R.drawable.ba
lloons);
             OutputStream os = new
FileOutputStream(file);
             byte[] data = new
byte[is.available()];
             is.read(data);
             os.write(data);
             is.close();
             os.close();
         } catch (IOException e) {
             // Unable to create file,
likely because external storage is
             // not currently mounted.
             Log.w("ExternalStorage", "Error
writing " + file, e);
         }
     }

     void deleteExternalStoragePrivateFile()
{
         // Get path for the file on
external storage.  If external
         // storage is not currently mounted
this will fail.
         File file = new
File(getExternalFilesDir(null),
"DemoFile.jpg");
         if (file != null) {
             file.delete();
         }
     }

     boolean hasExternalStoragePrivateFile()
{
         // Get path for the file on
external storage.  If external
         // storage is not currently mounted
this will fail.
         File file = new
File(getExternalFilesDir(null),
"DemoFile.jpg");
         if (file != null) {
             return file.exists();
         }
         return false;
     }

    Item createStorageControls(CharSequence
label, File path,
            View.OnClickListener
createClick,
            View.OnClickListener
deleteClick) {
        LayoutInflater inflater =
(LayoutInflater)getSystemService(LAYOUT_INFL
ATER_SERVICE);
        Item item = new Item();
        item.mRoot =
inflater.inflate(R.layout.external_storage_i
tem, null);
        TextView tv =
(TextView)item.mRoot.findViewById(R.id.label
);
        tv.setText(label);
        if (path != null) {
            tv =
(TextView)item.mRoot.findViewById(R.id.path)
;
            tv.setText(path.toString());
        }
        item.mCreate =
(Button)item.mRoot.findViewById(R.id.create)
;
       
item.mCreate.setOnClickListener(createClick)
;
        item.mDelete =
(Button)item.mRoot.findViewById(R.id.delete)
;
       
item.mDelete.setOnClickListener(deleteClick)
;
        return item;
    }
}