안드로이드 ListView에 헤더 항목 추가하는 방법 완벽 정리

이 튜토리얼에서는 안드로이드 앱에서 ListView에 헤더(HEADER) 항목을 추가하는 방법을 단계별로 알아봅니다. 사용자가 이름을 입력하고 저장하면 리스트 최상단에 'HEADER'라는 헤더가 붙어서 데이터가 정렬되어 표시되는 예제입니다.

1단계: 새 프로젝트 생성

Android Studio를 실행한 뒤 File → New Project 메뉴로 이동하여 새 프로젝트를 생성합니다. 필요한 모든 세부 정보를 입력하고 프로젝트 설정을 완료하세요.

2단계: 레이아웃 파일 작성

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.

<?xml version = "1.0" encoding = "utf-8"?>
<LinearLayout 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"
    android:orientation = "vertical">

    <EditText
        android:id = "@+id/name"
        android:layout_width = "match_parent"
        android:hint = "Enter Name"
        android:layout_height = "wrap_content" />

    <LinearLayout
        android:layout_width = "wrap_content"
        android:layout_height = "wrap_content">
            <Button
                android:id = "@+id/save"
                android:text = "Save"
                android:layout_width = "wrap_content"
                android:layout_height = "wrap_content" />
            <Button
                android:id = "@+id/refresh"
                android:text = "Refresh"
                android:layout_width = "wrap_content"
                android:layout_height = "wrap_content" />
    </LinearLayout>
    <ListView
        android:id = "@+id/listView"
        android:layout_width = "match_parent"
        android:layout_height = "wrap_content">
    </ListView>
</LinearLayout>

위 레이아웃은 크게 세 부분으로 구성됩니다. 먼저 사용자가 이름을 입력할 수 있는 EditText, 그리고 데이터를 저장하는 Save 버튼과 리스트를 갱신하는 Refresh 버튼, 마지막으로 결과를 보여주는 ListView입니다.

사용자가 Save 버튼을 클릭하면 입력한 이름이 ArrayList에 저장되고, Refresh 버튼을 누르면 ListView의 변경 사항이 화면에 반영됩니다.

3단계: MainActivity 자바 코드 작성

src/MainActivity.java 파일에 아래 코드를 추가합니다.

package com.example.andy.myapplication;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.ArrayAdapter;
import android.widget.EditText;
import android.widget.ListView;
import android.widget.Toast;

import java.util.ArrayList;
import java.util.Collections;
import java.util.Comparator;
import java.util.HashSet;
import java.util.Set;

public class MainActivity extends AppCompatActivity {
    EditText name;
    ArrayAdapter arrayAdapter;
    ArrayList<String> array_list;
    Set set = new HashSet();
    private ListView listView;

    @Override
    protected void onCreate(Bundle readdInstanceState) {
        super.onCreate(readdInstanceState);
        setContentView(R.layout.activity_main);
        array_list = new ArrayList<String>();
        array_list.ensureCapacity(20);
        name = findViewById(R.id.name);
        listView = findViewById(R.id.listView);
        findViewById(R.id.refresh).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                arrayAdapter.notifyDataSetChanged();
                listView.invalidateViews();
                listView.refreshDrawableState();
            }
        });

        findViewById(R.id.save).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if (!name.getText().toString().isEmpty()) {
                    set.add(name.getText().toString());
                    array_list.clear();
                    if (array_list.isEmpty()) {
                        array_list.add(0, "HEADER");
                        array_list.addAll(set);
                        Collections.sort(array_list, new Comparator<String>() {
                            @Override
                            public int compare(String o1, String o2) {
                                return o1.compareTo(o2);
                            }
                        });
                        array_list.trimToSize();
                        arrayAdapter = new ArrayAdapter(MainActivity.this, android.R.layout.simple_list_item_1, array_list);
                        listView.setAdapter(arrayAdapter);
                    } else {
                        listView.setVisibility(View.GONE);
                    }

                    Toast.makeText(MainActivity.this, "Inserted", Toast.LENGTH_LONG).show();
                } else {
                    name.setError("Enter NAME");
                }
            }
        });
    }
}

코드 핵심 로직 설명

이 예제의 핵심은 다음과 같습니다.

첫째, 입력값의 중복을 방지하기 위해 HashSet을 사용해 이름 데이터를 관리합니다.

둘째, Save 버튼 클릭 시 array_list.add(0, "HEADER") 코드를 통해 리스트의 0번 인덱스, 즉 최상단에 'HEADER'라는 헤더 항목을 삽입합니다.

셋째, Collections.sort()와 Comparator를 활용해 전체 리스트를 사전순으로 정렬한 뒤 ArrayAdapter에 연결하여 ListView에 표시합니다.

넷째, Refresh 버튼을 누르면 notifyDataSetChanged()와 invalidateViews()를 호출해 화면의 리스트를 즉시 갱신합니다.

4단계: 앱 실행 및 결과 확인

실제 안드로이드 기기를 컴퓨터에 연결한 상태에서 앱을 실행해 보겠습니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 Run(실행) 아이콘을 클릭하세요. 실행 옵션에서 연결된 모바일 기기를 선택하면 기기 화면에 앱이 표시됩니다.

실행 결과를 보면, 이름을 입력하고 저장할 때마다 리스트의 맨 위에는 'HEADER' 항목이 유지되고 그 아래에 입력된 이름들이 사전순으로 정렬되어 추가되는 것을 확인할 수 있습니다. 이처럼 ArrayList의 첫 번째 위치에 헤더 문자열을 삽입하는 간단한 방식으로 ListView에 헤더 항목을 손쉽게 구현할 수 있습니다.