// Copyright 2013 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 CONTENT_RENDERER_PEPPER_RESOURCE_CONVERTER_H
#define CONTENT_RENDERER_PEPPER_RESOURCE_CONVERTER_H
#include <vector>
#include "base/basictypes.h"
#include "base/callback.h"
#include "base/compiler_specific.h"
#include "base/memory/ref_counted.h"
#include "content/common/content_export.h"
#include "content/renderer/pepper/host_resource_var.h"
#include "ppapi/c/pp_instance.h"
#include "ppapi/c/pp_var.h"
#include "v8/include/v8.h"
namespace IPC {
class Message;
}
namespace ppapi {
class ScopedPPVar;
}
namespace content {
class RendererPpapiHost;
// This class is responsible for converting V8 vars to Pepper resources.
class CONTENT_EXPORT ResourceConverter {
public:
virtual ~ResourceConverter();
// Flush() must be called before any vars created by the ResourceConverter
// are valid. It handles creating any resource hosts that need to be created.
virtual void Flush(const base::Callback<void(bool)>& callback) = 0;
// Attempts to convert a V8 object to a PP_Var with type PP_VARTYPE_RESOURCE.
// On success, writes the resulting var to |result|, sets |was_resource| to
// true and returns true. If |val| is not a resource, sets |was_resource| to
// false and returns true. If an error occurs, returns false.
virtual bool FromV8Value(v8::Handle<v8::Object> val,
v8::Handle<v8::Context> context,
PP_Var* result,
bool* was_resource) = 0;
// Attempts to convert a PP_Var to a V8 object. |var| must have type
// PP_VARTYPE_RESOURCE. On success, writes the resulting value to |result| and
// returns true. If an error occurs, returns false.
virtual bool ToV8Value(const PP_Var& var,
v8::Handle<v8::Context> context,
v8::Handle<v8::Value>* result) = 0;
};
class ResourceConverterImpl : public ResourceConverter {
public:
ResourceConverterImpl(PP_Instance instance, RendererPpapiHost* host);
virtual ~ResourceConverterImpl();
// ResourceConverter overrides.
virtual void Flush(const base::Callback<void(bool)>& callback) OVERRIDE;
virtual bool FromV8Value(v8::Handle<v8::Object> val,
v8::Handle<v8::Context> context,
PP_Var* result,
bool* was_resource) OVERRIDE;
virtual bool ToV8Value(const PP_Var& var,
v8::Handle<v8::Context> context,
v8::Handle<v8::Value>* result) OVERRIDE;
private:
// Creates a resource var with the given |pending_renderer_id| and
// |create_message| to be sent to the plugin.
scoped_refptr<HostResourceVar> CreateResourceVar(
int pending_renderer_id,
const IPC::Message& create_message);
// Creates a resource var with the given |pending_renderer_id| and
// |create_message| to be sent to the plugin. Also sends
// |browser_host_create_message| to the browser, and asynchronously stores the
// resulting browser host ID in the newly created var.
scoped_refptr<HostResourceVar> CreateResourceVarWithBrowserHost(
int pending_renderer_id,
const IPC::Message& create_message,
const IPC::Message& browser_host_create_message);
// The instance this ResourceConverter is associated with.
PP_Instance instance_;
// The RendererPpapiHost to use to create browser hosts.
RendererPpapiHost* host_;
// A list of the messages to create the browser hosts. This is a parallel
// array to |browser_vars|. It is kept as a parallel array so that it can be
// conveniently passed to |CreateBrowserResourceHosts|.
std::vector<IPC::Message> browser_host_create_messages_;
// A list of the resource vars associated with browser hosts.
std::vector<scoped_refptr<HostResourceVar> > browser_vars;
DISALLOW_COPY_AND_ASSIGN(ResourceConverterImpl);
};
} // namespace content
#endif // CONTENT_RENDERER_PEPPER_RESOURCE_CONVERTER_H