Index: ppapi/shared_impl/resource_tracker.h |
diff --git a/ppapi/shared_impl/resource_tracker.h b/ppapi/shared_impl/resource_tracker.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..a6ab01a656f1f3911fcc12847392397f0dac5c59 |
--- /dev/null |
+++ b/ppapi/shared_impl/resource_tracker.h |
@@ -0,0 +1,92 @@ |
+// Copyright (c) 2011 The Chromium Authors. All rights reserved. |
+// Use of this source code is governed by a BSD-style license that can be |
+// found in the LICENSE file. |
+ |
+#ifndef PPAPI_SHARED_IMPL_RESOURCE_TRACKER_H_ |
+#define PPAPI_SHARED_IMPL_RESOURCE_TRACKER_H_ |
+ |
+#include <set> |
+ |
+#include "base/basictypes.h" |
+#include "base/hash_tables.h" |
+#include "base/memory/linked_ptr.h" |
+#include "ppapi/c/pp_instance.h" |
+#include "ppapi/c/pp_resource.h" |
+ |
+namespace ppapi { |
+ |
+class Resource; |
+ |
+class ResourceTracker { |
+ public: |
+ ResourceTracker(); |
+ virtual ~ResourceTracker(); |
+ |
+ // The returned pointer will be NULL if there is no resource. |
dmichael (off chromium)
2011/08/17 16:28:07
Maybe note that the reference count is unaffected?
|
+ Resource* GetResource(PP_Resource res) const; |
+ |
+ bool AddRefResource(PP_Resource res); |
+ bool ReleaseResource(PP_Resource res); |
+ |
+ // Notifies the tracker that a new instance has been created. This must be |
+ // called before creating any resources associated with the instance. |
+ void DidCreateInstance(PP_Instance instance); |
+ |
+ // Called when an instance is being deleted. All plugin refs for the |
+ // associated resources will be force freed, and the resources (if they still |
+ // exist) will be disassociated from the instance. |
+ void DidDeleteInstance(PP_Instance instance); |
+ |
+ // Returns the number of resources associated with the given instance. |
+ // Returns 0 if the instance isn't known. |
+ int GetLiveObjectsForInstance(PP_Instance instance) const; |
+ |
+ protected: |
+ // This calls AddResource and RemoveResource. |
+ friend class Resource; |
+ |
+ // Adds the given resource to the tracker, associating it with the instance |
+ // stored in the resource object. The new resource ID is returned, and the |
+ // resource will have 0 plugin refcount. This is called by the resource |
+ // constructor. |
+ // |
+ // Returns 0 if the resource could not be added. |
+ virtual PP_Resource AddResource(Resource* object); |
+ |
+ // The opposite of AddResource, this removes the tracking information for |
+ // the given resource. It's called from the resource destructor. |
+ virtual void RemoveResource(Resource* object); |
+ |
+ private: |
+ typedef std::set<PP_Resource> ResourceSet; |
+ |
+ struct InstanceData { |
+ // Lists all resources associated with the given instance as non-owning |
+ // pointers. This allows us to notify those resources that the instance is |
+ // going away (otherwise, they may crash if they outlive the instance). |
+ ResourceSet resources; |
+ }; |
+ typedef base::hash_map<PP_Instance, linked_ptr<InstanceData> > InstanceMap; |
+ |
+ InstanceMap instance_map_; |
+ |
+ // For each PP_Resource, keep the object pointer and a plugin use count. |
+ // This use count is different then Resource object's RefCount, and is |
+ // manipulated using this AddRefResource/UnrefResource. When the plugin use |
+ // count is positive, we keep an extra ref on the Resource on |
+ // behalf of the plugin. When it drops to 0, we free that ref, keeping |
+ // the resource in the list. |
+ // |
+ // A resource will be in this list as long as the object is alive. |
+ typedef std::pair<Resource*, int> ResourceAndRefCount; |
+ typedef base::hash_map<PP_Resource, ResourceAndRefCount> ResourceMap; |
+ ResourceMap live_resources_; |
+ |
+ int32 last_resource_value_; |
+ |
+ DISALLOW_COPY_AND_ASSIGN(ResourceTracker); |
+}; |
+ |
+} // namespace ppapi |
+ |
+#endif // PPAPI_SHARED_IMPL_RESOURCE_TRACKER_H_ |