File indexing completed on 2024-04-28 16:59:42

0001 /*
0002    Copyright (C) 2013 Andreas Hartmetz <ahartmetz@gmail.com>
0003 
0004    This library is free software; you can redistribute it and/or
0005    modify it under the terms of the GNU Library General Public
0006    License as published by the Free Software Foundation; either
0007    version 2 of the License, or (at your option) any later version.
0008 
0009    This library is distributed in the hope that it will be useful,
0010    but WITHOUT ANY WARRANTY; without even the implied warranty of
0011    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
0012    Library General Public License for more details.
0013 
0014    You should have received a copy of the GNU Library General Public License
0015    along with this library; see the file COPYING.LGPL.  If not, write to
0016    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
0017    Boston, MA 02110-1301, USA.
0018 
0019    Alternatively, this file is available under the Mozilla Public License
0020    Version 1.1.  You may obtain a copy of the License at
0021    http://www.mozilla.org/MPL/
0022 */
0023 
0024 #ifndef IMESSAGERECEIVER_H
0025 #define IMESSAGERECEIVER_H
0026 
0027 #include "export.h"
0028 
0029 class Connection;
0030 class Message;
0031 class PendingReply;
0032 
0033 class DFERRY_EXPORT IMessageReceiver
0034 {
0035 public:
0036     virtual ~IMessageReceiver();
0037     // This hands over ownership of the Message. The default implementation is empty, so the Message
0038     // is destroyed upon going out of scope there.
0039     virtual void handleSpontaneousMessageReceived(Message message, Connection *connection);
0040     // This assumes that client code already owns the PendingReply; if the PendingReply was destroyed, the
0041     // reply would be considered a spontaneous message. The received message is owned by the PendingReply.
0042     // The default implementation does nothing since somebody must still have the PendingReply, so the
0043     // Message is still reachable. That's a somewhat strange but valid situation.
0044     virtual void handlePendingReplyFinished(PendingReply *pendingReply, Connection *connection);
0045 };
0046 
0047 #endif // IMESSAGERECEIVER_H