이 튜토리얼에서는 안드로이드 앱에서 SearchView를 사용해 리스트 데이터를 검색하는 방법을 단계별로 살펴봅니다. 검색창에 입력하는 즉시 ListView 항목이 실시간으로 필터링되고, 일치하는 결과가 없으면 토스트(Toast) 메시지로 사용자에게 알려주는 기능까지 함께 구현합니다.
1단계: 새 프로젝트 생성
Android Studio를 실행한 후 File ⇒ New Project로 이동하고, 새 프로젝트 생성에 필요한 정보를 모두 입력하여 프로젝트를 만듭니다.
2단계: 레이아웃 작성 (res/layout/activity_main.xml)
아래 코드를 res/layout/activity_main.xml에 추가합니다. 화면 상단에는 검색창 역할을 하는 SearchView가 배치되고, 그 아래에는 과일 목록을 표시할 ListView가 위치하도록 구성했습니다.
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
xmlns:android="https://schemas.android.com/apk/res/android"
xmlns:tools="https://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<ListView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:id="@+id/listView"
android:divider="#ad5"
android:dividerHeight="2dp"
android:layout_below="@+id/searchView"/>
<SearchView
android:id="@+id/searchView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:queryHint="Search Here"
android:iconifiedByDefault="false"
android:layout_alignParentTop="true"/>
</RelativeLayout>
레이아웃 주요 속성 설명
- queryHint: 검색창에 아무것도 입력하지 않았을 때 표시되는 힌트 문구입니다.
- iconifiedByDefault="false": 기본값인 축소된 아이콘 형태 대신, 항상 펼쳐진 검색창으로 표시합니다.
- divider / dividerHeight: ListView 항목 사이의 구분선 색상과 두께를 지정합니다.
3단계: MainActivity 작성 (src/MainActivity.java)
다음으로 MainActivity.java에 아래 코드를 추가합니다. 과일 이름 목록을 ArrayList에 담아 ArrayAdapter로 ListView에 연결한 뒤, SearchView의 OnQueryTextListener를 통해 검색어가 변경되거나 제출될 때마다 어댑터의 필터를 적용합니다.
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.SearchView;
import android.widget.Toast;
import java.util.ArrayList;
public class MainActivity extends AppCompatActivity {
SearchView searchView;
ListView listView;
ArrayList list;
ArrayAdapter adapter;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
searchView = findViewById(R.id.searchView);
listView = findViewById(R.id.listView);
list = new ArrayList<>();
list.add("Apple");
list.add("Banana");
list.add("Pineapple");
list.add("Orange");
list.add("Mango");
list.add("Grapes");
list.add("Lemon");
list.add("Melon");
list.add("Watermelon");
list.add("Papaya");
adapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1,list);
listView.setAdapter(adapter);
searchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
@Override
public boolean onQueryTextSubmit(String query) {
if(list.contains(query)){
adapter.getFilter().filter(query);
}else{
Toast.makeText(MainActivity.this, "No Match found",Toast.LENGTH_LONG).show();
}
return false;
}
@Override
public boolean onQueryTextChange(String newText) {
adapter.getFilter().filter(newText);
return false;
}
});
}
}
핵심 로직 설명
- onQueryTextChange(): 검색창의 텍스트가 한 글자라도 바뀔 때마다 호출되어, 입력값에 맞게 리스트를 즉시 필터링합니다.
- onQueryTextSubmit(): 검색 버튼을 눌러 쿼리를 제출할 때 호출되며, 목록에 해당 값이 있으면 필터링하고 없으면 "No Match found" 토스트를 표시합니다.
- adapter.getFilter().filter(): ArrayAdapter가 기본 제공하는 필터 기능으로, 별도의 필터 클래스를 작성하지 않아도 간편하게 검색 기능을 구현할 수 있습니다.
4단계: 매니페스트 설정 (androidManifest.xml)
마지막으로 androidManifest.xml에 아래 코드를 추가합니다. 이 예제는 인터넷 접근 등 별도의 권한이 필요하지 않으며, 기본적인 액티비티 등록만 포함되어 있습니다.
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample">
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
앱 실행 및 결과 확인
이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 모바일 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 Run 아이콘을 클릭하세요. 실행 옵션에서 자신의 모바일 기기를 선택하면, 기기 화면에 아래와 같은 기본 화면이 표시됩니다.
