Android में SearchView से RecyclerView कैसे फ़िल्टर करें?

Android में SearchView से RecyclerView फ़िल्टर करना

यह ट्यूटोरियल दिखाता है कि कैसे RecyclerView में SearchView का उपयोग करके रियल-टाइम फ़िल्टरिंग इम्प्लीमेंट की जाती है, Filterable इंटरफेस और कस्टम एडाप्टर के साथ।

चरण 1: प्रोजेक्ट और निर्भरताएं

Android Studio में नया प्रोजेक्ट बनाएं। RecyclerView निर्भरता सुनिश्चित करें:

dependencies {
    implementation "androidx.recyclerview:recyclerview:1.3.2"
    implementation "androidx.cardview:cardview:1.0.0"
}

चरण 2: मेन लेआउट

res/layout/activity_main.xml:

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recyclerView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:padding="4dp"
        android:scrollbars="vertical"
        app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager" />
</androidx.constraintlayout.widget.ConstraintLayout>

चरण 3: आइटम लेआउट

res/layout/example_item.xml:

<?xml version="1.0" encoding="utf-8"?>
<androidx.cardview.widget.CardView
    xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_marginBottom="4dp"
    app:cardCornerRadius="8dp"
    app:cardElevation="2dp">
    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:padding="16dp">
        <ImageView
            android:id="@+id/image_view"
            android:layout_width="50dp"
            android:layout_height="50dp"
            android:padding="4dp" />
        <TextView
            android:id="@+id/text_view1"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_toEndOf="@id/image_view"
            android:layout_alignParentTop="true"
            android:layout_marginStart="16dp"
            android:text="लाइन 1"
            android:textSize="18sp"
            android:textStyle="bold"
            android:textColor="@android:color/black" />
        <TextView
            android:id="@+id/text_view2"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_toEndOf="@id/image_view"
            android:layout_below="@id/text_view1"
            android:layout_marginStart="16dp"
            android:layout_marginTop="4dp"
            android:text="लाइन 2"
            android:textSize="14sp" />
    </RelativeLayout>
</androidx.cardview.widget.CardView>

चरण 4: डेटा मॉडल

src/ExampleItem.java:

package com.app.sample;

public class ExampleItem {
    private int imageResource;
    private String text1;
    private String text2;

    public ExampleItem(int imageResource, String text1, String text2) {
        this.imageResource = imageResource;
        this.text1 = text1;
        this.text2 = text2;
    }

    public int getImageResource() { return imageResource; }
    public String getText1() { return text1; }
    public String getText2() { return text2; }
}

चरण 5: फिल्टरेबल एडाप्टर

src/ExampleAdapter.java - Filterable इम्प्लीमेंट करता है:

package com.app.sample;

import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.Filter;
import android.widget.Filterable;
import android.widget.ImageView;
import android.widget.TextView;
import androidx.annotation.NonNull;
import androidx.recyclerview.widget.RecyclerView;
import java.util.ArrayList;
import java.util.List;

public class ExampleAdapter extends RecyclerView.Adapter<ExampleAdapter.ExampleViewHolder> implements Filterable {
    private List<ExampleItem> exampleList;
    private List<ExampleItem> exampleListFull;

    public ExampleAdapter(List<ExampleItem> exampleList) {
        this.exampleList = exampleList;
        this.exampleListFull = new ArrayList<>(exampleList);
    }

    @NonNull
    @Override
    public ExampleViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View v = LayoutInflater.from(parent.getContext()).inflate(R.layout.example_item, parent, false);
        return new ExampleViewHolder(v);
    }

    @Override
    public void onBindViewHolder(@NonNull ExampleViewHolder holder, int position) {
        ExampleItem currentItem = exampleList.get(position);
        holder.imageView.setImageResource(currentItem.getImageResource());
        holder.textView1.setText(currentItem.getText1());
        holder.textView2.setText(currentItem.getText2());
    }

    @Override
    public int getItemCount() {
        return exampleList.size();
    }

    @Override
    public Filter getFilter() {
        return exampleFilter;
    }

    private final Filter exampleFilter = new Filter() {
        @Override
        protected FilterResults performFiltering(CharSequence constraint) {
            List<ExampleItem> filteredList = new ArrayList<>();
            
            if (constraint == null || constraint.length() == 0) {
                filteredList.addAll(exampleListFull);
            } else {
                String filterPattern = constraint.toString().toLowerCase().trim();
                for (ExampleItem item : exampleListFull) {
                    // text1 या text2 में खोजें
                    if (item.getText1().toLowerCase().contains(filterPattern) ||
                        item.getText2().toLowerCase().contains(filterPattern)) {
                        filteredList.add(item);
                    }
                }
            }
            
            FilterResults results = new FilterResults();
            results.values = filteredList;
            return results;
        }

        @Override
        protected void publishResults(CharSequence constraint, FilterResults results) {
            exampleList.clear();
            exampleList.addAll((List) results.values);
            notifyDataSetChanged();
        }
    };

    static class ExampleViewHolder extends RecyclerView.ViewHolder {
        ImageView imageView;
        TextView textView1, textView2;

        ExampleViewHolder(View itemView) {
            super(itemView);
            imageView = itemView.findViewById(R.id.image_view);
            textView1 = itemView.findViewById(R.id.text_view1);
            textView2 = itemView.findViewById(R.id.text_view2);
        }
    }
}

चरण 6: मेनू में SearchView

res/menu/example_menu.xml:

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto">
    <item
        android:id="@+id/action_search"
        android:title="खोजें"
        android:icon="@android:drawable/ic_menu_search"
        app:showAsAction="ifRoom|collapseActionView"
        app:actionViewClass="androidx.appcompat.widget.SearchView" />
</menu>

चरण 7: MainActivity में इंटीग्रेशन

src/MainActivity.java:

package com.app.sample;

import android.os.Bundle;
import android.view.Menu;
import android.view.MenuInflater;
import android.view.MenuItem;
import android.view.inputmethod.EditorInfo;
import android.widget.SearchView;
import androidx.appcompat.app.AppCompatActivity;
import androidx.recyclerview.widget.LinearLayoutManager;
import androidx.recyclerview.widget.RecyclerView;
import java.util.ArrayList;
import java.util.List;

public class MainActivity extends AppCompatActivity {
    private ExampleAdapter adapter;
    private List<ExampleItem> exampleList;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        fillExampleList();
        setUpRecyclerView();
    }

    private void fillExampleList() {
        exampleList = new ArrayList<>();
        exampleList.add(new ExampleItem(R.drawable.ic_android, "Android", "Mobile OS"));
        exampleList.add(new ExampleItem(R.drawable.ic_audio, "Audio", "Music Player"));
        exampleList.add(new ExampleItem(R.drawable.ic_sun, "Sun", "Weather App"));
        exampleList.add(new ExampleItem(R.drawable.ic_android, "Android Studio", "IDE"));
        exampleList.add(new ExampleItem(R.drawable.ic_audio, "Audio Recorder", "Voice Memo"));
        exampleList.add(new ExampleItem(R.drawable.ic_sun, "Sunrise Alarm", "Clock"));
        // और आइटम्स जोड़ें...
    }

    private void setUpRecyclerView() {
        RecyclerView recyclerView = findViewById(R.id.recyclerView);
        recyclerView.setHasFixedSize(true);
        recyclerView.setLayoutManager(new LinearLayoutManager(this));
        adapter = new ExampleAdapter(exampleList);
        recyclerView.setAdapter(adapter);
    }

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        MenuInflater inflater = getMenuInflater();
        inflater.inflate(R.menu.example_menu, menu);
        
        MenuItem searchItem = menu.findItem(R.id.action_search);
        SearchView searchView = (SearchView) searchItem.getActionView();
        
        searchView.setImeOptions(EditorInfo.IME_ACTION_DONE);
        searchView.setQueryHint("खोजें...");
        
        searchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
            @Override
            public boolean onQueryTextSubmit(String query) {
                return false;
            }
            
            @Override
            public boolean onQueryTextChange(String newText) {
                adapter.getFilter().filter(newText);
                return false;
            }
        });
        
        return true;
    }
}

चरण 8: मैनिफेस्ट

स्टैंडर्ड कॉन्फ़िगरेशन।

एडवांस्ड फ़िल्टरिंग टिप्स

• डिबाउंस: तेज टाइपिंग पर परफॉरमेंस के लिए RxJava/Debounce उपयोग करें
• हाईलाइटिंग: SpannableString से मैचिंग टेक्स्ट हाईलाइट करें
• मल्टी-फील्ड सर्च: एक से अधिक फील्ड्स में खोजें (ऊपर उदाहरण में दिखाया गया)
• सेक्शन हेडर्स: फिल्टर्ड रिजल्ट्स में ग्रुपिंग के लिए हेडर आइटम्स जोड़ें
• एनिमेशन: DiffUtil और ListAdapter का उपयोग करके स्मूथ एनिमेशन

आधुनिक विकल्प: ListAdapter + DiffUtil

public class ExampleAdapter extends ListAdapter<ExampleItem, ExampleViewHolder> {
    public ExampleAdapter() {
        super(DIFF_CALLBACK);
    }
    
    private static final DiffUtil.ItemCallback<ExampleItem> DIFF_CALLBACK = 
        new DiffUtil.ItemCallback<ExampleItem>() {
            @Override
            public boolean areItemsTheSame(ExampleItem old, ExampleItem new) {
                return old.getText1().equals(new.getText1());
            }
            @Override
            public boolean areContentsTheSame(ExampleItem old, ExampleItem new) {
                return old.equals(new);
            }
        };
    // ... बाकी कोड
}