com.amazonaws.services.s3.model
Class BucketWebsiteConfiguration

java.lang.Object
  com.amazonaws.services.s3.model.BucketWebsiteConfiguration

public class BucketWebsiteConfiguration
extends Object

Bucket configuration options for hosting static websites entirely out of Amazon S3.

To host a static website in Amazon S3, create a bucket, upload your files, and set the bucket website configuration. Once your bucket has been configured as a website, you can access all your content via the Amazon S3 website endpoint. To ensure that the existing Amazon S3 REST API will continue to behave the same, regardless of whether or not your bucket has been configured to host a website, a new HTTP endpoint has been introduced where you can access your website content. The bucket content you want to make available via the website must be publicly readable.

To enable hosting websites, Amazon S3 introduces the following concepts/features:

• Website endpoints - When you configure a bucket as a website, the website is available via the the region-specific website endpoint where the bucket resides.
• Index document support - When configuring a bucket as a website you must provide an index document name. This is the webpage that Amazon S3 returns when it receives a request to the root of your website, or one of its subdirectories. Amazon S3 supports index documents in subdirectories.
• Error document support - Should an error occur, Amazon S3 will return an HTML error document, instead of an XML document.You can optionally provide your own error document that contains HTML, or any other static content specific to your website. You provide the error document name when you configure a bucket as a website. If you provide the custom error document, Amazon S3 returns your custom error document when an HTTP 4XX class error occurs. For other error non-4XX class errors, Amazon S3 will return its own error document.

For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting.html.

See Also:

AmazonS3#setBucketWebsiteConfiguration(String, BucketWebsiteConfiguration), AmazonS3#getBucketWebsiteConfiguration(String), AmazonS3#deleteBucketWebsiteConfiguration(String)

Constructor Summary

BucketWebsiteConfiguration()
Creates a new BucketWebsiteConfiguration.

BucketWebsiteConfiguration(String indexDocumentSuffix)
Creates a new BucketWebsiteConfiguration with the specified index document suffix.

BucketWebsiteConfiguration(String indexDocumentSuffix, String errorDocument)
Creates a new BucketWebsiteConfiguration with the specified index document suffix and error document.

Method Summary

String	getErrorDocument() Returns the complete path to the document to serve for 4xx errors, or null if no error document has been configured.
String	getIndexDocumentSuffix() Returns the document to serve when a directory is specified (ex: index.html).
RedirectRule	getRedirectAllRequestsTo() Return the redirect information where all requests will be redirect to.
List<RoutingRule>	getRoutingRules() Return the list of routing rules that can be used for configuring redirects if certain conditions are meet.
void	setErrorDocument(String errorDocument) Sets the complete path to the document to serve for 4xx errors.
void	setIndexDocumentSuffix(String indexDocumentSuffix) Sets the document to serve when a directory is specified (ex: index.html).
void	setRedirectAllRequestsTo(RedirectRule redirectAllRequestsTo) Sets the redirect information where all requests will be redirect to.
void	setRoutingRules(List<RoutingRule> routingRules) Set the list of routing rules that can be used for configuring redirects if certain conditions are meet.
BucketWebsiteConfiguration	withRedirectAllRequestsTo(RedirectRule redirectAllRequestsTo) Sets the redirect information where all requests will be redirect to and returns a reference to this object(BucketWebsiteConfiguration) for method chaining.
BucketWebsiteConfiguration	withRoutingRules(List<RoutingRule> routingRules) Set the list of routing rules that can be used for configuring redirects if certain conditions are meet and returns a reference to this object(BucketWebsiteConfiguration) for method chaining.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BucketWebsiteConfiguration

public BucketWebsiteConfiguration()

Creates a new BucketWebsiteConfiguration.

BucketWebsiteConfiguration

public BucketWebsiteConfiguration(String indexDocumentSuffix)

Creates a new BucketWebsiteConfiguration with the specified index document suffix.

Parameters:

indexDocumentSuffix - The document to serve when a directory is specified (ex: index.html). This path is relative to the requested resource.

BucketWebsiteConfiguration

public BucketWebsiteConfiguration(String indexDocumentSuffix,
                                  String errorDocument)

Creates a new BucketWebsiteConfiguration with the specified index document suffix and error document.

Parameters:

indexDocumentSuffix - The document to serve when a directory is specified (ex: index.html). This path is relative to the requested resource.

errorDocument - The complete path to the document to serve for 4xx errors.

Method Detail

getIndexDocumentSuffix

public String getIndexDocumentSuffix()

Returns the document to serve when a directory is specified (ex: index.html). This path is relative to the requested resource.

Returns:

The document to serve when a directory is specified (ex: index.html). This path is relative to the requested resource.

setIndexDocumentSuffix

public void setIndexDocumentSuffix(String indexDocumentSuffix)

Sets the document to serve when a directory is specified (ex: index.html). This path is relative to the requested resource.

Parameters:

indexDocumentSuffix - The document to serve when a directory is specified (ex: index.html). This path is relative to the requested resource.

getErrorDocument

public String getErrorDocument()

Returns the complete path to the document to serve for 4xx errors, or null if no error document has been configured.

Returns:

The complete path to the document to serve for 4xx errors, or null if no error document has been configured.

setErrorDocument

public void setErrorDocument(String errorDocument)

Sets the complete path to the document to serve for 4xx errors.

Parameters:

errorDocument - The complete path to the document to serve for 4xx errors.

setRedirectAllRequestsTo

public void setRedirectAllRequestsTo(RedirectRule redirectAllRequestsTo)

Sets the redirect information where all requests will be redirect to.

Parameters:

redirectAllRequestsTo - The Redirect information where all requests will be redirect to.

getRedirectAllRequestsTo

public RedirectRule getRedirectAllRequestsTo()

Return the redirect information where all requests will be redirect to.

withRedirectAllRequestsTo

public BucketWebsiteConfiguration withRedirectAllRequestsTo(RedirectRule redirectAllRequestsTo)

Sets the redirect information where all requests will be redirect to and returns a reference to this object(BucketWebsiteConfiguration) for method chaining.

Parameters:

redirectAllRequestsTo - The Redirect information where all requests will be redirect to.

Returns:

a reference to this object(BucketWebsiteConfiguration) for method chaining.

setRoutingRules

public void setRoutingRules(List<RoutingRule> routingRules)

Set the list of routing rules that can be used for configuring redirects if certain conditions are meet.

Parameters:

routingRules - The list of routing rules that can be used for configuring redirects.

getRoutingRules

public List<RoutingRule> getRoutingRules()

Return the list of routing rules that can be used for configuring redirects if certain conditions are meet.

withRoutingRules

public BucketWebsiteConfiguration withRoutingRules(List<RoutingRule> routingRules)

Set the list of routing rules that can be used for configuring redirects if certain conditions are meet and returns a reference to this object(BucketWebsiteConfiguration) for method chaining.

Parameters:

routingRules - The list of routing rules that can be used for configuring redirects.

Returns:

A reference to this object(BucketWebsiteConfiguration) for method chaining.