#Android

RecyclerView Example

• 안드로이드 v7의 RecyclerView 사용법에 대해 알아보자


1. 내용

리스트 아이템 하나를 코딩한 뒤, 이 아이템을 계속 반복하여 사용(Recycle)하며 리스트를 보인다.

example_view

 

2. 코드

  • RecyclerView를 관리할 Adapter 클래스를 새로 생성한다.
public class RcvAdapter extends RecyclerView.Adapter<RcvAdapter.ViewHolder> {

    private Context mContext;
    private ArrayList<DataForm> dataList;
    // 예시에서는 DataForm Class에 Data가 담겨있음을 전제로 한다. DataForm을 원하는 클래스로 바꿔주자.

    public RcvAdapter(Context mContext, ArrayList<DataForm> dataList) {
        this.mContext = mContext;
        this.dataList = dataList;
    }

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

    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item, parent, false);
        ViewHolder viewHolder = new ViewHolder(view);
        return viewHolder;
    }

    class ViewHolder extends RecyclerView.ViewHolder {

        public ViewHolder(View itemView) {
            super(itemView);

        }
    }

    @Override
    public void onBindViewHolder(final ViewHolder holder, final int position) {

    }

    private void removeItem(int position) {
        dataList.remove(position);
        notifyItemRemoved(position);
        notifyItemRangeChanged(position, dataList.size()); 
    }
}

 

  • RecyclerView를 사용할 Activity 클래스에서 수정한다.
public class MainActivity extends AppCompatActivity {

    RecyclerView rcv;
    RcvAdapter rcvAdapter;

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

        rcv = (RecyclerView) findViewById(R.id.main_rcv);
        rcv.setLayoutManager(new LinearLayoutManager(this));

        rcvAdapter = new RcvAdapter(this, list);
        rcv.setAdapter(rcvAdapter);
    }
}

 

  • List에 넣을 item을 xml 파일로 생성한다. 아래는 예제에서 쓴 예시 item.
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="?android:attr/selectableItemBackground"
    android:minHeight="56dp"
    android:orientation="horizontal">

    <ImageView
        android:id="@+id/item_iv_icon"
        android:layout_width="40dp"
        android:layout_height="40dp"
        android:layout_gravity="center_vertical"
        android:layout_marginStart="8dp"
        app:srcCompat="@drawable/ic_number_1" />

    <TextView
        android:id="@+id/item_tv_name"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_gravity="center_vertical"
        android:layout_marginEnd="16dp"
        android:layout_marginStart="8dp"
        android:text="data.name"
        android:textColor="@android:color/black"
        android:textSize="16sp" />
</LinearLayout>

 

  • 예제의 DataForm 클래스
public class DataForm {
    private String name;
    private int imageNumber;

    public DataForm(String name, int imageNumber) {
        this.name = name;
        this.imageNumber = imageNumber;
    }

    public String getName() {
        return name;
    }

    public int getImageNumber() {
        return imageNumber;
    }

    public void setName(String name) {
        this.name = name;
    }

    public void setImageNumber(int imageNumber) {
        this.imageNumber = imageNumber;
    }
}

 

3. 코드 설명

  • int getItemCount()

    RecyclerView에 item이 몇 개 있는지 설정한다.

    예제에서는 dataList의 size.

 

  • ViewHolder onCreateViewHolder

    ViewHolder를 생성한다.

      View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item, parent, false);
    

    위의 코드에서 R.layout.item 부분에 원하는 xml파일의 주소를 넣어주면 해당 xml 파일이 ViewHolder가 된다.

 

  • class ViewHolder extends RecyclerView.ViewHolder

    ViewHolder를 설정하는 객체 class.

    아래 예시 코드의 주석을 참고.

      class ViewHolder extends RecyclerView.ViewHolder {
            
          // ViewHolder 클래스 내에서 View들을 자유롭게 사용하기 위해 이 위치에 View들을 선언한다.
          ImageView ivIcon;
          TextView tvName;
    
          public ViewHolder(View itemView) {
              super(itemView);
                
              // ViewHolder의 생성자.
              // ViewHolder의 View들을 세팅해주고, onClickListener들을 설정해준다.
    
              ivIcon = (ImageView) itemView.findViewById(R.id.item_iv_icon);
              tvName = (TextView) itemView.findViewById(R.id.item_tv_name);
    
              itemView.setOnClickListener(new View.OnClickListener() {
                  @Override
                  public void onClick(View view) {
                      Toast.makeText(activity, "click " + dataList.get(getAdapterPosition()).getName(), Toast.LENGTH_SHORT).show();
                  }
              });
    
              itemView.setOnLongClickListener(new View.OnLongClickListener() {
                  @Override
                  public boolean onLongClick(View view) {
                      Toast.makeText(activity, "remove " + dataList.get(getAdapterPosition()).getName(), Toast.LENGTH_SHORT).show();
                      removeItem(getAdapterPosition());
                      return false;
                  }
              });
          }
      }
    

 

  • void onBindViewHolder

    각각의 리스트 아이템에 데이터를 입력(Bind)한다.

      @Override
      public void onBindViewHolder(final ViewHolder holder, final int position) {
          DataForm tmpData = dataList.get(position); // dataList에서 현재 position의 data를 받아온다.
    
          holder.tvName.setText(tmpData.getName());
          switch(tmpData.getImageNumber()){
              case 1:
                  holder.ivIcon.setImageResource(R.drawable.ic_number_1);
                  break;
              case 2:
                  holder.ivIcon.setImageResource(R.drawable.ic_number_2);
                  break;
              case 3:
                  holder.ivIcon.setImageResource(R.drawable.ic_number_3);
                  break;
              case 4:
                  holder.ivIcon.setImageResource(R.drawable.ic_number_4);
                  break;
          }
      }
    

 

  • void removeItem

    Item을 삭제할 때 호출할 함수.

      private void removeItem(int position) {
          dataList.remove(position); // dataList에서 삭제할 position의 아이템을 삭제한다.
            
          notifyItemRemoved(position); // RecyclerView에 해당 position의 아이템이 삭제되었음을 알린다. 
    
          notifyItemRangeChanged(position, dataList.size()); // 삭제된 position부터 마지막 position까지의 아이템들을 새로고침한다.
          // (중간의 아이템이 삭제될 경우 모든 아이템의 position이 1씩 줄어들기 때문.)
      }
    

 

  • Activity 내에서 선언

      rcv = (RecyclerView) findViewById(R.id.main_rcv); // 코드 내의 RecyclerView 객체와 xml상의 RecyclerView를 연결한다. 
        
      rcv.setLayoutManager(new LinearLayoutManager(this)); // LayoutManager를 설정해 준다.
    
      rcvAdapter = new RcvAdapter(this, list); // Adapter 객체를 생성한다.
        
      rcv.setAdapter(rcvAdapter); // rcv에 adapter를 설정한다.
    

 

4. 더 알아보기

4.1. 구분선을 넣고 싶을 경우

Activity 클래스에서 LinearLayoutManager를 이렇게 설정해준다.

LinearLayoutManager linearLayoutManager = new LinearLayoutManager(this);
rcv.addItemDecoration(new DividerItemDecoration(this, linearLayoutManager.getOrientation()));
rcv.setLayoutManager(linearLayoutManager);

 

4.2. onBindViewHolder 내에서 setOnClickListener 사용 자제

onBindViewHolder는 아이템 하나하나마다 실행되며 데이터를 뷰에 설정하는 함수이다.

이 때, onBindViewHolder에 setOnClickListener를 넣게 되면 실행될때마다 setOn을 하여 렉을 유발할 수 있다.

대신, setOnClickListener는 ViewHolder의 생성자에서 설정해주자.

position은 getAdapterPosition() 함수를 사용하여 얻으면 된다.

 

4.3. 데이터 새로고침

데이터 새로고침의 함수는 여러가지가 있다.

  • notifyDataSetChanged() : 데이터 전체를 새로고침한다. 전체값이 바뀌는 경우가 아니면 사용을 자제하자.

  • notifyItemChanged( int position ) : 해당 position을 새로고침한다.

  • notifyItemRangeChanged( int positionStart, int itemCount ) : positionStart 위치부터 itemCount 만큼 새로고침한다.

  • notifyItemRemoved( int position ) : 해당 position의 itemView를 삭제한다. item이 삭제되는 애니메이션 효과가 발생한다.

notifyDataSetChanged() 를 통해 전부 새로고침하는 것보다, 다른 함수를 사용하여 새로고침하는 것이 효율적이다.

 

5. 오류 해결방법

5.1. item이 하나만 보인다면

item xml 파일에서 최상위 view의 layout_height를 wrap_content 로 바꿔주자.

item이 화면을 가득 채워서 하나만 보이는 경우이다.



Posted by Penguo • Saturday, April 21, 2018