copland 0.8.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (184) hide show
  1. data/doc/README +88 -0
  2. data/doc/manual-html/chapter-1.html +454 -0
  3. data/doc/manual-html/chapter-10.html +399 -0
  4. data/doc/manual-html/chapter-11.html +600 -0
  5. data/doc/manual-html/chapter-12.html +406 -0
  6. data/doc/manual-html/chapter-2.html +382 -0
  7. data/doc/manual-html/chapter-3.html +424 -0
  8. data/doc/manual-html/chapter-4.html +432 -0
  9. data/doc/manual-html/chapter-5.html +381 -0
  10. data/doc/manual-html/chapter-6.html +364 -0
  11. data/doc/manual-html/chapter-7.html +434 -0
  12. data/doc/manual-html/chapter-8.html +373 -0
  13. data/doc/manual-html/chapter-9.html +324 -0
  14. data/doc/manual-html/copland.png +0 -0
  15. data/doc/manual-html/index.html +331 -0
  16. data/doc/manual-html/manual.css +179 -0
  17. data/doc/manual-html/tutorial-1.html +407 -0
  18. data/doc/manual-html/tutorial-2.html +451 -0
  19. data/doc/manual-html/tutorial-3.html +484 -0
  20. data/doc/manual-html/tutorial-4.html +446 -0
  21. data/doc/manual-html/tutorial-5.html +520 -0
  22. data/doc/manual/chapter.erb +18 -0
  23. data/doc/manual/example.erb +18 -0
  24. data/doc/manual/img/copland.png +0 -0
  25. data/doc/manual/index.erb +30 -0
  26. data/doc/manual/manual.css +179 -0
  27. data/doc/manual/manual.rb +239 -0
  28. data/doc/manual/manual.yml +2643 -0
  29. data/doc/manual/page.erb +102 -0
  30. data/doc/manual/tutorial.erb +30 -0
  31. data/doc/packages/copland.html +764 -0
  32. data/doc/packages/copland.lib.html +439 -0
  33. data/doc/packages/copland.remote.html +2096 -0
  34. data/doc/packages/copland.webrick.html +925 -0
  35. data/doc/packages/index.html +49 -0
  36. data/doc/packages/packrat.css +125 -0
  37. data/examples/calc/calc.rb +47 -0
  38. data/examples/calc/package.yml +35 -0
  39. data/examples/calc/services.rb +74 -0
  40. data/examples/solitaire-cipher/README +11 -0
  41. data/examples/solitaire-cipher/Rakefile +57 -0
  42. data/examples/solitaire-cipher/bin/main.rb +14 -0
  43. data/examples/solitaire-cipher/lib/cipher.rb +230 -0
  44. data/examples/solitaire-cipher/lib/cli.rb +24 -0
  45. data/examples/solitaire-cipher/lib/package.yml +106 -0
  46. data/examples/solitaire-cipher/test/tc_deck.rb +30 -0
  47. data/examples/solitaire-cipher/test/tc_key-stream.rb +19 -0
  48. data/examples/solitaire-cipher/test/tc_keying-algorithms.rb +31 -0
  49. data/examples/solitaire-cipher/test/tc_solitaire-cipher.rb +66 -0
  50. data/examples/solitaire-cipher/test/tc_unkeyed-algorithm.rb +17 -0
  51. data/examples/solitaire-cipher/test/tests.rb +2 -0
  52. data/lib/copland.rb +56 -0
  53. data/lib/copland/class-factory.rb +95 -0
  54. data/lib/copland/configuration-point.rb +38 -0
  55. data/lib/copland/configuration-point/common.rb +203 -0
  56. data/lib/copland/configuration-point/errors.rb +44 -0
  57. data/lib/copland/configuration-point/list.rb +59 -0
  58. data/lib/copland/configuration-point/map.rb +59 -0
  59. data/lib/copland/configuration/errors.rb +43 -0
  60. data/lib/copland/configuration/loader.rb +113 -0
  61. data/lib/copland/configuration/yaml/configuration-point.rb +87 -0
  62. data/lib/copland/configuration/yaml/implementor.rb +134 -0
  63. data/lib/copland/configuration/yaml/interceptor.rb +63 -0
  64. data/lib/copland/configuration/yaml/listener.rb +56 -0
  65. data/lib/copland/configuration/yaml/loader.rb +122 -0
  66. data/lib/copland/configuration/yaml/package.rb +125 -0
  67. data/lib/copland/configuration/yaml/parser.rb +71 -0
  68. data/lib/copland/configuration/yaml/schema.rb +165 -0
  69. data/lib/copland/configuration/yaml/service-point.rb +116 -0
  70. data/lib/copland/configuration/yaml/utils.rb +82 -0
  71. data/lib/copland/default-schema-processor.rb +144 -0
  72. data/lib/copland/errors.rb +82 -0
  73. data/lib/copland/event-producer.rb +95 -0
  74. data/lib/copland/impl/builder-factory.rb +112 -0
  75. data/lib/copland/impl/copland-config.yml +1 -0
  76. data/lib/copland/impl/include-exclude.rb +140 -0
  77. data/lib/copland/impl/logging-interceptor.rb +106 -0
  78. data/lib/copland/impl/package.yml +217 -0
  79. data/lib/copland/impl/startup.rb +116 -0
  80. data/lib/copland/impl/symbol-source-manager.rb +131 -0
  81. data/lib/copland/impl/symbol-source.rb +63 -0
  82. data/lib/copland/instantiator.rb +38 -0
  83. data/lib/copland/instantiator/abstract.rb +91 -0
  84. data/lib/copland/instantiator/complex.rb +96 -0
  85. data/lib/copland/instantiator/identity.rb +58 -0
  86. data/lib/copland/instantiator/simple.rb +68 -0
  87. data/lib/copland/interceptor-chain.rb +166 -0
  88. data/lib/copland/interceptor.rb +139 -0
  89. data/lib/copland/log-factory.rb +206 -0
  90. data/lib/copland/models.rb +39 -0
  91. data/lib/copland/models/abstract.rb +78 -0
  92. data/lib/copland/models/prototype-deferred.rb +58 -0
  93. data/lib/copland/models/prototype.rb +58 -0
  94. data/lib/copland/models/proxy.rb +100 -0
  95. data/lib/copland/models/singleton-deferred.rb +59 -0
  96. data/lib/copland/models/singleton.rb +77 -0
  97. data/lib/copland/models/threaded.rb +65 -0
  98. data/lib/copland/ordering.rb +123 -0
  99. data/lib/copland/package.rb +246 -0
  100. data/lib/copland/registry.rb +368 -0
  101. data/lib/copland/schema.rb +206 -0
  102. data/lib/copland/service-point.rb +282 -0
  103. data/lib/copland/utils.rb +221 -0
  104. data/lib/copland/version.rb +47 -0
  105. data/test/conf-test/list-bad-key.yml +30 -0
  106. data/test/conf-test/list-bad-missing.yml +28 -0
  107. data/test/conf-test/list-bad-type.yml +28 -0
  108. data/test/conf-test/list-good.yml +29 -0
  109. data/test/conf-test/map-bad-key.yml +25 -0
  110. data/test/conf-test/map-bad-missing.yml +24 -0
  111. data/test/conf-test/map-bad-type.yml +23 -0
  112. data/test/conf-test/map-good.yml +25 -0
  113. data/test/configuration-point/package.yml +52 -0
  114. data/test/configuration/yaml/config/copland-config.yml +2 -0
  115. data/test/configuration/yaml/config/module.yml +2 -0
  116. data/test/configuration/yaml/config/subdir/copland-config.yml +2 -0
  117. data/test/configuration/yaml/config/subdir/package.yml +4 -0
  118. data/test/configuration/yaml/defaults/package.yml +5 -0
  119. data/test/configuration/yaml/defaults/subdir/package.yml +4 -0
  120. data/test/configuration/yaml/tc_config-loader.rb +86 -0
  121. data/test/configuration/yaml/tc_configuration-point-processor.rb +134 -0
  122. data/test/configuration/yaml/tc_implementor-processor.rb +104 -0
  123. data/test/configuration/yaml/tc_interceptor-processor.rb +85 -0
  124. data/test/configuration/yaml/tc_listener-processor.rb +69 -0
  125. data/test/configuration/yaml/tc_loader.rb +74 -0
  126. data/test/configuration/yaml/tc_package-processor.rb +120 -0
  127. data/test/configuration/yaml/tc_parser.rb +94 -0
  128. data/test/configuration/yaml/tc_schema-parser.rb +160 -0
  129. data/test/configuration/yaml/tc_service-point-processor.rb +104 -0
  130. data/test/configuration/yaml/tc_type-validator.rb +90 -0
  131. data/test/custom-logger.yml +3 -0
  132. data/test/impl/logging/package.yml +44 -0
  133. data/test/impl/logging/services.rb +84 -0
  134. data/test/impl/startup/package.yml +46 -0
  135. data/test/impl/startup/services.rb +47 -0
  136. data/test/impl/symbols/package.yml +24 -0
  137. data/test/impl/symbols/services.rb +38 -0
  138. data/test/impl/tc_builder-factory.rb +173 -0
  139. data/test/impl/tc_logging-interceptor.rb +148 -0
  140. data/test/impl/tc_startup.rb +59 -0
  141. data/test/impl/tc_symbol-sources.rb +61 -0
  142. data/test/logger.yml +6 -0
  143. data/test/mock.rb +201 -0
  144. data/test/schema/bad-package.yml +65 -0
  145. data/test/schema/package.yml +102 -0
  146. data/test/schema/services.rb +5 -0
  147. data/test/services/package.yml +79 -0
  148. data/test/services/simple.rb +87 -0
  149. data/test/tc_class-factory.rb +93 -0
  150. data/test/tc_complex-instantiator.rb +107 -0
  151. data/test/tc_configuration-point-contrib.rb +74 -0
  152. data/test/tc_configuration-point-schema.rb +122 -0
  153. data/test/tc_configuration-point.rb +91 -0
  154. data/test/tc_default-schema-processor.rb +297 -0
  155. data/test/tc_identity-instantiator.rb +61 -0
  156. data/test/tc_interceptors.rb +84 -0
  157. data/test/tc_logger.rb +131 -0
  158. data/test/tc_models.rb +176 -0
  159. data/test/tc_package.rb +165 -0
  160. data/test/tc_proxy.rb +65 -0
  161. data/test/tc_registry.rb +141 -0
  162. data/test/tc_schema.rb +78 -0
  163. data/test/tc_service-point.rb +178 -0
  164. data/test/tc_service.rb +70 -0
  165. data/test/tc_simple-instantiator.rb +61 -0
  166. data/test/tests.rb +93 -0
  167. data/tutorial/01/main.rb +7 -0
  168. data/tutorial/01/package.yml +8 -0
  169. data/tutorial/01/tutorial.rb +7 -0
  170. data/tutorial/02/main.rb +10 -0
  171. data/tutorial/02/package.yml +27 -0
  172. data/tutorial/02/tutorial.rb +46 -0
  173. data/tutorial/03/main.rb +24 -0
  174. data/tutorial/03/package.yml +29 -0
  175. data/tutorial/03/tutorial.rb +48 -0
  176. data/tutorial/04/main.rb +24 -0
  177. data/tutorial/04/package.yml +35 -0
  178. data/tutorial/04/tutorial.rb +48 -0
  179. data/tutorial/05/functions/package.yml +16 -0
  180. data/tutorial/05/functions/services.rb +15 -0
  181. data/tutorial/05/main.rb +10 -0
  182. data/tutorial/05/package.yml +35 -0
  183. data/tutorial/05/tutorial.rb +53 -0
  184. metadata +260 -0
@@ -0,0 +1,439 @@
1
+ <html>
2
+ <head>
3
+ <title>copland.lib</title>
4
+ <link rel="stylesheet" type="text/css" href="packrat.css" />
5
+ </head>
6
+ <body>
7
+ <h1>copland.lib</h1>
8
+
9
+ <!-- INDEX OF PACKAGE CONTENTS -->
10
+
11
+
12
+ <div class="description">
13
+ This package contains additional services, providing functionality beyond that given by the core set of services in Copland itself. These additional services include a multicast service factory, a synchronizing interceptor, and more.
14
+ </div>
15
+
16
+
17
+ <div class="nav">
18
+ Return to
19
+
20
+ <a href="index.html">index</a>
21
+
22
+ </div>
23
+
24
+
25
+ <h3>Service Points</h3>
26
+ <ul>
27
+
28
+ <li><a href="copland.lib.html#BlockingInterceptor_sp">BlockingInterceptor</a></li>
29
+
30
+ <li><a href="copland.lib.html#ClassBuilderFactory_sp">ClassBuilderFactory</a></li>
31
+
32
+ <li><a href="copland.lib.html#ENVSymbolSource_sp">ENVSymbolSource</a></li>
33
+
34
+ <li><a href="copland.lib.html#MulticastFactory_sp">MulticastFactory</a></li>
35
+
36
+ <li><a href="copland.lib.html#RedirectingInterceptor_sp">RedirectingInterceptor</a></li>
37
+
38
+ <li><a href="copland.lib.html#RubySymbolSource_sp">RubySymbolSource</a></li>
39
+
40
+ <li><a href="copland.lib.html#SynchronizingInterceptor_sp">SynchronizingInterceptor</a></li>
41
+
42
+ </ul>
43
+
44
+
45
+
46
+
47
+
48
+
49
+ <!-- SERVICE POINTS -->
50
+
51
+
52
+ <h2>Service Points</h2>
53
+
54
+
55
+ <h3><a name="BlockingInterceptor_sp">BlockingInterceptor</a> <small><em>(singleton)</em></small></h3>
56
+
57
+ <div class="item-body">
58
+
59
+
60
+ <p class="description">
61
+ Blocks access to certain messages, effectively limiting the interface of the service it wraps. The definition of the interceptor can specify the behavior when a blocked message is intercepted, either failing silently, or raising an exception.
62
+ </p>
63
+
64
+
65
+ <h4>Implementor</h4>
66
+ <div class="definition-item">
67
+
68
+ copland/lib/blocking-interceptor/Copland::Library::BlockingInterceptorFactory
69
+
70
+ </div>
71
+
72
+
73
+ <h4>Schema</h4>
74
+ <div class="definition-item">
75
+
76
+
77
+
78
+
79
+ <div class="schema-item-title">Extends <a href="copland.html#IncludeExcludeSchema_scm">copland.IncludeExcludeSchema</a></div>
80
+
81
+
82
+
83
+
84
+
85
+ <div class="schema-item">
86
+
87
+ <div class="subschema-name">
88
+ behavior
89
+ [string]
90
+
91
+ </div>
92
+ <div class="subschema">
93
+
94
+ <div class="description">
95
+ This should be either "silent", or the name of an exception to raise. It describes the behavior to select when a message is blocked. It defaults to "NoMethodError".
96
+ </div>
97
+
98
+
99
+
100
+
101
+
102
+
103
+
104
+
105
+ </div>
106
+ </div>
107
+
108
+
109
+ </div>
110
+
111
+
112
+
113
+
114
+
115
+
116
+ </div>
117
+
118
+
119
+ <h3><a name="ClassBuilderFactory_sp">ClassBuilderFactory</a> <small><em>(singleton)</em></small></h3>
120
+
121
+ <div class="item-body">
122
+
123
+
124
+ <p class="description">
125
+ This is just like BuilderFactory, but it works on classes instead of objects. That is to say, instead of instantiating an object, it instead just returns a class reference. This is useful for backing a service with a class instead of an object.
126
+ </p>
127
+
128
+
129
+ <h4>Implementor</h4>
130
+ <div class="definition-item">
131
+
132
+ copland/lib/class-builder-factory/Copland::Library::ClassBuilderFactory
133
+
134
+ </div>
135
+
136
+
137
+ <h4>Schema</h4>
138
+ <div class="definition-item">
139
+
140
+
141
+
142
+
143
+
144
+
145
+
146
+ <div class="schema-item">
147
+
148
+ <div class="subschema-name">
149
+ class
150
+ [string]
151
+ <em>(required)</em>
152
+ </div>
153
+ <div class="subschema">
154
+
155
+ <div class="description">
156
+ That path to class to return. This has the same format as for BuilderFactory.
157
+ </div>
158
+
159
+
160
+
161
+
162
+
163
+
164
+
165
+
166
+ </div>
167
+ <div class="subschema-name">
168
+ initialize-method
169
+ [string]
170
+
171
+ </div>
172
+ <div class="subschema">
173
+
174
+ <div class="description">
175
+ This describes the name of the (class) method to invoke when the service has been completely initialized (and all properties wired into it). This defaults to "initialize_service". If the method does not exist, then nothing is invoked.
176
+ </div>
177
+
178
+
179
+
180
+
181
+
182
+
183
+
184
+
185
+ </div>
186
+ <div class="subschema-name">
187
+ properties
188
+ [hash]
189
+
190
+ </div>
191
+ <div class="subschema">
192
+
193
+ <div class="description">
194
+ A hash of properties to set on the class. First, setters are searched for, of the format "name=" or "set_name". If one is found, it will be invoked. Otherwise, the properties are set directly using "class_eval".
195
+ </div>
196
+
197
+
198
+
199
+
200
+
201
+
202
+
203
+
204
+ </div>
205
+ </div>
206
+
207
+
208
+ </div>
209
+
210
+
211
+
212
+
213
+
214
+
215
+ </div>
216
+
217
+
218
+ <h3><a name="ENVSymbolSource_sp">ENVSymbolSource</a> <small><em>(singleton)</em></small></h3>
219
+
220
+ <div class="item-body">
221
+
222
+
223
+ <p class="description">
224
+ A symbol source that draws its values from the ENV hash. This source is not made available by default--applications wishing to use it must manually add it to the copland.SymbolSources configuration point.
225
+ </p>
226
+
227
+
228
+ <h4>Implementor</h4>
229
+ <div class="definition-item">
230
+
231
+ copland/lib/env-symbol-source/Copland::Library::ENVSymbolSource
232
+
233
+ </div>
234
+
235
+
236
+
237
+
238
+
239
+
240
+
241
+ </div>
242
+
243
+
244
+ <h3><a name="MulticastFactory_sp">MulticastFactory</a> <small><em>(singleton)</em></small></h3>
245
+
246
+ <div class="item-body">
247
+
248
+
249
+ <p class="description">
250
+ A specialized builder factory for constructing a multicast service. A multicast service is one which will forward any messages it recieves to all registered targets.
251
+ </p>
252
+
253
+
254
+ <h4>Implementor</h4>
255
+ <div class="definition-item">
256
+
257
+ copland/lib/multicast-factory/Copland::Library::MulticastFactory
258
+
259
+ </div>
260
+
261
+
262
+ <h4>Schema</h4>
263
+ <div class="definition-item">
264
+
265
+
266
+
267
+
268
+
269
+
270
+
271
+ <div class="schema-item">
272
+
273
+ <div class="subschema-name">
274
+ targets
275
+ [configuration]
276
+ <em>(required)</em>
277
+ </div>
278
+ <div class="subschema">
279
+
280
+ <div class="description">
281
+ This must be a 'list' configuration point, where each element in the list must be a service to forward messages to.
282
+ </div>
283
+
284
+
285
+
286
+
287
+
288
+
289
+
290
+
291
+ </div>
292
+ </div>
293
+
294
+
295
+ </div>
296
+
297
+
298
+
299
+
300
+
301
+
302
+ </div>
303
+
304
+
305
+ <h3><a name="RedirectingInterceptor_sp">RedirectingInterceptor</a> <small><em>(singleton)</em></small></h3>
306
+
307
+ <div class="item-body">
308
+
309
+
310
+ <p class="description">
311
+ Redirects incoming messages, so that a message A might get rerouted to message B. You can do more complex redirections as well, specifying a regular expression and a replacement pattern. Any message not matching one of the patterns will be routed through, unchanged.
312
+ </p>
313
+
314
+
315
+ <h4>Implementor</h4>
316
+ <div class="definition-item">
317
+
318
+ copland/lib/redirecting-interceptor/Copland::Library::RedirectingInterceptorFactory
319
+
320
+ </div>
321
+
322
+
323
+ <h4>Schema</h4>
324
+ <div class="definition-item">
325
+
326
+
327
+
328
+
329
+
330
+
331
+
332
+ <div class="schema-item">
333
+
334
+ <div class="subschema-name">
335
+ redirect
336
+ [any]
337
+ <em>(required)</em>
338
+ </div>
339
+ <div class="subschema">
340
+
341
+ <div class="description">
342
+ This should be either a hash or a map configuration point that defines the mappings for redirection. Each key should be a regular expression (implicitly wrapped in "^(.*)$"), and the value should be a string (possibly containing literals of the form "\1", for substituting the corresponding subgroup in the pattern).
343
+ </div>
344
+
345
+
346
+
347
+
348
+
349
+
350
+
351
+
352
+ </div>
353
+ </div>
354
+
355
+
356
+ </div>
357
+
358
+
359
+
360
+
361
+
362
+
363
+ </div>
364
+
365
+
366
+ <h3><a name="RubySymbolSource_sp">RubySymbolSource</a> <small><em>(singleton)</em></small></h3>
367
+
368
+ <div class="item-body">
369
+
370
+
371
+ <p class="description">
372
+ A symbol source that draws its values from the Config::CONFIG hash. This source is not made available by default--applications wishing to use it must manually add it to the copland.SymbolSources configuration point.
373
+ </p>
374
+
375
+
376
+ <h4>Implementor</h4>
377
+ <div class="definition-item">
378
+
379
+ copland/lib/ruby-symbol-source/Copland::Library::RubySymbolSource
380
+
381
+ </div>
382
+
383
+
384
+
385
+
386
+
387
+
388
+
389
+ </div>
390
+
391
+
392
+ <h3><a name="SynchronizingInterceptor_sp">SynchronizingInterceptor</a> <small><em>(singleton)</em></small></h3>
393
+
394
+ <div class="item-body">
395
+
396
+
397
+ <p class="description">
398
+ An interceptor that wraps each invocation of a service's methods inside a mutex's synchronization block. Each method is protected by its own mutex.
399
+ </p>
400
+
401
+
402
+ <h4>Implementor</h4>
403
+ <div class="definition-item">
404
+
405
+ copland/lib/synchronizing-interceptor/Copland::Library::SynchronizingInterceptorFactory
406
+
407
+ </div>
408
+
409
+
410
+ <h4>Schema</h4>
411
+ <div class="definition-item">
412
+ <a href="copland.html#IncludeExcludeSchema_scm">copland.IncludeExcludeSchema</a>
413
+ </div>
414
+
415
+
416
+
417
+
418
+
419
+
420
+ </div>
421
+
422
+
423
+
424
+
425
+ <!-- CONFIGURATION POINTS -->
426
+
427
+
428
+
429
+ <!-- SCHEMAS -->
430
+
431
+
432
+ <div class="generated-by">
433
+ Generated by
434
+ <a href="http://copland.rubyforge.org">Copland</a>'s
435
+ Packrat documentation extractor
436
+ on Sun Sep 26 21:37:13 MDT 2004
437
+ </div>
438
+ </body>
439
+ </html>
@@ -0,0 +1,2096 @@
1
+ <html>
2
+ <head>
3
+ <title>copland.remote</title>
4
+ <link rel="stylesheet" type="text/css" href="packrat.css" />
5
+ </head>
6
+ <body>
7
+ <h1>copland.remote</h1>
8
+
9
+ <!-- INDEX OF PACKAGE CONTENTS -->
10
+
11
+
12
+ <div class="description">
13
+ The copland.remote package is where standard Copland services dealing with remote access to services or servers are kept.
14
+ </div>
15
+
16
+
17
+ <div class="nav">
18
+ Return to
19
+
20
+ <a href="index.html">index</a>
21
+
22
+ </div>
23
+
24
+
25
+ <h3>Service Points</h3>
26
+ <ul>
27
+
28
+ <li><a href="copland.remote.html#DRbServerFactory_sp">DRbServerFactory</a></li>
29
+
30
+ <li><a href="copland.remote.html#DRbServiceFactory_sp">DRbServiceFactory</a></li>
31
+
32
+ <li><a href="copland.remote.html#DefaultDRbServer_sp">DefaultDRbServer</a></li>
33
+
34
+ <li><a href="copland.remote.html#DefaultSOAPServer_sp">DefaultSOAPServer</a></li>
35
+
36
+ <li><a href="copland.remote.html#DefaultXMLRPCServer_sp">DefaultXMLRPCServer</a></li>
37
+
38
+ <li><a href="copland.remote.html#SOAPServerFactory_sp">SOAPServerFactory</a></li>
39
+
40
+ <li><a href="copland.remote.html#SOAPServiceFactory_sp">SOAPServiceFactory</a></li>
41
+
42
+ <li><a href="copland.remote.html#XMLRPCServerFactory_sp">XMLRPCServerFactory</a></li>
43
+
44
+ <li><a href="copland.remote.html#XMLRPCServiceFactory_sp">XMLRPCServiceFactory</a></li>
45
+
46
+ </ul>
47
+
48
+
49
+
50
+ <h3>Configuration Points</h3>
51
+ <ul>
52
+
53
+ <li><a href="copland.remote.html#DefaultDRbServerConfiguration_cp">DefaultDRbServerConfiguration</a></li>
54
+
55
+ <li><a href="copland.remote.html#DefaultDRbServerExport_cp">DefaultDRbServerExport</a></li>
56
+
57
+ <li><a href="copland.remote.html#DefaultSOAPServerConfiguration_cp">DefaultSOAPServerConfiguration</a></li>
58
+
59
+ <li><a href="copland.remote.html#DefaultSOAPServices_cp">DefaultSOAPServices</a></li>
60
+
61
+ <li><a href="copland.remote.html#DefaultXMLRPCServerConfiguration_cp">DefaultXMLRPCServerConfiguration</a></li>
62
+
63
+ <li><a href="copland.remote.html#DefaultXMLRPCServices_cp">DefaultXMLRPCServices</a></li>
64
+
65
+ </ul>
66
+
67
+
68
+
69
+ <h3>Schemas</h3>
70
+ <ul>
71
+
72
+ <li><a href="copland.remote.html#DRbServerConfiguration_scm">DRbServerConfiguration</a></li>
73
+
74
+ <li><a href="copland.remote.html#DRbServerExport_scm">DRbServerExport</a></li>
75
+
76
+ <li><a href="copland.remote.html#SOAPServerConfiguration_scm">SOAPServerConfiguration</a></li>
77
+
78
+ <li><a href="copland.remote.html#SOAPServices_scm">SOAPServices</a></li>
79
+
80
+ <li><a href="copland.remote.html#XMLRPCServerConfiguration_scm">XMLRPCServerConfiguration</a></li>
81
+
82
+ <li><a href="copland.remote.html#XMLRPCServices_scm">XMLRPCServices</a></li>
83
+
84
+ </ul>
85
+
86
+
87
+ <!-- SERVICE POINTS -->
88
+
89
+
90
+ <h2>Service Points</h2>
91
+
92
+
93
+ <h3><a name="DRbServerFactory_sp">DRbServerFactory</a> <small><em>(singleton)</em></small></h3>
94
+
95
+ <div class="item-body">
96
+
97
+
98
+ <p class="description">
99
+ This factory service will create new DRb servers, based on the configuration given. Each server may export a single Copland service, and may specify which methods of the service to export (and even alias them, if desired).
100
+ </p>
101
+
102
+
103
+ <h4>Implementor</h4>
104
+ <div class="definition-item">
105
+
106
+ copland/remote/drb-server-factory/Copland::Remote::DRbServerFactory
107
+
108
+ </div>
109
+
110
+
111
+ <h4>Schema</h4>
112
+ <div class="definition-item">
113
+
114
+ <div class="description">
115
+ One of 'export' and 'export-configuration' must always be specified.
116
+ </div>
117
+
118
+
119
+
120
+
121
+
122
+
123
+
124
+ <div class="schema-item">
125
+
126
+ <div class="subschema-name">
127
+ export
128
+
129
+
130
+ </div>
131
+ <div class="subschema">
132
+
133
+
134
+
135
+
136
+
137
+
138
+
139
+ <div class="schema-item">
140
+
141
+ <div class="subschema-name">
142
+ service
143
+ [service]
144
+ <em>(required)</em>
145
+ </div>
146
+ <div class="subschema">
147
+
148
+ <div class="description">
149
+ A reference tot he service to export.
150
+ </div>
151
+
152
+
153
+
154
+
155
+
156
+
157
+
158
+
159
+ </div>
160
+ <div class="subschema-name">
161
+ methods
162
+ [array]
163
+
164
+ </div>
165
+ <div class="subschema">
166
+
167
+ <div class="description">
168
+ A list of the methods to export. It may be a list of strings or hashes, or a combination of the two. Where an element is a string, it is the name of the method to export. Where it is a hash, it must contain a "name" key (defining the name of the method to export), and may contain an "alias" key (defining the name by which the method ought to be exported).
169
+ </div>
170
+
171
+
172
+
173
+
174
+
175
+
176
+
177
+
178
+ </div>
179
+ </div>
180
+
181
+
182
+ </div>
183
+ <div class="subschema-name">
184
+ export-configuration
185
+ [configuration]
186
+
187
+ </div>
188
+ <div class="subschema">
189
+
190
+ <div class="description">
191
+ A configuration point that ought to have the DRbServerExport schema. If 'export' is given, then this option should not be given, and vice versa.
192
+ </div>
193
+
194
+
195
+
196
+
197
+
198
+
199
+
200
+
201
+ </div>
202
+ <div class="subschema-name">
203
+ setup
204
+
205
+
206
+ </div>
207
+ <div class="subschema">
208
+
209
+
210
+
211
+
212
+
213
+
214
+
215
+ <div class="schema-item">
216
+
217
+ <div class="subschema-name">
218
+ server.auto.start
219
+ [boolean]
220
+
221
+ </div>
222
+ <div class="subschema">
223
+
224
+ <div class="description">
225
+ Whether or not the server should be started when the service is instantiated. If false, then the application must start the service manually.
226
+ </div>
227
+
228
+
229
+
230
+
231
+
232
+
233
+
234
+
235
+ </div>
236
+ <div class="subschema-name">
237
+ server.bind.address
238
+ [string]
239
+
240
+ </div>
241
+ <div class="subschema">
242
+
243
+ <div class="description">
244
+ The address that the server should bind to. This defaults to "127.0.0.1", which means that (by default) the server will not accept connections from other machines.
245
+ </div>
246
+
247
+
248
+
249
+
250
+
251
+
252
+
253
+
254
+ </div>
255
+ <div class="subschema-name">
256
+ server.port
257
+ [integer]
258
+
259
+ </div>
260
+ <div class="subschema">
261
+
262
+ <div class="description">
263
+ The port that the server will listen on.
264
+ </div>
265
+
266
+
267
+
268
+
269
+
270
+
271
+
272
+
273
+ </div>
274
+ <div class="subschema-name">
275
+ server.use-log
276
+ [boolean]
277
+
278
+ </div>
279
+ <div class="subschema">
280
+
281
+ <div class="description">
282
+ Whether or not a log should be created for the new service. Default to false.
283
+ </div>
284
+
285
+
286
+
287
+
288
+
289
+
290
+
291
+
292
+ </div>
293
+ </div>
294
+
295
+
296
+ </div>
297
+ <div class="subschema-name">
298
+ setup-configuration
299
+ [configuration]
300
+
301
+ </div>
302
+ <div class="subschema">
303
+
304
+ <div class="description">
305
+ A configuration point that ought to have the DRbServerConfiguration schema. If 'setup' is given, then this option should not be given, and vice versa.
306
+ </div>
307
+
308
+
309
+
310
+
311
+
312
+
313
+
314
+
315
+ </div>
316
+ </div>
317
+
318
+
319
+ </div>
320
+
321
+
322
+
323
+
324
+
325
+
326
+ </div>
327
+
328
+
329
+ <h3><a name="DRbServiceFactory_sp">DRbServiceFactory</a> <small><em>(singleton)</em></small></h3>
330
+
331
+ <div class="item-body">
332
+
333
+
334
+ <p class="description">
335
+ This factory allows remote Ruby objects (exported via DRb) to be wrapped transparently as services.
336
+ </p>
337
+
338
+
339
+ <h4>Implementor</h4>
340
+ <div class="definition-item">
341
+
342
+ copland/remote/drb-service-factory/Copland::Remote::DRbServiceFactory
343
+
344
+ </div>
345
+
346
+
347
+ <h4>Schema</h4>
348
+ <div class="definition-item">
349
+
350
+
351
+
352
+
353
+
354
+
355
+
356
+ <div class="schema-item">
357
+
358
+ <div class="subschema-name">
359
+ uri
360
+ [string]
361
+ <em>(required)</em>
362
+ </div>
363
+ <div class="subschema">
364
+
365
+ <div class="description">
366
+ The URI of the remote object to wrap.
367
+ </div>
368
+
369
+
370
+
371
+
372
+
373
+
374
+
375
+
376
+ </div>
377
+ </div>
378
+
379
+
380
+ </div>
381
+
382
+
383
+
384
+
385
+
386
+
387
+ </div>
388
+
389
+
390
+ <h3><a name="DefaultDRbServer_sp">DefaultDRbServer</a> <small><em>(singleton-deferred)</em></small></h3>
391
+
392
+ <div class="item-body">
393
+
394
+
395
+ <p class="description">
396
+ A default DRb server that applications may configure. If more than one DRb server is needed, then the application should create its own servers using the DRbServerFactory.
397
+ </p>
398
+
399
+
400
+ <h4>Implementor</h4>
401
+ <div class="definition-item">
402
+
403
+ <ul>
404
+ <li>factory: <a href="copland.remote.html#DRbServerFactory_sp">copland.remote.DRbServerFactory</a></li>
405
+
406
+ <li>export-configuration: !!configuration <a href="copland.remote.html#DefaultDRbServerExport_cp">copland.remote.DefaultDRbServerExport</a></li><li>setup-configuration: !!configuration <a href="copland.remote.html#DefaultDRbServerConfiguration_cp">copland.remote.DefaultDRbServerConfiguration</a></li>
407
+
408
+ </ul>
409
+
410
+ </div>
411
+
412
+
413
+
414
+
415
+
416
+
417
+
418
+ </div>
419
+
420
+
421
+ <h3><a name="DefaultSOAPServer_sp">DefaultSOAPServer</a> <small><em>(singleton-deferred)</em></small></h3>
422
+
423
+ <div class="item-body">
424
+
425
+
426
+ <p class="description">
427
+ A default SOAP server that applications may configure and use. If an application requires more than one SOAP server, it should set them up manually via the SOAPServerFactory service.
428
+ </p>
429
+
430
+
431
+ <h4>Implementor</h4>
432
+ <div class="definition-item">
433
+
434
+ <ul>
435
+ <li>factory: <a href="copland.remote.html#SOAPServerFactory_sp">copland.remote.SOAPServerFactory</a></li>
436
+
437
+ <li>services-configuration: !!configuration <a href="copland.remote.html#DefaultSOAPServices_cp">copland.remote.DefaultSOAPServices</a></li><li>setup-configuration: !!configuration <a href="copland.remote.html#DefaultSOAPServerConfiguration_cp">copland.remote.DefaultSOAPServerConfiguration</a></li>
438
+
439
+ </ul>
440
+
441
+ </div>
442
+
443
+
444
+
445
+
446
+
447
+
448
+
449
+ </div>
450
+
451
+
452
+ <h3><a name="DefaultXMLRPCServer_sp">DefaultXMLRPCServer</a> <small><em>(singleton-deferred)</em></small></h3>
453
+
454
+ <div class="item-body">
455
+
456
+
457
+ <p class="description">
458
+ This service will create a an XMLRPC server instance.
459
+ </p>
460
+
461
+
462
+ <h4>Implementor</h4>
463
+ <div class="definition-item">
464
+
465
+ <ul>
466
+ <li>factory: <a href="copland.remote.html#XMLRPCServerFactory_sp">copland.remote.XMLRPCServerFactory</a></li>
467
+
468
+ <li>services-configuration: !!configuration <a href="copland.remote.html#DefaultXMLRPCServices_cp">copland.remote.DefaultXMLRPCServices</a></li><li>setup-configuration: !!configuration <a href="copland.remote.html#DefaultXMLRPCServerConfiguration_cp">copland.remote.DefaultXMLRPCServerConfiguration</a></li>
469
+
470
+ </ul>
471
+
472
+ </div>
473
+
474
+
475
+
476
+
477
+
478
+
479
+
480
+ </div>
481
+
482
+
483
+ <h3><a name="SOAPServerFactory_sp">SOAPServerFactory</a> <small><em>(singleton)</em></small></h3>
484
+
485
+ <div class="item-body">
486
+
487
+
488
+ <p class="description">
489
+ This service creates new SOAP servers, based on the configuration given. This allows applications to define multiple SOAP servers. If an application only needs one, it will be easier just to use the predefined DefaultSOAPServer service.
490
+ </p>
491
+
492
+
493
+ <h4>Implementor</h4>
494
+ <div class="definition-item">
495
+
496
+ copland/remote/soap-server-factory/Copland::Remote::SOAPServerFactory
497
+
498
+ </div>
499
+
500
+
501
+ <h4>Schema</h4>
502
+ <div class="definition-item">
503
+
504
+ <div class="description">
505
+ One of 'services' and 'services-configuration' must always be specified. When given, only one of 'setup' and 'setup-configuration' should be given as well.
506
+ </div>
507
+
508
+
509
+
510
+
511
+
512
+
513
+
514
+ <div class="schema-item">
515
+
516
+ <div class="subschema-name">
517
+ services
518
+
519
+
520
+ </div>
521
+ <div class="subschema">
522
+
523
+
524
+
525
+
526
+
527
+
528
+
529
+ <div class="schema-item">
530
+
531
+ <div class="subschema-name">
532
+ namespace
533
+ [string]
534
+ <em>(required)</em>
535
+ </div>
536
+ <div class="subschema">
537
+
538
+ <div class="description">
539
+ The name by which remote clients should request this service.
540
+ </div>
541
+
542
+
543
+
544
+
545
+
546
+
547
+
548
+
549
+ </div>
550
+ <div class="subschema-name">
551
+ service
552
+ [service]
553
+ <em>(required)</em>
554
+ </div>
555
+ <div class="subschema">
556
+
557
+ <div class="description">
558
+ The service to export.
559
+ </div>
560
+
561
+
562
+
563
+
564
+
565
+
566
+
567
+
568
+ </div>
569
+ <div class="subschema-name">
570
+ methods
571
+ [array]
572
+
573
+ </div>
574
+ <div class="subschema">
575
+
576
+ <div class="description">
577
+ The list of methods that should be exported by this service. Each element of the list ought to be either a string (naming a method), or a hash. The hash must have at least the "name" key (to identify the method to export), and may optionally have an "alias" key (to identify the name by which the method should be exported).
578
+ </div>
579
+
580
+
581
+
582
+
583
+
584
+
585
+
586
+
587
+ </div>
588
+ </div>
589
+
590
+
591
+ </div>
592
+ <div class="subschema-name">
593
+ services-configuration
594
+ [configuration]
595
+
596
+ </div>
597
+ <div class="subschema">
598
+
599
+ <div class="description">
600
+ A configuration point that ought to have the SOAPServices schema. If 'services' is given, then this option should not be given, and vice versa.
601
+ </div>
602
+
603
+
604
+
605
+
606
+
607
+
608
+
609
+
610
+ </div>
611
+ <div class="subschema-name">
612
+ setup
613
+
614
+
615
+ </div>
616
+ <div class="subschema">
617
+
618
+
619
+
620
+
621
+
622
+
623
+
624
+ <div class="schema-item">
625
+
626
+ <div class="subschema-name">
627
+ server.auto.start
628
+ [boolean]
629
+
630
+ </div>
631
+ <div class="subschema">
632
+
633
+ <div class="description">
634
+ Whether or not the server should be started when the service is instantiated. If false, then the application must start the service manually.
635
+ </div>
636
+
637
+
638
+
639
+
640
+
641
+
642
+
643
+
644
+ </div>
645
+ <div class="subschema-name">
646
+ server.bind.address
647
+ [string]
648
+
649
+ </div>
650
+ <div class="subschema">
651
+
652
+ <div class="description">
653
+ The address that the server should bind to. This defaults to "127.0.0.1", which means that (by default) the server will not accept connections from other machines.
654
+ </div>
655
+
656
+
657
+
658
+
659
+
660
+
661
+
662
+
663
+ </div>
664
+ <div class="subschema-name">
665
+ server.port
666
+ [integer]
667
+
668
+ </div>
669
+ <div class="subschema">
670
+
671
+ <div class="description">
672
+ The port that the server will listen on.
673
+ </div>
674
+
675
+
676
+
677
+
678
+
679
+
680
+
681
+
682
+ </div>
683
+ <div class="subschema-name">
684
+ server.use-log
685
+ [boolean]
686
+
687
+ </div>
688
+ <div class="subschema">
689
+
690
+ <div class="description">
691
+ Whether or not a log should be created for the new service. Default to false.
692
+ </div>
693
+
694
+
695
+
696
+
697
+
698
+
699
+
700
+
701
+ </div>
702
+ </div>
703
+
704
+
705
+ </div>
706
+ <div class="subschema-name">
707
+ setup-configuration
708
+ [configuration]
709
+
710
+ </div>
711
+ <div class="subschema">
712
+
713
+ <div class="description">
714
+ A configuration point that ought to have the DRbServerConfiguration schema. If 'setup' is given, then this option should not be given, and vice versa.
715
+ </div>
716
+
717
+
718
+
719
+
720
+
721
+
722
+
723
+
724
+ </div>
725
+ </div>
726
+
727
+
728
+ </div>
729
+
730
+
731
+
732
+
733
+
734
+
735
+ </div>
736
+
737
+
738
+ <h3><a name="SOAPServiceFactory_sp">SOAPServiceFactory</a> <small><em>(singleton)</em></small></h3>
739
+
740
+ <div class="item-body">
741
+
742
+
743
+ <p class="description">
744
+ This factory allows remote objects (exported via SOAP) to be wrapped transparently as services.
745
+ </p>
746
+
747
+
748
+ <h4>Implementor</h4>
749
+ <div class="definition-item">
750
+
751
+ copland/remote/soap-service-factory/Copland::Remote::SOAPServiceFactory
752
+
753
+ </div>
754
+
755
+
756
+ <h4>Schema</h4>
757
+ <div class="definition-item">
758
+
759
+
760
+
761
+
762
+
763
+
764
+
765
+ <div class="schema-item">
766
+
767
+ <div class="subschema-name">
768
+ methods
769
+ [array]
770
+ <em>(required)</em>
771
+ </div>
772
+ <div class="subschema">
773
+
774
+ <div class="description">
775
+ The array of methods to be imported from the remote object.
776
+ </div>
777
+
778
+
779
+
780
+
781
+
782
+
783
+
784
+ <div class="schema-item">
785
+
786
+ <div class="subschema-name">
787
+ name
788
+ [string]
789
+ <em>(required)</em>
790
+ </div>
791
+ <div class="subschema">
792
+
793
+ <div class="description">
794
+ The method name to export.
795
+ </div>
796
+
797
+
798
+
799
+
800
+
801
+
802
+
803
+
804
+ </div>
805
+ <div class="subschema-name">
806
+ alias
807
+ [string]
808
+
809
+ </div>
810
+ <div class="subschema">
811
+
812
+ <div class="description">
813
+ The name that the method should be exported as.
814
+ </div>
815
+
816
+
817
+
818
+
819
+
820
+
821
+
822
+
823
+ </div>
824
+ <div class="subschema-name">
825
+ fixed-args
826
+ [integer]
827
+
828
+ </div>
829
+ <div class="subschema">
830
+
831
+ <div class="description">
832
+ The number of fixed arguments for this method. If this value is >= 0, then the method is assumed to be variable arity, with the parameter at index "fixed-args" being the one that collects all subsequent arguments.
833
+ </div>
834
+
835
+
836
+
837
+
838
+
839
+
840
+
841
+
842
+ </div>
843
+ <div class="subschema-name">
844
+ parameters
845
+ [array]
846
+
847
+ </div>
848
+ <div class="subschema">
849
+
850
+ <div class="description">
851
+ This is an array of strings that name the parameters to the method.
852
+ </div>
853
+
854
+
855
+
856
+
857
+
858
+
859
+
860
+
861
+ </div>
862
+ </div>
863
+
864
+
865
+ </div>
866
+ <div class="subschema-name">
867
+ name
868
+ [string]
869
+ <em>(required)</em>
870
+ </div>
871
+ <div class="subschema">
872
+
873
+ <div class="description">
874
+ The name of the remote object to wrap, as registered on the remote host.
875
+ </div>
876
+
877
+
878
+
879
+
880
+
881
+
882
+
883
+
884
+ </div>
885
+ <div class="subschema-name">
886
+ url
887
+ [string]
888
+ <em>(required)</em>
889
+ </div>
890
+ <div class="subschema">
891
+
892
+ <div class="description">
893
+ The URL of the remote object to wrap.
894
+ </div>
895
+
896
+
897
+
898
+
899
+
900
+
901
+
902
+
903
+ </div>
904
+ </div>
905
+
906
+
907
+ </div>
908
+
909
+
910
+
911
+
912
+
913
+
914
+ </div>
915
+
916
+
917
+ <h3><a name="XMLRPCServerFactory_sp">XMLRPCServerFactory</a> <small><em>(singleton)</em></small></h3>
918
+
919
+ <div class="item-body">
920
+
921
+
922
+ <p class="description">
923
+ This service creates new XML-RPC server instances, based on the configuration given to it.
924
+ </p>
925
+
926
+
927
+ <h4>Implementor</h4>
928
+ <div class="definition-item">
929
+
930
+ copland/remote/xmlrpc-server-factory/Copland::Remote::XMLRPCServerFactory
931
+
932
+ </div>
933
+
934
+
935
+ <h4>Schema</h4>
936
+ <div class="definition-item">
937
+
938
+
939
+
940
+
941
+
942
+
943
+
944
+ <div class="schema-item">
945
+
946
+ <div class="subschema-name">
947
+ services
948
+
949
+
950
+ </div>
951
+ <div class="subschema">
952
+
953
+
954
+
955
+
956
+
957
+
958
+
959
+ <div class="schema-item">
960
+
961
+ <div class="subschema-name">
962
+ prefix
963
+ [string]
964
+ <em>(required)</em>
965
+ </div>
966
+ <div class="subschema">
967
+
968
+ <div class="description">
969
+ The name by which remote clients should request this service.
970
+ </div>
971
+
972
+
973
+
974
+
975
+
976
+
977
+
978
+
979
+ </div>
980
+ <div class="subschema-name">
981
+ service
982
+ [service]
983
+ <em>(required)</em>
984
+ </div>
985
+ <div class="subschema">
986
+
987
+ <div class="description">
988
+ The service to export.
989
+ </div>
990
+
991
+
992
+
993
+
994
+
995
+
996
+
997
+
998
+ </div>
999
+ <div class="subschema-name">
1000
+ interface
1001
+ [array]
1002
+
1003
+ </div>
1004
+ <div class="subschema">
1005
+
1006
+ <div class="description">
1007
+ An array of maps that describe the methods that this service should export.
1008
+ </div>
1009
+
1010
+
1011
+
1012
+
1013
+
1014
+
1015
+
1016
+ <div class="schema-item">
1017
+
1018
+ <div class="subschema-name">
1019
+ signature
1020
+ [string]
1021
+ <em>(required)</em>
1022
+ </div>
1023
+ <div class="subschema">
1024
+
1025
+ <div class="description">
1026
+ A valid XMLRPC signature for the method. This is the name by which the method will be invoked.
1027
+ </div>
1028
+
1029
+
1030
+
1031
+
1032
+
1033
+
1034
+
1035
+
1036
+ </div>
1037
+ <div class="subschema-name">
1038
+ help
1039
+ [string]
1040
+
1041
+ </div>
1042
+ <div class="subschema">
1043
+
1044
+ <div class="description">
1045
+ This is just arbitrary text that describes this method and what it does. It is useful for XMLRPC clients to query, to know what an interface is capable of.
1046
+ </div>
1047
+
1048
+
1049
+
1050
+
1051
+
1052
+
1053
+
1054
+
1055
+ </div>
1056
+ <div class="subschema-name">
1057
+ method
1058
+ [string]
1059
+
1060
+ </div>
1061
+ <div class="subschema">
1062
+
1063
+ <div class="description">
1064
+ This is the actual method name (as declared in the service), if it differs from the name given in the signature. This allows for aliasing of method names.
1065
+ </div>
1066
+
1067
+
1068
+
1069
+
1070
+
1071
+
1072
+
1073
+
1074
+ </div>
1075
+ </div>
1076
+
1077
+
1078
+ </div>
1079
+ </div>
1080
+
1081
+
1082
+ </div>
1083
+ <div class="subschema-name">
1084
+ services-configuration
1085
+ [configuration]
1086
+
1087
+ </div>
1088
+ <div class="subschema">
1089
+
1090
+ <div class="description">
1091
+ A configuration point that ought to have the XMLRPCServices schema. If 'services' is given, then this option should not be given, and vice versa.
1092
+ </div>
1093
+
1094
+
1095
+
1096
+
1097
+
1098
+
1099
+
1100
+
1101
+ </div>
1102
+ <div class="subschema-name">
1103
+ setup
1104
+
1105
+
1106
+ </div>
1107
+ <div class="subschema">
1108
+
1109
+
1110
+
1111
+
1112
+
1113
+
1114
+
1115
+ <div class="schema-item">
1116
+
1117
+ <div class="subschema-name">
1118
+ max.connections
1119
+ [integer]
1120
+
1121
+ </div>
1122
+ <div class="subschema">
1123
+
1124
+ <div class="description">
1125
+ The maximum number of concurrent connections.
1126
+ </div>
1127
+
1128
+
1129
+
1130
+
1131
+
1132
+
1133
+
1134
+
1135
+ </div>
1136
+ <div class="subschema-name">
1137
+ server.auto.start
1138
+ [boolean]
1139
+
1140
+ </div>
1141
+ <div class="subschema">
1142
+
1143
+ <div class="description">
1144
+ Whether or not the server should start as soon as the service is instantiated.
1145
+ </div>
1146
+
1147
+
1148
+
1149
+
1150
+
1151
+
1152
+
1153
+
1154
+ </div>
1155
+ <div class="subschema-name">
1156
+ server.bind.address
1157
+ [string]
1158
+
1159
+ </div>
1160
+ <div class="subschema">
1161
+
1162
+ <div class="description">
1163
+ The address that the server should bind to.
1164
+ </div>
1165
+
1166
+
1167
+
1168
+
1169
+
1170
+
1171
+
1172
+
1173
+ </div>
1174
+ <div class="subschema-name">
1175
+ server.port
1176
+ [integer]
1177
+
1178
+ </div>
1179
+ <div class="subschema">
1180
+
1181
+ <div class="description">
1182
+ The port that the server should listen on.
1183
+ </div>
1184
+
1185
+
1186
+
1187
+
1188
+
1189
+
1190
+
1191
+
1192
+ </div>
1193
+ <div class="subschema-name">
1194
+ server.use-log
1195
+ [boolean]
1196
+
1197
+ </div>
1198
+ <div class="subschema">
1199
+
1200
+ <div class="description">
1201
+ Whether or not a new log should be created for each service.
1202
+ </div>
1203
+
1204
+
1205
+
1206
+
1207
+
1208
+
1209
+
1210
+
1211
+ </div>
1212
+ </div>
1213
+
1214
+
1215
+ </div>
1216
+ <div class="subschema-name">
1217
+ setup-configuration
1218
+ [configuration]
1219
+
1220
+ </div>
1221
+ <div class="subschema">
1222
+
1223
+ <div class="description">
1224
+ A configuration point that ought to have the XMLRPCServerConfiguration schema. If 'setup' is given, then this option should not be given, and vice versa.
1225
+ </div>
1226
+
1227
+
1228
+
1229
+
1230
+
1231
+
1232
+
1233
+
1234
+ </div>
1235
+ </div>
1236
+
1237
+
1238
+ </div>
1239
+
1240
+
1241
+
1242
+
1243
+
1244
+
1245
+ </div>
1246
+
1247
+
1248
+ <h3><a name="XMLRPCServiceFactory_sp">XMLRPCServiceFactory</a> <small><em>(singleton)</em></small></h3>
1249
+
1250
+ <div class="item-body">
1251
+
1252
+
1253
+ <p class="description">
1254
+ This factory allows remote objects (exported via XMLRPC) to be wrapped transparently as services.
1255
+ </p>
1256
+
1257
+
1258
+ <h4>Implementor</h4>
1259
+ <div class="definition-item">
1260
+
1261
+ copland/remote/xmlrpc-service-factory/Copland::Remote::XMLRPCServiceFactory
1262
+
1263
+ </div>
1264
+
1265
+
1266
+ <h4>Schema</h4>
1267
+ <div class="definition-item">
1268
+
1269
+
1270
+
1271
+
1272
+
1273
+
1274
+
1275
+ <div class="schema-item">
1276
+
1277
+ <div class="subschema-name">
1278
+ host
1279
+ [string]
1280
+ <em>(required)</em>
1281
+ </div>
1282
+ <div class="subschema">
1283
+
1284
+ <div class="description">
1285
+ The hostname of the remote object to wrap.
1286
+ </div>
1287
+
1288
+
1289
+
1290
+
1291
+
1292
+
1293
+
1294
+
1295
+ </div>
1296
+ <div class="subschema-name">
1297
+ name
1298
+ [string]
1299
+ <em>(required)</em>
1300
+ </div>
1301
+ <div class="subschema">
1302
+
1303
+ <div class="description">
1304
+ The name of the remote object to wrap, as registered on the remote host.
1305
+ </div>
1306
+
1307
+
1308
+
1309
+
1310
+
1311
+
1312
+
1313
+
1314
+ </div>
1315
+ <div class="subschema-name">
1316
+ path
1317
+ [string]
1318
+
1319
+ </div>
1320
+ <div class="subschema">
1321
+
1322
+ <div class="description">
1323
+ The web path to the XMLRPC service on the host. This defaults to the root of the web document tree "/".
1324
+ </div>
1325
+
1326
+
1327
+
1328
+
1329
+
1330
+
1331
+
1332
+
1333
+ </div>
1334
+ <div class="subschema-name">
1335
+ port
1336
+ [any]
1337
+
1338
+ </div>
1339
+ <div class="subschema">
1340
+
1341
+ <div class="description">
1342
+ The port of the remote object to wrap. This defaults to port 8080.
1343
+ </div>
1344
+
1345
+
1346
+
1347
+
1348
+
1349
+
1350
+
1351
+
1352
+ </div>
1353
+ </div>
1354
+
1355
+
1356
+ </div>
1357
+
1358
+
1359
+
1360
+
1361
+
1362
+
1363
+ </div>
1364
+
1365
+
1366
+
1367
+
1368
+ <!-- CONFIGURATION POINTS -->
1369
+
1370
+
1371
+ <h2>Configuration Points</h2>
1372
+
1373
+
1374
+ <h3><a name="DefaultDRbServerConfiguration_cp">DefaultDRbServerConfiguration</a> <small><em>(map)</em></small></h3>
1375
+
1376
+ <div class="item-body">
1377
+
1378
+
1379
+ <p class="description">
1380
+ This configuration point is used to configure the DefaultDRbServer service.
1381
+ </p>
1382
+
1383
+
1384
+
1385
+ <h4>Schema</h4>
1386
+ <div class="definition-item">
1387
+ <a href="copland.remote.html#DRbServerConfiguration_scm">copland.remote.DRbServerConfiguration</a>
1388
+ </div>
1389
+
1390
+
1391
+ </div>
1392
+
1393
+
1394
+ <h3><a name="DefaultDRbServerExport_cp">DefaultDRbServerExport</a> <small><em>(map)</em></small></h3>
1395
+
1396
+ <div class="item-body">
1397
+
1398
+
1399
+ <p class="description">
1400
+ This configuration defines the service that will be exported by the DefaultDRbServer service.
1401
+ </p>
1402
+
1403
+
1404
+
1405
+ <h4>Schema</h4>
1406
+ <div class="definition-item">
1407
+ <a href="copland.remote.html#DRbServerExport_scm">copland.remote.DRbServerExport</a>
1408
+ </div>
1409
+
1410
+
1411
+ </div>
1412
+
1413
+
1414
+ <h3><a name="DefaultSOAPServerConfiguration_cp">DefaultSOAPServerConfiguration</a> <small><em>(map)</em></small></h3>
1415
+
1416
+ <div class="item-body">
1417
+
1418
+
1419
+ <p class="description">
1420
+ This configuration point is used to configure the DefaultSOAPServer service.
1421
+ </p>
1422
+
1423
+
1424
+
1425
+ <h4>Schema</h4>
1426
+ <div class="definition-item">
1427
+ <a href="copland.remote.html#SOAPServerConfiguration_scm">copland.remote.SOAPServerConfiguration</a>
1428
+ </div>
1429
+
1430
+
1431
+ </div>
1432
+
1433
+
1434
+ <h3><a name="DefaultSOAPServices_cp">DefaultSOAPServices</a> <small><em>(list)</em></small></h3>
1435
+
1436
+ <div class="item-body">
1437
+
1438
+
1439
+ <p class="description">
1440
+ This configuration point is used to configure the DefaultSOAPServer service.
1441
+ </p>
1442
+
1443
+
1444
+
1445
+ <h4>Schema</h4>
1446
+ <div class="definition-item">
1447
+ <a href="copland.remote.html#SOAPServices_scm">copland.remote.SOAPServices</a>
1448
+ </div>
1449
+
1450
+
1451
+ </div>
1452
+
1453
+
1454
+ <h3><a name="DefaultXMLRPCServerConfiguration_cp">DefaultXMLRPCServerConfiguration</a> <small><em>(map)</em></small></h3>
1455
+
1456
+ <div class="item-body">
1457
+
1458
+
1459
+ <p class="description">
1460
+ This configuration point is used to configure the XMLRPCServer service. The value server.host defaults to 'localhost', and server.port defaults to 8080.
1461
+ </p>
1462
+
1463
+
1464
+
1465
+ <h4>Schema</h4>
1466
+ <div class="definition-item">
1467
+ <a href="copland.remote.html#XMLRPCServerConfiguration_scm">copland.remote.XMLRPCServerConfiguration</a>
1468
+ </div>
1469
+
1470
+
1471
+ </div>
1472
+
1473
+
1474
+ <h3><a name="DefaultXMLRPCServices_cp">DefaultXMLRPCServices</a> <small><em>(list)</em></small></h3>
1475
+
1476
+ <div class="item-body">
1477
+
1478
+
1479
+ <p class="description">
1480
+ Each contribution to this configuration point should define the XMLRPC interface for a single service.
1481
+ </p>
1482
+
1483
+
1484
+
1485
+ <h4>Schema</h4>
1486
+ <div class="definition-item">
1487
+ <a href="copland.remote.html#XMLRPCServices_scm">copland.remote.XMLRPCServices</a>
1488
+ </div>
1489
+
1490
+
1491
+ </div>
1492
+
1493
+
1494
+
1495
+
1496
+ <!-- SCHEMAS -->
1497
+
1498
+
1499
+ <h2>Schemas</h2>
1500
+
1501
+
1502
+ <h3><a name="DRbServerConfiguration_scm">DRbServerConfiguration</a></h3>
1503
+
1504
+
1505
+
1506
+ <div class="item-body">
1507
+ <div class="definition-item">
1508
+
1509
+
1510
+
1511
+
1512
+
1513
+
1514
+
1515
+ <div class="schema-item">
1516
+
1517
+ <div class="subschema-name">
1518
+ server.auto.start
1519
+ [boolean]
1520
+
1521
+ </div>
1522
+ <div class="subschema">
1523
+
1524
+ <div class="description">
1525
+ Whether or not the server should be started when the service is instantiated. If false, then the application must start the service manually.
1526
+ </div>
1527
+
1528
+
1529
+
1530
+
1531
+
1532
+
1533
+
1534
+
1535
+ </div>
1536
+ <div class="subschema-name">
1537
+ server.bind.address
1538
+ [string]
1539
+
1540
+ </div>
1541
+ <div class="subschema">
1542
+
1543
+ <div class="description">
1544
+ The address that the server should bind to. This defaults to "127.0.0.1", which means that (by default) the server will not accept connections from other machines.
1545
+ </div>
1546
+
1547
+
1548
+
1549
+
1550
+
1551
+
1552
+
1553
+
1554
+ </div>
1555
+ <div class="subschema-name">
1556
+ server.port
1557
+ [integer]
1558
+
1559
+ </div>
1560
+ <div class="subschema">
1561
+
1562
+ <div class="description">
1563
+ The port that the server will listen on.
1564
+ </div>
1565
+
1566
+
1567
+
1568
+
1569
+
1570
+
1571
+
1572
+
1573
+ </div>
1574
+ <div class="subschema-name">
1575
+ server.use-log
1576
+ [boolean]
1577
+
1578
+ </div>
1579
+ <div class="subschema">
1580
+
1581
+ <div class="description">
1582
+ Whether or not a log should be created for the new service. Default to false.
1583
+ </div>
1584
+
1585
+
1586
+
1587
+
1588
+
1589
+
1590
+
1591
+
1592
+ </div>
1593
+ </div>
1594
+
1595
+
1596
+ </div>
1597
+ </div>
1598
+
1599
+ <h3><a name="DRbServerExport_scm">DRbServerExport</a></h3>
1600
+
1601
+
1602
+
1603
+ <div class="item-body">
1604
+ <div class="definition-item">
1605
+
1606
+
1607
+
1608
+
1609
+
1610
+
1611
+
1612
+ <div class="schema-item">
1613
+
1614
+ <div class="subschema-name">
1615
+ service
1616
+ [service]
1617
+ <em>(required)</em>
1618
+ </div>
1619
+ <div class="subschema">
1620
+
1621
+ <div class="description">
1622
+ A reference tot he service to export.
1623
+ </div>
1624
+
1625
+
1626
+
1627
+
1628
+
1629
+
1630
+
1631
+
1632
+ </div>
1633
+ <div class="subschema-name">
1634
+ methods
1635
+ [array]
1636
+
1637
+ </div>
1638
+ <div class="subschema">
1639
+
1640
+ <div class="description">
1641
+ A list of the methods to export. It may be a list of strings or hashes, or a combination of the two. Where an element is a string, it is the name of the method to export. Where it is a hash, it must contain a "name" key (defining the name of the method to export), and may contain an "alias" key (defining the name by which the method ought to be exported).
1642
+ </div>
1643
+
1644
+
1645
+
1646
+
1647
+
1648
+
1649
+
1650
+
1651
+ </div>
1652
+ </div>
1653
+
1654
+
1655
+ </div>
1656
+ </div>
1657
+
1658
+ <h3><a name="SOAPServerConfiguration_scm">SOAPServerConfiguration</a></h3>
1659
+
1660
+
1661
+
1662
+ <div class="item-body">
1663
+ <div class="definition-item">
1664
+
1665
+
1666
+
1667
+
1668
+
1669
+
1670
+
1671
+ <div class="schema-item">
1672
+
1673
+ <div class="subschema-name">
1674
+ server.auto.start
1675
+ [boolean]
1676
+
1677
+ </div>
1678
+ <div class="subschema">
1679
+
1680
+ <div class="description">
1681
+ Whether the server should start as soon as the service is instantiated.
1682
+ </div>
1683
+
1684
+
1685
+
1686
+
1687
+
1688
+
1689
+
1690
+
1691
+ </div>
1692
+ <div class="subschema-name">
1693
+ server.bind.address
1694
+ [string]
1695
+
1696
+ </div>
1697
+ <div class="subschema">
1698
+
1699
+ <div class="description">
1700
+ The address that the server should bind to.
1701
+ </div>
1702
+
1703
+
1704
+
1705
+
1706
+
1707
+
1708
+
1709
+
1710
+ </div>
1711
+ <div class="subschema-name">
1712
+ server.port
1713
+ [integer]
1714
+
1715
+ </div>
1716
+ <div class="subschema">
1717
+
1718
+ <div class="description">
1719
+ The port that the server will listen on.
1720
+ </div>
1721
+
1722
+
1723
+
1724
+
1725
+
1726
+
1727
+
1728
+
1729
+ </div>
1730
+ <div class="subschema-name">
1731
+ server.use-log
1732
+ [boolean]
1733
+
1734
+ </div>
1735
+ <div class="subschema">
1736
+
1737
+ <div class="description">
1738
+ Whether or not a log should be created for the new service.
1739
+ </div>
1740
+
1741
+
1742
+
1743
+
1744
+
1745
+
1746
+
1747
+
1748
+ </div>
1749
+ </div>
1750
+
1751
+
1752
+ </div>
1753
+ </div>
1754
+
1755
+ <h3><a name="SOAPServices_scm">SOAPServices</a></h3>
1756
+
1757
+
1758
+
1759
+ <div class="item-body">
1760
+ <div class="definition-item">
1761
+
1762
+
1763
+
1764
+
1765
+
1766
+
1767
+
1768
+ <div class="schema-item">
1769
+
1770
+ <div class="subschema-name">
1771
+ namespace
1772
+ [string]
1773
+ <em>(required)</em>
1774
+ </div>
1775
+ <div class="subschema">
1776
+
1777
+ <div class="description">
1778
+ The name by which remote clients should request this service.
1779
+ </div>
1780
+
1781
+
1782
+
1783
+
1784
+
1785
+
1786
+
1787
+
1788
+ </div>
1789
+ <div class="subschema-name">
1790
+ service
1791
+ [service]
1792
+ <em>(required)</em>
1793
+ </div>
1794
+ <div class="subschema">
1795
+
1796
+ <div class="description">
1797
+ The service to export.
1798
+ </div>
1799
+
1800
+
1801
+
1802
+
1803
+
1804
+
1805
+
1806
+
1807
+ </div>
1808
+ <div class="subschema-name">
1809
+ methods
1810
+ [array]
1811
+
1812
+ </div>
1813
+ <div class="subschema">
1814
+
1815
+ <div class="description">
1816
+ The list of methods that should be exported by this service. Each element of the list ought to be either a string (naming a method), or a hash. The hash must have at least the "name" key (to identify the method to export), and may optionally have an "alias" key (to identify the name by which the method should be exported).
1817
+ </div>
1818
+
1819
+
1820
+
1821
+
1822
+
1823
+
1824
+
1825
+
1826
+ </div>
1827
+ </div>
1828
+
1829
+
1830
+ </div>
1831
+ </div>
1832
+
1833
+ <h3><a name="XMLRPCServerConfiguration_scm">XMLRPCServerConfiguration</a></h3>
1834
+
1835
+
1836
+
1837
+ <div class="item-body">
1838
+ <div class="definition-item">
1839
+
1840
+
1841
+
1842
+
1843
+
1844
+
1845
+
1846
+ <div class="schema-item">
1847
+
1848
+ <div class="subschema-name">
1849
+ max.connections
1850
+ [integer]
1851
+
1852
+ </div>
1853
+ <div class="subschema">
1854
+
1855
+ <div class="description">
1856
+ The maximum number of concurrent connections.
1857
+ </div>
1858
+
1859
+
1860
+
1861
+
1862
+
1863
+
1864
+
1865
+
1866
+ </div>
1867
+ <div class="subschema-name">
1868
+ server.auto.start
1869
+ [boolean]
1870
+
1871
+ </div>
1872
+ <div class="subschema">
1873
+
1874
+ <div class="description">
1875
+ Whether or not the server should start as soon as the service is instantiated.
1876
+ </div>
1877
+
1878
+
1879
+
1880
+
1881
+
1882
+
1883
+
1884
+
1885
+ </div>
1886
+ <div class="subschema-name">
1887
+ server.bind.address
1888
+ [string]
1889
+
1890
+ </div>
1891
+ <div class="subschema">
1892
+
1893
+ <div class="description">
1894
+ The address that the server should bind to.
1895
+ </div>
1896
+
1897
+
1898
+
1899
+
1900
+
1901
+
1902
+
1903
+
1904
+ </div>
1905
+ <div class="subschema-name">
1906
+ server.port
1907
+ [integer]
1908
+
1909
+ </div>
1910
+ <div class="subschema">
1911
+
1912
+ <div class="description">
1913
+ The port that the server should listen on.
1914
+ </div>
1915
+
1916
+
1917
+
1918
+
1919
+
1920
+
1921
+
1922
+
1923
+ </div>
1924
+ <div class="subschema-name">
1925
+ server.use-log
1926
+ [boolean]
1927
+
1928
+ </div>
1929
+ <div class="subschema">
1930
+
1931
+ <div class="description">
1932
+ Whether or not a new log should be created for each service.
1933
+ </div>
1934
+
1935
+
1936
+
1937
+
1938
+
1939
+
1940
+
1941
+
1942
+ </div>
1943
+ </div>
1944
+
1945
+
1946
+ </div>
1947
+ </div>
1948
+
1949
+ <h3><a name="XMLRPCServices_scm">XMLRPCServices</a></h3>
1950
+
1951
+
1952
+
1953
+ <div class="item-body">
1954
+ <div class="definition-item">
1955
+
1956
+
1957
+
1958
+
1959
+
1960
+
1961
+
1962
+ <div class="schema-item">
1963
+
1964
+ <div class="subschema-name">
1965
+ prefix
1966
+ [string]
1967
+ <em>(required)</em>
1968
+ </div>
1969
+ <div class="subschema">
1970
+
1971
+ <div class="description">
1972
+ The name by which remote clients should request this service.
1973
+ </div>
1974
+
1975
+
1976
+
1977
+
1978
+
1979
+
1980
+
1981
+
1982
+ </div>
1983
+ <div class="subschema-name">
1984
+ service
1985
+ [service]
1986
+ <em>(required)</em>
1987
+ </div>
1988
+ <div class="subschema">
1989
+
1990
+ <div class="description">
1991
+ The service to export.
1992
+ </div>
1993
+
1994
+
1995
+
1996
+
1997
+
1998
+
1999
+
2000
+
2001
+ </div>
2002
+ <div class="subschema-name">
2003
+ interface
2004
+ [array]
2005
+
2006
+ </div>
2007
+ <div class="subschema">
2008
+
2009
+ <div class="description">
2010
+ An array of maps that describe the methods that this service should export.
2011
+ </div>
2012
+
2013
+
2014
+
2015
+
2016
+
2017
+
2018
+
2019
+ <div class="schema-item">
2020
+
2021
+ <div class="subschema-name">
2022
+ signature
2023
+ [string]
2024
+ <em>(required)</em>
2025
+ </div>
2026
+ <div class="subschema">
2027
+
2028
+ <div class="description">
2029
+ A valid XMLRPC signature for the method. This is the name by which the method will be invoked.
2030
+ </div>
2031
+
2032
+
2033
+
2034
+
2035
+
2036
+
2037
+
2038
+
2039
+ </div>
2040
+ <div class="subschema-name">
2041
+ help
2042
+ [string]
2043
+
2044
+ </div>
2045
+ <div class="subschema">
2046
+
2047
+ <div class="description">
2048
+ This is just arbitrary text that describes this method and what it does. It is useful for XMLRPC clients to query, to know what an interface is capable of.
2049
+ </div>
2050
+
2051
+
2052
+
2053
+
2054
+
2055
+
2056
+
2057
+
2058
+ </div>
2059
+ <div class="subschema-name">
2060
+ method
2061
+ [string]
2062
+
2063
+ </div>
2064
+ <div class="subschema">
2065
+
2066
+ <div class="description">
2067
+ This is the actual method name (as declared in the service), if it differs from the name given in the signature. This allows for aliasing of method names.
2068
+ </div>
2069
+
2070
+
2071
+
2072
+
2073
+
2074
+
2075
+
2076
+
2077
+ </div>
2078
+ </div>
2079
+
2080
+
2081
+ </div>
2082
+ </div>
2083
+
2084
+
2085
+ </div>
2086
+ </div>
2087
+
2088
+
2089
+ <div class="generated-by">
2090
+ Generated by
2091
+ <a href="http://copland.rubyforge.org">Copland</a>'s
2092
+ Packrat documentation extractor
2093
+ on Sun Sep 26 21:37:13 MDT 2004
2094
+ </div>
2095
+ </body>
2096
+ </html>