THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
...
The example also shows an important feature of the ServiceMix Client API - how to bind a WSDL file for a web service, which is adorned with WSIF additional metadata to configure the service implementation. In other words, the service.wsdl file contains WSIF extensions to WSDL that bind the web service to the protocol. The following snippet is from the servicemix.xml file. Note: that the WSIFBinding class has the service.wsdl file as a property.
| Wiki Markup |
|---|
{snippet:id=wsif|lang=xml|url=http://svn.servicemix.codehaus.org/*checkout*/branches/servicemix-1.1/base/src/test/resources/org/servicemix/components/wsif/example.xml} |
Here is an example of how to enable a service to be exposed over a JMS topic or queue. This is a snippet of code from the service.wsdl file. It shows how to configure the JMS binding:
| Wiki Markup |
|---|
{snippet:id=wsif|lang=xml|url=http://svn.servicemix.codehaus.org/*checkout*/branches/servicemix-1.1/base/src/test/resources/org/servicemix/components/wsif/service.wsdl} |
Working with XML versus properties.
The JBI standard requires encoding WSDL 1.1 parts using an XML encoding mechanism. ServiceMix supports this model. However, in addition we also allow the message properties to be used with WSIF as the named parts to avoid unnecessary XML marshalling. For example here is a Java example using the ServiceMix Client API in a WSIF style of working, passing in and fetching out named parameters.
| Wiki Markup |
|---|
{snippet:id=wsif|lang=java|url=http://svn.servicemix.codehaus.org/*checkout*/branches/servicemix-1.1/base/src/test/java/org/servicemix/components/wsif/WsifTest.java} |
This Java code works against the given WSDL 1.1 service using its named parts. Please see below for the sample WSDL codetransport protocol.
How it Works
The diagram below illustrates the logical flow of the program through the WSIF components:
...
Component or Bean ID | Description | ||
|---|---|---|---|
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="32ad0fa1c42c681f-1d968eae-42fe4464-943297fe-b0b3a6c5e2987900a46019d0"><ac:plain-text-body><![CDATA[ | checkAvailability | This component uses the WSIFBinding class to integrate WSIF to ServiceMix as specified in the class property. Its definitionResource property is set to read the file classpath:org/servicemix/components/wsif/service.wsdl, which defines the WSDL file that will be used. This file can be found at [servicemix_src_install_dir]\src\test \resources\org\servicemix\components\wsif. In the init() method of the WSIFBinding class, service.wsdl is read to define the binding extension. | ]]></ac:plain-text-body></ac:structured-macro> |
MDB | This message driven bean is the actual implementation of the service. It acts like a message listener on the queue specified in the config files. When a message is delivered, it extracts the body which is presumably a valid zip code. It then applies some logic to determine whether DSL service is available at this zip code or not. For simplicity, it just returns true for all zip codes < 50000, and false otherwise. The return message is sent to the queue specified in the replyTo field of the request message. Note that the bean must encode the correct JMSCorrelationID in the return message in order for it to be picked up by WSIF. |
Some Coding Details
The following snippet is from the servicemix.xml file. Note: that the WSIFBinding class has the service.wsdl file as a property.
| Wiki Markup |
|---|
{snippet:id=wsif|lang=xml|url=http://svn.servicemix.codehaus.org/*checkout*/branches/servicemix-1.1/base/src/test/resources/org/servicemix/components/wsif/example.xml} |
Here is an example of how to enable a service to be exposed over a JMS topic or queue. This is a snippet of code from the service.wsdl file. It shows how to configure the JMS binding:
| Wiki Markup |
|---|
{snippet:id=wsif|lang=xml|url=http://svn.servicemix.codehaus.org/*checkout*/branches/servicemix-1.1/base/src/test/resources/org/servicemix/components/wsif/service.wsdl} |
Working with XML versus properties.
The JBI standard requires encoding WSDL 1.1 parts using an XML encoding mechanism. ServiceMix supports this model. However, in addition we also allow the message properties to be used with WSIF as the named parts to avoid unnecessary XML marshalling. For example here is a Java example using the ServiceMix Client API in a WSIF style of working, passing in and fetching out named parameters.
| Wiki Markup |
|---|
{snippet:id=wsif|lang=java|url=http://svn.servicemix.codehaus.org/*checkout*/branches/servicemix-1.1/base/src/test/java/org/servicemix/components/wsif/WsifTest.java} |
This Java code works against the given WSDL 1.1 service using its named parts. Please see below for the sample WSDL code.
A code snippet from service.wsdl file:
...