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