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 OpenBeOS 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 43 class FolderListener { 44 public: 45 // entry created or moved into folder 46 virtual void EntryCreated(node_ref* node, entry_ref* entry) {}; 47 // entry removed from folder (or moved to another folder) 48 virtual void EntryRemoved(node_ref* node) {}; 49 // attribute of an entry has changed 50 virtual void AttributeChanged(node_ref* node) {}; 51 }; 52 53 54 // The class FolderWatcher watches creation, deletion of files in a directory 55 // and optionally watches attribute changes of files in the directory. 56 class FolderWatcher : public BHandler { 57 typedef BHandler inherited; 58 59 private: 60 BDirectory fFolder; 61 FolderListener* fListener; 62 bool fWatchAttrChanges; 63 64 bool BuildEntryRef(BMessage* msg, const char* dirName, entry_ref* entry); 65 bool BuildNodeRef(BMessage* msg, node_ref* node); 66 67 void HandleCreatedEntry(BMessage* msg, const char* dirName); 68 void HandleRemovedEntry(BMessage* msg); 69 void HandleChangedAttr(BMessage* msg); 70 71 public: 72 // start node watching (optionally watch attribute changes) 73 FolderWatcher(BLooper* looper, const BDirectory& folder, bool watchAttrChanges = false); 74 // stop node watching 75 virtual ~FolderWatcher(); 76 77 void MessageReceived(BMessage* msg); 78 79 // the directory 80 BDirectory* Folder() { return &fFolder; } 81 82 // set listener that is notified of changes in the directory 83 void SetListener(FolderListener* listener); 84 85 // start/stop watching of attribute changes 86 status_t StartAttrWatching(node_ref* node); 87 status_t StopAttrWatching(node_ref* node); 88 }; 89 90 #endif 91