to top
Android APIs
public class

ContentUris

extends Object
java.lang.Object
   ↳ android.content.ContentUris

Class Overview

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.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public ContentUris ()

Added in API level 1

Public Methods

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

Added in API level 1

Appends the given ID to the end of the path.

Parameters
builder to append the ID to
id to append
Returns
  • the given builder

public static long parseId (Uri contentUri)

Added in API level 1

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.

Returns
  • 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

public static Uri withAppendedId (Uri contentUri, long id)

Added in API level 1

Appends the given ID to the end of the path.

Parameters
contentUri to start with
id to append
Returns
  • a new URI with the given ID appended to the end of the path