chrome/browser/extensions/pending_extension_info.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 CHROME_BROWSER_EXTENSIONS_PENDING_EXTENSION_INFO_H_
   6 #define CHROME_BROWSER_EXTENSIONS_PENDING_EXTENSION_INFO_H_
   7
   8 #include <string>
   9
  10 #include "base/gtest_prod_util.h"
  11 #include "base/version.h"
  12 #include "extensions/common/manifest.h"
  13 #include "url/gurl.h"
  14
  15 FORWARD_DECLARE_TEST(ExtensionServiceTest, AddPendingExtensionFromSync);
  16
  17 namespace extensions {
  18 class Extension;
  19
  20 // A pending extension is an extension that hasn't been installed yet
  21 // and is intended to be installed in the next auto-update cycle.  The
  22 // update URL of a pending extension may be blank, in which case a
  23 // default one is assumed.
  24 // TODO(skerner): Make this class an implementation detail of
  25 // PendingExtensionManager, and remove all other users.
  26 class PendingExtensionInfo {
  27  public:
  28   typedef bool (*ShouldAllowInstallPredicate)(const Extension*);
  29
  30   PendingExtensionInfo(const std::string& id,
  31                        const std::string& install_parameter,
  32                        const GURL& update_url,
  33                        const Version& version,
  34                        ShouldAllowInstallPredicate should_allow_install,
  35                        bool is_from_sync,
  36                        Manifest::Location install_source,
  37                        int creation_flags,
  38                        bool mark_acknowledged,
  39                        bool remote_install);
  40
  41   // Required for STL container membership.  Should not be used directly.
  42   PendingExtensionInfo();
  43
  44   ~PendingExtensionInfo();
  45
  46   // Consider two PendingExtensionInfos equal if their ids are equal.
  47   bool operator==(const PendingExtensionInfo& rhs) const;
  48
  49   const std::string& id() const { return id_; }
  50   const GURL& update_url() const { return update_url_; }
  51   const Version& version() const { return version_; }
  52   const std::string& install_parameter() const { return install_parameter_; }
  53
  54   // ShouldAllowInstall() returns the result of running constructor argument
  55   // |should_allow_install| on an extension. After an extension is unpacked,
  56   // this function is run. If it returns true, the extension is installed.
  57   // If not, the extension is discarded. This allows creators of
  58   // PendingExtensionInfo objects to ensure that extensions meet some criteria
  59   // that can only be tested once the extension is unpacked.
  60   bool ShouldAllowInstall(const Extension* extension) const {
  61     return should_allow_install_(extension);
  62   }
  63   bool is_from_sync() const { return is_from_sync_; }
  64   Manifest::Location install_source() const { return install_source_; }
  65   int creation_flags() const { return creation_flags_; }
  66   bool mark_acknowledged() const { return mark_acknowledged_; }
  67   bool remote_install() const { return remote_install_; }
  68
  69   // Returns -1, 0 or 1 if |this| has lower, equal or higher precedence than
  70   // |other|, respectively. "Equal" precedence means that the version and the
  71   // install source match. "Higher" precedence means that the version is newer,
  72   // or the version matches but the install source has higher priority.
  73   // It is only valid to invoke this when the ids match.
  74   int CompareTo(const PendingExtensionInfo& other) const;
  75
  76  private:
  77   std::string id_;
  78
  79   GURL update_url_;
  80   Version version_;
  81   std::string install_parameter_;
  82
  83   // When the extension is about to be installed, this function is
  84   // called.  If this function returns true, the install proceeds.  If
  85   // this function returns false, the install is aborted.
  86   ShouldAllowInstallPredicate should_allow_install_;
  87
  88   bool is_from_sync_;  // This update check was initiated from sync.
  89   Manifest::Location install_source_;
  90   int creation_flags_;
  91   bool mark_acknowledged_;
  92   bool remote_install_;
  93
  94   FRIEND_TEST_ALL_PREFIXES(::ExtensionServiceTest, AddPendingExtensionFromSync);
  95 };
  96
  97 }  // namespace extensions
  98
  99 #endif  // CHROME_BROWSER_EXTENSIONS_PENDING_EXTENSION_INFO_H_