ftp.nice.ch/peanuts/GeneralData/Documents/openstep/OpenStepSpec_rtf.tar.gz#/OpenStepSpec_rtf/FoundationKit/Classes/NSProxy.rtf

This is NSProxy.rtf in view mode; [Download] [Up]

paperh18648 margl-907 margr0 margt0 margb0 fi0 ri0 ql sb0 f1 fs24 Copyright f3 'e3f1 1994 by NeXT Computer, Inc.  All Rights Reserved.

s4 li100 fi0 ri1007 ql f0 b fs36 fs100 
fs36 NSProxy 
pard s11 li2872 fi-2771 ri1007 ql tx2872 f1 b0 fs28 fs48 
fs28 f0 b fs24 Inherits From:tab b0 fs28 f1 none (i NXProxy is a root classi0 ) 
fs20 
fs28 s6 f0 b fs24 Conforms To:tab b0 fs28 f1 NSObject 
fs20 
fs28 s7 f0 b fs24 Declared In:tab b0 fs28 f1 Foundation/NSProxy 
fs20 
fs28 pard s16 li100 fi0 ri1007 ql f0 b fs28 fs20 
fs28 Class Description
fs14 
fs28 pard s1 li477 fi0 ri1007 ql tx2494 tx2872 tx3250 f1 b0 fs2 
fs28 The NSProxy class declares the programmatic interface to i proxiesi0 'd0objects that stand in for real objects (usually descendants of the NSObject class), where the real objects may exist within the same or another process, perhaps even in a system of a different architecture across a network. To the application, the proxy behaves like the real object, though the real object may not be directly accessible, and in general, instance variables of remote objects are not accessible.
fs16 
fs28 NSProxy class defines few methods, because proxies respond to few messages directly. Instead, when a proxy receives a message it doesn'27t respond to, it encodes the message, including the arguments, in an invocation, and invokes b forwardInvocation:b0 . Specialized subclasses then direct further processing, such as forwarding the message to a real object in the same or another process.
fs16 
fs28 Methods defined in this class are methods that the NSProxy class responds to directly. Unless otherwise noted, none of these methods are forwarded to the proxy'27s correspondent.
fs16 
fs28 Your application in general doesn'27t instantiate NSProxy objects'd0they'27re created as instances of specialized subclasses. Proxies are reference-counted so that only a single NSProxy per connection is instantiated for any real object.
fs16 
fs28 pard s16 li100 fi0 ri1007 ql f0 b fs24 
fs28 Creating and Destroying Instancestab 
fs14 
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2 
fs28 fi-6552 + (id)b allocb0 tab Returns a new, uninitialized instance of the receiving class.
fi-6552 fs16 
fs28 fi-6552 + (id)b allocWithZone:b0 (NSZone *)i zonei0 tab Returns a new, uninitialized instance of the receiving class in i zonei0 .
fi-6552 fs16 
fs28 fi-6552 {f3 -} (void)b deallocb0 tab Deallocates the memory occupied by the receiver. 
pard s16 li100 fi0 ri1007 ql f0 b fs48 
fs28 Identifying Classestab 
fs14 
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2 
fs28 fi-6552 + (Class)b classb0 tab Returns b selfb0 . Since this is a class method, it returns the class object.
pard s16 li100 fi0 ri1007 ql f0 b fs48 
fs28 Obtaining Method Information
fs14 
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2 
fs28 fi-6552 {f3 -} (NSMethodSignature *)b methodSignatureForSelector:b0 (SEL)i aSelector
s9 li7030 fi-6553 fi-5796 i0 tab Implemented by subclasses to return an object that contains a description of the i aSelectori0  method, or b nilb0  if the i aSelectori0  method can'27t be found. The NSProxy implementation of this method raises an NSInvalidArgumentException exception.
pard s16 li100 fi0 ri1007 ql f0 b fs48 
fs28 Describing Objects
fs14 
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2 
fs28 fi-6552 {f3 -} (NSString *)b descriptionb0 tab Prints the name of receiver'27s class and the hexadecimal value of the its b idb0 .
pard s16 li100 fi0 ri1007 ql f0 b fs48 
fs28 Forwarding Messages
fs14 
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2 
fs28 fi-6552 {f3 -} (void)b forwardInvocation:b0 (NSInvocation *)i invocation
s9 li7030 fi-6553 fi-5796 i0 tab Implemented by subclasses to forward messages to other objects. The NSProxy implementation of this method raises an NSInvalidArgumentException exception.
}

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.