RORemoteService

Overview

A RORemoteService instance represents all information needed to identify a service on a remote machine that a client wants to communicate with, namely the ROClientChannel configured for the server's end point, the ROMessage for the approriate message encoding and the Service Name to uniquely identify the individual service on the server.

RORemoteServices can be configured manually by passing in the above three values, or they can be created based on service information discovered using ZeroConf.

A ROSimpleRemoteService descendant is provided to cater for the most common scenario of talking to a HTTP server via BinMessage without needing to manually create the necessary message and channel instances.

Location


 

channel  retain

@property (retain) nonnull ROClientChannel *channel

init

- (nonnull instancetype) init

initWithMessage:channel:serviceName:

- (nonnull instancetype) initWithMessage:(nonnull ROMessage *)aMessage channel:(nonnull ROClientChannel *)aChannel serviceName:(nonnull NSString *)aServiceName

Parameters:

  • aMessage:
  • aChannel:
  • aServiceName:

initWithNetService:

- (nullable instancetype) initWithNetService:(nonnull NSNetService *)aService

Parameters:

  • aService:

initWithNetService:serviceName:

- (nullable instancetype) initWithNetService:(nonnull NSNetService *)aService serviceName:(nonnull NSString *)aName

Parameters:

  • aService:
  • aName:

initWithTargetUrl:serviceName:  deprecated

- (nonnull instancetype) initWithTargetUrl:(nonnull NSString *)targetUrl serviceName:(nonnull NSString *)aServiceName

Parameters:

  • targetUrl:
  • aServiceName:

initWithTargetURL:serviceName:

- (nonnull instancetype) initWithTargetURL:(nonnull NSURL *)targetUrl serviceName:(nonnull NSString *)aServiceName

Parameters:

  • targetUrl:
  • aServiceName:

message  retain

@property (retain) nonnull ROMessage *message

remoteServiceWithMessage:channel:serviceName:

+ (nonnull instancetype) remoteServiceWithMessage:(nonnull ROMessage *)aMessage channel:(nonnull ROClientChannel *)aChannel serviceName:(nonnull NSString *)aServiceName

Parameters:

  • aMessage:
  • aChannel:
  • aServiceName:

remoteServiceWithNetService:

+ (nullable instancetype) remoteServiceWithNetService:(nonnull NSNetService *)aService

Parameters:

  • aService:

remoteServiceWithNetService:serviceName:

+ (nullable instancetype) remoteServiceWithNetService:(nonnull NSNetService *)aService serviceName:(nonnull NSString *)aServiceName

Parameters:

  • aService:
  • aServiceName:

remoteServiceWithTargetUrl:serviceName:  deprecated

+ (nonnull instancetype) remoteServiceWithTargetUrl:(nonnull NSString *)targetUrl serviceName:(nonnull NSString *)aServiceName

Parameters:

  • targetUrl:
  • aServiceName:

remoteServiceWithTargetURL:serviceName:

+ (nonnull instancetype) remoteServiceWithTargetURL:(nonnull NSURL *)targetUrl serviceName:(nonnull NSString *)aServiceName

Parameters:

  • targetUrl:
  • aServiceName:

resolved

Boolean flag shows was this remote service already resolved via ZeroConf or not.

@property (readonly) BOOL resolved

serviceName  copy

@property (copy) nonnull NSString *serviceName

 

channel  retain

@property (retain) nonnull ROClientChannel *channel

message  retain

@property (retain) nonnull ROMessage *message

resolved

Boolean flag shows was this remote service already resolved via ZeroConf or not.

@property (readonly) BOOL resolved

serviceName  copy

@property (copy) nonnull NSString *serviceName

 

remoteServiceWithMessage:channel:serviceName:

+ (nonnull instancetype) remoteServiceWithMessage:(nonnull ROMessage *)aMessage channel:(nonnull ROClientChannel *)aChannel serviceName:(nonnull NSString *)aServiceName

Parameters:

  • aMessage:
  • aChannel:
  • aServiceName:

remoteServiceWithNetService:

+ (nullable instancetype) remoteServiceWithNetService:(nonnull NSNetService *)aService

Parameters:

  • aService:

remoteServiceWithNetService:serviceName:

+ (nullable instancetype) remoteServiceWithNetService:(nonnull NSNetService *)aService serviceName:(nonnull NSString *)aServiceName

Parameters:

  • aService:
  • aServiceName:

remoteServiceWithTargetUrl:serviceName:  deprecated

+ (nonnull instancetype) remoteServiceWithTargetUrl:(nonnull NSString *)targetUrl serviceName:(nonnull NSString *)aServiceName

Parameters:

  • targetUrl:
  • aServiceName:

remoteServiceWithTargetURL:serviceName:

+ (nonnull instancetype) remoteServiceWithTargetURL:(nonnull NSURL *)targetUrl serviceName:(nonnull NSString *)aServiceName

Parameters:

  • targetUrl:
  • aServiceName:

 

init

- (nonnull instancetype) init

initWithMessage:channel:serviceName:

- (nonnull instancetype) initWithMessage:(nonnull ROMessage *)aMessage channel:(nonnull ROClientChannel *)aChannel serviceName:(nonnull NSString *)aServiceName

Parameters:

  • aMessage:
  • aChannel:
  • aServiceName:

initWithNetService:

- (nullable instancetype) initWithNetService:(nonnull NSNetService *)aService

Parameters:

  • aService:

initWithNetService:serviceName:

- (nullable instancetype) initWithNetService:(nonnull NSNetService *)aService serviceName:(nonnull NSString *)aName

Parameters:

  • aService:
  • aName:

initWithTargetUrl:serviceName:  deprecated

- (nonnull instancetype) initWithTargetUrl:(nonnull NSString *)targetUrl serviceName:(nonnull NSString *)aServiceName

Parameters:

  • targetUrl:
  • aServiceName:

initWithTargetURL:serviceName:

- (nonnull instancetype) initWithTargetURL:(nonnull NSURL *)targetUrl serviceName:(nonnull NSString *)aServiceName

Parameters:

  • targetUrl:
  • aServiceName: