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