ডেটা স্ট্রিম (ভিউ) ট্রান্সফর্ম করা

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

আপনি যখন পেজ করা ডেটা নিয়ে কাজ করেন, তখন প্রায়ই আপনাকে ডেটা স্ট্রিম লোড করার সময় তা ট্রান্সফর্ম করতে হয়। যেমন, UI-তে দেখানোর আগে আপনাকে আইটেমের তালিকা ফিল্টার করতে বা আইটেমগুলিকে অন্য কোনও ধরনের আইটেমে পরিবর্তন করতে হতে পারে। ডেটা স্ট্রিম ট্রান্সফর্মেশনের আরেকটি সাধারণ ব্যবহার হল তালিকা বিভাজক যোগ করা।

আরও সাধারণভাবে, ডেটা স্ট্রিমে সরাসরি ট্রান্সফর্মেশন প্রয়োগ করলে, আপনি রিপোজিটরি কনস্ট্রাক্ট ও UI কনস্ট্রাক্ট আলাদা রাখতে পারবেন।

এই পৃষ্ঠায় ধরে নেওয়া হয়েছে যে আপনি পেজিং লাইব্রেরির প্রাথমিক ব্যবহার সম্পর্কে জানেন।

প্রাথমিক রূপান্তরণের নিয়ম প্রয়োগ করো

PagingData একটি রিঅ্যাক্টিভ স্ট্রিমে এনক্যাপসুলেট করা থাকে বলে, ডেটা লোড করা এবং তা দেখানোর মধ্যে আপনি ডেটার উপর ইনক্রিমেন্টাল ট্রান্সফর্ম অপারেশন প্রয়োগ করতে পারবেন।

স্ট্রিমে প্রতিটি PagingData অবজেক্টে রূপান্তরণের নিয়ম প্রয়োগ করতে, স্ট্রিমে map() অপারেশনের মধ্যে রূপান্তরণের নিয়মগুলি লিখুন:

জাভা

PagingRx.getFlowable(pager) // Type is Flowable<PagingData<User>>.
  // Map the outer stream so that the transformations are applied to
  // each new generation of PagingData.
  .map(pagingData -> {
    // Transformations in this block are applied to the items
    // in the paged data.
  });

জাভা

// Map the outer stream so that the transformations are applied to
// each new generation of PagingData.
Transformations.map(
  // Type is LiveData<PagingData<User>>.
  PagingLiveData.getLiveData(pager),
  pagingData -> {
    // Transformations in this block are applied to the items
    // in the paged data.
  });

ডেটা কনভার্ট করুন

ডেটার স্ট্রিমে সবচেয়ে প্রাথমিক অপারেশন হল এটিকে অন্য ধরনের ডেটায় পরিবর্তন করা। PagingData অবজেক্টে অ্যাক্সেস পাওয়ার পরে, আপনি PagingData অবজেক্টের মধ্যে থাকা পৃষ্ঠার তালিকায় প্রতিটি আইটেমে map() অপারেশন করতে পারবেন।

এর একটি সাধারণ ব্যবহার হল, নেটওয়ার্ক বা ডেটাবেস লেয়ার অবজেক্টকে UI লেয়ারে বিশেষভাবে ব্যবহৃত অবজেক্টে ম্যাপ করা। এই ধরনের ম্যাপ অপারেশন কীভাবে প্রয়োগ করতে হয় তা নিচের উদাহরণে দেখানো হয়েছে:

জাভা

// Type is Flowable<PagingData<User>>.
PagingRx.getFlowable(pager)
  .map(pagingData ->
    pagingData.map(UiModel.UserModel::new)
  )

জাভা

Transformations.map(
  // Type is LiveData<PagingData<User>>.
  PagingLiveData.getLiveData(pager),
  pagingData ->
    pagingData.map(UiModel.UserModel::new)
)

আরেকটি সাধারণ ডেটা কনভার্সন হল ব্যবহারকারীর থেকে ইনপুট নেওয়া, যেমন কোয়েরি স্ট্রিং এবং এটি দেখানোর জন্য অনুরোধের আউটপুটে কনভার্ট করা। এটি সেট-আপ করার জন্য ব্যবহারকারীর কোয়েরি ইনপুট শুনতে ও ক্যাপচার করতে, অনুরোধটি সম্পূর্ণ করতে এবং কোয়েরির ফলাফল UI-তে পুশ করতে হবে।

আপনি স্ট্রিম API ব্যবহার করে কোয়েরি ইনপুট শুনতে পারেন। আপনার ViewModel-এ স্ট্রিম রেফারেন্স রাখুন। UI লেয়ারের কাছে এটির সরাসরি অ্যাক্সেস থাকা উচিত নয়; এর পরিবর্তে, ব্যবহারকারীর কোয়েরি সম্পর্কে ViewModel-কে জানানোর জন্য একটি ফাংশন নির্ধারণ করুন।

জাভা

private BehaviorSubject<String> querySubject = BehaviorSubject.create("");

public void onQueryChanged(String query) {
  queryFlow.onNext(query)
}

জাভা

private MutableLiveData<String> queryLiveData = new MutableLiveData("");

public void onQueryChanged(String query) {
  queryFlow.setValue(query)
}

ডেটা স্ট্রিমে কোয়েরি ভ্যালু পরিবর্তন হলে, আপনি কোয়েরি ভ্যালুকে কাঙ্ক্ষিত ডেটার ধরনে পরিবর্তন করতে এবং UI লেয়ারে ফলাফল ফেরত দিতে অপারেশন করতে পারেন। নির্দিষ্ট কনভার্সন ফাংশনটি ব্যবহৃত ভাষা এবং ফ্রেমওয়ার্কের উপর নির্ভর করে, তবে তারা সকলেই একই ধরনের কার্যকারিতা প্রদান করে।

জাভা

Observable<User> querySearchResults =
  querySubject.switchMap(query -> userDatabase.searchBy(query));

জাভা

LiveData<User> querySearchResults = Transformations.switchMap(
  queryLiveData,
  query -> userDatabase.searchBy(query)
);

flatMapLatest বা switchMap-এর মতো অপারেশন ব্যবহার করলে, UI-তে শুধু লেটেস্ট ফলাফলই দেখানো হয়। ডেটাবেস অপারেশন সম্পূর্ণ হওয়ার আগে ব্যবহারকারী তার কোয়েরি ইনপুট পরিবর্তন করলে, এইসব অপারেশন পুরনো কোয়েরি থেকে পাওয়া ফলাফল বাতিল করে দেয় এবং অবিলম্বে নতুন সার্চ শুরু করে।

ডেটা ফিল্টার করুন

আরেকটি সাধারণ অপারেশন হল ফিল্টার করা। আপনি ব্যবহারকারীর থেকে পাওয়া মাপকাঠির ভিত্তিতে ডেটা ফিল্টার করতে পারেন অথবা অন্য কোনও মাপকাঠির ভিত্তিতে ডেটা লুকানোর প্রয়োজন হলে UI থেকে ডেটা সরিয়ে দিতে পারেন।

আপনাকে map() কলের মধ্যে এইসব ফিল্টার অপারেশন রাখতে হবে কারণ ফিল্টারটি PagingData অবজেক্টে প্রযোজ্য হয়। PagingData থেকে ডেটা ফিল্টার করা হয়ে গেলে, নতুন PagingData ইনস্ট্যান্স UI লেয়ারে পাস করা হয় যাতে সেটি দেখানো যায়।

জাভা

// Type is Flowable<PagingData<User>>.
PagingRx.getFlowable(pager)
  .map(pagingData ->
    pagingData.filter(user -> !user.isHiddenFromUi())
  )
}

জাভা

Transformations.map(
  // Type is LiveData<PagingData<User>>.
  PagingLiveData.getLiveData(pager),
  pagingData ->
    pagingData.filter(user -> !user.isHiddenFromUi())
)

তালিকা বিভাজক যোগ করুন

পেজিং লাইব্রেরি ডায়নামিক তালিকা বিভাজক সাপোর্ট করে। আপনি ডেটা স্ট্রিমে সরাসরি বিভাজক যোগ করে তালিকার পাঠযোগ্যতা উন্নত করতে পারেন, যেমন RecyclerView তালিকা আইটেম। ফলস্বরূপ, বিভাজকগুলি হল সম্পূর্ণ ফিচারযুক্ত ViewHolder অবজেক্ট, যা ইন্টারঅ্যাক্টিভিটি, অ্যাক্সেসিবিলিটি ফোকাস এবং View দ্বারা প্রদত্ত অন্যান্য সমস্ত ফিচার চালু করে।

আপনার পৃষ্ঠাভিত্তিক তালিকায় বিভাজক যোগ করার জন্য তিনটি ধাপ রয়েছে:

  1. বিভাজক আইটেম যোগ করার জন্য UI মডেল কনভার্ট করুন।
  2. ডেটা লোড করা এবং ডেটা দেখানোর মধ্যে ডাইনামিকভাবে বিভাজক যোগ করতে ডেটা স্ট্রিম ট্রান্সফর্ম করুন।
  3. বিভাজক আইটেম ম্যানেজ করতে UI আপডেট করুন।

UI মডেল কনভার্ট করুন

পেজিং লাইব্রেরি RecyclerView-এ প্রকৃত তালিকা আইটেম হিসেবে তালিকা বিভাজক যোগ করে, তবে বিভাজক আইটেমগুলিকে তালিকার ডেটা আইটেম থেকে আলাদা করা যেতে হবে যাতে সেগুলি একটি স্বতন্ত্র UI সহ একটি ভিন্ন ViewHolder প্রকারের সাথে আবদ্ধ হতে পারে। আপনার ডেটা ও সেপারেটর দেখানোর জন্য সাবক্লাস সহ Kotlin sealed class তৈরি করা হল এর সমাধান। বিকল্প হিসেবে, আপনি এমন একটি মূল ক্লাস তৈরি করতে পারেন যা আপনার তালিকা আইটেম ক্লাস এবং আপনার বিভাজক ক্লাস দ্বারা প্রসারিত হয়।

ধরুন, আপনি Userটি আইটেমের পৃষ্ঠাভিত্তিক তালিকায় বিভাজক যোগ করতে চান। নিম্নলিখিত স্নিপেট দেখায় যে কীভাবে একটি মূল ক্লাস তৈরি করতে হয় যেখানে ইনস্ট্যান্সগুলি হয় UserModel অথবা SeparatorModel হতে পারে:

জাভা

class UiModel {
  private UiModel() {}

  static class UserModel extends UiModel {
    @NonNull
    private String mId;
    @NonNull
    private String mLabel;

    UserModel(@NonNull String id, @NonNull String label) {
      mId = id;
      mLabel = label;
    }

    UserModel(@NonNull User user) {
      mId = user.id;
      mLabel = user.label;
    }

    @NonNull
    public String getId() {
      return mId;
    }

    @NonNull
    public String getLabel() {
      return mLabel;
      }
    }

    static class SeparatorModel extends UiModel {
    @NonNull
    private String mDescription;

    SeparatorModel(@NonNull String description) {
      mDescription = description;
    }

    @NonNull
    public String getDescription() {
      return mDescription;
    }
  }
}

জাভা

class UiModel {
  private UiModel() {}

  static class UserModel extends UiModel {
    @NonNull
    private String mId;
    @NonNull
    private String mLabel;

    UserModel(@NonNull String id, @NonNull String label) {
      mId = id;
      mLabel = label;
    }

    UserModel(@NonNull User user) {
      mId = user.id;
      mLabel = user.label;
    }

    @NonNull
    public String getId() {
      return mId;
    }

    @NonNull
    public String getLabel() {
      return mLabel;
      }
    }

    static class SeparatorModel extends UiModel {
    @NonNull
    private String mDescription;

    SeparatorModel(@NonNull String description) {
      mDescription = description;
    }

    @NonNull
    public String getDescription() {
      return mDescription;
    }
  }
}

ডেটা স্ট্রিম ট্রান্সফর্ম করুন

ডেটা স্ট্রিম লোড করার পরে এবং দেখানোর আগে আপনাকে অবশ্যই ট্রান্সফর্মেশন প্রয়োগ করতে হবে। ট্রান্সফর্মেশনকে নিম্নলিখিত কাজগুলি করতে হবে:

  • নতুন বেস আইটেমের ধরন দেখানোর জন্য লোড করা তালিকা আইটেম কনভার্ট করুন।
  • বিভাজক যোগ করতে PagingData.insertSeparators() পদ্ধতি ব্যবহার করুন।

ট্রান্সফর্মেশন অপারেশন সম্পর্কে আরও জানতে, প্রাথমিক ট্রান্সফর্মেশন প্রয়োগ করুন দেখুন।

নিম্নলিখিত উদাহরণে PagingData<User> স্ট্রিমকে বিভাজক সহ PagingData<UiModel> স্ট্রিমে আপডেট করার জন্য ট্রান্সফর্মেশন অপারেশন দেখানো হয়েছে:

জাভা

// Map outer stream, so you can perform transformations on each
// paging generation.
PagingRx.getFlowable(pager).map(pagingData -> {
  // First convert items in stream to UiModel.UserModel.
  PagingData<UiModel> uiModelPagingData = pagingData.map(
    UiModel.UserModel::new);

  // Insert UiModel.SeparatorModel, which produces PagingData of
  // generic type UiModel.
  return PagingData.insertSeparators(uiModelPagingData,
    (@Nullable UiModel before, @Nullable UiModel after) -> {
      if (before == null) {
        return new UiModel.SeparatorModel("HEADER");
      } else if (after == null) {
        return new UiModel.SeparatorModel("FOOTER");
      } else if (shouldSeparate(before, after)) {
        return new UiModel.SeparatorModel("BETWEEN ITEMS "
          + before.toString() + " AND " + after.toString());
      } else {
        // Return null to avoid adding a separator between two
        // items.
        return null;
      }
    });
});

জাভা

// Map outer stream, so you can perform transformations on each
// paging generation.
Transformations.map(PagingLiveData.getLiveData(pager),
  pagingData -> {
    // First convert items in stream to UiModel.UserModel.
    PagingData<UiModel> uiModelPagingData = pagingData.map(
      UiModel.UserModel::new);

    // Insert UiModel.SeparatorModel, which produces PagingData of
    // generic type UiModel.
    return PagingData.insertSeparators(uiModelPagingData,
      (@Nullable UiModel before, @Nullable UiModel after) -> {
        if (before == null) {
          return new UiModel.SeparatorModel("HEADER");
        } else if (after == null) {
          return new UiModel.SeparatorModel("FOOTER");
        } else if (shouldSeparate(before, after)) {
          return new UiModel.SeparatorModel("BETWEEN ITEMS "
            + before.toString() + " AND " + after.toString());
        } else {
          // Return null to avoid adding a separator between two
          // items.
          return null;
        }
      });
  });

UI-তে বিভাজক ম্যানেজ করা

শেষ ধাপ হল, বিভাজক আইটেমের ধরন যোগ করার জন্য আপনার UI পরিবর্তন করা। আপনার সেপারেটর আইটেমের জন্য লেআউট ও ভিউ হোল্ডার তৈরি করুন এবং লিস্ট অ্যাডাপ্টার পরিবর্তন করে ভিউ হোল্ডার টাইপ হিসেবে RecyclerView.ViewHolder ব্যবহার করুন যাতে এটি একাধিক ধরনের ভিউ হোল্ডার ম্যানেজ করতে পারে। বিকল্প হিসেবে, আপনি একটি সাধারণ বেস ক্লাস সংজ্ঞায়িত করতে পারেন যা আপনার আইটেম এবং বিভাজক ভিউ হোল্ডার ক্লাস উভয়কেই প্রসারিত করে।

এছাড়াও, আপনার তালিকা অ্যাডাপ্টারে নিম্নলিখিত পরিবর্তনগুলি করতে হবে:

  • বিভাজক তালিকা আইটেমগুলির জন্য onCreateViewHolder() এবং onBindViewHolder() পদ্ধতিতে কেস যোগ করুন।
  • নতুন তুলনাকারী প্রয়োগ করুন।

জাভা

class UiModelAdapter extends PagingDataAdapter<UiModel, RecyclerView.ViewHolder> {
  UiModelAdapter() {
    super(new UiModelComparator(), Dispatchers.getMain(),
      Dispatchers.getDefault());
  }

  @NonNull
  @Override
  public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent,
    int viewType) {
    if (viewType == R.layout.item) {
      return new UserModelViewHolder(parent);
    } else {
      return new SeparatorModelViewHolder(parent);
    }
  }

  @Override
  public int getItemViewType(int position) {
    // Use peek over getItem to avoid triggering page fetch / drops, since
    // recycling views is not indicative of the user's current scroll position.
    UiModel item = peek(position);
    if (item instanceof UiModel.UserModel) {
      return R.layout.item;
    } else if (item instanceof UiModel.SeparatorModel) {
      return R.layout.separator_item;
    } else {
      throw new IllegalStateException("Unknown view");
    }
  }

  @Override
  public void onBindViewHolder(@NonNull RecyclerView.ViewHolder holder,
    int position) {
    if (holder instanceOf UserModelViewHolder) {
      UserModel userModel = (UserModel) getItem(position);
      ((UserModelViewHolder) holder).bind(userModel);
    } else {
      SeparatorModel separatorModel = (SeparatorModel) getItem(position);
      ((SeparatorModelViewHolder) holder).bind(separatorModel);
    }
  }
}

class UiModelComparator extends DiffUtil.ItemCallback<UiModel> {
  @Override
  public boolean areItemsTheSame(@NonNull UiModel oldItem,
    @NonNull UiModel newItem) {
    boolean isSameRepoItem = oldItem instanceof UserModel
      && newItem instanceof UserModel
      && ((UserModel) oldItem).getId().equals(((UserModel) newItem).getId());

    boolean isSameSeparatorItem = oldItem instanceof SeparatorModel
      && newItem instanceof SeparatorModel
      && ((SeparatorModel) oldItem).getDescription().equals(
      ((SeparatorModel) newItem).getDescription());

    return isSameRepoItem || isSameSeparatorItem;
  }

  @Override
  public boolean areContentsTheSame(@NonNull UiModel oldItem,
    @NonNull UiModel newItem) {
    return oldItem.equals(newItem);
  }
}

জাভা

class UiModelAdapter extends PagingDataAdapter<UiModel, RecyclerView.ViewHolder> {
  UiModelAdapter() {
    super(new UiModelComparator(), Dispatchers.getMain(),
      Dispatchers.getDefault());
  }

  @NonNull
  @Override
  public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent,
    int viewType) {
    if (viewType == R.layout.item) {
      return new UserModelViewHolder(parent);
    } else {
      return new SeparatorModelViewHolder(parent);
    }
  }

  @Override
  public int getItemViewType(int position) {
    // Use peek over getItem to avoid triggering page fetch / drops, since
    // recycling views is not indicative of the user's current scroll position.
    UiModel item = peek(position);
    if (item instanceof UiModel.UserModel) {
      return R.layout.item;
    } else if (item instanceof UiModel.SeparatorModel) {
      return R.layout.separator_item;
    } else {
      throw new IllegalStateException("Unknown view");
    }
  }

  @Override
  public void onBindViewHolder(@NonNull RecyclerView.ViewHolder holder,
    int position) {
    if (holder instanceOf UserModelViewHolder) {
      UserModel userModel = (UserModel) getItem(position);
      ((UserModelViewHolder) holder).bind(userModel);
    } else {
      SeparatorModel separatorModel = (SeparatorModel) getItem(position);
      ((SeparatorModelViewHolder) holder).bind(separatorModel);
    }
  }
}

class UiModelComparator extends DiffUtil.ItemCallback<UiModel> {
  @Override
  public boolean areItemsTheSame(@NonNull UiModel oldItem,
    @NonNull UiModel newItem) {
    boolean isSameRepoItem = oldItem instanceof UserModel
      && newItem instanceof UserModel
      && ((UserModel) oldItem).getId().equals(((UserModel) newItem).getId());

    boolean isSameSeparatorItem = oldItem instanceof SeparatorModel
      && newItem instanceof SeparatorModel
      && ((SeparatorModel) oldItem).getDescription().equals(
      ((SeparatorModel) newItem).getDescription());

    return isSameRepoItem || isSameSeparatorItem;
  }

  @Override
  public boolean areContentsTheSame(@NonNull UiModel oldItem,
    @NonNull UiModel newItem) {
    return oldItem.equals(newItem);
  }
}

ডুপ্লিকেট কাজ এড়িয়ে চলুন

অ্যাপ যাতে অপ্রয়োজনীয় কাজ না করে সেই বিষয়ে নজর রাখতে হবে। ডেটা ফেচ করা একটি ব্যয়বহুল অপারেশন এবং ডেটা ট্রান্সফর্ম করতেও মূল্যবান সময় লাগতে পারে। ডেটা লোড হয়ে গেলে এবং UI-তে দেখানোর জন্য প্রস্তুত হয়ে গেলে, এটি সেভ করা উচিত যাতে কনফিগারেশন পরিবর্তন হলে এবং UI আবার তৈরি করার প্রয়োজন হলে তা করা যায়।

cachedIn() অপারেশন, এর আগে হওয়া যেকোনও ট্রান্সফর্মেশনের ফলাফল ক্যাশ করে। তাই, আপনার ViewModel-এ cachedIn() শেষ কল হওয়া উচিত।

জাভা

// CoroutineScope helper provided by the lifecycle-viewmodel-ktx artifact.
CoroutineScope viewModelScope = ViewModelKt.getViewModelScope(viewModel);
PagingRx.cachedIn(
  // Type is Flowable<PagingData<User>>.
  PagingRx.getFlowable(pager)
    .map(pagingData -> pagingData
      .filter(user -> !user.isHiddenFromUi())
      .map(UiModel.UserModel::new)),
  viewModelScope);
}

জাভা

// CoroutineScope helper provided by the lifecycle-viewmodel-ktx artifact.
CoroutineScope viewModelScope = ViewModelKt.getViewModelScope(viewModel);
PagingLiveData.cachedIn(
  Transformations.map(
    // Type is LiveData<PagingData<User>>.
    PagingLiveData.getLiveData(pager),
    pagingData -> pagingData
      .filter(user -> !user.isHiddenFromUi())
      .map(UiModel.UserModel::new)),
  viewModelScope);

PagingData-এর স্ট্রিমের সাথে cachedIn() ব্যবহার করার ব্যাপারে আরও তথ্যের জন্য, PagingData-এর স্ট্রিম সেট-আপ করুন দেখুন।