| <?xml version="1.0" encoding="UTF-8"?> |
| <!-- |
| Copyright 2017 The Android Open Source Project |
| |
| Licensed under the Apache License, Version 2.0 (the "License"); |
| you may not use this file except in compliance with the License. |
| You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| --> |
| <sample> |
| <name>ContentProviderPaging</name> |
| <group>UI</group> |
| <package>com.example.android.contentproviderpaging</package> |
| |
| <strings> |
| <intro> |
| <![CDATA[ |
| This sample demonstrates how to use the ContentProvider with paging support introduced |
| in Android O. The ContentProvider now accepts additional arguments for the offset and |
| the limit in the query method to support paging instead of fetching all the data in |
| a single query method call. |
| ]]> |
| </intro> |
| </strings> |
| |
| <template src="base-build" /> |
| |
| <metadata> |
| <status>PUBLISHED</status> |
| <categories>Content, Android O Preview</categories> |
| <technologies>Android</technologies> |
| <languages>Java</languages> |
| <solutions>Mobile</solutions> |
| <level>INTERMEDIATE</level> |
| <icon>screenshots/icon-web.png</icon> |
| <screenshots> |
| <img>screenshots/screenshot-1.png</img> |
| </screenshots> |
| <api_refs> |
| <android>android.content.ContentProvider</android> |
| <android>android.provider.DocumentsProvider</android> |
| </api_refs> |
| |
| <description> |
| <![CDATA[ |
| This sample demonstrates how to use the ContentProvider with paging support introduced |
| in Android O. The ContentProvider now accepts additional arguments for the offset and |
| the limit in the query method to support paging instead of fetching all the data in |
| a single query method call. |
| ]]> |
| </description> |
| |
| <intro> |
| <![CDATA[ |
| [ContentProvider][1] and [DocumentsProvider][2] now supports paging instead of fetching the all |
| data at once. |
| |
| Starting from Android O, ContentProvider#query(Uri, String[], Bundle, CancellationSignal) and |
| DocumentsProvider#query(Uri, String[], Bundle, CancellationSignal) methods are introduced. |
| The Bundle accepts the keys for ContentResolver.QUERY_ARG_OFFSET as an starting offset and |
| ContentResolver.QUERY_ARG_LIMIT as the number of items included in the returned Cursor object. |
| |
| Similarly, the returned Cursor object now has a Bundle object obtained by Cursor#getExtras(). |
| The Bundle is able to include data such as the total size of the underlying data set. |
| |
| [1]: https://developer.android.com/reference/android/content/ContentProvider.html |
| [2]: https://developer.android.com/reference/android/provider/DocumentsProvider.html |
| ]]> |
| </intro> |
| </metadata> |
| </sample> |