(Preliminary Documentation) Copyright ã1994 by NeXT Computer, Inc.  All Rights Reserved.

NSConnection 

Inherits From:	NSObject 

Conforms To:	NSCoding 
NSObject 

Declared In:	foundation/NSConnection.h 

Initializing a Connection

- (id)init	Initialize a connection.

Establishing a Connection

+ (NSConnection *)connectionWithRegisteredName:(NSString *)name 
host:(NSString *)host	Registers and returns a connection with name on host.
+ (NSConnection *)defaultConnection	Establishes and returns a default per-thread connection.
+ (NSDistantObject *)rootProxyForConnectionWithRegisteredName:(NSString *)name 
host:(NSString *)host	Registers a connection with name on host and returns its root proxy.

Determining Connections

+ (NSArray *)allConnections	Returns an array describing all existing valid connections.
- (BOOL)isValid	Identifies that the receiver is a valid connection.

Registering a Connection

- (BOOL)registerName:(NSString *)name	Registers the connection with name on the local system and returns YES if the registration was successful, No otherwise.

Assigning a Delegate

- (id)delegate	Returns the connection's delegate.
- (void)setDelegate:(id)anObject	Sets the connection's delegate.	

Getting and setting the Root Object

- (id)rootObject	Returns the root object served.
- (NSDistantObject *)rootProxy	Returns an NSDistantObject proxy to the root object served by this connection.
- (void)setRootObject:(id)anObject	Sets the root object being served to anObject; if the root object already exists, replaces it with anObject.

Request Mode

- (NSString *)requestMode	Returns the mode in which requests are honored.
- (void)setRequestMode:(NSString *)mode	Sets the mode in which requests are honored to mode.

Conversation Queueing

-(BOOL)independentConversationQueueing	Returns conversationQueuing mode.
-(void)setIndependentConversationQueueing:(BOOL)conversationQueuing
	If conversationQueuing is YES, unrelated requests are queued for later processing to help prevent deadlocks among peers.

Timeouts

- (NSTimeInterval)replyTimeout	Returns the reply timeout time interval.
- (NSTimeInterval)requestTimeout	Returns the request timeout time interval.
- (void)setReplyTimeout:(NSTimeInterval)interval	Sets the reply timeout to the time interval interval.
- (void)setRequestTimeout:(NSTimeInterval)interval	Sets the request timeout to the time interval interval.

Get Statistics

- (NSDictionary *)statistics	Returns statistics for this connection.

Implemented by the Delegate

- (BOOL)makeNewConnection:(NSConnection *)connection
sender:(NSConnection *)ancestor	Asks permission to create a new connection connection where ancestor is the ancestral connection; returns YES if connection allowed.