# Print output for @column tags ?>
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:
ContentResolver.SCHEME_CONTENT
(value
content://
).
/
), 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
often expects the id part to be a particular value for that column.
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
|
removeId(Uri contentUri)
Removes any ID from the end of the path. |
static
Uri
|
withAppendedId(Uri contentUri, long id)
Appends the given ID to the end of the path. |
Inherited methods | |
---|---|
public ContentUris ()
public static 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
This value cannot be null . |
id |
long : to append |
Returns | |
---|---|
Uri.Builder |
the given builder
This value cannot be null . |
public static 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 : This value cannot be null . |
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 |
public static Uri removeId (Uri contentUri)
Removes any ID from the end of the path.
Parameters | |
---|---|
contentUri |
Uri : that ends with an ID
This value cannot be null . |
Returns | |
---|---|
Uri |
a new URI with the ID removed from the end of the path
This value cannot be null . |
Throws | |
---|---|
IllegalArgumentException |
when the given URI has no ID to remove from the end of the path |
public static Uri withAppendedId (Uri contentUri, long id)
Appends the given ID to the end of the path.
Parameters | |
---|---|
contentUri |
Uri : to start with
This value cannot be null . |
id |
long : to append |
Returns | |
---|---|
Uri |
a new URI with the given ID appended to the end of the path
This value cannot be null . |