สร้างผู้ให้บริการเนื้อหา Stub

เฟรมเวิร์กอะแดปเตอร์ซิงค์ได้รับการออกแบบมาให้ทำงานกับข้อมูลอุปกรณ์ที่จัดการโดย เฟรมเวิร์กผู้ให้บริการเนื้อหาที่มีความปลอดภัยสูง ด้วยเหตุนี้ เฟรมเวิร์กอะแดปเตอร์การซิงค์จึงคาดหวังว่า แอปที่ใช้เฟรมเวิร์กนี้ได้กำหนดผู้ให้บริการเนื้อหาสำหรับข้อมูลในเครื่องแล้ว หากเฟรมเวิร์กอะแดปเตอร์การซิงค์พยายามเรียกใช้อะแดปเตอร์การซิงค์ และแอปของคุณไม่มี Content Provider อะแดปเตอร์การซิงค์เกิดขัดข้อง

หากคุณกำลังพัฒนาแอปใหม่ที่จะโอนข้อมูลจากเซิร์ฟเวอร์ไปยังอุปกรณ์ คุณควร ควรพิจารณาจัดเก็บข้อมูลในเครื่องไว้ในผู้ให้บริการเนื้อหา นอกเหนือจากความสำคัญต่อ อะแดปเตอร์การซิงค์ ผู้ให้บริการเนื้อหามีคุณประโยชน์ด้านความปลอดภัยมากมาย และ ที่ออกแบบมาเพื่อจัดการพื้นที่เก็บข้อมูลในระบบ Android ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างเนื้อหา โปรดดูการสร้างผู้ให้บริการเนื้อหา

แต่หากคุณจัดเก็บข้อมูลในเครื่องในรูปแบบอื่นอยู่แล้ว คุณจะยังใช้การซิงค์ได้ เพื่อจัดการการโอนข้อมูล เพื่อให้เป็นไปตามข้อกำหนดเฟรมเวิร์กอะแดปเตอร์การซิงค์สำหรับ Content Provider ให้เพิ่มผู้ให้บริการเนื้อหา Stub ลงในแอป ผู้ให้บริการสตับจะนำองค์ประกอบ คลาสผู้ให้บริการเนื้อหา แต่วิธีการที่จำเป็นทั้งหมดจะแสดงผลเป็น null หรือ 0 หากคุณ เพิ่มผู้ให้บริการสตับ คุณก็ใช้อะแดปเตอร์การซิงค์เพื่อโอนข้อมูลจากพื้นที่เก็บข้อมูลใดก็ได้ ที่คุณเลือก

หากมีผู้ให้บริการเนื้อหาในแอปอยู่แล้ว ก็ไม่จำเป็นต้องมีผู้ให้บริการเนื้อหา Stub ในกรณีนี้ คุณสามารถข้ามบทเรียนนี้และไปยังบทเรียนนั้นต่อ การสร้างอะแดปเตอร์การซิงค์ หากคุณยังไม่มี Content Provider บทเรียนนี้จะแสดงวิธีเพิ่มผู้ให้บริการเนื้อหา Stub ที่ช่วยให้คุณทำสิ่งต่อไปนี้ได้ เสียบอะแดปเตอร์การซิงค์เข้ากับเฟรมเวิร์ก

เพิ่มผู้ให้บริการเนื้อหา Stub

หากต้องการสร้างผู้ให้บริการเนื้อหา Stub สำหรับแอป โปรดขยายชั้นเรียน ContentProvider และนำวิธีการที่จำเป็นออก ดังต่อไปนี้ ตัวอย่างข้อมูลแสดงวิธีสร้างผู้ให้บริการสตับ

/*  * Define an implementation of ContentProvider that stubs out  * all methods  */ class StubProvider : ContentProvider() {     /*      * Always return true, indicating that the      * provider loaded correctly.      */     override fun onCreate(): Boolean  = true      /*      * Return no type for MIME type      */     override fun getType(uri: Uri): String?  = null      /*      * query() always returns no results      *      */     override fun query(             uri: Uri,             projection: Array<String>,             selection: String,             selectionArgs: Array<String>,             sortOrder: String     ): Cursor?  = null      /*      * insert() always returns null (no URI)      */     override fun insert(uri: Uri, values: ContentValues): Uri? = null      /*      * delete() always returns "no rows affected" (0)      */     override fun delete(uri: Uri, selection: String, selectionArgs: Array<String>): Int = 0      /*      * update() always returns "no rows affected" (0)      */     override fun update(             uri: Uri,             values: ContentValues,             selection: String,             selectionArgs: Array<String>     ): Int = 0 }

/*  * Define an implementation of ContentProvider that stubs out  * all methods  */ public class StubProvider extends ContentProvider {     /*      * Always return true, indicating that the      * provider loaded correctly.      */     @Override     public boolean onCreate() {         return true;     }     /*      * Return no type for MIME type      */     @Override     public String getType(Uri uri) {         return null;     }     /*      * query() always returns no results      *      */     @Override     public Cursor query(             Uri uri,             String[] projection,             String selection,             String[] selectionArgs,             String sortOrder) {         return null;     }     /*      * insert() always returns null (no URI)      */     @Override     public Uri insert(Uri uri, ContentValues values) {         return null;     }     /*      * delete() always returns "no rows affected" (0)      */     @Override     public int delete(Uri uri, String selection, String[] selectionArgs) {         return 0;     }     /*      * update() always returns "no rows affected" (0)      */     public int update(             Uri uri,             ContentValues values,             String selection,             String[] selectionArgs) {         return 0;     } }

ประกาศผู้ให้บริการในไฟล์ Manifest

เฟรมเวิร์กอะแดปเตอร์การซิงค์จะยืนยันว่าแอปของคุณมีผู้ให้บริการเนื้อหาหรือไม่ โดยตรวจสอบว่า แอปได้ประกาศผู้ให้บริการในไฟล์ Manifest ของแอป หากต้องการประกาศผู้ให้บริการสตับใน ไฟล์ Manifest ให้เพิ่มเอลิเมนต์ <provider> ที่มีแอตทริบิวต์ต่อไปนี้

android:name="com.example.android.datasync.provider.StubProvider"

ระบุชื่อที่มีคุณสมบัติครบถ้วนของคลาสที่ใช้ผู้ให้บริการเนื้อหา Stub

android:authorities="com.example.android.datasync.provider"

สิทธิ์ URI ที่ระบุผู้ให้บริการเนื้อหา Stub ทำให้ค่านี้ ชื่อแพ็กเกจที่มีสตริง ".provider" ต่อท้าย แม้ว่าคุณจะประกาศ ระบบไม่ได้ดำเนินการใดๆ กับคำขอเข้าถึงผู้ให้บริการเอง

android:exported="false"

กำหนดว่าแอปอื่นๆ สามารถเข้าถึงผู้ให้บริการเนื้อหาได้หรือไม่ สำหรับเนื้อหาต้นขั้ว ให้กำหนดค่าเป็น false เนื่องจากไม่จำเป็นต้องอนุญาตให้แอปอื่นๆ ดู กับผู้ให้บริการ ค่านี้ไม่ส่งผลต่อการโต้ตอบระหว่างเฟรมเวิร์กอะแดปเตอร์การซิงค์ และผู้ให้บริการเนื้อหา

android:syncable="true"

ตั้งค่าแฟล็กที่ระบุว่าผู้ให้บริการซิงค์ได้ หากตั้งค่าสถานะนี้เป็น true คุณไม่จำเป็นต้องโทรหา setIsSyncable() ด้วยรหัสของคุณ ธงนี้อนุญาตให้เฟรมเวิร์กอะแดปเตอร์การซิงค์สร้างข้อมูล การโอนกับผู้ให้บริการเนื้อหา แต่การโอนจะเกิดขึ้นเฉพาะในกรณีที่ดำเนินการอย่างชัดแจ้งเท่านั้น

ข้อมูลโค้ดต่อไปนี้จะแสดงวิธีเพิ่ม องค์ประกอบ <provider> ไปยังไฟล์ Manifest ของแอป:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"     package="com.example.android.network.sync.BasicSyncAdapter"     android:versionCode="1"     android:versionName="1.0" >     <application         android:allowBackup="true"         android:icon="@drawable/ic_launcher"         android:label="@string/app_name"         android:theme="@style/AppTheme" >     ...     <provider         android:name="com.example.android.datasync.provider.StubProvider"         android:authorities="com.example.android.datasync.provider"         android:exported="false"         android:syncable="true"/>     ...     </application> </manifest>

เมื่อสร้างทรัพยากร Dependency ที่เฟรมเวิร์กอะแดปเตอร์การซิงค์ต้องการแล้ว คุณจะทำสิ่งต่อไปนี้ได้ สร้างคอมโพเนนต์สรุปโค้ดการโอนข้อมูล คอมโพเนนต์นี้เรียกว่า อะแดปเตอร์การซิงค์ บทเรียนถัดไปจะแสดงวิธีเพิ่มคอมโพเนนต์นี้ลงในแอปของคุณ