swaRef (SOAP with attachments using wsi:swaRef)

swaRef must be used when you have to transfer files as attachment and located on disk.

swaRef refers to "Soap with attachments using the wsi:swaRef XML type from WS-I". It is a specific case of the SoapWithAttachment specification.

Warning: Java handles swaRef automatically. DotNet does not.

With swaRef, you can set an attribute with a dedicated value of "swaRef" on a STRING. When set, a Web service automatically sends the file in that string as an HTTP part or receives it as an HTTP part.

In the following example, a sendAttachment operation computes the MD5 of a file. The program sets XMLOptimizedContent="swaRef" on the DataIn string and the SOAP engine carries it over the wire as an HTTP part.

# Request Type
TYPE tsendAttachment RECORD ATTRIBUTES(XMLSequence,XSTypeName="sendAttachment",XSTypeNamespace="http://4js.com/services/swa")
  Name STRING ATTRIBUTES(XMLName="Name",XMLOptional),
  DataIn STRING ATTRIBUTES(XMLOptimizedContent="swaRef",XMLAttribute, XMLName="DataIn",XMLOptional)
END RECORD

# Response Type
TYPE tsendAttachmentResponse RECORD ATTRIBUTES(XMLSequence,XSTypeName="sendAttachmentResponse",XSTypeNamespace="http://4js.com/services/swa")
  return STRING ATTRIBUTES(XMLName="return",XMLOptional)
END RECORD

# VARIABLE : sendAttachment
DEFINE sendAttachment tsendAttachment ATTRIBUTES(XMLName="sendAttachment",XMLNamespace="http://4js.com/services/swa")

# VARIABLE : sendAttachmentResponse
DEFINE sendAttachmentResponse tsendAttachmentResponse ATTRIBUTES(XMLName="sendAttachmentResponse",XMLNamespace="http://4js.com/services/swa")
...
    # Publish Operation : sendAttachment
    LET operation = com.WebOperation.CreateDOCStyle("sendAttachment","sendAttachment",sendAttachment,sendAttachmentResponse)
    CALL service.publishOperation(operation,"")
...