com.ibm.cloud.objectstorage.regions

Class RegionMetadataParser

java.lang.Object

com.ibm.cloud.objectstorage.regions.RegionMetadataParser

public class RegionMetadataParser
extends Object

Parses a region metadata file to pull out information about the available regions, names, IDs, and what service endpoints are available in each region.

Constructor Summary

Constructors

Constructor and Description
RegionMetadataParser() Deprecated. since this object is stateless

Method Summary

Modifier and Type	Method and Description
static RegionMetadata	parse(InputStream input) Parses the specified input stream and returns a RegionMetadata object.
List<Region>	parseRegionMetadata(InputStream input) Deprecated. in favor of RegionMetadataParser.parse(InputStream)
List<Region>	parseRegionMetadata(InputStream input, boolean endpointVerification) Deprecated. in favor of RegionMetadataParser.parse(InputStream)

Methods inherited from class java.lang.Object

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

Constructor Detail

RegionMetadataParser

@Deprecated
public RegionMetadataParser()

Deprecated. since this object is stateless

Method Detail

parse

public static RegionMetadata parse(InputStream input)
                            throws IOException

Parses the specified input stream and returns a RegionMetadata object.

Parameters:

input - the input stream to parse

Returns:

the parsed region metadata

Throws:

IOException - on error

parseRegionMetadata

@Deprecated
public List<Region> parseRegionMetadata(InputStream input)
                                             throws IOException

Deprecated. in favor of RegionMetadataParser.parse(InputStream)

Parses the specified input stream and returns a list of the regions declared in it. By default, verification on the region endpoints is disabled.

Parameters:

input - The stream containing the region metadata to parse.

Returns:

The list of parsed regions.

Throws:

IOException

parseRegionMetadata

@Deprecated
public List<Region> parseRegionMetadata(InputStream input,
                                                    boolean endpointVerification)
                                             throws IOException

Deprecated. in favor of RegionMetadataParser.parse(InputStream)

Parses the specified input stream and optionally verifies that all of the endpoints end in ".amazonaws.com". This method is deprecated, since not all valid AWS endpoints end in ".amazonaws.com" any more.

Parameters:

input - The stream containing the region metadata to parse.

endpointVerification - Whether to verify each region endpoint

Returns:

The list of parsed regions.

Throws:

IOException