    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    }