haiku/headers/private/kernel/Notifications.h

/*
 * Copyright 2007, Haiku, Inc. All Rights Reserved.
 * Distributed under the terms of the MIT License.
 *
 * Authors:
 *		Axel Dörfler, axeld@pinc-software.de
 *		Ingo Weinhold, bonefish@cs.tu-berlin.de
 */
#ifndef _KERNEL_NOTIFICATIONS_H
#define _KERNEL_NOTIFICATIONS_H


#include <SupportDefs.h>

#include <lock.h>
#include <messaging.h>
#include <util/khash.h>


#ifdef __cplusplus

#include <Referenceable.h>

#include <util/AutoLock.h>
#include <util/KMessage.h>
#include <util/OpenHashTable.h>


class NotificationService;

class NotificationListener {
	public:
		virtual ~NotificationListener();

		virtual void EventOccured(NotificationService& service,
			const KMessage* event);
		virtual void AllListenersNotified(NotificationService& service);

		virtual bool operator==(const NotificationListener& other) const;

		bool operator!=(const NotificationListener& other) const
			{ return !(*this == other); }
};

class UserMessagingMessageSender {
	public:
		UserMessagingMessageSender();

		void SendMessage(const KMessage* message, port_id port, int32 token);
		void FlushMessage();

	private:
		enum {
			MAX_MESSAGING_TARGET_COUNT	= 16,
		};

		const KMessage*		fMessage;
		messaging_target	fTargets[MAX_MESSAGING_TARGET_COUNT];
		int32				fTargetCount;
};

class UserMessagingListener : public NotificationListener {
	public:
		UserMessagingListener(UserMessagingMessageSender& sender, port_id port,
			int32 token);
		virtual ~UserMessagingListener();

		virtual void EventOccured(NotificationService& service,
			const KMessage* event);
		virtual void AllListenersNotified(NotificationService& service);

		port_id Port() const	{ return fPort; }
		int32 Token() const		{ return fToken; }

	private:
		UserMessagingMessageSender&	fSender;
		port_id						fPort;
		int32						fToken;
};

class NotificationService : public Referenceable {
	public:
		virtual ~NotificationService();

		virtual status_t AddListener(const KMessage* eventSpecifier,
			NotificationListener& listener) = 0;
		virtual status_t RemoveListener(const KMessage* eventSpecifier,
			NotificationListener& listener) = 0;
		virtual status_t UpdateListener(const KMessage* eventSpecifier,
			NotificationListener& listener) = 0;

		virtual const char* Name() = 0;
		HashTableLink<NotificationService>& Link() { return fLink; }

	private:
		HashTableLink<NotificationService> fLink;
};

class NotificationManager {
	public:
		static NotificationManager& Manager();
		static status_t CreateManager();

		status_t RegisterService(NotificationService& service);
		void UnregisterService(NotificationService& service);

		NotificationService* GetService(const char* name);
		void PutService(NotificationService* service);

		status_t AddListener(const char* service, uint32 eventMask,
			NotificationListener& listener);
		status_t AddListener(const char* service,
			const KMessage* eventSpecifier, NotificationListener& listener);

		status_t UpdateListener(const char* service,
			uint32 eventMask, NotificationListener& listener);
		status_t UpdateListener(const char* service,
			const KMessage* eventSpecifier, NotificationListener& listener);

		status_t RemoveListener(const char* service,
			const KMessage* eventSpecifier, NotificationListener& listener);

	private:
		NotificationManager();
		~NotificationManager();

		status_t _Init();
		NotificationService* _ServiceFor(const char* name);

		struct HashDefinition {
			typedef const char* KeyType;
			typedef	NotificationService ValueType;

			size_t HashKey(const char* key) const
				{ return hash_hash_string(key); }
			size_t Hash(NotificationService *service) const
				{ return hash_hash_string(service->Name()); }
			bool Compare(const char* key, NotificationService* service) const
				{ return !strcmp(key, service->Name()); }
			HashTableLink<NotificationService>* GetLink(
					NotificationService* service) const
				{ return &service->Link(); }
		};

		static NotificationManager sManager;

		mutex fLock;
		typedef OpenHashTable<HashDefinition> ServiceHash;
		ServiceHash	fServiceHash;
};

extern "C" {

#endif	// __cplusplus

void notifications_init(void);

#ifdef __cplusplus
}
#endif	// __cplusplus

#endif	// _KERNEL_NOTIFICATIONS_H