home *** CD-ROM | disk | FTP | other *** search
/ Altsys Virtuoso 2.0K / virtuoso_20k.iso / NeXTanswers / OpenStepSpec_rtf / FoundationKit / Classes / NSConnection.rtf < prev    next >
Encoding:
Text File  |  1994-07-01  |  6.4 KB  |  125 lines
  1. {\rtf0\ansi\paperw16228 \paperh18648 \margl-907 \margr0 \margt0 \margb0 {\fonttbl\f0\fswiss Helvetica;\f1\froman Times;\f2\fmodern Courier;\f3\ftech Symbol;\f4\froman Palatino;}
  2. {\stylesheet{\s0 \li100 \fi0 \ri1007 \ql   1Head;}
  3. {\s1 \li100 \fi0 \ri1007 \ql   ClassName;}
  4. {\s2 \li2872 \fi-2771 \ri1007 \ql \tx2872   ConformsTo;}
  5. {\s3 \li2872 \fi-2771 \ri1007 \ql   DeclaredIn;}
  6. {\s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030   Description;}
  7. {\s5 \li7030 \fi-5796 \ri1007 \ql   DescriptionPart;}
  8. {\s6 \li0 \fi0 \ri0 \ql \tx-25 \tx8290 \tx9172   Footer;}
  9. {\s7 \li2872 \fi-2771 \ri1007 \ql \tx2872   InheritsFrom;}
  10. {\s8 \li100 \fi0 \ri1007 \ql   Summary;}
  11. }
  12. \li0 \fi0 \ri0 \ql \sb0 \f1 \fs24 
  13. (Preliminary Documentation) Copyright \f3 \'e3\f1 1994 by NeXT Computer, Inc.  All Rights Reserved.\
  14. \
  15. \s0 \li100 \fi0 \ri1007 \ql \f0 \b \fs36 \fs16 \
  16. \
  17. \
  18. \
  19. \
  20. \
  21. \
  22. \fs36 NSConnection \
  23. \pard \s7 \li2872 \fi-2771 \ri1007 \ql \tx2872 \f1 \b0 \fs28 \fs16 \
  24. \
  25. \
  26. \fs28 \f0 \b \fs28 Inherits From:    \b0 \fs28 \f1 NSObject \
  27. \fs16 \
  28. \fs28 \s2 \fs16 \fs28 \f0 \b \fs28 Conforms To:    \b0 \fs28 \f1 NSCoding \
  29. \fi0 NSObject \
  30. \fs16 \
  31. \fs28 \s3 \fi-2771 \fs16 \fs28 \f0 \b \fs28 Declared In:    \b0 \fs28 \f1 foundation/NSConnection.h \
  32. \fs16 \
  33. \fs28 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs28 \fs16 \
  34. \
  35. \fs28 Initializing a Connection\
  36. \fs16 \
  37. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (id)\b init\b0     Initialize a connection.\
  38. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  39. \
  40. \
  41. \fs28 Establishing a Connection\
  42. \fs16 \
  43. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 + (NSConnection *)\b connectionWithRegisteredName:\b0 (NSString *)\i name\i0  \
  44. \fi-6552 \s5 \li7030 \fi-6553 \fi-5796 \b host:\b0 (NSString *)\i host\i0     Registers and returns a connection with \i name\i0  on \i host\i0 .\
  45. \s4 \li7029 \fi-5794 \fi-6552 \fi-6552 + (NSConnection *)\b defaultConnection\b0     Establishes and returns a default per-thread connection.\
  46. \fi-6552 \fi-6552 \fi-6552 + (NSDistantObject *)\b rootProxyForConnectionWithRegisteredName:\b0 (NSString *)\i name\i0  \
  47. \fi-6552 \s5 \li7030 \fi-6553 \fi-5796 \b host\b0 :(NSString *)\i host\i0     Registers a connection with \i name\i0  on \i host\i0  and returns its root proxy.\
  48. \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  49. \
  50. \
  51. \fs28 Determining Connections\
  52. \fs16 \
  53. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 + (NSArray *)\b allConnections\b0     Returns an array describing all existing valid connections.\
  54. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (BOOL)\b isValid\b0     Identifies that the receiver is a valid connection.\
  55. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  56. \
  57. \
  58. \fs28 Registering a Connection\
  59. \fs16 \
  60. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (BOOL)\b registerName:\b0 (NSString *)\i name\i0     Registers the connection with \i name\i0  on the local system and returns YES if the registration was successful, No otherwise.\
  61. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  62. \
  63. \
  64. \fs28 Assigning a Delegate\
  65. \fs16 \
  66. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (id)\b delegate    \b0 Returns the connection\'27s delegate.\
  67. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b setDelegate:\b0 (id)\i anObject\i0     Sets the connection\'27s delegate.    \
  68. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  69. \
  70. \
  71. \fs28 Getting and setting the Root Object\
  72. \fs16 \
  73. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (id)\b rootObject\b0     Returns the root object served.\
  74. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (NSDistantObject *)\b rootProxy\b0     Returns an NSDistantObject proxy to the root object served by this connection.\
  75. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b setRootObject:\b0 (id)\i anObject\i0     Sets the root object being served to \i anObject\i0 ; if the root object already exists, replaces it with \i anObject\i0 .\
  76. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  77. \
  78. \
  79. \fs28 Request Mode\
  80. \fs16 \
  81. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (NSString *)\b requestMode\b0     Returns the mode in which requests are honored.\
  82. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b setRequestMode:\b0 (NSString *)\i mode\i0     Sets the mode in which requests are honored to \i mode\i0 .\
  83. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  84. \
  85. \
  86. \fs28 Conversation Queueing\
  87. \fs16 \
  88. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -}(BOOL)\b independentConversationQueueing\b0     Returns conversationQueuing mode.\
  89. \fi-6552 \fi-6552 \fi-6552 {\f3 -}(void)\b setIndependentConversationQueueing:\b0 (BOOL)\i conversationQueuing\
  90. \fi-6552 \s5 \li7030 \fi-6553 \fi-5796 \i0     If \i conversationQueuing\i0  is YES, unrelated requests are queued for later processing to help prevent deadlocks among peers.\
  91. \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  92. \
  93. \
  94. \fs28 Timeouts\
  95. \fs16 \
  96. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (NSTimeInterval)\b replyTimeout\b0     Returns the reply timeout time interval.\
  97. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (NSTimeInterval)\b requestTimeout\b0     Returns the request timeout time interval.\
  98. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b setReplyTimeout:\b0 (NSTimeInterval)\i interval    \i0 Sets the reply timeout to the time interval \i interval\i0 .\
  99. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b setRequestTimeout:\b0 (NSTimeInterval)\i interval\i0     Sets the request timeout to the time interval \i interval\i0 .\
  100. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  101. \
  102. \
  103. \fs28 Get Statistics\
  104. \fs16 \
  105. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (NSDictionary *)\b statistics\b0     Returns statistics for this connection.\
  106. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  107. \
  108. \
  109. \fs28 Implemented by the Delegate\
  110. \fs16 \
  111. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (BOOL)\b makeNewConnection:\b0 (NSConnection *)\i connection\
  112. \fi-6552 \s5 \li7030 \fi-6553 \fi-5796 \i0 \b sender:\b0 (NSConnection *)\i ancestor\i0     Asks permission to create a new connection \i connection\i0  where \i ancestor\i0  is the ancestral connection; returns YES if connection allowed.\
  113. \pard \s0 \li100 \fi0 \ri1007 \tx478 \tx856 \tx1234 \fs28 \fs16 \
  114. \
  115. \fs28 \
  116. \fs16 \
  117. \
  118. \fs28 \pard \s0 \
  119. \li100 \fi0 \fs16 \
  120. \
  121. \fs28 \
  122. \fs16 \
  123. \
  124. \fs28 }
  125.