Mac Developer Library

Developer

Foundation Framework Reference NSDistantObjectRequest Class Reference

Options
Deployment Target:

On This Page
Language:

NSDistantObjectRequest

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:.

Inheritance


Conforms To


Import Statement


Not Applicable

Objective-C

@import Foundation;

Availability


Available in OS X v10.0 and later.
  • Returns the NSConnection object involved in the request.

    Declaration

    Objective-C

    @property(readonly, retain) NSConnection *connection

    Return Value

    The NSConnection object involved in the request.

    Import Statement

    Objective-C

    @import Foundation;

    Availability

    Available in OS X v10.0 and later.

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

    Declaration

    Objective-C

    @property(readonly, retain) 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 NOfalse (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.

    Import Statement

    Objective-C

    @import Foundation;

    Availability

    Available in OS X v10.0 and later.

    See Also

    createConversationForConnection: (NSConnection)

  • Returns the NSInvocation object for the request.

    Declaration

    Objective-C

    @property(readonly, retain) NSInvocation *invocation

    Return Value

    The NSInvocation object for the request.

    Import Statement

    Objective-C

    @import Foundation;

    Availability

    Available in OS X v10.0 and later.

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

    Declaration

    Objective-C

    - (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.

    Import Statement

    Objective-C

    @import Foundation;

    Availability

    Available in OS X v10.0 and later.