org.ow2.easywsdl.schema.api

Interface SchemaReader

All Known Implementing Classes:

AbstractSchemaReader, SchemaReaderImpl

public interface SchemaReader

This interface describes a collection of methods that enable conversion of a SchemaImpl document (in XML, following the SchemaImpl parent described in the SchemaImpl specification) into a SchemaImpl model.

Author:

Nicolas Salatge - EBM WebSourcing

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	SchemaReader.FeatureConstants Constants for the Message Exchange Patterns.

Method Summary

Methods

Modifier and Type	Method and Description
URI	getDocumentBaseURI() Get the document base URI of the reader.
Object	getFeature(SchemaReader.FeatureConstants name) Gets the value of the specified feature.
Map<SchemaReader.FeatureConstants,Object>	getFeatures() Gets all features.
Schema	read(Document document) Read the XMLSchema definition accessible via the specified DOM Document, and bind it into a Schema object.
Schema	read(InputSource inputSource) Read the XMLSchema definition accessible via the specified InputSource, and bind it into a Schema object.
Schema	read(URL schemaURL) Read the XMLSchema definition available at the location identified by the specified URL, and bind it into a Schema object.
void	setDocumentBaseURI(URI documentBaseURI) Set the document base URI of the reader to be able to resolve imported parts.
void	setFeature(SchemaReader.FeatureConstants name, Object value) Sets the specified feature to the specified value.
void	setFeatures(Map<SchemaReader.FeatureConstants,Object> features) Set the specified features.

Method Detail

setFeature

void setFeature(SchemaReader.FeatureConstants name,
              Object value)
                throws IllegalArgumentException

Sets the specified feature to the specified value.

The minimum features that must be supported are:

Name	Description	Default Value
org.ow2.easywsdl.schema.verbose	If set to true, status messages will be displayed.	type: boolean - default value: false
org.ow2.easywsdl.schema.importDocuments	If set to true, imported WSDL documents will be retrieved and processed.	type: boolean - default value: true
org.ow2.easywsdl.schema.pathDirectoryOfImportLocations	If the location is set, imported WSDL documents will be retrieved at this location (Set the importDocuments Features at true).	type: String

All feature names must be fully-qualified, Java package style. All names starting with com.ebmwebsourcing. are reserved for features defined by the specification. It is recommended that implementation- specific features be fully-qualified to match the package name of that implementation. For example: com.abc.featureName

Parameters:

name - the name of the feature to be set.

value - the value to set the feature to.

Throws:

IllegalArgumentException - if the feature name is not recognized.

See Also:

#getFeature(String)

setFeatures

void setFeatures(Map<SchemaReader.FeatureConstants,Object> features)

Set the specified features. See setFeature(FeatureConstants, Object) for more information on available features.

Parameters:

features - Set of features to set.

getFeature

Object getFeature(SchemaReader.FeatureConstants name)

Gets the value of the specified feature.

Parameters:

name - the name of the feature to get the value of.

Returns:

the value of feature

Throws:

IllegalArgumentException - if the feature name is not recognized.

See Also:

#setFeature(String, boolean)

getFeatures

Map<SchemaReader.FeatureConstants,Object> getFeatures()

Gets all features.

Returns:

the features

See Also:

#setFeature(String, boolean)

read

Schema read(URL schemaURL)
            throws SchemaException,
                   URISyntaxException,
                   IOException

Read the XMLSchema definition available at the location identified by the specified URL, and bind it into a Schema object.

Note: all relative URIs are resolved according to the specified URL.

Parameters:

schemaURL - an URL pointing to a XMLSchema definition.

Returns:

the Schema definition.

Throws:

SchemaException - An error occurs during the parsing or the binding of the XMLSchema

URISyntaxException - If the URL is not formatted strictly according to to RFC2396 and cannot be converted to a URI.

IOException - An I/O error occurs openning the URL stream.

read

Schema read(Document document)
            throws SchemaException

Read the XMLSchema definition accessible via the specified DOM Document, and bind it into a Schema object.

Note: To be able to resolve relative URIs, the Document base URI must be set.

Parameters:

document - a DOM Document pointing to a XMLSchema definition.

Returns:

the Schema definition.

Throws:

SchemaException - An error occurs during the parsing or the binding of the XMLSchema

read

Schema read(InputSource inputSource)
            throws SchemaException,
                   URISyntaxException,
                   MalformedURLException

Read the XMLSchema definition accessible via the specified InputSource, and bind it into a Schema object.

Note: To be able to resolve relative URIs, the InputSource system identifier must be set.

Parameters:

inputSource - an InputSource pointing to a XMLSchema definition.

Returns:

the Schema definition.

Throws:

SchemaException - An error occurs during the parsing or the binding of the XMLSchema

URISyntaxException - If the system identifier URL is not formatted strictly according to to RFC2396 and cannot be converted to a URI.

MalformedURLException - The system identifier URL is not a well-formed URL

setDocumentBaseURI

void setDocumentBaseURI(URI documentBaseURI)

Set the document base URI of the reader to be able to resolve imported parts.

Parameters:

documentBaseURI -

getDocumentBaseURI

URI getDocumentBaseURI()

Get the document base URI of the reader.

Returns:

The document base URI.