blob: ff97fdb2b6c379178ad9f5a2267e91e084f97d29 [file] [log] [blame]
// Copyright (c) 2012 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.
#include <jni.h>
#include <map>
#include <string>
#include "base/android/jni_helper.h"
#include "base/android/scoped_java_ref.h"
#include "base/memory/linked_ptr.h"
#include "base/memory/weak_ptr.h"
#include "content/browser/renderer_host/java/java_method.h"
#include "third_party/npapi/bindings/npruntime.h"
namespace content {
class JavaBridgeDispatcherHostManager;
// Wrapper around a Java object.
// Represents a Java object for use in the Java bridge. Holds a global ref to
// the Java object and provides the ability to invoke methods on it.
// Interrogation of the Java object for its methods is done lazily. This class
// is not generally threadsafe. However, it does allow for instances to be
// created and destroyed on different threads.
class JavaBoundObject {
// Takes a Java object and creates a JavaBoundObject around it. The
// |require_annotation| flag specifies whether or not only methods with the
// JavascriptInterface annotation are exposed to JavaScript. This property
// propagates to all Objects that get implicitly exposed as return values as
// well. Returns an NPObject with a ref count of one which owns the
// JavaBoundObject.
// See also comment below for |manager_|.
static NPObject* Create(
const base::android::JavaRef<jobject>& object,
const base::android::JavaRef<jclass>& safe_annotation_clazz,
const base::WeakPtr<JavaBridgeDispatcherHostManager>& manager);
virtual ~JavaBoundObject();
// Gets a local ref to the underlying JavaObject from a JavaBoundObject
// wrapped as an NPObject. May return null if the underlying object has
// been garbage collected.
static base::android::ScopedJavaLocalRef<jobject> GetJavaObject(
NPObject* object);
// Methods to implement the NPObject callbacks.
bool HasMethod(const std::string& name) const;
bool Invoke(const std::string& name, const NPVariant* args, size_t arg_count,
NPVariant* result);
explicit JavaBoundObject(
const base::android::JavaRef<jobject>& object,
const base::android::JavaRef<jclass>& safe_annotation_clazz,
const base::WeakPtr<JavaBridgeDispatcherHostManager>& manager_);
void EnsureMethodsAreSetUp() const;
// The weak ref to the underlying Java object that this JavaBoundObject
// instance represents.
JavaObjectWeakGlobalRef java_object_;
// Keep a pointer back to the JavaBridgeDispatcherHostManager so that we
// can notify it when this JavaBoundObject is destroyed. JavaBoundObjects
// may outlive the manager so keep a WeakPtr. Note the WeakPtr may only be
// dereferenced on the UI thread.
base::WeakPtr<JavaBridgeDispatcherHostManager> manager_;
// Map of public methods, from method name to Method instance. Multiple
// entries will be present for overloaded methods. Note that we can't use
// scoped_ptr in STL containers as we can't copy it.
typedef std::multimap<std::string, linked_ptr<JavaMethod> > JavaMethodMap;
mutable JavaMethodMap methods_;
mutable bool are_methods_set_up_;
base::android::ScopedJavaGlobalRef<jclass> safe_annotation_clazz_;
} // namespace content