Skip to content

Most visited

Recently visited

navigation

ContentUris

public class ContentUris
extends Object

java.lang.Object
   ↳ android.content.ContentUris


Utility methods useful for working with Uri objects that use the "content" (content://) scheme.

Content URIs have the syntax

content://authority/path/id

content:
The scheme portion of the URI. This is always set to ContentResolver.SCHEME_CONTENT (value content://).
authority
A string that identifies the entire content provider. All the content URIs for the provider start with this string. To guarantee a unique authority, providers should consider using an authority that is the same as the provider class' package identifier.
path
Zero or more segments, separated by a forward slash (/), that identify some subset of the provider's data. Most providers use the path part to identify individual tables. Individual segments in the path are often called "directories" although they do not refer to file directories. The right-most segment in a path is often called a "twig"
id
A unique numeric identifier for a single row in the subset of data identified by the preceding path part. Most providers recognize content URIs that contain an id part and give them special handling. A table that contains a column named _ID often expects the id part to be a particular value for that column.

Summary

Public constructors

ContentUris()

Public methods

static Uri.Builder appendId(Uri.Builder builder, long id)

Appends the given ID to the end of the path.

static long parseId(Uri contentUri)

Converts the last path segment to a long.

static Uri withAppendedId(Uri contentUri, long id)

Appends the given ID to the end of the path.

Inherited methods

From class java.lang.Object

Public constructors

ContentUris

added in API level 1
ContentUris ()

Public methods

appendId

added in API level 1
Uri.Builder appendId (Uri.Builder builder, 
                long id)

Appends the given ID to the end of the path.

Parameters
builder Uri.Builder: to append the ID to

id long: to append

Returns
Uri.Builder the given builder

parseId

added in API level 1
long parseId (Uri contentUri)

Converts the last path segment to a long.

This supports a common convention for content URIs where an ID is stored in the last segment.

Parameters
contentUri Uri

Returns
long the long conversion of the last segment or -1 if the path is empty

Throws
UnsupportedOperationException if this isn't a hierarchical URI
NumberFormatException if the last segment isn't a number

withAppendedId

added in API level 1
Uri withAppendedId (Uri contentUri, 
                long id)

Appends the given ID to the end of the path.

Parameters
contentUri Uri: to start with

id long: to append

Returns
Uri a new URI with the given ID appended to the end of the path

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)