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
014package org.hornetq.api.core.client;
015
016import 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 */
028public 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}