IJMSServicePublisher.java

/**
 *  Copyright (c) 2012 GFT Appverse, S.L., Sociedad Unipersonal.
 *
 *  This Source Code Form is subject to the terms of the Appverse Public License
 *  Version 2.0 (“APL v2.0”). If a copy of the APL was not distributed with this
 *  file, You can obtain one at http://www.appverse.mobi/licenses/apl_v2.0.pdf. [^]
 *
 *  Redistribution and use in source and binary forms, with or without modification,
 *  are permitted provided that the conditions of the AppVerse Public License v2.0
 *  are met.
 *
 *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
 *  ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 *  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 *  DISCLAIMED. EXCEPT IN CASE OF WILLFUL MISCONDUCT OR GROSS NEGLIGENCE, IN NO EVENT
 *  SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 *  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 *  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 *  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 *  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT(INCLUDING NEGLIGENCE OR OTHERWISE)
 *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 *  POSSIBILITY OF SUCH DAMAGE.
 */
package org.appverse.web.framework.backend.messaging.services.integration;

import javax.jms.JMSException;
import javax.jms.Message;

import org.appverse.web.framework.backend.api.model.integration.AbstractIntegrationBean;
import org.springframework.jms.core.JmsTemplate;

/**
 * Interface to define Message publishing API
 *
 * @param <T>
 */
public interface IJMSServicePublisher<T extends AbstractIntegrationBean> extends IJMSService<T> {

	/**
	 * Simple message sending through JmsTemplate.
	 * It is only synchronous in terms of waiting for broker response (acknowledge), but obviously it doesn't wait for message consumption
	 * 
	 * @param bean
	 * @throws Exception
	 */
	void send(T bean) throws Exception;

	/**
	 * Same than {@link #send(T) send} method, but it provides to send another DTO to populate JMS message properties
	 * 
	 * @param dto
	 * @param header
	 * @throws Exception
	 */
	void send(final T dto, final AbstractIntegrationBean header) throws Exception;

	/**
	 * This method has to be overwritten by user implementations to provide publishing JmsTemplate
	 * 
	 * @return
	 */
	JmsTemplate getTemplatePublisher();

	/**
	 * This method has to be overwritten by user implementations to populate JMS message properties 
	 * 
	 * @param message
	 * @param header
	 * @throws JMSException
	 */
	void fillHeader(final Message message, final AbstractIntegrationBean header)
			throws JMSException;

}