1/*****************************************************************************/
2// FolderWatcher
3//
4// Author
5//   Michael Pfeiffer
6//
7// This application and all source files used in its construction, except
8// where noted, are licensed under the MIT License, and have been written
9// and are:
10//
11// Copyright (c) 2002 Haiku Project
12//
13// Permission is hereby granted, free of charge, to any person obtaining a
14// copy of this software and associated documentation files (the "Software"),
15// to deal in the Software without restriction, including without limitation
16// the rights to use, copy, modify, merge, publish, distribute, sublicense,
17// and/or sell copies of the Software, and to permit persons to whom the
18// Software is furnished to do so, subject to the following conditions:
19//
20// The above copyright notice and this permission notice shall be included
21// in all copies or substantial portions of the Software.
22//
23// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
24// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
25// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
26// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
27// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
28// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
29// DEALINGS IN THE SOFTWARE.
30/*****************************************************************************/
31
32#ifndef _FOLDER_WATCHER_H
33#define _FOLDER_WATCHER_H
34
35#include <Directory.h>
36#include <Entry.h>
37#include <Handler.h>
38#include <Looper.h>
39#include <String.h>
40#include <StorageDefs.h>
41
42
43class FolderListener {
44public:
45	virtual ~FolderListener() {};
46		// entry created or moved into folder
47	virtual void EntryCreated(node_ref* node, entry_ref* entry) {};
48		// entry removed from folder (or moved to another folder)
49	virtual void EntryRemoved(node_ref* node) {};
50		// attribute of an entry has changed
51	virtual void AttributeChanged(node_ref* node) {};
52};
53
54
55// The class FolderWatcher watches creation, deletion of files in a directory
56// and optionally watches attribute changes of files in the directory.
57class FolderWatcher : public BHandler {
58	typedef BHandler inherited;
59
60private:
61	BDirectory fFolder;
62	FolderListener* fListener;
63	bool fWatchAttrChanges;
64
65	bool BuildEntryRef(BMessage* msg, const char* dirName, entry_ref* entry);
66	bool BuildNodeRef(BMessage* msg, node_ref* node);
67
68	void HandleCreatedEntry(BMessage* msg, const char* dirName);
69	void HandleRemovedEntry(BMessage* msg);
70	void HandleChangedAttr(BMessage* msg);
71
72public:
73		// start node watching (optionally watch attribute changes)
74	FolderWatcher(BLooper* looper, const BDirectory& folder, bool watchAttrChanges = false);
75		// stop node watching
76	virtual ~FolderWatcher();
77
78	void MessageReceived(BMessage* msg);
79
80		// the directory
81	BDirectory* Folder() { return &fFolder; }
82
83		// set listener that is notified of changes in the directory
84	void SetListener(FolderListener* listener);
85
86		// start/stop watching of attribute changes
87	status_t StartAttrWatching(node_ref* node);
88	status_t StopAttrWatching(node_ref* node);
89};
90
91#endif
92