Android
android.net
public static final class

android.net.Uri.Builder

java.lang.Object
android.net.Uri.Builder

Helper class for building or manipulating URI references. Not safe for concurrent use.

An absolute hierarchical URI reference follows the pattern: ://?#

Relative URI references (which are always hierarchical) follow one of two patterns: ?# or //?#

An opaque URI follows this pattern: :#

Summary

Public Constructors

            Uri.Builder()
Constructs a new Builder.

Public Methods

          Uri.Builder  appendEncodedPath(String newSegment)
Appends the given segment to the path.
          Uri.Builder  appendPath(String newSegment)
Encodes the given segment and appends it to the path.
          Uri.Builder  appendQueryParameter(String key, String value)
Encodes the key and value and then appends the parameter to the query string.
          Uri.Builder  authority(String authority)
Encodes and sets the authority.
          Uri  build()
Constructs a Uri with the current attributes.
          Uri.Builder  encodedAuthority(String authority)
Sets the previously encoded authority.
          Uri.Builder  encodedFragment(String fragment)
Sets the previously encoded fragment.
          Uri.Builder  encodedOpaquePart(String opaquePart)
Sets the previously encoded opaque scheme-specific-part.
          Uri.Builder  encodedPath(String path)
Sets the previously encoded path.
          Uri.Builder  encodedQuery(String query)
Sets the previously encoded query.
          Uri.Builder  fragment(String fragment)
Encodes and sets the fragment.
          Uri.Builder  opaquePart(String opaquePart)
Encodes and sets the given opaque scheme-specific-part.
          Uri.Builder  path(String path)
Sets the path.
          Uri.Builder  query(String query)
Encodes and sets the query.
          Uri.Builder  scheme(String scheme)
Sets the scheme.
          String  toString()
Returns a string containing a concise, human-readable description of the receiver.
Methods inherited from class java.lang.Object

Details

Public Constructors

public Uri.Builder()

Constructs a new Builder.

Public Methods

public Uri.Builder appendEncodedPath(String newSegment)

Appends the given segment to the path.

public Uri.Builder appendPath(String newSegment)

Encodes the given segment and appends it to the path.

public Uri.Builder appendQueryParameter(String key, String value)

Encodes the key and value and then appends the parameter to the query string.

Parameters

key which will be encoded
value which will be encoded

public Uri.Builder authority(String authority)

Encodes and sets the authority.

public Uri build()

Constructs a Uri with the current attributes.

Throws

UnsupportedOperationException if the URI is opaque and the scheme is null

public Uri.Builder encodedAuthority(String authority)

Sets the previously encoded authority.

public Uri.Builder encodedFragment(String fragment)

Sets the previously encoded fragment.

public Uri.Builder encodedOpaquePart(String opaquePart)

Sets the previously encoded opaque scheme-specific-part.

Parameters

opaquePart encoded opaque part

public Uri.Builder encodedPath(String path)

Sets the previously encoded path.

If the path is not null and doesn't start with a '/', and if you specify a scheme and/or authority, the builder will prepend the given path with a '/'.

public Uri.Builder encodedQuery(String query)

Sets the previously encoded query.

public Uri.Builder fragment(String fragment)

Encodes and sets the fragment.

public Uri.Builder opaquePart(String opaquePart)

Encodes and sets the given opaque scheme-specific-part.

Parameters

opaquePart decoded opaque part

public Uri.Builder path(String path)

Sets the path. Leaves '/' characters intact but encodes others as necessary.

If the path is not null and doesn't start with a '/', and if you specify a scheme and/or authority, the builder will prepend the given path with a '/'.

public Uri.Builder query(String query)

Encodes and sets the query.

public Uri.Builder scheme(String scheme)

Sets the scheme.

Parameters

scheme name or null if this is a relative Uri

public String toString()

Returns a string containing a concise, human-readable description of the receiver.

Returns

  • String a printable representation for the receiver.
Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:48