It is accomplished ...

git-svn-id: file:///srv/svn/repos/haiku/trunk/current@10 a95241bf-73f2-0310-859d-f6bbb57e9c96
2002-07-09 12:24:59 +00:00
commit 52a3801208
2025 changed files with 472889 additions and 0 deletions
@@ -0,0 +1,148 @@
+//------------------------------------------------------------------------------
+//	Copyright (c) 2001-2002, OpenBeOS
+//
+//	Permission is hereby granted, free of charge, to any person obtaining a
+//	copy of this software and associated documentation files (the "Software"),
+//	to deal in the Software without restriction, including without limitation
+//	the rights to use, copy, modify, merge, publish, distribute, sublicense,
+//	and/or sell copies of the Software, and to permit persons to whom the
+//	Software is furnished to do so, subject to the following conditions:
+//
+//	The above copyright notice and this permission notice shall be included in
+//	all copies or substantial portions of the Software.
+//
+//	THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//	IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//	FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//	AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//	LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+//	FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+//	DEALINGS IN THE SOFTWARE.
+//
+//	File Name:		Handler.cpp
+//	Author:			Erik Jaesler ([email protected])
+//	Description:	BHandler defines the message-handling protocol.
+//					MessageReceived() is its lynchpin.
+//------------------------------------------------------------------------------
+
+#ifndef _HANDLER_H
+#define _HANDLER_H
+
+// Standard Includes -----------------------------------------------------------
+
+// System Includes -------------------------------------------------------------
+#include <BeBuild.h>
+#include <Archivable.h>
+
+// Project Includes ------------------------------------------------------------
+
+// Local Includes --------------------------------------------------------------
+
+// Local Defines ---------------------------------------------------------------
+
+// Globals ---------------------------------------------------------------------
+
+class BLooper;
+class BMessageFilter;
+class BMessage;
+class BList;
+class _ObserverList;
+
+#define B_OBSERVE_WHAT_CHANGE "be:observe_change_what"
+#define B_OBSERVE_ORIGINAL_WHAT "be:observe_orig_what"
+const uint32 B_OBSERVER_OBSERVE_ALL = 0xffffffff;
+
+// BHandler class --------------------------------------------------------------
+class BHandler : public BArchivable {
+
+public:
+							BHandler(const char* name = NULL);
+	virtual					~BHandler();
+
+	// Archiving
+							BHandler(BMessage* data);
+	static	BArchivable*	Instantiate(BMessage* data);
+	virtual	status_t		Archive(BMessage* data, bool deep = true) const;
+
+	// BHandler guts.
+	virtual	void			MessageReceived(BMessage* message);
+			BLooper*		Looper() const;
+			void			SetName(const char* name);
+			const char*		Name() const;
+	virtual	void			SetNextHandler(BHandler* handler);
+			BHandler*		NextHandler() const;
+
+	// Message filtering
+	virtual	void			AddFilter(BMessageFilter* filter);
+	virtual	bool			RemoveFilter(BMessageFilter* filter);
+	virtual	void			SetFilterList(BList* filters);
+			BList*			FilterList();
+
+			bool			LockLooper();
+			status_t		LockLooperWithTimeout(bigtime_t timeout);
+			void			UnlockLooper();
+
+	// Scripting
+	virtual BHandler*		ResolveSpecifier(BMessage* msg,
+											 int32 index,
+											 BMessage* specifier,
+											 int32 form,
+											 const char* property);
+	virtual status_t		GetSupportedSuites(BMessage* data);
+
+	// Observer calls, inter-looper and inter-team
+			status_t		StartWatching(BMessenger, uint32 what);
+			status_t		StartWatchingAll(BMessenger);
+			status_t		StopWatching(BMessenger, uint32 what);
+			status_t		StopWatchingAll(BMessenger);
+
+	// Observer calls for observing targets in the same BLooper
+			status_t		StartWatching(BHandler* , uint32 what);
+			status_t		StartWatchingAll(BHandler* );
+			status_t		StopWatching(BHandler* , uint32 what);
+			status_t		StopWatchingAll(BHandler* );
+
+
+	// Reserved
+	virtual status_t		Perform(perform_code d, void* arg);
+
+	// Notifier calls
+	virtual	void 			SendNotices(uint32 what, const BMessage*  = 0);
+			bool			IsWatched() const;
+
+//----- Private or reserved -----------------------------------------
+private:
+	typedef BArchivable		_inherited;
+	friend inline int32		_get_object_token_(const BHandler* );
+	friend class BLooper;
+	friend class BMessageFilter;
+
+	virtual	void			_ReservedHandler2();
+	virtual	void			_ReservedHandler3();
+	virtual	void			_ReservedHandler4();
+
+			void			InitData(const char* name);
+
+							BHandler(const BHandler&);
+			BHandler&		operator=(const BHandler&);
+			void			SetLooper(BLooper* loop);
+
+			int32			fToken;
+			char*			fName;
+			BLooper*		fLooper;
+			BHandler*		fNextHandler;
+			BList*			fFilters;
+			_ObserverList*	fObserverList;
+			uint32			_reserved[3];
+};
+//------------------------------------------------------------------------------
+
+#endif	// _HANDLER_H
+
+/*
+ * $Log $
+ *
+ * $Id  $
+ *
+ */
+