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
static class SchemaReader.FeatureConstants
          Constants for the Message Exchange Patterns.
 
Method Summary
 java.net.URI getDocumentBaseURI()
          Get the document base URI of the reader.
 java.lang.Object getFeature(SchemaReader.FeatureConstants name)
          Gets the value of the specified feature.
 java.util.Map<SchemaReader.FeatureConstants,java.lang.Object> getFeatures()
          Gets all features.
 Schema read(org.w3c.dom.Document document)
           Read the XMLSchema definition accessible via the specified DOM Document, and bind it into a Schema object.
 Schema read(org.xml.sax.InputSource inputSource)
           Read the XMLSchema definition accessible via the specified InputSource, and bind it into a Schema object.
 Schema read(java.net.URL schemaURL)
           Read the XMLSchema definition available at the location identified by the specified URL, and bind it into a Schema object.
 void setDocumentBaseURI(java.net.URI documentBaseURI)
          Set the document base URI of the reader to be able to resolve imported parts.
 void setFeature(SchemaReader.FeatureConstants name, java.lang.Object value)
          Sets the specified feature to the specified value.
 void setFeatures(java.util.Map<SchemaReader.FeatureConstants,java.lang.Object> features)
          Set the specified features.
 

Method Detail

setFeature

void setFeature(SchemaReader.FeatureConstants name,
                java.lang.Object value)
                throws java.lang.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:
java.lang.IllegalArgumentException - if the feature name is not recognized.
See Also:
#getFeature(String)

setFeatures

void setFeatures(java.util.Map<SchemaReader.FeatureConstants,java.lang.Object> features)
Set the specified features. See setFeature(FeatureConstants, Object) for more information on available features.

Parameters:
features - Set of features to set.

getFeature

java.lang.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:
java.lang.IllegalArgumentException - if the feature name is not recognized.
See Also:
#setFeature(String, boolean)

getFeatures

java.util.Map<SchemaReader.FeatureConstants,java.lang.Object> getFeatures()
Gets all features.

Returns:
the features
See Also:
#setFeature(String, boolean)

read

Schema read(java.net.URL schemaURL)
            throws SchemaException,
                   java.net.URISyntaxException,
                   java.io.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
java.net.URISyntaxException - If the URL is not formatted strictly according to to RFC2396 and cannot be converted to a URI.
java.io.IOException - An I/O error occurs openning the URL stream.

read

Schema read(org.w3c.dom.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(org.xml.sax.InputSource inputSource)
            throws SchemaException,
                   java.net.URISyntaxException,
                   java.net.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
java.net.URISyntaxException - If the system identifier URL is not formatted strictly according to to RFC2396 and cannot be converted to a URI.
java.net.MalformedURLException - The system identifier URL is not a well-formed URL

setDocumentBaseURI

void setDocumentBaseURI(java.net.URI documentBaseURI)
Set the document base URI of the reader to be able to resolve imported parts.

Parameters:
documentBaseURI -

getDocumentBaseURI

java.net.URI getDocumentBaseURI()
Get the document base URI of the reader.

Returns:
The document base URI.


Copyright © 2008-2010 Petals Link (previously EBM WebSourcing). All Rights Reserved.