Write To and Read From SD Card

Introduction

 

First, we will create a simple text file and then write some data into this file and finally, we will read the data from the text file.

 

Now we move to the coding part of this article.

 

XML Code of Activity

<FrameLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
        android:id="@+id/container"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        tools:context="com.example.readwritedataonsdcard.MainActivity"
        tools:ignore="MergeRootFrame" >
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical" >
        <Button
            android:id="@+id/btnWrite"
            android:layout_width="222dp"
            android:layout_height="wrap_content"
            android:text="@string/Write" />
        <Button
            android:id="@+id/btnRead"
            android:layout_width="222dp"
            android:layout_height="wrap_content"
            android:text="@string/Read" />
        <TextView
            android:id="@+id/textView1"
            android:layout_width="304dp"
            android:layout_height="900dp"
            android:layout_weight="0.06"
            android:textAppearance="?android:attr/textAppearanceLarge" />
    </LinearLayout>
</FrameLayout>

After using the preceding XML code our activity will look as in the following:

 

 

In this activity we use two buttons and a TextView (Label),

 

- The first button is “Write Data”. We will use this button to create a file and write some data in that text file

- The second button is “Read Data”.  We will use this button to read the data from the file and show the data in a TextView (Label).

 

Take User Permission

 

This is very important. If we are using an SDCard (Storage Device) in our project, then we must have user-permission, otherwise, the system will throw an error of permission denied. We can take user permission using the following code:

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

Write this code in your AndroidMainfest.xml file like the following:

 

 

Now we move to the source code (Java code) of this project. The following is the source code:

public class MainActivity extends ActionBarActivity {

    Button Read;
    Button Write;@Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        Read = (Button) findViewById(R.id.btnRead);
        Write = (Button) findViewById(R.id.btnWrite);

        Write.setOnClickListener(new View.OnClickListener() {

            @Override
            public void onClick(View arg0) {
                // TODO Auto-generated method stub

                String state = Environment.getExternalStorageState();

                if (state.equals(Environment.MEDIA_MOUNTED)) {
                    Toast.makeText(getApplicationContext(), "Media Is Mounted", Toast.LENGTH_SHORT).show();
                    File f = Environment.getExternalStorageDirectory();
                    File dir = new File(f.getAbsolutePath() + "/My_File");
                    dir.mkdirs();

                    File myfile = new File(dir, "MyTextFile.txt");

                    try {
                        myfile.createNewFile();
                        try {
                            FileOutputStream fout = new FileOutputStream(myfile);
                            PrintWriter pw = new PrintWriter(fout);
                            pw.println("Name=Pankaj Kumar Choudhary");
                            pw.println("\r\n" + "City=Alwar Rajasthan");
                            pw.println("\r\n" + "Occupation=Student");
                            pw.println("\r\n" + "Branch=Computer(CSE)");
                            pw.println("\r\n" + "Semester=7th");
                            pw.flush();
                            pw.close();
                            fout.close();
                            Toast.makeText(getApplicationContext(), "File Written successfully", Toast.LENGTH_LONG).show();
                        } catch (Exception e) {
                            Toast.makeText(getApplicationContext(), e.toString(), Toast.LENGTH_LONG).show();
                            //tv.setText(e.toString());
                        }


                    } catch (IOException e1) {
                        // TODO Auto-generated catch block
                        e1.printStackTrace();
                    }

                } else {
                    Toast.makeText(getApplicationContext(), "Media is not mounted", Toast.LENGTH_SHORT).show();
                }

            }
        });
        Read.setOnClickListener(new View.OnClickListener() {

            @Override
            public void onClick(View arg0) {
                // TODO Auto-generated method stub

                File f = Environment.getExternalStorageDirectory();
                //f.getAbsolutePath()
                File finalPath = new File(f.getAbsolutePath(), "/My_File/MyTextFile.txt");
                String lines = null;
                TextView t = (TextView) findViewById(R.id.textView1);
                try {
                    FileInputStream fin = new FileInputStream(finalPath);
                    BufferedReader myReader = new BufferedReader(new InputStreamReader(fin));

                    while ((lines = myReader.readLine()) != null) {
                        t.append(lines + "\r\n");
                    }
                    myReader.close();
                    Toast.makeText(getApplicationContext(), "File has been read successfully", Toast.LENGTH_LONG).show();
                } catch (Exception e) {
                    t.append(finalPath.getPath() + "\n" + e.toString());
                    Toast.makeText(getApplicationContext(), e.toString(), Toast.LENGTH_LONG).show();
                }

            }
        });
    }
}

Now I will explain the preceding code in a number of sections for a better understanding:

 

Code Section 1

String state = Environment.getExternalStorageState();

if (state.equals(Environment.MEDIA_MOUNTED)) {
    Toast.makeText(getApplicationContext(), "Media Is Mounted", Toast.LENGTH_SHORT).show();
    File f = Environment.getExternalStorageDirectory();
    File dir = new File(f.getAbsolutePath() + "/My_File");
    dir.mkdirs();
}

In the preceding code, we get the information about the external storage of our device using the getExternalStorageState() method. This method returns the information about the primary external storage directory like whether the external storage device is mounted. If the external storage device is mounted then we will show a message that “Media Is Mounted” using the Toast.makeText() method like the following:

 

 

Then we get the full path of the external storage device (SD Card) using the getExternalStorageDirectory() method. Now we will make a new directory (folder) in the SD Card using the mkdirs() method and assign a name. Here we will create a folder with the name “My_File”.

 

Code Section 2

File myfile = new File(dir, "MyTextFile.txt");

try {
    myfile.createNewFile();
    try {
        FileOutputStream fout = new FileOutputStream(myfile);
        PrintWriter pw = new PrintWriter(fout);
        pw.println("Name=Pankaj Kumar Choudhary");
        pw.println("\r\n" + "City=Alwar Rajasthan");
        pw.println("\r\n" + "Occupation=Student");
        pw.println("\r\n" + "Branch=Computer(CSE)");
        pw.println("\r\n" + "Semester=7th");
        pw.flush();
        pw.close();
        fout.close();
        Toast.makeText(getApplicationContext(), "File Written successfully", Toast.LENGTH_LONG).show();
    }
}

In the preceding code, we create a new TextFile using the createNewFile method. We use an object of the FileOutputStream class. FileOutputStream creates an OutputStream that we can use to write bytes to a file. In other words, FileOutputStream is used to write binary data to a file. We use a parameterized constructor of the FileOutputStream class and pass the name of the file as parameter. So the object of the FileOutputStream class will create an OutputStream for the “MyTextFile.txt” file. We create an object of PrintWriter class. This class provides a convenient method for printing common data types in a human-readable format. We write some data into our text file using the “println” method. Finally, we will show a message of file successfully written.

 

Conclusion

 

I can summarize all the operations in the following. We are writing our data in a PrintWriter class object using the println method. The PrintWriter class inserts all the data into a FileOutputStream class object and the FileOutputStream's object converts the data into byte code form and inserts the data into our textfile.

 

 

After the file is successfully written, check the storage of our device. We will find that “MyTextFile.txt” has been created in the sdcard.

 

 

Now we will check the data of this text file.

 

 

We can see that this text file contains the same data that we wrote in the preceding. Now I will explain how to read this data and show in a TextView.

 

Code Section 3

File f = Environment.getExternalStorageDirectory();
//f.getAbsolutePath()
File finalPath = new File(f.getAbsolutePath(), "/My_File/MyTextFile.txt");
String lines = null;
TextView t = (TextView) findViewById(R.id.textView1);
try {
    FileInputStream fin = new FileInputStream(finalPath);
    BufferedReader myReader = new BufferedReader(new InputStreamReader(fin));

    while ((lines = myReader.readLine()) != null) {
        t.append(lines + "\r\n");
    }
    myReader.close();
    Toast.makeText(getApplicationContext(), "File has been read successfully", Toast.LENGTH_LONG).show();
}

In the preceding code we used the getExternalStorageDirectory method. This method returns information about the primary external storage directory. Here the primary external storage device is the sdcard. In the next line we create an object of the File class. We pass two parameters in the File class constructor. The first is the absolute path of the external storage device and the second is the path of our text file in the sdcard. We also created an object of the FileInputStream class. The FileInputStream class is used to read a byte of data from a file. We pass the path of the file as a parameter in the FileInputStream class constructor.

 

We create an object of the BufferedReader class. The BufferedReader class wraps an existing Reader and buffers the input. In other words, the BufferedReader class retrieves data from a reader (here the reader is FileInputStream) and stores it in a buffer.

 

Now we can easily read data from the buffer using the readline method. In the preceding code, we read data line by line from the buffer and appended (inserted) this data into the TextView.

 

So when we click on the “Read Data” button, the output will be the following:

 

 

Thanks for reading my article. In the next article, I will explain a new topic on Android.