图像存储和元数据
Android提供了一个标准的方式在应用程序之间分享数据。负责此功能的那些类被称为内容提供者（content provider）。内容提供者提供了一个存储和检索各类数据的标准接口。
图像的标准内容提供者（同时也是音频和视频的）是MediaStore。MediaStore允许将文件配置到设备上的标准位置，并提供了便利的存储和检索文件元数据的方法。元数据是关于数据的数据。它可以包含它所在文件本身的信息，比如文件大小和名称。但MediaStore还可以设置各种各样的附加信息，例如标题，描述，纬度和经度。
我们来改变我们的 SizedCameraIntent activity，使用MediaStore来存储图像和相关元数据，代替之前将图像随意存储到SD卡上。
为图像获取URI
要获得存储图像的标准位置，我们首先需要得到一个MediaStore的引用。为此，我们使用内容解析器（content resolver）。内容解析器是获取，诸如MediaStore这样内容提供者的途径。
通过传入一个指定的URI，内容解析器知道提供一个接口给MediaStore，作为内容提供者。
因为我们要插入一个新图像，我们要用的方法是insert，URI是定义在android.provider.MediaStore.Images.Media类的常量，名为EXTERNAL_CONTENT_URI.这表示我们想将图像保存到设备的主外部存储空间上，一般而言是SD卡。如果我们想保存到设备的内部存储空间，我们可以用INTERNAL_CONTENT_URI.不过，
一般来说，媒体内容，如图像，音频，视频都相当大，你更可能用EXTERNAL_CONTENT_URI.
之前所示的insert调用返回一个URI，我们可以用来写入图像文件的二进制数据。在我们的例子中，如同我们在CameraActivity所做的那样，我们只是想要把它作为激活相机应用的Intent的一个extra。
Uri imageFileUri = getContentResolver().insert(Media.EXTERNAL_CONTENT_URI,
new ContentValues());
Intent i = new Intent(android.provider.MediaStore.ACTION_IMAGE_CAPTURE);
i.putExtra(android.provider.MediaStore.EXTRA_OUTPUT, imageFileUri);
startActivityForResult(i, CAMERA_RESULT);
你会发现，我们还传递了一个新建ContentValues对象。ContentValues对象，是记录创建时我们想要与之关联的元数据。在前述的例子中，我们传递了一个空的ContentValues对象。
预先填入关联的元数据
如果我们想预先填写元数据，我们可使用put方法来添加一些数据到其中。ContentValues以名称-值对接收数据。名称是标准的，以常量定义在android.provider.MediaStore.Images.Media类中。（某些常量实际上是存在于android.provider.MediaStore.MediaColumns接口，Media类所实现的。）
//保存图像的名称和描述到ContentValues的映射表。
ContentValues contentValues = new ContentValues(3);
contentValues.put(Media.DISPLAY_NAME, "This is a test title");
contentValues.put(Media.DESCRIPTION, "This is a test description");
contentValues.put(Media.MIME_TYPE, "image/jpeg");
//添加一个新纪录，不带位图，但是设置了一些值。
//insert()返回新纪录的URI。
Uri imageFileUri = getContentResolver().insert(Media.EXTERNAL_CONTENT_URI,
contentValues);
同样，这个调用返回的是一个URI，通过Intent传递给相机应用，指定了图像存储位置。
如果你通过Log来输出这个URI，它可能看起来是这样：
content://media/external/images/media/16
你可能首先发现它看起来像一个普通的URL，如同你在web浏览器所用的；只不过开头用Content替换了http，http是网页传输协议。在Android中，如果一个URI以content开头，那么它必是用于content provider（如MediaStore）。
检索已存图像
之前取得的用于存储图像的URI，也能作为访问图像的路径。但我们不再传递文件的全路径给BitmapFactory，而是通过内容解析器（content provider）为该图像打开一个InputStream，传递给BitmapFactory。
Bitmap bmp = BitmapFactory.decodeStream(
getContentResolver().openInputStream(imageFileUri), null, bmpFactoryOptions);
创建过后添加元数据
如果我们想在图像采集到MediaStore之后，给它关联更多的元数据，可以使用内容解析器（content provider）的update方法。这跟我们之前使用的insert非常类似，除了我们是通过图像文件的URI来访问它。
//更新记录的标题和描述 ContentValues contentValues = new ContentValues(3); contentValues.put(Media.DISPLAY_NAME, "This is a test title"); contentValues.put(Media.DESCRIPTION, "This is a test description"); getContentResolver().update(imageFileUri,contentValues,null,null);
更新CameraActivity，使用MediaStore来存储图像和关联元数据
下面是对之前的例子的更新，新版本将图像存储到MediaStore，并给我们展示了如何添加标题和描述。另外，这个版本还有几个用户界面元素(UI element)，它们的显示和隐藏基于用户对程序的操作。
package com.apress.proandroidmedia.ch1.mediastorecameraintent;
import java.io.FileNotFoundException;
import android.app.Activity;
import android.content.Intent;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.net.Uri;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.ImageView;
import android.widget.TextView;
import android.widget.Toast;
import android.provider.MediaStore.Images.Media;
import android.content.ContentValues;
public class MediaStoreCameraIntent extends Activity {
final static int CAMERA_RESULT = 0;
Uri imageFileUri;
// 用户界面元素，定义在/res/layout/main.xml
ImageView returnedImageView;
Button takePictureButton;
Button saveDataButton;
TextView titleTextView;
TextView descriptionTextView;
EditText titleEditText;
EditText descriptionEditText;
我们包含了一些用户界面元素它们已经定义在layout/main.xml中，其对象在上述的代码中做了声明。
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
//将Content View设置为定义在res/layout/main.xml内的视图
setContentView(R.layout.main);
//取得用户界面元素的引用
returnedImageView = (ImageView) findViewById(R.id.ReturnedImageView);
takePictureButton = (Button) findViewById(R.id.TakePictureButton);
saveDataButton = (Button) findViewById(R.id.SaveDataButton);
titleTextView = (TextView) findViewById(R.id.TitleTextView);
descriptionTextView = (TextView) findViewById(R.id.DescriptionTextView);
titleEditText = (EditText) findViewById(R.id.TitleEditText);
descriptionEditText = (EditText) findViewById(R.id.DescriptionEditText);
在Activity的标准方法OnCreate里，调用setContentView之后，我们实例化需要代码控制的用户界面元素。 通过findViewById取得用户界面的引用，然后转义为对应的类型。
// 除了takePictureButton之外,所有界面元素初始化为不可见
//View.GONE 表示不可见，而且不占空间。
returnedImageView.setVisibility(View.GONE);
saveDataButton.setVisibility(View.GONE);
titleTextView.setVisibility(View.GONE);
descriptionTextView.setVisibility(View.GONE);
titleEditText.setVisibility(View.GONE);
descriptionEditText.setVisibility(View.GONE);
接着，我们将设置所有的用户界面元素不可见，同时不在布局中占用空间。为此我们传递常量View.GONE给setVisibility方法。另一个常量View.INVISIBLE,可以隐藏上述元素，但是仍要在布局中占用空间。
//当点击拍照按钮(Take Picture Button)时
takePictureButton.setOnClickListener(new OnClickListener() {
public void onClick(View v) {
//添加一项不带位图的新记录
//返回新记录的URI
imageFileUri = getContentResolver().insert(Media.EXTERNAL_CONTENT_URI,
new ContentValues());
// 启动相机应用
Intent i = new Intent(android.provider.MediaStore.ACTION_IMAGE_CAPTURE);
i.putExtra(android.provider.MediaStore.EXTRA_OUTPUT, imageFileUri);
startActivityForResult(i, CAMERA_RESULT);
}
});
在takePictureButton的点击监听类OnClickListener里，我们为内置相机创建了一个标准的Intent，然后调用startAcitivityForResult。放在这里比直接放在onCreate，用户体验要稍微好一些。
saveDataButton.setOnClickListener(new OnClickListener() {
public void onClick(View v) {
//更新MediaStore记录的标题和描述
ContentValues contentValues = new ContentValues(3);
contentValues.put(Media.DISPLAY_NAME,titleEditText.getText().toString());
contentValues.put(Media.DESCRIPTION,
descriptionEditText.getText().toString());
getContentResolver().update(imageFileUri,contentValues,null,null);
// 通知用户
Toast bread = Toast.makeText(MediaStoreCameraIntent.this,
"Record Updated", Toast.LENGTH_SHORT);
bread.show();
//回到初始状态，设置拍照按钮可见
//隐藏其他的用户界面元素
takePictureButton.setVisibility(View.VISIBLE);
returnedImageView.setVisibility(View.GONE);
saveDataButton.setVisibility(View.GONE);
titleTextView.setVisibility(View.GONE);
descriptionTextView.setVisibility(View.GONE);
titleEditText.setVisibility(View.GONE);
descriptionEditText.setVisibility(View.GONE);
}
});
}
一旦相机应用返回图像，saveDataButton变得可见。其监听类OnClickListener为图像关联元数据。它接收用户输入到各个EditText元素的值，创建一个ContentValues对象，用来更新MediaStore中该图像的记录。
protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
super.onActivityResult(requestCode, resultCode, intent);
if (resultCode == RESULT_OK) {
// 相机应用返回了
// 隐藏拍照按钮
takePictureButton.setVisibility(View.GONE);
// 显示其他用户界面元素
saveDataButton.setVisibility(View.VISIBLE);
returnedImageView.setVisibility(View.VISIBLE);
titleTextView.setVisibility(View.VISIBLE);
descriptionTextView.setVisibility(View.VISIBLE);
titleEditText.setVisibility(View.VISIBLE);
descriptionEditText.setVisibility(View.VISIBLE);
// 缩放图像
int dw = 200; //使其最多200像素宽
int dh = 200; //使其最多200像素高
try {
// 加载图像的尺寸，而非图像本身
BitmapFactory.Options bmpFactoryOptions = new BitmapFactory.Options();
bmpFactoryOptions.inJustDecodeBounds = true;
Bitmap bmp = BitmapFactory.decodeStream(
getContentResolver().openInputStream(imageFileUri),
null, bmpFactoryOptions);
int heightRatio = (int)Math.ceil(bmpFactoryOptions.outHeight/(float)dh);
int widthRatio = (int)Math.ceil(bmpFactoryOptions.outWidth/(float)dw);
Log.v("HEIGHTRATIO",""+heightRatio);
Log.v("WIDTHRATIO",""+widthRatio);
// 如果两个比值都大于1 那么图像的某一边大于屏幕
//（译注：此处注释不恰当，把dh和dw当作了屏幕尺寸）
if (heightRatio > 1 && widthRatio > 1) {
if (heightRatio > widthRatio) {
// 高度比较大，根据它进行缩放
bmpFactoryOptions.inSampleSize = heightRatio;
}
else {
// 宽度比较大，根据它进行缩放
bmpFactoryOptions.inSampleSize = widthRatio;
}
}
// 真正解码图像
bmpFactoryOptions.inJustDecodeBounds = false;
bmp = BitmapFactory.decodeStream(
getContentResolver().openInputStream(imageFileUri),
null, bmpFactoryOptions);
//显示图像
returnedImageView.setImageBitmap(bmp);
}
catch (FileNotFoundException e) {
Log.v("ERROR",e.toString());
}
}
}
}
这是布局的XML文件:main.xml.用于上面的例子。
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="fill_parent"
android:layout_height="fill_parent" >
<ImageView
android:id="@+id/ReturnedImageView"
android:layout_width="wrap_content"
android:layout_height="wrap_content">
</ImageView>
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Title:"
android:id="@+id/TitleTextView">
</TextView>
<EditText
android:layout_height="wrap_content"
android:id="@+id/TitleEditText"
android:layout_width="fill_parent">
</EditText>
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Description"
android:id="@+id/DescriptionTextView">
</TextView>
<EditText android:layout_height="wrap_content"
android:layout_width="fill_parent"
android:id="@+id/DescriptionEditText">
</EditText>
<Button android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:id="@+id/TakePictureButton"
android:text="Take Picture">
</Button>
<Button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:id="@+id/SaveDataButton"
android:text="Save Data">
</Button>
</LinearLayout>
在前面的例子里,当相机应用返回时,onActivityResult被触发.新创建的图像被解码成位图并显示出来。在这个版本中,对相关的用户界面元素也进行了管理。