[GPT가 알려주는] Android - RecyclerView

✅ [1] RecyclerView 구성요소 정리

구성 요소	역할	예시 파일 이름추천	폴더 위치
✅ Adapter	데이터를 ViewHolder에 바인딩하는 핵심 클래스	UserAdapter.kt	adapter 폴더
✅ ViewHolder	각 아이템 뷰를 담는 역할 (Adapter 안에 포함됨)	보통 inner class	adapter 내
✅ Item View (레이아웃 XML)	각 리스트 아이템의 UI	item_user.xml	res/layout/
✅ Data class	각 아이템의 데이터 구조	User.kt	model 폴더
✅ RecyclerView 사용하는       Fragment/Activity	화면 전체	UserListFragment.kt	ui 혹은 view 폴더

 

 

 

 

✅ [2] 어댑터(Adapter)란?

RecyclerView.Adapter는 리스트 형태의 데이터를 화면에 그려주는 브릿지 역할을 해요.

📦 구조 예시:

class UserAdapter(
    private val items: List<User>
) : RecyclerView.Adapter<UserAdapter.UserViewHolder>() {

    class UserViewHolder(view: View) : RecyclerView.ViewHolder(view) {
        val nameText = view.findViewById<TextView>(R.id.nameText)
    }

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): UserViewHolder {
        val view = LayoutInflater.from(parent.context)
            .inflate(R.layout.item_user, parent, false)
        return UserViewHolder(view)
    }

    override fun onBindViewHolder(holder: UserViewHolder, position: Int) {
        val item = items[position]
        holder.nameText.text = item.name
    }

    override fun getItemCount() = items.size
}

 

• onCreateViewHolder: XML을 inflate → ViewHolder 생성
• onBindViewHolder: 데이터 → 뷰에 바인딩
• getItemCount: 아이템 개수 반환

 

✅ [3] 추천 폴더 구조 예시

app/
├── adapter/
│   └── UserAdapter.kt
├── model/
│   └── User.kt
├── ui/
│   └── UserListFragment.kt
├── res/
│   └── layout/
│       └── item_user.xml

 

👉 adapter / model / ui 나누면 나중에 유지보수 훨씬 쉽습니다.

아래는 RecyclerView를 구성하는 핵심 4개 파일의 예시입니다:

 

✅ 1. User.kt (model/ 폴더)

// model/User.kt
data class User(
    val name: String,
    val age: Int
)

 

 

✅ 2. item_user.xml (res/layout/ 폴더)

<!-- res/layout/item_user.xml -->
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="16dp"
    android:orientation="vertical">

    <TextView
        android:id="@+id/textName"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="이름"
        android:textSize="16sp"
        android:textStyle="bold" />

    <TextView
        android:id="@+id/textAge"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="나이"
        android:textSize="14sp" />
</LinearLayout>

 

✅ 3. UserAdapter.kt (adapter/ 폴더)

// adapter/UserAdapter.kt
package your.package.name.adapter

import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import android.widget.TextView
import androidx.recyclerview.widget.RecyclerView
import your.package.name.R
import your.package.name.model.User

class UserAdapter(private val users: List<User>) :
    RecyclerView.Adapter<UserAdapter.UserViewHolder>() {

    inner class UserViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        val textName: TextView = itemView.findViewById(R.id.textName)
        val textAge: TextView = itemView.findViewById(R.id.textAge)
    }

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): UserViewHolder {
        val view = LayoutInflater.from(parent.context)
            .inflate(R.layout.item_user, parent, false)
        return UserViewHolder(view)
    }

    override fun onBindViewHolder(holder: UserViewHolder, position: Int) {
        val user = users[position]
        holder.textName.text = user.name
        holder.textAge.text = "${user.age}살"
    }

    override fun getItemCount(): Int = users.size
}

 

✅ 4. UserListFragment.kt (ui/ 폴더)

// ui/UserListFragment.kt
package your.package.name.ui

import android.os.Bundle
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import androidx.fragment.app.Fragment
import androidx.recyclerview.widget.LinearLayoutManager
import androidx.recyclerview.widget.RecyclerView
import your.package.name.R
import your.package.name.adapter.UserAdapter
import your.package.name.model.User

class UserListFragment : Fragment() {

    private lateinit var recyclerView: RecyclerView
    private val users = listOf(
        User("김철수", 28),
        User("이영희", 24),
        User("박지성", 35)
    )

    override fun onCreateView(
        inflater: LayoutInflater, container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
        val view = inflater.inflate(R.layout.fragment_user_list, container, false)
        recyclerView = view.findViewById(R.id.recyclerView)
        return view
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        recyclerView.layoutManager = LinearLayoutManager(requireContext())
        recyclerView.adapter = UserAdapter(users)
    }
}

 

그리고 fragment_user_list.xml도 필요해요:

<!-- res/layout/fragment_user_list.xml -->
<androidx.recyclerview.widget.RecyclerView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/recyclerView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

 

 

 

🗂️ 정리된 폴더 구조 예시

app/
├── adapter/
│   └── UserAdapter.kt
├── model/
│   └── User.kt
├── ui/
│   └── UserListFragment.kt
├── res/
│   └── layout/
│       ├── item_user.xml
│       └── fragment_user_list.xml