SOAP WSDL - Versionsgeschichte

Cg: /* classNamePrefix: aString */

2023-07-08T04:55:37Z

classNamePrefix: aString

← Nächstältere Version		Version vom 8. Juli 2023, 04:55 Uhr
Zeile 207:		Zeile 207:
	defines (overwrites) the prefix to be used for all classes (i.e. type- and client classes). This includes the namespace prefix. Thus, if you say:		defines (overwrites) the prefix to be used for all classes (i.e. type- and client classes). This includes the namespace prefix. Thus, if you say:
	builder classNamePrefix: 'DBK_'.		builder classNamePrefix: 'DBK_'.
	all generated ~~type~~ classes will be named "DBK_<schema name>", and the client class will be "DBK_<serviceName>Client".		all generated classes will be named "DBK_<schema name>", and the client class will be "DBK_<serviceName>Client".

	==== Generated Data Holder Classes (TypeClasses) ====		==== Generated Data Holder Classes (TypeClasses) ====

Cg: /* WSDL Class Generator */

2023-07-08T04:53:41Z

WSDL Class Generator

← Nächstältere Version		Version vom 8. Juli 2023, 04:53 Uhr
Zeile 160:		Zeile 160:
	== WSDL Class Generator ==		== WSDL Class Generator ==

	The wsdl class generator takes WSDL definitions and generates a client class ~~containing~~ entries for the operations, and type classes which hold the arguments and return values.		The wsdl class generator takes WSDL definitions and generates a Smalltalk client class. This contains entries for the operations and type classes which hold the arguments and return values.

	==== Generating Classes ====		==== Generating Classes ====

Cg: /* Basic Usage */

2021-11-19T10:13:20Z

Basic Usage

← Nächstältere Version		Version vom 19. November 2021, 10:13 Uhr
Zeile 10:		Zeile 10:
	These chapter describes the basic underlying implementation.		These chapter describes the basic underlying implementation.
	The code generated by the WSDL class generator calls those functions.		The code generated by the WSDL class generator calls those functions.


	To make a SOAP request as a client, given a WSDL (either as file, string or URL),		To make a SOAP request as a client, given a WSDL (either as file, string or URL),

Cg: /* SOAP WSDL Package */

2021-11-19T10:12:58Z

SOAP WSDL Package

← Nächstältere Version		Version vom 19. November 2021, 10:12 Uhr
Zeile 1:		Zeile 1:
	== SOAP WSDL Package ==		== SOAP WSDL Package ==

			This document describes the internal workings of the SOAP framework (in the Smalltalk class library). The SOAP actions call these internal functions, and the WSDL importer generates code to call them.

			As an expecco user, you will not need to know those details;
			however the information herein may be useful if you have very special/exotic transport requirements or to setup fake (mockup) services and WSDL providers.

	== Basic Usage ==		== Basic Usage ==

Cg: /* Using PartnerService */

2021-11-19T10:08:30Z

Using PartnerService

← Nächstältere Version		Version vom 19. November 2021, 10:08 Uhr
Zeile 297:		Zeile 297:
	use:		use:
	service := SOAP__PartnerService new.		service := SOAP__PartnerService new.


	suchArg := SOAP_PartnerService_seitenSuche new.		suchArg := SOAP_PartnerService_seitenSuche new.
	suchArg ergebnisType:'ALLES'.		suchArg ergebnisType:'ALLES'.
	result := service listePartner: suchArg.		result := service listePartner: suchArg.


	"result will be an instance of kontrollTyp"		"result will be an instance of kontrollTyp"
	Transcript show: result code.		Transcript show: result code.

Cg: /* Using PartnerService */

2021-11-19T10:08:11Z

Using PartnerService

← Nächstältere Version		Version vom 19. November 2021, 10:08 Uhr
Zeile 296:		Zeile 296:
	To call the partnerService at its default service port address,		To call the partnerService at its default service port address,
	use:		use:

	<code><pre>
	service := SOAP__PartnerService new.		service := SOAP__PartnerService new.

Zeile 308:		Zeile 306:
	Transcript show: result fehler.		Transcript show: result fehler.
	Transcript show: result information.		Transcript show: result information.
	</pre></code>

	for a different service URL (in-house test service), use:		for a different service URL (in-house test service), use:
	<code><pre>
	service := SOAP__PartnerService new.		service := SOAP__PartnerService new.
	service destinationUrl:'http://testServer:8080/partner/proxyservice/PartnerBusinessService.		service destinationUrl:'http://testServer:8080/partner/proxyservice/PartnerBusinessService.
	...		...
	</pre></code>

	== SOAP Package Structure ==		== SOAP Package Structure ==

Cg: /* Generating the PartnerService classes */

2021-11-19T10:07:45Z

Generating the PartnerService classes

← Nächstältere Version		Version vom 19. November 2021, 10:07 Uhr
Zeile 276:		Zeile 276:

	Generating the partnerService classes:		Generating the partnerService classes:

	<code><pre>
	definitions := WSDLDefinitions		definitions := WSDLDefinitions
	onUrl: 'http://plan-eval-esb.services.debeka.de:30050/partner/proxyservice/PartnerBusinessService?WSDL'.		onUrl: 'http://plan-eval-esb.services.debeka.de:30050/partner/proxyservice/PartnerBusinessService?WSDL'.


	builder := WSDLClassBuilder definitions:definitions.		builder := WSDLClassBuilder definitions:definitions.
	builder generate.		builder generate.
	</pre></code>

	this will generate the following classes (into the class category "SOAP-Generated-partnerService"):		this will generate the following classes (into the class category "SOAP-Generated-partnerService"):

Cg: /* Accessing the Last Call Object (after a service call) */

2021-11-19T10:07:15Z

Accessing the Last Call Object (after a service call)

← Nächstältere Version		Version vom 19. November 2021, 10:07 Uhr
Zeile 264:		Zeile 264:
	The generated client class has an instance variable, which holds the previous request object.		The generated client class has an instance variable, which holds the previous request object.
	This can be inspected in case of an error. For example,		This can be inspected in case of an error. For example,
	<code><pre>
	serviceClient lastRequest out xml		serviceClient lastRequest out xml
	</pre></code>
	returns the last out-going request's full XML envelope,		returns the last out-going request's full XML envelope,
	<br>and:		<br>and:
	<code><pre>
	serviceClient lastRequest in xml		serviceClient lastRequest in xml
	</pre></code>
	contains the last response.		contains the last response.

Cg: /* Using Generated Client Classes */

2021-11-19T10:06:44Z

Using Generated Client Classes

← Nächstältere Version		Version vom 19. November 2021, 10:06 Uhr
Zeile 233:		Zeile 233:

	To instantiate a service client, use:		To instantiate a service client, use:
	<code><pre>
	serviceClient := <generatedServiceClientClass> new.		serviceClient := <generatedServiceClientClass> new.
	</pre></code>
	to use a different URL, change it with:		to use a different URL, change it with:
	<code><pre>
	serviceClient destinationUrl: 'http://...'.		serviceClient destinationUrl: 'http://...'.
	</pre></code>

	Once instantiated, the serviceClient can be reused for multiple requests to the same service host.		Once instantiated, the serviceClient can be reused for multiple requests to the same service host.
Zeile 246:		Zeile 242:
	Then setup the service arguments. Look into the source of the client classes' operation methods, to see what it expects,		Then setup the service arguments. Look into the source of the client classes' operation methods, to see what it expects,
	and the source of the corresponding type-class to see what elements it has:		and the source of the corresponding type-class to see what elements it has:
	<code><pre>
	arg := <operationTypeClass> new.		arg := <operationTypeClass> new.
	arg foo: valueForFoo.		arg foo: valueForFoo.
	arg bar: valueForBar.		arg bar: valueForBar.
	...		...
	</pre></code>

	Finally, perform the service call with:		Finally, perform the service call with:
	<code><pre>
	rslt := serviceClient operation: arg.		rslt := serviceClient operation: arg.
	</pre></code>
	the returned result-object will be an instance of the response type-class, with getters as specified in the WSDL. Look at the comments in the getters, to see what you get.		the returned result-object will be an instance of the response type-class, with getters as specified in the WSDL. Look at the comments in the getters, to see what you get.

Cg: /* Generated Data Holder Classes (TypeClasses) */

2021-11-19T10:06:11Z

Generated Data Holder Classes (TypeClasses)

← Nächstältere Version		Version vom 19. November 2021, 10:06 Uhr
Zeile 217:		Zeile 217:
	The translation to lowercase is done, because most Smalltalks give a warning about or even forbid instance variables with an uppercase first character. However, you may prefer having the original XSD schema names as instance variables and getter/setter names.		The translation to lowercase is done, because most Smalltalks give a warning about or even forbid instance variables with an uppercase first character. However, you may prefer having the original XSD schema names as instance variables and getter/setter names.
	Then use:		Then use:
	<code><pre>
	builder forceLowercaseFieldNames: false		builder forceLowercaseFieldNames: false
	</pre></code>
	before calling the generate method.		before calling the generate method.


	==== Using Generated Client Classes ====		==== Using Generated Client Classes ====