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 |
|
---|---|
![]() 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 |