পেজিং ৩-এ মাইগ্রেট করুন (ভিউ)

ধারণা ও Jetpack Compose-এর প্রয়োগ

পেজিং ৩, পেজিং লাইব্রেরির আগের ভার্সন থেকে অনেকটাই আলাদা। এই ভার্সন উন্নত কার্যকারিতা প্রদান করে এবং পেজিং ২ ব্যবহার করার সময় সাধারণ সমস্যাগুলি সমাধান করে। আপনার অ্যাপ যদি আগে থেকেই পেজিং লাইব্রেরির পুরনো ভার্সন ব্যবহার করে, তাহলে পেজিং ৩-এ মাইগ্রেট করার বিষয়ে আরও জানতে এই পৃষ্ঠাটি পড়ুন।

আপনার অ্যাপে পেজিং লাইব্রেরির প্রথম ভার্সন হিসেবে পেজিং ৩ ব্যবহার করলে, ব্যবহার সংক্রান্ত প্রাথমিক তথ্যের জন্য পেজ করা ডেটা লোড ও ডিসপ্লে করুন বিকল্প দেখুন।

Paging 3-এ মাইগ্রেট করার সুবিধা

পেজিং ৩-এ নিম্নলিখিত ফিচারগুলি অন্তর্ভুক্ত রয়েছে যা লাইব্রেরির আগের ভার্সনে উপলভ্য ছিল না:

  • Kotlin কোরুটিন ও Flow-এর জন্য ফার্স্ট-ক্লাস সহায়তা।
  • RxJava Single বা Guava ListenableFuture প্রিমিটিভ ব্যবহার করে অ্যাসিঙ্ক লোডিংয়ের জন্য সহায়তা।
  • রেসপন্সিভ UI ডিজাইনের জন্য বিল্ট-ইন লোড স্টেট এবং ত্রুটি সংকেত, যার মধ্যে রয়েছে আবার চেষ্টা করুন এবং রিফ্রেশ করার কার্যকারিতা।
  • রিপোজিটরি লেয়ারে উন্নতি, যার মধ্যে রয়েছে বাতিল করার সুবিধা এবং একটি সহজ ডেটা সোর্স ইন্টারফেস।
  • প্রেজেন্টেশন লেয়ার, তালিকা বিভাজক, কাস্টম পৃষ্ঠা ট্রান্সফর্ম এবং লোডিং স্টেট হেডার ও ফুটারে উন্নতি।

আপনার অ্যাপ Paging 3-এ মাইগ্রেট করা

Paging 3-এ সম্পূর্ণভাবে মাইগ্রেট করতে, আপনাকে Paging 2 থেকে তিনটি প্রধান কম্পোনেন্টই মাইগ্রেট করতে হবে:

  • DataSourceটি ক্লাস
  • PagedList
  • PagedListAdapter

তবে, কিছু পেজিং ৩ কম্পোনেন্ট পেজিংয়ের আগের ভার্সনের সাথে ব্যাকওয়ার্ড-কম্প্যাটিবল। বিশেষ করে, Paging 3-এর PagingSource API, পুরনো ভার্সনের LivePagedListBuilder ও RxPagedListBuilder-এর ডেটা সোর্স হতে পারে। একইভাবে, Pager API, asPagingSourceFactory পদ্ধতির মাধ্যমে পুরনো DataSource অবজেক্ট ব্যবহার করতে পারে। এর অর্থ হল, আপনার কাছে মাইগ্রেশনের নিম্নলিখিত বিকল্পগুলি রয়েছে:

  • আপনি DataSource থেকে PagingSource-এ মাইগ্রেট করতে পারেন, তবে আপনার পেজিং ইমপ্লিমেন্টেশনের বাকি অংশ অপরিবর্তিত রাখতে পারেন।
  • আপনি PagedList এবং PagedListAdapter মাইগ্রেট করতে পারবেন, তবে এখনও পুরনো DataSource API ব্যবহার করতে পারবেন।
  • আপনার অ্যাপকে সম্পূর্ণভাবে Paging 3-তে মাইগ্রেট করতে, আপনি সম্পূর্ণ Paging ইমপ্লিমেন্টেশন মাইগ্রেট করতে পারেন।

এই পৃষ্ঠার বিভাগগুলি ব্যাখ্যা করে যে কীভাবে আপনার অ্যাপের প্রতিটি স্তরে পেজিং উপাদানগুলি মাইগ্রেট করতে হয়।

মাইগ্রেশন ওভারভিউ

আপনার RecyclerView ইমপ্লিমেন্টেশন বজায় রেখে পেজিং ৩-এ সম্পূর্ণভাবে মাইগ্রেট করতে, আপনাকে নিম্নলিখিত কম্পোনেন্ট আপডেট করতে হবে:

পেজিং ২ কম্পোনেন্ট

পেজিং ৩ রিপ্লেসমেন্ট

PageKeyedDataSource

PagingSource

PagedListAdapter

PagingDataAdapter

LivePagedListBuilder

Pager

BoundaryCallback

RemoteMediator

DataSourceটি ক্লাস

এই বিভাগে PagingSource ব্যবহার করার জন্য পুরনো পেজিং ইমপ্লিমেন্টেশন মাইগ্রেট করার জন্য প্রয়োজনীয় পরিবর্তনগুলি বর্ণনা করা হয়েছে।

Paging 2-এর PageKeyedDataSource, PositionalDataSource এবং ItemKeyedDataSource, Paging 3-এর PagingSource API-তে একত্রিত করা হয়েছে। পুরানো API ক্লাসের সব লোডিং পদ্ধতি PagingSource-এ একটি load পদ্ধতিতে একত্রিত করা হয়েছে। এটি কোড ডুপ্লিকেশন কমায় কারণ পুরনো API ক্লাসের ইমপ্লিমেন্টেশনে লোডিং পদ্ধতি জুড়ে বেশিরভাগ লজিক প্রায়শই একই রকম হয়।

পেজিং ৩-এ সব লোডিং পদ্ধতি প্যারামিটার LoadParams সিলড ক্লাস দিয়ে প্রতিস্থাপিত হয়, যার মধ্যে প্রতিটি লোডের ধরনের জন্য সাবক্লাস অন্তর্ভুক্ত থাকে। আপনার load পদ্ধতিতে লোড টাইপের মধ্যে পার্থক্য করতে হলে, LoadParams-এর কোন সাবক্লাস পাস করা হয়েছে তা চেক করুন: LoadParams.Refresh, LoadParams.Prepend, অথবা LoadParams.Append।

PagingSource প্রয়োগ করা সম্পর্কে আরও জানতে, ডেটা সোর্স নির্ধারণ করুন দেখুন।

'কী' রিফ্রেশ করুন

PagingSource-এর ইমপ্লিমেন্টেশনে উল্লেখ করতে হবে যে লোড করা পৃষ্ঠা ডেটার মাঝখান থেকে কীভাবে রিফ্রেশ করা আবার শুরু করা যায়। এটি করতে getRefreshKey প্রয়োগ করুন যাতে state.anchorPosition-কে সবচেয়ে সম্প্রতি অ্যাক্সেস করা ইন্ডেক্স হিসেবে ব্যবহার করে সঠিক প্রাথমিক কী ম্যাপ করা যায়।

Java (RxJava)

// Replaces ItemKeyedDataSource.
@Nullable
@Override
String getRefreshKey(state: PagingState<String, User>) {
  Integer anchorPosition = state.anchorPosition;
  if (anchorPosition == null) {
    return null;
  }

  return state.getClosestItemToPosition(anchorPosition);
}

// Replaces PositionalDataSource.
@Nullable
@Override
Integer getRefreshKey(state: PagingState<Integer, User>) {
  return state.anchorPosition;
}

Java (Guava/LiveData)

// Replaces ItemKeyedDataSource.
@Nullable
@Override
String getRefreshKey(state: PagingState<String, User>) {
  Integer anchorPosition = state.anchorPosition;
  if (anchorPosition == null) {
    return null;
  }

  return state.getClosestItemToPosition(anchorPosition);
}

// Replaces PositionalDataSource.
@Nullable
@Override
Integer getRefreshKey(state: PagingState<Integer, User>) {
  return state.anchorPosition;
}

PagedList

এই বিভাগে, Paging 3-এ Pager ও PagingData ব্যবহার করার জন্য পুরনো পেজিং ইমপ্লিমেন্টেশন মাইগ্রেট করার জন্য প্রয়োজনীয় সব পরিবর্তন সম্পর্কে বর্ণনা করা হয়েছে।

PagedListBuilderটি ক্লাস

PagingData, পেজিং ২ থেকে আগে থেকে থাকা PagedList-কে প্রতিস্থাপন করে। PagingData-এ মাইগ্রেট করতে, আপনাকে অবশ্যই নিম্নলিখিতগুলি আপডেট করতে হবে:

  • পেজিং কনফিগারেশন PagedList.Config থেকে PagingConfig-এ সরানো হয়েছে।
  • LivePagedListBuilder এবং RxPagedListBuilder-কে একত্রিত করে একটি Pager ক্লাস করা হয়েছে।
  • Pager তার . সহ একটি পর্যবেক্ষণযোগ্য Flow<PagingData> প্রকাশ করে।flow প্রপার্টি। RxJava এবং LiveData ভেরিয়েন্টও এক্সটেনশন প্রপার্টি হিসেবে উপলভ্য, যা স্ট্যাটিক পদ্ধতির মাধ্যমে Java থেকে কল করা যায় এবং যথাক্রমে paging-rxjava* এবং paging-runtime মডিউল থেকে প্রদান করা হয়।

Java (RxJava)

// CoroutineScope helper provided by the lifecycle-viewmodel-ktx artifact.
CoroutineScope viewModelScope = ViewModelKt.getViewModelScope(viewModel);
Pager<Integer, User> pager = Pager<>(
  new PagingConfig(/* pageSize = */ 20),
  () -> ExamplePagingSource(backend, query));

Flowable<PagingData<User>> flowable = PagingRx.getFlowable(pager);
PagingRx.cachedIn(flowable, viewModelScope);

Java (Guava/LiveData)

// CoroutineScope helper provided by the lifecycle-viewmodel-ktx artifact.
CoroutineScope viewModelScope = ViewModelKt.getViewModelScope(viewModel);
Pager<Integer, User> pager = Pager<>(
  new PagingConfig(/* pageSize = */ 20),
  () -> ExamplePagingSource(backend, query));

PagingLiveData.cachedIn(PagingLiveData.getLiveData(pager), viewModelScope);

Paging 3 ব্যবহার করে PagingData অবজেক্টের রিঅ্যাক্টিভ স্ট্রিম সেট-আপ করার ব্যাপারে আরও জানতে, PagingData-এর স্ট্রিম সেট-আপ করুন দেখুন।

PagedListAdapter

এই বিভাগে, Paging 3 থেকে PagingDataAdapter বা AsyncPagingDataDiffer ক্লাস ব্যবহার করার জন্য পুরনো পেজিং ইমপ্লিমেন্টেশন মাইগ্রেট করার জন্য প্রয়োজনীয় সব পরিবর্তনের বিবরণ দেওয়া হয়েছে।

পেজিং ২ PagedListAdapter ব্যবহার করে PagedList-কে RecyclerView-এর সাথে বাইন্ড করে। পেজিং ৩-এ, PagingData, PagedList-কে রিপ্লেস করে।

নতুন PagingData রিঅ্যাক্টিভ স্ট্রিম ম্যানেজ করার জন্য পেজিং 3 PagingDataAdapter প্রদান করে। তা না হলে, PagedListAdapter এবং PagingDataAdapter-এর ইন্টারফেস একই। PagedListAdapter থেকে PagingDataAdapter-এ মাইগ্রেট করতে, PagedListAdapter-এর পরিবর্তে PagingDataAdapter-এর ইমপ্লিমেন্টেশন পরিবর্তন করুন।

PagingDataAdapter সম্পর্কে আরও জানতে, RecyclerView অ্যাডাপ্টার সংজ্ঞায়িত করুন দেখুন।

AsyncPagedListDiffer

আপনি বর্তমানে AsyncPagedListDiffer-এর সাথে কাস্টম RecyclerView.Adapter ইমপ্লিমেন্টেশন ব্যবহার করলে, পরিবর্তে পেজিং ৩-এ দেওয়া AsyncPagingDataDiffer ব্যবহার করার জন্য আপনার ইমপ্লিমেন্টেশন মাইগ্রেট করুন:

Kotlin

AsyncPagingDataDiffer(diffCallback, listUpdateCallback)

Java (RxJava)

new AsyncPagingDataDiffer(diffCallback, listUpdateCallback);

Java (Guava/LiveData)

new AsyncPagingDataDiffer(diffCallback, listUpdateCallback);