Support socket endpoint permissions for AppsV2 Socket API.

chrome/common/extensions/permissions/api_permission.h

Index: chrome/common/extensions/permissions/api_permission.h
diff --git a/chrome/common/extensions/permissions/api_permission.h b/chrome/common/extensions/permissions/api_permission.h
index c35a720ab1416491dd88c454da2147ea842f3ccf..c29fa8f7006620e954b2e1a1a482dbb8aac7a3cc 100644
--- a/chrome/common/extensions/permissions/api_permission.h
+++ b/chrome/common/extensions/permissions/api_permission.h
@@ -5,12 +5,26 @@
 #ifndef CHROME_COMMON_EXTENSIONS_PERMISSIONS_API_PERMISSION_H_
 #define CHROME_COMMON_EXTENSIONS_PERMISSIONS_API_PERMISSION_H_
 
+#include <map>
 #include <set>
+#include <string>
 
+#include "base/callback.h"
+#include "base/memory/ref_counted.h"
+#include "base/pickle.h"
 #include "chrome/common/extensions/permissions/permission_message.h"
 
+namespace base {
+class Value;
+}
+
+namespace IPC {
+class Message;
+}
+
 namespace extensions {
 
+class APIPermissionDetail;
 class PermissionsInfo;
 
 // The APIPermission is an immutable class that describes a single
@@ -105,10 +119,15 @@ class APIPermission {
     kFlagCannotBeOptional = 1 << 3
   };
 
+  typedef APIPermissionDetail* (*DetailConstructor)(const APIPermission*);
+
   typedef std::set<ID> IDSet;
 
   ~APIPermission();
 
+  // Creates a permission detail instance.
+  scoped_refptr<APIPermissionDetail> CreateDetail() const;
+
   // Returns the localized permission message associated with this api.
   // Use GetMessage_ to avoid name conflict with macro GetMessage on Windows.
   PermissionMessage GetMessage_() const;
@@ -150,19 +169,96 @@ class APIPermission {
       const char* name,
       int l10n_message_id,
       PermissionMessage::ID message_id,
-      int flags);
+      int flags,
+      DetailConstructor detail_constructor);
 
   // Register ALL the permissions!
   static void RegisterAllPermissions(PermissionsInfo* info);
 
-  ID id_;
-  const char* name_;
-  int flags_;
-  int l10n_message_id_;
-  PermissionMessage::ID message_id_;
+  const ID id_;
+  const char* const name_;
+  const int flags_;
+  const int l10n_message_id_;
+  const PermissionMessage::ID message_id_;
+  const DetailConstructor detail_constructor_;
 };
 
-typedef std::set<APIPermission::ID> APIPermissionSet;
+// TODO(penghuang): Rename APIPermissionDetail to APIPermission,
+// and APIPermssion to APIPermissionInfo.
+class APIPermissionDetail : public base::RefCounted<APIPermissionDetail> {
+ public:
+  struct CheckParam {
+  };
+
+  explicit APIPermissionDetail(const APIPermission* permission)
+    : permission_(permission) {
+    DCHECK(permission);
+  }
+
+  // Returns the id of this permission.
+  APIPermission::ID id() const {
+    return permission()->id();
+  }
+
+  // Returns the name of this permission.
+  const char* name() const {
+    return permission()->name();
+  }
+
+  // Returns the APIPermission of this permission.
+  const APIPermission* permission() const {
+    return permission_;
+  }
+
+  // Returns true if the given permission detail is allowed.
+  virtual bool Check(const CheckParam* param) const = 0;
+
+  // Returns true if |detail| is a subset of this.
+  virtual bool Contains(const APIPermissionDetail* detail) const = 0;
+
+  // Returns true if |detail| is equal to this.
+  virtual bool Equal(const APIPermissionDetail* detail) const = 0;
+
+  // Parses the detail from |value|. Returns false if error happens.
+  virtual bool FromValue(const base::Value* value) = 0;
+
+  // Stores this into a new created |value|.
+  virtual void ToValue(base::Value** value) const = 0;
+
+  // Clones this.
+  virtual APIPermissionDetail* Clone() const = 0;
+
+  // Returns a new API permission detail which equals this - |detail|.
+  virtual APIPermissionDetail* Diff(
+      const APIPermissionDetail* detail) const = 0;
+
+  // Returns a new API permission detail which equals the union of this and
+  // |detail|.
+  virtual APIPermissionDetail* Union(
+      const APIPermissionDetail* detail) const = 0;
+
+  // Returns a new API permission detail which equals the intersect of this and
+  // |detail|.
+  virtual APIPermissionDetail* Intersect(
+      const APIPermissionDetail* detail) const = 0;
+
+  // IPC functions
+  // Writes this into the given IPC message |m|.
+  virtual void Write(IPC::Message* m) const = 0;
+
+  // Reads from the given IPC message |m|.
+  virtual bool Read(const IPC::Message* m, PickleIterator* iter) = 0;
+
+  // Logs this detail.
+  virtual void Log(std::string* log) const = 0;
+
+ protected:
+  friend class base::RefCounted<APIPermissionDetail>;
+  virtual ~APIPermissionDetail();
+
+ private:
+  const APIPermission* const permission_;
+};
 
 }  // namespace extensions