Package com._1c.g5.v8.dt.ws.common

Class WSDefinitionLoader

java.lang.Object

com._1c.g5.v8.dt.natives.library.AbstractScomConnectionLoader

com._1c.g5.v8.dt.ws.common.WSDefinitionLoader

public class WSDefinitionLoader
extends AbstractScomConnectionLoader

Special provider for getting WSDL file content by url and by concrete Version.

• Firstly client should check that WSDefinitionLoader.Certificate is needed for this url. See method needUpdateCertificate(String). If it is needed than tune it
• Secondly client should check that authorization is needed for this url. See method needUrlAuthentification(String, Certificate). If authorization is needed client should find correct user name and password. User name and password should be checked by method checkUrlAuthentification(String, Certificate, String, String)
• Now client can get WSDL file content using information in previous stage. Client should call next methods for this getWSDefinitionContent(String, Certificate) or getWSDefinitionContent(String, Certificate, String, String). If there is no WSDefinitionLoader.Certificate and authorization client should call method getWSDefinitionContent(String)
• At the end, client should call dispose() for release special data for getting content of WSDL file by url

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	WSDefinitionLoader.Certificate	Special class contains structure of certificate for getting content of WSDL file.
static class	WSDefinitionLoader.WSDefinitionContent	Class contains full content of WSDefinition.

Field Summary

Fields inherited from class com._1c.g5.v8.dt.natives.library.AbstractScomConnectionLoader

LD_LIBRARY_PATH, version

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	WSDefinitionLoader(String id, Version version, IProcessManager processManager, IResolvableRuntimeInstallationManager resolvableRuntimeInstallationManager)	Constructor

Method Summary

Modifier and Type	Method	Description
boolean	checkUrlAuthentification(String url, WSDefinitionLoader.Certificate certificate, String user, String password)	Tries to authentification for WSDL url by certificate, user name and password
void	dispose()	Releases special data for getting content of WSDL file by url You should call this method if you have no plans to soon get content of WSDL file or calling other methods from this class.
WSDefinitionLoader.WSDefinitionContent	getWSDefinitionContent(String url)	Gets WSDL file content and content of the external xsd files by url
WSDefinitionLoader.WSDefinitionContent	getWSDefinitionContent(String url, WSDefinitionLoader.Certificate certificate)	Gets WSDL file content and content of the external xsd files by url
WSDefinitionLoader.WSDefinitionContent	getWSDefinitionContent(String url, WSDefinitionLoader.Certificate certificate, String user, String password)	Gets WSDL file content and content of the external xsd files by url
boolean	needUpdateCertificate(String url)	Checks that WSDL url need for authentification WSDefinitionLoader.Certificate
boolean	needUrlAuthentification(String url, WSDefinitionLoader.Certificate certificate)	Checks that WSDL url need authentification

Methods inherited from class com._1c.g5.v8.dt.natives.library.AbstractScomConnectionLoader

getLibraries, getMessageException, getProcessEnvironments, getRuntimeInstallation, getSystemLibraries

Methods inherited from class java.lang.Object

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

Constructor Detail

WSDefinitionLoader

protected WSDefinitionLoader(String id,
                             Version version,
                             IProcessManager processManager,
                             IResolvableRuntimeInstallationManager resolvableRuntimeInstallationManager)

Constructor

Parameters:

id - unique id for creating infrastructure for getting WSDL file content, can't be null

version - actual Version for getting images, can't be null

processManager - actual IProcessManager, can't be null

resolvableRuntimeInstallationManager - actual IResolvableRuntimeInstallationManager, can't be null

Method Detail

getWSDefinitionContent

public WSDefinitionLoader.WSDefinitionContent getWSDefinitionContent(String url)
                                                              throws WSDefinitionLoaderException

Gets WSDL file content and content of the external xsd files by url

Parameters:

url - actual WSDL url, can't be null

Returns:

WSDL file content and content of the external xsd files, never null

Throws:

WSDefinitionLoaderException - if exception in native API is occurred

getWSDefinitionContent

public WSDefinitionLoader.WSDefinitionContent getWSDefinitionContent(String url,
                                                                     WSDefinitionLoader.Certificate certificate)
                                                              throws WSDefinitionLoaderException

Gets WSDL file content and content of the external xsd files by url

Parameters:

url - actual WSDL url, can't be null

certificate - actual WSDefinitionLoader.Certificate. If Certificate not needed you should pass null

Returns:

WSDL file content and content of the external xsd files, never null

Throws:

WSDefinitionLoaderException - if exception in native API is occurred

getWSDefinitionContent

public WSDefinitionLoader.WSDefinitionContent getWSDefinitionContent(String url,
                                                                     WSDefinitionLoader.Certificate certificate,
                                                                     String user,
                                                                     String password)
                                                              throws WSDefinitionLoaderException

Gets WSDL file content and content of the external xsd files by url

Parameters:

url - actual WSDL url, can't be null

certificate - actual WSDefinitionLoader.Certificate. If Certificate not needed you should pass null

user - name of the user for authentification, can be null or empty string if user name not needed for authentification

password - password for authentification, can be null or empty string if password not needed for authentification

Returns:

WSDL file content and content of the external xsd files, never null

Throws:

WSDefinitionLoaderException - if exception in native API is occurred

checkUrlAuthentification

public boolean checkUrlAuthentification(String url,
                                        WSDefinitionLoader.Certificate certificate,
                                        String user,
                                        String password)
                                 throws WSDefinitionLoaderException

Tries to authentification for WSDL url by certificate, user name and password

Parameters:

url - actual WSDL url, can't be null

certificate - actual WSDefinitionLoader.Certificate. If Certificate not needed you should pass null

password - password for authentification, can be null or empty string if password not needed for authentification

Returns:

true if authentification pass correctly, false otherwise

Throws:

WSDefinitionLoaderException - if exception in native API is occurred

needUrlAuthentification

public boolean needUrlAuthentification(String url,
                                       WSDefinitionLoader.Certificate certificate)
                                throws WSDefinitionLoaderException

Checks that WSDL url need authentification

Parameters:

url - actual WSDL url, can't be null

certificate - actual WSDefinitionLoader.Certificate. If Certificate not needed you should pass null

Returns:

true if WSDL url need authentification, false otherwise

Throws:

WSDefinitionLoaderException - if exception in native API is occurred

needUpdateCertificate

public boolean needUpdateCertificate(String url)
                              throws WSDefinitionLoaderException

Checks that WSDL url need for authentification WSDefinitionLoader.Certificate

Parameters:

url - actual WSDL url, can't be null

Returns:

true if WSDL url need for authentification WSDefinitionLoader.Certificate, false otherwise

Throws:

WSDefinitionLoaderException - if exception in native API is occurred

dispose

public void dispose()

Releases special data for getting content of WSDL file by url
You should call this method if you have no plans to soon get content of WSDL file or calling other methods from this class. Attention! Client shouldn't call it after each call of methods from this class.