Androidのコンテンツプロバイダ(コンテンツプロバイダ)
コンポーネントを要求することにより、コンテンツプロバイダは、別のアプリケーションにあるアプリケーションからのデータを提供します。 に対処するためのクラスContentResolverの道によって、これらの要求。 コンテンツプロバイダは、データを格納するためのさまざまな方法を使用することができます。 データは、データベース、ファイル、またはネットワークに保存することができます。
アプリケーション間でデータを共有するために時々必要。 この場合、コンテンツプロバイダは、非常に有用となります。
コンテンツプロバイダは、必要に応じて、アクセスに別のアプリケーションの数を持つことができ、コンテンツにフォーカスを行うことができます。 コンテンツプロバイダやデータベースなどの行為。 あなたは、コンテンツを追加または削除する)(照会、その内容を編集、挿入()を使用し、更新()、(削除)および照会することができます。 ほとんどの場合、データは、SQLiteデータベースに格納されています。
コンテンツプロバイダは、クラスのContentProviderクラスのサブクラスとして実装されます。 我々は、標準的なAPIのシリーズを実装する必要があるので、他のアプリケーションは、トランザクションを実行します。
public class MyApplication extends ContentProvider { }
コンテンツURI
コンテンツプロバイダを照会するには、URIのクエリ文字列を指定するには、次の形式の形態であることする必要があります。
<prefix>://<authority>/<data_type>/<id>
以下は、URIの各部分の具体的な説明です。
セクション | 説明 |
---|---|
接頭辞 | 接頭辞:コンテンツとして設定されている:// |
権威 | 認可:などの連絡先、ブラウザ、として、コンテンツプロバイダーの名前を指定します。 cn.programmer.statusprovider:サードパーティのコンテンツプロバイダは、次のような完全な名前であってもよいです |
DATA_TYPE | データタイプ:これは、データのコンテンツプロバイダと、この特定のタイプを示します。 例えば:あなたは連絡先アドレス帳のすべてを取得するには、コンテンツプロバイダによって提供したい、次のように、データ・パスは、人々が、その後、URIはなります次のとおりです。内容://連絡先/人 |
イド | この要求は、特定のレコードを指定しました。 たとえば、次のコンテンツ://連絡先/人/ 5あなたは、コンテンツ・プロバイダ・コンタクトは、コンタクトID番号が5での検索を提供し、URIは次のようになります |
コンテンツプロバイダを作成します。
プロバイダーここで説明する簡単な手順は、独自のコンテンツを作成することができます。
- まず、あなたは、派生クラスContentProviderbaseコンテンツプロバイダクラスを作成する必要があります。
- 第二に、あなたは、コンテンツプロバイダURIアドレスにアクセスするためのコンテンツを定義する必要があります。
- 次に、あなたがコンテンツを格納するデータベースを作成する必要があります。 一般的に、AndroidはSQLiteのデータベースを使用し、データベースプロバイダを作成したり、開くことSQLiteOpenHelper法の枠組みの中で使用されるのonCreate()メソッドをオーバーライドします。 アプリケーションが起動されると、その各コンテンツプロバイダのonCreate()メソッドは、アプリケーションのメインスレッドで呼び出されます。
- 最後に、AndroidManifest.xmlをコンテンツプロバイダに登録されている<プロバイダja. />タグを使用します。
以下では、クラスのContentProviderの書き換えで、いくつかの方法を必要とする、あなたの仕事を得るために、コンテンツ・プロバイダです。
- onCreate():プロバイダが開始されたときに呼び出されます。
- 問合せ():このメソッドは、クライアントからのリクエストを受け付けます。 結果は戻りポインタ(カーソル)オブジェクトです。
- 挿入():このメソッドは、コンテンツプロバイダは、新しいレコードを挿入します。
- 削除():このメソッドは、既存のレコードのコンテンツプロバイダから削除されます。
- アップデート():このメソッドは、既存のレコード内のコンテンツプロバイダを更新します。
- getType():このメソッドは、指定されたURIのメタデータ型を返します。
例
この例では、独自のコンテンツプロバイダを作成する方法について説明します。 それでは、以下の手順に従ってみましょう:
ステップ | 説明 |
---|---|
1 | パッケージcn.uprogrammer.contentproviderに、コンテンツプロバイダという名前のAndroid Studioを使用してAndroidアプリケーションを作成し、宇宙活動の確立。 |
2 | )の2つの新しいメソッドonClickAddName()とonClickRetrieveStudentsを(追加するMainActivity.javaファイル主な活動を変更します。 |
3 | 実際のプロバイダ、および関連するメソッドを定義するStudentsProvider.javaファイルcn.uprogrammer.contentprovider新しいJavaパッケージの下に作成。 |
4 | 使用すると、<プロバイダはja. />のAndroidManifest.xml内のタグは、コンテンツプロバイダを登録しました。 |
5 | 生徒のレコードはシンプルなインタフェースが含まれている追加するには、デフォルトのコンテンツのres /レイアウト/ activity_main.xmlファイルを変更します。 |
6 | strings.xmlを変更することなく、Androidのスタジオは、注目のstrings.xmlファイルを支払うことになります。 |
7 | アプリケーションを実行し、アプリケーションに加えられた変更の結果を確認するためにAndroidのエミュレータを起動します。 |
ここでの変更された主な活動ファイルはsrc / cn.uprogrammer.contentprovider / MainActivity.javaの内容です。 このファイルは、基本的なライフサイクル・アプローチのそれぞれが含まれています。 私たちは、アプリケーションがユーザーの操作を処理させるために)2つの新しいメソッド、onClickAddName()とonClickRetrieveStudentsを(追加しました。
package cn.uprogrammer.contentprovider; import android.net.Uri; import android.os.Bundle; import android.app.Activity; import android.content.ContentValues; import android.content.CursorLoader; import android.database.Cursor; import android.view.Menu; import android.view.View; import android.widget.EditText; import android.widget.Toast; import cn.uprogrammer.contentprovider.R; public class MainActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); } @Override public boolean onCreateOptionsMenu(Menu menu) { getMenuInflater().inflate(R.menu.menu_main, menu); return true; } public void onClickAddName(View view) { // Add a new student record ContentValues values = new ContentValues(); values.put(StudentsProvider.NAME, ((EditText)findViewById(R.id.editText2)).getText().toString()); values.put(StudentsProvider.GRADE, ((EditText)findViewById(R.id.editText3)).getText().toString()); Uri uri = getContentResolver().insert( StudentsProvider.CONTENT_URI, values); Toast.makeText(getBaseContext(), uri.toString(), Toast.LENGTH_LONG).show(); } public void onClickRetrieveStudents(View view) { // Retrieve student records String URL = "content://com.example.provider.College/students"; Uri students = Uri.parse(URL); Cursor c = managedQuery(students, null, null, null, "name"); if (c.moveToFirst()) { do{ Toast.makeText(this, c.getString(c.getColumnIndex(StudentsProvider._ID)) + ", " + c.getString(c.getColumnIndex( StudentsProvider.NAME)) + ", " + c.getString(c.getColumnIndex( StudentsProvider.GRADE)), Toast.LENGTH_SHORT).show(); } while (c.moveToNext()); } } }
パッケージStudentsProvider.java cn.uprogrammer.contentproviderで新しいファイルを作成します。 以下は、ののsrc / cn.uprogrammer.contentprovider / StudentsProvider.javaの内容です。
package cn.uprogrammer.contentprovider; import java.util.HashMap; import android.content.ContentProvider; import android.content.ContentUris; import android.content.ContentValues; import android.content.Context; import android.content.UriMatcher; import android.database.Cursor; import android.database.SQLException; import android.database.sqlite.SQLiteDatabase; import android.database.sqlite.SQLiteOpenHelper; import android.database.sqlite.SQLiteQueryBuilder; import android.net.Uri; import android.text.TextUtils; public class StudentsProvider extends ContentProvider { static final String PROVIDER_NAME = "com.example.provider.College"; static final String URL = "content://" + PROVIDER_NAME + "/students"; static final Uri CONTENT_URI = Uri.parse(URL); static final String _ID = "_id"; static final String NAME = "name"; static final String GRADE = "grade"; private static HashMap<String, String> STUDENTS_PROJECTION_MAP; static final int STUDENTS = 1; static final int STUDENT_ID = 2; static final UriMatcher uriMatcher; static{ uriMatcher = new UriMatcher(UriMatcher.NO_MATCH); uriMatcher.addURI(PROVIDER_NAME, "students", STUDENTS); uriMatcher.addURI(PROVIDER_NAME, "students/#", STUDENT_ID); } /** * 数据库特定常量声明 */ private SQLiteDatabase db; static final String DATABASE_NAME = "College"; static final String STUDENTS_TABLE_NAME = "students"; static final int DATABASE_VERSION = 1; static final String CREATE_DB_TABLE = " CREATE TABLE " + STUDENTS_TABLE_NAME + " (_id INTEGER PRIMARY KEY AUTOINCREMENT, " + " name TEXT NOT NULL, " + " grade TEXT NOT NULL);"; /** * 创建和管理提供者内部数据源的帮助类. */ private static class DatabaseHelper extends SQLiteOpenHelper { DatabaseHelper(Context context){ super(context, DATABASE_NAME, null, DATABASE_VERSION); } @Override public void onCreate(SQLiteDatabase db) { db.execSQL(CREATE_DB_TABLE); } @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { db.execSQL("DROP TABLE IF EXISTS " + STUDENTS_TABLE_NAME); onCreate(db); } } @Override public boolean onCreate() { Context context = getContext(); DatabaseHelper dbHelper = new DatabaseHelper(context); /** * 如果不存在,则创建一个可写的数据库。 */ db = dbHelper.getWritableDatabase(); return (db == null)? false:true; } @Override public Uri insert(Uri uri, ContentValues values) { /** * 添加新学生记录 */ long rowID = db.insert( STUDENTS_TABLE_NAME, "", values); /** * 如果记录添加成功 */ if (rowID > 0) { Uri _uri = ContentUris.withAppendedId(CONTENT_URI, rowID); getContext().getContentResolver().notifyChange(_uri, null); return _uri; } throw new SQLException("Failed to add a record into " + uri); } @Override public Cursor query(Uri uri, String[] projection, String selection,String[] selectionArgs, String sortOrder) { SQLiteQueryBuilder qb = new SQLiteQueryBuilder(); qb.setTables(STUDENTS_TABLE_NAME); switch (uriMatcher.match(uri)) { case STUDENTS: qb.setProjectionMap(STUDENTS_PROJECTION_MAP); break; case STUDENT_ID: qb.appendWhere( _ID + "=" + uri.getPathSegments().get(1)); break; default: throw new IllegalArgumentException("Unknown URI " + uri); } if (sortOrder == null || sortOrder == ""){ /** * 默认按照学生姓名排序 */ sortOrder = NAME; } Cursor c = qb.query(db, projection, selection, selectionArgs,null, null, sortOrder); /** * 注册内容URI变化的监听器 */ c.setNotificationUri(getContext().getContentResolver(), uri); return c; } @Override public int delete(Uri uri, String selection, String[] selectionArgs) { int count = 0; switch (uriMatcher.match(uri)){ case STUDENTS: count = db.delete(STUDENTS_TABLE_NAME, selection, selectionArgs); break; case STUDENT_ID: String id = uri.getPathSegments().get(1); count = db.delete( STUDENTS_TABLE_NAME, _ID + " = " + id + (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : ""), selectionArgs); break; default: throw new IllegalArgumentException("Unknown URI " + uri); } getContext().getContentResolver().notifyChange(uri, null); return count; } @Override public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { int count = 0; switch (uriMatcher.match(uri)){ case STUDENTS: count = db.update(STUDENTS_TABLE_NAME, values, selection, selectionArgs); break; case STUDENT_ID: count = db.update(STUDENTS_TABLE_NAME, values, _ID + " = " + uri.getPathSegments().get(1) + (!TextUtils.isEmpty(selection) ? " AND (" +selection + ')' : ""), selectionArgs); break; default: throw new IllegalArgumentException("Unknown URI " + uri ); } getContext().getContentResolver().notifyChange(uri, null); return count; } @Override public String getType(Uri uri) { switch (uriMatcher.match(uri)){ /** * 获取所有学生记录 */ case STUDENTS: return "vnd.android.cursor.dir/vnd.example.students"; /** * 获取一个特定的学生 */ case STUDENT_ID: return "vnd.android.cursor.item/vnd.example.students"; default: throw new IllegalArgumentException("Unsupported URI: " + uri); } } }
以下は、AndroidManifest.xmlファイルの変更です。 ここに私たちのコンテンツプロバイダを含むように<プロバイダja. />タグを追加しました:
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="cn.uprogrammer.contentprovider" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="8" android:targetSdkVersion="22" /> <application android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme" > <activity android:name="cn.uprogrammer.contentprovider.MainActivity" android:label="@string/app_name" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <provider android:name="StudentsProvider" android:authorities="com.example.provider.College" > </provider> </application> </manifest>
ここでのres /レイアウト/ activity_main.xmlファイルの内容は次のとおりです。
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" android:paddingLeft="@dimen/activity_horizontal_margin" android:paddingRight="@dimen/activity_horizontal_margin" android:paddingTop="@dimen/activity_vertical_margin" android:paddingBottom="@dimen/activity_vertical_margin" tools:context=".MainActivity"> <TextView android:id="@+id/textView1" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="内容提供者实例" android:layout_alignParentTop="true" android:layout_centerHorizontal="true" android:textSize="30dp" /> <TextView android:id="@+id/textView2" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="www.uprogrammer.cn" android:textColor="#ff87ff09" android:textSize="30dp" android:layout_below="@+id/textView1" android:layout_centerHorizontal="true" /> <ImageButton android:layout_width="wrap_content" android:layout_height="wrap_content" android:id="@+id/imageButton" android:src="@drawable/ic_launcher" android:layout_below="@+id/textView2" android:layout_centerHorizontal="true" /> <Button android:layout_width="wrap_content" android:layout_height="wrap_content" android:id="@+id/button2" android:text="添加" android:layout_below="@+id/editText3" android:layout_alignRight="@+id/textView2" android:layout_alignEnd="@+id/textView2" android:layout_alignLeft="@+id/textView2" android:layout_alignStart="@+id/textView2" android:onClick="onClickAddName"/> <EditText android:layout_width="wrap_content" android:layout_height="wrap_content" android:id="@+id/editText" android:layout_below="@+id/imageButton" android:layout_alignRight="@+id/imageButton" android:layout_alignEnd="@+id/imageButton" /> <EditText android:layout_width="wrap_content" android:layout_height="wrap_content" android:id="@+id/editText2" android:layout_alignTop="@+id/editText" android:layout_alignLeft="@+id/textView1" android:layout_alignStart="@+id/textView1" android:layout_alignRight="@+id/textView1" android:layout_alignEnd="@+id/textView1" android:hint="姓名" android:textColorHint="@android:color/holo_blue_light" /> <EditText android:layout_width="wrap_content" android:layout_height="wrap_content" android:id="@+id/editText3" android:layout_below="@+id/editText" android:layout_alignLeft="@+id/editText2" android:layout_alignStart="@+id/editText2" android:layout_alignRight="@+id/editText2" android:layout_alignEnd="@+id/editText2" android:hint="年级" android:textColorHint="@android:color/holo_blue_bright" /> <Button android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="查询" android:id="@+id/button" android:layout_below="@+id/button2" android:layout_alignRight="@+id/editText3" android:layout_alignEnd="@+id/editText3" android:layout_alignLeft="@+id/button2" android:layout_alignStart="@+id/button2" android:onClick="onClickRetrieveStudents"/> </RelativeLayout>
解像度/値/のstrings.xmlファイルには、次のような内容があることを確認してください:
<?xml version="1.0" encoding="utf-8"?> <resources> <string name="app_name">Content Provider</string> <string name="action_settings">Settings</string> </resources>
ちょうど変更されたコンテンツプロバイダのアプリケーションを実行してみましょう。 私は、インストール環境中にAVDを作成したと仮定します。 アクティブなファイルでプロジェクトを開き、ツールバーのをクリック アンドロイドStudioでアプリケーションを実行するためのアイコン。 Androidのメーカーは、AVD上でアプリケーションをインストールし、それを開始します。 すべてがうまくいけば、次のようにエミュレータウィンドウに表示されます。
名前と年を入力して、メッセージを削除するには、データ内の学生のレコードを追加し、下部にあるだろう "追加"ボタン、をクリックしてください。 情報コンテンツは、データベースコンテンツプロバイダURIに追加されたレコードの数を表示します。 この操作は、挿入()メソッドを使用しています。 当社のコンテンツプロバイダのデータベースでより多くの学生を追加するには、このプロセスを繰り返します。
あなたが完了したら、データベースのレコードが追加され、コンテンツプロバイダに恩返しする時間であるこれらのレコードが必要です。 query()メソッドを実装することによって記録されたデータをすべて取得し、表示するために来る「検索」ボタンをクリックします。
あなたはアップデートを追加し、操作を削除するには、更新を準備し、操作を削除して、ユーザーインターフェイスを変更するにはMainActivity.javaコールバックメソッドを提供することができます。
あなたは、このようなコンタクトにより、このように提供される既存のコンテンツを使用することができます。 上記のような読み取り、書き込み、更新、削除などのデータベース操作のインスタンスとして知られているように、あなたはまた、良好なデータベース指向のアプリケーションを開発するには、このような方法で、あなたが行うことができますすることができます。