การทดสอบความชำนาญสำหรับ Proto DataStore:คู่มือปฏิบัติ

จากนั้นไปที่ 17 ของคุณ ไดเร็กทอรีและสร้างไฟล์ใหม่ โดยปกติ คุณจะมีคลาสพื้นที่เก็บข้อมูลที่โต้ตอบกับ Proto DataStore ของคุณ ดังนั้นคุณจึงสามารถตั้งชื่อไฟล์นี้เป็น YourRepositoryClassNameTest เราจะใช้ชื่อ 23 .

ก่อนที่เราจะเจาะลึกการทดสอบ Proto DataStore เราจำเป็นต้องสร้างอินสแตนซ์ก่อน หากคุณออนไลน์เพื่อค้นหาเอกสารเกี่ยวกับเรื่องนี้ มันก็ค่อนข้างเบาบาง

การสร้างอินสแตนซ์ Proto DataStore นั้นใช้กับบริบทส่วนกลางเช่นนั้น (เมื่อไม่ได้ใช้ในสถานการณ์การทดสอบ):

private val Context.myDataStore: DataStore<MyItem> by dataStore(
 fileName = DATA_STORE_FILE_NAME,
 serializer = MyItemSerializer
 )

คุณไม่สามารถทำสิ่งนี้ในคลาสทดสอบได้ เพราะถึงแม้คุณจะสามารถคัดลอกและวางโค้ดด้านบนได้ แต่คุณจะไม่สามารถ การเข้าถึง วัตถุ DataStore คุณสามารถรับบริบทของแอปพลิเคชันดังนี้:

ApplicationProvider.getApplicationContext()

แต่ 36 ของเรา วัตถุจะไม่สามารถใช้ได้ผ่านมัน

แล้วเราจะทำอย่างไร

ในบทความที่เชื่อมโยงด้านบน มีตัวอย่างวิธีที่เราสามารถสร้าง Preference DataStore โดยใช้เมธอด PreferenceDataStoreFactory.create

fun create( 
 corruptionHandler: ReplaceFileCorruptionHandler<Preferences>? = null, 
 migrations: List<DataMigration<Preferences>> = listOf(),
 scope: CoroutineScope = CoroutineScope(Dispatchers.IO + SupervisorJob()), 
 produceFile: () -> File): DataStore<Preferences>

แต่เนื่องจากเราไม่ได้ใช้ Preference DataStore นั่นจึงไม่เหมาะกับเรา สิ่งที่ได้ผลคือใช้เมธอด DataStoreFactory.create เช่นนี้:

fun <T : Any?> create( 
 serializer: Serializer<T>, 
 corruptionHandler: ReplaceFileCorruptionHandler<T>? = null, 
 migrations: List<DataMigration<T>> = listOf(), 
 scope: CoroutineScope = CoroutineScope(Dispatchers.IO + SupervisorJob()), produceFile: () -> File): DataStore<T>

มีข้อโต้แย้งหลายประการสำหรับวิธีนี้ (และบางข้อมีค่าเริ่มต้น) แต่เราไม่จำเป็นต้องส่งผ่านข้อโต้แย้งทั้งหมด เราจะส่งผ่าน:

• คลาสซีเรียลไลเซอร์ของเรา
• วิธีการแลมบ์ดาสำหรับการสร้างไฟล์สำหรับ Proto DataStore ของเรา

dataStore = DataStoreFactory.create( 
 produceFile = { 
 testContext.dataStoreFile(TEST_DATA_STORE_FILE_NAME) }, 
 serializer = MyItemSerializer 
 )

เราได้รับ 44 โดย:

private val testContext: Context = ApplicationProvider.getApplicationContext()

หลังจากที่สร้าง Proto DataStore ของเราสำเร็จแล้ว เราก็สามารถเขียนการทดสอบต่อไปได้ โปรดทราบว่าคุณมีคลาสพื้นที่เก็บข้อมูลที่ได้รับอินสแตนซ์ของ Proto DataStore เป็นการพึ่งพา ดังนั้นหลังจากสร้าง Proto DataStore เราจำเป็นต้องสร้างอินสแตนซ์ของคลาสพื้นที่เก็บข้อมูลของเรา

 private val repository = MyRepository(datastore)

ขั้นแรก เรามาสร้างการทดสอบเพื่อตรวจสอบสถานะ Proto DataStore เริ่มต้นของเรา Proto DataStore เองก็เปิดเผยโฟลว์ที่เราสามารถใช้ได้

@OptIn(ExperimentalCoroutinesApi::class)
 @Test
 fun repository_testFetchInitialState() {
 runTest {
 testScope.launch {
 val dataStoreObject = repository.myFlow.first()
 // Insert here whatever we want to assert from our
 // Proto DataStore. I.E. a flag whose initial value is false
 assert(dataStoreObject.myFlag == false) 
 }
 }
 }

JPOR คุณอาจสังเกตเห็นสิ่งนี้ก่อนหน้านี้ แต่เรากำลังใช้คำอธิบายประกอบ OptIn ที่นี่ เนื่องจาก (ปัจจุบัน) API ที่เราใช้อยู่ในขั้นทดลอง และต้องทำเครื่องหมายไว้เมื่อเราใช้งาน

เนื่องจากเรากำลังเข้าถึงโฟลว์ของ 55 ของเรา เราต้องล้อมมันไว้ใน 60 ของเรา . 77 ถูกสร้างขึ้นโดยการทำ:

@OptIn(ExperimentalCoroutinesApi::class)
private val dispatcher = TestCoroutineDispatcher()
@OptIn(ExperimentalCoroutinesApi::class)
private val testScope = TestCoroutineScope(dispatcher)

@OptIn(ExperimentalCoroutinesApi::class)
 @Test
 fun repository_testAdditionOfItem() {
 runTest {
 testScope.launch {
 //1
 val item: MyItem = MyItem.newBuilder().setItemId(UUID.randomUUID().toString())
 .setItemDescription(TEST_ITEM_DESCRIPTION).build()
 //2
 repository.updateItem(item)
 //3
 val items = repository.myFlow.first().itemsList
 assert(items.size == 1)
 //4
 assert(items[0].itemDescription.equals(TEST_ITEM_DESCRIPTION))
 }
 }
 }

@After
fun cleanup() {
 File(testContext.filesDir, "datastore").deleteRecursively()
}

@Before
 fun setup() {
 dataStore = DataStoreFactory.create(
 produceFile = {
 testContext.dataStoreFile(TEST_DATA_STORE_FILE_NAME)
 },
 serializer = MyItemSerializer
 )
 }