/*
* Copyright 2005-2014 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.springframework.ws.transport.jms;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.URI;
import java.net.URISyntaxException;
import java.util.Iterator;
import javax.jms.BytesMessage;
import javax.jms.Connection;
import javax.jms.ConnectionFactory;
import javax.jms.Destination;
import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.MessageConsumer;
import javax.jms.MessageProducer;
import javax.jms.Session;
import javax.jms.TemporaryQueue;
import javax.jms.TextMessage;
import org.springframework.jms.connection.ConnectionFactoryUtils;
import org.springframework.jms.core.MessagePostProcessor;
import org.springframework.jms.support.JmsUtils;
import org.springframework.util.Assert;
import org.springframework.ws.WebServiceMessage;
import org.springframework.ws.transport.AbstractSenderConnection;
import org.springframework.ws.transport.WebServiceConnection;
import org.springframework.ws.transport.jms.support.JmsTransportUtils;
/**
* Implementation of {@link WebServiceConnection} that is used for client-side JMS access. Exposes a {@link
* BytesMessage} request and response message.
*
* @author Arjen Poutsma
* @author Greg Turnquist
* @since 1.5.0
*/
public class JmsSenderConnection extends AbstractSenderConnection {
private final ConnectionFactory connectionFactory;
private final Connection connection;
private final Session session;
private final Destination requestDestination;
private Message requestMessage;
private Destination responseDestination;
private Message responseMessage;
private long receiveTimeout;
private int deliveryMode;
private long timeToLive;
private int priority;
private String textMessageEncoding;
private MessagePostProcessor postProcessor;
private boolean sessionTransacted = false;
private boolean temporaryResponseQueueCreated = false;
/** Constructs a new JMS connection with the given parameters. */
protected JmsSenderConnection(ConnectionFactory connectionFactory,
Connection connection,
Session session,
Destination requestDestination,
Message requestMessage) throws JMSException {
Assert.notNull(connectionFactory, "'connectionFactory' must not be null");
Assert.notNull(connection, "'connection' must not be null");
Assert.notNull(session, "'session' must not be null");
Assert.notNull(requestDestination, "'requestDestination' must not be null");
Assert.notNull(requestMessage, "'requestMessage' must not be null");
this.connectionFactory = connectionFactory;
this.connection = connection;
this.session = session;
this.requestDestination = requestDestination;
this.requestMessage = requestMessage;
}
/** Returns the request message for this connection. Returns either a {@link BytesMessage} or a {@link TextMessage}. */
public Message getRequestMessage() {
return requestMessage;
}
/**
* Returns the response message, if any, for this connection. Returns either a {@link BytesMessage} or a {@link
* TextMessage}.
*/
public Message getResponseMessage() {
return responseMessage;
}
/*
* Package-friendly setters
*/
void setResponseDestination(Destination responseDestination) {
this.responseDestination = responseDestination;
}
void setTimeToLive(long timeToLive) {
this.timeToLive = timeToLive;
}
void setDeliveryMode(int deliveryMode) {
this.deliveryMode = deliveryMode;
}
void setPriority(int priority) {
this.priority = priority;
}
void setReceiveTimeout(long receiveTimeout) {
this.receiveTimeout = receiveTimeout;
}
void setTextMessageEncoding(String textMessageEncoding) {
this.textMessageEncoding = textMessageEncoding;
}
void setPostProcessor(MessagePostProcessor postProcessor) {
this.postProcessor = postProcessor;
}
void setSessionTransacted(boolean sessionTransacted) {
this.sessionTransacted = sessionTransacted;
}
/*
* URI
*/
@Override
public URI getUri() throws URISyntaxException {
try {
return JmsTransportUtils.toUri(requestDestination);
}
catch (JMSException ex) {
throw new URISyntaxException("", ex.getMessage());
}
}
/*
* Errors
*/
@Override
public boolean hasError() throws IOException {
return false;
}
@Override
public String getErrorMessage() throws IOException {
return null;
}
/*
* Sending
*/
@Override
public void addRequestHeader(String name, String value) throws IOException {
try {
JmsTransportUtils.addHeader(requestMessage, name, value);
}
catch (JMSException ex) {
throw new JmsTransportException("Could not set property", ex);
}
}
@Override
protected OutputStream getRequestOutputStream() throws IOException {
if (requestMessage instanceof BytesMessage) {
return new BytesMessageOutputStream((BytesMessage) requestMessage);
}
else if (requestMessage instanceof TextMessage) {
return new TextMessageOutputStream((TextMessage) requestMessage, textMessageEncoding);
}
else {
throw new IllegalStateException("Unknown request message type [" + requestMessage + "]");
}
}
@Override
protected void onSendAfterWrite(WebServiceMessage message) throws IOException {
MessageProducer messageProducer = null;
try {
messageProducer = session.createProducer(requestDestination);
messageProducer.setDeliveryMode(deliveryMode);
messageProducer.setTimeToLive(timeToLive);
messageProducer.setPriority(priority);
if (responseDestination == null) {
responseDestination = session.createTemporaryQueue();
temporaryResponseQueueCreated = true;
}
requestMessage.setJMSReplyTo(responseDestination);
if (postProcessor != null) {
requestMessage = postProcessor.postProcessMessage(requestMessage);
}
connection.start();
messageProducer.send(requestMessage);
if (session.getTransacted() && isSessionLocallyTransacted(session)) {
JmsUtils.commitIfNecessary(session);
}
}
catch (JMSException ex) {
throw new JmsTransportException(ex);
}
finally {
JmsUtils.closeMessageProducer(messageProducer);
}
}
/** @see org.springframework.jms.core.JmsTemplate#isSessionLocallyTransacted(Session) */
private boolean isSessionLocallyTransacted(Session session) {
return sessionTransacted && !ConnectionFactoryUtils.isSessionTransactional(session, connectionFactory);
}
/*
* Receiving
*/
@Override
protected void onReceiveBeforeRead() throws IOException {
MessageConsumer messageConsumer = null;
try {
if (temporaryResponseQueueCreated) {
messageConsumer = session.createConsumer(responseDestination);
}
else {
String messageId = requestMessage.getJMSMessageID().replaceAll("'", "''");
String messageSelector = "JMSCorrelationID = '" + messageId + "'";
messageConsumer = session.createConsumer(responseDestination, messageSelector);
}
Message message = receiveTimeout >= 0 ? messageConsumer.receive(receiveTimeout) : messageConsumer.receive();
if (message instanceof BytesMessage || message instanceof TextMessage) {
responseMessage = message;
}
else if (message != null) {
throw new IllegalArgumentException(
"Wrong message type: [" + message.getClass() + "]. " +
"Only BytesMessages or TextMessages can be handled.");
}
}
catch (JMSException ex) {
throw new JmsTransportException(ex);
}
finally {
JmsUtils.closeMessageConsumer(messageConsumer);
if (temporaryResponseQueueCreated) {
try {
((TemporaryQueue) responseDestination).delete();
}
catch (JMSException ex) {
// ignore
}
}
}
}
@Override
protected boolean hasResponse() throws IOException {
return responseMessage != null;
}
@Override
public Iterator<String> getResponseHeaderNames() throws IOException {
try {
return JmsTransportUtils.getHeaderNames(responseMessage);
}
catch (JMSException ex) {
throw new JmsTransportException("Could not get property names", ex);
}
}
@Override
public Iterator<String> getResponseHeaders(String name) throws IOException {
try {
return JmsTransportUtils.getHeaders(responseMessage, name);
}
catch (JMSException ex) {
throw new JmsTransportException("Could not get property value", ex);
}
}
@Override
protected InputStream getResponseInputStream() throws IOException {
if (responseMessage instanceof BytesMessage) {
return new BytesMessageInputStream((BytesMessage) responseMessage);
}
else if (responseMessage instanceof TextMessage) {
return new TextMessageInputStream((TextMessage) responseMessage, textMessageEncoding);
}
else {
throw new IllegalStateException("Unknown response message type [" + responseMessage + "]");
}
}
@Override
protected void onClose() throws IOException {
JmsUtils.closeSession(session);
ConnectionFactoryUtils.releaseConnection(connection, connectionFactory, true);
}
}