ROSimpleRemoteService

Overview

A ROSimpleRemoteService 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    (declared in RORemoteService)

Represents a client channel instance

@property (retain) ROClientChannel *channel

init    (declared in RORemoteService)

initializes a new, unconfigured remote service instance.

- (id) init

initWithMessage:channel:serviceName:    (declared in RORemoteService)

initializes a new remote service instance with the given ROMessage, ROClientChannel and service name.

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

Parameters:

  • aMessage: ROMessage instance which will be used for working with given remote service
  • aChannel: ROClientChannel instance
  • aServiceName: Name of the service

initWithNetService:    (declared in RORemoteService)

initializes a new remote service instance with the given NSNetService obtained from ZeroConf .

- (id) initWithNetService:(NSNetService *)aService

Parameters:

  • aService:

initWithNetService:serviceName:    (declared in RORemoteService)

initializes a new remote service instance with the given ZeroConf NSNetService, but overrides the default service name.

This can be useful when contacting additional known services on a discovered server.

- (id) initWithNetService:(NSNetService *)aService serviceName:(NSString *)aName

Parameters:

  • aService:
  • aName: Custom service name

initWithTargetUrl:serviceName:

initializes a new remote service instance with a ROBinMessage and ROHTTPClientChannel on the given target URL and service name.

- (id) initWithTargetUrl:(NSString *)aTargetUrl serviceName:(NSString *)aServiceName

Parameters:

  • aTargetUrl:
  • aServiceName:

initWithTargetURL:serviceName:    (declared in RORemoteService)

Initializes a new remote service instance with the given Target URL and Service name.

- (id) initWithTargetURL:(NSURL *)targetUrl serviceName:(NSString *)aServiceName

Parameters:

  • targetUrl:
  • aServiceName:

message  retain    (declared in RORemoteService)

Represents the message instance of the Remote Service

@property (retain) ROMessage *message

remoteServiceWithMessage:channel:serviceName:    (declared in RORemoteService)

creates and returns a new remote service instance with the given ROMessage, ROClientChannel and service name.

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

Parameters:

  • aMessage: Message for the Remote Service
  • aChannel: Channel for the Remote Service
  • aServiceName: Name of the service

remoteServiceWithNetService:    (declared in RORemoteService)

Creates and returns a new remote service instance with the given ZeroConf NSNetService.

+ (id) remoteServiceWithNetService:(NSNetService *)aService

Parameters:

  • aService:

remoteServiceWithNetService:serviceName:    (declared in RORemoteService)

creates and returns a new remote service instance with the given ZeroConf NSNetService, but overrides the default service name. This is useful when contacting additional known services on a discovered server.

+ (id) remoteServiceWithNetService:(NSNetService *)aService serviceName:(NSString *)aServiceName

Parameters:

  • aService: NSNetService instance that came from ZeroConf
  • aServiceName: Represents the name of the service you want to connect to

remoteServiceWithTargetUrl:serviceName:

creates and returns a new remote service instance with a ROBinMessage and ROHTTPClientChannel on the given target URL and service name.

+ (id) remoteServiceWithTargetUrl:(NSString *)aTargetUrl serviceName:(NSString *)aServiceName

Parameters:

  • aTargetUrl:
  • aServiceName:

remoteServiceWithTargetURL:serviceName:    (declared in RORemoteService)

Creates and initialize RORemoteService instance with given service name and target URL

+ (id) remoteServiceWithTargetURL:(NSURL *)targetUrl serviceName:(NSString *)aServiceName

Parameters:

  • targetUrl: Represents target URL of the remote service
  • aServiceName: Name of the remote service we want to connect to

resolved    (declared in RORemoteService)

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

@property (readonly) BOOL resolved

serviceName  copy    (declared in RORemoteService)

Name of the RemoteService

@property (copy) NSString *serviceName

 

channel  retain    (declared in RORemoteService)

Represents a client channel instance

@property (retain) ROClientChannel *channel

message  retain    (declared in RORemoteService)

Represents the message instance of the Remote Service

@property (retain) ROMessage *message

resolved    (declared in RORemoteService)

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

@property (readonly) BOOL resolved

serviceName  copy    (declared in RORemoteService)

Name of the RemoteService

@property (copy) NSString *serviceName

 

remoteServiceWithMessage:channel:serviceName:    (declared in RORemoteService)

creates and returns a new remote service instance with the given ROMessage, ROClientChannel and service name.

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

Parameters:

  • aMessage: Message for the Remote Service
  • aChannel: Channel for the Remote Service
  • aServiceName: Name of the service

remoteServiceWithNetService:    (declared in RORemoteService)

Creates and returns a new remote service instance with the given ZeroConf NSNetService.

+ (id) remoteServiceWithNetService:(NSNetService *)aService

Parameters:

  • aService:

remoteServiceWithNetService:serviceName:    (declared in RORemoteService)

creates and returns a new remote service instance with the given ZeroConf NSNetService, but overrides the default service name. This is useful when contacting additional known services on a discovered server.

+ (id) remoteServiceWithNetService:(NSNetService *)aService serviceName:(NSString *)aServiceName

Parameters:

  • aService: NSNetService instance that came from ZeroConf
  • aServiceName: Represents the name of the service you want to connect to

remoteServiceWithTargetUrl:serviceName:

creates and returns a new remote service instance with a ROBinMessage and ROHTTPClientChannel on the given target URL and service name.

+ (id) remoteServiceWithTargetUrl:(NSString *)aTargetUrl serviceName:(NSString *)aServiceName

Parameters:

  • aTargetUrl:
  • aServiceName:

remoteServiceWithTargetURL:serviceName:    (declared in RORemoteService)

Creates and initialize RORemoteService instance with given service name and target URL

+ (id) remoteServiceWithTargetURL:(NSURL *)targetUrl serviceName:(NSString *)aServiceName

Parameters:

  • targetUrl: Represents target URL of the remote service
  • aServiceName: Name of the remote service we want to connect to

 

init    (declared in RORemoteService)

initializes a new, unconfigured remote service instance.

- (id) init

initWithMessage:channel:serviceName:    (declared in RORemoteService)

initializes a new remote service instance with the given ROMessage, ROClientChannel and service name.

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

Parameters:

  • aMessage: ROMessage instance which will be used for working with given remote service
  • aChannel: ROClientChannel instance
  • aServiceName: Name of the service

initWithNetService:    (declared in RORemoteService)

initializes a new remote service instance with the given NSNetService obtained from ZeroConf .

- (id) initWithNetService:(NSNetService *)aService

Parameters:

  • aService:

initWithNetService:serviceName:    (declared in RORemoteService)

initializes a new remote service instance with the given ZeroConf NSNetService, but overrides the default service name.

This can be useful when contacting additional known services on a discovered server.

- (id) initWithNetService:(NSNetService *)aService serviceName:(NSString *)aName

Parameters:

  • aService:
  • aName: Custom service name

initWithTargetUrl:serviceName:

initializes a new remote service instance with a ROBinMessage and ROHTTPClientChannel on the given target URL and service name.

- (id) initWithTargetUrl:(NSString *)aTargetUrl serviceName:(NSString *)aServiceName

Parameters:

  • aTargetUrl:
  • aServiceName:

initWithTargetURL:serviceName:    (declared in RORemoteService)

Initializes a new remote service instance with the given Target URL and Service name.

- (id) initWithTargetURL:(NSURL *)targetUrl serviceName:(NSString *)aServiceName

Parameters:

  • targetUrl:
  • aServiceName:

See Also