// 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 "ppapi/proxy/ppapi_proxy_test.h"
#include <sstream>
#include "base/bind.h"
#include "base/bind_helpers.h"
#include "base/message_loop/message_loop_proxy.h"
#include "base/observer_list.h"
#include "base/run_loop.h"
#include "ipc/ipc_sync_channel.h"
#include "ppapi/c/pp_errors.h"
#include "ppapi/c/private/ppb_proxy_private.h"
#include "ppapi/proxy/ppapi_messages.h"
#include "ppapi/proxy/ppb_message_loop_proxy.h"
#include "ppapi/shared_impl/proxy_lock.h"
namespace ppapi {
namespace proxy {
namespace {
// HostDispatcher requires a PPB_Proxy_Private, so we always provide a fallback
// do-nothing implementation.
void PluginCrashed(PP_Module module) {
NOTREACHED();
};
PP_Instance GetInstanceForResource(PP_Resource resource) {
// If a test relies on this, we need to implement it.
NOTREACHED();
return 0;
}
void SetReserveInstanceIDCallback(PP_Module module,
PP_Bool (*is_seen)(PP_Module, PP_Instance)) {
// This function gets called in HostDispatcher's constructor. We simply don't
// worry about Instance uniqueness in tests, so we can ignore the call.
}
void AddRefModule(PP_Module module) {}
void ReleaseModule(PP_Module module) {}
PP_Bool IsInModuleDestructor(PP_Module module) { return PP_FALSE; }
PPB_Proxy_Private ppb_proxy_private = {
&PluginCrashed,
&GetInstanceForResource,
&SetReserveInstanceIDCallback,
&AddRefModule,
&ReleaseModule,
&IsInModuleDestructor
};
// We allow multiple harnesses at a time to respond to 'GetInterface' calls.
// We assume that only 1 harness's GetInterface function will ever support a
// given interface name. In practice, there will either be only 1 GetInterface
// handler (for PluginProxyTest or HostProxyTest), or there will be only 2
// GetInterface handlers (for TwoWayTest). In the latter case, one handler is
// for the PluginProxyTestHarness and should only respond for PPP interfaces,
// and the other handler is for the HostProxyTestHarness which should only
// ever respond for PPB interfaces.
ObserverList<ProxyTestHarnessBase> get_interface_handlers_;
const void* MockGetInterface(const char* name) {
ObserverList<ProxyTestHarnessBase>::Iterator it =
get_interface_handlers_;
while (ProxyTestHarnessBase* observer = it.GetNext()) {
const void* interface = observer->GetInterface(name);
if (interface)
return interface;
}
if (strcmp(name, PPB_PROXY_PRIVATE_INTERFACE) == 0)
return &ppb_proxy_private;
return NULL;
}
void SetUpRemoteHarness(ProxyTestHarnessBase* harness,
const IPC::ChannelHandle& handle,
base::MessageLoopProxy* ipc_message_loop_proxy,
base::WaitableEvent* shutdown_event,
base::WaitableEvent* harness_set_up) {
harness->SetUpHarnessWithChannel(handle, ipc_message_loop_proxy,
shutdown_event, false);
harness_set_up->Signal();
}
void TearDownRemoteHarness(ProxyTestHarnessBase* harness,
base::WaitableEvent* harness_torn_down) {
harness->TearDownHarness();
harness_torn_down->Signal();
}
void RunTaskOnRemoteHarness(const base::Closure& task,
base::WaitableEvent* task_complete) {
task.Run();
task_complete->Signal();
}
} // namespace
// ProxyTestHarnessBase --------------------------------------------------------
ProxyTestHarnessBase::ProxyTestHarnessBase() : pp_module_(0x98765),
pp_instance_(0x12345) {
get_interface_handlers_.AddObserver(this);
}
ProxyTestHarnessBase::~ProxyTestHarnessBase() {
get_interface_handlers_.RemoveObserver(this);
}
const void* ProxyTestHarnessBase::GetInterface(const char* name) {
return registered_interfaces_[name];
}
void ProxyTestHarnessBase::RegisterTestInterface(const char* name,
const void* test_interface) {
registered_interfaces_[name] = test_interface;
}
bool ProxyTestHarnessBase::SupportsInterface(const char* name) {
sink().ClearMessages();
// IPC doesn't actually write to this when we send a message manually
// not actually using IPC.
bool unused_result = false;
PpapiMsg_SupportsInterface msg(name, &unused_result);
GetDispatcher()->OnMessageReceived(msg);
const IPC::Message* reply_msg =
sink().GetUniqueMessageMatching(IPC_REPLY_ID);
EXPECT_TRUE(reply_msg);
if (!reply_msg)
return false;
TupleTypes<PpapiMsg_SupportsInterface::ReplyParam>::ValueTuple reply_data;
EXPECT_TRUE(PpapiMsg_SupportsInterface::ReadReplyParam(
reply_msg, &reply_data));
sink().ClearMessages();
return reply_data.a;
}
// PluginProxyTestHarness ------------------------------------------------------
PluginProxyTestHarness::PluginProxyTestHarness(
GlobalsConfiguration globals_config)
: globals_config_(globals_config) {
}
PluginProxyTestHarness::~PluginProxyTestHarness() {
}
PpapiGlobals* PluginProxyTestHarness::GetGlobals() {
return plugin_globals_.get();
}
Dispatcher* PluginProxyTestHarness::GetDispatcher() {
return plugin_dispatcher_.get();
}
void PluginProxyTestHarness::SetUpHarness() {
// These must be first since the dispatcher set-up uses them.
CreatePluginGlobals();
// Some of the methods called during set-up check that the lock is held.
ProxyAutoLock lock;
resource_tracker().DidCreateInstance(pp_instance());
plugin_dispatcher_.reset(new PluginDispatcher(
&MockGetInterface,
PpapiPermissions(),
false));
plugin_dispatcher_->InitWithTestSink(&sink());
// The plugin proxy delegate is needed for
// |PluginProxyDelegate::GetBrowserSender| which is used
// in |ResourceCreationProxy::GetConnection| to get the channel to the
// browser. In this case we just use the |plugin_dispatcher_| as the channel
// for test purposes.
plugin_delegate_mock_.set_browser_sender(plugin_dispatcher_.get());
PluginGlobals::Get()->set_plugin_proxy_delegate(&plugin_delegate_mock_);
plugin_dispatcher_->DidCreateInstance(pp_instance());
}
void PluginProxyTestHarness::SetUpHarnessWithChannel(
const IPC::ChannelHandle& channel_handle,
base::MessageLoopProxy* ipc_message_loop,
base::WaitableEvent* shutdown_event,
bool is_client) {
// These must be first since the dispatcher set-up uses them.
CreatePluginGlobals();
// Some of the methods called during set-up check that the lock is held.
ProxyAutoLock lock;
resource_tracker().DidCreateInstance(pp_instance());
plugin_delegate_mock_.Init(ipc_message_loop, shutdown_event);
plugin_dispatcher_.reset(new PluginDispatcher(
&MockGetInterface,
PpapiPermissions(),
false));
plugin_dispatcher_->InitPluginWithChannel(&plugin_delegate_mock_,
base::kNullProcessId,
channel_handle,
is_client);
plugin_delegate_mock_.set_browser_sender(plugin_dispatcher_.get());
PluginGlobals::Get()->set_plugin_proxy_delegate(&plugin_delegate_mock_);
plugin_dispatcher_->DidCreateInstance(pp_instance());
}
void PluginProxyTestHarness::TearDownHarness() {
{
// Some of the methods called during tear-down check that the lock is held.
ProxyAutoLock lock;
plugin_dispatcher_->DidDestroyInstance(pp_instance());
plugin_dispatcher_.reset();
resource_tracker().DidDeleteInstance(pp_instance());
}
plugin_globals_.reset();
}
void PluginProxyTestHarness::CreatePluginGlobals() {
if (globals_config_ == PER_THREAD_GLOBALS) {
plugin_globals_.reset(new PluginGlobals(PpapiGlobals::PerThreadForTest()));
PpapiGlobals::SetPpapiGlobalsOnThreadForTest(GetGlobals());
// Enable locking in case some other unit test ran before us and disabled
// locking.
ProxyLock::EnableLockingOnThreadForTest();
} else {
plugin_globals_.reset(new PluginGlobals());
ProxyLock::EnableLockingOnThreadForTest();
}
}
base::MessageLoopProxy*
PluginProxyTestHarness::PluginDelegateMock::GetIPCMessageLoop() {
return ipc_message_loop_;
}
base::WaitableEvent*
PluginProxyTestHarness::PluginDelegateMock::GetShutdownEvent() {
return shutdown_event_;
}
IPC::PlatformFileForTransit
PluginProxyTestHarness::PluginDelegateMock::ShareHandleWithRemote(
base::PlatformFile handle,
base::ProcessId /* remote_pid */,
bool should_close_source) {
return IPC::GetFileHandleForProcess(handle,
base::Process::Current().handle(),
should_close_source);
}
std::set<PP_Instance>*
PluginProxyTestHarness::PluginDelegateMock::GetGloballySeenInstanceIDSet() {
return &instance_id_set_;
}
uint32 PluginProxyTestHarness::PluginDelegateMock::Register(
PluginDispatcher* plugin_dispatcher) {
return 0;
}
void PluginProxyTestHarness::PluginDelegateMock::Unregister(
uint32 plugin_dispatcher_id) {
}
IPC::Sender* PluginProxyTestHarness::PluginDelegateMock::GetBrowserSender() {
return browser_sender_;
}
std::string PluginProxyTestHarness::PluginDelegateMock::GetUILanguage() {
return std::string("en-US");
}
void PluginProxyTestHarness::PluginDelegateMock::PreCacheFont(
const void* logfontw) {
}
void PluginProxyTestHarness::PluginDelegateMock::SetActiveURL(
const std::string& url) {
}
PP_Resource PluginProxyTestHarness::PluginDelegateMock::CreateBrowserFont(
Connection connection,
PP_Instance instance,
const PP_BrowserFont_Trusted_Description& desc,
const Preferences& prefs) {
return 0;
}
// PluginProxyTest -------------------------------------------------------------
PluginProxyTest::PluginProxyTest() : PluginProxyTestHarness(SINGLETON_GLOBALS) {
}
PluginProxyTest::~PluginProxyTest() {
}
void PluginProxyTest::SetUp() {
SetUpHarness();
}
void PluginProxyTest::TearDown() {
TearDownHarness();
}
// PluginProxyMultiThreadTest --------------------------------------------------
PluginProxyMultiThreadTest::PluginProxyMultiThreadTest() {
}
PluginProxyMultiThreadTest::~PluginProxyMultiThreadTest() {
}
void PluginProxyMultiThreadTest::RunTest() {
main_thread_message_loop_proxy_ =
PpapiGlobals::Get()->GetMainThreadMessageLoop();
ASSERT_EQ(main_thread_message_loop_proxy_.get(),
base::MessageLoopProxy::current());
nested_main_thread_message_loop_.reset(new base::RunLoop());
secondary_thread_.reset(new base::DelegateSimpleThread(
this, "PluginProxyMultiThreadTest"));
{
ProxyAutoLock auto_lock;
// MessageLoopResource assumes that the proxy lock has been acquired.
secondary_thread_message_loop_ = new MessageLoopResource(pp_instance());
ASSERT_EQ(PP_OK,
secondary_thread_message_loop_->PostWork(
PP_MakeCompletionCallback(
&PluginProxyMultiThreadTest::InternalSetUpTestOnSecondaryThread,
this),
0));
}
SetUpTestOnMainThread();
secondary_thread_->Start();
nested_main_thread_message_loop_->Run();
secondary_thread_->Join();
{
ProxyAutoLock auto_lock;
// The destruction requires a valid PpapiGlobals instance, so we should
// explicitly release it.
secondary_thread_message_loop_ = NULL;
}
secondary_thread_.reset(NULL);
nested_main_thread_message_loop_.reset(NULL);
main_thread_message_loop_proxy_ = NULL;
}
void PluginProxyMultiThreadTest::CheckOnThread(ThreadType thread_type) {
ProxyAutoLock auto_lock;
if (thread_type == MAIN_THREAD) {
ASSERT_TRUE(MessageLoopResource::GetCurrent()->is_main_thread_loop());
} else {
ASSERT_EQ(secondary_thread_message_loop_.get(),
MessageLoopResource::GetCurrent());
}
}
void PluginProxyMultiThreadTest::PostQuitForMainThread() {
main_thread_message_loop_proxy_->PostTask(
FROM_HERE,
base::Bind(&PluginProxyMultiThreadTest::QuitNestedLoop,
base::Unretained(this)));
}
void PluginProxyMultiThreadTest::PostQuitForSecondaryThread() {
ProxyAutoLock auto_lock;
secondary_thread_message_loop_->PostQuit(PP_TRUE);
}
void PluginProxyMultiThreadTest::Run() {
ProxyAutoLock auto_lock;
ASSERT_EQ(PP_OK, secondary_thread_message_loop_->AttachToCurrentThread());
ASSERT_EQ(PP_OK, secondary_thread_message_loop_->Run());
secondary_thread_message_loop_->DetachFromThread();
}
void PluginProxyMultiThreadTest::QuitNestedLoop() {
nested_main_thread_message_loop_->Quit();
}
// static
void PluginProxyMultiThreadTest::InternalSetUpTestOnSecondaryThread(
void* user_data,
int32_t result) {
EXPECT_EQ(PP_OK, result);
PluginProxyMultiThreadTest* thiz =
static_cast<PluginProxyMultiThreadTest*>(user_data);
thiz->CheckOnThread(SECONDARY_THREAD);
thiz->SetUpTestOnSecondaryThread();
}
// HostProxyTestHarness --------------------------------------------------------
class HostProxyTestHarness::MockSyncMessageStatusReceiver
: public HostDispatcher::SyncMessageStatusReceiver {
public:
virtual void BeginBlockOnSyncMessage() OVERRIDE {}
virtual void EndBlockOnSyncMessage() OVERRIDE {}
};
HostProxyTestHarness::HostProxyTestHarness(GlobalsConfiguration globals_config)
: globals_config_(globals_config),
status_receiver_(new MockSyncMessageStatusReceiver) {
}
HostProxyTestHarness::~HostProxyTestHarness() {
}
PpapiGlobals* HostProxyTestHarness::GetGlobals() {
return host_globals_.get();
}
Dispatcher* HostProxyTestHarness::GetDispatcher() {
return host_dispatcher_.get();
}
void HostProxyTestHarness::SetUpHarness() {
// These must be first since the dispatcher set-up uses them.
CreateHostGlobals();
host_dispatcher_.reset(new HostDispatcher(
pp_module(),
&MockGetInterface,
status_receiver_.release(),
PpapiPermissions::AllPermissions()));
host_dispatcher_->InitWithTestSink(&sink());
HostDispatcher::SetForInstance(pp_instance(), host_dispatcher_.get());
}
void HostProxyTestHarness::SetUpHarnessWithChannel(
const IPC::ChannelHandle& channel_handle,
base::MessageLoopProxy* ipc_message_loop,
base::WaitableEvent* shutdown_event,
bool is_client) {
// These must be first since the dispatcher set-up uses them.
CreateHostGlobals();
delegate_mock_.Init(ipc_message_loop, shutdown_event);
host_dispatcher_.reset(new HostDispatcher(
pp_module(),
&MockGetInterface,
status_receiver_.release(),
PpapiPermissions::AllPermissions()));
ppapi::Preferences preferences;
host_dispatcher_->InitHostWithChannel(&delegate_mock_,
base::kNullProcessId, channel_handle,
is_client, preferences);
HostDispatcher::SetForInstance(pp_instance(), host_dispatcher_.get());
}
void HostProxyTestHarness::TearDownHarness() {
HostDispatcher::RemoveForInstance(pp_instance());
host_dispatcher_.reset();
host_globals_.reset();
}
void HostProxyTestHarness::CreateHostGlobals() {
if (globals_config_ == PER_THREAD_GLOBALS) {
host_globals_.reset(new TestGlobals(PpapiGlobals::PerThreadForTest()));
PpapiGlobals::SetPpapiGlobalsOnThreadForTest(GetGlobals());
// The host side of the proxy does not lock.
ProxyLock::DisableLockingOnThreadForTest();
} else {
ProxyLock::DisableLockingOnThreadForTest();
host_globals_.reset(new TestGlobals());
}
}
base::MessageLoopProxy*
HostProxyTestHarness::DelegateMock::GetIPCMessageLoop() {
return ipc_message_loop_;
}
base::WaitableEvent* HostProxyTestHarness::DelegateMock::GetShutdownEvent() {
return shutdown_event_;
}
IPC::PlatformFileForTransit
HostProxyTestHarness::DelegateMock::ShareHandleWithRemote(
base::PlatformFile handle,
base::ProcessId /* remote_pid */,
bool should_close_source) {
return IPC::GetFileHandleForProcess(handle,
base::Process::Current().handle(),
should_close_source);
}
// HostProxyTest ---------------------------------------------------------------
HostProxyTest::HostProxyTest() : HostProxyTestHarness(SINGLETON_GLOBALS) {
}
HostProxyTest::~HostProxyTest() {
}
void HostProxyTest::SetUp() {
SetUpHarness();
}
void HostProxyTest::TearDown() {
TearDownHarness();
}
// TwoWayTest ---------------------------------------------------------------
TwoWayTest::TwoWayTest(TwoWayTest::TwoWayTestMode test_mode)
: test_mode_(test_mode),
host_(ProxyTestHarnessBase::PER_THREAD_GLOBALS),
plugin_(ProxyTestHarnessBase::PER_THREAD_GLOBALS),
io_thread_("TwoWayTest_IOThread"),
plugin_thread_("TwoWayTest_PluginThread"),
remote_harness_(NULL),
local_harness_(NULL),
channel_created_(true, false),
shutdown_event_(true, false) {
if (test_mode == TEST_PPP_INTERFACE) {
remote_harness_ = &plugin_;
local_harness_ = &host_;
} else {
remote_harness_ = &host_;
local_harness_ = &plugin_;
}
}
TwoWayTest::~TwoWayTest() {
shutdown_event_.Signal();
}
void TwoWayTest::SetUp() {
base::Thread::Options options;
options.message_loop_type = base::MessageLoop::TYPE_IO;
io_thread_.StartWithOptions(options);
plugin_thread_.Start();
// Construct the IPC handle name using the process ID so we can safely run
// multiple |TwoWayTest|s concurrently.
std::ostringstream handle_name;
handle_name << "TwoWayTestChannel" << base::GetCurrentProcId();
IPC::ChannelHandle handle(handle_name.str());
base::WaitableEvent remote_harness_set_up(true, false);
plugin_thread_.message_loop_proxy()->PostTask(
FROM_HERE,
base::Bind(&SetUpRemoteHarness,
remote_harness_,
handle,
io_thread_.message_loop_proxy(),
&shutdown_event_,
&remote_harness_set_up));
remote_harness_set_up.Wait();
local_harness_->SetUpHarnessWithChannel(handle,
io_thread_.message_loop_proxy().get(),
&shutdown_event_,
true); // is_client
}
void TwoWayTest::TearDown() {
base::WaitableEvent remote_harness_torn_down(true, false);
plugin_thread_.message_loop_proxy()->PostTask(
FROM_HERE,
base::Bind(&TearDownRemoteHarness,
remote_harness_,
&remote_harness_torn_down));
remote_harness_torn_down.Wait();
local_harness_->TearDownHarness();
io_thread_.Stop();
}
void TwoWayTest::PostTaskOnRemoteHarness(const base::Closure& task) {
base::WaitableEvent task_complete(true, false);
plugin_thread_.message_loop_proxy()->PostTask(FROM_HERE,
base::Bind(&RunTaskOnRemoteHarness,
task,
&task_complete));
task_complete.Wait();
}
} // namespace proxy
} // namespace ppapi