Class

NSPortCoder

A coder used to transmit object proxies (and sometimes objects themselves) between connections.

Overview

NSPortCoder is a concrete subclass of NSCoder used in the distributed objects system to transmit object proxies (and sometimes objects themselves) between NSConnection objects. An NSPortCoder instance is always created and used by an NSConnection object; you should never need to explicitly create or use one directly yourself.

Topics

Creating an NSPortCoder Object

portCoderWithReceivePort:sendPort:components:

Creates and returns a new NSPortCoder object.

initWithReceivePort:sendPort:components:

Initializes and returns an NSPortCoder object.

Getting the Connection

connection

Returns the NSConnection object that uses the receiver.

Encoding NSPort Objects

encodePortObject:

Encodes a given port so it can be properly reconstituted in the receiving process or thread.

decodePortObject

Decodes and returns an NSPort object that was previously encoded with any of the general encode...Object: messages.

Checking for Encoding

isBycopy

Returns a Boolean value that indicates whether the receiver is encoding an object by copying it.

isByref

Returns a Boolean value that indicates whether the receiver is encoding an object by reference.

Dispatching

dispatch

Processes and acts upon the distributed object message with which the receiver was initialized.

Relationships

Inherits From

See Also

Legacy

NSMachPortDelegate

An interface for handling incoming Mach messages.

NSConnectionDelegate

An interface for interacting with low-level, interprocess connections.

Deprecated
NSConnection

An object that manages the communication between objects in different threads or between a thread and a process running on a local or remote system.

Deprecated
NSDistantObject

A proxy for objects in other applications or threads.

Deprecated
NSDistantObjectRequest

An object used by the distributed objects system to help handle invocations between different processes.

Deprecated
NSMachBootstrapServer

A port name server that takes and returns Mach port objects.

Deprecated
NSMachPort

A port that can be used as an endpoint for distributed object connections (or raw messaging).

NSMessagePort

A port that can be used as an endpoint for distributed object connections (or raw messaging).

NSMessagePortNameServer

A server takes and returns message ports.

Deprecated
NSPortDelegate

An interface for handling incoming messages.

NSPortMessage

A low-level, operating system-independent type for inter-application (and inter-thread) messages.

NSPortNameServer

An object-oriented interface to the port registration service used by the distributed objects system.

Deprecated
NSProtocolChecker

An object that restricts the messages that can be sent to another object (referred to as the checker’s delegate).

NSSocketPortNameServer

A port name server that takes and returns socket ports.

Deprecated