Java/J2EE/JMS SOAP
Содержание
- 1 A JMS message listener can use the MessageTransformer utility to convert JMS messages back to SOAP messages
- 2 How to use the MessageTransformer utility to convert SOAP message to JMS message
- 3 How to use the MessageTransformer utility to send SOAP messages with JMS
- 4 This example demonstrates a hello world example for using JAXM API
- 5 This example echos the SOAP message received back to the sender
A JMS message listener can use the MessageTransformer utility to convert JMS messages back to SOAP messages
/*
* @(#)ReceiveSOAPMessageWithJMS.java 1.4 02/05/02
*
* Copyright (c) 2002 Sun Microsystems, Inc. All Rights Reserved.
*
* Sun grants you ("Licensee") a non-exclusive, royalty free, license to use,
* modify and redistribute this software in source and binary code form,
* provided that i) this copyright notice and license appear on all copies of
* the software; and ii) Licensee does not utilize the software in a manner
* which is disparaging to Sun.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY
* IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
* NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE
* LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING
* OR DISTRIBUTING THE SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR ITS
* LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT,
* INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER
* CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF
* OR INABILITY TO USE SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGES.
*
* This software is not designed or intended for use in on-line control of
* aircraft, air traffic, aircraft navigation or aircraft communications; or in
* the design, construction, operation or maintenance of any nuclear
* facility. Licensee represents and warrants that it will not use or
* redistribute the Software for such purposes.
*/
import javax.xml.soap.MessageFactory;
import javax.xml.soap.SOAPMessage;
import javax.xml.soap.AttachmentPart;
import com.sun.messaging.xml.MessageTransformer;
import com.sun.messaging.ConnectionFactory;
import javax.jms.MessageListener;
import javax.jms.Connection;
import javax.jms.Session;
import javax.jms.Message;
import javax.jms.Session;
import javax.jms.Topic;
import javax.jms.JMSException;
import javax.jms.MessageConsumer;
import java.util.Iterator;
/**
* This example shows a JMS message listener can use the MessageTransformer
* utility to convert JMS messages back to SOAP messages.
*/
public class ReceiveSOAPMessageWithJMS implements MessageListener {
ConnectionFactory connectionFactory = null;
Connection connection = null;
Session session = null;
Topic topic = null;
MessageConsumer msgConsumer = null;
MessageFactory messageFactory = null;
/**
* Default constructor.
*/
public ReceiveSOAPMessageWithJMS(String topicName) {
init(topicName);
}
/**
* JMS Connection/Session/Destination/MessageListener set ups.
*/
public void init(String topicName) {
try {
/**
* construct a default SOAP message factory.
*/
messageFactory = MessageFactory.newInstance();
/**
* JMS set up.
*/
connectionFactory = new com.sun.messaging.ConnectionFactory();
connection = connectionFactory.createConnection();
session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
topic = session.createTopic(topicName);
msgConsumer = session.createConsumer(topic);
msgConsumer.setMessageListener( this );
connection.start();
System.out.println ("ready to receive SOAP messages ...");
} catch (Exception jmse) {
jmse.printStackTrace();
}
}
/**
* JMS Messages are delivered to this method. The body of the message
* contains SOAP streams.
*
* 1. The message conversion utility converts JMS message to SOAP
* message type.
* 2. Get the attachment parts and print content information to the
* standard output stream.
*/
public void onMessage (Message message) {
try {
/**
* convert JMS to SOAP message.
*/
SOAPMessage soapMessage =
MessageTransformer.SOAPMessageFromJMSMessage( message, messageFactory );
/**
* Print attachment counts.
*/
System.out.println("message received! Attachment counts: " + soapMessage.countAttachments());
/**
* Get attachment parts of the SOAP message.
*/
Iterator iterator = soapMessage.getAttachments();
while ( iterator.hasNext() ) {
/**
* Get next attachment.
*/
AttachmentPart ap = (AttachmentPart) iterator.next();
/**
* Get content type.
*/
String contentType = ap.getContentType();
System.out.println("content type: " + contentType);
/**
* Get content Id.
*/
String contentId = ap.getContentId();
System.out.println("content Id: " + contentId);
/**
* Check if this is a Text attachment.
*/
if ( contentType.indexOf("text") >=0 ) {
/**
* Get and print the string content if it is a text
* attachment.
*/
String content = (String) ap.getContent();
System.out.println("*** attachment content: " + content);
}
}
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* The main method to start the example receiver.
*/
public static void main (String[] args) {
String topicName = "TestTopic";
if (args.length > 0) {
topicName = args[0];
}
try {
ReceiveSOAPMessageWithJMS rsm = new ReceiveSOAPMessageWithJMS(topicName);
} catch (Exception e) {
e.printStackTrace();
}
}
}
How to use the MessageTransformer utility to convert SOAP message to JMS message
/*
* @(#)SOAPtoJMSServlet.java 1.5 02/07/19
*
* Copyright (c) 2002 Sun Microsystems, Inc. All Rights Reserved.
*
* Sun grants you ("Licensee") a non-exclusive, royalty free, license to use,
* modify and redistribute this software in source and binary code form,
* provided that i) this copyright notice and license appear on all copies of
* the software; and ii) Licensee does not utilize the software in a manner
* which is disparaging to Sun.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY
* IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
* NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE
* LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING
* OR DISTRIBUTING THE SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR ITS
* LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT,
* INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER
* CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF
* OR INABILITY TO USE SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGES.
*
* This software is not designed or intended for use in on-line control of
* aircraft, air traffic, aircraft navigation or aircraft communications; or in
* the design, construction, operation or maintenance of any nuclear
* facility. Licensee represents and warrants that it will not use or
* redistribute the Software for such purposes.
*/
import javax.xml.messaging.JAXMServlet;
import javax.xml.messaging.ReqRespListener;
import javax.xml.soap.SOAPMessage;
import javax.xml.soap.SOAPBody;
import javax.xml.soap.SOAPEnvelope;
import javax.xml.soap.SOAPException;
import javax.xml.soap.SOAPPart;
import com.sun.messaging.xml.MessageTransformer;
import com.sun.messaging.TopicConnectionFactory;
import javax.jms.MessageListener;
import javax.jms.TopicConnection;
import javax.jms.TopicSession;
import javax.jms.Session;
import javax.jms.Message;
import javax.jms.Topic;
import javax.jms.JMSException;
import javax.jms.TopicPublisher;
import javax.servlet.ServletConfig;
import javax.servlet.ServletException;
/**
* This example shows how to use the MessageTransformer utility to convert SOAP
* message to JMS message. When SOAP messages are received, they are
* delivered to the ReqRespListener"s onMessage() method. The onMessage()
* implementation uses the utility to convert SOAP to JMS message, then
* publishes the message to the JMS Topic.
* <p>
* The onMessage() method adds <MessageStatus> element with value "published"
* to the SOAPBody and returns the SOAP message to the caller.
*/
public class SOAPtoJMSServlet extends JAXMServlet implements ReqRespListener {
TopicConnectionFactory tcf = null;
TopicConnection tc = null;
TopicSession session = null;
Topic topic = null;
TopicPublisher publisher = null;
/**
* The init method set up JMS Connection/Session/Publisher.
*/
public void init(ServletConfig config) throws ServletException {
super.init(config);
try {
tcf = new com.sun.messaging.TopicConnectionFactory();
tc = tcf.createTopicConnection();
session = tc.createTopicSession(false, Session.AUTO_ACKNOWLEDGE);
String topicName = config.getInitParameter("TopicName");
if ( topicName == null ) {
topicName = "TestTopic";
}
topic = session.createTopic(topicName);
publisher = session.createPublisher(topic);
} catch (Exception jmse) {
throw new ServletException (jmse);
}
}
/**
* Clean up JMS connection.
*/
public void destroy() {
try {
if ( tc != null ) {
tc.close();
}
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* SOAP Messages are delivered to this method and then published to the
* JMS topic destination.
*/
public SOAPMessage onMessage (SOAPMessage soapMessage) {
try {
Message message =
MessageTransformer.SOAPMessageIntoJMSMessage(soapMessage, session);
publisher.publish( message );
} catch (Exception e) {
e.printStackTrace();
}
SOAPMessage resp = generateResponseMessage(soapMessage);
return resp;
}
/**
* Add a MessageStatus element with the value of "published" to
* the soapMessage.
*/
public SOAPMessage generateResponseMessage(SOAPMessage soapMessage) {
try {
SOAPPart soapPart = soapMessage.getSOAPPart();
SOAPEnvelope envelope = soapPart.getEnvelope();
SOAPBody soapBody = envelope.getBody();
soapBody.addChildElement("MessageStatus").addTextNode("published");
soapMessage.saveChanges();
} catch (SOAPException soape) {
soape.printStackTrace();
}
return soapMessage;
}
}
How to use the MessageTransformer utility to send SOAP messages with JMS
/*
* @(#)SendSOAPMessageWithJMS.java 1.6 02/05/02
*
* Copyright (c) 2002 Sun Microsystems, Inc. All Rights Reserved.
*
* Sun grants you ("Licensee") a non-exclusive, royalty free, license to use,
* modify and redistribute this software in source and binary code form,
* provided that i) this copyright notice and license appear on all copies of
* the software; and ii) Licensee does not utilize the software in a manner
* which is disparaging to Sun.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY
* IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
* NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE
* LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING
* OR DISTRIBUTING THE SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR ITS
* LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT,
* INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER
* CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF
* OR INABILITY TO USE SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGES.
*
* This software is not designed or intended for use in on-line control of
* aircraft, air traffic, aircraft navigation or aircraft communications; or in
* the design, construction, operation or maintenance of any nuclear
* facility. Licensee represents and warrants that it will not use or
* redistribute the Software for such purposes.
*/
import javax.xml.soap.SOAPMessage;
import javax.xml.soap.SOAPPart;
import javax.xml.soap.SOAPEnvelope;
import javax.xml.soap.SOAPBody;
import javax.xml.soap.SOAPElement;
import javax.xml.soap.MessageFactory;
import javax.xml.soap.AttachmentPart;
import javax.xml.soap.Name;
import java.net.URL;
import javax.activation.DataHandler;
import com.sun.messaging.xml.MessageTransformer;
import javax.jms.ConnectionFactory;
import javax.jms.Connection;
import javax.jms.JMSException;
import javax.jms.Session;
import javax.jms.Message;
import javax.jms.Session;
import javax.jms.Topic;
import javax.jms.MessageProducer;
/**
* This example shows how to use the MessageTransformer utility to send SOAP
* messages with JMS.
* <p>
* SOAP messages are constructed with javax.xml.soap API. The messages
* are converted with MessageTransformer utility to convert SOAP to JMS
* message types. The JMS messages are then published to the JMS topics.
*/
public class SendSOAPMessageWithJMS {
ConnectionFactory connectionFactory = null;
Connection connection = null;
Session session = null;
Topic topic = null;
MessageProducer msgProducer = null;
/**
* default constructor.
*/
public SendSOAPMessageWithJMS(String topicName) {
init(topicName);
}
/**
* Initialize JMS Connection/Session/Topic and Producer.
*/
public void init(String topicName) {
try {
connectionFactory = new com.sun.messaging.ConnectionFactory();
connection = connectionFactory.createConnection();
session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
topic = session.createTopic(topicName);
msgProducer = session.createProducer(topic);
} catch (JMSException jmse) {
jmse.printStackTrace();
}
}
/**
* Send SOAP message with JMS API.
*/
public void send () throws Exception {
/**
* Construct a default SOAP message factory.
*/
MessageFactory mf = MessageFactory.newInstance();
/**
* Create a SOAP message object.
*/
SOAPMessage soapMessage = mf.createMessage();
/**
* Get SOAP part.
*/
SOAPPart soapPart = soapMessage.getSOAPPart();
/**
* Get SOAP envelope.
*/
SOAPEnvelope soapEnvelope = soapPart.getEnvelope();
/**
* Get SOAP body.
*/
SOAPBody soapBody = soapEnvelope.getBody();
/**
* Create a name object. with name space http://www.sun.ru/imq.
*/
Name name = soapEnvelope.createName("HelloWorld", "hw", "http://www.sun.ru/imq");
/**
* Add child element with the above name.
*/
SOAPElement element = soapBody.addChildElement(name);
/**
* Add another child element.
*/
element.addTextNode( "Welcome to SunOne Web Services." );
/**
* Create an atachment with activation API.
*/
URL url = new URL ("http://java.sun.ru/webservices/");
DataHandler dh = new DataHandler (url);
AttachmentPart ap = soapMessage.createAttachmentPart(dh);
/**
* set content type/ID.
*/
ap.setContentType("text/html");
ap.setContentId("cid-001");
/**
* add the attachment to the SOAP message.
*/
soapMessage.addAttachmentPart(ap);
soapMessage.saveChanges();
/**
* Convert SOAP to JMS message.
*/
Message message = MessageTransformer.SOAPMessageIntoJMSMessage( soapMessage, session );
/**
* publish JMS message.
*/
msgProducer.send( message );
}
/**
* close JMS connection.
*/
public void close() throws JMSException {
connection.close();
}
/**
* The main program to send SOAP messages with JMS.
*/
public static void main (String[] args) {
String topicName = "TestTopic";
if (args.length > 0) {
topicName = args[0];
}
try {
SendSOAPMessageWithJMS ssm = new SendSOAPMessageWithJMS(topicName);
ssm.send();
ssm.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
This example demonstrates a hello world example for using JAXM API
/*
* @(#)SendSOAPMessage.java 1.4 02/05/02
*
* Copyright (c) 2002 Sun Microsystems, Inc. All Rights Reserved.
*
* Sun grants you ("Licensee") a non-exclusive, royalty free, license to use,
* modify and redistribute this software in source and binary code form,
* provided that i) this copyright notice and license appear on all copies of
* the software; and ii) Licensee does not utilize the software in a manner
* which is disparaging to Sun.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY
* IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
* NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE
* LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING
* OR DISTRIBUTING THE SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR ITS
* LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT,
* INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER
* CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF
* OR INABILITY TO USE SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGES.
*
* This software is not designed or intended for use in on-line control of
* aircraft, air traffic, aircraft navigation or aircraft communications; or in
* the design, construction, operation or maintenance of any nuclear
* facility. Licensee represents and warrants that it will not use or
* redistribute the Software for such purposes.
*/
import javax.xml.messaging.URLEndpoint;
import javax.xml.soap.MessageFactory;
import javax.xml.soap.SOAPMessage;
import javax.xml.soap.SOAPEnvelope;
import javax.xml.soap.SOAPBody;
import javax.xml.soap.SOAPPart;
import javax.xml.soap.SOAPElement;
import javax.xml.soap.SOAPException;
import javax.xml.soap.SOAPConnectionFactory;
import javax.xml.soap.SOAPConnection;
/**
* This example demonstrates a hello world example for using JAXM API.
*/
public class SendSOAPMessage {
/**
* send a simple soap message with JAXM API.
*/
public void sendMessage (String url) {
try {
/**
* Construct a default SOAP message factory.
*/
MessageFactory mf = MessageFactory.newInstance();
/**
* Create a SOAP message object.
*/
SOAPMessage soapMessage = mf.createMessage();
/**
* Get SOAP part.
*/
SOAPPart soapPart = soapMessage.getSOAPPart();
/**
* Get SOAP envelope.
*/
SOAPEnvelope soapEnvelope = soapPart.getEnvelope();
/**
* Get SOAP body.
*/
SOAPBody soapBody = soapEnvelope.getBody();
/**
* Add child element with the specified name.
*/
SOAPElement element = soapBody.addChildElement("HelloWorld");
/**
* Add text message
*/
element.addTextNode("Welcome to SunOne Web Services!");
soapMessage.saveChanges();
/**
* Construct a default SOAP connection factory.
*/
SOAPConnectionFactory connectionFactory = SOAPConnectionFactory.newInstance();
/**
* Get SOAP connection.
*/
SOAPConnection soapConnection = connectionFactory.createConnection();
/**
* Construct endpoint object.
*/
URLEndpoint endpoint = new URLEndpoint (url);
/**
* Send SOAP message.
*/
SOAPMessage resp = soapConnection.call(soapMessage, endpoint);
/**
* Print response to the std output.
*/
resp.writeTo( System.out );
/**
* close the connection
*/
soapConnection.close();
} catch (java.io.IOException ioe) {
ioe.printStackTrace();
} catch (SOAPException soape) {
soape.printStackTrace();
}
}
public static void main (String args[]) {
String url = "http://localhost:8080/imqSOAPexamples/SOAPEchoServlet";
if (args.length > 0) {
url = args[0];
} else {
System.out.println("Usage: " +
"\tjava SendSOAPMessage <SOAP servlet url>\n" +
"e.g.\n\tjava SendSOAPMessage http://localhost:8080/imqSOAPexamples/SOAPEchoServlet"
);
System.exit(1);
}
SendSOAPMessage ssm = new SendSOAPMessage();
ssm.sendMessage(url);
}
}
This example echos the SOAP message received back to the sender
/*
* @(#)SOAPEchoServlet.java 1.4 02/05/02
*
* Copyright (c) 2002 Sun Microsystems, Inc. All Rights Reserved.
*
* Sun grants you ("Licensee") a non-exclusive, royalty free, license to use,
* modify and redistribute this software in source and binary code form,
* provided that i) this copyright notice and license appear on all copies of
* the software; and ii) Licensee does not utilize the software in a manner
* which is disparaging to Sun.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY
* IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
* NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE
* LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING
* OR DISTRIBUTING THE SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR ITS
* LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT,
* INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER
* CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF
* OR INABILITY TO USE SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGES.
*
* This software is not designed or intended for use in on-line control of
* aircraft, air traffic, aircraft navigation or aircraft communications; or in
* the design, construction, operation or maintenance of any nuclear
* facility. Licensee represents and warrants that it will not use or
* redistribute the Software for such purposes.
*/
import javax.xml.messaging.JAXMServlet;
import javax.xml.messaging.ReqRespListener;
import javax.xml.soap.SOAPMessage;
/**
* This example echos the SOAP message received back to the sender.
*/
public class SOAPEchoServlet extends JAXMServlet implements ReqRespListener {
/**
* SOAP Message received is echoed back to the sender.
*/
public SOAPMessage onMessage (SOAPMessage soapMessage) {
return soapMessage;
}
}
