123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475 |
- /*
- * 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.
- */
- #import <Foundation/Foundation.h>
- #import <React/RCTDefines.h>
- #if RCT_DEV
- NS_ASSUME_NONNULL_BEGIN
- @protocol RCTPackagerClientMethod;
- @class RCTPackagerClientResponder;
- typedef uint32_t RCTHandlerToken;
- typedef void (^RCTNotificationHandler)(NSDictionary<NSString *, id> *);
- typedef void (^RCTRequestHandler)(NSDictionary<NSString *, id> *, RCTPackagerClientResponder *);
- typedef void (^RCTConnectedHandler)(void);
- /** Encapsulates singleton connection to React Native packager. */
- @interface RCTPackagerConnection : NSObject
- + (instancetype)sharedPackagerConnection;
- /**
- * Registers a handler for a notification broadcast from the packager. An
- * example is "reload" - an instruction to reload from the packager.
- * If multiple notification handlers are registered for the same method, they
- * will all be invoked sequentially.
- */
- - (RCTHandlerToken)addNotificationHandler:(RCTNotificationHandler)handler
- queue:(dispatch_queue_t)queue
- forMethod:(NSString *)method;
- /**
- * Registers a handler for a request from the packager. An example is
- * pokeSamplingProfiler; it asks for profile data from the client.
- * Only one handler can be registered for a given method; calling this
- * displaces any previous request handler registered for that method.
- */
- - (RCTHandlerToken)addRequestHandler:(RCTRequestHandler)handler
- queue:(dispatch_queue_t)queue
- forMethod:(NSString *)method;
- /**
- * Registers a handler that runs at most once, when the connection to the
- * packager has been established. The handler will be dispatched immediately
- * if the connection is already established.
- */
- - (RCTHandlerToken)addConnectedHandler:(RCTConnectedHandler)handler queue:(dispatch_queue_t)queue;
- /** Removes a handler. Silently does nothing if the token is not valid. */
- - (void)removeHandler:(RCTHandlerToken)token;
- /** Disconnects and removes all handlers. */
- - (void)stop;
- /**
- * Historically no distinction was made between notification and request
- * handlers. If you use this method, it will be registered as *both* a
- * notification handler *and* a request handler. You should migrate to the
- * new block-based API instead.
- */
- - (void)addHandler:(id<RCTPackagerClientMethod>)handler
- forMethod:(NSString *)method __deprecated_msg("Use addRequestHandler or addNotificationHandler instead");
- @end
- NS_ASSUME_NONNULL_END
- #endif
|