001/**
002 * Licensed to the Apache Software Foundation (ASF) under one or more
003 * contributor license agreements.  See the NOTICE file distributed with
004 * this work for additional information regarding copyright ownership.
005 * The ASF licenses this file to You under the Apache License, Version 2.0
006 * (the "License"); you may not use this file except in compliance with
007 * the License.  You may obtain a copy of the License at
008 *
009 *      http://www.apache.org/licenses/LICENSE-2.0
010 *
011 * Unless required by applicable law or agreed to in writing, software
012 * distributed under the License is distributed on an "AS IS" BASIS,
013 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014 * See the License for the specific language governing permissions and
015 * limitations under the License.
016 */
017package org.apache.activemq;
018
019import javax.jms.Destination;
020import javax.jms.JMSException;
021import javax.jms.MessageConsumer;
022import javax.jms.MessageProducer;
023import javax.jms.QueueReceiver;
024import javax.jms.QueueSender;
025import javax.jms.TopicPublisher;
026import javax.jms.TopicSubscriber;
027
028/**
029 * Represents a hook to allow the support of custom destinations
030 * such as to support <a href="http://activemq.apache.org/camel/">Apache Camel</a>
031 * to create and manage endpoints
032 *
033 * 
034 */
035public interface CustomDestination extends Destination {
036
037    // Consumers
038    //-----------------------------------------------------------------------
039    MessageConsumer createConsumer(ActiveMQSession session, String messageSelector);
040    MessageConsumer createConsumer(ActiveMQSession session, String messageSelector, boolean noLocal);
041
042    TopicSubscriber createSubscriber(ActiveMQSession session, String messageSelector, boolean noLocal);
043    TopicSubscriber createDurableSubscriber(ActiveMQSession session, String name, String messageSelector, boolean noLocal);
044
045    QueueReceiver createReceiver(ActiveMQSession session, String messageSelector);
046
047    // Producers
048    //-----------------------------------------------------------------------
049    MessageProducer createProducer(ActiveMQSession session) throws JMSException;
050
051    TopicPublisher createPublisher(ActiveMQSession session) throws JMSException;
052
053    QueueSender createSender(ActiveMQSession session) throws JMSException;
054}