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
|
withAppendedId(Uri contentUri, long id)
Appends the given ID to the end of the path. |
Inherited methods | |
---|---|
From
class
java.lang.Object
|
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 |
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 |
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 |