extensions/common/permissions/permissions_info.h

   1 // Copyright 2013 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 EXTENSIONS_COMMON_PERMISSIONS_PERMISSIONS_INFO_H_
   6 #define EXTENSIONS_COMMON_PERMISSIONS_PERMISSIONS_INFO_H_
   7
   8 #include <map>
   9 #include <set>
  10 #include <string>
  11
  12 #include "base/callback.h"
  13 #include "base/lazy_instance.h"
  14 #include "extensions/common/permissions/api_permission.h"
  15 #include "extensions/common/permissions/api_permission_set.h"
  16 #include "extensions/common/permissions/permission_message.h"
  17 #include "extensions/common/permissions/permissions_provider.h"
  18
  19 namespace extensions {
  20
  21 // A global object that holds the extension permission instances and provides
  22 // methods for accessing them.
  23 class PermissionsInfo {
  24  public:
  25   static PermissionsInfo* GetInstance();
  26
  27   // Initializes the permissions from the provider.
  28   void AddProvider(const PermissionsProvider& provider);
  29
  30   // Returns the permission with the given |id|, and NULL if it doesn't exist.
  31   const APIPermissionInfo* GetByID(APIPermission::ID id) const;
  32
  33   // Returns the permission with the given |name|, and NULL if none
  34   // exists.
  35   const APIPermissionInfo* GetByName(const std::string& name) const;
  36
  37   // Returns a set containing all valid api permission ids.
  38   APIPermissionSet GetAll() const;
  39
  40   // Converts all the permission names in |permission_names| to permission ids.
  41   APIPermissionSet GetAllByName(
  42       const std::set<std::string>& permission_names) const;
  43
  44   // Checks if any permissions have names that start with |name| followed by a
  45   // period.
  46   bool HasChildPermissions(const std::string& name) const;
  47
  48   // Gets the total number of API permissions.
  49   size_t get_permission_count() const { return permission_count_; }
  50
  51  private:
  52   friend struct base::DefaultLazyInstanceTraits<PermissionsInfo>;
  53
  54   PermissionsInfo();
  55
  56   virtual ~PermissionsInfo();
  57
  58   // Registers an |alias| for a given permission |name|.
  59   void RegisterAlias(const char* name, const char* alias);
  60
  61   // Registers a permission with the specified attributes and flags.
  62   void RegisterPermission(APIPermissionInfo* permission);
  63
  64   // Maps permission ids to permissions.
  65   typedef std::map<APIPermission::ID, APIPermissionInfo*> IDMap;
  66
  67   // Maps names and aliases to permissions.
  68   typedef std::map<std::string, APIPermissionInfo*> NameMap;
  69
  70   IDMap id_map_;
  71   NameMap name_map_;
  72
  73   size_t permission_count_;
  74
  75   DISALLOW_COPY_AND_ASSIGN(PermissionsInfo);
  76 };
  77
  78 }  // namespace extensions
  79
  80 #endif  // EXTENSIONS_COMMON_PERMISSIONS_PERMISSIONS_INFO_H_