RecyclerView란?
본격적인 예제에 앞서 안드로이드의 리사이클러뷰(RecyclerView)가 무엇인지 먼저 살펴보겠습니다. 리사이클러뷰는 기존 리스트뷰(ListView)를 개선한 고급 위젯으로, 뷰 홀더(ViewHolder) 디자인 패턴을 기반으로 동작합니다. 리사이클러뷰를 활용하면 그리드 형태와 목록 형태의 아이템을 모두 효율적으로 표시할 수 있습니다.
이 글에서는 학생 이름과 나이를 카드 형태로 보여주는 학생 명부 앱을 직접 만들어 보면서, 리사이클러뷰로 가로 스크롤 리스트뷰를 구현하는 방법을 단계별로 알아보겠습니다.
1단계 — 새 프로젝트 생성
안드로이드 스튜디오에서 File → New Project를 선택한 뒤, 필요한 정보를 모두 입력하여 새 프로젝트를 생성합니다.
2단계 — build.gradle에 라이브러리 의존성 추가
build.gradle 파일을 열고 리사이클러뷰(RecyclerView)와 카드뷰(CardView) 라이브러리 의존성을 추가합니다.
apply plugin: 'com.android.application'
android {
compileSdkVersion 28
defaultConfig {
applicationId "com.example.andy.tutorialspoint"
minSdkVersion 19
targetSdkVersion 28
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'com.android.support:appcompat-v7:28.0.0'
implementation 'com.android.support:design:28.0.0'
implementation 'com.android.support.constraint:constraint-layout:1.1.3'
implementation 'com.android.support:cardview-v7:28.0.0'
implementation 'com.android.support:recyclerview-v7:28.0.0'
testImplementation 'junit:junit:4.12'
androidTestImplementation 'com.android.support.test:runner:1.0.2'
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}3단계 — activity_main.xml 작성
res/layout/activity_main.xml 파일에 다음 코드를 추가합니다.
<?xml version = "1.0" encoding = "utf-8"?>
<RelativeLayout
xmlns:android = "https://schemas.android.com/apk/res/android"
xmlns:tools = "https://schemas.android.com/tools"
xmlns:app = "https://schemas.android.com/apk/res-auto"
android:layout_width = "match_parent"
android:layout_height = "match_parent"
app:layout_behavior = "@string/appbar_scrolling_view_behavior"
tools:showIn = "@layout/activity_main"
tools:context = ".MainActivity">
<android.support.v7.widget.RecyclerView
android:id = "@+id/recycler_view"
android:layout_width = "match_parent"
android:layout_height = "wrap_content"
android:scrollbars = "horizontal" />
</RelativeLayout>위 코드는 상위 레이아웃인 RelativeLayout 안에 리사이클러뷰를 배치하고, horizontal 스크롤바를 지정해 가로 방향 스크롤이 가능하도록 구성했습니다.
4단계 — MainActivity.java 작성
src/MainActivity.java 파일에 다음 코드를 추가합니다.
package com.example.andy.tutorialspoint;
import android.annotation.TargetApi;
import android.os.Build;
import android.os.Bundle;
import android.support.annotation.RequiresApi;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.DividerItemDecoration;
import android.support.v7.widget.GridLayoutManager;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
import android.view.View;
import android.widget.Button;
import android.widget.LinearLayout;
import android.widget.Toast;
import java.util.ArrayList;
import java.util.Collections;
import java.util.Comparator;
import java.util.List;
public class MainActivity extends AppCompatActivity {
private RecyclerView recyclerView;
private StudentAdapter studentAdapter;
private List studentDataList = new ArrayList<>();
@TargetApi(Build.VERSION_CODES.O)
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
recyclerView = findViewById(R.id.recycler_view);
studentAdapter = new StudentAdapter(studentDataList,MainActivity.this);
RecyclerView.LayoutManager manager = new LinearLayoutManager(this,LinearLayoutManager.HORIZONTAL, false);
recyclerView.setLayoutManager(manager);
recyclerView.setAdapter(studentAdapter);
StudentDataPrepare();
}
@RequiresApi(api = Build.VERSION_CODES.N)
private void StudentDataPrepare() {
studentData data = new studentData("sai", 25);
studentDataList.add(data);
data = new studentData("sai raj", 25);
studentDataList.add(data);
data = new studentData("raghu", 20);
studentDataList.add(data);
data = new studentData("raj", 28);
studentDataList.add(data);
data = new studentData("amar", 15);
studentDataList.add(data);
data = new studentData("bapu", 19);
studentDataList.add(data);
data = new studentData("chandra", 52);
studentDataList.add(data);
data = new studentData("deraj", 30);
studentDataList.add(data);
data = new studentData("eshanth", 28);
studentDataList.add(data);
Collections.sort(studentDataList, new Comparator() {
@Override
public int compare(studentData o1, studentData o2) {
return o1.name.compareTo(o2.name);
}
});
}
}위 코드에서는 리사이클러뷰에 학생 어댑터(StudentAdapter)를 연결했습니다. 어댑터에는 학생 이름과 나이가 담긴 studentDataList(ArrayList)를 전달합니다.
가로 방향 뷰를 구현하려면 아래와 같이 레이아웃 매니저를 설정해야 합니다.
RecyclerView.LayoutManager manager = new LinearLayoutManager(this,LinearLayoutManager.HORIZONTAL, false); recyclerView.setLayoutManager(manager);
LinearLayoutManager의 스크롤 방향을 HORIZONTAL로 지정했기 때문에 리스트가 가로 방향으로 스크롤됩니다.
5단계 — StudentAdapter.java 작성
src/StudentAdapter.java 파일의 내용입니다.
package com.example.andy.tutorialspoint;
import android.graphics.Color;
import android.support.annotation.NonNull;
import android.support.v7.widget.RecyclerView;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.LinearLayout;
import android.widget.TextView;
import java.util.List;
import java.util.Random;
class StudentAdapter extends RecyclerView.Adapter {
List<studentData> studentDataList;
public StudentAdapter(List studentDataList) {
this.studentDataList = studentDataList;
}
@NonNull
@Override
public MyViewHolder onCreateViewHolder(@NonNull ViewGroup viewGroup, int i) {
View itemView = LayoutInflater.from(viewGroup.getContext())
.inflate(R.layout.student_list_row, viewGroup, false);
return new MyViewHolder(itemView);
}
@Override
public void onBindViewHolder(MyViewHolder viewHolder, int i) {
studentData data = studentDataList.get(i);
Random rnd = new Random();
int currentColor = Color.argb(255, rnd.nextInt(256), rnd.nextInt(256), rnd.nextInt(256));
viewHolder.parent.setBackgroundColor(currentColor);
viewHolder.name.setText(data.name);
viewHolder.age.setText(String.valueOf(data.age));
}
@Override
public int getItemCount() {
return studentDataList.size();
}
class MyViewHolder extends RecyclerView.ViewHolder {
TextView name,age;
LinearLayout parent;
public MyViewHolder(View itemView) {
super(itemView);
parent = itemView.findViewById(R.id.parent);
name = itemView.findViewById(R.id.name);
age = itemView.findViewById(R.id.age);
}
}
}어댑터 클래스는 다음 네 가지 요소로 구성됩니다.
onCreateViewHolder(): 뷰 홀더를 생성하고 해당 뷰를 반환합니다.
onBindViewHolder(): 생성된 뷰 홀더에 데이터를 바인딩합니다.
getItemCount(): 리스트의 크기를 반환합니다.
MyViewHolder 클래스: RecyclerView.ViewHolder를 상속하는 내부 뷰 홀더 클래스입니다.
리사이클러뷰 아이템마다 배경색을 랜덤하게 지정하기 위해 안드로이드에 미리 정의된 Random 클래스로 임의 색상을 생성하고, 아래와 같이 아이템 뷰의 부모 레이아웃에 적용했습니다.
Random rnd = new Random(); int currentColor = Color.argb(255, rnd.nextInt(256), rnd.nextInt(256), rnd.nextInt(256)); viewHolder.parent.setBackgroundColor(currentColor);
6단계 — student_list_row.xml 작성
res/layout/student_list_row.xml 파일의 내용입니다.
<?xml version = "1.0" encoding = "utf-8"?>
<android.support.v7.widget.CardView xmlns:android = "https://schemas.android.com/apk/res/android"
xmlns:card_view = "https://schemas.android.com/apk/res-auto"
android:layout_width = "match_parent"
card_view:cardCornerRadius = "4dp"
android:id = "@+id/card_view"
android:layout_margin = "10dp"
android:layout_height = "200dp">
<LinearLayout
android:id = "@+id/parent"
android:layout_gravity = "center"
android:layout_width = "match_parent"
android:orientation = "vertical"
android:gravity = "center"
android:layout_height = "match_parent">
<TextView
android:id = "@+id/name"
android:layout_width = "wrap_content"
android:gravity = "center"
android:textSize = "25sp"
android:textColor = "#FFF"
android:layout_height = "wrap_content" />
<TextView
android:id = "@+id/age"
android:layout_width = "wrap_content"
android:gravity = "center"
android:textSize = "25sp"
android:textColor = "#FFF"
android:layout_height = "wrap_content" />
</LinearLayout>
</android.support.v7.widget.CardView>위 리스트 아이템 뷰는 카드뷰(CardView) 안에 이름과 나이를 표시하는 두 개의 텍스트뷰를 담고 있습니다. 카드뷰는 모서리 둥글기(cornerRadius)와 그림자 속성을 기본적으로 제공하므로, 이 예제에서는 cardCornerRadius 속성을 활용했습니다.
7단계 — studentData.java 작성
src/studentData.java 파일의 내용입니다.
class studentData {
String name;
int age;
public studentData(String name, int age) {
this.name = name;
this.age = age;
}
}위 코드는 학생 데이터 객체를 정의합니다. 이름(name)과 나이(age)를 필드로 가지는 단순한 모델 클래스입니다.
앱 실행하기
이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기가 컴퓨터에 연결되어 있다고 가정합니다. 안드로이드 스튜디오에서 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 Run 아이콘을 클릭하고, 실행할 모바일 기기를 선택하면 기기 화면에 앱이 표시됩니다.

리사이클러뷰를 가로 방향으로 스크롤하면 아래와 같은 결과를 확인할 수 있습니다.
