![]() System : Linux absol.cf 5.4.0-198-generic #218-Ubuntu SMP Fri Sep 27 20:18:53 UTC 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.33 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, Directory : /usr/share/doc/gnustep-base-doc/Base/Reference/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <title>NSPortCoder class reference</title> </head> <body> <font face="serif"> <a href="Base.html">Up</a> <br /> <h1><a name="title$NSPortCoder">NSPortCoder class reference</a></h1> <h3>Authors</h3> <dl> <dt>Andrew Kachites McCallum (<a href="mailto:mccallum@gnu.ai.mit.edu"><code>mccallum@gnu.ai.mit.edu</code></a>)</dt> <dd> </dd> </dl> <p><b>Copyright:</b> (C) 1997,2000 Free Software Foundation, Inc.</p> <div> <hr width="50%" align="left" /> <h3>Contents -</h3> <ol> <li> <a href="#001000000000">Software documentation for the NSPortCoder class</a> </li> <li> <a href="#002000000000">Software documentation for the NSObject(NSPortCoder) category</a> </li> </ol> <hr width="50%" align="left" /> </div> <h1><a name="001000000000"> Software documentation for the NSPortCoder class </a></h1> <h2><a name="class$NSPortCoder">NSPortCoder</a> : <a rel="gsdoc" href="NSCoder.html#class$NSCoder">NSCoder</a></h2> <blockquote class="declared"> <dl> <dt><b>Declared in:</b></dt> <dd>Foundation/NSPortCoder.h</dd> </dl> </blockquote> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> This class is an <a rel="gsdoc" href="NSCoder.html#class$NSCoder">NSCoder</a> implementation specialized for sending objects over network connections for immediate use (as opposed to the archivers which persist objects for reconstitution after an indefinite term). It is used to help implement the distributed objects framework by the <a rel="gsdoc" href="NSConnection.html#class$NSConnection">NSConnection</a> class. Even for highly specialized applications, you probably do not need to use this class directly. </div> <b>Method summary</b> <ul> <li><a rel="gsdoc" href="NSPortCoder.html#method$NSPortCoder+portCoderWithReceivePort$sendPort$components$">+portCoderWithReceivePort:sendPort:components:</a></li> <li><a rel="gsdoc" href="NSPortCoder.html#method$NSPortCoder-connection">-connection</a></li> <li><a rel="gsdoc" href="NSPortCoder.html#method$NSPortCoder-decodePortObject">-decodePortObject</a></li> <li><a rel="gsdoc" href="NSPortCoder.html#method$NSPortCoder-dispatch">-dispatch</a></li> <li><a rel="gsdoc" href="NSPortCoder.html#method$NSPortCoder-encodePortObject$">-encodePortObject:</a></li> <li><a rel="gsdoc" href="NSPortCoder.html#method$NSPortCoder-initWithReceivePort$sendPort$components$">-initWithReceivePort:sendPort:components:</a></li> <li><a rel="gsdoc" href="NSPortCoder.html#method$NSPortCoder-isBycopy">-isBycopy</a></li> <li><a rel="gsdoc" href="NSPortCoder.html#method$NSPortCoder-isByref">-isByref</a></li> </ul> <hr width="50%" align="left" /> <div class="method"> <h3><a name="method$NSPortCoder+portCoderWithReceivePort$sendPort$components$">portCoderWithReceivePort: sendPort: components: </a></h3> + (<a rel="gsdoc" href="#class$NSPortCoder">NSPortCoder</a>*) <b>portCoderWithReceivePort:</b> (<a rel="gsdoc" href="NSPort.html#class$NSPort">NSPort</a>*)recv<b> sendPort:</b> (<a rel="gsdoc" href="NSPort.html#class$NSPort">NSPort</a>*)send<b> components:</b> (<a rel="gsdoc" href="NSArray.html#class$NSArray">NSArray</a>*)comp;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> Create a new instance for communications over <var>send</var> and <var>recv</var>, and <var>send</var> an initial message through <var>send</var> as specified by <var>comp</var>. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPortCoder-connection">connection </a></h3> - (<a rel="gsdoc" href="NSConnection.html#class$NSConnection">NSConnection</a>*) <b>connection</b>;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> Returns the <code>NSConnection</code> using this instance. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPortCoder-decodePortObject">decodePortObject </a></h3> - (<a rel="gsdoc" href="NSPort.html#class$NSPort">NSPort</a>*) <b>decodePortObject</b>;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> Return port object previously encoded by this instance. Mainly for use by the ports themselves. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPortCoder-dispatch">dispatch </a></h3> - (void) <b>dispatch</b>;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> Processes and acts upon the initial message the receiver was initialized with.. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPortCoder-encodePortObject$">encodePortObject: </a></h3> - (void) <b>encodePortObject:</b> (<a rel="gsdoc" href="NSPort.html#class$NSPort">NSPort</a>*)aPort;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> Encodes <var>aPort</var> so it can be sent to the receiving side of the connection. Mainly for use by the ports themselves. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPortCoder-initWithReceivePort$sendPort$components$">initWithReceivePort: sendPort: components: </a></h3> - (id) <b>initWithReceivePort:</b> (<a rel="gsdoc" href="NSPort.html#class$NSPort">NSPort</a>*)recv<b> sendPort:</b> (<a rel="gsdoc" href="NSPort.html#class$NSPort">NSPort</a>*)send<b> components:</b> (<a rel="gsdoc" href="NSArray.html#class$NSArray">NSArray</a>*)comp;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> Initialize a new instance for communications over <var>send</var> and <var>recv</var>, and <var>send</var> an initial message through <var>send</var> as specified by <var>comp</var>. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPortCoder-isBycopy">isBycopy </a></h3> - (BOOL) <b>isBycopy</b>;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> Returns <code>YES</code> if receiver is in the process of encoding objects by copying them (rather than substituting a proxy). This method is mainly needed internally and by subclasses. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPortCoder-isByref">isByref </a></h3> - (BOOL) <b>isByref</b>;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> Returns <code>YES</code> if receiver will substitute a proxy when encoding objects rather than by copying them. This method is mainly needed internally and by subclasses. </div> <hr width="25%" align="left" /> </div> <h1><a name="002000000000"> Software documentation for the NSObject(NSPortCoder) category </a></h1> <h2><a rel="gsdoc" href="NSObject.html#class$NSObject">NSObject</a>(<a name="category$NSObject(NSPortCoder)">NSPortCoder</a>)</h2> <blockquote class="declared"> <dl> <dt><b>Declared in:</b></dt> <dd>Foundation/NSPortCoder.h</dd> </dl> </blockquote> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> This informal protocol allows an object to control the details of how an object is sent over the wire in distributed objects Port communications. </div> <b>Method summary</b> <ul> <li><a rel="gsdoc" href="NSPortCoder.html#method$NSObject(NSPortCoder)-classForPortCoder">-classForPortCoder</a></li> <li><a rel="gsdoc" href="NSPortCoder.html#method$NSObject(NSPortCoder)-replacementObjectForPortCoder$">-replacementObjectForPortCoder:</a></li> </ul> <hr width="50%" align="left" /> <div class="method"> <h3><a name="method$NSObject(NSPortCoder)-classForPortCoder">classForPortCoder </a></h3> - (Class) <b>classForPortCoder</b>;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> Must return the class that will be created on the remote side of the connection. If the class to be created is not the same as that of the object returned by replacementObjectForPortCoder: then the class must be capable of recognising the object it actually gets in its initWithCoder: method. The default operation is to return NSDistantObject unless the object is being sent bycopy, in which case the objects actual class is returned. To force bycopy operation the object should return its own class. <br /> Override to substitute class when an instance is being serialized by an <a rel="gsdoc" href="#class$NSPortCoder">NSPortCoder</a> . Default implementation returns <a rel="gsdoc" href="NSObject.html#method$NSObject-classForCoder"> -classForCoder </a> . </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSObject(NSPortCoder)-replacementObjectForPortCoder$">replacementObjectForPortCoder: </a></h3> - (id) <b>replacementObjectForPortCoder:</b> (<a rel="gsdoc" href="#class$NSPortCoder">NSPortCoder</a>*)aCoder;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> This message is sent to an object about to be encoded for sending over the wire. The default action is to return an NSDistantObject which is a local proxy for the object unless the object is being sent bycopy, in which case the actual object is returned. To force bycopy, an object should return itself. <br /> Returns the actual object to be encoded for sending over the network on a Distributed Objects connection. <br /> The default implementation returns self if the receiver is being sent <em>bycopy</em> and returns a proxy otherwise. <br /> Subclasses may override this method to change this behavior, eg. to ensure that they are always copied. </div> <hr width="25%" align="left" /> </div> <br /> <a href="Base.html">Up</a> </font> </body> </html>