<div id="readability-page-1" class="page"><div><p id="c385">ConcatAdapter에 대해 알아봅니다.</p><figure><div role="button" tabindex="0"><p><img alt="" src="https://miro.medium.com/max/1400/0*OVoFhx-wB3nFK_aQ" sizes="" loading="lazy" role="presentation"></p></div><figcaption>Photo by <a href="https://unsplash.com/@kalvisuals?utm_source=medium&amp;utm_medium=referral" rel="noopener ugc nofollow" target="_blank">KAL VISUALS</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral" rel="noopener ugc nofollow" target="_blank">Unsplash</a></figcaption></figure><h2 id="6bb5">ConcatAdapter</h2><p id="e5c5"><code>ConcatAdapter</code>는 <code>recyclerview:1.2.0-alpha02</code> 버전에서 등장한 여러 개의 어댑터를 하나의 RecyclerView에 추가할 수 있는 어댑터입니다. 기존에는 모양이 다른 각각의 뷰를 리스트 형태로 보여주기 위해서는 <code>RecyclerView.Adapter</code>에서 뷰타입을 각각의 뷰마다 나눠주어야 했습니다. 그러다 보니 하나의 어댑터에 여러 가지 <code>ViewHolder</code>가 존재하게 되었고, 여러 로직이 결합되어 있었습니다. ConcatAdapter는 여러 가지 Adapter를 하나의 Adapter에 추가하여 하나의 RecyclerView에 추가할 수 있도록 구현되어 캡슐화와 재사용의 이점을 챙길 수 있습니다.</p><figure><div role="button" tabindex="0"><p><img alt="" src="https://miro.medium.com/max/1400/1*yv5E5vawRBuhhTWwAahMmA.png" sizes="" loading="lazy" role="presentation"></p></div></figure><h2 id="0dcf">ConcatAdapter의 Component</h2><h2 id="65e9">Config</h2><p id="d4e0">ConcatAdapter의 생성자에 <code>ConcatAdapter.Config</code> 객체를 넘겨서 기본적인 옵션을 지정할 수 있습니다.</p><figure></figure><p id="82d1"><code>Config</code>의 <code>isolateViewTypes</code>와 <code>stableIdMode</code>를 제어할 수 있는데, 각각 옵션에 대한 설명은 아래와 같습니다.</p><ul><li id="7dc1"><code>isolateViewTypes</code> : <code>false</code>인 경우 ConcatAdapter는 자신에게 할당된 모든 어댑터가 동일한 뷰 타입을 사용하여 동일한 뷰홀더를 참조하도록 글로벌한 뷰타입 풀을 공유한다고 가정하게 됩니다. 이 옵션을 <code>false</code>로 지정하면 중첩된 어댑터가 뷰홀더를 공유할 수 있게 되지만, 서로 다른 뷰홀더에 대해 동일한 뷰 타입을 리턴하는 충돌하는 뷰 타입을 가지지 않아야 함을 의미합니다. 기본적으로 <code>true</code>로 지정되어, 어댑터 간에 뷰타입을 분리하여 동일한 뷰홀더를 사용하지 않도록 합니다.</li><li id="88d0"><code>stableIdMode</code> : <code>StableIdMode</code>는 3가지가 존재합니다.</li></ul><ol><li id="cebc"><code>NO_STABLE_IDS</code> : 기본값으로 지정되는 값이며, <code>concatAdapter</code>에 추가되는 어댑터의 stable id를 무시합니다. stable id를 사용하는 adapter를 이 모드일때 추가할 경우 경고가 발생합니다.</li><li id="91d0"><code>ISOLATED_STABLE_IDS</code> : 이 모드에서 concatAdapter의 <code>hasStableIds()</code>는 <code>true</code>를 리턴하며, stable id가 지정된 adapter를 요구합니다. 서로 다른 두 어댑터가 서로 인지하지 못하고 동일한 stable id를 리턴할 수도 있으므로 <code>ConcatAdapter</code>는 각 어댑터의 id 풀을 서로 분리하여 리턴된 stable id를 덮어쓰도록 한 후에 <code>RecyclerView</code>에게 다시 알립니다. 이 모드에서는 <code>RecyclerView.Adapter.getItemId(int)</code>의 값과 <code>RecyclerView.ViewHolder.getItemId()</code>의 값이 다를 수 있습니다. 또한 stable id가 지정되지 않은 adapter를 추가할 경우 <code>IllegalArgumentException</code>이 발생합니다.</li><li id="0e45"><code>SHARED_STABLE_IDS</code> : <code>ISOLATED_STABLE_IDS</code>와 동일하게 <code>hasStableIds()</code>는 <code>true</code>를 리턴하고 stable id가 지정된 adapter를 요구합니다. 하지만 <code>ISOLATED_STABLE_IDS</code>와는 달리 리턴된 stable id를 재정의하지 않습니다. 이 모드에서 하위 어댑터는 서로를 인지해야 하며 어댑터 간에 아이템을 이동하지 않는 한 동일한 id를 리턴해서는 안 됩니다. stable id가 지정되지 않은 adapter를 추가할 경우 <code>IllegalArgumentException</code>이 발생합니다.</li></ol><p id="6115"><strong>ConcatAdapter의 생성자에 </strong><code><strong>Config</strong></code><strong>를 넘기지 않고 생성하면 </strong><code><strong>Config.DEFAULT</strong></code><strong>로 지정되며, </strong><code><strong>isolateViewTypes</strong></code><strong>는 </strong><code><strong>true</strong></code><strong>, </strong><code><strong>StableIdMode</strong></code><strong>는 </strong><code><strong>NO_STABLE_IDS</strong></code><strong>로 지정됩니다</strong>.</p><h2 id="e1e8">NestedAdapterWrapper</h2><figure></figure><p id="d385">ConcatAdapter의 대부분의 함수는 <code>ConcatAdapterController</code>에게 동작을 위임하고 있습니다. 그리고 <code>ConcatAdapterController</code>는 <code>NestedAdapterWrapper.Callback</code>을 구현하고 있는데, 먼저 <code>NestedAdapterWrapper</code> 에 대해 살펴보겠습니다.</p><p id="b03e"><code>NestedAdapterWrapper</code>는 우리가 추가한 Adapter를 래핑한 클래스입니다. <code>Callback</code>의 생김새는 <code>RecyclerView.AdapterDataObserver</code>와 동일한데, 우리가 <code>addAdapter</code> 메소드를 통해 Adapter를 추가할 때, <code>NestedAdapterWrapper</code>의 생성자의 파라미터에 추가하려는 Adapter와 <code>ConcatAdapterController</code>가 넘겨지고, <code>NestedAdapterWrapper</code>는 넘겨받은 <code>Callback(ConcatAdapterController)</code>를 내부의 필드로 가지고 있는 <code>AdapterDataObserver</code>에 매핑되어 호출됩니다.</p><figure></figure><p id="12b9">위 코드에서 <code>NestedAdapterWrapper</code>는 <code>ViewTypeStorage.ViewTypeLookup</code>, <code>StableIdStorage.StableIdLookup</code>이라는 객체를 필드로 보유하고 있음을 알 수 있습니다. 이 필드들을 통해 우리가 ConcatAdapter에 특정 아이템의 id나 뷰타입을 조회할 경우 리턴되는 값이 결정됩니다.</p><h2 id="ae03">ViewTypeStorage</h2><p id="6e27"><code>ViewTypeStorage</code>는 뷰타입을 저장 및 관리하는 스토리지 인터페이스입니다. <code>ConcatAdapterController</code>에서 필드로 보유하고 있습니다.</p><figure><figcaption>ConcatAdapterController는 ViewTypeStorage를 보유</figcaption></figure><p id="abed"><strong>getItemViewType</strong></p><p id="e67d">우리가 <code>getItemViewType</code> 함수를 호출하면 결국 <code>NestedAdapterWrapper</code>의 <code>getItemViewType</code>에 의해 뷰타입이 리턴되는데, 필드로 보유하고 있는 <code>ViewTypeStorage.ViewTypeLookup</code> 인터페이스 구현체에 의해 이 값이 결정됩니다.</p><figure><figcaption>NestedAdapterWrapper에서 ViewTypeLookup 필드의 값이 생성</figcaption></figure><figure></figure><p id="b181">그리고 <code>ViewTypeStorage</code>는 <code>ConcatAdapterController</code>의 생성자에서 생성되는데, <code>isolateViewTypes</code>의 값에 따라 생성되는 구현체가 2가지로 나뉘게 됩니다.</p><figure></figure><p id="e222"><code>IsolatedViewTypeStorage</code>, <code>SharedIdRangeViewTypeStorage</code>는 각각 <code>ViewTypeStorage.ViewTypeLookup</code> 인터페이스의 구현체 클래스인 <code>WrapperViewTypeLookup</code>이 내부에 선언되어 있는데, 이 구현체 클래스가 해당하는 Storage가 관리하는 뷰타입을 참조하여 뷰타입을 리턴합니다.</p><ul><li id="309b"><code>SharedIdRangeViewTypeStorage</code> : <code>getItemViewType</code>시 <code>NestedAdapterWrapper</code>에 연결된 Adapter의 뷰타입을 그대로 리턴합니다.</li><li id="ae2d"><code>IsolatedViewTypeStorage</code> : <code>getItemViewType</code>시 이미 저장되어 있는 뷰타입이라면 이를 리턴하고, 그렇지 않다면 유니크한 뷰타입을 생성하여 리턴합니다. (똑같은 뷰타입을 지정한 Adapter를 N개 추가해도, <code>getItemViewType</code>시 각각 다른 유니크한 뷰타입이 리턴됨)</li></ul><h2 id="8431">StableIdStorage</h2><p id="641f"><code>StableIdStorage</code>는 Stable id를 저장하는 스토리지 인터페이스입니다. 마찬가지로 <code>ConcatAdapterController</code>에서 필드로 보유하고 있습니다.</p><figure></figure><p id="5899"><strong>getItemId</strong></p><p id="6958">마찬가지로 <code>NestedAdapterWrapper</code>에서 <code>StableIdLookup</code>을 필드로 보유하고 있으며 <code>getItemId</code>를 호출할 경우 이 필드를 통해 <code>id</code>가 리턴됩니다.</p><figure></figure><p id="e80f"><code>StableIdLookup</code>의 구현체는 <code>StableIdStorage</code> 인터페이스의 3가지 구현체 내부에 선언되어 있으며 각각 이렇게 동작합니다.</p><ul><li id="48f0"><code>NoStableIdStorage</code> : 무조건 <code>RecyclerView.NO_ID</code>를 리턴 (기본값)</li><li id="547b"><code>SharedPoolStableIdStorage</code>: Adapter의 <code>getItemId</code> 값을 그대로 리턴</li><li id="6ad6"><code>IsolatedStableIdStorage</code> : 파라미터로 받은 adapter의 <code>getItemId</code> 값이 이미 저장되어 있다면 그 <code>id</code>를 리턴하거나 고유한 <code>id</code>를 생성하여 리턴</li></ul><h2 id="576f">Under the hood</h2><h2 id="a7e1">addAdapter</h2><p id="892c">우리가 adapter를 하나 추가하기 위해 <code>addAdapter</code>를 호출하면 내부적으로 어떤 동작이 발생할까요? ConcatAdapter는 <code>ConcatAdapterController</code>의 <code>addAdapter</code>를 호출하게 되고 <code>ConcatAdapterController</code>는 아래 프로세스를 따라 <code>addAdapter</code>를 수행합니다.</p><figure><div role="button" tabindex="0"><p><img alt="" src="https://miro.medium.com/max/1400/1*FhbG6dH1AhHqOMALC2Mx6A.png" sizes="" loading="lazy" role="presentation"></p></div></figure><p id="c499">Controller — <code>addAdapter</code></p><ol><li id="11ad"><strong>index 검사</strong> : 우리가 <code>addAdapter</code>에 <code>adapter</code>와 <code>index</code>를 함께 넘겨주어 추가하려고 하면 우선 이 <code>index</code>가 0에서 현재 어댑터들의 갯수 사이의 값인지 검사합니다. 만약 이 범위를 벗어나는 <code>index</code>값을 넘겨서 추가하려고 하면 <code>IndexOutOfBoundsException</code>가 발생합니다. <code>index</code>를 넘기지 않고 <code>addAdapter</code>를 호출할 경우는 내부적으로 맨 마지막 순서로 <code>adapter</code>를 추가하게 됩니다.</li><li id="e0f0"><strong>Stable id 검사</strong> : 현재 ConcatAdapter의 <code>StableIdMode</code>가 <code>NO_STABLE_IDS</code> 가 아니고, 추가하려는 <code>adapter</code>의 <code>hasStableIds</code>가 <code>true</code>일 경우 익셉션을 발생시킵니다. 그게 아니라 <code>StableIdMode</code>가 <code>NO_STABLE_IDS</code>이고 추가하려는 <code>adapter</code>의 <code>hasStableIds</code>가 <code>true</code>라면 경고를 로그로 출력합니다.</li><li id="a603"><strong>이미 추가된 adapter인지 검사</strong> : ConcatAdapter에 이미 추가된 <code>adapter</code>와 추가하려는 <code>adapter</code>가 일치할 경우 adapter를 추가하지 않고 그대로 리턴합니다.</li><li id="75f3">이 과정을 모두 통과하면, <code>NestedAdapterWrapper</code>를 생성한 후 추가하려는 adapter를 연결하고 이 <code>wrapper</code>를 캐싱합니다. 그리고 ConcatAdapter에 연결된 RecyclerView에 <code>onAttachedToRecyclerView</code> 메소드를 통해서 attach를 알리고, 만약 추가하려는 adapter에 이미 아이템이 존재한다면 <code>notifyItemRangeInserted</code>를 호출하여 리스트를 갱신합니다.</li><li id="5895">그리고 마지막으로 <code><a href="https://developer.android.com/reference/androidx/recyclerview/widget/RecyclerView.Adapter.StateRestorationPolicy" rel="noopener ugc nofollow" target="_blank">StateRestorationPolicy</a></code>를 갱신합니다.</li></ol><h2 id="085e">getItemViewType &amp; getItemId</h2><p id="139f">우리는 특정 위치 아이템의 뷰타입을 알아내기 위해서 ConcatAdapter의 <code>getItemViewType</code>을 호출할 수 있습니다. 그러면 ConcatAdapter는 내부적으로 <code>ConcatAdapterController</code>의 <code>getItemViewType</code>을 호출합니다.</p><figure></figure><p id="0ceb">또한 특정 위치 아이템의 id를 알아내기 위해서 <code>getItemId</code>를 호출할 수 있습니다. 마찬가지로 <code>ConcatAdapterController</code>의 <code>getItemId</code>를 호출합니다.</p><figure></figure><p id="dfe3"><code>wrapper</code>에서 호출하는 <code>getItemViewType</code>과 <code>getItemId</code>는 위에서 어떤 동작을 통해 값을 가져오는지 살펴봤으니, <code>findWrapperAndLocalPosition</code>과 <code>releaseWrapperAndLocalPosition</code>에 대해 살펴보겠습니다.</p><h2 id="e842">findWrapperAndLocalPosition</h2><p id="4384"><code>findWrapperAndLocalPosition</code>은 파라미터로 받는 <code>globalPosition</code>을 사용하여 정확한 position을 계산하는 함수입니다.</p><p id="3cfb">이 때 <code>WrapperAndLocalPosition</code> 클래스를 사용하는데, 이 클래스는 <code>ConcatAdapterController</code> 내부에 정의되어 있습니다.</p><figure></figure><p id="8f02"><code>findWrapperAndLocalPosition</code> 메소드는 아래와 같은 절차로 정확한 <code>position</code>과 해당하는 <code>Wrapper</code>를 보유한 <code>WrapperAndLocalPosition</code> 객체를 리턴합니다.</p><figure></figure><ol><li id="fc6d">Controller가 보유한 <code>mReusableHolder</code> 필드의 <code>mInUse</code> 플래그 값을 이용하여 캐싱한 <code>mReusableHolder</code>가 사용되지 않았다면 새로운 <code>WrapperAndLocalPosition</code> 객체를 생성합니다.</li><li id="188b">캐싱되어 있는 <code>List&lt;Wrapper&gt;</code> 필드를 반복문을 통해 <code>globalposition</code>을 캐싱된 wrapper의 item 갯수만큼 빼는 작업을 진행합니다.</li><li id="9302">만약 <code>globalPosition</code> 보다 wrapper의 item 갯수가 크다면 생성한 <code>WrapperAndLocalPosition</code> 객체의 <code>wrapper</code>와 <code>position</code>을 갱신하고 이를 리턴합니다.</li></ol><h2 id="5bfb">releaseWrapperAndLocalPosition</h2><p id="6bac"><code>getItemId</code>, <code>getItemViewType</code> 등 어떤 행위로 인해 <code>mReusableHolder</code> 가 사용되었다면 <code>releaseWrapperAndLocalPosition</code> 함수가 마지막에 호출됩니다. 이는 가능하면 새로운 할당 없이 wrapper와 position을 리턴할 수 있도록 하기 위함입니다.</p><figure></figure><h2 id="c8f8">마치며</h2><p id="5ceb">여러 타입의 데이터를 하나의 어댑터로 표현하며, 로직을 캡슐화 할 수 있는 ConcatAdapter를 사용하는 것은 좋은 방안일 수 있습니다. 하지만 <code>Config</code>와 내부 동작에 대해 자세히 이해하고 사용하지 않으면 의도치않은 동작을 마주하게 될 수 있을 것입니다.</p><h2 id="5bc3">참고</h2><ul><li id="927e"><a rel="noopener" href="/androiddevelopers/merge-adapters-sequentially-with-mergeadapter-294d2942127a">https://medium.com/androiddevelopers/merge-adapters-sequentially-with-mergeadapter-294d2942127a</a></li></ul></div></div>

Stories by hongbeom on Medium

ConcatAdapter에 대해 알아봅니다.
ConcatAdapter
ConcatAdapter는 recyclerview:1.2.0-alpha02 버전에서 등장한 여러 개의 어댑터를 하나의 RecyclerView에 추가할 수 있는 어댑터입니다. 기존에는 모양이 다른 각각의 뷰를 리스트 형태로 보여주기 위해서는 RecyclerView.Adapter에서 뷰타입을 각각의 뷰마다 나눠주어야 했습니다. 그러다 보니 하나의 어댑터에 여러 가지 ViewHolder가 존재하게 되었고, 여러 로직이 결합되어 있었습니다. ConcatAdapter는 여러 가지 Adapter를 하나의 Adapter에 추가하여 하나의 RecyclerView에 추가할 수 있도록 구현되어 캡슐화와 재사용의 이점을 챙길 수 있습니다.
ConcatAdapter의 Component
Config
ConcatAdapter의 생성자에 ConcatAdapter.Config 객체를 넘겨서 기본적인 옵션을 지정할 수 있습니다.
https://medium.com/media/81f4c820a514d0d5704cc8cf41a7bed3/href
Config의 isolateViewTypes와 stableIdMode를 제어할 수 있는데, 각각 옵션에 대한 설명은 아래와 같습니다.
isolateViewTypes : false인 경우 ConcatAdapter는 자신에게 할당된 모든 어댑터가 동일한 뷰 타입을 사용하여 동일한 뷰홀더를 참조하도록 글로벌한 뷰타입 풀을 공유한다고 가정하게 됩니다. 이 옵션을 false로 지정하면 중첩된 어댑터가 뷰홀더를 공유할 수 있게 되지만, 서로 다른 뷰홀더에 대해 동일한 뷰 타입을 리턴하는 충돌하는 뷰 타입을 가지지 않아야 함을 의미합니다. 기본적으로 true로 지정되어, 어댑터 간에 뷰타입을 분리하여 동일한 뷰홀더를 사용하지 않도록 합니다.
stableIdMode : StableIdMode는 3가지가 존재합니다.
NO_STABLE_IDS : 기본값으로 지정되는 값이며, concatAdapter에 추가되는 어댑터의 stable id를 무시합니다. stable id를 사용하는 adapter를 이 모드일때 추가할 경우 경고가 발생합니다.
ISOLATED_STABLE_IDS : 이 모드에서 concatAdapter의 hasStableIds()는 true를 리턴하며, stable id가 지정된 adapter를 요구합니다. 서로 다른 두 어댑터가 서로 인지하지 못하고 동일한 stable id를 리턴할 수도 있으므로 ConcatAdapter는 각 어댑터의 id 풀을 서로 분리하여 리턴된 stable id를 덮어쓰도록 한 후에 RecyclerView에게 다시 알립니다. 이 모드에서는 RecyclerView.Adapter.getItemId(int)의 값과 RecyclerView.ViewHolder.getItemId()의 값이 다를 수 있습니다. 또한 stable id가 지정되지 않은 adapter를 추가할 경우 IllegalArgumentException이 발생합니다.
SHARED_STABLE_IDS : ISOLATED_STABLE_IDS와 동일하게 hasStableIds()는 true를 리턴하고 stable id가 지정된 adapter를 요구합니다. 하지만 ISOLATED_STABLE_IDS와는 달리 리턴된 stable id를 재정의하지 않습니다. 이 모드에서 하위 어댑터는 서로를 인지해야 하며 어댑터 간에 아이템을 이동하지 않는 한 동일한 id를 리턴해서는 안 됩니다. stable id가 지정되지 않은 adapter를 추가할 경우 IllegalArgumentException이 발생합니다.
ConcatAdapter의 생성자에 Config를 넘기지 않고 생성하면 Config.DEFAULT로 지정되며, isolateViewTypes는 true, StableIdMode는 NO_STABLE_IDS로 지정됩니다.
NestedAdapterWrapper
https://medium.com/media/3e3e862f543803d7cf9a804b3b8ad3b1/href
ConcatAdapter의 대부분의 함수는 ConcatAdapterController에게 동작을 위임하고 있습니다. 그리고 ConcatAdapterController는 NestedAdapterWrapper.Callback을 구현하고 있는데, 먼저 NestedAdapterWrapper 에 대해 살펴보겠습니다.
NestedAdapterWrapper는 우리가 추가한 Adapter를 래핑한 클래스입니다. Callback의 생김새는 RecyclerView.AdapterDataObserver와 동일한데, 우리가 addAdapter 메소드를 통해 Adapter를 추가할 때, NestedAdapterWrapper의 생성자의 파라미터에 추가하려는 Adapter와 ConcatAdapterController가 넘겨지고, NestedAdapterWrapper는 넘겨받은 Callback(ConcatAdapterController)를 내부의 필드로 가지고 있는 AdapterDataObserver에 매핑되어 호출됩니다.
https://medium.com/media/574bbe91a77a1c5e58803f978e23c9cb/href
위 코드에서 NestedAdapterWrapper는 ViewTypeStorage.ViewTypeLookup, StableIdStorage.StableIdLookup이라는 객체를 필드로 보유하고 있음을 알 수 있습니다. 이 필드들을 통해 우리가 ConcatAdapter에 특정 아이템의 id나 뷰타입을 조회할 경우 리턴되는 값이 결정됩니다.
ViewTypeStorage
ViewTypeStorage는 뷰타입을 저장 및 관리하는 스토리지 인터페이스입니다. ConcatAdapterController에서 필드로 보유하고 있습니다.
https://medium.com/media/e9db92a0362c67fc37fbc5233d9d0934/href
getItemViewType
우리가 getItemViewType 함수를 호출하면 결국 NestedAdapterWrapper의 getItemViewType에 의해 뷰타입이 리턴되는데, 필드로 보유하고 있는 ViewTypeStorage.ViewTypeLookup 인터페이스 구현체에 의해 이 값이 결정됩니다.
https://medium.com/media/cc40965921cc2f896f75521af9f4e4c6/hrefhttps://medium.com/media/d821d9f5c38102a13b781f8bf60bd7ca/href
그리고 ViewTypeStorage는 ConcatAdapterController의 생성자에서 생성되는데, isolateViewTypes의 값에 따라 생성되는 구현체가 2가지로 나뉘게 됩니다.
https://medium.com/media/9cb89d31849ac331adaf9a414acf2013/href
IsolatedViewTypeStorage, SharedIdRangeViewTypeStorage는 각각 ViewTypeStorage.ViewTypeLookup 인터페이스의 구현체 클래스인 WrapperViewTypeLookup이 내부에 선언되어 있는데, 이 구현체 클래스가 해당하는 Storage가 관리하는 뷰타입을 참조하여 뷰타입을 리턴합니다.
SharedIdRangeViewTypeStorage : getItemViewType시 NestedAdapterWrapper에 연결된 Adapter의 뷰타입을 그대로 리턴합니다.
IsolatedViewTypeStorage : getItemViewType시 이미 저장되어 있는 뷰타입이라면 이를 리턴하고, 그렇지 않다면 유니크한 뷰타입을 생성하여 리턴합니다. (똑같은 뷰타입을 지정한 Adapter를 N개 추가해도, getItemViewType시 각각 다른 유니크한 뷰타입이 리턴됨)
StableIdStorage
StableIdStorage는 Stable id를 저장하는 스토리지 인터페이스입니다. 마찬가지로 ConcatAdapterController에서 필드로 보유하고 있습니다.
https://medium.com/media/86294b3cac7974760a653029ed8adfcc/href
getItemId
마찬가지로 NestedAdapterWrapper에서 StableIdLookup을 필드로 보유하고 있으며 getItemId를 호출할 경우 이 필드를 통해 id가 리턴됩니다.
https://medium.com/media/47351993c832bcca158a749b6b5ec2e7/href
StableIdLookup의 구현체는 StableIdStorage 인터페이스의 3가지 구현체 내부에 선언되어 있으며 각각 이렇게 동작합니다.
NoStableIdStorage : 무조건 RecyclerView.NO_ID를 리턴 (기본값)
SharedPoolStableIdStorage: Adapter의 getItemId 값을 그대로 리턴
IsolatedStableIdStorage : 파라미터로 받은 adapter의 getItemId 값이 이미 저장되어 있다면 그 id를 리턴하거나 고유한 id를 생성하여 리턴
Under the hood
addAdapter
우리가 adapter를 하나 추가하기 위해 addAdapter를 호출하면 내부적으로 어떤 동작이 발생할까요? ConcatAdapter는 ConcatAdapterController의 addAdapter를 호출하게 되고 ConcatAdapterController는 아래 프로세스를 따라 addAdapter를 수행합니다.
Controller — addAdapter
index 검사 : 우리가 addAdapter에 adapter와 index를 함께 넘겨주어 추가하려고 하면 우선 이 index가 0에서 현재 어댑터들의 갯수 사이의 값인지 검사합니다. 만약 이 범위를 벗어나는 index값을 넘겨서 추가하려고 하면 IndexOutOfBoundsException가 발생합니다. index를 넘기지 않고 addAdapter를 호출할 경우는 내부적으로 맨 마지막 순서로 adapter를 추가하게 됩니다.
Stable id 검사 : 현재 ConcatAdapter의 StableIdMode가 NO_STABLE_IDS 가 아니고, 추가하려는 adapter의 hasStableIds가 true일 경우 익셉션을 발생시킵니다. 그게 아니라 StableIdMode가 NO_STABLE_IDS이고 추가하려는 adapter의 hasStableIds가 true라면 경고를 로그로 출력합니다.
이미 추가된 adapter인지 검사 : ConcatAdapter에 이미 추가된 adapter와 추가하려는 adapter가 일치할 경우 adapter를 추가하지 않고 그대로 리턴합니다.
이 과정을 모두 통과하면, NestedAdapterWrapper를 생성한 후 추가하려는 adapter를 연결하고 이 wrapper를 캐싱합니다. 그리고 ConcatAdapter에 연결된 RecyclerView에 onAttachedToRecyclerView 메소드를 통해서 attach를 알리고, 만약 추가하려는 adapter에 이미 아이템이 존재한다면 notifyItemRangeInserted를 호출하여 리스트를 갱신합니다.
그리고 마지막으로 StateRestorationPolicy를 갱신합니다.
getItemViewType & getItemId
우리는 특정 위치 아이템의 뷰타입을 알아내기 위해서 ConcatAdapter의 getItemViewType을 호출할 수 있습니다. 그러면 ConcatAdapter는 내부적으로 ConcatAdapterController의 getItemViewType을 호출합니다.
https://medium.com/media/01e7d22feb8437f9aeb9a3609c5f4cf8/href
또한 특정 위치 아이템의 id를 알아내기 위해서 getItemId를 호출할 수 있습니다. 마찬가지로 ConcatAdapterController의 getItemId를 호출합니다.
https://medium.com/media/88c198cbecdc9d186dc66d3206b58c0f/href
wrapper에서 호출하는 getItemViewType과 getItemId는 위에서 어떤 동작을 통해 값을 가져오는지 살펴봤으니, findWrapperAndLocalPosition과 releaseWrapperAndLocalPosition에 대해 살펴보겠습니다.
findWrapperAndLocalPosition
findWrapperAndLocalPosition은 파라미터로 받는 globalPosition을 사용하여 정확한 position을 계산하는 함수입니다.
이 때 WrapperAndLocalPosition 클래스를 사용하는데, 이 클래스는 ConcatAdapterController 내부에 정의되어 있습니다.
https://medium.com/media/2f6fb358f7c4abd9c9dea5547ca69947/href
findWrapperAndLocalPosition 메소드는 아래와 같은 절차로 정확한 position과 해당하는 Wrapper를 보유한 WrapperAndLocalPosition 객체를 리턴합니다.
https://medium.com/media/a8592ab60cdf60021b02bc6ff4b73806/href
Controller가 보유한 mReusableHolder 필드의 mInUse 플래그 값을 이용하여 캐싱한 mReusableHolder가 사용되지 않았다면 새로운 WrapperAndLocalPosition 객체를 생성합니다.
캐싱되어 있는 List<Wrapper> 필드를 반복문을 통해 globalposition을 캐싱된 wrapper의 item 갯수만큼 빼는 작업을 진행합니다.
만약 globalPosition 보다 wrapper의 item 갯수가 크다면 생성한 WrapperAndLocalPosition 객체의 wrapper와 position을 갱신하고 이를 리턴합니다.
releaseWrapperAndLocalPosition
getItemId, getItemViewType 등 어떤 행위로 인해 mReusableHolder 가 사용되었다면 releaseWrapperAndLocalPosition 함수가 마지막에 호출됩니다. 이는 가능하면 새로운 할당 없이 wrapper와 position을 리턴할 수 있도록 하기 위함입니다.
https://medium.com/media/5e931438d826f10ba1857e8077e74051/href
마치며
여러 타입의 데이터를 하나의 어댑터로 표현하며, 로직을 캡슐화 할 수 있는 ConcatAdapter를 사용하는 것은 좋은 방안일 수 있습니다. 하지만 Config와 내부 동작에 대해 자세히 이해하고 사용하지 않으면 의도치않은 동작을 마주하게 될 수 있을 것입니다.
참고
https://medium.com/androiddevelopers/merge-adapters-sequentially-with-mergeadapter-294d2942127a
ConcatAdapter Deep Dive was originally published in hongbeomi dev on Medium, where people are continuing the conversation by highlighting and responding to this story.

ConcatAdapter Deep Dive

댓글