Fading Coder

One Final Commit for the Last Sprint

Home > Tech > Content

Exploring Additional Configuration-Driven Modifications to Generated IRIS SOAP Web Service WSDL

Tech May 7 3

Several configuration options for InterSystems IRIS web services alter the <types> segment and other WSDL components.

Defaults to 0; set INCLUDEDOCUMENTATION to 1 on the web service to embed triple-slash (///) comments from type clases as <s:annotation><s:documentation> elements. For example, editing ArithmeticWithComplexPairs service to include Parameter INCLUDEDOCUMENTATION = 1; while the paired type ImaginaryRealNumber has comments:

Class MyMath.ImaginaryRealNumber Extends %SOAP.DataType
{
/// Represents a pair of real and imaginary components for a complex value
Property Real As %Double;
/// Imaginary component coefficient
Property Imaginary As %Double;
}

The WSDL <types> section would then include:

...
<s:complexType name="ImaginaryRealNumber">
    <s:annotation>
        <s:documentation>Represents a pair of real and imaginary components for a complex value</s:documentation>
    </s:annotation>
    <s:sequence>
        <s:element minOccurs="0" name="Real" type="s:double">
            <s:annotation>
                <s:documentation>Real component coefficient</s:documentation>
            </s:annotation>
        </s:element>
        <s:element minOccurs="0" name="Imaginary" type="s:double">
            <s:annotation>
                <s:documentation>Imaginary component coefficient</s:documentation>
            </s:annotation>
        </s:element>
    </s:sequence>
</s:complexType>
...
  • SOAPBINARY=1 modifies <types> and related sections for IRIS-specific binary SOAP encoding.
  • SOAPSESSION=1 introduces WSDL elements dedicated to managing SOAP session state.
  • Defining the SoapTypeNameSpace class keyword overrides the default XML namespace used for types within the <types> block.
  • Setting REQUIRED=1 on a web method parameter, property, or type field enfocres minOccurs="1" in the corresponding XML schema element.
  • Applying the SoapRequestMessage method keyword replaces the default <operation> input element name with the specified value instead of the method’s original identifier.
  • The ALLOWREDUNDANTARRAYNAME service parameter controls how colllection properties (like lists or arrays) map to XML schema structures within <types>.
Tags: SOAPWSDL

Related Articles

Understanding Strong and Weak References in Java

Strong References Strong reference are the most prevalent type of object referencing in Java. When an object has a strong reference pointing to it, the garbage collector will not reclaim its memory. F...

Comprehensive Guide to SSTI Explained with Payload Bypass Techniques

Introduction Server-Side Template Injection (SSTI) is a vulnerability in web applications where user input is improper handled within the template engine and executed on the server. This exploit can r...

Implement Image Upload Functionality for Django Integrated TinyMCE Editor

Django’s Admin panel is highly user-friendly, and pairing it with TinyMCE, an effective rich text editor, simplifies content management significantly. Combining the two is particular useful for bloggi...

Leave a Comment

Anonymous

◎Feel free to join the discussion and share your thoughts.