com.amazonaws.services.s3

Class AmazonS3URI

java.lang.Object

com.amazonaws.services.s3.AmazonS3URI

public class AmazonS3URI
extends java.lang.Object

A URI wrapper that can parse out information about an S3 URI.

Constructor Summary

Constructors

Constructor and Description
AmazonS3URI(java.lang.String str) Creates a new AmazonS3URI by parsing the given string.
AmazonS3URI(java.lang.String str, boolean urlEncode) Creates a new AmazonS3URI by parsing the given string.
AmazonS3URI(java.net.URI uri) Creates a new AmazonS3URI by wrapping the given URI.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object o)
java.lang.String	getBucket()
java.lang.String	getKey()
java.lang.String	getRegion()
java.net.URI	getURI()
java.lang.String	getVersionId()
int	hashCode()
boolean	isPathStyle()
java.lang.String	toString()

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

AmazonS3URI

public AmazonS3URI(java.lang.String str)

Creates a new AmazonS3URI by parsing the given string. String will be URL encoded before generating the URI.

Parameters:

str - the URI to parse.

AmazonS3URI

public AmazonS3URI(java.lang.String str,
                   boolean urlEncode)

Creates a new AmazonS3URI by parsing the given string. String will optionally be URL encoded before generating the URI. URL encoding is recommended if you work with bucket names or object keys with special characters. This can be disabled if you pre-encode URI strings before passing them to this class.

Parameters:

str - the URI to parse.

urlEncode - true if string should be URL encoded

AmazonS3URI

public AmazonS3URI(java.net.URI uri)

Creates a new AmazonS3URI by wrapping the given URI.

Parameters:

uri - the URI to wrap

Method Detail

getURI

public java.net.URI getURI()

Returns:

the S3 URI being parsed

isPathStyle

public boolean isPathStyle()

Returns:

true if the URI contains the bucket in the path, false if it contains the bucket in the authority

getBucket

public java.lang.String getBucket()

Returns:

the bucket name parsed from the URI (or null if no bucket specified)

getKey

public java.lang.String getKey()

Returns:

the key parsed from the URI (or null if no key specified)

getVersionId

public java.lang.String getVersionId()

Returns:

the version id parsed from the URI (or null if no version specified)

getRegion

public java.lang.String getRegion()

Returns:

the region parsed from the URI (or null if no region specified)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object