// Copyright 2015 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 IPC_IPC_MESSAGE_TEMPLATES_H_ #define IPC_IPC_MESSAGE_TEMPLATES_H_ #include #include #include #include "base/logging.h" #include "base/tuple.h" #include "build/build_config.h" #include "ipc/ipc_message.h" #include "ipc/ipc_message_utils.h" namespace IPC { // This function is for all the async IPCs that don't pass an extra parameter // using IPC_BEGIN_MESSAGE_MAP_WITH_PARAM. template void DispatchToMethod(ObjT* obj, Method method, P*, const Tuple& tuple) { base::DispatchToMethod(obj, method, tuple); } template void DispatchToMethodImpl(ObjT* obj, Method method, P* parameter, const Tuple& tuple, base::IndexSequence) { // TODO(mdempsky): Apply UnwrapTraits like base::DispatchToMethod? (obj->*method)(parameter, std::get(tuple)...); } // The following function is for async IPCs which have a dispatcher with an // extra parameter specified using IPC_BEGIN_MESSAGE_MAP_WITH_PARAM. template typename std::enable_if::type DispatchToMethod(ObjT* obj, void (ObjT::*method)(P*, Args...), P* parameter, const std::tuple& tuple) { DispatchToMethodImpl(obj, method, parameter, tuple, base::MakeIndexSequence()); } enum class MessageKind { CONTROL, ROUTED, }; // Routing is a helper struct so MessageT's private common constructor has a // different type signature than the public "int32_t routing_id" one. struct Routing { explicit Routing(int32_t id) : id(id) {} int32_t id; }; // We want to restrict MessageT's constructors so that a routing_id is always // provided for ROUTED messages and never provided for CONTROL messages, so // use the SFINAE technique from N4387's "Implementation Hint" section. #if defined(COMPILER_MSVC) // MSVC 2013 doesn't support default arguments for template member functions // of templated classes, so there we have to rely on the DCHECKs instead. // TODO(mdempsky): Reevaluate once MSVC 2015. #define IPC_MESSAGET_SFINAE(x) #else #define IPC_MESSAGET_SFINAE(x) \ template ::type = false> #endif // MessageT is the common template used for all user-defined message types. // It's intended to be used via the macros defined in ipc_message_macros.h. template class MessageT; // Asynchronous message partial specialization. template class MessageT, void> : public Message { public: using Param = std::tuple; enum { ID = Meta::ID }; // TODO(mdempsky): Remove. Uses of MyMessage::Schema::Param can be replaced // with just MyMessage::Param. using Schema = MessageT; IPC_MESSAGET_SFINAE(Meta::kKind == MessageKind::CONTROL) MessageT(const Ins&... ins) : MessageT(Routing(MSG_ROUTING_CONTROL), ins...) { DCHECK(Meta::kKind == MessageKind::CONTROL) << Meta::kName; } IPC_MESSAGET_SFINAE(Meta::kKind == MessageKind::ROUTED) MessageT(int32_t routing_id, const Ins&... ins) : MessageT(Routing(routing_id), ins...) { DCHECK(Meta::kKind == MessageKind::ROUTED) << Meta::kName; } static bool Read(const Message* msg, Param* p); static void Log(std::string* name, const Message* msg, std::string* l); template static bool Dispatch(const Message* msg, T* obj, S* sender, P* parameter, Method func) { Param p; if (Read(msg, &p)) { DispatchToMethod(obj, func, parameter, p); return true; } return false; } private: MessageT(Routing routing, const Ins&... ins); }; // Synchronous message partial specialization. template class MessageT, std::tuple> : public SyncMessage { public: using SendParam = std::tuple; using ReplyParam = std::tuple; enum { ID = Meta::ID }; // TODO(mdempsky): Remove. Uses of MyMessage::Schema::{Send,Reply}Param can // be replaced with just MyMessage::{Send,Reply}Param. using Schema = MessageT; IPC_MESSAGET_SFINAE(Meta::kKind == MessageKind::CONTROL) MessageT(const Ins&... ins, Outs*... outs) : MessageT(Routing(MSG_ROUTING_CONTROL), ins..., outs...) { DCHECK(Meta::kKind == MessageKind::CONTROL) << Meta::kName; } IPC_MESSAGET_SFINAE(Meta::kKind == MessageKind::ROUTED) MessageT(int32_t routing_id, const Ins&... ins, Outs*... outs) : MessageT(Routing(routing_id), ins..., outs...) { DCHECK(Meta::kKind == MessageKind::ROUTED) << Meta::kName; } static bool ReadSendParam(const Message* msg, SendParam* p); static bool ReadReplyParam(const Message* msg, ReplyParam* p); static void WriteReplyParams(Message* reply, const Outs&... outs); static void Log(std::string* name, const Message* msg, std::string* l); template static bool Dispatch(const Message* msg, T* obj, S* sender, P* parameter, Method func) { SendParam send_params; bool ok = ReadSendParam(msg, &send_params); Message* reply = SyncMessage::GenerateReply(msg); if (ok) { ReplyParam reply_params; base::DispatchToMethod(obj, func, send_params, &reply_params); WriteParam(reply, reply_params); LogReplyParamsToMessage(reply_params, msg); } else { NOTREACHED() << "Error deserializing message " << msg->type(); reply->set_reply_error(); } sender->Send(reply); return ok; } template static bool DispatchDelayReply(const Message* msg, T* obj, P* parameter, Method func) { SendParam send_params; bool ok = ReadSendParam(msg, &send_params); Message* reply = SyncMessage::GenerateReply(msg); if (ok) { std::tuple t = std::tie(*reply); ConnectMessageAndReply(msg, reply); base::DispatchToMethod(obj, func, send_params, &t); } else { NOTREACHED() << "Error deserializing message " << msg->type(); reply->set_reply_error(); obj->Send(reply); } return ok; } private: MessageT(Routing routing, const Ins&... ins, Outs*... outs); }; } // namespace IPC #if defined(IPC_MESSAGE_IMPL) #include "ipc/ipc_message_templates_impl.h" #endif #endif // IPC_IPC_MESSAGE_TEMPLATES_H_