這篇文章分享我的 Android 開發（入門）課程 的最后一個實戰項目：貨物清單應用。這個項目托管在我的 GitHub 上，具體是 InventoryApp Repository，項目介紹已詳細寫在 README 上，歡迎大家 star 和 fork。

這個實戰項目的主要目的是練習在 Android 中使用 SQLite 數據庫。與 實戰項目 9: 習慣記錄應用 直接在 Activity 中操作數據庫的做法不同，InventoryApp 采用了更符合 Android 設計規范的框架，即

• 數據庫端
  （1）使用 Contract 類定義數據庫相關的常量，如 Content URI 及其 MIME 類型、數據庫的表格名稱以及各列名稱。
  （2）使用自定義 SQLiteOpenHelper 類管理數據庫，如新建數據庫表格、升級數據庫架構。
  （3）使用自定義 ContentProvider 類實現數據庫的 CRUD 操作，其中包括對數據庫更新和插入數據時的數據校驗。
• UI 端
  通過 ContentResolver 對數據庫實現插入、更新、刪除數據的交互，而讀取數據通過 CursorLoader 在后臺線程實現。

由此可見，InventoryApp 的數據庫框架與課程中介紹的相同，所以這部分內容不再贅述，詳情可參考相關的學習筆記，如《課程 3: Content Providers 簡介》。值得一提的是，InventoryApp 的數據庫需要存儲圖片，但是沒有將圖片數據直接存入數據庫（如將圖片轉換為 byte[] 以 BLOB 原樣存入數據庫），而是存儲了圖片的 URI，這樣極大地降低了數據庫的體積，同時也減輕了應用處理數據的負擔。

除此之外，InventoryApp 還使用了很多其它有意思的 Android 組件，這篇文章按例分享給大家，希望對大家有幫助，歡迎互相交流。為了精簡篇幅，文中的代碼有刪減，請以 GitHub 中的代碼為準。

關鍵詞：RecyclerView & CursorLoader、Glide、Runtime Permissions、DialogFragment、通過相機應用拍攝照片以及在相冊中選取圖片、FileProvider、AsyncTask、Intent to Email with Attachment、InputFilter、RegEx、禁止設備屏幕旋轉、Drawable Resources、FloatingActionButton

RecyclerView 從 CursorLoader 接收數據以填充列表

雖然課程中介紹的 ListView 和 GridView 能夠輕松地與 CursorLoader 配合顯示列表，但是 RecyclerView 作為 ListView 的升級版，它是一個更靈活的 Android 組件，尤其是在列表的子項需要加載的數據量較大或者子項的數據需要頻繁更新的時候，RecyclerView 更適合這種應用場景。例如在 實戰項目 7&8 : 從 Web API 獲取數據 中，BookListing App 實現了可擴展 CardView 效果的 RecyclerView 列表，如下圖所示。

RecyclerView 的使用教程可以參考 這個 Android Developers 文檔。在 InventoryApp 中，首先在 CatalogActivity 中創建一個 RecyclerView 對象，并進行初始化設置，在這里主要是通過 setLayoutManager 將列表的布局模式設置為兩列的、交錯分布的垂直列表。其中，這種交錯網格布局 (StaggeredGridLayout) 也是 InventoryApp 使用 RecyclerView 的一個原因；GridView 默認情況下只能顯示對齊的網格，當子項之間的尺寸（寬或高）不同時，會以最大的那個對齊，這樣就會產生不必要的空隙。

In CatalogActivity.java

@Override protected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_catalog);RecyclerView recyclerView = findViewById(R.id.list);recyclerView.setLayoutManager(new StaggeredGridLayoutManager(2, StaggeredGridLayoutManager.VERTICAL));mAdapter = new InventoryAdapter(this, null);recyclerView.setAdapter(mAdapter);... } 復制代碼

當然，RecyclerView 同樣采用適配器模式向列表填充數據，而且業務邏輯與 CursorAdapter 類似：首先通過 onCreateViewHolder 創建新的子項視圖，隨后通過 onBindViewHolder 將數據填充到視圖中；視圖回收時則直接通過 onBindViewHolder 將數據填充到回收的視圖中。不同的是，RecyclerView 列表的子項布局需要由自定義 RecyclerView.ViewHolder 類提供，具體的應用流程是

首先在 onCreateViewHolder 中根據子項布局創建一個自定義 ViewHolder 對象。

然后將自定義 ViewHolder 對象傳遞至 onBindViewHolder 對相應位置的子項進行數據填充。

因此，在 InventoryApp 中的 RecyclerView 適配器自定義為 InventoryAdapter，注意類名后的 extends 參數為 RecyclerView.Adapter，其泛型參數為 VH，即自定義的 RecyclerView.ViewHolder，在這里作為適配器的內部類實現。

In InventoryAdapter.java

public class InventoryAdapter extends RecyclerView.Adapter<InventoryAdapter.MyViewHolder> {private Cursor mCursor;private Context mContext;public InventoryAdapter(Context context, Cursor cursor) {mContext = context;mCursor = cursor;}@Overridepublic int getItemCount() {if (mCursor == null) {return 0;} else {return mCursor.getCount();}}public class MyViewHolder extends RecyclerView.ViewHolder {private ImageView imageView;private TextView nameTextView, priceTextView, quantityTextView;private FloatingActionButton fab;private MyViewHolder(View view) {super(view);imageView = view.findViewById(R.id.item_image);nameTextView = view.findViewById(R.id.item_name);priceTextView = view.findViewById(R.id.item_price);quantityTextView = view.findViewById(R.id.item_quantity);fab = view.findViewById(R.id.fab_sell);}}... } 復制代碼

首先定義 InventoryAdapter 的構造函數，輸入參數分別為 Context 和 Cursor 對象，其中 Cursor 包含了列表需要顯示的內容，它定義為一個全局變量，使其能由 getItemCount 等方法利用。當初始化或重置適配器時，Cursor 可傳入 null 表示列表無數據顯示，適配器不會出錯。

然后實現自定義 RecyclerView.ViewHolder 類，名為 MyViewHolder，其構造函數根據傳入的 View 對象（通常是根據 Layout 生成）找到需要填充數據的視圖，注意這些視圖需要聲明為內部類 MyViewHolder 的全局變量；另外在構造函數內不要忘記調用超級類，輸入參數為傳入的 View 對象。

有了上述基礎，InventoryAdapter 就可以根據自定義 ViewHolder 對象實現列表的數據填充了。首先在 onCreateViewHolder 中通過 LayoutInflater 根據列表子項的布局文件生成一個 View 對象，然后創建一個 MyViewHolder 對象，輸入參數即生成的 View 對象，最后返回該 MyViewHolder 對象。

In InventoryAdapter.java

@NonNull @Override public InventoryAdapter.MyViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {View itemView = LayoutInflater.from(parent.getContext()).inflate(R.layout.list_item, parent, false);MyViewHolder myViewHolder = new MyViewHolder(itemView);return myViewHolder; } 復制代碼

然后在 onBindViewHolder 中根據傳入的 MyViewHolder 對象以及 Cursor 進行數據填充。注意在進行任何操作之前，需要將 Cursor 的位置移到當前位置上。

In InventoryAdapter.java

@Override public void onBindViewHolder(@NonNull final InventoryAdapter.MyViewHolder holder, int position) {if (mCursor.moveToPosition(position)) {...GlideApp.with(mContext).load(imageUriString).transforms(new CenterCrop(), new RoundedCorners((int) mContext.getResources().getDimension(R.dimen.background_corner_radius))).into(holder.imageView);...} } 復制代碼

至此，RecyclerView 的適配器基本框架就已經實現了。不過在 InventoryApp 中的實際應用中，還有幾個需要注意的點。

一、Glide

對于 Android 來說，在列表中顯示多張圖片是一項既耗時又耗性能的工作，是否需要而又如何將讀取圖片資源、根據視圖大小裁剪圖片等工作放入后臺線程，這是 InventoryApp 在開發過程中踩過的大坑。在查閱 這篇 Android Developers 文檔 后，才了解到絕大多數情況下，Glide 庫 都能僅用一行代碼就完美地實現圖片抓取、解碼、顯示，它甚至支持 GIF 動圖以及視頻快照。

在 InventoryApp 中，使用了 Glide 目前最新的 v4 版本（已穩定，v3 版本已不維護）的 Generated API ，主要原因是需要利用 Glide 的 多重變換 設置圖片 centerCrop 的裁剪模式以及四周圓角 (RoundedCorners)。Glide 的文檔非常豐富，上手非常簡單，所以這里不再贅述。

二、swapCursor

由于在 InventoryApp 中 RecyclerView 需要從 CursorLoader 接收數據，在 onLoadFinished 和 onLoaderReset 需要調用適配器的 swapCursor 方法，而 RecyclerView 沒有提供類似 ListView 的相應方法，所以需要在適配器中自己實現。

In InventoryAdapter.java

public void swapCursor(Cursor cursor) {mCursor = cursor;notifyDataSetChanged(); } 復制代碼

在這里，swapCursor 方法的輸入參數為一個 Cursor 對象；在方法內，更新適配器內的 Cursor 全局變量，完成后通知適配器列表的數據集發生了變化。

三、列表子項的點擊事件監聽器

在 onCreateViewHolder 中生成的 View 對象表示每一個列表子項，對其設置 OnClickListener 就可以響應列表子項的點擊事件。

In InventoryAdapter.java

@NonNull @Override public InventoryAdapter.MyViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {View itemView = LayoutInflater.from(parent.getContext()).inflate(R.layout.list_item, parent, false);final MyViewHolder myViewHolder = new MyViewHolder(itemView);// Setup each item listener here.itemView.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View view) {int position = myViewHolder.getAdapterPosition();if (mOnItemClickListener != null) {// Send the click event back to the host activity.mOnItemClickListener.onItemClick(view, position, getItemId(position));}}});return myViewHolder; }public long getItemId(int position) {if (mCursor != null) {if (mCursor.moveToPosition(position)) {int idColumnIndex = mCursor.getColumnIndex(InventoryEntry._ID);return mCursor.getLong(idColumnIndex);}}return 0; } 復制代碼

首先調用 MyViewHolder 的 getAdapterPosition() 方法獲取當前子項的位置。

然后調用 OnItemClickListener 的 onItemClick 方法，表示在使用 RecyclerView 的 CatalogActivity 中對列表子項的點擊事件進行響應，輸入參數包括當前子項的位置及其在數據庫中的 ID，其中 ID 通過 getItemId 方法查詢 Cursor 的相應鍵獲得。

在 InventoryApp 中，RecyclerView 列表的每一個子項的被點擊時的動作是由 CatalogActivity 跳轉到 DetailActivity 中，這里要用到 Intent 組件，所以在 CatalogActivity 中響應列表子項的點擊事件比較合理。不過 RecyclerView.Adapter 沒有默認的子項點擊事件監聽器，所以這里需要自己實現。

In InventoryAdapter.java

private OnItemClickListener mOnItemClickListener;public void setOnItemClickListener(OnItemClickListener onItemClickListener) {mOnItemClickListener = onItemClickListener; }public interface OnItemClickListener {void onItemClick(View view, int position, long id); } 復制代碼

首先定義一個接口 (interface)，名為 OnItemClickListener，里面放置一個 onItemClick 方法，表示 Activity 或 Fragment 在實例化這個接口時必須實現該方法。

然后將 OnItemClickListener 接口定義為一個全局變量，使其在適配器內可被其它方法應用。

最后定義一個 setOnItemClickListener 方法，將 OnItemClickListener 接口的實例化對象作為輸入參數，并且在方法內將傳入的 OnItemClickListener 對象賦給上述的全局變量，在這里即把 Activity 或 Fragment 實現的 OnItemClickListener 接口的實例化對象傳入適配器。

這種代碼結構體現了典型的 Java 繼承特性。在 CatalogActivity 中實現 RecyclerView 列表子項的點擊事件響應代碼如下，可見 RecyclerView 的適配器調用 setOnItemClickListener 方法，傳入一個新的 OnItemClickListener 對象，并在其中實現 onItemClick 方法。代碼結構與 ListView 的 AdapterView.OnItemClickListener 相同。

In CatalogActivity.java

@Override protected void onCreate(Bundle savedInstanceState) {...mAdapter.setOnItemClickListener(new InventoryAdapter.OnItemClickListener() {@Overridepublic void onItemClick(View view, int position, long id) {Intent intent = new Intent(CatalogActivity.this, DetailActivity.class);Uri currentItemUri = ContentUris.withAppendedId(InventoryEntry.CONTENT_URI, id);intent.setData(currentItemUri);startActivity(intent);}}); } 復制代碼

四、Empty View

為 RecyclerView 列表添加一個空視圖是提升用戶體驗的必要之舉，由于 RecyclerView 從 CursorLoader 接收數據，所以可以利用 CursorLoader 在加載數據完畢后的 onLoadFinished 方法中判斷列表的狀態，如果列表為空，則顯示空視圖；如果列表中有數據，則消除空視圖。

In CatalogActivity.java

@Override public void onLoadFinished(Loader<Cursor> loader, Cursor data) {mAdapter.swapCursor(data);View emptyView = findViewById(R.id.empty_view);if (mAdapter.getItemCount() == 0) {emptyView.setVisibility(View.VISIBLE);} else {emptyView.setVisibility(View.GONE);} } 復制代碼

運行時權限請求

在 InventoryApp 中包含讀寫圖片文件的操作，這涉及了 Android 危險權限，所以應用需要請求 STORAGE 這一個權限組，以獲得讀寫外部存儲器中的文件的權限。關于 Android 權限的更多介紹可參考《課程 2: HTTP 網絡》。

因此，首先在 AndroidManifest 中添加 參數，放在頂級元素 下面。在這里，只添加了一條 WRITE_EXTERNAL_STORAGE 參數，而沒有添加 READ_EXTERNAL_STORAGE 參數。這是因為兩者屬于同一個權限組，應用獲得前者的寫權限時會自動獲取后者的讀權限。

In AndroidManifest.xml

<manifest xmlns:android="http://schemas.android.com/apk/res/android"package="com.example.android.inventoryapp"><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /><application ...>...</application> </manifest> 復制代碼

Note:
從 Android 4.4 KitKat (API level 19) 開始，應用通過 getExternalFilesDir(String) 與 getExternalCacheDir() 讀寫應用自身目錄下（僅應用本身可見）的文件時，不需要請求 STORAGE 權限組。

至此，對于運行在 Android 5.1 (API level 22) 或以下的設備，InventoryApp 在安裝時 (Install Time)，就會彈出對話框，顯示應用請求的 STORAGE 權限組，用戶必須同意該權限請求，否則無法安裝應用。而對于運行在 Android 6.0 (API level 23) 或以上的設備，需要在 InventoryApp 運行時 (Runtime)，彈出對話框請求 STORAGE 權限組；如果應用沒有相關的代碼處理運行時權限請求，那么默認不具有該權限。

因此，應用需要在恰當的時機向用戶請求權限。由于 InventoryApp 所需的 STORAGE 權限組僅在進行圖片相關的操作時涉及到，所以在 DetailActivity 中處理圖片的唯一入口處設置 OnClickListener 來處理運行時權限請求。

In DetailActivity.java

@Override protected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_detail);...View imageContainer = findViewById(R.id.item_image_container);imageContainer.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {// Check permission before anything happens.if (hasPermissionExternalStorage()) {// Permission has already been granted, then start the dialog fragment.startImageChooserDialogFragment();}}}); } 復制代碼

當圖片編輯框被點擊時，監聽器內會調用一個輔助方法，判斷是否已獲得所需的權限，若是則返回 true，才進行下面的工作。值得注意的是，InventoryApp 在每一次圖片編輯框被點擊時都必須檢查是否已獲得所需的權限，因為從 Android 6.0 Marshmallow (API level 23) 開始，用戶可隨時撤回給予應用的權限。

In DetailActivity.java

private boolean hasPermissionExternalStorage() {if (ContextCompat.checkSelfPermission(getApplicationContext(),Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {// Permission is NOT granted.if (ActivityCompat.shouldShowRequestPermissionRationale(DetailActivity.this,Manifest.permission.WRITE_EXTERNAL_STORAGE)) {// Show an explanation with snack bar to user if needed.Snackbar snackbar = Snackbar.make(findViewById(R.id.editor_container),R.string.permission_required, Snackbar.LENGTH_LONG);// Prompt user a OK button to request permission.snackbar.setAction(android.R.string.ok, new View.OnClickListener() {@Overridepublic void onClick(View v) {// Request the permission.ActivityCompat.requestPermissions(DetailActivity.this,new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},PERMISSION_REQUEST_EXTERNAL_STORAGE);}});snackbar.show();} else {// Request the permission directly, if it doesn't need to explain.ActivityCompat.requestPermissions(DetailActivity.this,new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},PERMISSION_REQUEST_EXTERNAL_STORAGE);}return false;} else {// Permission has already been granted, then return true.return true;} } 復制代碼

在輔助方法 hasPermissionExternalStorage 中，首先判斷應用是否已獲得 WRITE_EXTERNAL_STORAGE 權限，若是則返回 true。

如果應用尚未獲得需要的權限，那么首先通過 ActivityCompat 的 shouldShowRequestPermissionRationale 方法判斷是否需要向用戶顯示請求該權限的理由，若不需要則直接通過 ActivityCompat 的 requestPermissions 方法請求權限，其中輸入參數依次為
（1）activity: 請求權限的當前 Activity，在這里即 DetailActivity。
（2）permissions: 需要請求的權限列表，作為一個字符串列表對象傳入，不能為空。
（3）requestCode: 該權限請求的唯一標識符，通常定義為一個全局的整數常量，它在接收權限請求的結果時會用到。

如果用戶之前拒絕過權限請求，那么 shouldShowRequestPermissionRationale 方法會返回 true，表示需要向用戶顯示請求該權限的理由，并異步處理權限請求。在這里，通過彈出一個 Snackbar 顯示請求該權限的理由，并提供一個 OK 按鈕，用戶點擊后會通過 ActivityCompat 的 requestPermissions 方法請求權限，此時應用會彈出一個標準的（應用無法配置或改變）對話框供用戶選擇是否同意該權限請求。

應用發起權限請求后，用戶的選擇會通過 onRequestPermissionsResult 方法獲取，在這里響應不同的請求結果。

In DetailActivity.java

@Override public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions,@NonNull int[] grantResults) {if (requestCode == PERMISSION_REQUEST_EXTERNAL_STORAGE) {if (grantResults.length == 1 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {// For the first time, permission was granted, then start the dialog fragment.startImageChooserDialogFragment();} else {// Prompt to user that permission request was denied.Toast.makeText(this, R.string.toast_permission_denied, Toast.LENGTH_SHORT).show();}} else {super.onRequestPermissionsResult(requestCode, permissions, grantResults);} } 復制代碼

首先通過權限請求的唯一標識符區分不同請求，如果不是期望的請求，那么就調用超級類保持默認行為。

針對特定的權限請求，進一步判斷用戶是否同意該請求，若是則進行下面的工作；若用戶拒絕則顯示一個相關的 Toast 消息。

至此，運行時權限請求基本上就完成了，處理流程如下圖所示。更多信息可參考 這個 Android Developers 文檔。

Note:
InventoryApp 也使用了相機應用拍攝照片，但是這里不需要請求訪問相機的權限，因為 InventoryApp 并非直接操控攝像頭硬件模塊，而是通過 Intent 利用相機應用來獲取圖片資源，這也是使用 Intent 的一個優勢。

DialogFragment

在 InventoryApp 中，應用獲得讀寫外部存儲器文件的權限后，用戶點擊 DetailActivity 中的圖片編輯框時，會調用一個輔助方法，彈出一個標簽為 imageChooser 的自定義對話框，提供了兩個選項。

In DetailActivity.java

private void startImageChooserDialogFragment() {DialogFragment fragment = new ImageChooserDialogFragment();fragment.show(getFragmentManager(), "imageChooser"); } 復制代碼

上述對話框自定義為 ImageChooserDialogFragment，放在單獨的 Java 文件中，屬于 DialogFragment 的子類。首先在 onCreateDialog 方法中，創建并返回一個 Dialog 對象。

In ImageChooserDialogFragment.java

public class ImageChooserDialogFragment extends DialogFragment {@Overridepublic Dialog onCreateDialog(Bundle savedInstanceState) {LayoutInflater inflater = getActivity().getLayoutInflater();View view = inflater.inflate(R.layout.dialog_image_chooser, null);AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());builder.setView(view);return builder.create();}... } 復制代碼

首先通過 LayoutInflater 根據對話框的布局文件生成一個 View 對象。

然后通過 AlertDialog.Builder 配置對話框，主要是將上面生成的 View 對象設置為對話框的布局。

最后調用 AlertDialog.Builder 對象的 create() 方法，返回一個 Dialog 對象。

由于 ImageChooserDialogFragment 的兩個選項的點擊事件都需要使用 Intent 組件，所以與上述 RecyclerView.Adapter 的列表子項點擊事件監聽器相同，這里也要在調用 ImageChooserDialogFragment 的 DetailActivity 中響應其中兩個選項的點擊事件。類似地，在 ImageChooserDialogFragment 中定義點擊事件的接口，以及相關的變量與方法。

In ImageChooserDialogFragment.java

private ImageChooserDialogListener mListener;@Override public void onAttach(Activity activity) {super.onAttach(activity);try {mListener = (ImageChooserDialogListener) activity;} catch (ClassCastException e) {throw new ClassCastException(activity.toString()+ " must implement ImageChooserDialogListener.");} }public interface ImageChooserDialogListener {void onDialogCameraClick(DialogFragment dialog);void onDialogGalleryClick(DialogFragment dialog); } 復制代碼

首先定義一個接口 (interface)，名為 ImageChooserDialogListener，里面放置兩個方法，分別作為兩個選項的點擊事件的響應方法。Activity 在使用 ImageChooserDialogFragment 時必須實現接口內的兩個方法。

然后將 ImageChooserDialogListener 接口定義為一個全局變量，使其能在 onAttach 方法內根據 Activity 初始化，并在其它地方應用，例如在 onCreateDialog 中設置兩個選項的點擊事件監聽器，分別調用 ImageChooserDialogListener 的兩個方法，表示在 DetailActivity 中對點擊事件進行響應。

In ImageChooserDialogFragment.java

@Override public Dialog onCreateDialog(Bundle savedInstanceState) {LayoutInflater inflater = getActivity().getLayoutInflater();View view = inflater.inflate(R.layout.dialog_image_chooser, null);View cameraView = view.findViewById(R.id.action_camera);View galleryView = view.findViewById(R.id.action_gallery);cameraView.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {// Send the camera click event back to the host activity.mListener.onDialogCameraClick(ImageChooserDialogFragment.this);// Dismiss the dialog fragment.dismiss();}});galleryView.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {// Send the gallery click event back to the host activity.mListener.onDialogGalleryClick(ImageChooserDialogFragment.this);// Dismiss the dialog fragment.dismiss();}});... } 復制代碼

首先根據由布局文件生成的 View 對象找到兩個選項的視圖，分別為“相機”和“相冊”。

相機視圖的點擊事件監聽器調用 ImageChooserDialogListener 的 onDialogCameraClick 方法，在 DetailActivity 中響應點擊事件，隨后通過 dismiss() 方法關閉對話框。

類似地，相冊視圖的點擊事件監聽器調用 ImageChooserDialogListener 的 onDialogGalleryClick 方法，在 DetailActivity 中響應點擊事件，隨后通過 dismiss() 方法關閉對話框。

關于 Dialog 的更多信息可參考?這個 Android Developers 文檔。

通過相機應用拍攝照片以及在相冊中選取圖片

在調用 ImageChooserDialogFragment 的 DetailActivity 中響應其中兩個選項的點擊事件，即實現 ImageChooserDialogListener 接口內的兩個方法，這里完成了通過相機應用拍攝照片以及在相冊中選取圖片的功能。

In DetailActivity.java

public class DetailActivity extends AppCompatActivityimplements ImageChooserDialogFragment.ImageChooserDialogListener {public static final String FILE_PROVIDER_AUTHORITY = "com.example.android.fileprovider.camera";private static final int REQUEST_IMAGE_CAPTURE = 0;private static final int REQUEST_IMAGE_SELECT = 1;@Overridepublic void onDialogGalleryClick(DialogFragment dialog) {Intent selectPictureIntent = new Intent();selectPictureIntent.setAction(Intent.ACTION_GET_CONTENT);selectPictureIntent.setType("image/*");if (selectPictureIntent.resolveActivity(getPackageManager()) != null) {startActivityForResult(selectPictureIntent, REQUEST_IMAGE_SELECT);}}@Overridepublic void onDialogCameraClick(DialogFragment dialog) {Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);if (takePictureIntent.resolveActivity(getPackageManager()) != null) {File imageFile = null;try {imageFile = createCameraImageFile();} catch (IOException e) {Log.e(LOG_TAG, "Error creating the File " + e);}if (imageFile != null) {Uri imageURI = FileProvider.getUriForFile(this,FILE_PROVIDER_AUTHORITY, imageFile);takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, imageURI);startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE);}}} } 復制代碼

在相冊中選取圖片的 Intent 比較簡單，URI 設為 Intent.ACTION_GET_CONTENT，MIME 類型設為 image/*，最后通過 startActivityForResult 方法啟動帶有回傳數據的 Intent，其中輸入參數為
（1）intent: 上面配置好的 Intent 對象，在這里即 selectPictureIntent。
（2）requestCode: Intent 的唯一標識符，通常定義為一個全局的整數常量，它在接收 Intent 的回傳數據時會用到。

通過相機應用拍攝照片的 Intent 則相對復雜，主要的工作是創建一個文件，用于存儲相機應用拍攝的照片。完整的步驟如下，更多信息可參考 這個 Android Developers 文檔。
（1）首先設置 Intent 的 URI 為 MediaStore.ACTION_IMAGE_CAPTURE。
（2）然后通過輔助方法創建一個 File 對象，這里需要捕捉可能由創建文件產生的 IOException 異常。
（3）如果成功創建 File 對象，那么就通過 FileProvider 的 getUriForFile 方法獲取該文件的 URI，并作為 EXTRA_OUTPUT 數據傳入 Intent，在這里就指定了相機應用拍攝的照片的存儲位置。
（4）最后通過 startActivityForResult 方法啟動帶有回傳數據的 Intent，其中唯一標識符為 REQUEST_IMAGE_CAPTURE。

在通過相機應用拍攝照片的 Intent 中，調用了一個輔助方法來創建 File 對象，代碼如下，邏輯并不復雜。
（1）首先通過 SimpleDateFormat 獲得一個固定格式的時間戳，再加上前后綴就構成了一個抗沖突 (collision-resistant) 的文件名。
（2）然后通過 Environment 的 getExternalStoragePublicDirectory 方法，以及 Environment.DIRECTORY_PICTURES 輸入參數，獲取一個公共的圖片目錄。這樣用戶通過相機應用拍攝的照片就能被所有應用訪問，這是符合 Android 設計規范的。
（3）最后通過 File 的 createTempFile 方法創建并返回一個 File 對象，其中輸入參數包括上述定義的文件名以及存儲目錄。
（4）另外通過 File 對象的 getAbsolutePath() 方法獲取新建的圖片文件的目錄路徑，它在接收 Intent 的回傳數據時會用到。

In DetailActivity.java

private String mCurrentPhotoPath;private File createCameraImageFile() throws IOException {String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss", Locale.getDefault()).format(new Date());String imageFileName = "JPEG_" + timeStamp + "_";File storageDirectory = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES);File imageFile = File.createTempFile(imageFileName, /* prefix */".jpg", /* suffix */storageDirectory /* directory */);mCurrentPhotoPath = imageFile.getAbsolutePath();return imageFile;} 復制代碼

在通過相機應用拍攝照片的 Intent 中，通過 FileProvider 的 getUriForFile 方法獲取了圖片文件的 URI，其中輸入參數為
（1）context: 當前的應用環境，在這里即 this 表示當前的 DetailActivity。
（2）authority: FileProvider 的主機名，必須與 AndroidManifest 中的一致。
（3）file: 需要獲取 URI 的 File 對象，在這里即上面生成的圖片文件 imageFile。

顯然，這里使用了 Android 提供的 FileProvider，需要在 AndroidManifest 中聲明。

In AndroidManifest.xml

<application>...<providerandroid:name="android.support.v4.content.FileProvider"android:authorities="com.example.android.fileprovider.camera"android:exported="false"android:grantUriPermissions="true"><meta-dataandroid:name="android.support.FILE_PROVIDER_PATHS"android:resource="@xml/file_paths" /></provider> </application> 復制代碼

其中元數據指定了文件的目錄，定義在 xml/file_paths 目錄下。

In res/xml/file_paths.xml

<paths><!-- Declare the path to the public Pictures directory. --><external-path name="item_images" path="." /> </paths> 復制代碼

由于圖片文件放在公共目錄下，所以 FileProvider 指定的文件目錄與應用內部的不同，具體可參考 這個 stack overflow 帖子。

通過相機應用拍攝照片以及在相冊中選取圖片的兩個 Intent 都是帶有回傳數據的，因此通過 override onActivityResult 方法獲取 Intent 的回傳數據。

In DetailActivity.java

private Uri mLatestItemImageUri = null;@Override protected void onActivityResult(int requestCode, int resultCode, Intent intent) {if (resultCode == RESULT_OK) {switch (requestCode) {case REQUEST_IMAGE_CAPTURE:mLatestItemImageUri = Uri.fromFile(new File(mCurrentPhotoPath));GlideApp.with(this).load(mLatestItemImageUri).transforms(new CenterCrop(), new RoundedCorners((int) getResources().getDimension(R.dimen.background_corner_radius))).into(mImageView);break;case REQUEST_IMAGE_SELECT:Uri contentUri = intent.getData();GlideApp.with(this).load(contentUri).transforms(new CenterCrop(), new RoundedCorners((int) getResources().getDimension(R.dimen.background_corner_radius))).into(mImageView);new copyImageFileTask().execute(contentUri);break;}} } 復制代碼

首先判斷 Intent 請求是否成功，若是再根據不同 Intent 的唯一標識符分別進行處理。

對于通過相機應用拍攝照片的 Intent，因為數據庫僅存儲圖片的 URI，而不是存儲圖片數據本身，所以在這里，根據之前新建圖片文件時獲取的目錄路徑獲得一個 file URI，并賦給全局變量 mLatestItemImageUri；最后利用 Glide 顯示圖片。

對于在相冊中選取圖片的 Intent，通過 getData() 方法獲得用戶選擇的圖片文件的 Content URI，隨后利用 Glide 顯示圖片。值得注意的是，這里沒有直接把從 Intent 獲取的 Content URI 賦給 mLatestItemImageUri，而是通過一個 AsyncTask 在后臺線程將用戶選擇的圖片文件復制到應用內部目錄的文件中，再將復制的文件的 file URI 賦給 mLatestItemImageUri。

In DetailActivity.java

private class copyImageFileTask extends AsyncTask<Uri, Void, Uri> {@Overrideprotected Uri doInBackground(Uri... uris) {if (uris[0] == null) {return null;}try {File file = createCopyImageFile();InputStream input = getContentResolver().openInputStream(uris[0]);OutputStream output = new FileOutputStream(file);byte[] buffer = new byte[4 * 1024];int bytesRead;while ((bytesRead = input.read(buffer)) > 0) {output.write(buffer, 0, bytesRead);}input.close();output.close();return Uri.fromFile(file);} catch (IOException e) {Log.e(LOG_TAG, "Error creating the File " + e);}return null;}@Overrideprotected void onPostExecute(Uri uri) {if (uri != null) {mLatestItemImageUri = uri;}} } 復制代碼

從 Intent 獲取的 Content URI 傳入自定義 AsyncTask 類 copyImageFileTask 的 doInBackground 方法，在后臺線程中完成復制文件的工作。

首先判斷 URI 是否為空，若為空則提前返回 null。

然后調用輔助方法新建一個 File 對象，用于存儲復制的圖片文件。與上述相機應用拍攝照片使用的輔助方法的邏輯類似，這里的同樣先是生成一個抗沖突的文件名，再獲取一個存儲目錄，最后通過 File 的 createTempFile 方法創建并返回一個 File 對象。
不同的是，因為這里是從相冊選擇圖片的場景，如果把圖片復制到公共目錄下會對用戶造成困擾，所以這里通過 getExternalFilesDir 方法以及 Environment.DIRECTORY_PICTURES 輸入參數獲取應用內部的目錄，使復制的圖片文件對其它應用不可見。另外，這里不需要獲取復制文件的目錄路徑，所以沒有用到 FileProvider。

In DetailActivity.java

private File createCopyImageFile() throws IOException {String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss", Locale.getDefault()).format(new Date());String imageFileName = "JPEG_" + timeStamp + "_";File storageDirectory = getExternalFilesDir(Environment.DIRECTORY_PICTURES);return File.createTempFile(imageFileName, /* prefix */".jpg", /* suffix */storageDirectory /* directory */); } 復制代碼

接下來從上述 Content URI 讀取數據并存入一個 InputStream 對象，同時根據上述 File 對象新建一個 OutputStream 對象，然后通過 byte[] 緩存將 InputStream 的數據寫入 OutputStream，完成復制后關閉兩個對象，防止內存泄漏。

最后調用 Uri 的 fromFile 方法，根據完成復制的 File 對象返回一個 file URI。然后在 onPostExecute 方法中，如果由 doInBackground 方法傳入的 URI 不為 null 的話，那么將 URI 賦給 mLatestItemImageUri。

至此，通過相機應用拍攝照片以及在相冊中選取圖片的功能就實現了，不過還有一個非常明顯的優化項，那就是每一次用戶通過相機應用拍攝照片或在相冊中選取圖片時，應用都會新建一個圖片文件，如果用戶連續使用相機應用拍攝照片，或者連續在相冊中選取圖片，這會產生多個圖片文件，但最終應用只采用了最后一張圖片，甚至如果用戶此時放棄編輯，之前操作產生的多個文件都作廢了，徒增設備和應用的占用內存。

因此，應用要能夠刪除無用的文件，分為三種情況處理。

一、在相機應用中途取消拍攝照片

對于通過相機應用拍攝照片的操作，只要用戶點擊了 ImageChooserDialogFragment 的相機選項，不管 Intent 請求是否成功，應用都會新建一個文件，所以需要在 onActivityResult 中添加 Intent 請求不成功時的執行代碼，例如用戶點擊了對話框的相機選項，跳轉到相機應用，但沒有成功拍攝照片就回到 InventoryApp，此時就需要刪除這個操作新建的圖片文件。

In DetailActivity.java

@Override protected void onActivityResult(int requestCode, int resultCode, Intent intent) {if (resultCode == RESULT_OK) {switch (requestCode) {case REQUEST_IMAGE_CAPTURE:...mCurrentPhotoPath = null;break;case REQUEST_IMAGE_SELECT:...}} else if (mCurrentPhotoPath != null) {File file = new File(mCurrentPhotoPath);if (file.delete()) {Toast.makeText(this, android.R.string.cancel, Toast.LENGTH_SHORT).show();}} } 復制代碼

需要注意的是，在相冊中選取圖片的操作也會觸發 onActivityResult，例如用戶首先通過相機應用拍攝了一張照片，隨后又點擊了對話框的相冊選項，跳轉到相冊，但沒有選擇圖片就回到 InventoryApp；由于刪除動作是根據 mCurrentPhotoPath 是否為 null 來觸發的，如果上次通過相機應用拍攝照片返回的數據處理完畢后沒有清空 mCurrentPhotoPath 的話，就會誤刪用戶之前通過相機應用拍攝的照片。因此，在通過相機應用拍攝照片的 case 條目內，處理完返回數據后，要將 mCurrentPhotoPath 設為 null。

二、重復通過相機應用拍攝照片或重復在相冊中選取圖片

用戶連續使用相機應用拍攝照片，或者連續在相冊中選取圖片，這會產生多個圖片文件，但最終應用只采用了最后一張圖片，對此的策略是在更換新圖片之前刪除舊圖片。

In DetailActivity.java

@Override protected void onActivityResult(int requestCode, int resultCode, Intent intent) {if (resultCode == RESULT_OK) {deleteFile();...} }private void deleteFile() {if (mLatestItemImageUri != null) {File file = new File(mLatestItemImageUri.getPath());if (file.delete()) {Log.v(LOG_TAG, "Previous file deleted.");}} } 復制代碼

因為用戶通過相機應用拍攝的照片或從相冊選取的圖片的 URI 都存儲在全局變量 mLatestItemImageUri 中，而且 mLatestItemImageUri 的值僅在用戶添加圖片時改變，所以 mLatestItemImageUri 可以作為用戶之前是否已添加過圖片的標識。

在 onActivityResult 方法內，在判斷 Intent 請求成功后，首先調用輔助方法刪除舊圖片。在輔助方法 deleteFile 內，首先判斷 mLatestItemImageUri 是否為 null，若不為空，說明此時存在舊圖片；然后根據這個 file URI 的目錄路徑創建一個 File 對象進行刪除文件的操作，成功后 Log 一條 verbose 消息。

三、用戶放棄編輯

用戶通過相機應用拍攝照片或從相冊選取圖片之后，沒有保存就點擊 BACK 或 UP 按鈕放棄編輯，這會導致新建的圖片文件無用，所以對策是在 BACK 或 UP 按鈕的點擊事件監聽器中調用輔助方法 deleteFile 刪除舊圖片。

Intent to Email with Attachment

在 DetailActivity 的編輯模式下，菜單欄有一個訂購按鈕可以 Intent 到郵箱應用，并且帶有當前貨物的信息，包括將圖片文件放入郵件的附件。

In DetailActivity.java

Intent intent = new Intent(Intent.ACTION_SENDTO); intent.setData(Uri.parse("mailto:"));String subject = "Order " + mCurrentItemName;intent.putExtra(Intent.EXTRA_SUBJECT, subject);StringBuilder text = new StringBuilder(getString(R.string.intent_email_text, mCurrentItemName)); text.append(System.getProperty("line.separator")); intent.putExtra(Intent.EXTRA_STREAM, Uri.parse(mCurrentItemImage));intent.putExtra(Intent.EXTRA_TEXT, text.toString());if (intent.resolveActivity(getPackageManager()) != null) {startActivity(intent); } 復制代碼

頭兩行代碼保證了只有郵箱應用能夠響應這個 Intent 請求。

向 Intent 添加 EXTRA_STREAM 數據作為郵件的附件，傳入圖片文件的 file URI 即可。注意如果這里傳入的是 Content URI，郵箱應用可能由于權限等問題無法獲取指定的文件。

在 StringBuilder 中 append 添加 System.getProperty("line.separator") 資源使字符串換行，它在所有平臺都適用。

向 Intent 添加其它 EXTRA 數據可參考 這篇 Android Developers 文檔。

InputFilter

與 實戰項目 9: 習慣記錄應用 類似，InventoryApp 中的價格 EditText 的輸入限制也是由一個自定義 InputFilter 類實現的。

private class DigitsInputFilter implements InputFilter {private Pattern mPattern;private DigitsInputFilter(int digitsBeforeDecimalPoint, int digitsAfterDecimalPoint) {mPattern = Pattern.compile(getString(R.string.price_pattern,digitsBeforeDecimalPoint - 1, digitsAfterDecimalPoint));}@Overridepublic CharSequence filter(CharSequence source, int start, int end,Spanned dest, int dstart, int dend) {String inputString = dest.toString().substring(0, dstart)+ source.toString().substring(start, end)+ dest.toString().substring(dend, dest.toString().length());Matcher matcher = mPattern.matcher(inputString);if (!matcher.matches()) {return "";}return null;} } 復制代碼

由于自定義 InputFilter 類 DigitsInputFilter 只在 DetailActivity 中用到，所以它作為內部類實現，在 DigitsInputFilter 類內有一個關鍵的全局變量 mPattern，用于決定用戶輸入是否符合要求。

DigitsInputFilter 的構造函數傳入兩個輸入限制參數，分別是小數點前的數字位數以及小數點后的數字位數。它們會作為輸入 Pattern 的一部分，用于決定 EditText 的輸入限制。在 InventoryApp 中，DigitsInputFilter 專門用于價格 EditText，在調用時傳入的兩個參數分別是 10 和 2，表示小數點前最多可輸入十位數字，小數點后則最多為兩位。在這里，Pattern 通過正則表達式 (RegEx) 編譯而成，InventoryApp 中使用的價格正則表達式為 ^(0|[1-9][0-9]{0,9}+)((\\.\\d{0,2})?)，它允許的輸入格式可分為以下幾種情況
（1）以 0 開頭，接下來僅接受小數點 (.) 輸入，不允許更多的 0 或 1～9 數字輸入；小數點后允許最多兩位 0～9 數字輸入。
（2）以 1～9 開頭，接下來可輸入小數點 (.) 或最多九位 0～9 數字輸入；小數點后允許最多兩位 0～9 數字輸入。
（3）不允許以小數點 (.) 開頭。

Override filter method 定義實現輸入限制的代碼，每當用戶輸入一個字符都會觸發該方法。在這里，首先獲取 EditText 中現有的所有字符，然后調用全局變量 Pattern 的 matcher 方法獲得一個 Matcher 對象，最后通過 Matcher 對象的 matches() 方法判斷當前輸入是否符合 Pattern。若是則返回 null 表示允許輸入，若非則返回 "" 用空字符代替輸入，表示過濾輸入。

禁止設備屏幕旋轉

在 InventoryApp 中，存在一種情況，即用戶本來以垂直方向手持設備，但是在向貨物添加圖片時，用戶把設備橫放在相機應用拍攝照片，這會導致 InventoryApp 的 DetailActivity 在后臺被銷毀，用戶拍完照片回來時應用就奔潰了。因此，InventoryApp 的 DetailActivity 需要禁止設備屏幕旋轉，在 AndroidManifest 中設置相關參數。

In AndroidManifest.xml

<activityandroid:name=".DetailActivity"android:screenOrientation="sensorPortrait"android:configChanges="keyboardHidden|orientation|screenSize"android:parentActivityName=".CatalogActivity"android:theme="@style/AppTheme"android:windowSoftInputMode="stateHidden"><!-- Parent activity meta-data to support 4.0 and lower --><meta-dataandroid:name="android.support.PARENT_ACTIVITY"android:value=".CatalogActivity" /> </activity> 復制代碼

將 android:screenOrientation 設為 sensorPortrait，使屏幕方向始終保持傳感器的垂直方向（正向或反向），它在用戶禁用傳感器的情況下仍有效。

向 android:configChanges 添加 orientation 和 screenSize 參數，表示 Activity 在屏幕旋轉以及尺寸變化時不會重啟，而是保持運行，并調用 ?onConfigurationChanged() 方法。在這里 DetailActivity 并沒有 override onConfigurationChanged() 方法，也就是說屏幕旋轉以及尺寸變化時，DetailActivity 保持運行，不作任何反應。

通常情況下，在運行時發生配置變化時，Activity 會重啟，而 android:configChanges 屬性中的參數就指定了其中一些配置變化由 Activity 在?onConfigurationChanged()?方法中自行處理，不需要 Activity 重啟。例如 keyboardHidden 參數代表了鍵盤可用性狀態的配置變化，把它放入 android:configChanges 屬性中就能夠起到首次進入 Activity 時禁止自動彈出輸入法的效果。更多信息可以參考 這個 Android Developers 文檔。

Drawable Resources

在 Android 中 Drawable 資源除了由 png、jpg、gif 等文件提供的圖片文件之外，還有許多直接由 xml 文件提供的資源。例如在 InventoryApp 中，background_border.xml 提供了 CatalogActivity 的列表子項以及 DetailActivity 的圖片的邊框背景，它屬于 Shape Drawable；image_chooser_item_color_list.xml 則提供了添加圖片對話框中的選項在不同點按狀態下的顏色，它屬于 State List Drawable。Drawable Resources 的文檔非常詳盡，邏輯也不復雜，所以在此不再贅述。

FloatingActionButton

FloatingActionButton 的位置可以錨定 (anchor) 到某一個視圖上，如上圖所示，銷售按鈕錨定在貨物圖片的右下角，通過以下代碼可以實現。

In list_item.xml

<android.support.design.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"...><LinearLayout .../><android.support.design.widget.FloatingActionButton...android:layout_margin="@dimen/activity_spacing"android:src="@drawable/ic_sell_white_24dp"app:layout_anchor="@id/item_image"app:layout_anchorGravity="bottom|right|end" /> </android.support.design.widget.CoordinatorLayout> 復制代碼

CoordinatorLayout 作為根目錄，不要忘記添加 app 命名空間。

在 FloatingActionButton 內添加 app:layout_anchor 屬性，并以需要錨定的視圖 ID 作為參數；隨后添加 app:layout_anchorGravity 屬性，設置錨定位置，在這里設為右下角，一般還會添加 16dp 的外邊距 margin。

值得注意的是，FloatingActionButton 是 ImageButton 的子類，所以默認情況下無法在 FloatingActionButton 中添加文字資源。

總結

以上是生活随笔為你收集整理的实战项目 10: 货物清单应用的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。