扫二维码与项目经理沟通
我们在微信上24小时期待你的声音
解答本文疑问/技术咨询/运营咨询/技术建议/互联网交流
这个项目以及代码中使用的未在下面代码给出源码的方法都在这里：https://github.com/NashLegend/LegendUtils
丰县ssl适用于网站、小程序/APP、API接口等需要进行数据传输应用场景，ssl证书未来市场广阔！成为成都创新互联的ssl证书销售渠道，可以享受市场价格4-6折优惠！如果有意向欢迎电话联系或者加微信：028-86922220（备注：SSL证书合作）期待与您的合作！
第二种对话框的源码在这里：https://github.com/NashLegend/LegendExplorer/，这是一个文件浏览器源码。
Android文件对话框，一般用的分两种。
一是我们自己程序内使用的，当我们需要让用户选择一个文件或文件夹进行上传、下载或者其他操作时有时会用到。
二是系统的全局文件对话框，当一个程序发起一个要选择的Intent，那么这个对话框就会弹出，用户进行操作后返回行距的文件或者文件夹，比如写一封邮件如果想同时发送一个附件的时候，就会发起一个Intent，然后我们的选择文件对话框会弹出，让用户来选择文件。
这个文件对话框大约长下面这个样子（图标是不是很熟悉，这是直接取的ES文件浏览器的图标），它可以实现文件、文件夹的单选、多选、混选，当用户点击确定时，返回一个ArrayList
下面是如何写这个文件对话框。
首先我们需要一个，一个Dialog需要一个view来显示，也就是我们看到的。我们给它起名FileDialogView。很显然它需要两个Button用于确定取消，一个ImageButton用于返回上级，多选的话还要再加一个【全部选择、全部取消】的CheckBox（上图为单选文件夹的示例，所以没有出现）.一个EditText用于显示当前路径、以及最重要的——ListView以及它的adapter，我们叫这个adapter为FileListAdapter。
下面是这个FileDialogView的代码（这个项目不难，代码里面的注释应该足够清楚了……）。
/**
* FileDialog的view
*
* @author NashLegend
*/
public class FileDialogView extends FrameLayout implements OnClickListener,
OnCheckedChangeListener {
private FileListAdapter adapter;
private ListView listView;//文件列表
private EditText pathText;//当前路径
private ImageButton backButton;//返回上级按钮
private CheckBox selectAllButton;//全选按钮
private int fileMode = FileDialog.FILE_MODE_OPEN_MULTI;//选择文件方式，默认为文件、文件夹混选
private String initialPath = "/";//用来指定刚打开时的目录，默认为根目录
private Button cancelButton;
private Button okButton;
public FileDialogView(Context context) {
super(context);
initView(context);
}
public FileDialogView(Context context, AttributeSet attrs) {
super(context, attrs);
initView(context);
}
public FileDialogView(Context context, AttributeSet attrs, int defStyle) {
super(context, attrs, defStyle);
initView(context);
}
/**
* 初始化view
*/
private void initView(Context context) {
LayoutInflater inflater = (LayoutInflater) context
.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
inflater.inflate(R.layout.dialog_file, this);
listView = (ListView) findViewById(R.id.listview_dialog_file);
pathText = (EditText) findViewById(R.id.edittext_dialog_file_path);
backButton = (ImageButton) findViewById(R.id.p_w_picpathbutton_dialog_file_back);
selectAllButton = (CheckBox) findViewById(R.id.checkbox_dialog_file_all);
cancelButton = (Button) findViewById(R.id.button_dialog_file_cancel);
okButton = (Button) findViewById(R.id.button_dialog_file_ok);
backButton.setOnClickListener(this);
cancelButton.setOnClickListener(this);
okButton.setOnClickListener(this);
selectAllButton.setOnCheckedChangeListener(this);
pathText.setKeyListener(null);//不需要弹起键盘
adapter = new FileListAdapter(context);
adapter.setDialogView(this);
listView.setAdapter(adapter);
}
/**
* 打开目录
*
* @param file 要打开的文件夹
*
*/
public void openFolder(File file) {
if (!file.exists() || !file.isDirectory()) {
// 若不存在此目录，则打开SD卡根目录
file = Environment.getExternalStorageDirectory();
}
//openFolder用来读取文件列表详见FileListAdapter的代码
adapter.openFolder(file);
}
/**
* 打开目录
*
* @param path
* 要打开的文件夹路径
*/
public void openFolder(String path) {
openFolder(new File(path));
}
/**
* 打开初始目录
*/
public void openFolder() {
openFolder(initialPath);
}
/**
* 返回上级目录
*/
private void back2ParentLevel() {
File file = adapter.getCurrentDirectory();
// 如果当前目录不为空且父目录不为空，则打开父目录
if (file != null && file.getParentFile() != null) {
openFolder(file.getParentFile());
}
}
/**
* 选中当前目录所有文件
*/
private void selectAll() {
adapter.selectAll();
}
/**
* 取消选中当前目录所有文件
*/
private void unselectAll() {
adapter.unselectAll();
}
public void unselectCheckBox() {
selectAllButton.setOnCheckedChangeListener(null);
selectAllButton.setChecked(false);
selectAllButton.setOnCheckedChangeListener(this);
}
/**
* @return 返回选中的文件列表
*/
public ArrayList getSelectedFiles() {
ArrayList list = new ArrayList();
if (adapter.getSelectedFiles().size() > 0) {
list = adapter.getSelectedFiles();
} else {
//如果点击确定的时候没有选择文件并且模式是选择单个文件夹，那么就返回当前目录
if (fileMode == FileDialog.FILE_MODE_OPEN_FOLDER_SINGLE) {
list.add(adapter.getCurrentDirectory());
}
}
return list;
}
@Override
public void onClick(View v) {
int id = v.getId();
if (id == R.id.p_w_picpathbutton_dialog_file_back) {
back2ParentLevel();
}
}
public EditText getPathText() {
return pathText;
}
public int getFileMode() {
return fileMode;
}
public void setFileMode(int fileMode) {
this.fileMode = fileMode;
if (fileMode > FileDialog.FILE_MODE_OPEN_FILE_MULTI) {
// 单选模式应该看不到全选按钮才对
selectAllButton.setVisibility(View.GONE);
} else {
selectAllButton.setVisibility(View.VISIBLE);
}
}
public String getInitialPath() {
return initialPath;
}
public void setInitialPath(String initialPath) {
this.initialPath = initialPath;
}
@Override
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
if (selectAllButton.isChecked()) {
selectAll();
} else {
unselectAll();
}
}
public CheckBox getSelectAllButton() {
return selectAllButton;
}
} FileDialogView代码并不多，只负责了构建界面的任务。
下面是FileListAdapter的代码，FileListAdapter负责读取文件夹、全选、反选、排序、返回选中文件，数据对象为FileItem：
package com.example.legendutils.BuildIn;
import java.io.File;
import java.util.ArrayList;
import java.util.Collections;
import java.util.Comparator;
import java.util.Iterator;
import com.example.legendutils.Dialogs.FileDialog;
import android.annotation.SuppressLint;
import android.content.Context;
import android.text.TextUtils;
import android.util.Log;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
public class FileListAdapter extends BaseAdapter {
private ArrayList list = new ArrayList();
private Context mContext;
private File currentDirectory;
private FileDialogView dialogView;
public FileListAdapter(Context Context) {
mContext = Context;
}
@Override
public int getCount() {
return list.size();
}
@Override
public Object getItem(int position) {
return list.get(position);
}
@Override
public long getItemId(int position) {
return position;
}
@Override
public View getView(int position, View convertView, ViewGroup parent) {
ViewHolder holder = null;
if (convertView == null) {
holder = new ViewHolder();
convertView = new FileItemView(mContext);
holder.fileItemView = (FileItemView) convertView;
convertView.setTag(holder);
} else {
holder = (ViewHolder) convertView.getTag();
}
holder.fileItemView.setFileItem(list.get(position), this,
dialogView.getFileMode());
return holder.fileItemView;
}
class ViewHolder {
FileItemView fileItemView;
}
public ArrayList getList() {
return list;
}
public void setList(ArrayList list) {
this.list = list;
}
/**
* 打开文件夹，更新文件列表
*
* @param file
*/
public void openFolder(File file) {
if (file != null && file.exists() && file.isDirectory()) {
if (!file.equals(currentDirectory)) {
// 与当前目录不同
currentDirectory = file;
list.clear();
File[] files = file.listFiles();
if (files != null) {
for (int i = 0; i < files.length; i++) {
File tmpFile = files[i];
if (tmpFile.isFile()
&& (dialogView.getFileMode() == FileDialog.FILE_MODE_OPEN_FOLDER_MULTI || dialogView
.getFileMode() == FileDialog.FILE_MODE_OPEN_FOLDER_SINGLE)) {
//如果只能选择文件夹并且当前文件不是文件夹，那则跳过
continue;
}
list.add(new FileItem(files[i]));
}
}
files = null;
sortList();
notifyDataSetChanged();
}
}
//改变FileDialogView的当前路径显示
dialogView.getPathText().setText(file.getAbsolutePath());
}
/**
* 选择当前目录下所有文件
*/
public void selectAll() {
int mode = dialogView.getFileMode();
if (mode > FileDialog.FILE_MODE_OPEN_FILE_MULTI) {
// 这个if不会发生，我为啥要写……
return;
}
for (Iterator iterator = list.iterator(); iterator.hasNext();) {
FileItem fileItem = (FileItem) iterator.next();
if (mode == FileDialog.FILE_MODE_OPEN_FILE_MULTI
&& fileItem.isDirectory()) {
// fileItem是目录，但是只能选择文件，则跳过
continue;
}
if (mode == FileDialog.FILE_MODE_OPEN_FOLDER_MULTI
&& !fileItem.isDirectory()) {
// fileItem是文件，但是只能选择目录，则跳过
continue;
}
fileItem.setSelected(true);
}
notifyDataSetChanged();
}
/**
* 取消所有文件的选中状态
*/
public void unselectAll() {
for (Iterator iterator = list.iterator(); iterator.hasNext();) {
FileItem fileItem = (FileItem) iterator.next();
fileItem.setSelected(false);
}
notifyDataSetChanged();
}
/**
* 选中一个文件，只在选中时调用，取消选中不调用，且只由FileItemView调用
*
* @param fileItem
*/
public void selectOne(FileItem fileItem) {
int mode = dialogView.getFileMode();
if (mode > FileDialog.FILE_MODE_OPEN_FILE_MULTI) {
// 如果是单选
if (mode == FileDialog.FILE_MODE_OPEN_FILE_SINGLE
&& fileItem.isDirectory()) {
// fileItem是目录，但是只能选择文件，则返回
return;
}
if (mode == FileDialog.FILE_MODE_OPEN_FOLDER_SINGLE
&& !fileItem.isDirectory()) {
// fileItem是文件，但是只能选择目录，则返回
return;
}
for (Iterator iterator = list.iterator(); iterator
.hasNext();) {
FileItem tmpItem = (FileItem) iterator.next();
if (tmpItem.equals(fileItem)) {
tmpItem.setSelected(true);
} else {
tmpItem.setSelected(false);
}
}
} else {
// 如果是多选
if (mode == FileDialog.FILE_MODE_OPEN_FILE_MULTI
&& fileItem.isDirectory()) {
// fileItem是目录，但是只能选择文件，则返回
return;
}
if (mode == FileDialog.FILE_MODE_OPEN_FOLDER_MULTI
&& !fileItem.isDirectory()) {
// fileItem是文件，但是只能选择目录，则返回
return;
}
fileItem.setSelected(true);
}
notifyDataSetChanged();
}
public void sortList() {
FileItemComparator comparator = new FileItemComparator();
Collections.sort(list, comparator);
}
/**
* 取消一个的选择，其他逻辑都在FileItemView里面
*/
public void unselectOne() {
dialogView.unselectCheckBox();
}
/**
* @return 选中的文件列表
*/
public ArrayList getSelectedFiles() {
ArrayList selectedFiles = new ArrayList();
for (Iterator iterator = list.iterator(); iterator.hasNext();) {
FileItem file = iterator.next();// 强制转换为File
if (file.isSelected()) {
selectedFiles.add(file);
}
}
return selectedFiles;
}
public class FileItemComparator implements Comparator {
@Override
public int compare(FileItem lhs, FileItem rhs) {
if (lhs.isDirectory() != rhs.isDirectory()) {
// 如果一个是文件，一个是文件夹，优先按照类型排序
if (lhs.isDirectory()) {
return -1;
} else {
return 1;
}
} else {
// 如果同是文件夹或者文件，则按名称排序
return lhs.getName().toLowerCase().compareTo(rhs.getName().toLowerCase());
}
}
}
public File getCurrentDirectory() {
return currentDirectory;
}
public FileDialogView getDialogView() {
return dialogView;
}
public void setDialogView(FileDialogView dialogView) {
this.dialogView = dialogView;
}
} 下面是FileItemView，它是ListView的元素，用来显示每一个文件。数据对象为FileItem
/**
* 文件列表单个item的view
*
* @author NashLegend
*/
public class FileItemView extends FrameLayout implements OnClickListener,
OnCheckedChangeListener {
private ImageView icon;//文件图标
private TextView title;//文件名
private CheckBox checkBox;//选择按钮
private ViewGroup rootFileItemView;//FileItemView的xml文件的根view
private FileListAdapter adapter;
private int fileMode = FileDialog.FILE_MODE_OPEN_MULTI;
private boolean selectable = true;
private FileItem fileItem;
public FileItemView(Context context) {
super(context);
LayoutInflater inflater = (LayoutInflater) context
.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
inflater.inflate(R.layout.view_file_item, this);
icon = (ImageView) findViewById(R.id.p_w_picpath_file_icon);
title = (TextView) findViewById(R.id.text_file_title);
rootFileItemView = (ViewGroup) findViewById(R.id.rootFileItemView);
checkBox = (CheckBox) findViewById(R.id.checkbox_file_item_select);
setOnClickListener(this);
}
public FileItem getFileItem() {
return fileItem;
}
public void setFileItem(FileItem fileItem, FileListAdapter adapter,
int fileMode) {
this.fileItem = fileItem;
this.adapter = adapter;
this.fileMode = fileMode;
icon.setImageResource(fileItem.getIcon());
title.setText(fileItem.getName());
toggleSelectState();
if (!fileItem.isDirectory()
&& (fileMode == FileDialog.FILE_MODE_OPEN_FOLDER_MULTI || fileMode == FileDialog.FILE_MODE_OPEN_FOLDER_SINGLE)) {
//如果选择模式与当前文件类型不符，则设计为不可选择，比如在只可选择文件平时，文件不可选
checkBox.setEnabled(false);
selectable = false;
checkBox.setOnCheckedChangeListener(null);
return;
}
if (fileItem.isDirectory()
&& (fileMode == FileDialog.FILE_MODE_OPEN_FILE_MULTI || fileMode == FileDialog.FILE_MODE_OPEN_FILE_SINGLE)) {
//如果选择模式与当前文件类型不符，则设计为不可选择，比如在只可选择文件时，文件夹不可选
checkBox.setEnabled(false);
selectable = false;
checkBox.setOnCheckedChangeListener(null);
return;
}
selectable = true;
checkBox.setEnabled(true);
checkBox.setOnCheckedChangeListener(this);
}
/**
* 切换选中、未选中状态,fileItem.setSelected(boolean)先发生;
*/
public void toggleSelectState() {
if (fileItem.isSelected()) {
rootFileItemView
.setBackgroundResource(R.drawable.bg_file_item_select);
} else {
rootFileItemView
.setBackgroundResource(R.drawable.bg_file_item_normal);
}
checkBox.setOnCheckedChangeListener(null);
checkBox.setChecked(fileItem.isSelected());
checkBox.setOnCheckedChangeListener(this);
}
@Override
public void onClick(View v) {
if (v.getId() != R.id.checkbox_file_item_select) {
//被点击时，如果是文件夹则打开文件夹，如果是文件则选中文件
if (fileItem.isDirectory()) {
openFolder();
} else {
// 选中一个
selectOne();
}
}
}
public void selectOne() {//选中一个文件(夹)
if (selectable) {
if (fileItem.isSelected()) {
// 取消选中状态，只在FileItemView就可以
fileItem.setSelected(!fileItem.isSelected());
toggleSelectState();
adapter.unselectOne();
} else {
// 如果要选中某个FileItem，则必须要在adapter里面进行，因为如果是单选的话，还要取消其他的选中状态
adapter.selectOne(fileItem);
}
}
}
/**
* 打开文件夹
*/
public void openFolder() {
adapter.openFolder(fileItem);
}
public FileListAdapter getAdapter() {
return adapter;
}
@Override
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
if (isChecked) {
adapter.selectOne(fileItem);
} else {
fileItem.setSelected(false);
rootFileItemView
.setBackgroundResource(R.drawable.bg_file_item_normal);
adapter.unselectOne();
}
}
public int getFileMode() {
return fileMode;
}
}上面所使用的数据对象FileItem其实很简单，只是一个继承了File，并仅仅多了icon字段和selected字段的类。这里不写出来了，详见上面的地址。
现在有了View，只要把它放到Dialog里就可以了，Dialog很简单了，我们仍然依照系统的Dialog写一个Builder以方便使用。代码如下：
public class FileDialog extends Dialog {
/**
* 以打开文件模式打开文件对话框，有可能是文件夹也有可能是文件,可多选，最终返回值为一个File对象列表。
*/
public static final int FILE_MODE_OPEN_MULTI = 0;
/**
* 以打开文件模式打开文件对话框，只能选择文件夹而不是文件，可多选，最终返回值为一个File对象列表。
*/
public static final int FILE_MODE_OPEN_FOLDER_MULTI = 1;
/**
* 以打开文件模式打开文件对话框，只能选择文件而不是文件夹，可多选，最终返回值为一个File对象列表。
*/
public static final int FILE_MODE_OPEN_FILE_MULTI = 2;
/**
* 以打开文件模式打开文件对话框，有可能是文件夹也有可能是文件,最终返回值为一个长度为1的File对象列表。
*/
public static final int FILE_MODE_OPEN_SINGLE = 3;
/**
* 以打开文件模式打开文件对话框，只能选择文件夹而不是文件，最终返回值为一个长度为1的File对象列表。
*/
public static final int FILE_MODE_OPEN_FOLDER_SINGLE = 4;
/**
* 以打开文件模式打开文件对话框，只能选择文件而不是文件夹，最终返回值为一个长度为1的File对象列表。
*/
public static final int FILE_MODE_OPEN_FILE_SINGLE = 5;
public FileDialog(Context context) {
super(context);
}
public FileDialog(Context context, int theme) {
super(context, theme);
}
public FileDialog(Context context, boolean cancelable,
OnCancelListener cancelListener) {
super(context, cancelable, cancelListener);
}
public interface FileDialogListener {
public void onFileSelected(ArrayList files);
public void onFileCanceled();
}
public static class Builder {
private int fileMode = FileDialog.FILE_MODE_OPEN_MULTI;
private String initialPath = Environment.getExternalStorageDirectory()
.getAbsolutePath();
private FileDialogListener fileSelectListener;
private FileDialogView dialogView;
private Context context;
private boolean canceledOnTouchOutside = true;
private boolean cancelable = true;
private String title = "选择文件";
public Builder(Context context) {
this.context = context;
}
public Builder setCanceledOnTouchOutside(boolean flag) {
canceledOnTouchOutside = flag;
return this;
}
public Builder setCancelable(boolean flag) {
cancelable = flag;
return this;
}
public Builder setFileMode(int fileMode) {
this.fileMode = fileMode;
return this;
}
public Builder setInitialPath(String initialPath) {
this.initialPath = initialPath;
return this;
}
public Builder setTitle(String title) {
this.title = title;
return this;
}
public Builder setFileSelectListener(
FileDialogListener fileSelectListener) {
this.fileSelectListener = fileSelectListener;
return this;
}
/**
* 必须强制设置dialog的大小，因为ListView大小必须确定，否则ListView的Adapter的getView会执行很多遍,
* 次数取决于listview最终能显示多少项。
*
* @return
*/
public FileDialog create(int width, int height) {
final FileDialog dialog = new FileDialog(context);
dialogView = new FileDialogView(context);
dialogView.setFileMode(fileMode);
dialogView.setInitialPath(initialPath);
dialogView.openFolder();
dialog.setTitle(title);
dialog.setCancelable(cancelable);
dialog.setCanceledOnTouchOutside(canceledOnTouchOutside);
dialog.setContentView(dialogView, new LayoutParams(
LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT));
if (width > 0 && height > 0) {
dialog.getWindow().setLayout(width, height);
}
Button okButton = (Button) dialogView
.findViewById(R.id.button_dialog_file_ok);
Button cancelButton = (Button) dialogView
.findViewById(R.id.button_dialog_file_cancel);
okButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 点击确定按钮，返回文件列表
if (fileSelectListener != null) {
if (dialogView.getSelectedFiles().size() > 0) {
fileSelectListener.onFileSelected(dialogView
.getSelectedFiles());
} else {
fileSelectListener.onFileCanceled();
}
}
dialog.dismiss();
}
});
cancelButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
//点击取消按钮，直接dismiss
if (fileSelectListener != null) {
fileSelectListener.onFileCanceled();
}
dialog.dismiss();
}
});
return dialog;
}
/**
* 使得FileDialog大小和activity一样,在Activity创建完成之前，返回的数字可能不对
*
* @param activity
* @return
*/
public FileDialog create(Activity activity) {
//下面这两个方法是获得窗口的宽高，方法不在这里贴出了，详情见上面给出的项目地址
int width = DisplayUtil.getWindowWidth(activity);
int height = DisplayUtil.getWindowHeight(activity);
return create(width, height);
}
}
} 如何使用它：
FileDialog dialog = new FileDialog.Builder(getActivity())
.setFileMode(FileDialog.FILE_MODE_OPEN_FOLDER_SINGLE)
.setCancelable(true).setCanceledOnTouchOutside(false)
.setTitle("selectFolder")
.setFileSelectListener(new FileDialogListener() {
@Override
public void onFileSelected(ArrayList files) {
if (files.size() > 0) {
copy2Folder(getSelectedFiles(), files.get(0));
}
}
@Override
public void onFileCanceled() {
ToastUtil.showToast(getActivity(), "Copy Cancelled!");
}
}).create(getActivity());
dialog.show(); 至于第二种接收系统通知其实在同小异，核心代码都跟上面一样，唯一的区别是，它其实是一个Activity，我们叫它PickerActivity，使用了FileDialogView的Activity，而上面的是Dialog……
要接收打开文件的Intent，要在AndroidMenifest.xml的这个Activity节点***册IntentFilter。如下：