Difference between revisions of "CPDistributedMessagingCenter"

From iPhone Development Wiki
Jump to: navigation, search
m (External links)
m (External links)
Line 48: Line 48:
 
== External links ==
 
== External links ==
  
{{IPFHeader|AppSupport|.framework||CPDistributedMessagingCenter}}
+
{{IPFHeader|AppSupport}}

Revision as of 16:14, 26 October 2014

CPDistributedMessagingCenter is a wrapper over the existing messaging facilities in the operating system. It provides server-client communication between different processes using simple messages and dictionaries. All dictionaries transferred must be serializable as a property list.

Usage

Server

-(id)init... {
...

  CPDistributedMessagingCenter *messagingCenter;
  // Center name must be unique, recommend using application identifier.
  messagingCenter = [CPDistributedMessagingCenter centerNamed:@"unique.name.for.messaging.center"];
  [messagingCenter runServerOnCurrentThread];

  // Register Messages
  [messagingCenter registerForMessageName:@"messageThatHasInfo" target:self selector:@selector(handleMessageNamed:withUserInfo:)];
  [messagingCenter registerForMessageName:@"message" target:self selector:@selector(handleSimpleMessageNamed:)];

...
}

- (NSDictionary *)handleMessageNamed:(NSString *)name withUserInfo:(NSDictionary *)userinfo {
    // Process userinfo (simple dictionary) and return a dictionary (or nil)
}

- (void)handleSimpleMessageNamed:(NSString *)name {
    // ...
}

Client

CPDistributedMessagingCenter *messagingCenter;
messagingCenter = [CPDistributedMessagingCenter centerNamed:@"unique.name.for.messaging.center"];

// One-way (message only)
[messagingCenter sendMessageName:@"message" userInfo:nil/* optional dictionary. in this example it will be ignored. */];

// Two-way (wait for reply)
NSDictionary *reply;
reply = [messagingCenter sendMessageAndReceiveReplyName:@"messageThatHasInfo" userInfo:nil/* optional dictionary */];

CPDistributedMessagingCenter as a MIG subsystem

The CPDistributedMessagingCenter is a complex wrapper on top of the MIG-generated RPC subsystem (_CPDMCPDistributedMessaging_subsystem). The center name will in fact be registered as the service name in the bootstrap name. Therefore, existing services like com.apple.springboard.services cannot be used as the center name.

This subsystem has only 2 routines: 79000 (CPDMMessage) and 79001 (CPDMTwoWayMessage).

External links