Valentin Shergin 4a8613f40f Fabric: UIManager's API for installing and uninstalling itself
Summary: UIManager now can install and uninstall itself calling a functions that are provided as constructor arguments.

Reviewed By: mdvacca

Differential Revision: D9931329

fbshipit-source-id: b8d2d9925b0e2db0fed44bdf2e185d198fabd5ee
2018-09-26 10:18:38 -07:00

97 lines
3.8 KiB
C++

/**
* Copyright (c) Facebook, Inc. and its 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 <memory>
#include <folly/dynamic.h>
#include <fabric/core/ShadowNode.h>
#include <fabric/uimanager/ComponentDescriptorRegistry.h>
#include <fabric/uimanager/UIManagerDelegate.h>
namespace facebook {
namespace react {
class FabricUIManager;
using UIManager = FabricUIManager;
/*
* Particular implementations of those functions should capture references to
* the runtime and ensure proper threading.
*/
using UIManagerInstaller = void (UIManager &uiManager);
using UIManagerUninstaller = void ();
using DispatchEventToEmptyTargetFunction = void (const EventHandler &eventHandler, const std::string &type, const folly::dynamic &payload);
using DispatchEventToTargetFunction = void (const EventHandler &eventHandler, const EventTarget &eventTarget, const std::string &type, const folly::dynamic &payload);
class FabricUIManager {
public:
FabricUIManager(std::function<UIManagerInstaller> installer, std::function<UIManagerUninstaller> uninstaller);
~FabricUIManager();
#pragma mark - Native-facing Interface
void setComponentDescriptorRegistry(const SharedComponentDescriptorRegistry &componentDescriptorRegistry);
/*
* Sets and gets the UIManager's delegate.
* The delegate is stored as a raw pointer, so the owner must null
* the pointer before being destroyed.
*/
void setDelegate(UIManagerDelegate *delegate);
UIManagerDelegate *getDelegate();
#pragma mark - Callback Functions
/*
* Registers callback functions.
*/
void setDispatchEventToEmptyTargetFunction(std::function<DispatchEventToEmptyTargetFunction> dispatchEventFunction);
void setDispatchEventToTargetFunction(std::function<DispatchEventToTargetFunction> dispatchEventFunction);
#pragma mark - Native-facing Interface
void dispatchEventToTarget(const EventTarget *eventTarget, const std::string &type, const folly::dynamic &payload) const;
#pragma mark - JavaScript/React-facing Interface
/*
* All those JavaScript-facing methods call be called from any thread.
* `UIManager` guarantees its own thread-safety, but it does *not* guarantee
* thread-safety of `ShadowNode`s that it operates on. The caller should
* enforce logical correctness and thread-safety of the unsealed `ShadowNode`s.
*/
SharedShadowNode createNode(Tag reactTag, std::string viewName, Tag rootTag, folly::dynamic props, SharedEventTarget eventTarget) const;
SharedShadowNode cloneNode(const SharedShadowNode &node) const;
SharedShadowNode cloneNodeWithNewChildren(const SharedShadowNode &node) const;
SharedShadowNode cloneNodeWithNewProps(const SharedShadowNode &node, folly::dynamic props) const;
SharedShadowNode cloneNodeWithNewChildrenAndProps(const SharedShadowNode &node, folly::dynamic newProps) const;
void appendChild(const SharedShadowNode &parentNode, const SharedShadowNode &childNode) const;
SharedShadowNodeUnsharedList createChildSet(Tag rootTag) const;
void appendChildToSet(const SharedShadowNodeUnsharedList &childSet, const SharedShadowNode &childNode) const;
void completeRoot(Tag rootTag, const SharedShadowNodeUnsharedList &childSet) const;
void registerEventHandler(UniqueEventHandler eventHandler) const;
private:
SharedComponentDescriptorRegistry componentDescriptorRegistry_;
UIManagerDelegate *delegate_;
mutable UniqueEventHandler eventHandler_;
std::function<DispatchEventToEmptyTargetFunction> dispatchEventToEmptyTargetFunction_;
std::function<DispatchEventToTargetFunction> dispatchEventToTargetFunction_;
std::function<UIManagerInstaller> installer_;
std::function<UIManagerUninstaller> uninstaller_;
};
} // namespace react
} // namespace facebook