*** QMan WS-DM examples *** | |
1) DESCRIPTION | |
This set of examples shows QMan WS-DM interface capabilities. | |
Each example is articulated in the following way. | |
First the name of the example class with a brief description about that is printed out. For example : | |
GetWSDLMetadataExample | |
------------------------------------------------------------------- | |
This example shows the usage of WS-DM | |
GetResourcePropertyRequest / Response on a | |
Group service. | |
The target resource is the WS-DM Adapter itself | |
and the requested property is "ws-rp:Entry". | |
WS-DM Adapter is a special WS-Resource (is a Group) | |
that acts as the main entry point for retrieving | |
all other managed resources. | |
So clients that want to deal with QMan WS-Resources | |
must first get resource identifiers sending | |
a GetResourcePropertyRequest to WS-DM Adapter | |
with "ws-rp:Entry" as target target property. | |
------------------------------------------------------------------- | |
Type enter to proceed. | |
When you're ready type enter to proceed. Now the example runs and all the exchanged | |
SOAP messages are printed out on the screen. | |
If you want, we shipped (under sample_messages folder) several files containing those messages. | |
A general note concerning examples...they are all written using java language so what you see is the | |
"java" usage of WS-DM client API. | |
The most important thing that you should keep in mind is that what is expected (on QMan side) is a SOAP WS-DM | |
compliant message so on top of that you don't need to use those java API but feel free to produce those messages | |
in your preferred way (by hand or using another programming language). | |
Another thing : the examples contain a lot of code duplication because each of them is took as independent as possible. | |
The general idea is that you open an example source file and in the executeExample(...) method you should have a quick | |
idea of how things are working. | |
Also, as mentioned before, we provided, under the sample_messages folder, the messages that are part of each example conversation. | |
Remember : these messages are important, not the way / language you use to produce them. | |
2) HOW TO RUN | |
2.1) Java | |
You need JDK 1.5 or higher in order to run and / or compile the examples. | |
2.2) Dependencies | |
You need to set / update the CLASSPATH environment variable with libraries found under $QMAN_HOME/app/qman/WEB-INF/lib. | |
After that you should be able to run one the shipped examples: | |
> java org.apache.qpid.management.example.GetMultipleResourcePropertiesExample <qman_host> <qman_port> | |
> java org.apache.qpid.management.example.GetQManResourceMembersExample <qman_host> <qman_port> | |
> java org.apache.qpid.management.example.GetResourceMetadataDescriptorExample <qman_host> <qman_port> | |
> java org.apache.qpid.management.example.GetResourcePropertyDocumentExample <qman_host> <qman_port> | |
> java org.apache.qpid.management.example.GetResourcePropertyExample <qman_host> <qman_port> | |
> java org.apache.qpid.management.example.GetWSDLMetadataExample <qman_host> <qman_port> | |
> java org.apache.qpid.management.example.SetResourcePropertyExample <qman_host> <qman_port> | |
Where | |
<qman_host> is the host (ip or hostname) where QMan is running; | |
<qman_port> is the port number where QMan is running; | |
2.3) Qpid | |
You must have a running C++ broker with management enabled. | |
2.4) QMan | |
You must have QMan WS-DM up, running and connected with the broker above. |