001    /*
002     * Copyright 2009 Red Hat, Inc.
003     * Red Hat licenses this file to you under the Apache License, version
004     * 2.0 (the "License"); you may not use this file except in compliance
005     * with the License.  You may obtain a copy of the License at
006     *    http://www.apache.org/licenses/LICENSE-2.0
007     * Unless required by applicable law or agreed to in writing, software
008     * distributed under the License is distributed on an "AS IS" BASIS,
009     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
010     * implied.  See the License for the specific language governing
011     * permissions and limitations under the License.
012     */
013    
014    package org.hornetq.api.core.client;
015    
016    import org.hornetq.api.core.Message;
017    
018    /**
019     * A SendAcknowledgementHandler notifies a client when an message sent asynchronously has been received by the server.
020     * <br />
021     * If the session is not blocking when sending durable or non-durable messages, the session can
022     * set a SendAcknowledgementHandler to be notified later when the messages
023     * has been received by the server. The method {@code sendAcknowledged} will be called with the message that
024     * was sent asynchronously.
025     *
026     * @author <a href="mailto:tim.fox@jboss.com">Tim Fox</a>
027     */
028    public interface SendAcknowledgementHandler
029    {
030       /**
031        * Notifies the client that a message sent asynchronously has been received by the server.
032        *
033        * @param message message sent asynchronously
034        */
035       void sendAcknowledged(Message message);
036    }