Deprecated NSConnection Methods

A method identified as deprecated has been superseded and may become unsupported in the future.

Deprecated in Mac OS X v10.6

defaultConnection

Returns the default NSConnection object for the current thread. (Deprecated in Mac OS X v10.6. Use [[NSConnection new] autorelease] to create a unique connection instead.)

+ (NSConnection *)defaultConnection

Return Value

The default NSConnection object for the current thread, creating it if necessary.

Discussion

The default NSConnection object uses a single NSPort object for both receiving and sending and is useful only for vending an object; use the setRootObject: and registerName: methods to do this.

Special Considerations

The singleton method of NSConnection has been deprecated. It was difficult to ensure that the shared connection wasn’t being used by other operations on the thread on which the defaultConnection was requested. Using [[NSConnection new] autorelease] ensures that you get a unique connection object, preventing such collisions.

Availability
Declared In
NSConnection.h


© 2009 Apple Inc. All Rights Reserved. (Last updated: 2009-10-19)