Deprecated. XML Maps are deprecated as of the WebLogic Platform 8.1 release. For new code, use XQuery maps. For more information, see Introduction to XQuery Maps.

How Do I: Ensure that Outgoing XML Messages Conform to a Particular Shape?

When your service must generate a particular outgoing XML message shape, you can create an XML map as an translation layer between the specific Java types of your service's implementation and the corresponding outgoing message. XML maps are particularly useful in cases where a web service you develop must generate messages whose shape is beyond your control. Maps enable you to control the shape of those messages without changing the implementation of your class. You can find an introduction to XML maps at Why Use XML Maps?

Depending on how the outgoing message leaves your service, you will create either a parameter-xml map or a return-xml map. The following section describes the four circumstances under which an outgoing XML message can leave from your web service, and describes which kind of map you should use for each.

Note: For each of the outgoing message sources described in this topic, there is a related incoming message source. For more information on mapping to handle incoming messages, see How Do I: Handle XML Messages of a Certain Shape?

An outgoing message can be sent to the following targets:

The Edit Maps and Interface dialog provides a convenient way to begin an XML map. To learn more about the Edit Maps and Interface dialog, see How Do I: Add or Edit an XML Map with the Edit Maps and Interface Dialog?

Related Topics

Why Use XML Maps?

How Do I: Handle XML Messages of a Certain Shape?

How Do I: Add or Edit an XML Map with the Edit Maps and Interface Dialog?

Using Callbacks to Notify Clients of Events

JCX File: Extending Controls the topic titles linked to and from are different