Class EnsLib.SOAP.InboundAdapter

class EnsLib.SOAP.InboundAdapter extends EnsLib.TCP.InboundAdapter

Base adapter class for Automatic SOAP WebServices

Parameters	Properties	Methods	Queries	Indices	ForeignKeys	Triggers
2	6	7

Summary

Properties
%CredentialsObj	%PoolLimit	%SplitBody	%ToLowerHeaderVars
%WarnedLatest	%logConnections	%outIPAddr	AdapterURL
AllowedIPAddresses	BusinessHost	CallInterval	Connected
Credentials	Device	EnableStandardRequests	IOAddr
JobPerConnection	KeepaliveInterval	LocalInterface	OldIO
Port	QSize	ReadTimeout	RegistryID
SSLConfig	Socket	StayConnected	Terminators

Methods
%AddToSaveSet	%ClassIsLatestVersion	%ClassName	%ConstructClone
%DispatchClassMethod	%DispatchGetModified	%DispatchGetProperty	%DispatchMethod
%DispatchSetModified	%DispatchSetMultidimProperty	%DispatchSetProperty	%Extends
%GetParameter	%IsA	%IsModified	%New
%NormalizeObject	%ObjectModified	%OriginalNamespace	%PackageName
%RemoveFromSaveSet	%SerializeObject	%SetModified	%ValidateObject
AssignOneSetting	ClearAllAppData	ClearRuntimeAppData	ClearStaticAppData
ConnectOut	ConnectedSet	CredentialsSet	Disconnect
EnumerateSettingsClose	EnumerateSettingsExecute	EnumerateSettingsFetch	FlushWrite
GetAddress	GetSettings	IsReadError	IsWriteError
OnConnected	OnInit	OnKeepalive	OnTask
OnTearDown	TestConnection	connectedJob	faultStream
faultString

Parameters

• parameter Mode = "SW";

Override the Device Mode that will be used to open the TCP socket

• parameter SETTINGS = "EnableStandardRequests:Connection,AdapterURL:Connection";

List of properties can be set as settings in the configuration file format is a comma separated list of property names

Properties

• property %SplitBody as %Integer(VALUELIST=",0,1,2") [ InitialExpression = 0 ];

Set to 1 to enable splitting of the SOAP Body into a separate stream and excluding it from the Envelope and Headers stream. This avoids a full XML parse of the Body and also injects any namespace declarations from the Envelope into the opening Body tag. Set to 2 to do this and call ProcessBody() directly without processing any of the SOAP headers.

• property %ToLowerHeaderVars as %Boolean [ InitialExpression = 1 ];

Set this to 0 to prevent normalizing of HTTP header variable names to lowercase

• property AdapterURL as %String(MAXLEN=1000);

A specific URL for the Service to accept requests on. For SOAP Services invoked through the SOAP Inbound Adapter on a custom local port, this setting allows a custom URL to be used instead of the standard csp/namespace/classname style of URL.

• property EnableStandardRequests as %Boolean [ InitialExpression = 0 ];

Listen via the CSP WebServer, if any, in addition to listening on the custom local port.
Note that SSLConfig only applies to the custom local port. To use SSL via the CSP WebServer, you must configure the WebServer separately.
Also note that AdapterURL only applies to the custom local port. If the Service is invoked via the CSP WebServer, the ?CfgItem= URL parameter may be used to distinguish between multiple configured same-class Services but the standard csp/namespace/classname URL must be used.

• property Port as Ens.DataType.TCPAgentPort [ InitialExpression = "1980",Required ];

Local TCP port to listen on for SOAP requests (possibly in addition to listening via the CSP WebServer, if any).

• property Terminators as %String [ InitialExpression = $C(10) ];

Read-terminator character or characters, if any, for subclasses that do terminated reads.

Methods

• method OnConnected() as %Status

• method OnInit() as %Status

This user callback method is called just after %OnNew()

• classmethod faultStream(pStatus As %Status, pBHost As EnsLib.SOAP.Service, pSOAPVer As %String) as %GlobalCharacterStream

• classmethod faultString(pStatus As %Status, pBHost As EnsLib.SOAP.Service, pSOAPVer As %String = "1.1") as %String

Class Reference IRIS for UNIX 2024.1.2
Documentation Search