{"id":478346,"date":"2026-05-03T04:11:45","date_gmt":"2026-05-03T04:11:45","guid":{"rendered":"https:\/\/savepearlharbor.com\/?p=478346"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=478346","title":{"rendered":"\u041e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u0435 Paginator \u0441 3.x \u0434\u043e 8.x"},"content":{"rendered":"<div xmlns=\"http:\/\/www.w3.org\/1999\/xhtml\">\n<blockquote>\n<p>\u0415\u0441\u043b\u0438 \u0432\u044b \u0441\u0438\u0434\u0435\u043b\u0438 \u043d\u0430 <strong>Paginator 3.3.0<\/strong> \u0438 \u0440\u0435\u0448\u0438\u043b\u0438 \u0441\u0440\u0430\u0437\u0443 \u043f\u0440\u044b\u0433\u043d\u0443\u0442\u044c \u043d\u0430 \u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u0443\u044e <strong>8.6.2<\/strong> \u2014<br \/> \u044d\u0442\u043e \u043d\u0435 \u0441\u043e\u0432\u0441\u0435\u043c \u00ab\u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u0435\u00bb, \u0430 \u0441\u043a\u043e\u0440\u0435\u0435 \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u044f \u043d\u0430, \u043f\u043e \u0441\u0443\u0442\u0438, \u0434\u0440\u0443\u0433\u0443\u044e \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0443. \u041a\u043e\u043d\u0446\u0435\u043f\u0446\u0438\u0438<br \/> \u0442\u0435 \u0436\u0435 (page state, \u0437\u0430\u043a\u043b\u0430\u0434\u043a\u0438, \u043f\u0440\u044b\u0436\u043a\u0438, snapshot\/cacheFlow), \u043d\u043e \u043c\u0435\u0436\u0434\u0443 \u044d\u0442\u0438\u043c\u0438 \u0432\u0435\u0440\u0441\u0438\u044f\u043c\u0438 \u2014<br \/> 200+ \u043a\u043e\u043c\u043c\u0438\u0442\u043e\u0432, <strong>\u043f\u044f\u0442\u044c \u043c\u0430\u0436\u043e\u0440\u043d\u044b\u0445 \u0440\u0435\u043b\u0438\u0437\u043e\u0432<\/strong> (4.x \u2192 8.x), \u043f\u0435\u0440\u0435\u0435\u0437\u0434 \u0441 JitPack \u043d\u0430 Maven Central,<br \/> \u043f\u0435\u0440\u0435\u0445\u043e\u0434 \u0441 Android-only \u043d\u0430 <strong>Kotlin Multiplatform<\/strong>, \u0440\u0430\u0437\u0434\u0435\u043b\u0435\u043d\u0438\u0435 \u043d\u0430 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u043e\u0432<br \/> \u0438 \u0434\u043e\u0432\u043e\u043b\u044c\u043d\u043e \u0430\u0433\u0440\u0435\u0441\u0441\u0438\u0432\u043d\u0430\u044f \u0441\u0435\u0440\u0438\u044f \u043f\u0435\u0440\u0435\u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u0438\u0439 \u043f\u0443\u0431\u043b\u0438\u0447\u043d\u043e\u0433\u043e API.<\/p>\n<\/blockquote>\n<p>\u042d\u0442\u0430 \u0441\u0442\u0430\u0442\u044c\u044f \u2014 \u043f\u0440\u043e \u0442\u043e, \u0447\u0442\u043e \u0440\u0435\u0430\u043b\u044c\u043d\u043e \u0438\u0437\u043c\u0435\u043d\u0438\u043b\u043e\u0441\u044c, \u0438 \u0432 \u043a\u0430\u043a\u043e\u043c \u043f\u043e\u0440\u044f\u0434\u043a\u0435 \u044f \u0431\u044b \u0440\u0435\u043a\u043e\u043c\u0435\u043d\u0434\u043e\u0432\u0430\u043b \u044d\u0442\u043e<br \/> \u0442\u0440\u043e\u0433\u0430\u0442\u044c. \u041e\u0441\u043d\u043e\u0432\u0430\u043d\u043e \u043d\u0430 \u0434\u0438\u0444\u0444\u0435 \u043c\u0435\u0436\u0434\u0443 (3.3.0) \u0438 (8.6.2).<\/p>\n<hr\/>\n<h3>1. \u041a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u0430 \u0438 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439<\/h3>\n<p>\u042d\u0442\u043e \u043f\u0435\u0440\u0432\u043e\u0435 \u0438 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e\u0435 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0435.<\/p>\n<p><strong>3.3.0 \u2014 JitPack:<\/strong><\/p>\n<pre><code class=\"kotlin\">repositories {    maven { setUrl(\"https:\/\/jitpack.io\") }}dependencies {    implementation(\"com.github.jamal-wia:Paginator:3.3.0\")}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:87px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p><strong>8.6.2 \u2014 Maven Central + BOM + \u043c\u043d\u043e\u0433\u043e\u043c\u043e\u0434\u0443\u043b\u044c\u043d\u0430\u044f \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430:<\/strong><\/p>\n<pre><code class=\"kotlin\">repositories {    mavenCentral() \/\/ JitPack \u0431\u043e\u043b\u044c\u0448\u0435 \u043d\u0435 \u043d\u0443\u0436\u0435\u043d}dependencies {    implementation(platform(\"io.github.jamal-wia:paginator-bom:8.6.2\"))    implementation(\"io.github.jamal-wia:paginator\")           \/\/ \u044f\u0434\u0440\u043e, \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e    implementation(\"io.github.jamal-wia:paginator-compose\")   \/\/ \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u043e \u2014 Compose \/ CMP    implementation(\"io.github.jamal-wia:paginator-view\")      \/\/ \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u043e \u2014 Android Views}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p><code>groupId<\/code> \u0441\u043c\u0435\u043d\u0438\u043b\u0441\u044f (<code>com.github.jamal-wia<\/code> \u2192 <code>io.github.jamal-wia<\/code>), \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442 \u0440\u0430\u0437\u0434\u0435\u043b\u0438\u043b\u0441\u044f<br \/> \u043d\u0430 <code>paginator<\/code> \/ <code>paginator-compose<\/code> \/ <code>paginator-view<\/code>, \u0438 \u043f\u043e\u044f\u0432\u0438\u043b\u0441\u044f <code>paginator-bom<\/code>, \u0447\u0442\u043e\u0431\u044b<br \/> \u0432\u0441\u0435 \u0442\u0440\u0438 \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u0430 \u043d\u0430 classpath \u043d\u0435 \u0440\u0430\u0437\u044a\u0435\u0437\u0436\u0430\u043b\u0438\u0441\u044c \u043f\u043e \u0432\u0435\u0440\u0441\u0438\u044f\u043c.<\/p>\n<h3>2. \u041f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u044b<\/h3>\n<p>3.3.0 \u0436\u0438\u0432\u0451\u0442 \u0432 <code>paginator\/src\/main\/java\/...<\/code> \u2014 \u044d\u0442\u043e <strong>Android-only<\/strong> \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430.<\/p>\n<p>8.6.2 \u2014 <strong>Kotlin Multiplatform<\/strong>: \u0438\u0441\u0445\u043e\u0434\u043d\u0438\u043a\u0438 \u043f\u0435\u0440\u0435\u0435\u0445\u0430\u043b\u0438 \u0432 <code>commonMain<\/code>, \u043e\u043f\u0443\u0431\u043b\u0438\u043a\u043e\u0432\u0430\u043d\u043d\u044b\u0435<br \/> \u0442\u0430\u0440\u0433\u0435\u0442\u044b \u2014 <strong>Android, JVM, iosX64, iosArm64, iosSimulatorArm64<\/strong>. \u0415\u0441\u043b\u0438 \u0443 \u0432\u0430\u0441 KMP-\u043f\u0440\u043e\u0435\u043a\u0442,<br \/> \u0442\u0435\u043f\u0435\u0440\u044c \u043c\u043e\u0436\u043d\u043e \u043a\u043b\u0430\u0441\u0442\u044c <code>paginator<\/code> \u043f\u0440\u044f\u043c\u043e \u0432 <code>commonMain.dependencies<\/code>, \u0438 Gradle \u0441\u0430\u043c \u043f\u043e\u0434\u0442\u044f\u043d\u0435\u0442<br \/> \u043d\u0443\u0436\u043d\u044b\u0439 \u043f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u0435\u043d\u043d\u044b\u0439 \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442 \u0438\u0437 KMP-\u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0445.<\/p>\n<h3>3. \u041d\u043e\u043c\u0435\u0440 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b: UInt \u2192 Int<\/h3>\n<p>\u0412 3.3.0 \u043d\u043e\u043c\u0435\u0440 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b \u0431\u044b\u043b <code>UInt<\/code> (<code>1u<\/code>, <code>BookmarkUInt(page = 5u)<\/code>, <code>page: UInt<\/code>). \u0412 8.6.2<br \/> \u044d\u0442\u043e <code><strong>Int<\/strong><\/code>. \u0412\u0441\u0435 \u0441\u0443\u0444\u0444\u0438\u043a\u0441\u044b <code>u<\/code> \u0438 \u043b\u044e\u0431\u044b\u0435 \u0443\u043f\u043e\u043c\u0438\u043d\u0430\u043d\u0438\u044f <code>UInt<\/code>\/<code>BookmarkUInt<\/code> \u043f\u0440\u0438\u0434\u0451\u0442\u0441\u044f \u043f\u0435\u0440\u0435\u043f\u0438\u0441\u0430\u0442\u044c.<\/p>\n<pre><code class=\"kotlin\">\/\/ 3.3.0paginator.setPageState(page = 1u, ...)paginator.bookmarks += BookmarkUInt(page = 5u)\/\/ 8.6.2paginator.setState(page = 1, ...)paginator.bookmarks += BookmarkInt(page = 5)<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0442\u0435\u043f\u0435\u0440\u044c \u0442\u0430\u043a\u043e\u0439: <code>page &gt;= 1<\/code>, \u0430 <code>0<\/code> \u0434\u043b\u044f \u043a\u043e\u043d\u0442\u0435\u043a\u0441\u0442\u043d\u044b\u0445 \u0441\u0442\u0440\u0430\u043d\u0438\u0446 \u043e\u0437\u043d\u0430\u0447\u0430\u0435\u0442 \u00ab\u0435\u0449\u0451 \u043d\u0435 \u043d\u0430\u0447\u0430\u043b\u0438\u00bb.<\/p>\n<h3>4. \u041b\u044f\u043c\u0431\u0434\u0430 load<\/h3>\n<p>\u042d\u0442\u043e, \u043f\u043e\u0436\u0430\u043b\u0443\u0439, \u043f\u0435\u0440\u0432\u043e\u0435 breaking-\u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0435, \u043a\u043e\u0442\u043e\u0440\u043e\u0435 \u0432\u044b \u0443\u0432\u0438\u0434\u0438\u0442\u0435, \u043a\u0430\u043a \u0442\u043e\u043b\u044c\u043a\u043e \u043d\u0430\u0447\u043d\u0451\u0442\u0435 \u043f\u0438\u0441\u0430\u0442\u044c \u043a\u043e\u0434.<\/p>\n<p><strong>3.3.0:<\/strong><\/p>\n<pre><code class=\"kotlin\">val paginator = Paginator&lt;Item&gt; { page: UInt -&gt;    repo.loadPage(page.toInt()) \/\/ \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 List&lt;Item&gt;}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p><strong>8.6.2:<\/strong><\/p>\n<pre><code class=\"kotlin\">val paginator = Paginator&lt;Item&gt; { page: Int -&gt;    LoadResult(repo.loadPage(page))    \/\/ \u0438\u043b\u0438 \u0441 \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u043c\u0438 API:    \/\/ LoadResult(items, MyMetadata(totalCount = response.total))}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041f\u043e\u043c\u0435\u043d\u044f\u043b\u043e\u0441\u044c \u0442\u0440\u0438 \u0432\u0435\u0449\u0438 \u0441\u0440\u0430\u0437\u0443: \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u043e \u043d\u0430\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f <code>load<\/code>, \u0430 \u043d\u0435 <code>source<\/code>; \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 \u0441\u0442\u0430\u043b <code>Int<\/code>;<br \/> \u043b\u044f\u043c\u0431\u0434\u0430 \u0442\u0435\u043f\u0435\u0440\u044c \u043e\u0431\u044f\u0437\u0430\u043d\u0430 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0442\u044c <code>LoadResult&lt;T&gt;<\/code> (<code>data<\/code> + \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u044b\u0439 <code>Metadata<\/code>).<br \/> <code>LoadResult<\/code> \u2014 \u043e\u0444\u0438\u0446\u0438\u0430\u043b\u044c\u043d\u0430\u044f \u0442\u043e\u0447\u043a\u0430 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u044f \u0434\u043b\u044f \u0432\u0441\u0435\u0433\u043e, \u0447\u0442\u043e \u0432\u044b \u0445\u043e\u0442\u0438\u0442\u0435 \u043f\u0440\u043e\u043a\u0438\u043d\u0443\u0442\u044c \u0432<br \/> <code>PageState.metadata<\/code>: total count, \u043a\u0443\u0440\u0441\u043e\u0440, \u0432\u0435\u0440\u0441\u0438\u044f \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b \u0438 \u0442.\u0434.<\/p>\n<h3>5. Paginator VS MutablePaginator<\/h3>\n<p>\u0412 3.3.0 \u043e\u0434\u0438\u043d \u043a\u043b\u0430\u0441\u0441 <code>Paginator<\/code> \u0443\u043c\u0435\u043b \u0432\u0441\u0451 \u2014 \u043d\u0430\u0432\u0438\u0433\u0430\u0446\u0438\u044e, <code>addElement<\/code>, <code>removeElement<\/code>, <code>resize<\/code>,<br \/> <code>setPageState<\/code>. \u041d\u0430\u0447\u0438\u043d\u0430\u044f \u0441 6.x \u044d\u0442\u043e \u0440\u0430\u0437\u0434\u0435\u043b\u0435\u043d\u043e:<\/p>\n<ul>\n<li>\n<p><code>Paginator&lt;T&gt;<\/code> \u2014 read-only, \u0442\u043e\u043b\u044c\u043a\u043e \u043d\u0430\u0432\u0438\u0433\u0430\u0446\u0438\u044f (<code>jump*<\/code>, <code>goNextPage<\/code>, <code>goPreviousPage<\/code>, <code>restart<\/code>, <code>refresh<\/code>).<\/p>\n<\/li>\n<li>\n<p><code>MutablePaginator&lt;T&gt;<\/code> \u2014 \u043d\u0430\u0441\u043b\u0435\u0434\u043d\u0438\u043a, \u0432 \u043d\u0451\u043c CRUD \u043f\u043e \u044d\u043b\u0435\u043c\u0435\u043d\u0442\u0430\u043c, <code>resize<\/code>, <code>setState<\/code>.<\/p>\n<\/li>\n<\/ul>\n<p>\u0415\u0441\u043b\u0438 \u0432\u044b \u0433\u0434\u0435-\u0442\u043e \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442\u0435 <code>addElement<\/code> \/ <code>removeElement<\/code> \/ <code>setPageState<\/code> \/ <code>resize<\/code> \/<br \/> <code>setState<\/code>, \u0442\u0438\u043f \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u0439 \u043d\u0443\u0436\u043d\u043e \u0441\u043c\u0435\u043d\u0438\u0442\u044c \u043d\u0430 <code>MutablePaginator&lt;T&gt;<\/code>. \u0414\u043b\u044f \u0447\u0438\u0441\u0442\u043e-\u0447\u0438\u0442\u0430\u044e\u0449\u0438\u0445<br \/> \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0435\u0432 \u043c\u043e\u0436\u043d\u043e \u043e\u0441\u0442\u0430\u0432\u0438\u0442\u044c <code>Paginator&lt;T&gt;<\/code> \u0438 \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u0431\u043e\u043b\u0435\u0435 \u0443\u0437\u043a\u0438\u0439 API.<\/p>\n<h3>6. \u0421\u043f\u0438\u0441\u043e\u043a \u043f\u0435\u0440\u0435\u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u0438\u0439 \u0438\u0437 5.0.0<\/h3>\n<p>\u0411\u043e\u0301\u043b\u044c\u0448\u0430\u044f \u0447\u0430\u0441\u0442\u044c \u043e\u0448\u0438\u0431\u043e\u043a \u043a\u043e\u043c\u043f\u0438\u043b\u044f\u0446\u0438\u0438 \u043f\u043e\u0441\u043b\u0435 \u0430\u043f\u0433\u0440\u0435\u0439\u0434\u0430 \u043f\u0440\u0438\u0434\u0451\u0442 \u0438\u043c\u0435\u043d\u043d\u043e \u043e\u0442\u0441\u044e\u0434\u0430:<\/p>\n<div>\n<div class=\"table\">\n<table>\n<tbody>\n<tr>\n<th>\n<p align=\"left\">3.3.0<\/p>\n<\/th>\n<th>\n<p align=\"left\">8.6.2<\/p>\n<\/th>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>setPageState(...)<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>setState(...)<\/code><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>removePageState(...)<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>removeState(...)<\/code><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>getPageState(page)<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>getStateOf(page)<\/code><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>ignoreCapacity<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>isCapacityUnlimited<\/code><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>isValidSuccessState<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>isFilledSuccessState<\/code><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>enforceCapacity<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>coerceToCapacity<\/code> (7.x)<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>fastSearchPageBefore<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>walkBackwardWhile<\/code><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>fastSearchPageAfter<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>walkForwardWhile<\/code><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>walkForwardWhile\/...<\/code> (\u043c\u0435\u0442\u043e\u0434\u044b)<\/p>\n<\/td>\n<td>\n<p align=\"left\">extension-\u0444\u0443\u043d\u043a\u0446\u0438\u0438<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>removeElement(...)<\/code> (\u043c\u0435\u0442\u043e\u0434)<\/p>\n<\/td>\n<td>\n<p align=\"left\">extension-\u0444\u0443\u043d\u043a\u0446\u0438\u044f<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>refreshAll<\/code>, \u0447\u0430\u0441\u0442\u044c <code>addElement<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\">extension-\u0444\u0443\u043d\u043a\u0446\u0438\u0438<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n<p>\u041f\u043b\u044e\u0441: cache \u0431\u043e\u043b\u044c\u0448\u0435 \u043d\u0435 \u0442\u043e\u0440\u0447\u0438\u0442 \u043d\u0430\u0440\u0443\u0436\u0443 \u043a\u0430\u043a <code>sortedMap<\/code>. \u041e\u043d \u0436\u0438\u0432\u0451\u0442 \u0437\u0430 <code>core: PagingCore<\/code> \/<br \/> <code>cache: PagingCache<\/code>. \u0415\u0441\u043b\u0438 \u0432 3.3.0 \u0432\u044b \u043b\u0430\u0437\u0438\u043b\u0438 \u0432\u043e \u0432\u043d\u0443\u0442\u0440\u0435\u043d\u043d\u044e\u044e \u043c\u0430\u043f\u0443 \u2014 \u0442\u0435\u043f\u0435\u0440\u044c \u0442\u043e\u043b\u044c\u043a\u043e \u0447\u0435\u0440\u0435\u0437 API<br \/> <code>core<\/code>\/<code>cache<\/code>.<\/p>\n<h3>7. \u041f\u0435\u0440\u0435\u043f\u0430\u043a\u043e\u0432\u043a\u0430 \u0442\u0438\u043f\u043e\u0432<\/h3>\n<p>\u0412 3.3.0 \u043f\u043e\u0447\u0442\u0438 \u0432\u0441\u0451 \u0431\u044b\u043b\u043e \u0432\u043b\u043e\u0436\u0435\u043d\u043e \u0432 \u0441\u0430\u043c <code>Paginator<\/code> (<code>Paginator.PageState.SuccessPage<\/code>,<br \/> <code>Paginator.Bookmark.BookmarkUInt<\/code>, <code>Paginator.LockedException...<\/code>). \u0412 8.6.2 \u044d\u0442\u0438 \u0442\u0438\u043f\u044b<br \/> \u0440\u0430\u0437\u043d\u0435\u0441\u0435\u043d\u044b \u043f\u043e \u043d\u043e\u0440\u043c\u0430\u043b\u044c\u043d\u044b\u043c \u043f\u043e\u0434-\u043f\u0430\u043a\u0435\u0442\u0430\u043c:<\/p>\n<ul>\n<li>\n<p><code>com.jamal_<\/code><a href=\"http:\/\/aliev.paginator.page\" rel=\"noopener noreferrer nofollow\"><code>aliev.paginator.page<\/code><\/a><code>.PageState<\/code> (+ <code>PlaceholderPageState<\/code>, <code>PaginatorUiState<\/code>)<\/p>\n<\/li>\n<li>\n<p><code>com.jamal_aliev.paginator.bookmark.BookmarkInt<\/code><\/p>\n<\/li>\n<li>\n<p><code>com.jamal_aliev.paginator.exception.LockedException.*<\/code>, <code>FinalPageExceededException<\/code>, <code>LoadGuardedException<\/code><\/p>\n<\/li>\n<li>\n<p><code>com.jamal_aliev.paginator.load.LoadResult<\/code>, <code>Metadata<\/code><\/p>\n<\/li>\n<li>\n<p><code>com.jamal_aliev.paginator.cache.PagingCache<\/code> \u0438 \u0441\u0442\u0440\u0430\u0442\u0435\u0433\u0438\u0438 \u043a\u044d\u0448\u0430<\/p>\n<\/li>\n<li>\n<p><code>com.jamal_aliev.paginator.logger.PaginatorLogger<\/code><\/p>\n<\/li>\n<\/ul>\n<p>\u0412\u0441\u0435 \u0438\u043c\u043f\u043e\u0440\u0442\u044b \u043f\u0440\u0438\u0434\u0451\u0442\u0441\u044f \u043f\u0435\u0440\u0435\u043f\u0438\u0441\u0430\u0442\u044c. \u0425\u043e\u0440\u043e\u0448\u0430\u044f \u043d\u043e\u0432\u043e\u0441\u0442\u044c \u2014 \u043f\u043e\u0441\u043b\u0435 \u043f\u0440\u0430\u0432\u043e\u043a \u0438\u0437 \u00a76 IDE-\u0430\u0432\u0442\u043e\u0438\u043c\u043f\u043e\u0440\u0442<br \/> \u0437\u0430\u043a\u0440\u043e\u0435\u0442 \u043f\u043e\u0447\u0442\u0438 \u0432\u0441\u0451 \u044d\u0442\u043e \u0441\u0430\u043c.<\/p>\n<h3>8. \u0427\u0442\u043e \u043d\u043e\u0432\u043e\u0433\u043e \u0441\u0442\u043e\u0438\u0442 \u0437\u043d\u0430\u0442\u044c, \u043f\u043e\u043a\u0430 \u0432\u044b \u0442\u0430\u043c<\/h3>\n<p>\u042d\u0442\u043e \u043d\u0435 breaking, \u043d\u043e \u044d\u0442\u043e \u043c\u0435\u043d\u044f\u0435\u0442 \u043e\u0431\u043b\u0438\u043a \u00ab\u0438\u0434\u0438\u043e\u043c\u0430\u0442\u0438\u0447\u043d\u043e\u0433\u043e\u00bb \u043a\u043e\u0434\u0430 \u0432 8.x. \u0420\u0430\u0437 \u0443\u0436 \u0432\u0441\u0451 \u0440\u0430\u0432\u043d\u043e \u043f\u0440\u0430\u0432\u0438\u043c \u2014<br \/> \u0438\u043c\u0435\u0435\u0442 \u0441\u043c\u044b\u0441\u043b \u0441\u0440\u0430\u0437\u0443 \u043f\u043e\u0434\u0446\u0435\u043f\u0438\u0442\u044c:<\/p>\n<ul>\n<li>\n<p><code><strong>finalPage: Int<\/strong><\/code> \u2014 \u0432\u0435\u0440\u0445\u043d\u044f\u044f \u0433\u0440\u0430\u043d\u0438\u0446\u0430 \u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u0438, \u043a\u0438\u0434\u0430\u0435\u0442 <code>FinalPageExceededException<\/code> (5.1.0). \u041f\u043e\u043b\u0435\u0437\u043d\u043e, \u043a\u043e\u0433\u0434\u0430 API \u0441\u043e\u043e\u0431\u0449\u0430\u0435\u0442 \u043e\u0431\u0449\u0435\u0435 \u0447\u0438\u0441\u043b\u043e \u0441\u0442\u0440\u0430\u043d\u0438\u0446.<\/p>\n<\/li>\n<li>\n<p><code><strong>loadGuard<\/strong><\/code> \u2014 \u043a\u043e\u043b\u0431\u044d\u043a, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043c\u043e\u0436\u0435\u0442 \u00ab\u0437\u0430\u0440\u0443\u0431\u0438\u0442\u044c\u00bb \u0437\u0430\u0433\u0440\u0443\u0437\u043a\u0443 <em>\u0434\u043e<\/em> \u0441\u0435\u0442\u0435\u0432\u043e\u0433\u043e \u0437\u0430\u043f\u0440\u043e\u0441\u0430, \u043a\u0438\u0434\u0430\u044f <code>LoadGuardedException<\/code>. \u0417\u0430\u043c\u0435\u043d\u044f\u0435\u0442 \u0441\u0430\u043c\u043e\u043f\u0438\u0441\u043d\u044b\u0435 \u0444\u043b\u0430\u0433\u0438 \u00ab\u043c\u043e\u0436\u043d\u043e \u043b\u0438 \u0441\u0435\u0439\u0447\u0430\u0441 \u0433\u0440\u0443\u0437\u0438\u0442\u044c\u00bb.<\/p>\n<\/li>\n<li>\n<p><strong>\u0421\u0442\u0440\u0430\u0442\u0435\u0433\u0438\u0438 \u043a\u044d\u0448\u0430<\/strong> \u2014 <code>LRU<\/code> \/ <code>FIFO<\/code> \/ <code>TTL<\/code> \/ <code>SlidingWindow<\/code> \/ <code>Composite<\/code> \u0447\u0435\u0440\u0435\u0437 <code>PagingCache<\/code>. \u0412 3.3.0 \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0439 \u0440\u0443\u0447\u043a\u043e\u0439 \u0431\u044b\u043b <code>capacity<\/code>.<\/p>\n<\/li>\n<li>\n<p><strong>\u0421\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f \u0441\u043e\u0441\u0442\u043e\u044f\u043d\u0438\u044f<\/strong> \u2014 <code>paginator.saveState(...)<\/code> \/ <code>restoreState(...)<\/code> \u043f\u043e\u0432\u0435\u0440\u0445 <code>kotlinx.serialization<\/code>. \u0417\u0430\u043c\u0435\u043d\u044f\u0435\u0442 \u0440\u0443\u0447\u043d\u043e\u0439 \u0442\u0430\u043d\u0435\u0446 \u00ab\u0441\u043e\u0445\u0440\u0430\u043d\u0438 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0438\u0435 \u043d\u043e\u043c\u0435\u0440\u0430 \u0441\u0442\u0440\u0430\u043d\u0438\u0446 \u0432 <code>SavedStateHandle<\/code>\u00bb \u043f\u0440\u0438 \u043f\u0440\u043e\u0446\u0435\u0441\u0441-\u0441\u043c\u0435\u0440\u0442\u0438.<\/p>\n<\/li>\n<li>\n<p><code><strong>PaginatorUiState<\/strong><\/code> \u2014 \u0435\u0434\u0438\u043d\u044b\u0439 Flow \u0434\u043b\u044f UI-\u0441\u043b\u043e\u044f (loading \/ data \/ error \/ empty), \u0440\u0435\u043a\u043e\u043c\u0435\u043d\u0434\u0443\u0435\u0442\u0441\u044f \u0432 \u043d\u043e\u0432\u043e\u043c Quick Start \u0432\u043c\u0435\u0441\u0442\u043e \u0440\u0443\u0447\u043d\u043e\u0439 \u0441\u0431\u043e\u0440\u043a\u0438 <code>snapshot<\/code> + \u0444\u043b\u0430\u0433\u043e\u0432 \u0437\u0430\u0433\u0440\u0443\u0437\u043a\u0438.<\/p>\n<\/li>\n<li>\n<p><code><strong>PlaceholderProgressPage<\/strong><\/code> \u2014 \u0432\u0441\u0442\u0440\u043e\u0435\u043d\u043d\u0430\u044f \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430 skeleton\/shimmer-\u0441\u0442\u0440\u043e\u043a.<\/p>\n<\/li>\n<li>\n<p><code><strong>PaginatorLogger<\/strong><\/code> \u2014 pluggable \u043b\u043e\u0433\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 (<code>AndroidLogger<\/code>, <code>NoOpLogger<\/code>).<\/p>\n<\/li>\n<li>\n<p><strong>DSL-builder<\/strong> \u2014 <code>paginator { \u2026 }<\/code> \u0432\u043c\u0435\u0441\u0442\u043e \u043f\u043e\u0437\u0438\u0446\u0438\u043e\u043d\u043d\u043e\u0433\u043e \u043a\u043e\u043d\u0441\u0442\u0440\u0443\u043a\u0442\u043e\u0440\u0430 (8.1+).<\/p>\n<\/li>\n<li>\n<p><code><strong>paginator-compose<\/strong><\/code> \u2014 \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438\u0439 prefetch \u0434\u043b\u044f <code>LazyColumn<\/code> \/ <code>LazyRow<\/code> \/ <code>LazyVerticalGrid<\/code> \/ <code>LazyVerticalStaggeredGrid<\/code>. \u041d\u0438\u043a\u0430\u043a\u0438\u0445 \u0431\u043e\u043b\u044c\u0448\u0435 <code>LaunchedEffect<\/code> + <code>snapshotFlow<\/code>.<\/p>\n<\/li>\n<li>\n<p><code><strong>paginator-view<\/strong><\/code> \u2014 <code>bindPaginated<\/code> \/ <code>bindPrefetchToRecyclerView<\/code> \u0434\u043b\u044f Android Views.<\/p>\n<\/li>\n<li>\n<p><code><strong>CursorPaginator<\/strong><\/code><strong> \/ <\/strong><code><strong>MutableCursorPaginator<\/strong><\/code> \u2014 \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u044b\u0439 \u043a\u0443\u0440\u0441\u043e\u0440\u043d\u044b\u0439 \u0440\u0435\u0436\u0438\u043c (<code>prev<\/code> \/ <code>self<\/code> \/ <code>next<\/code>), \u043f\u043e\u0434 GraphQL connections, \u0447\u0430\u0442\u044b \u0438 \u043b\u044e\u0431\u044b\u0435 API, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0432\u043c\u0435\u0441\u0442\u043e \u043d\u043e\u043c\u0435\u0440\u043e\u0432 \u0441\u0442\u0440\u0430\u043d\u0438\u0446 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u044e\u0442 \u043a\u0443\u0440\u0441\u043e\u0440\u044b (8.3+). \u0415\u0441\u043b\u0438 \u0432\u0430\u0448 \u0431\u044d\u043a\u0435\u043d\u0434 \u0443\u0436\u0435 \u0443\u043c\u0435\u0435\u0442 \u043a\u0443\u0440\u0441\u043e\u0440\u044b \u2014 \u044d\u0442\u043e \u0441\u0442\u0440\u043e\u0433\u043e \u043b\u0443\u0447\u0448\u0435, \u0447\u0435\u043c \u044d\u043c\u0443\u043b\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0438\u0445 \u043f\u043e\u0432\u0435\u0440\u0445 offset-\u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u0438.<\/p>\n<\/li>\n<li>\n<p><strong>Dirty pages<\/strong> \u2014 \u0442\u0440\u0435\u043a\u0438\u043d\u0433 \u00ab\u0433\u0440\u044f\u0437\u043d\u044b\u0445\u00bb \u0441\u0442\u0440\u0430\u043d\u0438\u0446 \u0434\u043b\u044f \u0447\u0430\u0441\u0442\u0438\u0447\u043d\u043e\u0439 \u0438\u043d\u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u0438 \u0432\u043c\u0435\u0441\u0442\u043e \u0441\u043d\u043e\u0441\u0430 \u0432\u0441\u0435\u0433\u043e \u043a\u044d\u0448\u0430.<\/p>\n<\/li>\n<\/ul>\n<h3>9. \u041d\u0430\u0433\u043b\u044f\u0434\u043d\u043e<\/h3>\n<p><strong>3.3.0:<\/strong><\/p>\n<pre><code class=\"kotlin\">class MainViewModel : ViewModel() {    private val paginator = Paginator&lt;Item&gt; { page: UInt -&gt;        SampleRepository.loadPage(page.toInt())    }    init { viewModelScope.launch { paginator.jumpForward() } }    override fun onCleared() {        paginator.release()        super.onCleared()    }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p><strong>8.6.2:<\/strong><\/p>\n<pre><code class=\"kotlin\">class MainViewModel : ViewModel() {    private val paginator = MutablePaginator&lt;Item&gt; { page: Int -&gt;        LoadResult(SampleRepository.loadPage(page))    }.apply {        \/\/ logger = AndroidLogger()        \/\/ finalPage = 50    }    val uiState = paginator.uiState \/\/ Flow&lt;PaginatorUiState&lt;Item&gt;&gt;    init { viewModelScope.launch { paginator.jumpForward() } }    override fun onCleared() {        paginator.release()        super.onCleared()    }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<h3>10. \u041f\u043e\u0440\u044f\u0434\u043e\u043a \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u0438, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u044f \u0431\u044b \u0440\u0435\u043a\u043e\u043c\u0435\u043d\u0434\u043e\u0432\u0430\u043b<\/h3>\n<ol>\n<li>\n<p><strong>\u0421\u043d\u0430\u0447\u0430\u043b\u0430 Gradle.<\/strong> \u0423\u0431\u0440\u0430\u0442\u044c JitPack, \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c <code>mavenCentral()<\/code>, \u043f\u0435\u0440\u0435\u0439\u0442\u0438 \u043d\u0430 BOM \u0438 \u043d\u0443\u0436\u043d\u044b\u0435 \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u044b.<\/p>\n<\/li>\n<li>\n<p><strong>\u0418\u043c\u043f\u043e\u0440\u0442\u044b.<\/strong> <code>Paginator.PageState.*<\/code> \u2192 <code>com.jamal_<\/code><a href=\"http:\/\/aliev.paginator.page\" rel=\"noopener noreferrer nofollow\"><code>aliev.paginator.page<\/code><\/a><code>.PageState.*<\/code> \u0438 \u0430\u043d\u0430\u043b\u043e\u0433\u0438\u0447\u043d\u043e \u0434\u043b\u044f \u043e\u0441\u0442\u0430\u043b\u044c\u043d\u044b\u0445 \u043f\u0435\u0440\u0435\u0435\u0445\u0430\u0432\u0448\u0438\u0445 \u0442\u0438\u043f\u043e\u0432 (\u00a77).<\/p>\n<\/li>\n<li>\n<p><code><strong>UInt<\/strong><\/code><strong> \u2192 <\/strong><code><strong>Int<\/strong><\/code> \u0432\u0435\u0437\u0434\u0435 \u2014 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b, \u0437\u0430\u043a\u043b\u0430\u0434\u043a\u0438, \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b, \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u043c\u044b\u0435 \u0442\u0438\u043f\u044b (<code>BookmarkUInt<\/code> \u2192 <code>BookmarkInt<\/code>).<\/p>\n<\/li>\n<li>\n<p><strong>\u041e\u0431\u0435\u0440\u043d\u0443\u0442\u044c \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u0434\u0430\u043d\u043d\u044b\u0445.<\/strong> <code>source = { \u2026 }<\/code> \u0441 <code>List&lt;T&gt;<\/code> \u2192 <code>load = { \u2026 }<\/code> \u0441 <code>LoadResult(...)<\/code>.<\/p>\n<\/li>\n<li>\n<p><strong>\u0421\u043c\u0435\u043d\u0438\u0442\u044c \u0442\u0438\u043f \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u0439 \u043d\u0430 <\/strong><code><strong>MutablePaginator<\/strong><\/code><strong>,<\/strong> \u0435\u0441\u043b\u0438 \u0432\u044b \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442\u0435 \u043a\u0430\u043a\u043e\u0439-\u043d\u0438\u0431\u0443\u0434\u044c CRUD \/ <code>setState<\/code> \/ <code>resize<\/code>.<\/p>\n<\/li>\n<li>\n<p><strong>\u041f\u0440\u043e\u0433\u043d\u0430\u0442\u044c \u043f\u0435\u0440\u0435\u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u0438\u044f<\/strong> \u0438\u0437 \u00a76 (<code>setPageState\u2192setState<\/code>, <code>getPageState\u2192getStateOf<\/code>, <code>ignoreCapacity\u2192isCapacityUnlimited<\/code>, <code>enforceCapacity\u2192coerceToCapacity<\/code>, \u2026).<\/p>\n<\/li>\n<li>\n<p><strong>\u0421\u043a\u043e\u043c\u043f\u0438\u043b\u0438\u0440\u043e\u0432\u0430\u0442\u044c.<\/strong> \u041a\u043e\u043c\u043f\u0438\u043b\u044f\u0442\u043e\u0440 \u043f\u043e\u0434\u0441\u0432\u0435\u0442\u0438\u0442 \u043e\u0441\u0442\u0430\u0442\u043e\u043a (\u0432 \u043e\u0441\u043d\u043e\u0432\u043d\u043e\u043c extension-\u0444\u0443\u043d\u043a\u0446\u0438\u0438, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0440\u0430\u043d\u044c\u0448\u0435 \u0431\u044b\u043b\u0438 \u043c\u0435\u0442\u043e\u0434\u0430\u043c\u0438).<\/p>\n<\/li>\n<li>\n<p><strong>\u041f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c runtime-\u043f\u043e\u0432\u0435\u0434\u0435\u043d\u0438\u0435<\/strong> \u043d\u0430 \u0440\u0435\u043f\u0440\u0435\u0437\u0435\u043d\u0442\u0430\u0442\u0438\u0432\u043d\u044b\u0445 \u0434\u0430\u043d\u043d\u044b\u0445. \u041a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b \u0442\u0435\u043f\u0435\u0440\u044c <code>page &gt;= 1<\/code>, <code>0<\/code> \u043e\u0437\u043d\u0430\u0447\u0430\u0435\u0442 \u00ab\u0435\u0449\u0451 \u043d\u0435 \u043d\u0430\u0447\u0430\u043b\u0438\u00bb; lock-\u0444\u043b\u0430\u0433\u0438 \u0438 \u0438\u0441\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u044f \u0436\u0438\u0432\u0443\u0442 \u0432 \u043f\u0430\u043a\u0435\u0442\u0435 <code>exception<\/code>.<\/p>\n<\/li>\n<li>\n<p><strong>\u041e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u043e, \u043d\u043e \u0438\u043c\u0435\u0435\u0442 \u0441\u043c\u044b\u0441\u043b:<\/strong> \u043f\u0435\u0440\u0435\u0439\u0442\u0438 \u043d\u0430 <code>uiState<\/code>, \u0432\u044b\u0431\u0440\u0430\u0442\u044c \u0441\u0442\u0440\u0430\u0442\u0435\u0433\u0438\u044e <code>PagingCache<\/code>, \u043f\u043e\u0434\u0446\u0435\u043f\u0438\u0442\u044c <code>saveState<\/code> \/ <code>restoreState<\/code>, DSL-builder \u0438 \u2014 \u0435\u0441\u043b\u0438 API \u043a\u0443\u0440\u0441\u043e\u0440\u043d\u044b\u0439 \u2014 <code>CursorPaginator<\/code>.<\/p>\n<\/li>\n<\/ol>\n<h3>11. \u041a\u0443\u0434\u0430 \u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u0437\u0430 \u0434\u0435\u0442\u0430\u043b\u044f\u043c\u0438<\/h3>\n<p>\u0412\u0441\u044f \u043d\u043e\u0432\u0430\u044f \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043b\u0435\u0436\u0438\u0442 \u0432 <a href=\"https:\/\/github.com\/jamal-wia\/Paginator\/tree\/master\/docs\" rel=\"noopener noreferrer nofollow\">docs\/<\/a>. \u0421\u0430\u043c\u043e\u0435 \u043f\u043e\u043b\u0435\u0437\u043d\u043e\u0435 \u043f\u0440\u0438 \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u0438:<\/p>\n<ul>\n<li>\n<p>docs\/1. core-concepts.md<\/p>\n<\/li>\n<li>\n<p>docs\/3. state.md \u2014 \u043d\u043e\u0432\u044b\u0439 <code>PaginatorUiState<\/code><\/p>\n<\/li>\n<li>\n<p>docs\/5. serialization.md \u2014 <code>saveState<\/code> \/ <code>restoreState<\/code><\/p>\n<\/li>\n<li>\n<p>docs\/6. caching.md \u2014 \u0441\u0442\u0440\u0430\u0442\u0435\u0433\u0438\u0438 \u043a\u044d\u0448\u0430<\/p>\n<\/li>\n<li>\n<p>docs\/11. dsl-builder.md<\/p>\n<\/li>\n<li>\n<p>docs\/13. cursor-pagination.md \u0438 docs\/14. paginator-vs-cursor.md<\/p>\n<\/li>\n<\/ul>\n<hr\/>\n<h3>\u0418\u0442\u043e\u0433\u043e<\/h3>\n<p>\u041a\u043e\u043d\u0446\u0435\u043f\u0446\u0438\u0438 \u043e\u0441\u0442\u0430\u043b\u0438\u0441\u044c, \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u2014 \u043d\u0435\u0442. \u0420\u0435\u0430\u043b\u044c\u043d\u043e \u043f\u043e\u0436\u0438\u0440\u0430\u044e\u0449\u0438\u0435 \u0432\u0440\u0435\u043c\u044f breaking-\u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f:<\/p>\n<ol>\n<li>\n<p>\u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u0430 \u0438 \u043f\u0435\u0440\u0435\u0435\u0437\u0434 \u043d\u0430 Maven Central + BOM,<\/p>\n<\/li>\n<li>\n<p><code>UInt<\/code> \u2192 <code>Int<\/code> \u0434\u043b\u044f \u0432\u0441\u0435\u0445 \u043d\u043e\u043c\u0435\u0440\u043e\u0432 \u0441\u0442\u0440\u0430\u043d\u0438\u0446,<\/p>\n<\/li>\n<li>\n<p><code>source: () -&gt; List&lt;T&gt;<\/code> \u2192 <code>load: () -&gt; LoadResult&lt;T&gt;<\/code>,<\/p>\n<\/li>\n<li>\n<p>\u0440\u0430\u0437\u0434\u0435\u043b\u0435\u043d\u0438\u0435 \u043d\u0430 <code>Paginator<\/code> \/ <code>MutablePaginator<\/code>,<\/p>\n<\/li>\n<li>\n<p>\u043f\u0430\u0440\u0442\u0438\u044f \u043f\u0435\u0440\u0435\u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u0438\u0439 \u0438\u0437 5.0.0,<\/p>\n<\/li>\n<li>\n<p>\u043f\u0435\u0440\u0435\u043f\u0430\u043a\u043e\u0432\u043a\u0430 <code>PageState<\/code>, <code>Bookmark<\/code>, \u0438\u0441\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0439 \u0438 \u043a\u044d\u0448\u0430.<\/p>\n<\/li>\n<\/ol>\n<p>\u0417\u0430\u043a\u0440\u043e\u0439\u0442\u0435 \u044d\u0442\u0438 \u0448\u0435\u0441\u0442\u044c \u043f\u0443\u043d\u043a\u0442\u043e\u0432 \u2014 \u043e\u0441\u0442\u0430\u043b\u044c\u043d\u043e\u0435 \u0431\u0443\u0434\u0435\u0442 \u043b\u0438\u0431\u043e \u043d\u043e\u0432\u044b\u0435 \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u044b\u0435 \u0444\u0438\u0447\u0438, \u043b\u0438\u0431\u043e \u043a\u043e\u0441\u043c\u0435\u0442\u0438\u043a\u0430.<\/p>\n<\/div>\n<p>\u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 <a href=\"https:\/\/habr.com\/ru\/articles\/1030758\/\">https:\/\/habr.com\/ru\/articles\/1030758\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u0415\u0441\u043b\u0438 \u0432\u044b \u0441\u0438\u0434\u0435\u043b\u0438 \u043d\u0430 Paginator 3.3.0 \u0438 \u0440\u0435\u0448\u0438\u043b\u0438 \u0441\u0440\u0430\u0437\u0443 \u043f\u0440\u044b\u0433\u043d\u0443\u0442\u044c \u043d\u0430 \u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u0443\u044e 8.6.2 \u2014 \u044d\u0442\u043e \u043d\u0435 \u0441\u043e\u0432\u0441\u0435\u043c \u00ab\u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u0435\u00bb, \u0430 \u0441\u043a\u043e\u0440\u0435\u0435 \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u044f \u043d\u0430, \u043f\u043e \u0441\u0443\u0442\u0438, \u0434\u0440\u0443\u0433\u0443\u044e \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0443. \u041a\u043e\u043d\u0446\u0435\u043f\u0446\u0438\u0438 \u0442\u0435 \u0436\u0435 (page state, \u0437\u0430\u043a\u043b\u0430\u0434\u043a\u0438, \u043f\u0440\u044b\u0436\u043a\u0438, snapshot\/cacheFlow), \u043d\u043e \u043c\u0435\u0436\u0434\u0443 \u044d\u0442\u0438\u043c\u0438 \u0432\u0435\u0440\u0441\u0438\u044f\u043c\u0438 \u2014 200+ \u043a\u043e\u043c\u043c\u0438\u0442\u043e\u0432, \u043f\u044f\u0442\u044c \u043c\u0430\u0436\u043e\u0440\u043d\u044b\u0445 \u0440\u0435\u043b\u0438\u0437\u043e\u0432 (4.x \u2192 8.x), \u043f\u0435\u0440\u0435\u0435\u0437\u0434 \u0441 JitPack \u043d\u0430 Maven Central, \u043f\u0435\u0440\u0435\u0445\u043e\u0434 \u0441 Android-only \u043d\u0430 Kotlin Multiplatform, \u0440\u0430\u0437\u0434\u0435\u043b\u0435\u043d\u0438\u0435 \u043d\u0430 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u043e\u0432 \u0438 \u0434\u043e\u0432\u043e\u043b\u044c\u043d\u043e \u0430\u0433\u0440\u0435\u0441\u0441\u0438\u0432\u043d\u0430\u044f \u0441\u0435\u0440\u0438\u044f \u043f\u0435\u0440\u0435\u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u0438\u0439 \u043f\u0443\u0431\u043b\u0438\u0447\u043d\u043e\u0433\u043e API.\u042d\u0442\u0430 \u0441\u0442\u0430\u0442\u044c\u044f \u2014 \u043f\u0440\u043e \u0442\u043e, \u0447\u0442\u043e \u0440\u0435\u0430\u043b\u044c\u043d\u043e \u0438\u0437\u043c\u0435\u043d\u0438\u043b\u043e\u0441\u044c, \u0438 \u0432 \u043a\u0430\u043a\u043e\u043c \u043f\u043e\u0440\u044f\u0434\u043a\u0435 \u044f \u0431\u044b \u0440\u0435\u043a\u043e\u043c\u0435\u043d\u0434\u043e\u0432\u0430\u043b \u044d\u0442\u043e \u0442\u0440\u043e\u0433\u0430\u0442\u044c. \u041e\u0441\u043d\u043e\u0432\u0430\u043d\u043e \u043d\u0430 \u0434\u0438\u0444\u0444\u0435 \u043c\u0435\u0436\u0434\u0443 (3.3.0) \u0438 (8.6.2).1. \u041a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u0430 \u0438 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439\u042d\u0442\u043e \u043f\u0435\u0440\u0432\u043e\u0435 \u0438 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e\u0435 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0435.3.3.0 \u2014 JitPack:repositories {    maven { setUrl(&#171;https:\/\/jitpack.io&#187;) }}dependencies {    implementation(&#171;com.github.jamal-wia:Paginator:3.3.0&#187;)}8.6.2 \u2014 Maven Central + BOM + \u043c\u043d\u043e\u0433\u043e\u043c\u043e\u0434\u0443\u043b\u044c\u043d\u0430\u044f \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430:repositories {    mavenCentral() \/\/ JitPack \u0431\u043e\u043b\u044c\u0448\u0435 \u043d\u0435 \u043d\u0443\u0436\u0435\u043d}dependencies {    implementation(platform(&#171;io.github.jamal-wia:paginator-bom:8.6.2&#187;))    implementation(&#171;io.github.jamal-wia:paginator&#187;)           \/\/ \u044f\u0434\u0440\u043e, \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e    implementation(&#171;io.github.jamal-wia:paginator-compose&#187;)   \/\/ \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u043e \u2014 Compose \/ CMP    implementation(&#171;io.github.jamal-wia:paginator-view&#187;)      \/\/ \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u043e \u2014 Android Views}groupId \u0441\u043c\u0435\u043d\u0438\u043b\u0441\u044f (com.github.jamal-wia \u2192 io.github.jamal-wia), \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442 \u0440\u0430\u0437\u0434\u0435\u043b\u0438\u043b\u0441\u044f \u043d\u0430 paginator \/ paginator-compose \/ paginator-view, \u0438 \u043f\u043e\u044f\u0432\u0438\u043b\u0441\u044f paginator-bom, \u0447\u0442\u043e\u0431\u044b \u0432\u0441\u0435 \u0442\u0440\u0438 \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u0430 \u043d\u0430 classpath \u043d\u0435 \u0440\u0430\u0437\u044a\u0435\u0437\u0436\u0430\u043b\u0438\u0441\u044c \u043f\u043e \u0432\u0435\u0440\u0441\u0438\u044f\u043c.2. \u041f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u044b3.3.0 \u0436\u0438\u0432\u0451\u0442 \u0432 paginator\/src\/main\/java\/&#8230; \u2014 \u044d\u0442\u043e Android-only \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430.8.6.2 \u2014 Kotlin Multiplatform: \u0438\u0441\u0445\u043e\u0434\u043d\u0438\u043a\u0438 \u043f\u0435\u0440\u0435\u0435\u0445\u0430\u043b\u0438 \u0432 commonMain, \u043e\u043f\u0443\u0431\u043b\u0438\u043a\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u0442\u0430\u0440\u0433\u0435\u0442\u044b \u2014 Android, JVM, iosX64, iosArm64, iosSimulatorArm64. \u0415\u0441\u043b\u0438 \u0443 \u0432\u0430\u0441 KMP-\u043f\u0440\u043e\u0435\u043a\u0442, \u0442\u0435\u043f\u0435\u0440\u044c \u043c\u043e\u0436\u043d\u043e \u043a\u043b\u0430\u0441\u0442\u044c paginator \u043f\u0440\u044f\u043c\u043e \u0432 commonMain.dependencies, \u0438 Gradle \u0441\u0430\u043c \u043f\u043e\u0434\u0442\u044f\u043d\u0435\u0442 \u043d\u0443\u0436\u043d\u044b\u0439 \u043f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u0435\u043d\u043d\u044b\u0439 \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442 \u0438\u0437 KMP-\u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0445.3. \u041d\u043e\u043c\u0435\u0440 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b: UInt \u2192 Int\u0412 3.3.0 \u043d\u043e\u043c\u0435\u0440 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b \u0431\u044b\u043b UInt (1u, BookmarkUInt(page = 5u), page: UInt). \u0412 8.6.2 \u044d\u0442\u043e Int. \u0412\u0441\u0435 \u0441\u0443\u0444\u0444\u0438\u043a\u0441\u044b u \u0438 \u043b\u044e\u0431\u044b\u0435 \u0443\u043f\u043e\u043c\u0438\u043d\u0430\u043d\u0438\u044f UInt\/BookmarkUInt \u043f\u0440\u0438\u0434\u0451\u0442\u0441\u044f \u043f\u0435\u0440\u0435\u043f\u0438\u0441\u0430\u0442\u044c.\/\/ 3.3.0paginator.setPageState(page = 1u, &#8230;)paginator.bookmarks += BookmarkUInt(page = 5u)\/\/ 8.6.2paginator.setState(page = 1, &#8230;)paginator.bookmarks += BookmarkInt(page = 5)\u041a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0442\u0435\u043f\u0435\u0440\u044c \u0442\u0430\u043a\u043e\u0439: page &gt;= 1, \u0430 0 \u0434\u043b\u044f \u043a\u043e\u043d\u0442\u0435\u043a\u0441\u0442\u043d\u044b\u0445 \u0441\u0442\u0440\u0430\u043d\u0438\u0446 \u043e\u0437\u043d\u0430\u0447\u0430\u0435\u0442 \u00ab\u0435\u0449\u0451 \u043d\u0435 \u043d\u0430\u0447\u0430\u043b\u0438\u00bb.4. \u041b\u044f\u043c\u0431\u0434\u0430 load\u042d\u0442\u043e, \u043f\u043e\u0436\u0430\u043b\u0443\u0439, \u043f\u0435\u0440\u0432\u043e\u0435 breaking-\u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0435, \u043a\u043e\u0442\u043e\u0440\u043e\u0435 \u0432\u044b \u0443\u0432\u0438\u0434\u0438\u0442\u0435, \u043a\u0430\u043a \u0442\u043e\u043b\u044c\u043a\u043e \u043d\u0430\u0447\u043d\u0451\u0442\u0435 \u043f\u0438\u0441\u0430\u0442\u044c \u043a\u043e\u0434.3.3.0:val paginator = Paginator&lt;Item&gt; { page: UInt -&gt;    repo.loadPage(page.toInt()) \/\/ \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 List&lt;Item&gt;}8.6.2:val paginator = Paginator&lt;Item&gt; { page: Int -&gt;    LoadResult(repo.loadPage(page))    \/\/ \u0438\u043b\u0438 \u0441 \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u043c\u0438 API:    \/\/ LoadResult(items, MyMetadata(totalCount = response.total))}\u041f\u043e\u043c\u0435\u043d\u044f\u043b\u043e\u0441\u044c \u0442\u0440\u0438 \u0432\u0435\u0449\u0438 \u0441\u0440\u0430\u0437\u0443: \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u043e \u043d\u0430\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f load, \u0430 \u043d\u0435 source; \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 \u0441\u0442\u0430\u043b Int; \u043b\u044f\u043c\u0431\u0434\u0430 \u0442\u0435\u043f\u0435\u0440\u044c \u043e\u0431\u044f\u0437\u0430\u043d\u0430 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0442\u044c LoadResult&lt;T&gt; (data + \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u044b\u0439 Metadata). LoadResult \u2014 \u043e\u0444\u0438\u0446\u0438\u0430\u043b\u044c\u043d\u0430\u044f \u0442\u043e\u0447\u043a\u0430 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u044f \u0434\u043b\u044f \u0432\u0441\u0435\u0433\u043e, \u0447\u0442\u043e \u0432\u044b \u0445\u043e\u0442\u0438\u0442\u0435 \u043f\u0440\u043e\u043a\u0438\u043d\u0443\u0442\u044c \u0432 PageState.metadata: total count, \u043a\u0443\u0440\u0441\u043e\u0440, \u0432\u0435\u0440\u0441\u0438\u044f \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b \u0438 \u0442.\u0434.5. Paginator VS MutablePaginator\u0412 3.3.0 \u043e\u0434\u0438\u043d \u043a\u043b\u0430\u0441\u0441 Paginator \u0443\u043c\u0435\u043b \u0432\u0441\u0451 \u2014 \u043d\u0430\u0432\u0438\u0433\u0430\u0446\u0438\u044e, addElement, removeElement, resize, setPageState. \u041d\u0430\u0447\u0438\u043d\u0430\u044f \u0441 6.x \u044d\u0442\u043e \u0440\u0430\u0437\u0434\u0435\u043b\u0435\u043d\u043e:Paginator&lt;T&gt; \u2014 read-only, \u0442\u043e\u043b\u044c\u043a\u043e \u043d\u0430\u0432\u0438\u0433\u0430\u0446\u0438\u044f (jump*, goNextPage, goPreviousPage, restart, refresh).MutablePaginator&lt;T&gt; \u2014 \u043d\u0430\u0441\u043b\u0435\u0434\u043d\u0438\u043a, \u0432 \u043d\u0451\u043c CRUD \u043f\u043e \u044d\u043b\u0435\u043c\u0435\u043d\u0442\u0430\u043c, resize, setState.\u0415\u0441\u043b\u0438 \u0432\u044b \u0433\u0434\u0435-\u0442\u043e \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442\u0435 addElement \/ removeElement \/ setPageState \/ resize \/ setState, \u0442\u0438\u043f \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u0439 \u043d\u0443\u0436\u043d\u043e \u0441\u043c\u0435\u043d\u0438\u0442\u044c \u043d\u0430 MutablePaginator&lt;T&gt;. \u0414\u043b\u044f \u0447\u0438\u0441\u0442\u043e-\u0447\u0438\u0442\u0430\u044e\u0449\u0438\u0445 \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0435\u0432 \u043c\u043e\u0436\u043d\u043e \u043e\u0441\u0442\u0430\u0432\u0438\u0442\u044c Paginator&lt;T&gt; \u0438 \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u0431\u043e\u043b\u0435\u0435 \u0443\u0437\u043a\u0438\u0439 API.6. \u0421\u043f\u0438\u0441\u043e\u043a \u043f\u0435\u0440\u0435\u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u0438\u0439 \u0438\u0437 5.0.0\u0411\u043e\u0301\u043b\u044c\u0448\u0430\u044f \u0447\u0430\u0441\u0442\u044c \u043e\u0448\u0438\u0431\u043e\u043a \u043a\u043e\u043c\u043f\u0438\u043b\u044f\u0446\u0438\u0438 \u043f\u043e\u0441\u043b\u0435 \u0430\u043f\u0433\u0440\u0435\u0439\u0434\u0430 \u043f\u0440\u0438\u0434\u0451\u0442 \u0438\u043c\u0435\u043d\u043d\u043e \u043e\u0442\u0441\u044e\u0434\u0430:3.3.08.6.2setPageState(&#8230;)setState(&#8230;)removePageState(&#8230;)removeState(&#8230;)getPageState(page)getStateOf(page)ignoreCapacityisCapacityUnlimitedisValidSuccessStateisFilledSuccessStateenforceCapacitycoerceToCapacity (7.x)fastSearchPageBeforewalkBackwardWhilefastSearchPageAfterwalkForwardWhilewalkForwardWhile\/&#8230; (\u043c\u0435\u0442\u043e\u0434\u044b)extension-\u0444\u0443\u043d\u043a\u0446\u0438\u0438removeElement(&#8230;) (\u043c\u0435\u0442\u043e\u0434)extension-\u0444\u0443\u043d\u043a\u0446\u0438\u044frefreshAll, \u0447\u0430\u0441\u0442\u044c addElementextension-\u0444\u0443\u043d\u043a\u0446\u0438\u0438\u041f\u043b\u044e\u0441: cache \u0431\u043e\u043b\u044c\u0448\u0435 \u043d\u0435 \u0442\u043e\u0440\u0447\u0438\u0442 \u043d\u0430\u0440\u0443\u0436\u0443 \u043a\u0430\u043a sortedMap. \u041e\u043d \u0436\u0438\u0432\u0451\u0442 \u0437\u0430 core: PagingCore \/ cache: PagingCache. \u0415\u0441\u043b\u0438 \u0432 3.3.0 \u0432\u044b \u043b\u0430\u0437\u0438\u043b\u0438 \u0432\u043e \u0432\u043d\u0443\u0442\u0440\u0435\u043d\u043d\u044e\u044e \u043c\u0430\u043f\u0443 \u2014 \u0442\u0435\u043f\u0435\u0440\u044c \u0442\u043e\u043b\u044c\u043a\u043e \u0447\u0435\u0440\u0435\u0437 API core\/cache.7. \u041f\u0435\u0440\u0435\u043f\u0430\u043a\u043e\u0432\u043a\u0430 \u0442\u0438\u043f\u043e\u0432\u0412 3.3.0 \u043f\u043e\u0447\u0442\u0438 \u0432\u0441\u0451 \u0431\u044b\u043b\u043e \u0432\u043b\u043e\u0436\u0435\u043d\u043e \u0432 \u0441\u0430\u043c Paginator (Paginator.PageState.SuccessPage, Paginator.Bookmark.BookmarkUInt, Paginator.LockedException&#8230;). \u0412 8.6.2 \u044d\u0442\u0438 \u0442\u0438\u043f\u044b \u0440\u0430\u0437\u043d\u0435\u0441\u0435\u043d\u044b \u043f\u043e \u043d\u043e\u0440\u043c\u0430\u043b\u044c\u043d\u044b\u043c \u043f\u043e\u0434-\u043f\u0430\u043a\u0435\u0442\u0430\u043c:com.jamal_aliev.paginator.page.PageState (+ PlaceholderPageState, PaginatorUiState)com.jamal_aliev.paginator.bookmark.BookmarkIntcom.jamal_aliev.paginator.exception.LockedException.*, FinalPageExceededException, LoadGuardedExceptioncom.jamal_aliev.paginator.load.LoadResult, Metadatacom.jamal_aliev.paginator.cache.PagingCache \u0438 \u0441\u0442\u0440\u0430\u0442\u0435\u0433\u0438\u0438 \u043a\u044d\u0448\u0430com.jamal_aliev.paginator.logger.PaginatorLogger\u0412\u0441\u0435 \u0438\u043c\u043f\u043e\u0440\u0442\u044b \u043f\u0440\u0438\u0434\u0451\u0442\u0441\u044f \u043f\u0435\u0440\u0435\u043f\u0438\u0441\u0430\u0442\u044c. \u0425\u043e\u0440\u043e\u0448\u0430\u044f \u043d\u043e\u0432\u043e\u0441\u0442\u044c \u2014 \u043f\u043e\u0441\u043b\u0435 \u043f\u0440\u0430\u0432\u043e\u043a \u0438\u0437 \u00a76 IDE-\u0430\u0432\u0442\u043e\u0438\u043c\u043f\u043e\u0440\u0442 \u0437\u0430\u043a\u0440\u043e\u0435\u0442 \u043f\u043e\u0447\u0442\u0438 \u0432\u0441\u0451 \u044d\u0442\u043e \u0441\u0430\u043c.8. \u0427\u0442\u043e \u043d\u043e\u0432\u043e\u0433\u043e \u0441\u0442\u043e\u0438\u0442 \u0437\u043d\u0430\u0442\u044c, \u043f\u043e\u043a\u0430 \u0432\u044b \u0442\u0430\u043c\u042d\u0442\u043e \u043d\u0435 breaking, \u043d\u043e \u044d\u0442\u043e \u043c\u0435\u043d\u044f\u0435\u0442 \u043e\u0431\u043b\u0438\u043a \u00ab\u0438\u0434\u0438\u043e\u043c\u0430\u0442\u0438\u0447\u043d\u043e\u0433\u043e\u00bb \u043a\u043e\u0434\u0430 \u0432 8.x. \u0420\u0430\u0437 \u0443\u0436 \u0432\u0441\u0451 \u0440\u0430\u0432\u043d\u043e \u043f\u0440\u0430\u0432\u0438\u043c \u2014 \u0438\u043c\u0435\u0435\u0442 \u0441\u043c\u044b\u0441\u043b \u0441\u0440\u0430\u0437\u0443 \u043f\u043e\u0434\u0446\u0435\u043f\u0438\u0442\u044c:finalPage: Int \u2014 \u0432\u0435\u0440\u0445\u043d\u044f\u044f \u0433\u0440\u0430\u043d\u0438\u0446\u0430 \u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u0438, \u043a\u0438\u0434\u0430\u0435\u0442 FinalPageExceededException (5.1.0). \u041f\u043e\u043b\u0435\u0437\u043d\u043e, \u043a\u043e\u0433\u0434\u0430 API \u0441\u043e\u043e\u0431\u0449\u0430\u0435\u0442 \u043e\u0431\u0449\u0435\u0435 \u0447\u0438\u0441\u043b\u043e \u0441\u0442\u0440\u0430\u043d\u0438\u0446.loadGuard \u2014 \u043a\u043e\u043b\u0431\u044d\u043a, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043c\u043e\u0436\u0435\u0442 \u00ab\u0437\u0430\u0440\u0443\u0431\u0438\u0442\u044c\u00bb \u0437\u0430\u0433\u0440\u0443\u0437\u043a\u0443 \u0434\u043e \u0441\u0435\u0442\u0435\u0432\u043e\u0433\u043e \u0437\u0430\u043f\u0440\u043e\u0441\u0430, \u043a\u0438\u0434\u0430\u044f LoadGuardedException. \u0417\u0430\u043c\u0435\u043d\u044f\u0435\u0442 \u0441\u0430\u043c\u043e\u043f\u0438\u0441\u043d\u044b\u0435 \u0444\u043b\u0430\u0433\u0438 \u00ab\u043c\u043e\u0436\u043d\u043e \u043b\u0438 \u0441\u0435\u0439\u0447\u0430\u0441 \u0433\u0440\u0443\u0437\u0438\u0442\u044c\u00bb.\u0421\u0442\u0440\u0430\u0442\u0435\u0433\u0438\u0438 \u043a\u044d\u0448\u0430 \u2014 LRU \/ FIFO \/ TTL \/ SlidingWindow \/ Composite \u0447\u0435\u0440\u0435\u0437 PagingCache. \u0412 3.3.0 \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0439 \u0440\u0443\u0447\u043a\u043e\u0439 \u0431\u044b\u043b capacity.\u0421\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f \u0441\u043e\u0441\u0442\u043e\u044f\u043d\u0438\u044f \u2014 paginator.saveState(&#8230;) \/ restoreState(&#8230;) \u043f\u043e\u0432\u0435\u0440\u0445 kotlinx.serialization. \u0417\u0430\u043c\u0435\u043d\u044f\u0435\u0442 \u0440\u0443\u0447\u043d\u043e\u0439 \u0442\u0430\u043d\u0435\u0446 \u00ab\u0441\u043e\u0445\u0440\u0430\u043d\u0438 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0438\u0435 \u043d\u043e\u043c\u0435\u0440\u0430 \u0441\u0442\u0440\u0430\u043d\u0438\u0446 \u0432 SavedStateHandle\u00bb \u043f\u0440\u0438 \u043f\u0440\u043e\u0446\u0435\u0441\u0441-\u0441\u043c\u0435\u0440\u0442\u0438.PaginatorUiState \u2014 \u0435\u0434\u0438\u043d\u044b\u0439 Flow \u0434\u043b\u044f UI-\u0441\u043b\u043e\u044f (loading \/ data \/ error \/ empty), \u0440\u0435\u043a\u043e\u043c\u0435\u043d\u0434\u0443\u0435\u0442\u0441\u044f \u0432 \u043d\u043e\u0432\u043e\u043c Quick Start \u0432\u043c\u0435\u0441\u0442\u043e \u0440\u0443\u0447\u043d\u043e\u0439 \u0441\u0431\u043e\u0440\u043a\u0438 snapshot + \u0444\u043b\u0430\u0433\u043e\u0432 \u0437\u0430\u0433\u0440\u0443\u0437\u043a\u0438.PlaceholderProgressPage \u2014 \u0432\u0441\u0442\u0440\u043e\u0435\u043d\u043d\u0430\u044f \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430 skeleton\/shimmer-\u0441\u0442\u0440\u043e\u043a.PaginatorLogger \u2014 pluggable \u043b\u043e\u0433\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 (AndroidLogger, NoOpLogger).DSL-builder \u2014 paginator { \u2026 } \u0432\u043c\u0435\u0441\u0442\u043e \u043f\u043e\u0437\u0438\u0446\u0438\u043e\u043d\u043d\u043e\u0433\u043e \u043a\u043e\u043d\u0441\u0442\u0440\u0443\u043a\u0442\u043e\u0440\u0430 (8.1+).paginator-compose \u2014 \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438\u0439 prefetch \u0434\u043b\u044f LazyColumn \/ LazyRow \/ LazyVerticalGrid \/ LazyVerticalStaggeredGrid. \u041d\u0438\u043a\u0430\u043a\u0438\u0445 \u0431\u043e\u043b\u044c\u0448\u0435 LaunchedEffect + snapshotFlow.paginator-view \u2014 bindPaginated \/ bindPrefetchToRecyclerView \u0434\u043b\u044f Android Views.CursorPaginator \/ MutableCursorPaginator \u2014 \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u044b\u0439 \u043a\u0443\u0440\u0441\u043e\u0440\u043d\u044b\u0439 \u0440\u0435\u0436\u0438\u043c (prev \/ self \/ next), \u043f\u043e\u0434 GraphQL connections, \u0447\u0430\u0442\u044b \u0438 \u043b\u044e\u0431\u044b\u0435 API, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0432\u043c\u0435\u0441\u0442\u043e \u043d\u043e\u043c\u0435\u0440\u043e\u0432 \u0441\u0442\u0440\u0430\u043d\u0438\u0446 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u044e\u0442 \u043a\u0443\u0440\u0441\u043e\u0440\u044b (8.3+). \u0415\u0441\u043b\u0438 \u0432\u0430\u0448 \u0431\u044d\u043a\u0435\u043d\u0434 \u0443\u0436\u0435 \u0443\u043c\u0435\u0435\u0442 \u043a\u0443\u0440\u0441\u043e\u0440\u044b \u2014 \u044d\u0442\u043e \u0441\u0442\u0440\u043e\u0433\u043e \u043b\u0443\u0447\u0448\u0435, \u0447\u0435\u043c \u044d\u043c\u0443\u043b\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0438\u0445 \u043f\u043e\u0432\u0435\u0440\u0445 offset-\u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u0438.Dirty pages \u2014 \u0442\u0440\u0435\u043a\u0438\u043d\u0433 \u00ab\u0433\u0440\u044f\u0437\u043d\u044b\u0445\u00bb \u0441\u0442\u0440\u0430\u043d\u0438\u0446 \u0434\u043b\u044f \u0447\u0430\u0441\u0442\u0438\u0447\u043d\u043e\u0439 \u0438\u043d\u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u0438 \u0432\u043c\u0435\u0441\u0442\u043e \u0441\u043d\u043e\u0441\u0430 \u0432\u0441\u0435\u0433\u043e \u043a\u044d\u0448\u0430.9. \u041d\u0430\u0433\u043b\u044f\u0434\u043d\u043e3.3.0:class MainViewModel : ViewModel() {    private val paginator = Paginator&lt;Item&gt; { page: UInt -&gt;        SampleRepository.loadPage(page.toInt())    }    init { viewModelScope.launch { paginator.jumpForward() } }    override fun onCleared() {        paginator.release()        super.onCleared()    }}8.6.2:class MainViewModel : ViewModel() {    private val paginator = MutablePaginator&lt;Item&gt; { page: Int -&gt;        LoadResult(SampleRepository.loadPage(page))    }.apply {        \/\/ logger = AndroidLogger()        \/\/ finalPage = 50    }    val uiState = paginator.uiState \/\/ Flow&lt;PaginatorUiState&lt;Item&gt;&gt;    init { viewModelScope.launch { paginator.jumpForward() } }    override fun onCleared() {        paginator.release()        super.onCleared()    }}10. \u041f\u043e\u0440\u044f\u0434\u043e\u043a \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u0438, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u044f \u0431\u044b \u0440\u0435\u043a\u043e\u043c\u0435\u043d\u0434\u043e\u0432\u0430\u043b\u0421\u043d\u0430\u0447\u0430\u043b\u0430 Gradle. \u0423\u0431\u0440\u0430\u0442\u044c JitPack, \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c mavenCentral(), \u043f\u0435\u0440\u0435\u0439\u0442\u0438 \u043d\u0430 BOM \u0438 \u043d\u0443\u0436\u043d\u044b\u0435 \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u044b.\u0418\u043c\u043f\u043e\u0440\u0442\u044b. Paginator.PageState.* \u2192 com.jamal_aliev.paginator.page.PageState.* \u0438 \u0430\u043d\u0430\u043b\u043e\u0433\u0438\u0447\u043d\u043e \u0434\u043b\u044f \u043e\u0441\u0442\u0430\u043b\u044c\u043d\u044b\u0445 \u043f\u0435\u0440\u0435\u0435\u0445\u0430\u0432\u0448\u0438\u0445 \u0442\u0438\u043f\u043e\u0432 (\u00a77).UInt \u2192 Int \u0432\u0435\u0437\u0434\u0435 \u2014 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b, \u0437\u0430\u043a\u043b\u0430\u0434\u043a\u0438, \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b, \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u043c\u044b\u0435 \u0442\u0438\u043f\u044b (BookmarkUInt \u2192 BookmarkInt).\u041e\u0431\u0435\u0440\u043d\u0443\u0442\u044c \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u0434\u0430\u043d\u043d\u044b\u0445. source = { \u2026 } \u0441 List&lt;T&gt; \u2192 load = { \u2026 } \u0441 LoadResult(&#8230;).\u0421\u043c\u0435\u043d\u0438\u0442\u044c \u0442\u0438\u043f \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u0439 \u043d\u0430 MutablePaginator, \u0435\u0441\u043b\u0438 \u0432\u044b \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442\u0435 \u043a\u0430\u043a\u043e\u0439-\u043d\u0438\u0431\u0443\u0434\u044c CRUD \/ setState \/ resize.\u041f\u0440\u043e\u0433\u043d\u0430\u0442\u044c \u043f\u0435\u0440\u0435\u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u0438\u044f \u0438\u0437 \u00a76 (setPageState\u2192setState, getPageState\u2192getStateOf, ignoreCapacity\u2192isCapacityUnlimited, enforceCapacity\u2192coerceToCapacity, \u2026).\u0421\u043a\u043e\u043c\u043f\u0438\u043b\u0438\u0440\u043e\u0432\u0430\u0442\u044c. \u041a\u043e\u043c\u043f\u0438\u043b\u044f\u0442\u043e\u0440 \u043f\u043e\u0434\u0441\u0432\u0435\u0442\u0438\u0442 \u043e\u0441\u0442\u0430\u0442\u043e\u043a (\u0432 \u043e\u0441\u043d\u043e\u0432\u043d\u043e\u043c extension-\u0444\u0443\u043d\u043a\u0446\u0438\u0438, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0440\u0430\u043d\u044c\u0448\u0435 \u0431\u044b\u043b\u0438 \u043c\u0435\u0442\u043e\u0434\u0430\u043c\u0438).\u041f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c runtime-\u043f\u043e\u0432\u0435\u0434\u0435\u043d\u0438\u0435 \u043d\u0430 \u0440\u0435\u043f\u0440\u0435\u0437\u0435\u043d\u0442\u0430\u0442\u0438\u0432\u043d\u044b\u0445 \u0434\u0430\u043d\u043d\u044b\u0445. \u041a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b \u0442\u0435\u043f\u0435\u0440\u044c page &gt;= 1, 0 \u043e\u0437\u043d\u0430\u0447\u0430\u0435\u0442 \u00ab\u0435\u0449\u0451 \u043d\u0435 \u043d\u0430\u0447\u0430\u043b\u0438\u00bb; lock-\u0444\u043b\u0430\u0433\u0438 \u0438 \u0438\u0441\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u044f \u0436\u0438\u0432\u0443\u0442 \u0432 \u043f\u0430\u043a\u0435\u0442\u0435 exception.\u041e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u043e, \u043d\u043e \u0438\u043c\u0435\u0435\u0442 \u0441\u043c\u044b\u0441\u043b: \u043f\u0435\u0440\u0435\u0439\u0442\u0438 \u043d\u0430 uiState, \u0432\u044b\u0431\u0440\u0430\u0442\u044c \u0441\u0442\u0440\u0430\u0442\u0435\u0433\u0438\u044e PagingCache, \u043f\u043e\u0434\u0446\u0435\u043f\u0438\u0442\u044c saveState \/ restoreState, DSL-builder \u0438 \u2014 \u0435\u0441\u043b\u0438 API \u043a\u0443\u0440\u0441\u043e\u0440\u043d\u044b\u0439 \u2014 CursorPaginator.11. \u041a\u0443\u0434\u0430 \u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u0437\u0430 \u0434\u0435\u0442\u0430\u043b\u044f\u043c\u0438\u0412\u0441\u044f \u043d\u043e\u0432\u0430\u044f \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043b\u0435\u0436\u0438\u0442 \u0432 docs\/. \u0421\u0430\u043c\u043e\u0435 \u043f\u043e\u043b\u0435\u0437\u043d\u043e\u0435 \u043f\u0440\u0438 \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u0438:docs\/1. core-concepts.mddocs\/3. state.md \u2014 \u043d\u043e\u0432\u044b\u0439 PaginatorUiStatedocs\/5. serialization.md \u2014 saveState \/ restoreStatedocs\/6. caching.md \u2014 \u0441\u0442\u0440\u0430\u0442\u0435\u0433\u0438\u0438 \u043a\u044d\u0448\u0430docs\/11. dsl-builder.mddocs\/13. cursor-pagination.md \u0438 docs\/14. paginator-vs-cursor.md\u0418\u0442\u043e\u0433\u043e\u041a\u043e\u043d\u0446\u0435\u043f\u0446\u0438\u0438 \u043e\u0441\u0442\u0430\u043b\u0438\u0441\u044c, \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u2014 \u043d\u0435\u0442. \u0420\u0435\u0430\u043b\u044c\u043d\u043e \u043f\u043e\u0436\u0438\u0440\u0430\u044e\u0449\u0438\u0435 \u0432\u0440\u0435\u043c\u044f breaking-\u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f:\u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u0430 \u0438 \u043f\u0435\u0440\u0435\u0435\u0437\u0434 \u043d\u0430 Maven Central + BOM,UInt \u2192 Int \u0434\u043b\u044f \u0432\u0441\u0435\u0445 \u043d\u043e\u043c\u0435\u0440\u043e\u0432 \u0441\u0442\u0440\u0430\u043d\u0438\u0446,source: () -&gt; List&lt;T&gt; \u2192 load: () -&gt; LoadResult&lt;T&gt;,\u0440\u0430\u0437\u0434\u0435\u043b\u0435\u043d\u0438\u0435 \u043d\u0430 Paginator \/ MutablePaginator,\u043f\u0430\u0440\u0442\u0438\u044f \u043f\u0435\u0440\u0435\u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u0438\u0439 \u0438\u0437 5.0.0,\u043f\u0435\u0440\u0435\u043f\u0430\u043a\u043e\u0432\u043a\u0430 PageState, Bookmark, \u0438\u0441\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0439 \u0438 \u043a\u044d\u0448\u0430.\u0417\u0430\u043a\u0440\u043e\u0439\u0442\u0435 \u044d\u0442\u0438 \u0448\u0435\u0441\u0442\u044c \u043f\u0443\u043d\u043a\u0442\u043e\u0432 \u2014 \u043e\u0441\u0442\u0430\u043b\u044c\u043d\u043e\u0435 \u0431\u0443\u0434\u0435\u0442 \u043b\u0438\u0431\u043e \u043d\u043e\u0432\u044b\u0435 \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u044b\u0435 \u0444\u0438\u0447\u0438, \u043b\u0438\u0431\u043e \u043a\u043e\u0441\u043c\u0435\u0442\u0438\u043a\u0430.\u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 https:\/\/habr.com\/ru\/articles\/1030758\/<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-478346","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/478346","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=478346"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/478346\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=478346"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=478346"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=478346"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}