Remove src/trusted/plugin

src/trusted/plugin/scriptable_handle.h

-/*
- * Copyright 2011 (c) The Native Client Authors. All rights reserved.
- * Use of this source code is governed by a BSD-style license that can be
- * found in the LICENSE file.
- */
-
-
-// The browser scriptable container class.  The methods on this class
-// are defined in the specific API directories.
-
-#ifndef NATIVE_CLIENT_SRC_TRUSTED_PLUGIN_SCRIPTABLE_HANDLE_H_
-#define NATIVE_CLIENT_SRC_TRUSTED_PLUGIN_SCRIPTABLE_HANDLE_H_
-
-#include "native_client/src/trusted/plugin/scriptable_handle.h"
-
-#include <stdio.h>
-#include <string.h>
-
-#include <set>
-#include <string>
-#include <vector>
-
-#include "native_client/src/include/checked_cast.h"
-#include "native_client/src/include/nacl_macros.h"
-#include "native_client/src/include/nacl_string.h"
-#include "native_client/src/include/portability.h"
-#include "native_client/src/trusted/plugin/utility.h"
-#include "ppapi/cpp/dev/scriptable_object_deprecated.h"
-#include "ppapi/cpp/private/var_private.h"
-
-struct NaClDesc;
-
-namespace plugin {
-
-// Forward declarations for externals.
-class DescBasedHandle;
-class Plugin;
-
-// ScriptableHandle encapsulates objects that are scriptable from the browser.
-class ScriptableHandle : public pp::deprecated::ScriptableObject {
- public:
-  // Factory methods for creation.
-  static ScriptableHandle* NewPlugin(Plugin* plugin);
-  static ScriptableHandle* NewDescHandle(DescBasedHandle* desc_handle);
-
-  // If not NULL, this var should be reused to pass this object to the browser.
-  pp::VarPrivate* var() { return var_; }
-
-  // Check that a pointer is to a validly created ScriptableHandle.
-  static bool is_valid(const ScriptableHandle* handle);
-  static void Unref(ScriptableHandle** handle);
-
-  // Get the contained plugin object.  NULL if this contains a descriptor.
-  Plugin* plugin() const { return plugin_; }
-
-  // Get the contained descriptor object.  NULL if this contains a plugin.
-  // OBSOLETE -- this support is only needed for SRPC descriptor passing.
-  // TODO(polina): Remove this support when SRPC descriptor passing is removed.
-  DescBasedHandle* desc_handle() const { return desc_handle_; }
-
-  // This function is called when we are about to share the object owned by the
-  // plugin with the browser. Since reference counting on the browser side is
-  // handled via pp::Var's, we create the var() here if not created already.
-  ScriptableHandle* AddRef();
-  // Remove a browser reference to this object.
-  // Delete the object when the ref count becomes 0.
-  // If var() is set, we delete it. Otherwise, we delete the object itself.
-  // Therefore, this cannot be called more than once.
-  void Unref();
-
-  // ------ Methods inherited from pp::deprecated::ScriptableObject:
-
-  // Returns true for preloaded NaCl Plugin properties.
-  // Does not set |exception|.
-  virtual bool HasProperty(const pp::Var& name, pp::Var* exception);
-  // Returns true for preloaded NaCl Plugin methods and SRPC methods exported
-  // from a NaCl module. Does not set |exception|.
-  virtual bool HasMethod(const pp::Var& name, pp::Var* exception);
-
-  // Gets the value of a preloaded NaCl Plugin property.
-  // Sets |exception| on failure.
-  virtual pp::Var GetProperty(const pp::Var& name, pp::Var* exception);
-  // Sets the value of a preloaded NaCl Plugin property.
-  // Does not add new properties. Sets |exception| of failure.
-  virtual void SetProperty(const pp::Var& name, const pp::Var& value,
-                           pp::Var* exception);
-  // Set |exception| to indicate that property removal is not supported.
-  virtual void RemoveProperty(const pp::Var& name, pp::Var* exception);
-  // Returns a list of all preloaded NaCl Plugin |properties|.
-  // Does not set |exception|.
-  virtual void GetAllPropertyNames(std::vector<pp::Var>* properties,
-                                   pp::Var* exception);
-
-  // Calls preloaded NaCl Plugin methods or SRPC methods exported from
-  // a NaCl module. Sets |exception| on failure.
-  virtual pp::Var Call(const pp::Var& name, const std::vector<pp::Var>& args,
-                       pp::Var* exception);
-
-  // Sets |exception| to indicate that constructor is not supported.
-  virtual pp::Var Construct(const std::vector<pp::Var>& args,
-                            pp::Var* exception);
-
- private:
-  NACL_DISALLOW_COPY_AND_ASSIGN(ScriptableHandle);
-  // Prevent construction from outside the class: must use factory New()
-  // method instead.
-  explicit ScriptableHandle(Plugin* plugin);
-  explicit ScriptableHandle(DescBasedHandle* desc_handle);
-  // This will be called when both the plugin and the browser clear all
-  // references to this object.
-  virtual ~ScriptableHandle();
-
-  // When we pass the object owned by the plugin to the browser, we need to wrap
-  // it in a pp::VarPrivate, which also registers the object with the browser
-  // for refcounting. It must be registered only once with all other var
-  // references being copies of the original one. Thus, we record the
-  // pp::VarPrivate here and reuse it when satisfiying additional browser
-  // requests. This way we also ensure that when the browser clears its
-  // references, this object does not get deallocated while we still hold ours.
-  // This is never set for objects that are not shared with the browser nor for
-  // objects created during SRPC calls as they are taken over by the browser on
-  // return.
-  pp::VarPrivate* var_;
-
-  // We should have no more than one internal plugin owner for this object,
-  // and only that owner should call Unref(). To CHECK for that keep a counter.
-  int num_unref_calls_;
-
-  // The contained plugin object.
-  Plugin* plugin_;
-  // OBSOLETE -- this support is only needed for SRPC descriptor passing.
-  // TODO(polina): Remove this support when SRPC descriptor passing is removed.
-  // The contained descriptor handle object.
-  DescBasedHandle* desc_handle_;
-};
-
-}  // namespace plugin
-
-#endif  // NATIVE_CLIENT_SRC_TRUSTED_PLUGIN_SCRIPTABLE_HANDLE_H_