---

NSDistantObjectRequest Class Reference

Overview

NSDistantObjectRequest objects are used by the distributed objects system to help handle invocations between different processes. You should never create NSDistantObjectRequest objects directly. Unless you are getting involved with the low-level details of distributed objects, there should never be a need to access an NSDistantObjectRequest. To intercept and possibly process requests yourself, implement the NSConnection delegate method connection:handleRequest:.

Tasks

Getting Information About a Request

• – connection
• – conversation
• – invocation

Raising a Remote Exception

• – replyWithException:

Instance Methods

connection

Returns the NSConnection object involved in the request.

- (NSConnection *)connection

Return Value

The NSConnection object involved in the request.

Availability

• Available in Mac OS X v10.0 and later.

Declared In

NSConnection.h

conversation

Returns the token object representing the conversation in which the receiver was created.

- (id)conversation

Return Value

The token object representing the conversation in which the receiver was created.

Discussion

If both ends of the distributed objects connection has independentConversationQueueing set to NO (the default), the conversation object is always nil. Otherwise, it is either a proxy (or a copy) of the object created by the sender of the message or a locally created object, depending which end of the connection has independent queueing on.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• createConversationForConnection: (NSConnection)

Declared In

NSConnection.h

invocation

Returns the NSInvocation object for the request.

- (NSInvocation *)invocation

Return Value

The NSInvocation object for the request.

Availability

• Available in Mac OS X v10.0 and later.

Declared In

NSConnection.h

replyWithException:

Sends a reply back to the remote object making the distant object request.

- (void)replyWithException:(NSException *)exception

Parameters

exception

The exception to send.

Discussion

If exception is nil, the return value of the receiver’s invocation is sent; otherwise, exception is sent and is automatically raised when it arrives at its destination.

Availability

• Available in Mac OS X v10.0 and later.

Declared In

NSConnection.h

---