macosx/HBDistributedArray.h

   1 /*  HBDistributedArray.h $
   2
   3  This file is part of the HandBrake source code.
   4  Homepage: <http://handbrake.fr/>.
   5  It may be used under the terms of the GNU General Public License. */
   6
   7 #import <Cocoa/Cocoa.h>
   8
   9 extern NSString *HBDistributedArrayChanged;
  10
  11 /**
  12  *  Objects in HBDistributedArray
  13  *  must implement this protocol.
  14  */
  15 @protocol HBUniqueObject <NSObject>
  16
  17 @property (nonatomic, readonly) NSString *uuid;
  18
  19 @end
  20
  21 /**
  22  *  HBDistributedArray
  23  *  a mutable array that share its content between processes.
  24  *  post a HBDistributedArrayChanged when the content is changed
  25  *  by another process.
  26  *
  27  *  Use beginTransaction and commit to wrap atomic changes to the array.
  28  *
  29  *  It is safe to keep a reference to an array object.
  30  */
  31 @interface HBDistributedArray : NSMutableArray
  32
  33 - (instancetype)initWithURL:(NSURL *)fileURL;
  34
  35 /**
  36  *  Begin a transaction on the array
  37  */
  38 - (void)beginTransaction;
  39
  40 /**
  41  *  Commit the changes and notify
  42  *  the observers about the changes.
  43  */
  44 - (void)commit;
  45
  46 @end