diff options
author | The Android Open Source Project <initial-contribution@android.com> | 2008-10-21 07:00:00 -0700 |
---|---|---|
committer | The Android Open Source Project <initial-contribution@android.com> | 2008-10-21 07:00:00 -0700 |
commit | 54b6cfa9a9e5b861a9930af873580d6dc20f773c (patch) | |
tree | 35051494d2af230dce54d6b31c6af8fc24091316 /core/java/android/content/ContentUris.java | |
download | frameworks_base-54b6cfa9a9e5b861a9930af873580d6dc20f773c.zip frameworks_base-54b6cfa9a9e5b861a9930af873580d6dc20f773c.tar.gz frameworks_base-54b6cfa9a9e5b861a9930af873580d6dc20f773c.tar.bz2 |
Initial Contribution
Diffstat (limited to 'core/java/android/content/ContentUris.java')
-rw-r--r-- | core/java/android/content/ContentUris.java | 67 |
1 files changed, 67 insertions, 0 deletions
diff --git a/core/java/android/content/ContentUris.java b/core/java/android/content/ContentUris.java new file mode 100644 index 0000000..aa76034 --- /dev/null +++ b/core/java/android/content/ContentUris.java @@ -0,0 +1,67 @@ +/* + * Copyright (C) 2007 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package android.content; + +import android.net.Uri; + +/** + * Utility methods useful for working with content {@link android.net.Uri}s, + * those with a "content" scheme. + */ +public class ContentUris { + + /** + * Converts the last path segment to a long. + * + * <p>This supports a common convention for content URIs where an ID is + * stored in the last segment. + * + * @throws UnsupportedOperationException if this isn't a hierarchical URI + * @throws NumberFormatException if the last segment isn't a number + * + * @return the long conversion of the last segment or -1 if the path is + * empty + */ + public static long parseId(Uri contentUri) { + String last = contentUri.getLastPathSegment(); + return last == null ? -1 : Long.parseLong(last); + } + + /** + * Appends the given ID to the end of the path. + * + * @param builder to append the ID to + * @param id to append + * + * @return the given builder + */ + public static Uri.Builder appendId(Uri.Builder builder, long id) { + return builder.appendEncodedPath(String.valueOf(id)); + } + + /** + * Appends the given ID to the end of the path. + * + * @param contentUri to start with + * @param id to append + * + * @return a new URI with the given ID appended to the end of the path + */ + public static Uri withAppendedId(Uri contentUri, long id) { + return appendId(contentUri.buildUpon(), id).build(); + } +} |