ファイル選択アクティビティ（ Activity + ListView )

解説

標準では、ファイル選択アクティビティに関する関数、クラスは用意されていないので、自作します。

実現方法としては、Activity内に、ListViewを表示する方法で実現します。

ファイル選択アクティビティに関するクラスとしては、３つのクラスを作成します。
・「Activity内にListViewを表示する」ファイル選択アクティビティクラス
・「ListViewの表示要素を管理する」ファイル情報配列アダプタクラス
・「ListViewで表示するときの一要素にあたる」ファイル情報クラス

実装

アプリの仕様

アプリを起動すると、メインアクティビティが表示される。
タイトルバー右のオプションメニューに、「Select File...」というメニュー項目が表示される。
「Select File...」というメニュー項目を選択すると、ファイル選択アクティビティが表示される。
ファイル選択アクティビティには、ディレクトリ・ファイルのリストと、「Cancel」ボタンが表示される。
ディレクトリ・ファイルのリストは、上の階層に戻る「..」、フォルダ、ファイルの順でリストされる。
ディレクトリ名は名前の末尾に「/」が付く。
ディレクトリ名をクリックすると、一階層下のディレクトリ・ファイルのリストが表示される。
ファイル名をクリックすると、ファイル選択アクティビティは閉じられ、選択したファイルパス名をトーストにて表示する。
「Cancel」ボタンを押すと、ファイル選択アクティビティは閉じられる。

プロジェクトの作成

（開発環境としては、Android Studio 2.3.3 を使用しています）

（この設定でプロジェクトを作成しなければいけない、というわけではありません。）

「Welcome」画面の「Start a new Android Studio project」をクリックします。

Application nameに、「FileSelectionActivityTest」と入力します。
Company domainに、会社のドメイン名を指定します。
Project locationに、プロジェクトを保存するフォルダパスを指定します。
「Next」ボタンを押します。

Minimum SDKを選択します（たとえば、「API19: Android 4.4 (KitKat)」）。
「Next」ボタンを押します。

「Empty Activity」を選択し、「Next」ボタンを押します。

（変更なし）
「Finish」を押します。

しばらく待ちます。
Android Studio のステータスバーに「Gradle build finished in ・・・」と出るまで待ちます。

以上で、プロジェクトができました。

クラスファイルの作成

ファイル選択アクティビティに関する以下の３つのクラスを作成していきます。
①「Activity内にListViewを表示する」ファイル選択アクティビティクラス
②「ListViewの表示要素を管理する」ファイル情報配列アダプタクラス
③「ListViewで表示するときの一要素にあたる」ファイル情報クラス

ここで、③は②からのみ使用されるクラスであり、②は①からのみ使用されるクラスです。

①②③のクラスをそれぞれ個別のファイルとして作成することもできますが、可搬性・移植性を考慮し、ここでは、①②③をまとめて１つのファイルで作成することとします。
すなわち、①のクラスの内部クラスとして②③のクラスを作成することとします。

「Project」ペインの「app > java > ドメイン.fileselectionactivitytest」を右クリックします。
右クリックメニュー「New > Activity > Empty Activity」を選択します。

Nameに、「FileSelectionActivity」と入力します。
「Finish」ボタンを押します。

ファイル情報クラスの追加

「ListViewで表示するときの一要素にあたる」ファイル情報クラスを追加します。

ファイル情報クラスの仕事は、
① ファイル・ディレクトリの表示名とFileオブジェクトの管理
② ソート用の比較関数の提供
です。

「① ファイル・ディレクトリの表示名とFileオブジェクトの管理」のために、メンバ変数、アクセサ関数を追加します。
「② ソート用の比較関数の提供」のために、Comparable<FileInfo> のインターフェースを実装します。
（クラス名の後ろに、implements Comparable<FileInfo> を追加し、インターフェースで宣言されている関数である compareTo関数を追加します。）

ファイル選択アクティビティクラスに、内部クラスとしてファイル情報クラスを追加します。

ファイル選択アクティビティクラス全体としては、以下のようにします。

public class FileSelectionActivity extends AppCompatActivity { static public class FileInfo implements Comparable<FileInfo> { private String m_strName; // 表示名 private File m_file; // ファイルオブジェクト // コンストラクタ public FileInfo( String strName, File file ) { m_strName = strName; m_file = file; } public String getName() { return m_strName; } public File getFile() { return m_file; } // 比較 public int compareTo( FileInfo another ) { // ディレクトリ < ファイルの順 if( m_file.isDirectory() && !another.getFile().isDirectory() ) { return -1; } if( !m_file.isDirectory() && another.getFile().isDirectory() ) { return 1; } // ファイル同士、ディレクトリ同士の場合は、ファイル名（ディレクトリ名）の大文字小文字区別しない辞書順 return m_file.getName().toLowerCase().compareTo( another.getFile().getName().toLowerCase() ); } } @Override protected void onCreate( Bundle savedInstanceState ) { （・・・省略・・・） } }

「Cannot resolve symbol」エラーは、「Alt + Enter」で、必要なクラスをimportします。
リビルドし、エラー、警告がないことを確認します。

ファイル情報配列アダプタクラスの追加

「ListViewの表示要素を管理する」ファイル情報配列アダプタクラスを追加します。

ファイル情報配列アダプタクラスの仕事は、
① ファイル情報リストの委譲、管理
② ListViewのリスト表示における一要素のビューの生成
です。

「① ファイル情報リストの委譲、管理」のために、メンバ変数、コンストラクタ、アクセサ関数を追加します。
「② ListViewのリスト表示における一要素のビューの生成」のために、getView関数をオーバーライドし、処理を実装します。

ファイル選択アクティビティクラスに、内部クラスとしてファイル情報配列アダプタクラスを追加します。

ファイル選択アクティビティクラス全体としては、以下のようにします。

public class FileSelectionActivity extends AppCompatActivity { static public class FileInfo implements Comparable<FileInfo> { （・・・省略・・・） } static public class FileInfoArrayAdapter extends BaseAdapter { private Context m_context; private List<FileInfo> m_listFileInfo; // ファイル情報リスト // コンストラクタ public FileInfoArrayAdapter( Context context, List<FileInfo> list ) { super(); m_context = context; m_listFileInfo = list; } @Override public int getCount() { return m_listFileInfo.size(); } @Override public FileInfo getItem( int position ) { return m_listFileInfo.get( position ); } @Override public long getItemId( int position ) { return position; } static class ViewHolder { TextView textviewFileName; TextView textviewFileSize; } // 一要素のビューの生成 @Override public View getView( int position, View convertView, ViewGroup parent ) { ViewHolder viewHolder; if( null == convertView ) { // レイアウト LinearLayout layout = new LinearLayout( m_context ); layout.setOrientation( LinearLayout.VERTICAL ); layout.setLayoutParams( new LinearLayout.LayoutParams( LinearLayout.LayoutParams.MATCH_PARENT, LinearLayout.LayoutParams.WRAP_CONTENT ) ); // ファイル名テキスト TextView textviewFileName = new TextView( m_context ); textviewFileName.setTextSize( TypedValue.COMPLEX_UNIT_DIP, 24 ); layout.addView( textviewFileName, new LinearLayout.LayoutParams( LinearLayout.LayoutParams.MATCH_PARENT, LinearLayout.LayoutParams.WRAP_CONTENT ) ); // ファイルサイズテキスト TextView textviewFileSize = new TextView( m_context ); textviewFileSize.setTextSize( TypedValue.COMPLEX_UNIT_DIP, 12 ); layout.addView( textviewFileSize, new LinearLayout.LayoutParams( LinearLayout.LayoutParams.MATCH_PARENT, LinearLayout.LayoutParams.WRAP_CONTENT ) ); convertView = layout; viewHolder = new ViewHolder(); viewHolder.textviewFileName = textviewFileName; viewHolder.textviewFileSize = textviewFileSize; convertView.setTag( viewHolder ); } else { viewHolder = (ViewHolder)convertView.getTag(); } FileInfo fileinfo = m_listFileInfo.get( position ); if( fileinfo.getFile().isDirectory() ) { // ディレクトリの場合は、名前の後ろに「/」を付ける viewHolder.textviewFileName.setText( fileinfo.getName() + "/" ); viewHolder.textviewFileSize.setText( "(directory)" ); } else { viewHolder.textviewFileName.setText( fileinfo.getName() ); viewHolder.textviewFileSize.setText( String.valueOf( fileinfo.getFile().length() / 1024 ) + " [KB]" ); } return convertView; } } @Override protected void onCreate( Bundle savedInstanceState ) { （・・・省略・・・） } }

「Cannot resolve symbol」エラーは、「Alt + Enter」で、必要なクラスをimportします。
リビルドし、エラー、警告がないことを確認します。

ファイル選択アクティビティクラスの追加

「Activity内にListViewを表示する」ファイル選択アクティビティクラスを追加します。

ファイル選択アクティビティクラスの仕事は、
① アクティビティの作成
② アクティビティのListView内の項目をクリックしたときの処理
③ アクティビティのCancelボタンをクリックしたときの処理
④ アクティビティ呼び出し元との情報のやりとりのためのインテントに関する処理
です。

「① アクティビティの作成」のために、onCreate関数と、fillという関数を追加します。
（アクティビティのビューのレイアウト構築に、xmlファイルを利用しないので、onCreate関数内の setContentView関数呼び出しをコメントアウトします。）
「② アクティビティのListView内の項目をクリックしたときの処理」のために、android.widget.AdapterView.OnItemClickListener のインターフェースを実装します。
（クラス名の後ろに、implements AdapterView.OnItemClickListener を追加し、インターフェースで宣言されている関数である onItemClick関数を追加します。）
「③ アクティビティのCancelボタンをクリックしたときの処理」のために、android.view.View.OnClickListener のインターフェースを実装します。
（クラス名の後ろの、implements AdapterView.OnItemClickListener の後ろに、 View.OnClickListener を追加し、インターフェースで宣言されている関数である onClick関数を追加します。）
「④ アクティビティ呼び出し元との情報のやりとりのためのインテントに関する処理」のために、onCreate関数に、呼び出し元からのパラメータ取得処理、onItemClick関数に、呼び出し元へのパラメータ設定処理、を追加します。

メンバ変数、コンストラクタも追加します。

ファイル選択アクティビティクラス全体としては、以下のようにします。

public class FileSelectionActivity extends AppCompatActivity implements AdapterView.OnItemClickListener, View.OnClickListener { static public class FileInfo implements Comparable<FileInfo> { （・・・省略・・・） } static public class FileInfoArrayAdapter extends BaseAdapter { （・・・省略・・・） } // 定数 public static final String EXTRA_INITIAL_DIR = "INITIAL_DIR"; public static final String EXTRA_FILE = "FILE"; private static final int BUTTONTAG_CANCEL = 0; // メンバー変数 private ListView m_listview; // リストビュー private FileInfoArrayAdapter m_fileinfoarrayadapter; // ファイル情報配列アダプタ @Override protected void onCreate( Bundle savedInstanceState ) { super.onCreate( savedInstanceState ); // setContentView( R.layout.activity_file_selection ); // アクティビティの戻り値の初期化 setResult( Activity.RESULT_CANCELED ); // 呼び出し元からパラメータ取得 String strInitialDir = null; Bundle extras = getIntent().getExtras(); if( null != extras ) { strInitialDir = extras.getString( EXTRA_INITIAL_DIR ); } if( null == strInitialDir || !( new File( strInitialDir ).isDirectory() ) ) { strInitialDir = "/"; } LinearLayout.LayoutParams layoutparams; // レイアウト LinearLayout layout = new LinearLayout( this ); layoutparams = new LinearLayout.LayoutParams( LinearLayout.LayoutParams.MATCH_PARENT, LinearLayout.LayoutParams.MATCH_PARENT ); layout.setLayoutParams( layoutparams ); layout.setOrientation( LinearLayout.VERTICAL ); setContentView( layout ); // リストビュー m_listview = new ListView( this ); m_listview.setOnItemClickListener( this ); layoutparams = new LinearLayout.LayoutParams( LinearLayout.LayoutParams.MATCH_PARENT, 0 ); layoutparams.weight = 1; layout.addView( m_listview, layoutparams ); // ボタン Button button = new Button( this ); button.setOnClickListener( this ); button.setTag( BUTTONTAG_CANCEL ); button.setText( "Cancel" ); layoutparams = new LinearLayout.LayoutParams( LinearLayout.LayoutParams.MATCH_PARENT, LinearLayout.LayoutParams.WRAP_CONTENT ); layout.addView( button, layoutparams ); fill( new File( strInitialDir ) ); } // アクティビティ内の表示内容構築 private void fill( File fileDirectory ) { // タイトル setTitle( fileDirectory.getAbsolutePath() ); // ファイルリスト File[] aFile = fileDirectory.listFiles(); List<FileInfo> listFileInfo = new ArrayList<>(); if( null != aFile ) { for( File fileTemp : aFile ) { listFileInfo.add( new FileInfo( fileTemp.getName(), fileTemp ) ); } Collections.sort( listFileInfo ); } // 親フォルダに戻るパスの追加 if( null != fileDirectory.getParent() ) { listFileInfo.add( 0, new FileInfo( "..", new File( fileDirectory.getParent() ) ) ); } m_fileinfoarrayadapter = new FileInfoArrayAdapter( this, listFileInfo ); m_listview.setAdapter( m_fileinfoarrayadapter ); } @Override public void onClick( View v ) { switch( (int)v.getTag() ) { case BUTTONTAG_CANCEL: // アクティビティ終了 finish(); break; } } @Override public void onItemClick( AdapterView<?> parent, View view, int position, long id ) { FileInfo fileinfo = m_fileinfoarrayadapter.getItem( position ); if( fileinfo.getFile().isDirectory() ) { fill( fileinfo.getFile() ); } else { // 呼び出し元へのパラメータ設定 Intent intent = new Intent(); intent.putExtra( EXTRA_FILE, fileinfo.getFile() ); // アクティビティの戻り値の設定 setResult( Activity.RESULT_OK, intent ); // アクティビティ終了 finish(); } } }

「Cannot resolve symbol」エラーは、「Alt + Enter」で、必要なクラスをimportします。
リビルドし、エラー、警告がないことを確認します。

メインアクティビティクラスの実装

ファイル選択アクティビティに関する３つのクラスが出来たので、メインアクティビティに、ファイル選択アクティビティ呼び出しの処理を実装します。

メインアクティビティクラスの仕事は、
① タイトルバー右のオプションメニューに、「Select File...」というメニュー項目が表示される。　② 「Select File...」というメニュー項目を選択すると、ファイル選択アクティビティが表示される。
③ ファイル名をクリックされた場合に、選択したファイルパス名をトーストにて表示する。
です。

「① タイトルバー右のオプションメニューに、「Select File...」というメニュー項目が表示される。」のために、onCreateOptionsMenu関数をオーバーライドし、処理を実装します。
「② 「Select File...」というメニュー項目を選択すると、ファイル選択アクティビティが表示される。」のために、onOptionsItemSelected関数をオーバーライドし、処理を実装します。
「③ ファイル名をクリックされた場合に、選択したファイルパス名をトーストにて表示する。」のために、onFileSelect関数を追加します。

メンバ変数も追加します。

メインアクティビティクラス全体としては、以下のようにします。

public class MainActivity extends AppCompatActivity { // 定数 private static final int MENUID_FILE = 0; // ファイルメニューID private static final int REQUEST_FILESELECT = 0; // リクエストコード // メンバー変数 private String m_strInitialDir = Environment.getExternalStorageDirectory().getPath(); // 初期フォルダ @Override protected void onCreate( Bundle savedInstanceState ) { super.onCreate( savedInstanceState ); setContentView( R.layout.activity_main ); } // オプションメニュー生成時 @Override public boolean onCreateOptionsMenu( Menu menu ) { super.onCreateOptionsMenu( menu ); menu.add( 0, MENUID_FILE, 0, "Select File..." ); return true; } // オプションメニュー選択時 @Override public boolean onOptionsItemSelected( MenuItem item ) { switch( item.getItemId() ) { case MENUID_FILE: // ファイル選択アクティビティ Intent intent = new Intent( this, FileSelectionActivity.class ); intent.putExtra( FileSelectionActivity.EXTRA_INITIAL_DIR, m_strInitialDir ); startActivityForResult( intent, REQUEST_FILESELECT ); return true; } return false; } // アクティビティ呼び出し結果の取得 @Override protected void onActivityResult( int requestCode, int resultCode, Intent intent ) { if( REQUEST_FILESELECT == requestCode && RESULT_OK == resultCode ) { Bundle extras = intent.getExtras(); if( null != extras ) { File file = (File)extras.getSerializable( FileSelectionActivity.EXTRA_FILE ); Toast.makeText( this, "File Selected : " + file.getPath(), Toast.LENGTH_SHORT ).show(); m_strInitialDir = file.getParent(); } } } }

「Cannot resolve symbol」エラーは、「Alt + Enter」で、必要なクラスをimportします。
リビルドし、エラー、警告がないことを確認します。

AndroidManifest.xml へのファイル選択アクティビティの追加

「FileSelectionActivity」を使用するためには、マニフェストファイルに、「FileSelectionActivity」に関する記述を追加する必要があります。

「Project」ペインの「app > manifests > AndroidManifest.xml」を開きます。

以下のパーミッション宣言があることを確認します。ない場合には、追加します。

<activity android:name=".FileSelectionActivity"> </activity>

「AndroidManifest.xml」全体としては、以下のようになります。

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.hiramine.fileselectionactivitytest"> <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:roundIcon="@mipmap/ic_launcher_round" android:supportsRtl="true" android:theme="@style/AppTheme"> <activity android:name=".MainActivity"> <intent-filter> <action android:name="android.intent.action.MAIN"/> <category android:name="android.intent.category.LAUNCHER"/> </intent-filter> </activity> <activity android:name=".FileSelectionActivity"> </activity> </application> </manifest>

ファイルのリストを取得するためのパーミッションの宣言

ファイルのリストを取得するためには、「READ_EXTERNAL_STORAGE」パーミッションが必要です。
マニフェストファイルに、「READ_EXTERNAL_STORAGE」パーミッションの宣言を追加します。

「Project」ペインの「app > manifests > AndroidManifest.xml」を開きます。

以下のパーミッション宣言を追加します。

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

「AndroidManifest.xml」全体としては、以下のようにします。

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.hiramine.fileselectionactivitytest">  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/> <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:roundIcon="@mipmap/ic_launcher_round" android:supportsRtl="true" android:theme="@style/AppTheme"> <activity android:name=".MainActivity"> <intent-filter> <action android:name="android.intent.action.MAIN"/> <category android:name="android.intent.category.LAUNCHER"/> </intent-filter> </activity> <activity android:name=".FileSelectionActivity"> </activity> </application> </manifest>

実行時のパーミッションリクエスト

ファイルのリストを取得するためには、「READ_EXTERNAL_STORAGE」パーミッションが必要です。
実行時に、「READ_EXTERNAL_STORAGE」パーミッションが付与されているかをチェックし、付与されていない場合にはパーミッションをリクエストします。

メインアクティビティクラスの末尾に、onResume関数、requestReadExternalStoragePermission関数、onRequestPermissionsResult関数を追加します。
また、定数宣言部に、「外部ストレージ読み込みパーミッション要求時の識別コード」定数を追加します。

public class MainActivity extends AppCompatActivity implements FileSelectionDialog.OnFileSelectListener { // 定数 private static final int MENUID_FILE = 0; // ファイルメニューID private static final int REQUEST_FILESELECT = 0; // リクエストコード private static final int REQUEST_PERMISSION_READ_EXTERNAL_STORAGE = 1; // 外部ストレージ読み込みパーミッション要求時の識別コード // メンバー変数（・・・省略・・・） // 初回表示時、および、ポーズからの復帰時 @Override protected void onResume() { super.onResume(); // 外部ストレージ読み込みパーミッション要求 requestReadExternalStoragePermission(); } // 外部ストレージ読み込みパーミッション要求 private void requestReadExternalStoragePermission() { if( PackageManager.PERMISSION_GRANTED == ContextCompat.checkSelfPermission( this, Manifest.permission.READ_EXTERNAL_STORAGE ) ) { // パーミッションは付与されている return; } // パーミッションは付与されていない。 // パーミッションリクエスト ActivityCompat.requestPermissions( this, new String[]{ Manifest.permission.READ_EXTERNAL_STORAGE }, REQUEST_PERMISSION_READ_EXTERNAL_STORAGE ); } // パーミッション要求ダイアログの操作結果 @Override public void onRequestPermissionsResult( int requestCode, String[] permissions, int[] grantResults ) { switch( requestCode ) { case REQUEST_PERMISSION_READ_EXTERNAL_STORAGE: if( grantResults.length == 0 || grantResults[0] != PackageManager.PERMISSION_GRANTED ) { // 許可されなかった場合 Toast.makeText( this, "Permission denied.", Toast.LENGTH_SHORT ).show(); finish(); // アプリ終了宣言 return; } break; default: break; } } }

「Cannot resolve symbol」エラーは、「Alt + Enter」で、必要なクラスをimportします。
リビルドし、エラー、警告がないことを確認します。

実行

Android端末にて、動作確認。

起動時に、「READ_EXTERNAL_STORAGE」パーミッションが付与されていない場合は、「READ_EXTERNAL_STORAGE」パーミッションリクエストダイアログが表示されます。「許可」をタップすると、起動します。「許可しない」をタップすると、起動しません。

起動直後

タイトルバー右のオプションメニューをタップすると、「Select File...」というメニュー項目が表示されます。

「Select File..」というメニュー項目を選択すると、ファイル選択アクティビティが表示されます。

ディレクトリ名をクリックすると、一階層下のディレクトリ・ファイルのリストが表示されます。

ファイル名をクリックすると、ファイルパス名が、トーストで表示されます。