apple.foundation.protocol

Interface NSXPCProxyCreating

All Known Implementing Classes:

NSXPCConnection

public interface NSXPCProxyCreating

The connection itself and all proxies vended by the connection will conform with this protocol. This allows creation of new proxies from other proxies.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	NSXPCProxyCreating.Block_remoteObjectProxyWithErrorHandler
static interface	NSXPCProxyCreating.Block_synchronousRemoteObjectProxyWithErrorHandler

Method Summary

Modifier and Type	Method and Description
java.lang.Object	remoteObjectProxy() Returns a proxy object with no error handling block.
java.lang.Object	remoteObjectProxyWithErrorHandler(NSXPCProxyCreating.Block_remoteObjectProxyWithErrorHandler handler) Returns a proxy object which will invoke the error handling block if an error occurs on the connection.
default java.lang.Object	synchronousRemoteObjectProxyWithErrorHandler(NSXPCProxyCreating.Block_synchronousRemoteObjectProxyWithErrorHandler handler) Make a synchronous IPC call instead of the default async behavior.

Method Detail

remoteObjectProxy

java.lang.Object remoteObjectProxy()

Returns a proxy object with no error handling block. Messages sent to the proxy object will be sent over the wire to the other side of the connection. All messages must be 'oneway void' return type. Control may be returned to the caller before the message is sent. This proxy object will conform with the NSXPCProxyCreating protocol.

remoteObjectProxyWithErrorHandler

java.lang.Object remoteObjectProxyWithErrorHandler(NSXPCProxyCreating.Block_remoteObjectProxyWithErrorHandler handler)

Returns a proxy object which will invoke the error handling block if an error occurs on the connection. If the message sent to the proxy has a reply handler, then either the error handler or the reply handler will be called exactly once. This proxy object will also conform with the NSXPCProxyCreating protocol.

synchronousRemoteObjectProxyWithErrorHandler

default java.lang.Object synchronousRemoteObjectProxyWithErrorHandler(NSXPCProxyCreating.Block_synchronousRemoteObjectProxyWithErrorHandler handler)

Make a synchronous IPC call instead of the default async behavior. The error handler block and reply block will be invoked on the calling thread before the message to the proxy returns, instead of on the queue for the connection.