dom/events/DataTransferItem.h

   1 /* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
   2 /* vim: set ts=8 sts=2 et sw=2 tw=80: */
   3 /* This Source Code Form is subject to the terms of the Mozilla Public
   4  * License, v. 2.0. If a copy of the MPL was not distributed with this
   5  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
   6
   7 #ifndef mozilla_dom_DataTransferItem_h
   8 #define mozilla_dom_DataTransferItem_h
   9
  10 #include "mozilla/dom/DataTransfer.h"
  11 #include "mozilla/dom/DOMString.h"
  12 #include "mozilla/dom/File.h"
  13
  14 namespace mozilla {
  15 class ErrorResult;
  16
  17 namespace dom {
  18
  19 class DataTransfer;
  20 class FileSystemEntry;
  21 class FunctionStringCallback;
  22
  23 class DataTransferItem final : public nsISupports, public nsWrapperCache {
  24  public:
  25   NS_DECL_CYCLE_COLLECTING_ISUPPORTS
  26   NS_DECL_CYCLE_COLLECTION_WRAPPERCACHE_CLASS(DataTransferItem);
  27
  28  public:
  29   // The spec only talks about the "file" and "string" kinds. Due to the Moz*
  30   // APIs, it is possible to attach any type to a DataTransferItem, meaning that
  31   // we can have other kinds then just FILE and STRING. These others are simply
  32   // marked as "other" and can only be produced throug the Moz* APIs.
  33   enum eKind {
  34     KIND_FILE,
  35     KIND_STRING,
  36     KIND_OTHER,
  37   };
  38
  39   DataTransferItem(DataTransfer* aDataTransfer, const nsAString& aType,
  40                    eKind aKind = KIND_OTHER)
  41       : mIndex(0),
  42         mChromeOnly(false),
  43         mKind(aKind),
  44         mType(aType),
  45         mDataTransfer(aDataTransfer) {
  46     MOZ_ASSERT(mDataTransfer, "Must be associated with a DataTransfer");
  47   }
  48
  49   already_AddRefed<DataTransferItem> Clone(DataTransfer* aDataTransfer) const;
  50
  51   virtual JSObject* WrapObject(JSContext* aCx,
  52                                JS::Handle<JSObject*> aGivenProto) override;
  53
  54   void GetAsString(FunctionStringCallback* aCallback,
  55                    nsIPrincipal& aSubjectPrincipal, ErrorResult& aRv);
  56
  57   void GetKind(nsAString& aKind) const {
  58     switch (mKind) {
  59       case KIND_FILE:
  60         aKind = u"file"_ns;
  61         return;
  62       case KIND_STRING:
  63         aKind = u"string"_ns;
  64         return;
  65       default:
  66         aKind = u"other"_ns;
  67         return;
  68     }
  69   }
  70
  71   void GetInternalType(nsAString& aType) const { aType = mType; }
  72   bool IsInternalType(const nsAString& aType) const { return aType == mType; }
  73
  74   void GetType(nsAString& aType);
  75
  76   eKind Kind() const { return mKind; }
  77
  78   already_AddRefed<File> GetAsFile(nsIPrincipal& aSubjectPrincipal,
  79                                    ErrorResult& aRv);
  80
  81   already_AddRefed<FileSystemEntry> GetAsEntry(nsIPrincipal& aSubjectPrincipal,
  82                                                ErrorResult& aRv);
  83
  84   DataTransfer* GetParentObject() const { return mDataTransfer; }
  85
  86   nsIPrincipal* Principal() const { return mPrincipal; }
  87   void SetPrincipal(nsIPrincipal* aPrincipal) { mPrincipal = aPrincipal; }
  88
  89   // @return cached data, if available.
  90   //         otherwise: if available, `mDataTransfer`'s transferable data.
  91   //                    otherwise the data is retrieved from the clipboard (for
  92   //                    paste events) or the drag session.
  93   already_AddRefed<nsIVariant> DataNoSecurityCheck();
  94   // Data may return null if the clipboard state has changed since the type was
  95   // detected.
  96   already_AddRefed<nsIVariant> Data(nsIPrincipal* aPrincipal, ErrorResult& aRv);
  97
  98   // Note: This can modify the mKind.  Callers of this method must let the
  99   // relevant DataTransfer know, because its types list can change as a result.
 100   void SetData(nsIVariant* aData);
 101
 102   uint32_t Index() const { return mIndex; }
 103   void SetIndex(uint32_t aIndex) { mIndex = aIndex; }
 104   void FillInExternalData();
 105
 106   bool ChromeOnly() const { return mChromeOnly; }
 107   void SetChromeOnly(bool aChromeOnly) { mChromeOnly = aChromeOnly; }
 108
 109   static eKind KindFromData(nsIVariant* aData);
 110
 111  private:
 112   ~DataTransferItem() = default;
 113   already_AddRefed<File> CreateFileFromInputStream(nsIInputStream* aStream);
 114   already_AddRefed<File> CreateFileFromInputStream(
 115       nsIInputStream* aStream, const char* aFileNameKey,
 116       const nsAString& aContentType);
 117
 118   // The index in the 2d mIndexedItems array
 119   uint32_t mIndex;
 120
 121   bool mChromeOnly;
 122   eKind mKind;
 123   const nsString mType;
 124   nsCOMPtr<nsIVariant> mData;
 125   nsCOMPtr<nsIPrincipal> mPrincipal;
 126   RefPtr<DataTransfer> mDataTransfer;
 127
 128   // File cache for nsIFile application/x-moz-file entries.
 129   RefPtr<File> mCachedFile;
 130 };
 131
 132 }  // namespace dom
 133 }  // namespace mozilla
 134
 135 #endif /* mozilla_dom_DataTransferItem_h */