Summary: For C++, folly::dynamic is used throughout. On iOS and Android though, Flipper goes through multiple conversions to get to a folly::dynamic only to ultimately obtain a JSON string from it. Let's take a look at Android: There are multiple types like FlipperObject, FlipperArray that wrap around a JSONObject. When data needs to be sent: 1. The JSONObject is asked for its string representation. 2. The string representation is then parsed by folly to construct the folly::dynamic instance. 3. The step above involves an extra boundary cross through JNI. 4. Ultimately, a socket or ws connection does not understand folly::dynamic so we then get a JSON string representation from it. 5. Data is sent. As described above, for big enough objects, this represents an issue. So, the idea of this change, is to allow plugins to send a JSON string instead. This will remove a few serialisation/deserialisation steps from the process. *Note: this API is not currently used by anything so there's no impact to existing plugins.* Changelog: expose a send method that accept a string as params Reviewed By: LukeDefeo Differential Revision: D38741582 fbshipit-source-id: 78e0acd80fc8c97378ee986cbaf377078996ed60
61 lines
1.5 KiB
C++
61 lines
1.5 KiB
C++
/*
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <folly/json.h>
|
|
#include <functional>
|
|
#include <string>
|
|
#include "FlipperResponder.h"
|
|
|
|
namespace facebook {
|
|
namespace flipper {
|
|
|
|
/**
|
|
Represents a connection between the Desktop and mobile plugins
|
|
with corresponding identifiers.
|
|
*/
|
|
class FlipperConnection {
|
|
public:
|
|
using FlipperReceiver = std::function<
|
|
void(const folly::dynamic&, std::shared_ptr<FlipperResponder>)>;
|
|
|
|
virtual ~FlipperConnection() {}
|
|
|
|
/**
|
|
Invoke a method on the Flipper desktop plugin with a matching identifier.
|
|
*/
|
|
virtual void send(
|
|
const std::string& method,
|
|
const folly::dynamic& params) = 0;
|
|
|
|
/**
|
|
Invoke a method on the Flipper desktop plugin with a matching
|
|
identifier.
|
|
Note: The `message` argument is expected to contain a valid JSON.
|
|
*/
|
|
virtual void send(const std::string& method, const std::string& params) = 0;
|
|
|
|
/**
|
|
Report an error to the Flipper desktop app
|
|
*/
|
|
virtual void error(
|
|
const std::string& message,
|
|
const std::string& stacktrace) = 0;
|
|
|
|
/**
|
|
Register a receiver to be notified of incoming calls of the given
|
|
method from the Flipper desktop plugin with a matching identifier.
|
|
*/
|
|
virtual void receive(
|
|
const std::string& method,
|
|
const FlipperReceiver& receiver) = 0;
|
|
};
|
|
|
|
} // namespace flipper
|
|
} // namespace facebook
|