org.idoox.wasp.wsdl
Interface WSDLRepository

public interface WSDLRepository

This repository is responsible for storage and indexing of handled WSDL files structure data for providing of effective finder operations on handled definitions.

Since:

4.0

Component:

Core

Nested Class Summary

static interface	WSDLRepository.Config
static class	WSDLRepository.PortInfo A holder for a Port meta data.
static class	WSDLRepository.ServiceInfo A holder for a Service meta data.

Method Summary

WSDLRepository.PortInfo[]	findPortByPortType(QName portTypeQName) This method tries to search WSDLRepository indexes for WSDL definition, which has service's port with binding of given portType.
WSDLRepository.ServiceInfo	findService(QName serviceQName) This method tries to search WSDLRepository indexes for WSDL service by its qualified name.
java.lang.String	findWSDLUrlByPort(java.lang.String portName, QName serviceQName) This method tries to search WSDLRepository indexes for WSDL definition, which contains given service's port.
Definition	getDefinition(java.lang.String wsdlURL) This method reads definition from given URL and returns its Java representation.
Definition	getDefinition(java.lang.String wsdlURL, boolean register) This method reads definition from given URL and returns its Java representation.
Definition	getDefinition(java.lang.String wsdlURL, boolean register, java.util.Map transportProps) This method reads definition from given URL and returns its Java representation.
Definition	getDefinition(java.lang.String wsdlURL, java.util.Map transportProps) This method reads definition from given URL and returns its Java representation.

Method Detail

getDefinition

public Definition getDefinition(java.lang.String wsdlURL,
                                boolean register)
                         throws java.net.MalformedURLException,
                                java.io.IOException,
                                org.xml.sax.SAXException,
                                WSDLException

This method reads definition from given URL and returns its Java representation. This is recommended way how to obtain WSDLs, because this unified Definition entry point allows caching, which saves a lot of XML/WSDL parsing system load.

Parameters:

wsdlURL - URL of requested definition

register - flag that controls, if requested definition should be processed by internal WSDLRepository indexing mechanisms

Returns:

javax.wsdl.Definition representation

Throws:

java.net.MalformedURLException - if an error occurs

java.io.IOException - if an error occurs

org.xml.sax.SAXException - if an error occurs

WSDLException - if an error occurs

getDefinition

public Definition getDefinition(java.lang.String wsdlURL)
                         throws java.net.MalformedURLException,
                                java.io.IOException,
                                org.xml.sax.SAXException,
                                WSDLException

This method reads definition from given URL and returns its Java representation. This is recommended way how to obtain WSDLs, because this unified Definition entry point allows caching, which saves a lot of XML/WSDL parsing system load. This method DOES NOT implicitly register requested definition within WSDLRepository indexing structure!

Parameters:

wsdlURL - URL of requested definition

Returns:

javax.wsdl.Definition representation

Throws:

java.net.MalformedURLException - if an error occurs

java.io.IOException - if an error occurs

org.xml.sax.SAXException - if an error occurs

WSDLException - if an error occurs

getDefinition

public Definition getDefinition(java.lang.String wsdlURL,
                                java.util.Map transportProps)
                         throws java.net.MalformedURLException,
                                java.io.IOException,
                                org.xml.sax.SAXException,
                                WSDLException

This method reads definition from given URL and returns its Java representation. This is recommended way how to obtain WSDLs, because this unified Definition entry point allows caching, which saves a lot of XML/WSDL parsing system load. This method DOES NOT implicitly register requested definition within WSDLRepository indexing structure!

Parameters:

wsdlURL - URL of requested definition

transportProps - the properties used to configure the transport operation. This parameter may be null.

Returns:

javax.wsdl.Definition representation

Throws:

java.net.MalformedURLException - if an error occurs

java.io.IOException - if an error occurs

org.xml.sax.SAXException - if an error occurs

WSDLException - if an error occurs

getDefinition

public Definition getDefinition(java.lang.String wsdlURL,
                                boolean register,
                                java.util.Map transportProps)
                         throws java.net.MalformedURLException,
                                java.io.IOException,
                                org.xml.sax.SAXException,
                                WSDLException

This method reads definition from given URL and returns its Java representation. This is recommended way how to obtain WSDLs, because this unified Definition entry point allows caching, which saves a lot of XML/WSDL parsing system load.

Parameters:

wsdlURL - URL of requested definition

register - flag that controls, if requested definition should be processed by internal WSDLRepository indexing mechanisms

transportProps - the properties used to configure the transport operation. This parameter may be null.

Returns:

javax.wsdl.Definition representation

Throws:

java.net.MalformedURLException - if an error occurs

java.io.IOException - if an error occurs

org.xml.sax.SAXException - if an error occurs

WSDLException - if an error occurs

findPortByPortType

public WSDLRepository.PortInfo[] findPortByPortType(QName portTypeQName)

This method tries to search WSDLRepository indexes for WSDL definition, which has service's port with binding of given portType.

Parameters:

portTypeQName - qualified name of requested portType declaration

Returns:

PortInfo holder or null if not found

findWSDLUrlByPort

public java.lang.String findWSDLUrlByPort(java.lang.String portName,
                                          QName serviceQName)

This method tries to search WSDLRepository indexes for WSDL definition, which contains given service's port.

Parameters:

portName - name of the requested WSDL service's port

serviceQName - qualified name of WSDL port's service

Returns:

URL of matching WSDL or null if not found

findService

public WSDLRepository.ServiceInfo findService(QName serviceQName)

This method tries to search WSDLRepository indexes for WSDL service by its qualified name.

Parameters:

serviceQName - qualified name of WSDL service

Returns:

the service or null if not found