MQProducer.java example

Explorer

RocketMQ-master
- rocketmq-broker
  - src
    - main
      - java
        com
        alibaba
        rocketmq
        broker
        BrokerController.java
        BrokerStartup.java
        client
        ClientChannelInfo.java
        ClientHousekeepingService.java
        ConsumerGroupInfo.java
        ConsumerManager.java
        ProducerManager.java
        longpolling
        ManyPullRequest.java
        PullRequest.java
        PullRequestHoldService.java
        offset
        ConsumerOffsetManager.java
        pagecache
        ManyMessageTransfer.java
        OneMessageTransfer.java
        QueryMessageTransfer.java
        processor
        AdminBrokerProcessor.java
        ClientManageProcessor.java
        EndTransactionProcessor.java
        ForwardRequestProcessor.java
        PullMessageProcessor.java
        QueryMessageProcessor.java
        SendMessageProcessor.java
        topic
        TopicConfigManager.java
    - test
      - java
        com
        alibaba
        rocketmq
        broker
        api
        SendMessageTest.java
        offset
        ConsumerOffsetManagerTest.java
        topic
        TopicConfigManagerTest.java
- rocketmq-client
  - src
    - main
      - java
        com
        alibaba
        rocketmq
        client
        MQAdmin.java
        MQClientConfig.java
        QueryResult.java
        consumer
        AllocateMessageQueueStrategy.java
        ConsumeFromWhereOffset.java
        ConsumeFromWhichNode.java
        DefaultMQPullConsumer.java
        DefaultMQPushConsumer.java
        MQConsumer.java
        MQPullConsumer.java
        MQPushConsumer.java
        MessageQueueListener.java
        PullCallback.java
        PullResult.java
        PullStatus.java
        listener
        ConsumeConcurrentlyContext.java
        ConsumeConcurrentlyStatus.java
        ConsumeOrderlyContext.java
        ConsumeOrderlyStatus.java
        MessageListener.java
        MessageListenerConcurrently.java
        MessageListenerOrderly.java
        loadbalance
        AllocateMessageQueueAveragely.java
        AllocateMessageQueueByConfig.java
        AllocateMessageQueueByMachineRoom.java
        exception
        MQBrokerException.java
        MQClientException.java
        impl
        ClientRemotingProcessor.java
        CommunicationMode.java
        FindBrokerResult.java
        MQAdminImpl.java
        MQClientAPIImpl.java
        MQClientManager.java
        consumer
        DefaultMQPullConsumerImpl.java
        DefaultMQPushConsumerImpl.java
        MQConsumerInner.java
        PullAPIWrapper.java
        PullMessageService.java
        PullRequest.java
        PullResultExt.java
        factory
        MQClientFactory.java
        producer
        DefaultMQProducerImpl.java
        SendResultExt.java
        TopicPublishInfo.java
        producer
        DefaultMQProducer.java
        LocalTransactionExecuter.java
        LocalTransactionState.java
        MQProducer.java
        MessageQueueSelector.java
        SendCallback.java
        SendResult.java
        SendStatus.java
        TransactionCheckListener.java
        TransactionMQProducer.java
        selector
        SelectMessageQueueByMachineRoom.java
    - test
      - java
        com
        alibaba
        rocketmq
        client
        consumer
        loadbalance
        AllocateMessageQueueAveragelyTeset.java
- rocketmq-common
  - src
    - main
      - java
        com
        alibaba
        rocketmq
        common
        BrokerConfig.java
        DataVersion.java
        MQVersion.java
        Message.java
        MessageDecoder.java
        MessageExt.java
        MessageId.java
        MessageQueue.java
        MixAll.java
        Pair.java
        ServiceState.java
        ServiceThread.java
        SubGroupConfig.java
        SystemClock.java
        TopicConfig.java
        TopicFilterType.java
        UtilALl.java
        filter
        Op.java
        Operand.java
        Operator.java
        PolishExpr.java
        Type.java
        namesrv
        NamesrvConfig.java
        TopAddressing.java
        TopicRuntimeData.java
        protocol
        MQProtos.java
        MQProtosHelper.java
        header
        CheckTransactionStateRequestHeader.java
        CheckTransactionStateResponseHeader.java
        CreateTopicRequestHeader.java
        DeleteTopicRequestHeader.java
        EndTransactionRequestHeader.java
        EndTransactionResponseHeader.java
        GetAllTopicConfigResponseHeader.java
        GetBrokerConfigResponseHeader.java
        GetEarliestMsgStoretimeRequestHeader.java
        GetEarliestMsgStoretimeResponseHeader.java
        GetMaxOffsetRequestHeader.java
        GetMaxOffsetResponseHeader.java
        GetMinOffsetRequestHeader.java
        GetMinOffsetResponseHeader.java
        PullMessageRequestHeader.java
        PullMessageResponseHeader.java
        QueryConsumerOffsetRequestHeader.java
        QueryConsumerOffsetResponseHeader.java
        QueryMessageRequestHeader.java
        QueryMessageResponseHeader.java
        SearchOffsetRequestHeader.java
        SearchOffsetResponseHeader.java
        SendMessageRequestHeader.java
        SendMessageResponseHeader.java
        UnregisterClientRequestHeader.java
        UnregisterClientResponseHeader.java
        UpdateConsumerOffsetRequestHeader.java
        UpdateConsumerOffsetResponseHeader.java
        ViewMessageRequestHeader.java
        ViewMessageResponseHeader.java
        namesrv
        GetRouteInfoRequestHeader.java
        GetRouteInfoResponseHeader.java
        GetTopicResponseHeader.java
        RegisterBrokerRequestHeader.java
        RegisterOrderTopicRequestHeader.java
        UnRegisterBrokerRequestHeader.java
        heartbeat
        ConsumeType.java
        ConsumerData.java
        HeartbeatData.java
        MessageModel.java
        ProducerData.java
        SubscriptionData.java
        route
        BrokerData.java
        ObjectConverter.java
        QueueData.java
        TopicRouteData.java
        sysflag
        MessageSysFlag.java
        PullSysFlag.java
    - test
      - java
        com
        alibaba
        rocketmq
        common
        MixAllTest.java
        TopicRuntimeDataTest.java
        UtilAllTest.java
        filter
        PolishExprTest.java
        protocol
        MQProtosHelperTest.java
        heartbeat
        HeartbeatTest.java
- rocketmq-console
  - src
    - main
      - java
        com
        alibaba
        rocketmq
        console
        ConsoleConfig.java
        ConsoleController.java
        ConsoleStartup.java
        http
        ConsoleJettyHander.java
- rocketmq-example
  - src
    - main
      - java
        com
        alibaba
        rocketmq
        example
        benchmark
        Consumer.java
        Producer.java
        simple
        Producer.java
        PullConsumer.java
        PushConsumer.java
        transaction
        TranExecuterImpl.java
        TransactionCheckListenerImpl.java
        TransactionProducer.java
- rocketmq-namesrv
  - src
    - main
      - java
        com
        alibaba
        rocketmq
        namesrv
        NamesrvController.java
        NamesrvStartup.java
        common
        MergeResult.java
        MergeResultHolder.java
        Result.java
        daemon
        NamesrvClient.java
        NamesrvSync.java
        PollingAddress.java
        processor
        AllRequestProcessor.java
        ChangeSpreadProcessor.java
        sync
        Exec.java
        FutureGroup.java
        Task.java
        TaskGroup.java
        TaskGroupExecutor.java
        TaskType.java
        topic
        DefaultNamesrvConfigManager.java
        DefaultTopicRuntimeDataManager.java
        NamesrvConfigManager.java
        TopicRuntimeDataManager.java
    - test
      - java
        com
        alibaba
        rocketmq
        namesrv
        DataUtils.java
        daemon
        NamesrvClientTest.java
        NamesrvSyncTest.java
        PollingAddressTest.java
        topic
        DefaultTopicRuntimeDataManagerTest.java
- rocketmq-remoting
  - src
    - main
      - java
        com
        alibaba
        rocketmq
        remoting
        ChannelEventListener.java
        CommandCustomHeader.java
        InvokeCallback.java
        RemotingClient.java
        RemotingServer.java
        annotation
        CFNotNull.java
        CFNullable.java
        common
        Pair.java
        RemotingHelper.java
        RemotingUtil.java
        SemaphoreReleaseOnlyOnce.java
        ServiceThread.java
        exception
        RemotingCommandException.java
        RemotingConnectException.java
        RemotingException.java
        RemotingSendRequestException.java
        RemotingTimeoutException.java
        RemotingTooMuchRequestException.java
        netty
        NettyClientConfig.java
        NettyDecoder.java
        NettyEncoder.java
        NettyEvent.java
        NettyEventType.java
        NettyRemotingAbstract.java
        NettyRemotingClient.java
        NettyRemotingServer.java
        NettyRequestProcessor.java
        NettyServerConfig.java
        ResponseFuture.java
        protocol
        RemotingCommand.java
        RemotingCommandType.java
        RemotingProtos.java
        RemotingProtosHelper.java
    - test
      - java
        com
        alibaba
        rocketmq
        protocol
        RemotingProtosHelperTest.java
        remoting
        ExceptionTest.java
        MixTest.java
        NettyRPCTest.java
        SyncInvokeTest.java
        subclass
        TestSubClassAuto.java
- rocketmq-research
  - src
    - main
      - java
        com
        alibaba
        rocketmq
        research
        logback
        LogbackTest.java
        mix
        Test1.java
        rpc
        Connection.java
        DefaultRPCClient.java
        DefaultRPCServer.java
        LinkedByteBufferList.java
        RPCClient.java
        RPCProcessor.java
        RPCServer.java
        benchmark
        Client.java
        MTClient.java
        Server.java
        store
        MessageStoreTestObject.java
        storeha
        BrokerMaster.java
        BrokerSlave.java
- rocketmq-store
  - src
    - main
      - java
        com
        alibaba
        rocketmq
        store
        AllocateMapedFileService.java
        AppendMessageCallback.java
        AppendMessageResult.java
        AppendMessageStatus.java
        CommitLog.java
        ConsumeQueue.java
        DefaultMessageFilter.java
        DefaultMessageStore.java
        DispatchRequest.java
        GetMessageResult.java
        GetMessageStatus.java
        MapedFile.java
        MapedFileQueue.java
        MessageExtBrokerInner.java
        MessageFilter.java
        MessageStore.java
        PutMessageResult.java
        PutMessageStatus.java
        QueryMessageResult.java
        ReferenceResource.java
        RunningFlags.java
        SelectMapedBufferResult.java
        StoreCheckpoint.java
        StoreStatsService.java
        config
        BrokerRole.java
        FlushDiskType.java
        MessageStoreConfig.java
        ha
        HAConnection.java
        HAService.java
        WaitNotifyObject.java
        index
        IndexFile.java
        IndexHeader.java
        IndexService.java
        QueryOffsetResult.java
        schedule
        ScheduleMessageService.java
        transaction
        TransactionCheckExecuter.java
        TransactionStateService.java
    - test
      - java
        com
        alibaba
        rocketmq
        store
        DefaultMessageStoreTest.java
        MapedFileQueueTest.java
        MapedFileTest.java
        RecoverTest.java
        StoreCheckpointTest.java
        index
        IndexFileTest.java
        schedule
        ScheduleMessageTest.java

/**
 * $Id: MQProducer.java 1831 2013-05-16 01:39:51Z shijia.wxr $
 */
package com.alibaba.rocketmq.client.producer;

import java.util.List;

import com.alibaba.rocketmq.client.MQAdmin;
import com.alibaba.rocketmq.client.exception.MQBrokerException;
import com.alibaba.rocketmq.client.exception.MQClientException;
import com.alibaba.rocketmq.common.Message;
import com.alibaba.rocketmq.common.MessageQueue;
import com.alibaba.rocketmq.remoting.exception.RemotingException;


/**
 * ��Ϣ������
 * 
 * @author vintage.wang@gmail.com shijia.wxr@taobao.com
 */
public interface MQProducer extends MQAdmin {
    /**
     * ��������
     * 
     * @throws MQClientException
     */
    public void start() throws MQClientException;


    /**
     * �رշ���
     */
    public void shutdown();


    /**
     * ����topic��ȡ��Ӧ��MessageQueue�������˳����Ϣ������˳����Ϣ���÷���
     * 
     * @param topic
     *            ��ϢTopic
     * @return ���ض��м���
     * @throws MQClientException
     */
    public List<MessageQueue> fetchPublishMessageQueues(final String topic) throws MQClientException;


    /**
     * ������Ϣ��ͬ������
     * 
     * @param msg
     *            ��Ϣ
     * @return ���ͽ��
     * @throws InterruptedException
     * @throws MQBrokerException
     * @throws RemotingException
     * @throws MQClientException
     */
    public SendResult send(final Message msg) throws MQClientException, RemotingException, MQBrokerException,
            InterruptedException;


    /**
     * ������Ϣ���첽����
     * 
     * @param msg
     *            ��Ϣ
     * @param sendCallback
     *            ���ͽ��ͨ���˽ӿڻص�
     * @throws MQClientException
     * @throws RemotingException
     * @throws InterruptedException
     */
    public void send(final Message msg, final SendCallback sendCallback) throws MQClientException,
            RemotingException, InterruptedException;


    /**
     * ������Ϣ��Oneway��ʽ����������Ӧ���޷���֤��Ϣ�Ƿ�ɹ����������
     * 
     * @param msg
     *            ��Ϣ
     * @throws MQClientException
     * @throws RemotingException
     * @throws InterruptedException
     */
    public void sendOneway(final Message msg) throws MQClientException, RemotingException, InterruptedException;


    /**
     * ��ָ�����з�����Ϣ��ͬ������
     * 
     * @param msg
     *            ��Ϣ
     * @param mq
     *            ����
     * @return ���ͽ��
     * @throws InterruptedException
     * @throws MQBrokerException
     * @throws RemotingException
     * @throws MQClientException
     */
    public SendResult send(final Message msg, final MessageQueue mq) throws MQClientException, RemotingException,
            MQBrokerException, InterruptedException;


    /**
     * ��ָ�����з�����Ϣ���첽����
     * 
     * @param msg
     *            ��Ϣ
     * @param mq
     *            ����
     * @param sendCallback
     *            ���ͽ��ͨ���˽ӿڻص�
     * @throws InterruptedException
     * @throws RemotingException
     * @throws MQClientException
     */
    public void send(final Message msg, final MessageQueue mq, final SendCallback sendCallback)
            throws MQClientException, RemotingException, InterruptedException;


    /**
     * ��ָ�����з�����Ϣ��Oneway��ʽ����������Ӧ���޷���֤��Ϣ�Ƿ�ɹ����������
     * 
     * @param msg
     *            ��Ϣ
     * @param mq
     *            ����
     * @throws MQClientException
     * @throws RemotingException
     * @throws InterruptedException
     */
    public void sendOneway(final Message msg, final MessageQueue mq) throws MQClientException, RemotingException,
            InterruptedException;


    /**
     * ������Ϣ�������Զ���ѡ����У����е��������ܻ�����Broker����ͣ�仯<br>
     * ���Ҫ��֤��Ϣ�ϸ�����������ά��Ա����Topicʱ����Ҫ�ر�˵��<br>
     * ͬ������
     * 
     * @param msg
     *            ��Ϣ
     * @param selector
     *            ����ѡ����������ʱ��ص�
     * @param arg
     *            �ص�����ѡ����ʱ���˲����ᴫ�����ѡ�񷽷�
     * @return ���ͽ��
     * @throws InterruptedException
     * @throws MQBrokerException
     * @throws RemotingException
     * @throws MQClientException
     */
    public SendResult send(final Message msg, final MessageQueueSelector selector, final Object arg)
            throws MQClientException, RemotingException, MQBrokerException, InterruptedException;


    /**
     * ������Ϣ�������Զ���ѡ����У����е��������ܻ�����Broker����ͣ�仯<br>
     * ���Ҫ��֤��Ϣ�ϸ�����������ά��Ա����Topicʱ����Ҫ�ر�˵��<br>
     * �첽����
     * 
     * @param msg
     *            ��Ϣ
     * @param selector
     *            ����ѡ����������ʱ��ص�
     * @param arg
     *            �ص�����ѡ����ʱ���˲����ᴫ�����ѡ�񷽷�
     * @param sendCallback
     *            ���ͽ��ͨ���˽ӿڻص�
     * @throws MQClientException
     * @throws RemotingException
     * @throws InterruptedException
     */
    public void send(final Message msg, final MessageQueueSelector selector, final Object arg,
            final SendCallback sendCallback) throws MQClientException, RemotingException, InterruptedException;


    /**
     * ������Ϣ�������Զ���ѡ����У����е��������ܻ�����Broker����ͣ�仯<br>
     * ���Ҫ��֤��Ϣ�ϸ�����������ά��Ա����Topicʱ����Ҫ�ر�˵��<br>
     * Oneway��ʽ����������Ӧ���޷���֤��Ϣ�Ƿ�ɹ����������
     * 
     * @param msg
     *            ��Ϣ
     * @param selector
     *            ����ѡ����������ʱ��ص�
     * @param arg
     *            �ص�����ѡ����ʱ���˲����ᴫ�����ѡ�񷽷�
     * @throws MQClientException
     * @throws RemotingException
     * @throws InterruptedException
     */
    public void sendOneway(final Message msg, final MessageQueueSelector selector, final Object arg)
            throws MQClientException, RemotingException, InterruptedException;


    public SendResult sendMessageInTransaction(final Message msg, final LocalTransactionExecuter tranExecuter)
            throws MQClientException;
}