sync/api/attachments/attachment.h

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef SYNC_API_ATTACHMENTS_ATTACHMENT_H_
   6 #define SYNC_API_ATTACHMENTS_ATTACHMENT_H_
   7
   8 #include <map>
   9 #include <vector>
  10
  11 #include "base/basictypes.h"
  12 #include "base/memory/ref_counted.h"
  13 #include "base/memory/ref_counted_memory.h"
  14 #include "base/memory/scoped_ptr.h"
  15 #include "sync/api/attachments/attachment_id.h"
  16 #include "sync/base/sync_export.h"
  17
  18 namespace syncer {
  19
  20 // A blob of in-memory data attached to a sync item.
  21 //
  22 // While Attachment objects themselves aren't immutable (they are assignable)
  23 // the data they wrap is immutable.
  24 //
  25 // It is cheap to copy Attachments. Feel free to store and return by value.
  26 class SYNC_EXPORT Attachment {
  27  public:
  28   ~Attachment();
  29
  30   // Default copy and assignment are welcome.
  31
  32   // Creates an attachment with a unique id and the supplied data.
  33   //
  34   // Used when creating a brand new attachment.
  35   static Attachment Create(const scoped_refptr<base::RefCountedMemory>& data);
  36
  37   // Creates an attachment with the supplied id and data.
  38   //
  39   // Used when you want to recreate a specific attachment. E.g. creating a local
  40   // copy of an attachment that already exists on the sync server.
  41   static Attachment CreateWithId(
  42       const AttachmentId& id,
  43       const scoped_refptr<base::RefCountedMemory>& data);
  44
  45   // Returns this attachment's id.
  46   const AttachmentId& GetId() const;
  47
  48   // Returns this attachment's data.
  49   const scoped_refptr<base::RefCountedMemory>& GetData() const;
  50
  51  private:
  52   AttachmentId id_;
  53   scoped_refptr<base::RefCountedMemory> data_;
  54
  55   Attachment(const AttachmentId& id,
  56              const scoped_refptr<base::RefCountedMemory>& data);
  57 };
  58
  59 typedef std::vector<syncer::Attachment> AttachmentList;
  60 typedef std::map<AttachmentId, Attachment> AttachmentMap;
  61
  62 }  // namespace syncer
  63
  64 #endif  // SYNC_API_ATTACHMENTS_ATTACHMENT_H_