com.amazonaws.services.s3.model.transform

Class XmlResponsesSaxParser

java.lang.Object

com.amazonaws.services.s3.model.transform.XmlResponsesSaxParser

public class XmlResponsesSaxParser
extends java.lang.Object

XML Sax parser to read XML documents returned by S3 via the REST interface, converting these documents into objects.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	XmlResponsesSaxParser.AccessControlListHandler Handler for AccessControlList response XML documents.
static class	XmlResponsesSaxParser.BucketCrossOriginConfigurationHandler
static class	XmlResponsesSaxParser.BucketLifecycleConfigurationHandler
static class	XmlResponsesSaxParser.BucketLocationHandler Handler for CreateBucketConfiguration response XML documents for a bucket.
static class	XmlResponsesSaxParser.BucketLoggingConfigurationHandler Handler for LoggingStatus response XML documents for a bucket.
static class	XmlResponsesSaxParser.BucketNotificationConfigurationHandler
static class	XmlResponsesSaxParser.BucketTaggingConfigurationHandler
static class	XmlResponsesSaxParser.BucketVersioningConfigurationHandler
static class	XmlResponsesSaxParser.BucketWebsiteConfigurationHandler
static class	XmlResponsesSaxParser.CompleteMultipartUploadHandler
static class	XmlResponsesSaxParser.CopyObjectResultHandler
static class	XmlResponsesSaxParser.DeleteObjectsHandler
static class	XmlResponsesSaxParser.InitiateMultipartUploadHandler
static class	XmlResponsesSaxParser.ListAllMyBucketsHandler Handler for ListAllMyBuckets response XML documents.
static class	XmlResponsesSaxParser.ListBucketHandler Handler for ListBucket response XML documents.
static class	XmlResponsesSaxParser.ListMultipartUploadsHandler
static class	XmlResponsesSaxParser.ListPartsHandler
static class	XmlResponsesSaxParser.ListVersionsHandler Handler for ListVersionsResult XML document.
static class	XmlResponsesSaxParser.RequestPaymentConfigurationHandler Handler for parsing RequestPaymentConfiguration XML response associated with an Amazon S3 bucket.

Constructor Summary

Constructors

Constructor and Description
XmlResponsesSaxParser() Constructs the XML SAX parser.

Method Summary

Methods

Modifier and Type	Method and Description
XmlResponsesSaxParser.AccessControlListHandler	parseAccessControlListResponse(java.io.InputStream inputStream) Parses an AccessControlListHandler response XML document from an input stream.
XmlResponsesSaxParser.BucketCrossOriginConfigurationHandler	parseBucketCrossOriginConfigurationResponse(java.io.InputStream inputStream)
XmlResponsesSaxParser.BucketLifecycleConfigurationHandler	parseBucketLifecycleConfigurationResponse(java.io.InputStream inputStream)
java.lang.String	parseBucketLocationResponse(java.io.InputStream inputStream)
XmlResponsesSaxParser.CompleteMultipartUploadHandler	parseCompleteMultipartUploadResponse(java.io.InputStream inputStream)
XmlResponsesSaxParser.CopyObjectResultHandler	parseCopyObjectResponse(java.io.InputStream inputStream)
XmlResponsesSaxParser.DeleteObjectsHandler	parseDeletedObjectsResult(java.io.InputStream inputStream)
XmlResponsesSaxParser.InitiateMultipartUploadHandler	parseInitiateMultipartUploadResponse(java.io.InputStream inputStream)
XmlResponsesSaxParser.ListBucketHandler	parseListBucketObjectsResponse(java.io.InputStream inputStream) Parses a ListBucket response XML document from an input stream.
XmlResponsesSaxParser.ListMultipartUploadsHandler	parseListMultipartUploadsResponse(java.io.InputStream inputStream)
XmlResponsesSaxParser.ListAllMyBucketsHandler	parseListMyBucketsResponse(java.io.InputStream inputStream) Parses a ListAllMyBuckets response XML document from an input stream.
XmlResponsesSaxParser.ListPartsHandler	parseListPartsResponse(java.io.InputStream inputStream)
XmlResponsesSaxParser.ListVersionsHandler	parseListVersionsResponse(java.io.InputStream inputStream) Parses a ListVersions response XML document from an input stream.
XmlResponsesSaxParser.BucketLoggingConfigurationHandler	parseLoggingStatusResponse(java.io.InputStream inputStream) Parses a LoggingStatus response XML document for a bucket from an input stream.
XmlResponsesSaxParser.BucketNotificationConfigurationHandler	parseNotificationConfigurationResponse(java.io.InputStream inputStream)
XmlResponsesSaxParser.RequestPaymentConfigurationHandler	parseRequestPaymentConfigurationResponse(java.io.InputStream inputStream)
XmlResponsesSaxParser.BucketTaggingConfigurationHandler	parseTaggingConfigurationResponse(java.io.InputStream inputStream)
XmlResponsesSaxParser.BucketVersioningConfigurationHandler	parseVersioningConfigurationResponse(java.io.InputStream inputStream)
XmlResponsesSaxParser.BucketWebsiteConfigurationHandler	parseWebsiteConfigurationResponse(java.io.InputStream inputStream)
protected void	parseXmlInputStream(org.xml.sax.helpers.DefaultHandler handler, java.io.InputStream inputStream) Parses an XML document from an input stream using a document handler.
protected java.io.InputStream	sanitizeXmlDocument(org.xml.sax.helpers.DefaultHandler handler, java.io.InputStream inputStream)

Methods inherited from class java.lang.Object

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

Constructor Detail

XmlResponsesSaxParser

public XmlResponsesSaxParser()
                      throws AmazonClientException

Constructs the XML SAX parser.

Throws:

AmazonClientException

Method Detail

parseXmlInputStream

protected void parseXmlInputStream(org.xml.sax.helpers.DefaultHandler handler,
                       java.io.InputStream inputStream)
                            throws java.io.IOException

Parses an XML document from an input stream using a document handler.

Parameters:

handler - the handler for the XML document

inputStream - an input stream containing the XML document to parse

Throws:

java.io.IOException - on error reading from the input stream (ie connection reset)

AmazonClientException - on error with malformed XML, etc

sanitizeXmlDocument

protected java.io.InputStream sanitizeXmlDocument(org.xml.sax.helpers.DefaultHandler handler,
                                      java.io.InputStream inputStream)
                                           throws java.io.IOException

Throws:

java.io.IOException

parseListBucketObjectsResponse

public XmlResponsesSaxParser.ListBucketHandler parseListBucketObjectsResponse(java.io.InputStream inputStream)
                                                                       throws java.io.IOException

Parses a ListBucket response XML document from an input stream.

Parameters:

inputStream - XML data input stream.

Returns:

the XML handler object populated with data parsed from the XML stream.

Throws:

AmazonClientException

java.io.IOException

parseListVersionsResponse

public XmlResponsesSaxParser.ListVersionsHandler parseListVersionsResponse(java.io.InputStream inputStream)
                                                                    throws java.io.IOException

Parses a ListVersions response XML document from an input stream.

Parameters:

inputStream - XML data input stream.

Returns:

the XML handler object populated with data parsed from the XML stream.

Throws:

AmazonClientException

java.io.IOException

parseListMyBucketsResponse

public XmlResponsesSaxParser.ListAllMyBucketsHandler parseListMyBucketsResponse(java.io.InputStream inputStream)
                                                                         throws java.io.IOException

Parses a ListAllMyBuckets response XML document from an input stream.

Parameters:

inputStream - XML data input stream.

Returns:

the XML handler object populated with data parsed from the XML stream.

Throws:

AmazonClientException

java.io.IOException

parseAccessControlListResponse

public XmlResponsesSaxParser.AccessControlListHandler parseAccessControlListResponse(java.io.InputStream inputStream)
                                                                              throws java.io.IOException

Parses an AccessControlListHandler response XML document from an input stream.

Parameters:

inputStream - XML data input stream.

Returns:

the XML handler object populated with data parsed from the XML stream.

Throws:

AmazonClientException

java.io.IOException

parseLoggingStatusResponse

public XmlResponsesSaxParser.BucketLoggingConfigurationHandler parseLoggingStatusResponse(java.io.InputStream inputStream)
                                                                                   throws java.io.IOException

Parses a LoggingStatus response XML document for a bucket from an input stream.

Parameters:

inputStream - XML data input stream.

Returns:

the XML handler object populated with data parsed from the XML stream.

Throws:

AmazonClientException

java.io.IOException

parseBucketLifecycleConfigurationResponse

public XmlResponsesSaxParser.BucketLifecycleConfigurationHandler parseBucketLifecycleConfigurationResponse(java.io.InputStream inputStream)
                                                                                                    throws java.io.IOException

Throws:

java.io.IOException

parseBucketCrossOriginConfigurationResponse

public XmlResponsesSaxParser.BucketCrossOriginConfigurationHandler parseBucketCrossOriginConfigurationResponse(java.io.InputStream inputStream)
                                                                                                        throws java.io.IOException

Throws:

java.io.IOException

parseBucketLocationResponse

public java.lang.String parseBucketLocationResponse(java.io.InputStream inputStream)
                                             throws java.io.IOException

Throws:

java.io.IOException

parseVersioningConfigurationResponse

public XmlResponsesSaxParser.BucketVersioningConfigurationHandler parseVersioningConfigurationResponse(java.io.InputStream inputStream)
                                                                                                throws java.io.IOException

Throws:

java.io.IOException

parseWebsiteConfigurationResponse

public XmlResponsesSaxParser.BucketWebsiteConfigurationHandler parseWebsiteConfigurationResponse(java.io.InputStream inputStream)
                                                                                          throws java.io.IOException

Throws:

java.io.IOException

parseNotificationConfigurationResponse

public XmlResponsesSaxParser.BucketNotificationConfigurationHandler parseNotificationConfigurationResponse(java.io.InputStream inputStream)
                                                                                                    throws java.io.IOException

Throws:

java.io.IOException

parseTaggingConfigurationResponse

public XmlResponsesSaxParser.BucketTaggingConfigurationHandler parseTaggingConfigurationResponse(java.io.InputStream inputStream)
                                                                                          throws java.io.IOException

Throws:

java.io.IOException

parseDeletedObjectsResult

public XmlResponsesSaxParser.DeleteObjectsHandler parseDeletedObjectsResult(java.io.InputStream inputStream)
                                                                     throws java.io.IOException

Throws:

java.io.IOException

parseCopyObjectResponse

public XmlResponsesSaxParser.CopyObjectResultHandler parseCopyObjectResponse(java.io.InputStream inputStream)
                                                                      throws java.io.IOException

Throws:

java.io.IOException

parseCompleteMultipartUploadResponse

public XmlResponsesSaxParser.CompleteMultipartUploadHandler parseCompleteMultipartUploadResponse(java.io.InputStream inputStream)
                                                                                          throws java.io.IOException

Throws:

java.io.IOException

parseInitiateMultipartUploadResponse

public XmlResponsesSaxParser.InitiateMultipartUploadHandler parseInitiateMultipartUploadResponse(java.io.InputStream inputStream)
                                                                                          throws java.io.IOException

Throws:

java.io.IOException

parseListMultipartUploadsResponse

public XmlResponsesSaxParser.ListMultipartUploadsHandler parseListMultipartUploadsResponse(java.io.InputStream inputStream)
                                                                                    throws java.io.IOException

Throws:

java.io.IOException

parseListPartsResponse

public XmlResponsesSaxParser.ListPartsHandler parseListPartsResponse(java.io.InputStream inputStream)
                                                              throws java.io.IOException

Throws:

java.io.IOException

parseRequestPaymentConfigurationResponse

public XmlResponsesSaxParser.RequestPaymentConfigurationHandler parseRequestPaymentConfigurationResponse(java.io.InputStream inputStream)
                                                                                                  throws java.io.IOException

Parameters:

inputStream -

Returns:

true if the bucket's is configured as Requester Pays, false if it is configured as Owner pays.

Throws:

AmazonClientException

java.io.IOException