Files
platform-external-webrtc/rtc_base/message_handler.h
Tomas Gunnarsson 123594114f Make MessageHandler ctor explicitly require 'false'.
This is the next step towards making MessageHandler a pure virtual
interface. All dependencies that require automatic cleanup
should be depending on the MessageHandlerAutoCleanup class.

Next step will be to remove the ctor from MessageHandler and make
it a pure virtual interface.

Bug: webrtc:11908
Change-Id: I9321b6d9e57c167868f8b896a5345fbfe19af0e9
Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/183984
Reviewed-by: Mirko Bonadei <mbonadei@webrtc.org>
Commit-Queue: Tommi <tommi@webrtc.org>
Cr-Commit-Position: refs/heads/master@{#32090}
2020-09-12 11:04:43 +00:00

61 lines
1.8 KiB
C++

/*
* Copyright 2004 The WebRTC Project Authors. All rights reserved.
*
* Use of this source code is governed by a BSD-style license
* that can be found in the LICENSE file in the root of the source
* tree. An additional intellectual property rights grant can be found
* in the file PATENTS. All contributing project authors may
* be found in the AUTHORS file in the root of the source tree.
*/
#ifndef RTC_BASE_MESSAGE_HANDLER_H_
#define RTC_BASE_MESSAGE_HANDLER_H_
#include <utility>
#include "api/function_view.h"
#include "rtc_base/constructor_magic.h"
#include "rtc_base/system/rtc_export.h"
namespace rtc {
struct Message;
// MessageQueue/Thread Messages get dispatched to a MessageHandler via the
// |OnMessage()| callback method.
//
// Note: Besides being an interface, the class can perform automatic cleanup
// in the destructor.
// TODO(bugs.webrtc.org/11908): The |auto_cleanup| parameter and associated
// logic is a temporary step while changing the MessageHandler class to be
// a pure virtual interface. The automatic cleanup step involves a number of
// complex operations and as part of this interface, can easily go by unnoticed
// and bundled into situations where it's not needed.
class RTC_EXPORT MessageHandler {
public:
virtual ~MessageHandler();
virtual void OnMessage(Message* msg) = 0;
protected:
// TODO(bugs.webrtc.org/11908): Remove this ctor.
explicit MessageHandler(bool auto_cleanup);
private:
RTC_DISALLOW_COPY_AND_ASSIGN(MessageHandler);
};
class RTC_EXPORT MessageHandlerAutoCleanup : public MessageHandler {
public:
~MessageHandlerAutoCleanup() override;
protected:
MessageHandlerAutoCleanup();
private:
RTC_DISALLOW_COPY_AND_ASSIGN(MessageHandlerAutoCleanup);
};
} // namespace rtc
#endif // RTC_BASE_MESSAGE_HANDLER_H_