There is currently no mechanism in ColdFusion MX 6.1 to create or process header fields in web services. This TechNote provides a patch to Apache Axis to allow users to retrieve the response headers from a web service request, as well as a hot fix to allow users to create a SOAP header in a request that has the"mustUnderstand" attribute set to be true.
There are two components to the download provided in this TechNote:
Part 1 (webservices.jar and soap-udfs.cfm) - Allows CFMX to send and receive SOAP headers. It also allows a ColdFusion component (CFC) to learn if it was invoked via SOAP or by some other mechanism such as Flash Remoting. The Web Service header functions in soap-udfs.cfm should only be used in a ColdFusion component when it is invoked via SOAP.
Part 2 (hf53566_61.jar) - Allows the mustUnderstand SOAP header attribute to be processed by CFMX. This lets CFMX set the attribute when invoking a non-CFMX web service that requires it. It also lets a ColdFusion component learn whether this attribute was set when processing a web service request header.
Note: Most customers will not need Part 2. Only if all three of the following conditions are met, should the hot fix be installed:
- Headers must be passed to an external, non-ColdFusion web service
- The web service processes headers with the "mustUnderstand" attribute set
- The web service also requires that the"mustUnderstand" attribute be set.
Note: The webservices.jar located in this download has been updated as of 3/15/04 to include the patch from Security Bulletin MPSB04-04.
SOAP Header UDF functions
Five user-defined functions are supplied in the soap-udfs.cfm file to access SOAP headers. It is necessary to installPart 1 to use these functions. For examples on how to use these functions, download examples.zip (2K)
Functions used in ColdFusion web service components (CFCs)