rack-auth-ip 0.0.3 → 0.0.4
Sign up to get free protection for your applications and to get access to all the features.
- data/ChangeLog +12 -0
- data/Rakefile +6 -1
- data/doc/output/coverage/-Library-Ruby-Gems-gems-diff-lcs-1_1_2-lib-diff-lcs-block_rb.html +1 -1
- data/doc/output/coverage/-Library-Ruby-Gems-gems-diff-lcs-1_1_2-lib-diff-lcs-callbacks_rb.html +1 -1
- data/doc/output/coverage/-Library-Ruby-Gems-gems-diff-lcs-1_1_2-lib-diff-lcs-change_rb.html +1 -1
- data/doc/output/coverage/-Library-Ruby-Gems-gems-diff-lcs-1_1_2-lib-diff-lcs-hunk_rb.html +1 -1
- data/doc/output/coverage/-Library-Ruby-Gems-gems-diff-lcs-1_1_2-lib-diff-lcs_rb.html +1 -1
- data/doc/output/coverage/-Library-Ruby-Gems-gems-ipaddr_list-0_0_2-lib-ipaddr_list_rb.html +794 -0
- data/doc/output/coverage/-Library-Ruby-Gems-gems-rcov-0_8_1_2_0-lib-rcov_rb.html +1 -1
- data/doc/output/coverage/index.html +33 -195
- data/doc/output/coverage/lib-rack-auth-ip_rb.html +63 -62
- data/lib/rack/auth/ip.rb +4 -3
- metadata +12 -9
- data/doc/output/coverage/-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-drb-drb_rb.html +0 -2373
- data/doc/output/coverage/-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-drb-eq_rb.html +0 -626
- data/doc/output/coverage/-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-drb-invokemethod_rb.html +0 -646
- data/doc/output/coverage/-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-ipaddr_rb.html +0 -1139
- data/doc/output/coverage/-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-pp_rb.html +0 -1257
- data/doc/output/coverage/-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-prettyprint_rb.html +0 -1506
- data/doc/output/coverage/-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-timeout_rb.html +0 -715
data/lib/rack/auth/ip.rb
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
require 'ipaddr'
|
|
2
|
+
require 'ipaddr_list'
|
|
2
3
|
module Rack
|
|
3
4
|
module Auth
|
|
4
5
|
# in your_app.ru
|
|
@@ -30,8 +31,8 @@ module Rack
|
|
|
30
31
|
@app = app
|
|
31
32
|
@ip_list = ip_list
|
|
32
33
|
|
|
33
|
-
if @ip_list
|
|
34
|
-
@ip_list =
|
|
34
|
+
if @ip_list && @ip_list.size > 0
|
|
35
|
+
@ip_list = IPAddrList.new(@ip_list)
|
|
35
36
|
end
|
|
36
37
|
|
|
37
38
|
@cond = block
|
|
@@ -41,7 +42,7 @@ module Rack
|
|
|
41
42
|
req_ip = IPAddr.new(detect_ip(env))
|
|
42
43
|
|
|
43
44
|
if @ip_list
|
|
44
|
-
if @ip_list.
|
|
45
|
+
if @ip_list.include?(req_ip)
|
|
45
46
|
return @app.call(env)
|
|
46
47
|
end
|
|
47
48
|
else
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: rack-auth-ip
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.0.
|
|
4
|
+
version: 0.0.4
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Keiji, Yoshimi
|
|
@@ -9,7 +9,7 @@ autorequire: ""
|
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
11
|
|
|
12
|
-
date: 2008-
|
|
12
|
+
date: 2008-09-13 00:00:00 +09:00
|
|
13
13
|
default_executable:
|
|
14
14
|
dependencies:
|
|
15
15
|
- !ruby/object:Gem::Dependency
|
|
@@ -21,6 +21,15 @@ dependencies:
|
|
|
21
21
|
- !ruby/object:Gem::Version
|
|
22
22
|
version: 0.3.0
|
|
23
23
|
version:
|
|
24
|
+
- !ruby/object:Gem::Dependency
|
|
25
|
+
name: ipaddr_list
|
|
26
|
+
version_requirement:
|
|
27
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
28
|
+
requirements:
|
|
29
|
+
- - ">="
|
|
30
|
+
- !ruby/object:Gem::Version
|
|
31
|
+
version: "0"
|
|
32
|
+
version:
|
|
24
33
|
description: rack's moddleware to restrict ip address
|
|
25
34
|
email: walf443 at gmail.com
|
|
26
35
|
executables: []
|
|
@@ -47,14 +56,8 @@ files:
|
|
|
47
56
|
- doc/output/coverage/-Library-Ruby-Gems-gems-diff-lcs-1_1_2-lib-diff-lcs-change_rb.html
|
|
48
57
|
- doc/output/coverage/-Library-Ruby-Gems-gems-diff-lcs-1_1_2-lib-diff-lcs-hunk_rb.html
|
|
49
58
|
- doc/output/coverage/-Library-Ruby-Gems-gems-diff-lcs-1_1_2-lib-diff-lcs_rb.html
|
|
59
|
+
- doc/output/coverage/-Library-Ruby-Gems-gems-ipaddr_list-0_0_2-lib-ipaddr_list_rb.html
|
|
50
60
|
- doc/output/coverage/-Library-Ruby-Gems-gems-rcov-0_8_1_2_0-lib-rcov_rb.html
|
|
51
|
-
- doc/output/coverage/-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-drb-drb_rb.html
|
|
52
|
-
- doc/output/coverage/-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-drb-eq_rb.html
|
|
53
|
-
- doc/output/coverage/-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-drb-invokemethod_rb.html
|
|
54
|
-
- doc/output/coverage/-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-ipaddr_rb.html
|
|
55
|
-
- doc/output/coverage/-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-pp_rb.html
|
|
56
|
-
- doc/output/coverage/-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-prettyprint_rb.html
|
|
57
|
-
- doc/output/coverage/-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-timeout_rb.html
|
|
58
61
|
- doc/output/coverage/index.html
|
|
59
62
|
- doc/output/coverage/lib-rack-auth-ip_rb.html
|
|
60
63
|
- tasks/basic_config.rake
|
|
@@ -1,2373 +0,0 @@
|
|
|
1
|
-
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
2
|
-
<html lang='en' xml:lang='en' xmlns='http://www.w3.org/1999/xhtml'><head><title>/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/lib/ruby/1.8/drb/drb.rb - C0 code coverage information</title>
|
|
3
|
-
<style type='text/css'>body { background-color: rgb(240, 240, 245); }</style>
|
|
4
|
-
<style type='text/css'>span.cross-ref-title {
|
|
5
|
-
font-size: 140%;
|
|
6
|
-
}
|
|
7
|
-
span.cross-ref a {
|
|
8
|
-
text-decoration: none;
|
|
9
|
-
}
|
|
10
|
-
span.cross-ref {
|
|
11
|
-
background-color:#f3f7fa;
|
|
12
|
-
border: 1px dashed #333;
|
|
13
|
-
margin: 1em;
|
|
14
|
-
padding: 0.5em;
|
|
15
|
-
overflow: hidden;
|
|
16
|
-
}
|
|
17
|
-
a.crossref-toggle {
|
|
18
|
-
text-decoration: none;
|
|
19
|
-
}
|
|
20
|
-
span.marked0 {
|
|
21
|
-
background-color: rgb(185, 210, 200);
|
|
22
|
-
display: block;
|
|
23
|
-
}
|
|
24
|
-
span.marked1 {
|
|
25
|
-
background-color: rgb(190, 215, 205);
|
|
26
|
-
display: block;
|
|
27
|
-
}
|
|
28
|
-
span.inferred0 {
|
|
29
|
-
background-color: rgb(175, 200, 200);
|
|
30
|
-
display: block;
|
|
31
|
-
}
|
|
32
|
-
span.inferred1 {
|
|
33
|
-
background-color: rgb(180, 205, 205);
|
|
34
|
-
display: block;
|
|
35
|
-
}
|
|
36
|
-
span.uncovered0 {
|
|
37
|
-
background-color: rgb(225, 110, 110);
|
|
38
|
-
display: block;
|
|
39
|
-
}
|
|
40
|
-
span.uncovered1 {
|
|
41
|
-
background-color: rgb(235, 120, 120);
|
|
42
|
-
display: block;
|
|
43
|
-
}
|
|
44
|
-
span.overview {
|
|
45
|
-
border-bottom: 8px solid black;
|
|
46
|
-
}
|
|
47
|
-
div.overview {
|
|
48
|
-
border-bottom: 8px solid black;
|
|
49
|
-
}
|
|
50
|
-
body {
|
|
51
|
-
font-family: verdana, arial, helvetica;
|
|
52
|
-
}
|
|
53
|
-
div.footer {
|
|
54
|
-
font-size: 68%;
|
|
55
|
-
margin-top: 1.5em;
|
|
56
|
-
}
|
|
57
|
-
h1, h2, h3, h4, h5, h6 {
|
|
58
|
-
margin-bottom: 0.5em;
|
|
59
|
-
}
|
|
60
|
-
h5 {
|
|
61
|
-
margin-top: 0.5em;
|
|
62
|
-
}
|
|
63
|
-
.hidden {
|
|
64
|
-
display: none;
|
|
65
|
-
}
|
|
66
|
-
div.separator {
|
|
67
|
-
height: 10px;
|
|
68
|
-
}
|
|
69
|
-
/* Commented out for better readability, esp. on IE */
|
|
70
|
-
/*
|
|
71
|
-
table tr td, table tr th {
|
|
72
|
-
font-size: 68%;
|
|
73
|
-
}
|
|
74
|
-
td.value table tr td {
|
|
75
|
-
font-size: 11px;
|
|
76
|
-
}
|
|
77
|
-
*/
|
|
78
|
-
table.percent_graph {
|
|
79
|
-
height: 12px;
|
|
80
|
-
border: #808080 1px solid;
|
|
81
|
-
empty-cells: show;
|
|
82
|
-
}
|
|
83
|
-
table.percent_graph td.covered {
|
|
84
|
-
height: 10px;
|
|
85
|
-
background: #00f000;
|
|
86
|
-
}
|
|
87
|
-
table.percent_graph td.uncovered {
|
|
88
|
-
height: 10px;
|
|
89
|
-
background: #e00000;
|
|
90
|
-
}
|
|
91
|
-
table.percent_graph td.NA {
|
|
92
|
-
height: 10px;
|
|
93
|
-
background: #eaeaea;
|
|
94
|
-
}
|
|
95
|
-
table.report {
|
|
96
|
-
border-collapse: collapse;
|
|
97
|
-
width: 100%;
|
|
98
|
-
}
|
|
99
|
-
table.report td.heading {
|
|
100
|
-
background: #dcecff;
|
|
101
|
-
border: #d0d0d0 1px solid;
|
|
102
|
-
font-weight: bold;
|
|
103
|
-
text-align: center;
|
|
104
|
-
}
|
|
105
|
-
table.report td.heading:hover {
|
|
106
|
-
background: #c0ffc0;
|
|
107
|
-
}
|
|
108
|
-
table.report td.text {
|
|
109
|
-
border: #d0d0d0 1px solid;
|
|
110
|
-
}
|
|
111
|
-
table.report td.value,
|
|
112
|
-
table.report td.lines_total,
|
|
113
|
-
table.report td.lines_code {
|
|
114
|
-
text-align: right;
|
|
115
|
-
border: #d0d0d0 1px solid;
|
|
116
|
-
}
|
|
117
|
-
table.report tr.light {
|
|
118
|
-
background-color: rgb(240, 240, 245);
|
|
119
|
-
}
|
|
120
|
-
table.report tr.dark {
|
|
121
|
-
background-color: rgb(230, 230, 235);
|
|
122
|
-
}
|
|
123
|
-
</style>
|
|
124
|
-
<script type='text/javascript'>
|
|
125
|
-
// <![CDATA[
|
|
126
|
-
function toggleCode( id ) {
|
|
127
|
-
if ( document.getElementById )
|
|
128
|
-
elem = document.getElementById( id );
|
|
129
|
-
else if ( document.all )
|
|
130
|
-
elem = eval( "document.all." + id );
|
|
131
|
-
else
|
|
132
|
-
return false;
|
|
133
|
-
|
|
134
|
-
elemStyle = elem.style;
|
|
135
|
-
|
|
136
|
-
if ( elemStyle.display != "block" ) {
|
|
137
|
-
elemStyle.display = "block"
|
|
138
|
-
} else {
|
|
139
|
-
elemStyle.display = "none"
|
|
140
|
-
}
|
|
141
|
-
|
|
142
|
-
return true;
|
|
143
|
-
}
|
|
144
|
-
|
|
145
|
-
// Make cross-references hidden by default
|
|
146
|
-
document.writeln( "<style type=\"text/css\">span.cross-ref { display: none }</style>" )
|
|
147
|
-
// ]]>
|
|
148
|
-
</script>
|
|
149
|
-
<style type='text/css'>span.run0 {
|
|
150
|
-
background-color: rgb(178, 204, 255);
|
|
151
|
-
display: block;
|
|
152
|
-
}
|
|
153
|
-
span.run1 {
|
|
154
|
-
background-color: rgb(178, 206, 255);
|
|
155
|
-
display: block;
|
|
156
|
-
}
|
|
157
|
-
span.run2 {
|
|
158
|
-
background-color: rgb(178, 209, 255);
|
|
159
|
-
display: block;
|
|
160
|
-
}
|
|
161
|
-
span.run3 {
|
|
162
|
-
background-color: rgb(178, 211, 255);
|
|
163
|
-
display: block;
|
|
164
|
-
}
|
|
165
|
-
span.run4 {
|
|
166
|
-
background-color: rgb(178, 214, 255);
|
|
167
|
-
display: block;
|
|
168
|
-
}
|
|
169
|
-
span.run5 {
|
|
170
|
-
background-color: rgb(178, 218, 255);
|
|
171
|
-
display: block;
|
|
172
|
-
}
|
|
173
|
-
span.run6 {
|
|
174
|
-
background-color: rgb(178, 220, 255);
|
|
175
|
-
display: block;
|
|
176
|
-
}
|
|
177
|
-
span.run7 {
|
|
178
|
-
background-color: rgb(178, 223, 255);
|
|
179
|
-
display: block;
|
|
180
|
-
}
|
|
181
|
-
span.run8 {
|
|
182
|
-
background-color: rgb(178, 225, 255);
|
|
183
|
-
display: block;
|
|
184
|
-
}
|
|
185
|
-
span.run9 {
|
|
186
|
-
background-color: rgb(178, 228, 255);
|
|
187
|
-
display: block;
|
|
188
|
-
}
|
|
189
|
-
span.run10 {
|
|
190
|
-
background-color: rgb(178, 232, 255);
|
|
191
|
-
display: block;
|
|
192
|
-
}
|
|
193
|
-
span.run11 {
|
|
194
|
-
background-color: rgb(178, 234, 255);
|
|
195
|
-
display: block;
|
|
196
|
-
}
|
|
197
|
-
span.run12 {
|
|
198
|
-
background-color: rgb(178, 237, 255);
|
|
199
|
-
display: block;
|
|
200
|
-
}
|
|
201
|
-
span.run13 {
|
|
202
|
-
background-color: rgb(178, 239, 255);
|
|
203
|
-
display: block;
|
|
204
|
-
}
|
|
205
|
-
span.run14 {
|
|
206
|
-
background-color: rgb(178, 242, 255);
|
|
207
|
-
display: block;
|
|
208
|
-
}
|
|
209
|
-
span.run15 {
|
|
210
|
-
background-color: rgb(178, 246, 255);
|
|
211
|
-
display: block;
|
|
212
|
-
}
|
|
213
|
-
span.run16 {
|
|
214
|
-
background-color: rgb(178, 248, 255);
|
|
215
|
-
display: block;
|
|
216
|
-
}
|
|
217
|
-
span.run17 {
|
|
218
|
-
background-color: rgb(178, 251, 255);
|
|
219
|
-
display: block;
|
|
220
|
-
}
|
|
221
|
-
span.run18 {
|
|
222
|
-
background-color: rgb(178, 253, 255);
|
|
223
|
-
display: block;
|
|
224
|
-
}
|
|
225
|
-
span.run19 {
|
|
226
|
-
background-color: rgb(178, 255, 253);
|
|
227
|
-
display: block;
|
|
228
|
-
}
|
|
229
|
-
span.run20 {
|
|
230
|
-
background-color: rgb(178, 255, 249);
|
|
231
|
-
display: block;
|
|
232
|
-
}
|
|
233
|
-
span.run21 {
|
|
234
|
-
background-color: rgb(178, 255, 247);
|
|
235
|
-
display: block;
|
|
236
|
-
}
|
|
237
|
-
span.run22 {
|
|
238
|
-
background-color: rgb(178, 255, 244);
|
|
239
|
-
display: block;
|
|
240
|
-
}
|
|
241
|
-
span.run23 {
|
|
242
|
-
background-color: rgb(178, 255, 242);
|
|
243
|
-
display: block;
|
|
244
|
-
}
|
|
245
|
-
span.run24 {
|
|
246
|
-
background-color: rgb(178, 255, 239);
|
|
247
|
-
display: block;
|
|
248
|
-
}
|
|
249
|
-
span.run25 {
|
|
250
|
-
background-color: rgb(178, 255, 235);
|
|
251
|
-
display: block;
|
|
252
|
-
}
|
|
253
|
-
span.run26 {
|
|
254
|
-
background-color: rgb(178, 255, 233);
|
|
255
|
-
display: block;
|
|
256
|
-
}
|
|
257
|
-
span.run27 {
|
|
258
|
-
background-color: rgb(178, 255, 230);
|
|
259
|
-
display: block;
|
|
260
|
-
}
|
|
261
|
-
span.run28 {
|
|
262
|
-
background-color: rgb(178, 255, 228);
|
|
263
|
-
display: block;
|
|
264
|
-
}
|
|
265
|
-
span.run29 {
|
|
266
|
-
background-color: rgb(178, 255, 225);
|
|
267
|
-
display: block;
|
|
268
|
-
}
|
|
269
|
-
span.run30 {
|
|
270
|
-
background-color: rgb(178, 255, 221);
|
|
271
|
-
display: block;
|
|
272
|
-
}
|
|
273
|
-
span.run31 {
|
|
274
|
-
background-color: rgb(178, 255, 219);
|
|
275
|
-
display: block;
|
|
276
|
-
}
|
|
277
|
-
span.run32 {
|
|
278
|
-
background-color: rgb(178, 255, 216);
|
|
279
|
-
display: block;
|
|
280
|
-
}
|
|
281
|
-
span.run33 {
|
|
282
|
-
background-color: rgb(178, 255, 214);
|
|
283
|
-
display: block;
|
|
284
|
-
}
|
|
285
|
-
span.run34 {
|
|
286
|
-
background-color: rgb(178, 255, 211);
|
|
287
|
-
display: block;
|
|
288
|
-
}
|
|
289
|
-
span.run35 {
|
|
290
|
-
background-color: rgb(178, 255, 207);
|
|
291
|
-
display: block;
|
|
292
|
-
}
|
|
293
|
-
span.run36 {
|
|
294
|
-
background-color: rgb(178, 255, 205);
|
|
295
|
-
display: block;
|
|
296
|
-
}
|
|
297
|
-
span.run37 {
|
|
298
|
-
background-color: rgb(178, 255, 202);
|
|
299
|
-
display: block;
|
|
300
|
-
}
|
|
301
|
-
span.run38 {
|
|
302
|
-
background-color: rgb(178, 255, 200);
|
|
303
|
-
display: block;
|
|
304
|
-
}
|
|
305
|
-
span.run39 {
|
|
306
|
-
background-color: rgb(178, 255, 197);
|
|
307
|
-
display: block;
|
|
308
|
-
}
|
|
309
|
-
span.run40 {
|
|
310
|
-
background-color: rgb(178, 255, 193);
|
|
311
|
-
display: block;
|
|
312
|
-
}
|
|
313
|
-
span.run41 {
|
|
314
|
-
background-color: rgb(178, 255, 191);
|
|
315
|
-
display: block;
|
|
316
|
-
}
|
|
317
|
-
span.run42 {
|
|
318
|
-
background-color: rgb(178, 255, 188);
|
|
319
|
-
display: block;
|
|
320
|
-
}
|
|
321
|
-
span.run43 {
|
|
322
|
-
background-color: rgb(178, 255, 186);
|
|
323
|
-
display: block;
|
|
324
|
-
}
|
|
325
|
-
span.run44 {
|
|
326
|
-
background-color: rgb(178, 255, 183);
|
|
327
|
-
display: block;
|
|
328
|
-
}
|
|
329
|
-
span.run45 {
|
|
330
|
-
background-color: rgb(178, 255, 179);
|
|
331
|
-
display: block;
|
|
332
|
-
}
|
|
333
|
-
span.run46 {
|
|
334
|
-
background-color: rgb(179, 255, 178);
|
|
335
|
-
display: block;
|
|
336
|
-
}
|
|
337
|
-
span.run47 {
|
|
338
|
-
background-color: rgb(182, 255, 178);
|
|
339
|
-
display: block;
|
|
340
|
-
}
|
|
341
|
-
span.run48 {
|
|
342
|
-
background-color: rgb(184, 255, 178);
|
|
343
|
-
display: block;
|
|
344
|
-
}
|
|
345
|
-
span.run49 {
|
|
346
|
-
background-color: rgb(187, 255, 178);
|
|
347
|
-
display: block;
|
|
348
|
-
}
|
|
349
|
-
span.run50 {
|
|
350
|
-
background-color: rgb(191, 255, 178);
|
|
351
|
-
display: block;
|
|
352
|
-
}
|
|
353
|
-
span.run51 {
|
|
354
|
-
background-color: rgb(193, 255, 178);
|
|
355
|
-
display: block;
|
|
356
|
-
}
|
|
357
|
-
span.run52 {
|
|
358
|
-
background-color: rgb(196, 255, 178);
|
|
359
|
-
display: block;
|
|
360
|
-
}
|
|
361
|
-
span.run53 {
|
|
362
|
-
background-color: rgb(198, 255, 178);
|
|
363
|
-
display: block;
|
|
364
|
-
}
|
|
365
|
-
span.run54 {
|
|
366
|
-
background-color: rgb(201, 255, 178);
|
|
367
|
-
display: block;
|
|
368
|
-
}
|
|
369
|
-
span.run55 {
|
|
370
|
-
background-color: rgb(205, 255, 178);
|
|
371
|
-
display: block;
|
|
372
|
-
}
|
|
373
|
-
span.run56 {
|
|
374
|
-
background-color: rgb(207, 255, 178);
|
|
375
|
-
display: block;
|
|
376
|
-
}
|
|
377
|
-
span.run57 {
|
|
378
|
-
background-color: rgb(210, 255, 178);
|
|
379
|
-
display: block;
|
|
380
|
-
}
|
|
381
|
-
span.run58 {
|
|
382
|
-
background-color: rgb(212, 255, 178);
|
|
383
|
-
display: block;
|
|
384
|
-
}
|
|
385
|
-
span.run59 {
|
|
386
|
-
background-color: rgb(215, 255, 178);
|
|
387
|
-
display: block;
|
|
388
|
-
}
|
|
389
|
-
span.run60 {
|
|
390
|
-
background-color: rgb(219, 255, 178);
|
|
391
|
-
display: block;
|
|
392
|
-
}
|
|
393
|
-
span.run61 {
|
|
394
|
-
background-color: rgb(221, 255, 178);
|
|
395
|
-
display: block;
|
|
396
|
-
}
|
|
397
|
-
span.run62 {
|
|
398
|
-
background-color: rgb(224, 255, 178);
|
|
399
|
-
display: block;
|
|
400
|
-
}
|
|
401
|
-
span.run63 {
|
|
402
|
-
background-color: rgb(226, 255, 178);
|
|
403
|
-
display: block;
|
|
404
|
-
}
|
|
405
|
-
span.run64 {
|
|
406
|
-
background-color: rgb(229, 255, 178);
|
|
407
|
-
display: block;
|
|
408
|
-
}
|
|
409
|
-
span.run65 {
|
|
410
|
-
background-color: rgb(233, 255, 178);
|
|
411
|
-
display: block;
|
|
412
|
-
}
|
|
413
|
-
span.run66 {
|
|
414
|
-
background-color: rgb(235, 255, 178);
|
|
415
|
-
display: block;
|
|
416
|
-
}
|
|
417
|
-
span.run67 {
|
|
418
|
-
background-color: rgb(238, 255, 178);
|
|
419
|
-
display: block;
|
|
420
|
-
}
|
|
421
|
-
span.run68 {
|
|
422
|
-
background-color: rgb(240, 255, 178);
|
|
423
|
-
display: block;
|
|
424
|
-
}
|
|
425
|
-
span.run69 {
|
|
426
|
-
background-color: rgb(243, 255, 178);
|
|
427
|
-
display: block;
|
|
428
|
-
}
|
|
429
|
-
span.run70 {
|
|
430
|
-
background-color: rgb(247, 255, 178);
|
|
431
|
-
display: block;
|
|
432
|
-
}
|
|
433
|
-
span.run71 {
|
|
434
|
-
background-color: rgb(249, 255, 178);
|
|
435
|
-
display: block;
|
|
436
|
-
}
|
|
437
|
-
span.run72 {
|
|
438
|
-
background-color: rgb(252, 255, 178);
|
|
439
|
-
display: block;
|
|
440
|
-
}
|
|
441
|
-
span.run73 {
|
|
442
|
-
background-color: rgb(255, 255, 178);
|
|
443
|
-
display: block;
|
|
444
|
-
}
|
|
445
|
-
span.run74 {
|
|
446
|
-
background-color: rgb(255, 252, 178);
|
|
447
|
-
display: block;
|
|
448
|
-
}
|
|
449
|
-
span.run75 {
|
|
450
|
-
background-color: rgb(255, 248, 178);
|
|
451
|
-
display: block;
|
|
452
|
-
}
|
|
453
|
-
span.run76 {
|
|
454
|
-
background-color: rgb(255, 246, 178);
|
|
455
|
-
display: block;
|
|
456
|
-
}
|
|
457
|
-
span.run77 {
|
|
458
|
-
background-color: rgb(255, 243, 178);
|
|
459
|
-
display: block;
|
|
460
|
-
}
|
|
461
|
-
span.run78 {
|
|
462
|
-
background-color: rgb(255, 240, 178);
|
|
463
|
-
display: block;
|
|
464
|
-
}
|
|
465
|
-
span.run79 {
|
|
466
|
-
background-color: rgb(255, 238, 178);
|
|
467
|
-
display: block;
|
|
468
|
-
}
|
|
469
|
-
span.run80 {
|
|
470
|
-
background-color: rgb(255, 234, 178);
|
|
471
|
-
display: block;
|
|
472
|
-
}
|
|
473
|
-
span.run81 {
|
|
474
|
-
background-color: rgb(255, 232, 178);
|
|
475
|
-
display: block;
|
|
476
|
-
}
|
|
477
|
-
span.run82 {
|
|
478
|
-
background-color: rgb(255, 229, 178);
|
|
479
|
-
display: block;
|
|
480
|
-
}
|
|
481
|
-
span.run83 {
|
|
482
|
-
background-color: rgb(255, 226, 178);
|
|
483
|
-
display: block;
|
|
484
|
-
}
|
|
485
|
-
span.run84 {
|
|
486
|
-
background-color: rgb(255, 224, 178);
|
|
487
|
-
display: block;
|
|
488
|
-
}
|
|
489
|
-
span.run85 {
|
|
490
|
-
background-color: rgb(255, 220, 178);
|
|
491
|
-
display: block;
|
|
492
|
-
}
|
|
493
|
-
span.run86 {
|
|
494
|
-
background-color: rgb(255, 218, 178);
|
|
495
|
-
display: block;
|
|
496
|
-
}
|
|
497
|
-
span.run87 {
|
|
498
|
-
background-color: rgb(255, 215, 178);
|
|
499
|
-
display: block;
|
|
500
|
-
}
|
|
501
|
-
span.run88 {
|
|
502
|
-
background-color: rgb(255, 212, 178);
|
|
503
|
-
display: block;
|
|
504
|
-
}
|
|
505
|
-
span.run89 {
|
|
506
|
-
background-color: rgb(255, 210, 178);
|
|
507
|
-
display: block;
|
|
508
|
-
}
|
|
509
|
-
span.run90 {
|
|
510
|
-
background-color: rgb(255, 206, 178);
|
|
511
|
-
display: block;
|
|
512
|
-
}
|
|
513
|
-
span.run91 {
|
|
514
|
-
background-color: rgb(255, 204, 178);
|
|
515
|
-
display: block;
|
|
516
|
-
}
|
|
517
|
-
span.run92 {
|
|
518
|
-
background-color: rgb(255, 201, 178);
|
|
519
|
-
display: block;
|
|
520
|
-
}
|
|
521
|
-
span.run93 {
|
|
522
|
-
background-color: rgb(255, 198, 178);
|
|
523
|
-
display: block;
|
|
524
|
-
}
|
|
525
|
-
span.run94 {
|
|
526
|
-
background-color: rgb(255, 196, 178);
|
|
527
|
-
display: block;
|
|
528
|
-
}
|
|
529
|
-
span.run95 {
|
|
530
|
-
background-color: rgb(255, 192, 178);
|
|
531
|
-
display: block;
|
|
532
|
-
}
|
|
533
|
-
span.run96 {
|
|
534
|
-
background-color: rgb(255, 189, 178);
|
|
535
|
-
display: block;
|
|
536
|
-
}
|
|
537
|
-
span.run97 {
|
|
538
|
-
background-color: rgb(255, 187, 178);
|
|
539
|
-
display: block;
|
|
540
|
-
}
|
|
541
|
-
span.run98 {
|
|
542
|
-
background-color: rgb(255, 184, 178);
|
|
543
|
-
display: block;
|
|
544
|
-
}
|
|
545
|
-
span.run99 {
|
|
546
|
-
background-color: rgb(255, 182, 178);
|
|
547
|
-
display: block;
|
|
548
|
-
}
|
|
549
|
-
span.run100 {
|
|
550
|
-
background-color: rgb(255, 178, 178);
|
|
551
|
-
display: block;
|
|
552
|
-
}
|
|
553
|
-
</style>
|
|
554
|
-
</head>
|
|
555
|
-
<body><h3>C0 code coverage information</h3>
|
|
556
|
-
<p>Generated on Sat Jun 28 12:48:57 +0900 2008 with <a href='http://eigenclass.org/hiki/rcov'>rcov 0.8.1.2</a>
|
|
557
|
-
</p>
|
|
558
|
-
<hr/>
|
|
559
|
-
<pre><span class='marked0'>Code reported as executed by Ruby looks like this...
|
|
560
|
-
</span><span class='marked1'>and this: this line is also marked as covered.
|
|
561
|
-
</span><span class='inferred0'>Lines considered as run by rcov, but not reported by Ruby, look like this,
|
|
562
|
-
</span><span class='inferred1'>and this: these lines were inferred by rcov (using simple heuristics).
|
|
563
|
-
</span><span class='uncovered0'>Finally, here's a line marked as not executed.
|
|
564
|
-
</span></pre>
|
|
565
|
-
<table class='report'><thead><tr><td class='heading'>Name</td>
|
|
566
|
-
<td class='heading'>Total lines</td>
|
|
567
|
-
<td class='heading'>Lines of code</td>
|
|
568
|
-
<td class='heading'>Total coverage</td>
|
|
569
|
-
<td class='heading'>Code coverage</td>
|
|
570
|
-
</tr>
|
|
571
|
-
</thead>
|
|
572
|
-
<tbody><tr class='light'><td><a href='-System-Library-Frameworks-Ruby_framework-Versions-1_8-usr-lib-ruby-1_8-drb-drb_rb.html'>/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/lib/ruby/1.8/drb/drb.rb</a>
|
|
573
|
-
</td>
|
|
574
|
-
<td class='lines_total'><tt>1763</tt>
|
|
575
|
-
</td>
|
|
576
|
-
<td class='lines_code'><tt>861</tt>
|
|
577
|
-
</td>
|
|
578
|
-
<td><table cellspacing='0' cellpadding='0' align='right'><tr><td><tt class='coverage_total'>61.9%</tt>
|
|
579
|
-
</td>
|
|
580
|
-
<td><table cellspacing='0' class='percent_graph' cellpadding='0' width='100'><tr><td class='covered' width='62'/>
|
|
581
|
-
<td class='uncovered' width='38'/>
|
|
582
|
-
</tr>
|
|
583
|
-
</table>
|
|
584
|
-
</td>
|
|
585
|
-
</tr>
|
|
586
|
-
</table>
|
|
587
|
-
</td>
|
|
588
|
-
<td><table cellspacing='0' cellpadding='0' align='right'><tr><td><tt class='coverage_code'>24.0%</tt>
|
|
589
|
-
</td>
|
|
590
|
-
<td><table cellspacing='0' class='percent_graph' cellpadding='0' width='100'><tr><td class='covered' width='24'/>
|
|
591
|
-
<td class='uncovered' width='76'/>
|
|
592
|
-
</tr>
|
|
593
|
-
</table>
|
|
594
|
-
</td>
|
|
595
|
-
</tr>
|
|
596
|
-
</table>
|
|
597
|
-
</td>
|
|
598
|
-
</tr>
|
|
599
|
-
</tbody>
|
|
600
|
-
</table>
|
|
601
|
-
<pre><span class="inferred1"><a name="line1"></a> 1 #
|
|
602
|
-
</span><span class="inferred0"><a name="line2"></a> 2 # = drb/drb.rb
|
|
603
|
-
</span><span class="inferred1"><a name="line3"></a> 3 #
|
|
604
|
-
</span><span class="inferred0"><a name="line4"></a> 4 # Distributed Ruby: _dRuby_ version 2.0.4
|
|
605
|
-
</span><span class="inferred1"><a name="line5"></a> 5 #
|
|
606
|
-
</span><span class="inferred0"><a name="line6"></a> 6 # Copyright (c) 1999-2003 Masatoshi SEKI. You can redistribute it and/or
|
|
607
|
-
</span><span class="inferred1"><a name="line7"></a> 7 # modify it under the same terms as Ruby.
|
|
608
|
-
</span><span class="inferred0"><a name="line8"></a> 8 #
|
|
609
|
-
</span><span class="inferred1"><a name="line9"></a> 9 # Author:: Masatoshi SEKI
|
|
610
|
-
</span><span class="inferred0"><a name="line10"></a> 10 #
|
|
611
|
-
</span><span class="inferred1"><a name="line11"></a> 11 # Documentation:: William Webber (william@williamwebber.com)
|
|
612
|
-
</span><span class="inferred0"><a name="line12"></a> 12 #
|
|
613
|
-
</span><span class="inferred1"><a name="line13"></a> 13 # == Overview
|
|
614
|
-
</span><span class="inferred0"><a name="line14"></a> 14 #
|
|
615
|
-
</span><span class="inferred1"><a name="line15"></a> 15 # dRuby is a distributed object system for Ruby. It allows an object in one
|
|
616
|
-
</span><span class="inferred0"><a name="line16"></a> 16 # Ruby process to invoke methods on an object in another Ruby process on the
|
|
617
|
-
</span><span class="inferred1"><a name="line17"></a> 17 # same or a different machine.
|
|
618
|
-
</span><span class="inferred0"><a name="line18"></a> 18 #
|
|
619
|
-
</span><span class="inferred1"><a name="line19"></a> 19 # The Ruby standard library contains the core classes of the dRuby package.
|
|
620
|
-
</span><span class="inferred0"><a name="line20"></a> 20 # However, the full package also includes access control lists and the
|
|
621
|
-
</span><span class="inferred1"><a name="line21"></a> 21 # Rinda tuple-space distributed task management system, as well as a
|
|
622
|
-
</span><span class="inferred0"><a name="line22"></a> 22 # large number of samples. The full dRuby package can be downloaded from
|
|
623
|
-
</span><span class="inferred1"><a name="line23"></a> 23 # the dRuby home page (see *References*).
|
|
624
|
-
</span><span class="inferred0"><a name="line24"></a> 24 #
|
|
625
|
-
</span><span class="inferred1"><a name="line25"></a> 25 # For an introduction and examples of usage see the documentation to the
|
|
626
|
-
</span><span class="inferred0"><a name="line26"></a> 26 # DRb module.
|
|
627
|
-
</span><span class="inferred1"><a name="line27"></a> 27 #
|
|
628
|
-
</span><span class="inferred0"><a name="line28"></a> 28 # == References
|
|
629
|
-
</span><span class="inferred1"><a name="line29"></a> 29 #
|
|
630
|
-
</span><span class="inferred0"><a name="line30"></a> 30 # [http://www2a.biglobe.ne.jp/~seki/ruby/druby.html]
|
|
631
|
-
</span><span class="inferred1"><a name="line31"></a> 31 # The dRuby home page, in Japanese. Contains the full dRuby package
|
|
632
|
-
</span><span class="inferred0"><a name="line32"></a> 32 # and links to other Japanese-language sources.
|
|
633
|
-
</span><span class="inferred1"><a name="line33"></a> 33 #
|
|
634
|
-
</span><span class="inferred0"><a name="line34"></a> 34 # [http://www2a.biglobe.ne.jp/~seki/ruby/druby.en.html]
|
|
635
|
-
</span><span class="inferred1"><a name="line35"></a> 35 # The English version of the dRuby home page.
|
|
636
|
-
</span><span class="inferred0"><a name="line36"></a> 36 #
|
|
637
|
-
</span><span class="inferred1"><a name="line37"></a> 37 # [http://www.chadfowler.com/ruby/drb.html]
|
|
638
|
-
</span><span class="inferred0"><a name="line38"></a> 38 # A quick tutorial introduction to using dRuby by Chad Fowler.
|
|
639
|
-
</span><span class="inferred1"><a name="line39"></a> 39 #
|
|
640
|
-
</span><span class="inferred0"><a name="line40"></a> 40 # [http://www.linux-mag.com/2002-09/ruby_05.html]
|
|
641
|
-
</span><span class="inferred1"><a name="line41"></a> 41 # A tutorial introduction to dRuby in Linux Magazine by Dave Thomas.
|
|
642
|
-
</span><span class="inferred0"><a name="line42"></a> 42 # Includes a discussion of Rinda.
|
|
643
|
-
</span><span class="inferred1"><a name="line43"></a> 43 #
|
|
644
|
-
</span><span class="inferred0"><a name="line44"></a> 44 # [http://www.eng.cse.dmu.ac.uk/~hgs/ruby/dRuby/]
|
|
645
|
-
</span><span class="inferred1"><a name="line45"></a> 45 # Links to English-language Ruby material collected by Hugh Sasse.
|
|
646
|
-
</span><span class="inferred0"><a name="line46"></a> 46 #
|
|
647
|
-
</span><span class="inferred1"><a name="line47"></a> 47 # [http://www.rubycentral.com/book/ospace.html]
|
|
648
|
-
</span><span class="inferred0"><a name="line48"></a> 48 # The chapter from *Programming* *Ruby* by Dave Thomas and Andy Hunt
|
|
649
|
-
</span><span class="inferred1"><a name="line49"></a> 49 # which discusses dRuby.
|
|
650
|
-
</span><span class="inferred0"><a name="line50"></a> 50 #
|
|
651
|
-
</span><span class="inferred1"><a name="line51"></a> 51 # [http://www.clio.ne.jp/home/web-i31s/Flotuard/Ruby/PRC2K_seki/dRuby.en.html]
|
|
652
|
-
</span><span class="inferred0"><a name="line52"></a> 52 # Translation of presentation on Ruby by Masatoshi Seki.
|
|
653
|
-
</span><span class="inferred1"><a name="line53"></a> 53
|
|
654
|
-
</span><span class="marked0"><a name="line54"></a> 54 require 'socket'
|
|
655
|
-
</span><span class="marked1"><a name="line55"></a> 55 require 'thread'
|
|
656
|
-
</span><span class="marked0"><a name="line56"></a> 56 require 'fcntl'
|
|
657
|
-
</span><span class="marked1"><a name="line57"></a> 57 require 'drb/eq'
|
|
658
|
-
</span><span class="inferred0"><a name="line58"></a> 58
|
|
659
|
-
</span><span class="inferred1"><a name="line59"></a> 59 #
|
|
660
|
-
</span><span class="inferred0"><a name="line60"></a> 60 # == Overview
|
|
661
|
-
</span><span class="inferred1"><a name="line61"></a> 61 #
|
|
662
|
-
</span><span class="inferred0"><a name="line62"></a> 62 # dRuby is a distributed object system for Ruby. It is written in
|
|
663
|
-
</span><span class="inferred1"><a name="line63"></a> 63 # pure Ruby and uses its own protocol. No add-in services are needed
|
|
664
|
-
</span><span class="inferred0"><a name="line64"></a> 64 # beyond those provided by the Ruby runtime, such as TCP sockets. It
|
|
665
|
-
</span><span class="inferred1"><a name="line65"></a> 65 # does not rely on or interoperate with other distributed object
|
|
666
|
-
</span><span class="inferred0"><a name="line66"></a> 66 # systems such as CORBA, RMI, or .NET.
|
|
667
|
-
</span><span class="inferred1"><a name="line67"></a> 67 #
|
|
668
|
-
</span><span class="inferred0"><a name="line68"></a> 68 # dRuby allows methods to be called in one Ruby process upon a Ruby
|
|
669
|
-
</span><span class="inferred1"><a name="line69"></a> 69 # object located in another Ruby process, even on another machine.
|
|
670
|
-
</span><span class="inferred0"><a name="line70"></a> 70 # References to objects can be passed between processes. Method
|
|
671
|
-
</span><span class="inferred1"><a name="line71"></a> 71 # arguments and return values are dumped and loaded in marshalled
|
|
672
|
-
</span><span class="inferred0"><a name="line72"></a> 72 # format. All of this is done transparently to both the caller of the
|
|
673
|
-
</span><span class="inferred1"><a name="line73"></a> 73 # remote method and the object that it is called upon.
|
|
674
|
-
</span><span class="inferred0"><a name="line74"></a> 74 #
|
|
675
|
-
</span><span class="inferred1"><a name="line75"></a> 75 # An object in a remote process is locally represented by a
|
|
676
|
-
</span><span class="inferred0"><a name="line76"></a> 76 # DRb::DRbObject instance. This acts as a sort of proxy for the
|
|
677
|
-
</span><span class="inferred1"><a name="line77"></a> 77 # remote object. Methods called upon this DRbObject instance are
|
|
678
|
-
</span><span class="inferred0"><a name="line78"></a> 78 # forwarded to its remote object. This is arranged dynamically at run
|
|
679
|
-
</span><span class="inferred1"><a name="line79"></a> 79 # time. There are no statically declared interfaces for remote
|
|
680
|
-
</span><span class="inferred0"><a name="line80"></a> 80 # objects, such as CORBA's IDL.
|
|
681
|
-
</span><span class="inferred1"><a name="line81"></a> 81 #
|
|
682
|
-
</span><span class="inferred0"><a name="line82"></a> 82 # dRuby calls made into a process are handled by a DRb::DRbServer
|
|
683
|
-
</span><span class="inferred1"><a name="line83"></a> 83 # instance within that process. This reconstitutes the method call,
|
|
684
|
-
</span><span class="inferred0"><a name="line84"></a> 84 # invokes it upon the specified local object, and returns the value to
|
|
685
|
-
</span><span class="inferred1"><a name="line85"></a> 85 # the remote caller. Any object can receive calls over dRuby. There
|
|
686
|
-
</span><span class="inferred0"><a name="line86"></a> 86 # is no need to implement a special interface, or mixin special
|
|
687
|
-
</span><span class="inferred1"><a name="line87"></a> 87 # functionality. Nor, in the general case, does an object need to
|
|
688
|
-
</span><span class="inferred0"><a name="line88"></a> 88 # explicitly register itself with a DRbServer in order to receive
|
|
689
|
-
</span><span class="inferred1"><a name="line89"></a> 89 # dRuby calls.
|
|
690
|
-
</span><span class="inferred0"><a name="line90"></a> 90 #
|
|
691
|
-
</span><span class="inferred1"><a name="line91"></a> 91 # One process wishing to make dRuby calls upon another process must
|
|
692
|
-
</span><span class="inferred0"><a name="line92"></a> 92 # somehow obtain an initial reference to an object in the remote
|
|
693
|
-
</span><span class="inferred1"><a name="line93"></a> 93 # process by some means other than as the return value of a remote
|
|
694
|
-
</span><span class="inferred0"><a name="line94"></a> 94 # method call, as there is initially no remote object reference it can
|
|
695
|
-
</span><span class="inferred1"><a name="line95"></a> 95 # invoke a method upon. This is done by attaching to the server by
|
|
696
|
-
</span><span class="inferred0"><a name="line96"></a> 96 # URI. Each DRbServer binds itself to a URI such as
|
|
697
|
-
</span><span class="inferred1"><a name="line97"></a> 97 # 'druby://example.com:8787'. A DRbServer can have an object attached
|
|
698
|
-
</span><span class="inferred0"><a name="line98"></a> 98 # to it that acts as the server's *front* *object*. A DRbObject can
|
|
699
|
-
</span><span class="inferred1"><a name="line99"></a> 99 # be explicitly created from the server's URI. This DRbObject's
|
|
700
|
-
</span><span class="inferred0"><a name="line100"></a> 100 # remote object will be the server's front object. This front object
|
|
701
|
-
</span><span class="inferred1"><a name="line101"></a> 101 # can then return references to other Ruby objects in the DRbServer's
|
|
702
|
-
</span><span class="inferred0"><a name="line102"></a> 102 # process.
|
|
703
|
-
</span><span class="inferred1"><a name="line103"></a> 103 #
|
|
704
|
-
</span><span class="inferred0"><a name="line104"></a> 104 # Method calls made over dRuby behave largely the same as normal Ruby
|
|
705
|
-
</span><span class="inferred1"><a name="line105"></a> 105 # method calls made within a process. Method calls with blocks are
|
|
706
|
-
</span><span class="inferred0"><a name="line106"></a> 106 # supported, as are raising exceptions. In addition to a method's
|
|
707
|
-
</span><span class="inferred1"><a name="line107"></a> 107 # standard errors, a dRuby call may also raise one of the
|
|
708
|
-
</span><span class="inferred0"><a name="line108"></a> 108 # dRuby-specific errors, all of which are subclasses of DRb::DRbError.
|
|
709
|
-
</span><span class="inferred1"><a name="line109"></a> 109 #
|
|
710
|
-
</span><span class="inferred0"><a name="line110"></a> 110 # Any type of object can be passed as an argument to a dRuby call or
|
|
711
|
-
</span><span class="inferred1"><a name="line111"></a> 111 # returned as its return value. By default, such objects are dumped
|
|
712
|
-
</span><span class="inferred0"><a name="line112"></a> 112 # or marshalled at the local end, then loaded or unmarshalled at the
|
|
713
|
-
</span><span class="inferred1"><a name="line113"></a> 113 # remote end. The remote end therefore receives a copy of the local
|
|
714
|
-
</span><span class="inferred0"><a name="line114"></a> 114 # object, not a distributed reference to it; methods invoked upon this
|
|
715
|
-
</span><span class="inferred1"><a name="line115"></a> 115 # copy are executed entirely in the remote process, not passed on to
|
|
716
|
-
</span><span class="inferred0"><a name="line116"></a> 116 # the local original. This has semantics similar to pass-by-value.
|
|
717
|
-
</span><span class="inferred1"><a name="line117"></a> 117 #
|
|
718
|
-
</span><span class="inferred0"><a name="line118"></a> 118 # However, if an object cannot be marshalled, a dRuby reference to it
|
|
719
|
-
</span><span class="inferred1"><a name="line119"></a> 119 # is passed or returned instead. This will turn up at the remote end
|
|
720
|
-
</span><span class="inferred0"><a name="line120"></a> 120 # as a DRbObject instance. All methods invoked upon this remote proxy
|
|
721
|
-
</span><span class="inferred1"><a name="line121"></a> 121 # are forwarded to the local object, as described in the discussion of
|
|
722
|
-
</span><span class="inferred0"><a name="line122"></a> 122 # DRbObjects. This has semantics similar to the normal Ruby
|
|
723
|
-
</span><span class="inferred1"><a name="line123"></a> 123 # pass-by-reference.
|
|
724
|
-
</span><span class="inferred0"><a name="line124"></a> 124 #
|
|
725
|
-
</span><span class="inferred1"><a name="line125"></a> 125 # The easiest way to signal that we want an otherwise marshallable
|
|
726
|
-
</span><span class="inferred0"><a name="line126"></a> 126 # object to be passed or returned as a DRbObject reference, rather
|
|
727
|
-
</span><span class="inferred1"><a name="line127"></a> 127 # than marshalled and sent as a copy, is to include the
|
|
728
|
-
</span><span class="inferred0"><a name="line128"></a> 128 # DRb::DRbUndumped mixin module.
|
|
729
|
-
</span><span class="inferred1"><a name="line129"></a> 129 #
|
|
730
|
-
</span><span class="inferred0"><a name="line130"></a> 130 # dRuby supports calling remote methods with blocks. As blocks (or
|
|
731
|
-
</span><span class="inferred1"><a name="line131"></a> 131 # rather the Proc objects that represent them) are not marshallable,
|
|
732
|
-
</span><span class="inferred0"><a name="line132"></a> 132 # the block executes in the local, not the remote, context. Each
|
|
733
|
-
</span><span class="inferred1"><a name="line133"></a> 133 # value yielded to the block is passed from the remote object to the
|
|
734
|
-
</span><span class="inferred0"><a name="line134"></a> 134 # local block, then the value returned by each block invocation is
|
|
735
|
-
</span><span class="inferred1"><a name="line135"></a> 135 # passed back to the remote execution context to be collected, before
|
|
736
|
-
</span><span class="inferred0"><a name="line136"></a> 136 # the collected values are finally returned to the local context as
|
|
737
|
-
</span><span class="inferred1"><a name="line137"></a> 137 # the return value of the method invocation.
|
|
738
|
-
</span><span class="inferred0"><a name="line138"></a> 138 #
|
|
739
|
-
</span><span class="inferred1"><a name="line139"></a> 139 # == Examples of usage
|
|
740
|
-
</span><span class="inferred0"><a name="line140"></a> 140 #
|
|
741
|
-
</span><span class="inferred1"><a name="line141"></a> 141 # For more dRuby samples, see the +samples+ directory in the full
|
|
742
|
-
</span><span class="inferred0"><a name="line142"></a> 142 # dRuby distribution.
|
|
743
|
-
</span><span class="inferred1"><a name="line143"></a> 143 #
|
|
744
|
-
</span><span class="inferred0"><a name="line144"></a> 144 # === dRuby in client/server mode
|
|
745
|
-
</span><span class="inferred1"><a name="line145"></a> 145 #
|
|
746
|
-
</span><span class="inferred0"><a name="line146"></a> 146 # This illustrates setting up a simple client-server drb
|
|
747
|
-
</span><span class="inferred1"><a name="line147"></a> 147 # system. Run the server and client code in different terminals,
|
|
748
|
-
</span><span class="inferred0"><a name="line148"></a> 148 # starting the server code first.
|
|
749
|
-
</span><span class="inferred1"><a name="line149"></a> 149 #
|
|
750
|
-
</span><span class="inferred0"><a name="line150"></a> 150 # ==== Server code
|
|
751
|
-
</span><span class="inferred1"><a name="line151"></a> 151 #
|
|
752
|
-
</span><span class="inferred0"><a name="line152"></a> 152 # require 'drb/drb'
|
|
753
|
-
</span><span class="inferred1"><a name="line153"></a> 153 #
|
|
754
|
-
</span><span class="inferred0"><a name="line154"></a> 154 # # The URI for the server to connect to
|
|
755
|
-
</span><span class="inferred1"><a name="line155"></a> 155 # URI="druby://localhost:8787"
|
|
756
|
-
</span><span class="inferred0"><a name="line156"></a> 156 #
|
|
757
|
-
</span><span class="inferred1"><a name="line157"></a> 157 # class TimeServer
|
|
758
|
-
</span><span class="inferred0"><a name="line158"></a> 158 #
|
|
759
|
-
</span><span class="inferred1"><a name="line159"></a> 159 # def get_current_time
|
|
760
|
-
</span><span class="inferred0"><a name="line160"></a> 160 # return Time.now
|
|
761
|
-
</span><span class="inferred1"><a name="line161"></a> 161 # end
|
|
762
|
-
</span><span class="inferred0"><a name="line162"></a> 162 #
|
|
763
|
-
</span><span class="inferred1"><a name="line163"></a> 163 # end
|
|
764
|
-
</span><span class="inferred0"><a name="line164"></a> 164 #
|
|
765
|
-
</span><span class="inferred1"><a name="line165"></a> 165 # # The object that handles requests on the server
|
|
766
|
-
</span><span class="inferred0"><a name="line166"></a> 166 # FRONT_OBJECT=TimeServer.new
|
|
767
|
-
</span><span class="inferred1"><a name="line167"></a> 167 #
|
|
768
|
-
</span><span class="inferred0"><a name="line168"></a> 168 # $SAFE = 1 # disable eval() and friends
|
|
769
|
-
</span><span class="inferred1"><a name="line169"></a> 169 #
|
|
770
|
-
</span><span class="inferred0"><a name="line170"></a> 170 # DRb.start_service(URI, FRONT_OBJECT)
|
|
771
|
-
</span><span class="inferred1"><a name="line171"></a> 171 # # Wait for the drb server thread to finish before exiting.
|
|
772
|
-
</span><span class="inferred0"><a name="line172"></a> 172 # DRb.thread.join
|
|
773
|
-
</span><span class="inferred1"><a name="line173"></a> 173 #
|
|
774
|
-
</span><span class="inferred0"><a name="line174"></a> 174 # ==== Client code
|
|
775
|
-
</span><span class="inferred1"><a name="line175"></a> 175 #
|
|
776
|
-
</span><span class="inferred0"><a name="line176"></a> 176 # require 'drb/drb'
|
|
777
|
-
</span><span class="inferred1"><a name="line177"></a> 177 #
|
|
778
|
-
</span><span class="inferred0"><a name="line178"></a> 178 # # The URI to connect to
|
|
779
|
-
</span><span class="inferred1"><a name="line179"></a> 179 # SERVER_URI="druby://localhost:8787"
|
|
780
|
-
</span><span class="inferred0"><a name="line180"></a> 180 #
|
|
781
|
-
</span><span class="inferred1"><a name="line181"></a> 181 # # Start a local DRbServer to handle callbacks.
|
|
782
|
-
</span><span class="inferred0"><a name="line182"></a> 182 # #
|
|
783
|
-
</span><span class="inferred1"><a name="line183"></a> 183 # # Not necessary for this small example, but will be required
|
|
784
|
-
</span><span class="inferred0"><a name="line184"></a> 184 # # as soon as we pass a non-marshallable object as an argument
|
|
785
|
-
</span><span class="inferred1"><a name="line185"></a> 185 # # to a dRuby call.
|
|
786
|
-
</span><span class="inferred0"><a name="line186"></a> 186 # DRb.start_service
|
|
787
|
-
</span><span class="inferred1"><a name="line187"></a> 187 #
|
|
788
|
-
</span><span class="inferred0"><a name="line188"></a> 188 # timeserver = DRbObject.new_with_uri(SERVER_URI)
|
|
789
|
-
</span><span class="inferred1"><a name="line189"></a> 189 # puts timeserver.get_current_time
|
|
790
|
-
</span><span class="inferred0"><a name="line190"></a> 190 #
|
|
791
|
-
</span><span class="inferred1"><a name="line191"></a> 191 # === Remote objects under dRuby
|
|
792
|
-
</span><span class="inferred0"><a name="line192"></a> 192 #
|
|
793
|
-
</span><span class="inferred1"><a name="line193"></a> 193 # This example illustrates returning a reference to an object
|
|
794
|
-
</span><span class="inferred0"><a name="line194"></a> 194 # from a dRuby call. The Logger instances live in the server
|
|
795
|
-
</span><span class="inferred1"><a name="line195"></a> 195 # process. References to them are returned to the client process,
|
|
796
|
-
</span><span class="inferred0"><a name="line196"></a> 196 # where methods can be invoked upon them. These methods are
|
|
797
|
-
</span><span class="inferred1"><a name="line197"></a> 197 # executed in the server process.
|
|
798
|
-
</span><span class="inferred0"><a name="line198"></a> 198 #
|
|
799
|
-
</span><span class="inferred1"><a name="line199"></a> 199 # ==== Server code
|
|
800
|
-
</span><span class="inferred0"><a name="line200"></a> 200 #
|
|
801
|
-
</span><span class="inferred1"><a name="line201"></a> 201 # require 'drb/drb'
|
|
802
|
-
</span><span class="inferred0"><a name="line202"></a> 202 #
|
|
803
|
-
</span><span class="inferred1"><a name="line203"></a> 203 # URI="druby://localhost:8787"
|
|
804
|
-
</span><span class="inferred0"><a name="line204"></a> 204 #
|
|
805
|
-
</span><span class="inferred1"><a name="line205"></a> 205 # class Logger
|
|
806
|
-
</span><span class="inferred0"><a name="line206"></a> 206 #
|
|
807
|
-
</span><span class="inferred1"><a name="line207"></a> 207 # # Make dRuby send Logger instances as dRuby references,
|
|
808
|
-
</span><span class="inferred0"><a name="line208"></a> 208 # # not copies.
|
|
809
|
-
</span><span class="inferred1"><a name="line209"></a> 209 # include DRb::DRbUndumped
|
|
810
|
-
</span><span class="inferred0"><a name="line210"></a> 210 #
|
|
811
|
-
</span><span class="inferred1"><a name="line211"></a> 211 # def initialize(n, fname)
|
|
812
|
-
</span><span class="inferred0"><a name="line212"></a> 212 # @name = n
|
|
813
|
-
</span><span class="inferred1"><a name="line213"></a> 213 # @filename = fname
|
|
814
|
-
</span><span class="inferred0"><a name="line214"></a> 214 # end
|
|
815
|
-
</span><span class="inferred1"><a name="line215"></a> 215 #
|
|
816
|
-
</span><span class="inferred0"><a name="line216"></a> 216 # def log(message)
|
|
817
|
-
</span><span class="inferred1"><a name="line217"></a> 217 # File.open(@filename, "a") do |f|
|
|
818
|
-
</span><span class="inferred0"><a name="line218"></a> 218 # f.puts("#{Time.now}: #{@name}: #{message}")
|
|
819
|
-
</span><span class="inferred1"><a name="line219"></a> 219 # end
|
|
820
|
-
</span><span class="inferred0"><a name="line220"></a> 220 # end
|
|
821
|
-
</span><span class="inferred1"><a name="line221"></a> 221 #
|
|
822
|
-
</span><span class="inferred0"><a name="line222"></a> 222 # end
|
|
823
|
-
</span><span class="inferred1"><a name="line223"></a> 223 #
|
|
824
|
-
</span><span class="inferred0"><a name="line224"></a> 224 # # We have a central object for creating and retrieving loggers.
|
|
825
|
-
</span><span class="inferred1"><a name="line225"></a> 225 # # This retains a local reference to all loggers created. This
|
|
826
|
-
</span><span class="inferred0"><a name="line226"></a> 226 # # is so an existing logger can be looked up by name, but also
|
|
827
|
-
</span><span class="inferred1"><a name="line227"></a> 227 # # to prevent loggers from being garbage collected. A dRuby
|
|
828
|
-
</span><span class="inferred0"><a name="line228"></a> 228 # # reference to an object is not sufficient to prevent it being
|
|
829
|
-
</span><span class="inferred1"><a name="line229"></a> 229 # # garbage collected!
|
|
830
|
-
</span><span class="inferred0"><a name="line230"></a> 230 # class LoggerFactory
|
|
831
|
-
</span><span class="inferred1"><a name="line231"></a> 231 #
|
|
832
|
-
</span><span class="inferred0"><a name="line232"></a> 232 # def initialize(bdir)
|
|
833
|
-
</span><span class="inferred1"><a name="line233"></a> 233 # @basedir = bdir
|
|
834
|
-
</span><span class="inferred0"><a name="line234"></a> 234 # @loggers = {}
|
|
835
|
-
</span><span class="inferred1"><a name="line235"></a> 235 # end
|
|
836
|
-
</span><span class="inferred0"><a name="line236"></a> 236 #
|
|
837
|
-
</span><span class="inferred1"><a name="line237"></a> 237 # def get_logger(name)
|
|
838
|
-
</span><span class="inferred0"><a name="line238"></a> 238 # if !@loggers.has_key? name
|
|
839
|
-
</span><span class="inferred1"><a name="line239"></a> 239 # # make the filename safe, then declare it to be so
|
|
840
|
-
</span><span class="inferred0"><a name="line240"></a> 240 # fname = name.gsub(/[.\/]/, "_").untaint
|
|
841
|
-
</span><span class="inferred1"><a name="line241"></a> 241 # @loggers[name] = Logger.new(name, @basedir + "/" + fname)
|
|
842
|
-
</span><span class="inferred0"><a name="line242"></a> 242 # end
|
|
843
|
-
</span><span class="inferred1"><a name="line243"></a> 243 # return @loggers[name]
|
|
844
|
-
</span><span class="inferred0"><a name="line244"></a> 244 # end
|
|
845
|
-
</span><span class="inferred1"><a name="line245"></a> 245 #
|
|
846
|
-
</span><span class="inferred0"><a name="line246"></a> 246 # end
|
|
847
|
-
</span><span class="inferred1"><a name="line247"></a> 247 #
|
|
848
|
-
</span><span class="inferred0"><a name="line248"></a> 248 # FRONT_OBJECT=LoggerFactory.new("/tmp/dlog")
|
|
849
|
-
</span><span class="inferred1"><a name="line249"></a> 249 #
|
|
850
|
-
</span><span class="inferred0"><a name="line250"></a> 250 # $SAFE = 1 # disable eval() and friends
|
|
851
|
-
</span><span class="inferred1"><a name="line251"></a> 251 #
|
|
852
|
-
</span><span class="inferred0"><a name="line252"></a> 252 # DRb.start_service(URI, FRONT_OBJECT)
|
|
853
|
-
</span><span class="inferred1"><a name="line253"></a> 253 # DRb.thread.join
|
|
854
|
-
</span><span class="inferred0"><a name="line254"></a> 254 #
|
|
855
|
-
</span><span class="inferred1"><a name="line255"></a> 255 # ==== Client code
|
|
856
|
-
</span><span class="inferred0"><a name="line256"></a> 256 #
|
|
857
|
-
</span><span class="inferred1"><a name="line257"></a> 257 # require 'drb/drb'
|
|
858
|
-
</span><span class="inferred0"><a name="line258"></a> 258 #
|
|
859
|
-
</span><span class="inferred1"><a name="line259"></a> 259 # SERVER_URI="druby://localhost:8787"
|
|
860
|
-
</span><span class="inferred0"><a name="line260"></a> 260 #
|
|
861
|
-
</span><span class="inferred1"><a name="line261"></a> 261 # DRb.start_service
|
|
862
|
-
</span><span class="inferred0"><a name="line262"></a> 262 #
|
|
863
|
-
</span><span class="inferred1"><a name="line263"></a> 263 # log_service=DRbObject.new_with_uri(SERVER_URI)
|
|
864
|
-
</span><span class="inferred0"><a name="line264"></a> 264 #
|
|
865
|
-
</span><span class="inferred1"><a name="line265"></a> 265 # ["loga", "logb", "logc"].each do |logname|
|
|
866
|
-
</span><span class="inferred0"><a name="line266"></a> 266 #
|
|
867
|
-
</span><span class="inferred1"><a name="line267"></a> 267 # logger=log_service.get_logger(logname)
|
|
868
|
-
</span><span class="inferred0"><a name="line268"></a> 268 #
|
|
869
|
-
</span><span class="inferred1"><a name="line269"></a> 269 # logger.log("Hello, world!")
|
|
870
|
-
</span><span class="inferred0"><a name="line270"></a> 270 # logger.log("Goodbye, world!")
|
|
871
|
-
</span><span class="inferred1"><a name="line271"></a> 271 # logger.log("=== EOT ===")
|
|
872
|
-
</span><span class="inferred0"><a name="line272"></a> 272 #
|
|
873
|
-
</span><span class="inferred1"><a name="line273"></a> 273 # end
|
|
874
|
-
</span><span class="inferred0"><a name="line274"></a> 274 #
|
|
875
|
-
</span><span class="inferred1"><a name="line275"></a> 275 # == Security
|
|
876
|
-
</span><span class="inferred0"><a name="line276"></a> 276 #
|
|
877
|
-
</span><span class="inferred1"><a name="line277"></a> 277 # As with all network services, security needs to be considered when
|
|
878
|
-
</span><span class="inferred0"><a name="line278"></a> 278 # using dRuby. By allowing external access to a Ruby object, you are
|
|
879
|
-
</span><span class="inferred1"><a name="line279"></a> 279 # not only allowing outside clients to call the methods you have
|
|
880
|
-
</span><span class="inferred0"><a name="line280"></a> 280 # defined for that object, but by default to execute arbitrary Ruby
|
|
881
|
-
</span><span class="inferred1"><a name="line281"></a> 281 # code on your server. Consider the following:
|
|
882
|
-
</span><span class="inferred0"><a name="line282"></a> 282 #
|
|
883
|
-
</span><span class="inferred1"><a name="line283"></a> 283 # # !!! UNSAFE CODE !!!
|
|
884
|
-
</span><span class="inferred0"><a name="line284"></a> 284 # ro = DRbObject::new_with_uri("druby://your.server.com:8989")
|
|
885
|
-
</span><span class="inferred1"><a name="line285"></a> 285 # class << ro
|
|
886
|
-
</span><span class="inferred0"><a name="line286"></a> 286 # undef :instance_eval # force call to be passed to remote object
|
|
887
|
-
</span><span class="inferred1"><a name="line287"></a> 287 # end
|
|
888
|
-
</span><span class="inferred0"><a name="line288"></a> 288 # ro.instance_eval("`rm -rf *`")
|
|
889
|
-
</span><span class="inferred1"><a name="line289"></a> 289 #
|
|
890
|
-
</span><span class="inferred0"><a name="line290"></a> 290 # The dangers posed by instance_eval and friends are such that a
|
|
891
|
-
</span><span class="inferred1"><a name="line291"></a> 291 # DRbServer should generally be run with $SAFE set to at least
|
|
892
|
-
</span><span class="inferred0"><a name="line292"></a> 292 # level 1. This will disable eval() and related calls on strings
|
|
893
|
-
</span><span class="inferred1"><a name="line293"></a> 293 # passed across the wire. The sample usage code given above follows
|
|
894
|
-
</span><span class="inferred0"><a name="line294"></a> 294 # this practice.
|
|
895
|
-
</span><span class="inferred1"><a name="line295"></a> 295 #
|
|
896
|
-
</span><span class="inferred0"><a name="line296"></a> 296 # A DRbServer can be configured with an access control list to
|
|
897
|
-
</span><span class="inferred1"><a name="line297"></a> 297 # selectively allow or deny access from specified IP addresses. The
|
|
898
|
-
</span><span class="inferred0"><a name="line298"></a> 298 # main druby distribution provides the ACL class for this purpose. In
|
|
899
|
-
</span><span class="inferred1"><a name="line299"></a> 299 # general, this mechanism should only be used alongside, rather than
|
|
900
|
-
</span><span class="inferred0"><a name="line300"></a> 300 # as a replacement for, a good firewall.
|
|
901
|
-
</span><span class="inferred1"><a name="line301"></a> 301 #
|
|
902
|
-
</span><span class="inferred0"><a name="line302"></a> 302 # == dRuby internals
|
|
903
|
-
</span><span class="inferred1"><a name="line303"></a> 303 #
|
|
904
|
-
</span><span class="inferred0"><a name="line304"></a> 304 # dRuby is implemented using three main components: a remote method
|
|
905
|
-
</span><span class="inferred1"><a name="line305"></a> 305 # call marshaller/unmarshaller; a transport protocol; and an
|
|
906
|
-
</span><span class="inferred0"><a name="line306"></a> 306 # ID-to-object mapper. The latter two can be directly, and the first
|
|
907
|
-
</span><span class="inferred1"><a name="line307"></a> 307 # indirectly, replaced, in order to provide different behaviour and
|
|
908
|
-
</span><span class="inferred0"><a name="line308"></a> 308 # capabilities.
|
|
909
|
-
</span><span class="inferred1"><a name="line309"></a> 309 #
|
|
910
|
-
</span><span class="inferred0"><a name="line310"></a> 310 # Marshalling and unmarshalling of remote method calls is performed by
|
|
911
|
-
</span><span class="inferred1"><a name="line311"></a> 311 # a DRb::DRbMessage instance. This uses the Marshal module to dump
|
|
912
|
-
</span><span class="inferred0"><a name="line312"></a> 312 # the method call before sending it over the transport layer, then
|
|
913
|
-
</span><span class="inferred1"><a name="line313"></a> 313 # reconstitute it at the other end. There is normally no need to
|
|
914
|
-
</span><span class="inferred0"><a name="line314"></a> 314 # replace this component, and no direct way is provided to do so.
|
|
915
|
-
</span><span class="inferred1"><a name="line315"></a> 315 # However, it is possible to implement an alternative marshalling
|
|
916
|
-
</span><span class="inferred0"><a name="line316"></a> 316 # scheme as part of an implementation of the transport layer.
|
|
917
|
-
</span><span class="inferred1"><a name="line317"></a> 317 #
|
|
918
|
-
</span><span class="inferred0"><a name="line318"></a> 318 # The transport layer is responsible for opening client and server
|
|
919
|
-
</span><span class="inferred1"><a name="line319"></a> 319 # network connections and forwarding dRuby request across them.
|
|
920
|
-
</span><span class="inferred0"><a name="line320"></a> 320 # Normally, it uses DRb::DRbMessage internally to manage marshalling
|
|
921
|
-
</span><span class="inferred1"><a name="line321"></a> 321 # and unmarshalling. The transport layer is managed by
|
|
922
|
-
</span><span class="inferred0"><a name="line322"></a> 322 # DRb::DRbProtocol. Multiple protocols can be installed in
|
|
923
|
-
</span><span class="inferred1"><a name="line323"></a> 323 # DRbProtocol at the one time; selection between them is determined by
|
|
924
|
-
</span><span class="inferred0"><a name="line324"></a> 324 # the scheme of a dRuby URI. The default transport protocol is
|
|
925
|
-
</span><span class="inferred1"><a name="line325"></a> 325 # selected by the scheme 'druby:', and implemented by
|
|
926
|
-
</span><span class="inferred0"><a name="line326"></a> 326 # DRb::DRbTCPSocket. This uses plain TCP/IP sockets for
|
|
927
|
-
</span><span class="inferred1"><a name="line327"></a> 327 # communication. An alternative protocol, using UNIX domain sockets,
|
|
928
|
-
</span><span class="inferred0"><a name="line328"></a> 328 # is implemented by DRb::DRbUNIXSocket in the file drb/unix.rb, and
|
|
929
|
-
</span><span class="inferred1"><a name="line329"></a> 329 # selected by the scheme 'drbunix:'. A sample implementation over
|
|
930
|
-
</span><span class="inferred0"><a name="line330"></a> 330 # HTTP can be found in the samples accompanying the main dRuby
|
|
931
|
-
</span><span class="inferred1"><a name="line331"></a> 331 # distribution.
|
|
932
|
-
</span><span class="inferred0"><a name="line332"></a> 332 #
|
|
933
|
-
</span><span class="inferred1"><a name="line333"></a> 333 # The ID-to-object mapping component maps dRuby object ids to the
|
|
934
|
-
</span><span class="inferred0"><a name="line334"></a> 334 # objects they refer to, and vice versa. The implementation to use
|
|
935
|
-
</span><span class="inferred1"><a name="line335"></a> 335 # can be specified as part of a DRb::DRbServer's configuration. The
|
|
936
|
-
</span><span class="inferred0"><a name="line336"></a> 336 # default implementation is provided by DRb::DRbIdConv. It uses an
|
|
937
|
-
</span><span class="inferred1"><a name="line337"></a> 337 # object's ObjectSpace id as its dRuby id. This means that the dRuby
|
|
938
|
-
</span><span class="inferred0"><a name="line338"></a> 338 # reference to that object only remains meaningful for the lifetime of
|
|
939
|
-
</span><span class="inferred1"><a name="line339"></a> 339 # the object's process and the lifetime of the object within that
|
|
940
|
-
</span><span class="inferred0"><a name="line340"></a> 340 # process. A modified implementation is provided by DRb::TimerIdConv
|
|
941
|
-
</span><span class="inferred1"><a name="line341"></a> 341 # in the file drb/timeridconv.rb. This implementation retains a local
|
|
942
|
-
</span><span class="inferred0"><a name="line342"></a> 342 # reference to all objects exported over dRuby for a configurable
|
|
943
|
-
</span><span class="inferred1"><a name="line343"></a> 343 # period of time (defaulting to ten minutes), to prevent them being
|
|
944
|
-
</span><span class="inferred0"><a name="line344"></a> 344 # garbage-collected within this time. Another sample implementation
|
|
945
|
-
</span><span class="inferred1"><a name="line345"></a> 345 # is provided in sample/name.rb in the main dRuby distribution. This
|
|
946
|
-
</span><span class="inferred0"><a name="line346"></a> 346 # allows objects to specify their own id or "name". A dRuby reference
|
|
947
|
-
</span><span class="inferred1"><a name="line347"></a> 347 # can be made persistent across processes by having each process
|
|
948
|
-
</span><span class="inferred0"><a name="line348"></a> 348 # register an object using the same dRuby name.
|
|
949
|
-
</span><span class="inferred1"><a name="line349"></a> 349 #
|
|
950
|
-
</span><span class="marked0"><a name="line350"></a> 350 module DRb
|
|
951
|
-
</span><span class="inferred1"><a name="line351"></a> 351
|
|
952
|
-
</span><span class="inferred0"><a name="line352"></a> 352 # Superclass of all errors raised in the DRb module.
|
|
953
|
-
</span><span class="marked1"><a name="line353"></a> 353 class DRbError < RuntimeError; end
|
|
954
|
-
</span><span class="inferred0"><a name="line354"></a> 354
|
|
955
|
-
</span><span class="inferred1"><a name="line355"></a> 355 # Error raised when an error occurs on the underlying communication
|
|
956
|
-
</span><span class="inferred0"><a name="line356"></a> 356 # protocol.
|
|
957
|
-
</span><span class="marked1"><a name="line357"></a> 357 class DRbConnError < DRbError; end
|
|
958
|
-
</span><span class="inferred0"><a name="line358"></a> 358
|
|
959
|
-
</span><span class="inferred1"><a name="line359"></a> 359 # Class responsible for converting between an object and its id.
|
|
960
|
-
</span><span class="inferred0"><a name="line360"></a> 360 #
|
|
961
|
-
</span><span class="inferred1"><a name="line361"></a> 361 # This, the default implementation, uses an object's local ObjectSpace
|
|
962
|
-
</span><span class="inferred0"><a name="line362"></a> 362 # __id__ as its id. This means that an object's identification over
|
|
963
|
-
</span><span class="inferred1"><a name="line363"></a> 363 # drb remains valid only while that object instance remains alive
|
|
964
|
-
</span><span class="inferred0"><a name="line364"></a> 364 # within the server runtime.
|
|
965
|
-
</span><span class="inferred1"><a name="line365"></a> 365 #
|
|
966
|
-
</span><span class="inferred0"><a name="line366"></a> 366 # For alternative mechanisms, see DRb::TimerIdConv in rdb/timeridconv.rb
|
|
967
|
-
</span><span class="inferred1"><a name="line367"></a> 367 # and DRbNameIdConv in sample/name.rb in the full drb distribution.
|
|
968
|
-
</span><span class="marked0"><a name="line368"></a> 368 class DRbIdConv
|
|
969
|
-
</span><span class="inferred1"><a name="line369"></a> 369
|
|
970
|
-
</span><span class="inferred0"><a name="line370"></a> 370 # Convert an object reference id to an object.
|
|
971
|
-
</span><span class="inferred1"><a name="line371"></a> 371 #
|
|
972
|
-
</span><span class="inferred0"><a name="line372"></a> 372 # This implementation looks up the reference id in the local object
|
|
973
|
-
</span><span class="inferred1"><a name="line373"></a> 373 # space and returns the object it refers to.
|
|
974
|
-
</span><span class="marked0"><a name="line374"></a> 374 def to_obj(ref)
|
|
975
|
-
</span><span class="uncovered1"><a name="line375"></a> 375 ObjectSpace._id2ref(ref)
|
|
976
|
-
</span><span class="uncovered0"><a name="line376"></a> 376 end
|
|
977
|
-
</span><span class="inferred1"><a name="line377"></a> 377
|
|
978
|
-
</span><span class="inferred0"><a name="line378"></a> 378 # Convert an object into a reference id.
|
|
979
|
-
</span><span class="inferred1"><a name="line379"></a> 379 #
|
|
980
|
-
</span><span class="inferred0"><a name="line380"></a> 380 # This implementation returns the object's __id__ in the local
|
|
981
|
-
</span><span class="inferred1"><a name="line381"></a> 381 # object space.
|
|
982
|
-
</span><span class="marked0"><a name="line382"></a> 382 def to_id(obj)
|
|
983
|
-
</span><span class="uncovered1"><a name="line383"></a> 383 obj.nil? ? nil : obj.__id__
|
|
984
|
-
</span><span class="uncovered0"><a name="line384"></a> 384 end
|
|
985
|
-
</span><span class="uncovered1"><a name="line385"></a> 385 end
|
|
986
|
-
</span><span class="inferred0"><a name="line386"></a> 386
|
|
987
|
-
</span><span class="inferred1"><a name="line387"></a> 387 # Mixin module making an object undumpable or unmarshallable.
|
|
988
|
-
</span><span class="inferred0"><a name="line388"></a> 388 #
|
|
989
|
-
</span><span class="inferred1"><a name="line389"></a> 389 # If an object which includes this module is returned by method
|
|
990
|
-
</span><span class="inferred0"><a name="line390"></a> 390 # called over drb, then the object remains in the server space
|
|
991
|
-
</span><span class="inferred1"><a name="line391"></a> 391 # and a reference to the object is returned, rather than the
|
|
992
|
-
</span><span class="inferred0"><a name="line392"></a> 392 # object being marshalled and moved into the client space.
|
|
993
|
-
</span><span class="marked1"><a name="line393"></a> 393 module DRbUndumped
|
|
994
|
-
</span><span class="marked0"><a name="line394"></a> 394 def _dump(dummy) # :nodoc:
|
|
995
|
-
</span><span class="uncovered1"><a name="line395"></a> 395 raise TypeError, 'can\'t dump'
|
|
996
|
-
</span><span class="uncovered0"><a name="line396"></a> 396 end
|
|
997
|
-
</span><span class="uncovered1"><a name="line397"></a> 397 end
|
|
998
|
-
</span><span class="inferred0"><a name="line398"></a> 398
|
|
999
|
-
</span><span class="inferred1"><a name="line399"></a> 399 # Error raised by the DRb module when an attempt is made to refer to
|
|
1000
|
-
</span><span class="inferred0"><a name="line400"></a> 400 # the context's current drb server but the context does not have one.
|
|
1001
|
-
</span><span class="inferred1"><a name="line401"></a> 401 # See #current_server.
|
|
1002
|
-
</span><span class="marked0"><a name="line402"></a> 402 class DRbServerNotFound < DRbError; end
|
|
1003
|
-
</span><span class="inferred1"><a name="line403"></a> 403
|
|
1004
|
-
</span><span class="inferred0"><a name="line404"></a> 404 # Error raised by the DRbProtocol module when it cannot find any
|
|
1005
|
-
</span><span class="inferred1"><a name="line405"></a> 405 # protocol implementation support the scheme specified in a URI.
|
|
1006
|
-
</span><span class="marked0"><a name="line406"></a> 406 class DRbBadURI < DRbError; end
|
|
1007
|
-
</span><span class="inferred1"><a name="line407"></a> 407
|
|
1008
|
-
</span><span class="inferred0"><a name="line408"></a> 408 # Error raised by a dRuby protocol when it doesn't support the
|
|
1009
|
-
</span><span class="inferred1"><a name="line409"></a> 409 # scheme specified in a URI. See DRb::DRbProtocol.
|
|
1010
|
-
</span><span class="marked0"><a name="line410"></a> 410 class DRbBadScheme < DRbError; end
|
|
1011
|
-
</span><span class="inferred1"><a name="line411"></a> 411
|
|
1012
|
-
</span><span class="inferred0"><a name="line412"></a> 412 # An exception wrapping a DRb::DRbUnknown object
|
|
1013
|
-
</span><span class="marked1"><a name="line413"></a> 413 class DRbUnknownError < DRbError
|
|
1014
|
-
</span><span class="inferred0"><a name="line414"></a> 414
|
|
1015
|
-
</span><span class="inferred1"><a name="line415"></a> 415 # Create a new DRbUnknownError for the DRb::DRbUnknown object +unknown+
|
|
1016
|
-
</span><span class="marked0"><a name="line416"></a> 416 def initialize(unknown)
|
|
1017
|
-
</span><span class="uncovered1"><a name="line417"></a> 417 @unknown = unknown
|
|
1018
|
-
</span><span class="uncovered0"><a name="line418"></a> 418 super(unknown.name)
|
|
1019
|
-
</span><span class="uncovered1"><a name="line419"></a> 419 end
|
|
1020
|
-
</span><span class="inferred0"><a name="line420"></a> 420
|
|
1021
|
-
</span><span class="inferred1"><a name="line421"></a> 421 # Get the wrapped DRb::DRbUnknown object.
|
|
1022
|
-
</span><span class="marked0"><a name="line422"></a> 422 attr_reader :unknown
|
|
1023
|
-
</span><span class="inferred1"><a name="line423"></a> 423
|
|
1024
|
-
</span><span class="marked0"><a name="line424"></a> 424 def self._load(s) # :nodoc:
|
|
1025
|
-
</span><span class="uncovered1"><a name="line425"></a> 425 Marshal::load(s)
|
|
1026
|
-
</span><span class="uncovered0"><a name="line426"></a> 426 end
|
|
1027
|
-
</span><span class="inferred1"><a name="line427"></a> 427
|
|
1028
|
-
</span><span class="marked0"><a name="line428"></a> 428 def _dump(lv) # :nodoc:
|
|
1029
|
-
</span><span class="uncovered1"><a name="line429"></a> 429 Marshal::dump(@unknown)
|
|
1030
|
-
</span><span class="uncovered0"><a name="line430"></a> 430 end
|
|
1031
|
-
</span><span class="uncovered1"><a name="line431"></a> 431 end
|
|
1032
|
-
</span><span class="inferred0"><a name="line432"></a> 432
|
|
1033
|
-
</span><span class="inferred1"><a name="line433"></a> 433 # An exception wrapping an error object
|
|
1034
|
-
</span><span class="marked0"><a name="line434"></a> 434 class DRbRemoteError < DRbError
|
|
1035
|
-
</span><span class="marked1"><a name="line435"></a> 435 def initialize(error)
|
|
1036
|
-
</span><span class="uncovered0"><a name="line436"></a> 436 @reason = error.class.to_s
|
|
1037
|
-
</span><span class="uncovered1"><a name="line437"></a> 437 super("#{error.message} (#{error.class})")
|
|
1038
|
-
</span><span class="uncovered0"><a name="line438"></a> 438 set_backtrace(error.backtrace)
|
|
1039
|
-
</span><span class="uncovered1"><a name="line439"></a> 439 end
|
|
1040
|
-
</span><span class="inferred0"><a name="line440"></a> 440
|
|
1041
|
-
</span><span class="inferred1"><a name="line441"></a> 441 # the class of the error, as a string.
|
|
1042
|
-
</span><span class="marked0"><a name="line442"></a> 442 attr_reader :reason
|
|
1043
|
-
</span><span class="inferred1"><a name="line443"></a> 443 end
|
|
1044
|
-
</span><span class="inferred0"><a name="line444"></a> 444
|
|
1045
|
-
</span><span class="inferred1"><a name="line445"></a> 445 # Class wrapping a marshalled object whose type is unknown locally.
|
|
1046
|
-
</span><span class="inferred0"><a name="line446"></a> 446 #
|
|
1047
|
-
</span><span class="inferred1"><a name="line447"></a> 447 # If an object is returned by a method invoked over drb, but the
|
|
1048
|
-
</span><span class="inferred0"><a name="line448"></a> 448 # class of the object is unknown in the client namespace, or
|
|
1049
|
-
</span><span class="inferred1"><a name="line449"></a> 449 # the object is a constant unknown in the client namespace, then
|
|
1050
|
-
</span><span class="inferred0"><a name="line450"></a> 450 # the still-marshalled object is returned wrapped in a DRbUnknown instance.
|
|
1051
|
-
</span><span class="inferred1"><a name="line451"></a> 451 #
|
|
1052
|
-
</span><span class="inferred0"><a name="line452"></a> 452 # If this object is passed as an argument to a method invoked over
|
|
1053
|
-
</span><span class="inferred1"><a name="line453"></a> 453 # drb, then the wrapped object is passed instead.
|
|
1054
|
-
</span><span class="inferred0"><a name="line454"></a> 454 #
|
|
1055
|
-
</span><span class="inferred1"><a name="line455"></a> 455 # The class or constant name of the object can be read from the
|
|
1056
|
-
</span><span class="inferred0"><a name="line456"></a> 456 # +name+ attribute. The marshalled object is held in the +buf+
|
|
1057
|
-
</span><span class="inferred1"><a name="line457"></a> 457 # attribute.
|
|
1058
|
-
</span><span class="marked0"><a name="line458"></a> 458 class DRbUnknown
|
|
1059
|
-
</span><span class="inferred1"><a name="line459"></a> 459
|
|
1060
|
-
</span><span class="inferred0"><a name="line460"></a> 460 # Create a new DRbUnknown object.
|
|
1061
|
-
</span><span class="inferred1"><a name="line461"></a> 461 #
|
|
1062
|
-
</span><span class="inferred0"><a name="line462"></a> 462 # +buf+ is a string containing a marshalled object that could not
|
|
1063
|
-
</span><span class="inferred1"><a name="line463"></a> 463 # be unmarshalled. +err+ is the error message that was raised
|
|
1064
|
-
</span><span class="inferred0"><a name="line464"></a> 464 # when the unmarshalling failed. It is used to determine the
|
|
1065
|
-
</span><span class="inferred1"><a name="line465"></a> 465 # name of the unmarshalled object.
|
|
1066
|
-
</span><span class="marked0"><a name="line466"></a> 466 def initialize(err, buf)
|
|
1067
|
-
</span><span class="uncovered1"><a name="line467"></a> 467 case err.to_s
|
|
1068
|
-
</span><span class="uncovered0"><a name="line468"></a> 468 when /uninitialized constant (\S+)/
|
|
1069
|
-
</span><span class="uncovered1"><a name="line469"></a> 469 @name = $1
|
|
1070
|
-
</span><span class="uncovered0"><a name="line470"></a> 470 when /undefined class\/module (\S+)/
|
|
1071
|
-
</span><span class="uncovered1"><a name="line471"></a> 471 @name = $1
|
|
1072
|
-
</span><span class="uncovered0"><a name="line472"></a> 472 else
|
|
1073
|
-
</span><span class="uncovered1"><a name="line473"></a> 473 @name = nil
|
|
1074
|
-
</span><span class="uncovered0"><a name="line474"></a> 474 end
|
|
1075
|
-
</span><span class="uncovered1"><a name="line475"></a> 475 @buf = buf
|
|
1076
|
-
</span><span class="uncovered0"><a name="line476"></a> 476 end
|
|
1077
|
-
</span><span class="inferred1"><a name="line477"></a> 477
|
|
1078
|
-
</span><span class="inferred0"><a name="line478"></a> 478 # The name of the unknown thing.
|
|
1079
|
-
</span><span class="inferred1"><a name="line479"></a> 479 #
|
|
1080
|
-
</span><span class="inferred0"><a name="line480"></a> 480 # Class name for unknown objects; variable name for unknown
|
|
1081
|
-
</span><span class="inferred1"><a name="line481"></a> 481 # constants.
|
|
1082
|
-
</span><span class="marked0"><a name="line482"></a> 482 attr_reader :name
|
|
1083
|
-
</span><span class="inferred1"><a name="line483"></a> 483
|
|
1084
|
-
</span><span class="inferred0"><a name="line484"></a> 484 # Buffer contained the marshalled, unknown object.
|
|
1085
|
-
</span><span class="marked1"><a name="line485"></a> 485 attr_reader :buf
|
|
1086
|
-
</span><span class="inferred0"><a name="line486"></a> 486
|
|
1087
|
-
</span><span class="marked1"><a name="line487"></a> 487 def self._load(s) # :nodoc:
|
|
1088
|
-
</span><span class="uncovered0"><a name="line488"></a> 488 begin
|
|
1089
|
-
</span><span class="uncovered1"><a name="line489"></a> 489 Marshal::load(s)
|
|
1090
|
-
</span><span class="uncovered0"><a name="line490"></a> 490 rescue NameError, ArgumentError
|
|
1091
|
-
</span><span class="uncovered1"><a name="line491"></a> 491 DRbUnknown.new($!, s)
|
|
1092
|
-
</span><span class="uncovered0"><a name="line492"></a> 492 end
|
|
1093
|
-
</span><span class="uncovered1"><a name="line493"></a> 493 end
|
|
1094
|
-
</span><span class="inferred0"><a name="line494"></a> 494
|
|
1095
|
-
</span><span class="marked1"><a name="line495"></a> 495 def _dump(lv) # :nodoc:
|
|
1096
|
-
</span><span class="uncovered0"><a name="line496"></a> 496 @buf
|
|
1097
|
-
</span><span class="uncovered1"><a name="line497"></a> 497 end
|
|
1098
|
-
</span><span class="inferred0"><a name="line498"></a> 498
|
|
1099
|
-
</span><span class="inferred1"><a name="line499"></a> 499 # Attempt to load the wrapped marshalled object again.
|
|
1100
|
-
</span><span class="inferred0"><a name="line500"></a> 500 #
|
|
1101
|
-
</span><span class="inferred1"><a name="line501"></a> 501 # If the class of the object is now known locally, the object
|
|
1102
|
-
</span><span class="inferred0"><a name="line502"></a> 502 # will be unmarshalled and returned. Otherwise, a new
|
|
1103
|
-
</span><span class="inferred1"><a name="line503"></a> 503 # but identical DRbUnknown object will be returned.
|
|
1104
|
-
</span><span class="marked0"><a name="line504"></a> 504 def reload
|
|
1105
|
-
</span><span class="uncovered1"><a name="line505"></a> 505 self.class._load(@buf)
|
|
1106
|
-
</span><span class="uncovered0"><a name="line506"></a> 506 end
|
|
1107
|
-
</span><span class="inferred1"><a name="line507"></a> 507
|
|
1108
|
-
</span><span class="inferred0"><a name="line508"></a> 508 # Create a DRbUnknownError exception containing this object.
|
|
1109
|
-
</span><span class="marked1"><a name="line509"></a> 509 def exception
|
|
1110
|
-
</span><span class="uncovered0"><a name="line510"></a> 510 DRbUnknownError.new(self)
|
|
1111
|
-
</span><span class="uncovered1"><a name="line511"></a> 511 end
|
|
1112
|
-
</span><span class="uncovered0"><a name="line512"></a> 512 end
|
|
1113
|
-
</span><span class="inferred1"><a name="line513"></a> 513
|
|
1114
|
-
</span><span class="marked0"><a name="line514"></a> 514 class DRbArray
|
|
1115
|
-
</span><span class="marked1"><a name="line515"></a> 515 def initialize(ary)
|
|
1116
|
-
</span><span class="uncovered0"><a name="line516"></a> 516 @ary = ary.collect { |obj|
|
|
1117
|
-
</span><span class="uncovered1"><a name="line517"></a> 517 if obj.kind_of? DRbUndumped
|
|
1118
|
-
</span><span class="uncovered0"><a name="line518"></a> 518 DRbObject.new(obj)
|
|
1119
|
-
</span><span class="uncovered1"><a name="line519"></a> 519 else
|
|
1120
|
-
</span><span class="uncovered0"><a name="line520"></a> 520 begin
|
|
1121
|
-
</span><span class="uncovered1"><a name="line521"></a> 521 Marshal.dump(obj)
|
|
1122
|
-
</span><span class="uncovered0"><a name="line522"></a> 522 obj
|
|
1123
|
-
</span><span class="uncovered1"><a name="line523"></a> 523 rescue
|
|
1124
|
-
</span><span class="uncovered0"><a name="line524"></a> 524 DRbObject.new(obj)
|
|
1125
|
-
</span><span class="uncovered1"><a name="line525"></a> 525 end
|
|
1126
|
-
</span><span class="uncovered0"><a name="line526"></a> 526 end
|
|
1127
|
-
</span><span class="uncovered1"><a name="line527"></a> 527 }
|
|
1128
|
-
</span><span class="uncovered0"><a name="line528"></a> 528 end
|
|
1129
|
-
</span><span class="inferred1"><a name="line529"></a> 529
|
|
1130
|
-
</span><span class="marked0"><a name="line530"></a> 530 def self._load(s)
|
|
1131
|
-
</span><span class="uncovered1"><a name="line531"></a> 531 Marshal::load(s)
|
|
1132
|
-
</span><span class="uncovered0"><a name="line532"></a> 532 end
|
|
1133
|
-
</span><span class="inferred1"><a name="line533"></a> 533
|
|
1134
|
-
</span><span class="marked0"><a name="line534"></a> 534 def _dump(lv)
|
|
1135
|
-
</span><span class="uncovered1"><a name="line535"></a> 535 Marshal.dump(@ary)
|
|
1136
|
-
</span><span class="uncovered0"><a name="line536"></a> 536 end
|
|
1137
|
-
</span><span class="uncovered1"><a name="line537"></a> 537 end
|
|
1138
|
-
</span><span class="inferred0"><a name="line538"></a> 538
|
|
1139
|
-
</span><span class="inferred1"><a name="line539"></a> 539 # Handler for sending and receiving drb messages.
|
|
1140
|
-
</span><span class="inferred0"><a name="line540"></a> 540 #
|
|
1141
|
-
</span><span class="inferred1"><a name="line541"></a> 541 # This takes care of the low-level marshalling and unmarshalling
|
|
1142
|
-
</span><span class="inferred0"><a name="line542"></a> 542 # of drb requests and responses sent over the wire between server
|
|
1143
|
-
</span><span class="inferred1"><a name="line543"></a> 543 # and client. This relieves the implementor of a new drb
|
|
1144
|
-
</span><span class="inferred0"><a name="line544"></a> 544 # protocol layer with having to deal with these details.
|
|
1145
|
-
</span><span class="inferred1"><a name="line545"></a> 545 #
|
|
1146
|
-
</span><span class="inferred0"><a name="line546"></a> 546 # The user does not have to directly deal with this object in
|
|
1147
|
-
</span><span class="inferred1"><a name="line547"></a> 547 # normal use.
|
|
1148
|
-
</span><span class="marked0"><a name="line548"></a> 548 class DRbMessage
|
|
1149
|
-
</span><span class="marked1"><a name="line549"></a> 549 def initialize(config) # :nodoc:
|
|
1150
|
-
</span><span class="uncovered0"><a name="line550"></a> 550 @load_limit = config[:load_limit]
|
|
1151
|
-
</span><span class="uncovered1"><a name="line551"></a> 551 @argc_limit = config[:argc_limit]
|
|
1152
|
-
</span><span class="uncovered0"><a name="line552"></a> 552 end
|
|
1153
|
-
</span><span class="inferred1"><a name="line553"></a> 553
|
|
1154
|
-
</span><span class="marked0"><a name="line554"></a> 554 def dump(obj, error=false) # :nodoc:
|
|
1155
|
-
</span><span class="uncovered1"><a name="line555"></a> 555 obj = make_proxy(obj, error) if obj.kind_of? DRbUndumped
|
|
1156
|
-
</span><span class="uncovered0"><a name="line556"></a> 556 begin
|
|
1157
|
-
</span><span class="uncovered1"><a name="line557"></a> 557 str = Marshal::dump(obj)
|
|
1158
|
-
</span><span class="uncovered0"><a name="line558"></a> 558 rescue
|
|
1159
|
-
</span><span class="uncovered1"><a name="line559"></a> 559 str = Marshal::dump(make_proxy(obj, error))
|
|
1160
|
-
</span><span class="uncovered0"><a name="line560"></a> 560 end
|
|
1161
|
-
</span><span class="uncovered1"><a name="line561"></a> 561 [str.size].pack('N') + str
|
|
1162
|
-
</span><span class="uncovered0"><a name="line562"></a> 562 end
|
|
1163
|
-
</span><span class="inferred1"><a name="line563"></a> 563
|
|
1164
|
-
</span><span class="marked0"><a name="line564"></a> 564 def load(soc) # :nodoc:
|
|
1165
|
-
</span><span class="uncovered1"><a name="line565"></a> 565 begin
|
|
1166
|
-
</span><span class="uncovered0"><a name="line566"></a> 566 sz = soc.read(4) # sizeof (N)
|
|
1167
|
-
</span><span class="uncovered1"><a name="line567"></a> 567 rescue
|
|
1168
|
-
</span><span class="uncovered0"><a name="line568"></a> 568 raise(DRbConnError, $!.message, $!.backtrace)
|
|
1169
|
-
</span><span class="uncovered1"><a name="line569"></a> 569 end
|
|
1170
|
-
</span><span class="uncovered0"><a name="line570"></a> 570 raise(DRbConnError, 'connection closed') if sz.nil?
|
|
1171
|
-
</span><span class="uncovered1"><a name="line571"></a> 571 raise(DRbConnError, 'premature header') if sz.size < 4
|
|
1172
|
-
</span><span class="uncovered0"><a name="line572"></a> 572 sz = sz.unpack('N')[0]
|
|
1173
|
-
</span><span class="uncovered1"><a name="line573"></a> 573 raise(DRbConnError, "too large packet #{sz}") if @load_limit < sz
|
|
1174
|
-
</span><span class="uncovered0"><a name="line574"></a> 574 begin
|
|
1175
|
-
</span><span class="uncovered1"><a name="line575"></a> 575 str = soc.read(sz)
|
|
1176
|
-
</span><span class="uncovered0"><a name="line576"></a> 576 rescue
|
|
1177
|
-
</span><span class="uncovered1"><a name="line577"></a> 577 raise(DRbConnError, $!.message, $!.backtrace)
|
|
1178
|
-
</span><span class="uncovered0"><a name="line578"></a> 578 end
|
|
1179
|
-
</span><span class="uncovered1"><a name="line579"></a> 579 raise(DRbConnError, 'connection closed') if str.nil?
|
|
1180
|
-
</span><span class="uncovered0"><a name="line580"></a> 580 raise(DRbConnError, 'premature marshal format(can\'t read)') if str.size < sz
|
|
1181
|
-
</span><span class="uncovered1"><a name="line581"></a> 581 Thread.exclusive do
|
|
1182
|
-
</span><span class="uncovered0"><a name="line582"></a> 582 begin
|
|
1183
|
-
</span><span class="uncovered1"><a name="line583"></a> 583 save = Thread.current[:drb_untaint]
|
|
1184
|
-
</span><span class="uncovered0"><a name="line584"></a> 584 Thread.current[:drb_untaint] = []
|
|
1185
|
-
</span><span class="uncovered1"><a name="line585"></a> 585 Marshal::load(str)
|
|
1186
|
-
</span><span class="uncovered0"><a name="line586"></a> 586 rescue NameError, ArgumentError
|
|
1187
|
-
</span><span class="uncovered1"><a name="line587"></a> 587 DRbUnknown.new($!, str)
|
|
1188
|
-
</span><span class="uncovered0"><a name="line588"></a> 588 ensure
|
|
1189
|
-
</span><span class="uncovered1"><a name="line589"></a> 589 Thread.current[:drb_untaint].each do |x|
|
|
1190
|
-
</span><span class="uncovered0"><a name="line590"></a> 590 x.untaint
|
|
1191
|
-
</span><span class="uncovered1"><a name="line591"></a> 591 end
|
|
1192
|
-
</span><span class="uncovered0"><a name="line592"></a> 592 Thread.current[:drb_untaint] = save
|
|
1193
|
-
</span><span class="uncovered1"><a name="line593"></a> 593 end
|
|
1194
|
-
</span><span class="uncovered0"><a name="line594"></a> 594 end
|
|
1195
|
-
</span><span class="uncovered1"><a name="line595"></a> 595 end
|
|
1196
|
-
</span><span class="inferred0"><a name="line596"></a> 596
|
|
1197
|
-
</span><span class="marked1"><a name="line597"></a> 597 def send_request(stream, ref, msg_id, arg, b) # :nodoc:
|
|
1198
|
-
</span><span class="uncovered0"><a name="line598"></a> 598 ary = []
|
|
1199
|
-
</span><span class="uncovered1"><a name="line599"></a> 599 ary.push(dump(ref.__drbref))
|
|
1200
|
-
</span><span class="uncovered0"><a name="line600"></a> 600 ary.push(dump(msg_id.id2name))
|
|
1201
|
-
</span><span class="uncovered1"><a name="line601"></a> 601 ary.push(dump(arg.length))
|
|
1202
|
-
</span><span class="uncovered0"><a name="line602"></a> 602 arg.each do |e|
|
|
1203
|
-
</span><span class="uncovered1"><a name="line603"></a> 603 ary.push(dump(e))
|
|
1204
|
-
</span><span class="uncovered0"><a name="line604"></a> 604 end
|
|
1205
|
-
</span><span class="uncovered1"><a name="line605"></a> 605 ary.push(dump(b))
|
|
1206
|
-
</span><span class="uncovered0"><a name="line606"></a> 606 stream.write(ary.join(''))
|
|
1207
|
-
</span><span class="uncovered1"><a name="line607"></a> 607 rescue
|
|
1208
|
-
</span><span class="uncovered0"><a name="line608"></a> 608 raise(DRbConnError, $!.message, $!.backtrace)
|
|
1209
|
-
</span><span class="uncovered1"><a name="line609"></a> 609 end
|
|
1210
|
-
</span><span class="inferred0"><a name="line610"></a> 610
|
|
1211
|
-
</span><span class="marked1"><a name="line611"></a> 611 def recv_request(stream) # :nodoc:
|
|
1212
|
-
</span><span class="uncovered0"><a name="line612"></a> 612 ref = load(stream)
|
|
1213
|
-
</span><span class="uncovered1"><a name="line613"></a> 613 ro = DRb.to_obj(ref)
|
|
1214
|
-
</span><span class="uncovered0"><a name="line614"></a> 614 msg = load(stream)
|
|
1215
|
-
</span><span class="uncovered1"><a name="line615"></a> 615 argc = load(stream)
|
|
1216
|
-
</span><span class="uncovered0"><a name="line616"></a> 616 raise ArgumentError, 'too many arguments' if @argc_limit < argc
|
|
1217
|
-
</span><span class="uncovered1"><a name="line617"></a> 617 argv = Array.new(argc, nil)
|
|
1218
|
-
</span><span class="uncovered0"><a name="line618"></a> 618 argc.times do |n|
|
|
1219
|
-
</span><span class="uncovered1"><a name="line619"></a> 619 argv[n] = load(stream)
|
|
1220
|
-
</span><span class="uncovered0"><a name="line620"></a> 620 end
|
|
1221
|
-
</span><span class="uncovered1"><a name="line621"></a> 621 block = load(stream)
|
|
1222
|
-
</span><span class="uncovered0"><a name="line622"></a> 622 return ro, msg, argv, block
|
|
1223
|
-
</span><span class="uncovered1"><a name="line623"></a> 623 end
|
|
1224
|
-
</span><span class="inferred0"><a name="line624"></a> 624
|
|
1225
|
-
</span><span class="marked1"><a name="line625"></a> 625 def send_reply(stream, succ, result) # :nodoc:
|
|
1226
|
-
</span><span class="uncovered0"><a name="line626"></a> 626 stream.write(dump(succ) + dump(result, !succ))
|
|
1227
|
-
</span><span class="uncovered1"><a name="line627"></a> 627 rescue
|
|
1228
|
-
</span><span class="uncovered0"><a name="line628"></a> 628 raise(DRbConnError, $!.message, $!.backtrace)
|
|
1229
|
-
</span><span class="uncovered1"><a name="line629"></a> 629 end
|
|
1230
|
-
</span><span class="inferred0"><a name="line630"></a> 630
|
|
1231
|
-
</span><span class="marked1"><a name="line631"></a> 631 def recv_reply(stream) # :nodoc:
|
|
1232
|
-
</span><span class="uncovered0"><a name="line632"></a> 632 succ = load(stream)
|
|
1233
|
-
</span><span class="uncovered1"><a name="line633"></a> 633 result = load(stream)
|
|
1234
|
-
</span><span class="uncovered0"><a name="line634"></a> 634 [succ, result]
|
|
1235
|
-
</span><span class="uncovered1"><a name="line635"></a> 635 end
|
|
1236
|
-
</span><span class="inferred0"><a name="line636"></a> 636
|
|
1237
|
-
</span><span class="marked1"><a name="line637"></a> 637 private
|
|
1238
|
-
</span><span class="marked0"><a name="line638"></a> 638 def make_proxy(obj, error=false)
|
|
1239
|
-
</span><span class="uncovered1"><a name="line639"></a> 639 if error
|
|
1240
|
-
</span><span class="uncovered0"><a name="line640"></a> 640 DRbRemoteError.new(obj)
|
|
1241
|
-
</span><span class="uncovered1"><a name="line641"></a> 641 else
|
|
1242
|
-
</span><span class="uncovered0"><a name="line642"></a> 642 DRbObject.new(obj)
|
|
1243
|
-
</span><span class="uncovered1"><a name="line643"></a> 643 end
|
|
1244
|
-
</span><span class="uncovered0"><a name="line644"></a> 644 end
|
|
1245
|
-
</span><span class="uncovered1"><a name="line645"></a> 645 end
|
|
1246
|
-
</span><span class="inferred0"><a name="line646"></a> 646
|
|
1247
|
-
</span><span class="inferred1"><a name="line647"></a> 647 # Module managing the underlying network protocol(s) used by drb.
|
|
1248
|
-
</span><span class="inferred0"><a name="line648"></a> 648 #
|
|
1249
|
-
</span><span class="inferred1"><a name="line649"></a> 649 # By default, drb uses the DRbTCPSocket protocol. Other protocols
|
|
1250
|
-
</span><span class="inferred0"><a name="line650"></a> 650 # can be defined. A protocol must define the following class methods:
|
|
1251
|
-
</span><span class="inferred1"><a name="line651"></a> 651 #
|
|
1252
|
-
</span><span class="inferred0"><a name="line652"></a> 652 # [open(uri, config)] Open a client connection to the server at +uri+,
|
|
1253
|
-
</span><span class="inferred1"><a name="line653"></a> 653 # using configuration +config+. Return a protocol
|
|
1254
|
-
</span><span class="inferred0"><a name="line654"></a> 654 # instance for this connection.
|
|
1255
|
-
</span><span class="inferred1"><a name="line655"></a> 655 # [open_server(uri, config)] Open a server listening at +uri+,
|
|
1256
|
-
</span><span class="inferred0"><a name="line656"></a> 656 # using configuration +config+. Return a
|
|
1257
|
-
</span><span class="inferred1"><a name="line657"></a> 657 # protocol instance for this listener.
|
|
1258
|
-
</span><span class="inferred0"><a name="line658"></a> 658 # [uri_option(uri, config)] Take a URI, possibly containing an option
|
|
1259
|
-
</span><span class="inferred1"><a name="line659"></a> 659 # component (e.g. a trailing '?param=val'),
|
|
1260
|
-
</span><span class="inferred0"><a name="line660"></a> 660 # and return a [uri, option] tuple.
|
|
1261
|
-
</span><span class="inferred1"><a name="line661"></a> 661 #
|
|
1262
|
-
</span><span class="inferred0"><a name="line662"></a> 662 # All of these methods should raise a DRbBadScheme error if the URI
|
|
1263
|
-
</span><span class="inferred1"><a name="line663"></a> 663 # does not identify the protocol they support (e.g. "druby:" for
|
|
1264
|
-
</span><span class="inferred0"><a name="line664"></a> 664 # the standard Ruby protocol). This is how the DRbProtocol module,
|
|
1265
|
-
</span><span class="inferred1"><a name="line665"></a> 665 # given a URI, determines which protocol implementation serves that
|
|
1266
|
-
</span><span class="inferred0"><a name="line666"></a> 666 # protocol.
|
|
1267
|
-
</span><span class="inferred1"><a name="line667"></a> 667 #
|
|
1268
|
-
</span><span class="inferred0"><a name="line668"></a> 668 # The protocol instance returned by #open_server must have the
|
|
1269
|
-
</span><span class="inferred1"><a name="line669"></a> 669 # following methods:
|
|
1270
|
-
</span><span class="inferred0"><a name="line670"></a> 670 #
|
|
1271
|
-
</span><span class="inferred1"><a name="line671"></a> 671 # [accept] Accept a new connection to the server. Returns a protocol
|
|
1272
|
-
</span><span class="inferred0"><a name="line672"></a> 672 # instance capable of communicating with the client.
|
|
1273
|
-
</span><span class="inferred1"><a name="line673"></a> 673 # [close] Close the server connection.
|
|
1274
|
-
</span><span class="inferred0"><a name="line674"></a> 674 # [uri] Get the URI for this server.
|
|
1275
|
-
</span><span class="inferred1"><a name="line675"></a> 675 #
|
|
1276
|
-
</span><span class="inferred0"><a name="line676"></a> 676 # The protocol instance returned by #open must have the following methods:
|
|
1277
|
-
</span><span class="inferred1"><a name="line677"></a> 677 #
|
|
1278
|
-
</span><span class="inferred0"><a name="line678"></a> 678 # [send_request (ref, msg_id, arg, b)]
|
|
1279
|
-
</span><span class="inferred1"><a name="line679"></a> 679 # Send a request to +ref+ with the given message id and arguments.
|
|
1280
|
-
</span><span class="inferred0"><a name="line680"></a> 680 # This is most easily implemented by calling DRbMessage.send_request,
|
|
1281
|
-
</span><span class="inferred1"><a name="line681"></a> 681 # providing a stream that sits on top of the current protocol.
|
|
1282
|
-
</span><span class="inferred0"><a name="line682"></a> 682 # [recv_reply]
|
|
1283
|
-
</span><span class="inferred1"><a name="line683"></a> 683 # Receive a reply from the server and return it as a [success-boolean,
|
|
1284
|
-
</span><span class="inferred0"><a name="line684"></a> 684 # reply-value] pair. This is most easily implemented by calling
|
|
1285
|
-
</span><span class="inferred1"><a name="line685"></a> 685 # DRb.recv_reply, providing a stream that sits on top of the
|
|
1286
|
-
</span><span class="inferred0"><a name="line686"></a> 686 # current protocol.
|
|
1287
|
-
</span><span class="inferred1"><a name="line687"></a> 687 # [alive?]
|
|
1288
|
-
</span><span class="inferred0"><a name="line688"></a> 688 # Is this connection still alive?
|
|
1289
|
-
</span><span class="inferred1"><a name="line689"></a> 689 # [close]
|
|
1290
|
-
</span><span class="inferred0"><a name="line690"></a> 690 # Close this connection.
|
|
1291
|
-
</span><span class="inferred1"><a name="line691"></a> 691 #
|
|
1292
|
-
</span><span class="inferred0"><a name="line692"></a> 692 # The protocol instance returned by #open_server().accept() must have
|
|
1293
|
-
</span><span class="inferred1"><a name="line693"></a> 693 # the following methods:
|
|
1294
|
-
</span><span class="inferred0"><a name="line694"></a> 694 #
|
|
1295
|
-
</span><span class="inferred1"><a name="line695"></a> 695 # [recv_request]
|
|
1296
|
-
</span><span class="inferred0"><a name="line696"></a> 696 # Receive a request from the client and return a [object, message,
|
|
1297
|
-
</span><span class="inferred1"><a name="line697"></a> 697 # args, block] tuple. This is most easily implemented by calling
|
|
1298
|
-
</span><span class="inferred0"><a name="line698"></a> 698 # DRbMessage.recv_request, providing a stream that sits on top of
|
|
1299
|
-
</span><span class="inferred1"><a name="line699"></a> 699 # the current protocol.
|
|
1300
|
-
</span><span class="inferred0"><a name="line700"></a> 700 # [send_reply(succ, result)]
|
|
1301
|
-
</span><span class="inferred1"><a name="line701"></a> 701 # Send a reply to the client. This is most easily implemented
|
|
1302
|
-
</span><span class="inferred0"><a name="line702"></a> 702 # by calling DRbMessage.send_reply, providing a stream that sits
|
|
1303
|
-
</span><span class="inferred1"><a name="line703"></a> 703 # on top of the current protocol.
|
|
1304
|
-
</span><span class="inferred0"><a name="line704"></a> 704 # [close]
|
|
1305
|
-
</span><span class="inferred1"><a name="line705"></a> 705 # Close this connection.
|
|
1306
|
-
</span><span class="inferred0"><a name="line706"></a> 706 #
|
|
1307
|
-
</span><span class="inferred1"><a name="line707"></a> 707 # A new protocol is registered with the DRbProtocol module using
|
|
1308
|
-
</span><span class="inferred0"><a name="line708"></a> 708 # the add_protocol method.
|
|
1309
|
-
</span><span class="inferred1"><a name="line709"></a> 709 #
|
|
1310
|
-
</span><span class="inferred0"><a name="line710"></a> 710 # For examples of other protocols, see DRbUNIXSocket in drb/unix.rb,
|
|
1311
|
-
</span><span class="inferred1"><a name="line711"></a> 711 # and HTTP0 in sample/http0.rb and sample/http0serv.rb in the full
|
|
1312
|
-
</span><span class="inferred0"><a name="line712"></a> 712 # drb distribution.
|
|
1313
|
-
</span><span class="marked1"><a name="line713"></a> 713 module DRbProtocol
|
|
1314
|
-
</span><span class="inferred0"><a name="line714"></a> 714
|
|
1315
|
-
</span><span class="inferred1"><a name="line715"></a> 715 # Add a new protocol to the DRbProtocol module.
|
|
1316
|
-
</span><span class="marked0"><a name="line716"></a> 716 def add_protocol(prot)
|
|
1317
|
-
</span><span class="uncovered1"><a name="line717"></a> 717 @protocol.push(prot)
|
|
1318
|
-
</span><span class="uncovered0"><a name="line718"></a> 718 end
|
|
1319
|
-
</span><span class="marked1"><a name="line719"></a> 719 module_function :add_protocol
|
|
1320
|
-
</span><span class="inferred0"><a name="line720"></a> 720
|
|
1321
|
-
</span><span class="inferred1"><a name="line721"></a> 721 # Open a client connection to +uri+ with the configuration +config+.
|
|
1322
|
-
</span><span class="inferred0"><a name="line722"></a> 722 #
|
|
1323
|
-
</span><span class="inferred1"><a name="line723"></a> 723 # The DRbProtocol module asks each registered protocol in turn to
|
|
1324
|
-
</span><span class="inferred0"><a name="line724"></a> 724 # try to open the URI. Each protocol signals that it does not handle that
|
|
1325
|
-
</span><span class="inferred1"><a name="line725"></a> 725 # URI by raising a DRbBadScheme error. If no protocol recognises the
|
|
1326
|
-
</span><span class="inferred0"><a name="line726"></a> 726 # URI, then a DRbBadURI error is raised. If a protocol accepts the
|
|
1327
|
-
</span><span class="inferred1"><a name="line727"></a> 727 # URI, but an error occurs in opening it, a DRbConnError is raised.
|
|
1328
|
-
</span><span class="marked0"><a name="line728"></a> 728 def open(uri, config, first=true)
|
|
1329
|
-
</span><span class="uncovered1"><a name="line729"></a> 729 @protocol.each do |prot|
|
|
1330
|
-
</span><span class="uncovered0"><a name="line730"></a> 730 begin
|
|
1331
|
-
</span><span class="uncovered1"><a name="line731"></a> 731 return prot.open(uri, config)
|
|
1332
|
-
</span><span class="uncovered0"><a name="line732"></a> 732 rescue DRbBadScheme
|
|
1333
|
-
</span><span class="uncovered1"><a name="line733"></a> 733 rescue DRbConnError
|
|
1334
|
-
</span><span class="uncovered0"><a name="line734"></a> 734 raise($!)
|
|
1335
|
-
</span><span class="uncovered1"><a name="line735"></a> 735 rescue
|
|
1336
|
-
</span><span class="uncovered0"><a name="line736"></a> 736 raise(DRbConnError, "#{uri} - #{$!.inspect}")
|
|
1337
|
-
</span><span class="uncovered1"><a name="line737"></a> 737 end
|
|
1338
|
-
</span><span class="uncovered0"><a name="line738"></a> 738 end
|
|
1339
|
-
</span><span class="uncovered1"><a name="line739"></a> 739 if first && (config[:auto_load] != false)
|
|
1340
|
-
</span><span class="uncovered0"><a name="line740"></a> 740 auto_load(uri, config)
|
|
1341
|
-
</span><span class="uncovered1"><a name="line741"></a> 741 return open(uri, config, false)
|
|
1342
|
-
</span><span class="uncovered0"><a name="line742"></a> 742 end
|
|
1343
|
-
</span><span class="uncovered1"><a name="line743"></a> 743 raise DRbBadURI, 'can\'t parse uri:' + uri
|
|
1344
|
-
</span><span class="uncovered0"><a name="line744"></a> 744 end
|
|
1345
|
-
</span><span class="marked1"><a name="line745"></a> 745 module_function :open
|
|
1346
|
-
</span><span class="inferred0"><a name="line746"></a> 746
|
|
1347
|
-
</span><span class="inferred1"><a name="line747"></a> 747 # Open a server listening for connections at +uri+ with
|
|
1348
|
-
</span><span class="inferred0"><a name="line748"></a> 748 # configuration +config+.
|
|
1349
|
-
</span><span class="inferred1"><a name="line749"></a> 749 #
|
|
1350
|
-
</span><span class="inferred0"><a name="line750"></a> 750 # The DRbProtocol module asks each registered protocol in turn to
|
|
1351
|
-
</span><span class="inferred1"><a name="line751"></a> 751 # try to open a server at the URI. Each protocol signals that it does
|
|
1352
|
-
</span><span class="inferred0"><a name="line752"></a> 752 # not handle that URI by raising a DRbBadScheme error. If no protocol
|
|
1353
|
-
</span><span class="inferred1"><a name="line753"></a> 753 # recognises the URI, then a DRbBadURI error is raised. If a protocol
|
|
1354
|
-
</span><span class="inferred0"><a name="line754"></a> 754 # accepts the URI, but an error occurs in opening it, the underlying
|
|
1355
|
-
</span><span class="inferred1"><a name="line755"></a> 755 # error is passed on to the caller.
|
|
1356
|
-
</span><span class="marked0"><a name="line756"></a> 756 def open_server(uri, config, first=true)
|
|
1357
|
-
</span><span class="uncovered1"><a name="line757"></a> 757 @protocol.each do |prot|
|
|
1358
|
-
</span><span class="uncovered0"><a name="line758"></a> 758 begin
|
|
1359
|
-
</span><span class="uncovered1"><a name="line759"></a> 759 return prot.open_server(uri, config)
|
|
1360
|
-
</span><span class="uncovered0"><a name="line760"></a> 760 rescue DRbBadScheme
|
|
1361
|
-
</span><span class="uncovered1"><a name="line761"></a> 761 end
|
|
1362
|
-
</span><span class="uncovered0"><a name="line762"></a> 762 end
|
|
1363
|
-
</span><span class="uncovered1"><a name="line763"></a> 763 if first && (config[:auto_load] != false)
|
|
1364
|
-
</span><span class="uncovered0"><a name="line764"></a> 764 auto_load(uri, config)
|
|
1365
|
-
</span><span class="uncovered1"><a name="line765"></a> 765 return open_server(uri, config, false)
|
|
1366
|
-
</span><span class="uncovered0"><a name="line766"></a> 766 end
|
|
1367
|
-
</span><span class="uncovered1"><a name="line767"></a> 767 raise DRbBadURI, 'can\'t parse uri:' + uri
|
|
1368
|
-
</span><span class="uncovered0"><a name="line768"></a> 768 end
|
|
1369
|
-
</span><span class="marked1"><a name="line769"></a> 769 module_function :open_server
|
|
1370
|
-
</span><span class="inferred0"><a name="line770"></a> 770
|
|
1371
|
-
</span><span class="inferred1"><a name="line771"></a> 771 # Parse +uri+ into a [uri, option] pair.
|
|
1372
|
-
</span><span class="inferred0"><a name="line772"></a> 772 #
|
|
1373
|
-
</span><span class="inferred1"><a name="line773"></a> 773 # The DRbProtocol module asks each registered protocol in turn to
|
|
1374
|
-
</span><span class="inferred0"><a name="line774"></a> 774 # try to parse the URI. Each protocol signals that it does not handle that
|
|
1375
|
-
</span><span class="inferred1"><a name="line775"></a> 775 # URI by raising a DRbBadScheme error. If no protocol recognises the
|
|
1376
|
-
</span><span class="inferred0"><a name="line776"></a> 776 # URI, then a DRbBadURI error is raised.
|
|
1377
|
-
</span><span class="marked1"><a name="line777"></a> 777 def uri_option(uri, config, first=true)
|
|
1378
|
-
</span><span class="uncovered0"><a name="line778"></a> 778 @protocol.each do |prot|
|
|
1379
|
-
</span><span class="uncovered1"><a name="line779"></a> 779 begin
|
|
1380
|
-
</span><span class="uncovered0"><a name="line780"></a> 780 uri, opt = prot.uri_option(uri, config)
|
|
1381
|
-
</span><span class="uncovered1"><a name="line781"></a> 781 # opt = nil if opt == ''
|
|
1382
|
-
</span><span class="uncovered0"><a name="line782"></a> 782 return uri, opt
|
|
1383
|
-
</span><span class="uncovered1"><a name="line783"></a> 783 rescue DRbBadScheme
|
|
1384
|
-
</span><span class="uncovered0"><a name="line784"></a> 784 end
|
|
1385
|
-
</span><span class="uncovered1"><a name="line785"></a> 785 end
|
|
1386
|
-
</span><span class="uncovered0"><a name="line786"></a> 786 if first && (config[:auto_load] != false)
|
|
1387
|
-
</span><span class="uncovered1"><a name="line787"></a> 787 auto_load(uri, config)
|
|
1388
|
-
</span><span class="uncovered0"><a name="line788"></a> 788 return uri_option(uri, config, false)
|
|
1389
|
-
</span><span class="uncovered1"><a name="line789"></a> 789 end
|
|
1390
|
-
</span><span class="uncovered0"><a name="line790"></a> 790 raise DRbBadURI, 'can\'t parse uri:' + uri
|
|
1391
|
-
</span><span class="uncovered1"><a name="line791"></a> 791 end
|
|
1392
|
-
</span><span class="marked0"><a name="line792"></a> 792 module_function :uri_option
|
|
1393
|
-
</span><span class="inferred1"><a name="line793"></a> 793
|
|
1394
|
-
</span><span class="marked0"><a name="line794"></a> 794 def auto_load(uri, config) # :nodoc:
|
|
1395
|
-
</span><span class="uncovered1"><a name="line795"></a> 795 if uri =~ /^drb([a-z0-9]+):/
|
|
1396
|
-
</span><span class="uncovered0"><a name="line796"></a> 796 require("drb/#{$1}") rescue nil
|
|
1397
|
-
</span><span class="uncovered1"><a name="line797"></a> 797 end
|
|
1398
|
-
</span><span class="uncovered0"><a name="line798"></a> 798 end
|
|
1399
|
-
</span><span class="marked1"><a name="line799"></a> 799 module_function :auto_load
|
|
1400
|
-
</span><span class="inferred0"><a name="line800"></a> 800 end
|
|
1401
|
-
</span><span class="inferred1"><a name="line801"></a> 801
|
|
1402
|
-
</span><span class="inferred0"><a name="line802"></a> 802 # The default drb protocol.
|
|
1403
|
-
</span><span class="inferred1"><a name="line803"></a> 803 #
|
|
1404
|
-
</span><span class="inferred0"><a name="line804"></a> 804 # Communicates over a TCP socket.
|
|
1405
|
-
</span><span class="marked1"><a name="line805"></a> 805 class DRbTCPSocket
|
|
1406
|
-
</span><span class="marked0"><a name="line806"></a> 806 private
|
|
1407
|
-
</span><span class="marked1"><a name="line807"></a> 807 def self.parse_uri(uri)
|
|
1408
|
-
</span><span class="uncovered0"><a name="line808"></a> 808 if uri =~ /^druby:\/\/(.*?):(\d+)(\?(.*))?$/
|
|
1409
|
-
</span><span class="uncovered1"><a name="line809"></a> 809 host = $1
|
|
1410
|
-
</span><span class="uncovered0"><a name="line810"></a> 810 port = $2.to_i
|
|
1411
|
-
</span><span class="uncovered1"><a name="line811"></a> 811 option = $4
|
|
1412
|
-
</span><span class="uncovered0"><a name="line812"></a> 812 [host, port, option]
|
|
1413
|
-
</span><span class="uncovered1"><a name="line813"></a> 813 else
|
|
1414
|
-
</span><span class="uncovered0"><a name="line814"></a> 814 raise(DRbBadScheme, uri) unless uri =~ /^druby:/
|
|
1415
|
-
</span><span class="uncovered1"><a name="line815"></a> 815 raise(DRbBadURI, 'can\'t parse uri:' + uri)
|
|
1416
|
-
</span><span class="uncovered0"><a name="line816"></a> 816 end
|
|
1417
|
-
</span><span class="uncovered1"><a name="line817"></a> 817 end
|
|
1418
|
-
</span><span class="inferred0"><a name="line818"></a> 818
|
|
1419
|
-
</span><span class="marked1"><a name="line819"></a> 819 public
|
|
1420
|
-
</span><span class="inferred0"><a name="line820"></a> 820
|
|
1421
|
-
</span><span class="inferred1"><a name="line821"></a> 821 # Open a client connection to +uri+ using configuration +config+.
|
|
1422
|
-
</span><span class="marked0"><a name="line822"></a> 822 def self.open(uri, config)
|
|
1423
|
-
</span><span class="uncovered1"><a name="line823"></a> 823 host, port, option = parse_uri(uri)
|
|
1424
|
-
</span><span class="uncovered0"><a name="line824"></a> 824 host.untaint
|
|
1425
|
-
</span><span class="uncovered1"><a name="line825"></a> 825 port.untaint
|
|
1426
|
-
</span><span class="uncovered0"><a name="line826"></a> 826 soc = TCPSocket.open(host, port)
|
|
1427
|
-
</span><span class="uncovered1"><a name="line827"></a> 827 self.new(uri, soc, config)
|
|
1428
|
-
</span><span class="uncovered0"><a name="line828"></a> 828 end
|
|
1429
|
-
</span><span class="inferred1"><a name="line829"></a> 829
|
|
1430
|
-
</span><span class="marked0"><a name="line830"></a> 830 def self.getservername
|
|
1431
|
-
</span><span class="uncovered1"><a name="line831"></a> 831 host = Socket::gethostname
|
|
1432
|
-
</span><span class="uncovered0"><a name="line832"></a> 832 begin
|
|
1433
|
-
</span><span class="uncovered1"><a name="line833"></a> 833 Socket::gethostbyname(host)[0]
|
|
1434
|
-
</span><span class="uncovered0"><a name="line834"></a> 834 rescue
|
|
1435
|
-
</span><span class="uncovered1"><a name="line835"></a> 835 'localhost'
|
|
1436
|
-
</span><span class="uncovered0"><a name="line836"></a> 836 end
|
|
1437
|
-
</span><span class="uncovered1"><a name="line837"></a> 837 end
|
|
1438
|
-
</span><span class="inferred0"><a name="line838"></a> 838
|
|
1439
|
-
</span><span class="marked1"><a name="line839"></a> 839 def self.open_server_inaddr_any(host, port)
|
|
1440
|
-
</span><span class="uncovered0"><a name="line840"></a> 840 infos = Socket::getaddrinfo(host, nil,
|
|
1441
|
-
</span><span class="uncovered1"><a name="line841"></a> 841 Socket::AF_UNSPEC,
|
|
1442
|
-
</span><span class="uncovered0"><a name="line842"></a> 842 Socket::SOCK_STREAM,
|
|
1443
|
-
</span><span class="uncovered1"><a name="line843"></a> 843 0,
|
|
1444
|
-
</span><span class="uncovered0"><a name="line844"></a> 844 Socket::AI_PASSIVE)
|
|
1445
|
-
</span><span class="uncovered1"><a name="line845"></a> 845 family = infos.collect { |af, *_| af }.uniq
|
|
1446
|
-
</span><span class="uncovered0"><a name="line846"></a> 846 case family
|
|
1447
|
-
</span><span class="uncovered1"><a name="line847"></a> 847 when ['AF_INET']
|
|
1448
|
-
</span><span class="uncovered0"><a name="line848"></a> 848 return TCPServer.open('0.0.0.0', port)
|
|
1449
|
-
</span><span class="uncovered1"><a name="line849"></a> 849 when ['AF_INET6']
|
|
1450
|
-
</span><span class="uncovered0"><a name="line850"></a> 850 return TCPServer.open('::', port)
|
|
1451
|
-
</span><span class="uncovered1"><a name="line851"></a> 851 else
|
|
1452
|
-
</span><span class="uncovered0"><a name="line852"></a> 852 return TCPServer.open(port)
|
|
1453
|
-
</span><span class="uncovered1"><a name="line853"></a> 853 end
|
|
1454
|
-
</span><span class="uncovered0"><a name="line854"></a> 854 end
|
|
1455
|
-
</span><span class="inferred1"><a name="line855"></a> 855
|
|
1456
|
-
</span><span class="inferred0"><a name="line856"></a> 856 # Open a server listening for connections at +uri+ using
|
|
1457
|
-
</span><span class="inferred1"><a name="line857"></a> 857 # configuration +config+.
|
|
1458
|
-
</span><span class="marked0"><a name="line858"></a> 858 def self.open_server(uri, config)
|
|
1459
|
-
</span><span class="uncovered1"><a name="line859"></a> 859 uri = 'druby://:0' unless uri
|
|
1460
|
-
</span><span class="uncovered0"><a name="line860"></a> 860 host, port, opt = parse_uri(uri)
|
|
1461
|
-
</span><span class="uncovered1"><a name="line861"></a> 861 if host.size == 0
|
|
1462
|
-
</span><span class="uncovered0"><a name="line862"></a> 862 host = getservername
|
|
1463
|
-
</span><span class="uncovered1"><a name="line863"></a> 863 soc = open_server_inaddr_any(host, port)
|
|
1464
|
-
</span><span class="uncovered0"><a name="line864"></a> 864 else
|
|
1465
|
-
</span><span class="uncovered1"><a name="line865"></a> 865 soc = TCPServer.open(host, port)
|
|
1466
|
-
</span><span class="uncovered0"><a name="line866"></a> 866 end
|
|
1467
|
-
</span><span class="uncovered1"><a name="line867"></a> 867 port = soc.addr[1] if port == 0
|
|
1468
|
-
</span><span class="uncovered0"><a name="line868"></a> 868 uri = "druby://#{host}:#{port}"
|
|
1469
|
-
</span><span class="uncovered1"><a name="line869"></a> 869 self.new(uri, soc, config)
|
|
1470
|
-
</span><span class="uncovered0"><a name="line870"></a> 870 end
|
|
1471
|
-
</span><span class="inferred1"><a name="line871"></a> 871
|
|
1472
|
-
</span><span class="inferred0"><a name="line872"></a> 872 # Parse +uri+ into a [uri, option] pair.
|
|
1473
|
-
</span><span class="marked1"><a name="line873"></a> 873 def self.uri_option(uri, config)
|
|
1474
|
-
</span><span class="uncovered0"><a name="line874"></a> 874 host, port, option = parse_uri(uri)
|
|
1475
|
-
</span><span class="uncovered1"><a name="line875"></a> 875 return "druby://#{host}:#{port}", option
|
|
1476
|
-
</span><span class="uncovered0"><a name="line876"></a> 876 end
|
|
1477
|
-
</span><span class="inferred1"><a name="line877"></a> 877
|
|
1478
|
-
</span><span class="inferred0"><a name="line878"></a> 878 # Create a new DRbTCPSocket instance.
|
|
1479
|
-
</span><span class="inferred1"><a name="line879"></a> 879 #
|
|
1480
|
-
</span><span class="inferred0"><a name="line880"></a> 880 # +uri+ is the URI we are connected to.
|
|
1481
|
-
</span><span class="inferred1"><a name="line881"></a> 881 # +soc+ is the tcp socket we are bound to. +config+ is our
|
|
1482
|
-
</span><span class="inferred0"><a name="line882"></a> 882 # configuration.
|
|
1483
|
-
</span><span class="marked1"><a name="line883"></a> 883 def initialize(uri, soc, config={})
|
|
1484
|
-
</span><span class="uncovered0"><a name="line884"></a> 884 @uri = uri
|
|
1485
|
-
</span><span class="uncovered1"><a name="line885"></a> 885 @socket = soc
|
|
1486
|
-
</span><span class="uncovered0"><a name="line886"></a> 886 @config = config
|
|
1487
|
-
</span><span class="uncovered1"><a name="line887"></a> 887 @acl = config[:tcp_acl]
|
|
1488
|
-
</span><span class="uncovered0"><a name="line888"></a> 888 @msg = DRbMessage.new(config)
|
|
1489
|
-
</span><span class="uncovered1"><a name="line889"></a> 889 set_sockopt(@socket)
|
|
1490
|
-
</span><span class="uncovered0"><a name="line890"></a> 890 end
|
|
1491
|
-
</span><span class="inferred1"><a name="line891"></a> 891
|
|
1492
|
-
</span><span class="inferred0"><a name="line892"></a> 892 # Get the URI that we are connected to.
|
|
1493
|
-
</span><span class="marked1"><a name="line893"></a> 893 attr_reader :uri
|
|
1494
|
-
</span><span class="inferred0"><a name="line894"></a> 894
|
|
1495
|
-
</span><span class="inferred1"><a name="line895"></a> 895 # Get the address of our TCP peer (the other end of the socket
|
|
1496
|
-
</span><span class="inferred0"><a name="line896"></a> 896 # we are bound to.
|
|
1497
|
-
</span><span class="marked1"><a name="line897"></a> 897 def peeraddr
|
|
1498
|
-
</span><span class="uncovered0"><a name="line898"></a> 898 @socket.peeraddr
|
|
1499
|
-
</span><span class="uncovered1"><a name="line899"></a> 899 end
|
|
1500
|
-
</span><span class="inferred0"><a name="line900"></a> 900
|
|
1501
|
-
</span><span class="inferred1"><a name="line901"></a> 901 # Get the socket.
|
|
1502
|
-
</span><span class="marked0"><a name="line902"></a> 902 def stream; @socket; end
|
|
1503
|
-
</span><span class="inferred1"><a name="line903"></a> 903
|
|
1504
|
-
</span><span class="inferred0"><a name="line904"></a> 904 # On the client side, send a request to the server.
|
|
1505
|
-
</span><span class="marked1"><a name="line905"></a> 905 def send_request(ref, msg_id, arg, b)
|
|
1506
|
-
</span><span class="uncovered0"><a name="line906"></a> 906 @msg.send_request(stream, ref, msg_id, arg, b)
|
|
1507
|
-
</span><span class="uncovered1"><a name="line907"></a> 907 end
|
|
1508
|
-
</span><span class="inferred0"><a name="line908"></a> 908
|
|
1509
|
-
</span><span class="inferred1"><a name="line909"></a> 909 # On the server side, receive a request from the client.
|
|
1510
|
-
</span><span class="marked0"><a name="line910"></a> 910 def recv_request
|
|
1511
|
-
</span><span class="uncovered1"><a name="line911"></a> 911 @msg.recv_request(stream)
|
|
1512
|
-
</span><span class="uncovered0"><a name="line912"></a> 912 end
|
|
1513
|
-
</span><span class="inferred1"><a name="line913"></a> 913
|
|
1514
|
-
</span><span class="inferred0"><a name="line914"></a> 914 # On the server side, send a reply to the client.
|
|
1515
|
-
</span><span class="marked1"><a name="line915"></a> 915 def send_reply(succ, result)
|
|
1516
|
-
</span><span class="uncovered0"><a name="line916"></a> 916 @msg.send_reply(stream, succ, result)
|
|
1517
|
-
</span><span class="uncovered1"><a name="line917"></a> 917 end
|
|
1518
|
-
</span><span class="inferred0"><a name="line918"></a> 918
|
|
1519
|
-
</span><span class="inferred1"><a name="line919"></a> 919 # On the client side, receive a reply from the server.
|
|
1520
|
-
</span><span class="marked0"><a name="line920"></a> 920 def recv_reply
|
|
1521
|
-
</span><span class="uncovered1"><a name="line921"></a> 921 @msg.recv_reply(stream)
|
|
1522
|
-
</span><span class="uncovered0"><a name="line922"></a> 922 end
|
|
1523
|
-
</span><span class="inferred1"><a name="line923"></a> 923
|
|
1524
|
-
</span><span class="marked0"><a name="line924"></a> 924 public
|
|
1525
|
-
</span><span class="inferred1"><a name="line925"></a> 925
|
|
1526
|
-
</span><span class="inferred0"><a name="line926"></a> 926 # Close the connection.
|
|
1527
|
-
</span><span class="inferred1"><a name="line927"></a> 927 #
|
|
1528
|
-
</span><span class="inferred0"><a name="line928"></a> 928 # If this is an instance returned by #open_server, then this stops
|
|
1529
|
-
</span><span class="inferred1"><a name="line929"></a> 929 # listening for new connections altogether. If this is an instance
|
|
1530
|
-
</span><span class="inferred0"><a name="line930"></a> 930 # returned by #open or by #accept, then it closes this particular
|
|
1531
|
-
</span><span class="inferred1"><a name="line931"></a> 931 # client-server session.
|
|
1532
|
-
</span><span class="marked0"><a name="line932"></a> 932 def close
|
|
1533
|
-
</span><span class="uncovered1"><a name="line933"></a> 933 if @socket
|
|
1534
|
-
</span><span class="uncovered0"><a name="line934"></a> 934 @socket.close
|
|
1535
|
-
</span><span class="uncovered1"><a name="line935"></a> 935 @socket = nil
|
|
1536
|
-
</span><span class="uncovered0"><a name="line936"></a> 936 end
|
|
1537
|
-
</span><span class="uncovered1"><a name="line937"></a> 937 end
|
|
1538
|
-
</span><span class="inferred0"><a name="line938"></a> 938
|
|
1539
|
-
</span><span class="inferred1"><a name="line939"></a> 939 # On the server side, for an instance returned by #open_server,
|
|
1540
|
-
</span><span class="inferred0"><a name="line940"></a> 940 # accept a client connection and return a new instance to handle
|
|
1541
|
-
</span><span class="inferred1"><a name="line941"></a> 941 # the server's side of this client-server session.
|
|
1542
|
-
</span><span class="marked0"><a name="line942"></a> 942 def accept
|
|
1543
|
-
</span><span class="uncovered1"><a name="line943"></a> 943 while true
|
|
1544
|
-
</span><span class="uncovered0"><a name="line944"></a> 944 s = @socket.accept
|
|
1545
|
-
</span><span class="uncovered1"><a name="line945"></a> 945 break if (@acl ? @acl.allow_socket?(s) : true)
|
|
1546
|
-
</span><span class="uncovered0"><a name="line946"></a> 946 s.close
|
|
1547
|
-
</span><span class="uncovered1"><a name="line947"></a> 947 end
|
|
1548
|
-
</span><span class="uncovered0"><a name="line948"></a> 948 self.class.new(nil, s, @config)
|
|
1549
|
-
</span><span class="uncovered1"><a name="line949"></a> 949 end
|
|
1550
|
-
</span><span class="inferred0"><a name="line950"></a> 950
|
|
1551
|
-
</span><span class="inferred1"><a name="line951"></a> 951 # Check to see if this connection is alive.
|
|
1552
|
-
</span><span class="marked0"><a name="line952"></a> 952 def alive?
|
|
1553
|
-
</span><span class="uncovered1"><a name="line953"></a> 953 return false unless @socket
|
|
1554
|
-
</span><span class="uncovered0"><a name="line954"></a> 954 if IO.select([@socket], nil, nil, 0)
|
|
1555
|
-
</span><span class="uncovered1"><a name="line955"></a> 955 close
|
|
1556
|
-
</span><span class="uncovered0"><a name="line956"></a> 956 return false
|
|
1557
|
-
</span><span class="uncovered1"><a name="line957"></a> 957 end
|
|
1558
|
-
</span><span class="uncovered0"><a name="line958"></a> 958 true
|
|
1559
|
-
</span><span class="uncovered1"><a name="line959"></a> 959 end
|
|
1560
|
-
</span><span class="inferred0"><a name="line960"></a> 960
|
|
1561
|
-
</span><span class="marked1"><a name="line961"></a> 961 def set_sockopt(soc) # :nodoc:
|
|
1562
|
-
</span><span class="uncovered0"><a name="line962"></a> 962 soc.setsockopt(Socket::IPPROTO_TCP, Socket::TCP_NODELAY, 1)
|
|
1563
|
-
</span><span class="uncovered1"><a name="line963"></a> 963 soc.fcntl(Fcntl::F_SETFD, Fcntl::FD_CLOEXEC) if defined? Fcntl::FD_CLOEXEC
|
|
1564
|
-
</span><span class="uncovered0"><a name="line964"></a> 964 end
|
|
1565
|
-
</span><span class="uncovered1"><a name="line965"></a> 965 end
|
|
1566
|
-
</span><span class="inferred0"><a name="line966"></a> 966
|
|
1567
|
-
</span><span class="marked1"><a name="line967"></a> 967 module DRbProtocol
|
|
1568
|
-
</span><span class="marked0"><a name="line968"></a> 968 @protocol = [DRbTCPSocket] # default
|
|
1569
|
-
</span><span class="inferred1"><a name="line969"></a> 969 end
|
|
1570
|
-
</span><span class="inferred0"><a name="line970"></a> 970
|
|
1571
|
-
</span><span class="marked1"><a name="line971"></a> 971 class DRbURIOption # :nodoc: I don't understand the purpose of this class...
|
|
1572
|
-
</span><span class="marked0"><a name="line972"></a> 972 def initialize(option)
|
|
1573
|
-
</span><span class="uncovered1"><a name="line973"></a> 973 @option = option.to_s
|
|
1574
|
-
</span><span class="uncovered0"><a name="line974"></a> 974 end
|
|
1575
|
-
</span><span class="marked1"><a name="line975"></a> 975 attr :option
|
|
1576
|
-
</span><span class="marked0"><a name="line976"></a> 976 def to_s; @option; end
|
|
1577
|
-
</span><span class="inferred1"><a name="line977"></a> 977
|
|
1578
|
-
</span><span class="marked0"><a name="line978"></a> 978 def ==(other)
|
|
1579
|
-
</span><span class="uncovered1"><a name="line979"></a> 979 return false unless DRbURIOption === other
|
|
1580
|
-
</span><span class="uncovered0"><a name="line980"></a> 980 @option == other.option
|
|
1581
|
-
</span><span class="uncovered1"><a name="line981"></a> 981 end
|
|
1582
|
-
</span><span class="inferred0"><a name="line982"></a> 982
|
|
1583
|
-
</span><span class="marked1"><a name="line983"></a> 983 def hash
|
|
1584
|
-
</span><span class="uncovered0"><a name="line984"></a> 984 @option.hash
|
|
1585
|
-
</span><span class="uncovered1"><a name="line985"></a> 985 end
|
|
1586
|
-
</span><span class="inferred0"><a name="line986"></a> 986
|
|
1587
|
-
</span><span class="marked1"><a name="line987"></a> 987 alias eql? ==
|
|
1588
|
-
</span><span class="inferred0"><a name="line988"></a> 988 end
|
|
1589
|
-
</span><span class="inferred1"><a name="line989"></a> 989
|
|
1590
|
-
</span><span class="inferred0"><a name="line990"></a> 990 # Object wrapping a reference to a remote drb object.
|
|
1591
|
-
</span><span class="inferred1"><a name="line991"></a> 991 #
|
|
1592
|
-
</span><span class="inferred0"><a name="line992"></a> 992 # Method calls on this object are relayed to the remote
|
|
1593
|
-
</span><span class="inferred1"><a name="line993"></a> 993 # object that this object is a stub for.
|
|
1594
|
-
</span><span class="marked0"><a name="line994"></a> 994 class DRbObject
|
|
1595
|
-
</span><span class="inferred1"><a name="line995"></a> 995
|
|
1596
|
-
</span><span class="inferred0"><a name="line996"></a> 996 # Unmarshall a marshalled DRbObject.
|
|
1597
|
-
</span><span class="inferred1"><a name="line997"></a> 997 #
|
|
1598
|
-
</span><span class="inferred0"><a name="line998"></a> 998 # If the referenced object is located within the local server, then
|
|
1599
|
-
</span><span class="inferred1"><a name="line999"></a> 999 # the object itself is returned. Otherwise, a new DRbObject is
|
|
1600
|
-
</span><span class="inferred0"><a name="line1000"></a>1000 # created to act as a stub for the remote referenced object.
|
|
1601
|
-
</span><span class="marked1"><a name="line1001"></a>1001 def self._load(s)
|
|
1602
|
-
</span><span class="uncovered0"><a name="line1002"></a>1002 uri, ref = Marshal.load(s)
|
|
1603
|
-
</span><span class="uncovered1"><a name="line1003"></a>1003
|
|
1604
|
-
</span><span class="uncovered0"><a name="line1004"></a>1004 if DRb.here?(uri)
|
|
1605
|
-
</span><span class="uncovered1"><a name="line1005"></a>1005 obj = DRb.to_obj(ref)
|
|
1606
|
-
</span><span class="uncovered0"><a name="line1006"></a>1006 if ((! obj.tainted?) && Thread.current[:drb_untaint])
|
|
1607
|
-
</span><span class="uncovered1"><a name="line1007"></a>1007 Thread.current[:drb_untaint].push(obj)
|
|
1608
|
-
</span><span class="uncovered0"><a name="line1008"></a>1008 end
|
|
1609
|
-
</span><span class="uncovered1"><a name="line1009"></a>1009 return obj
|
|
1610
|
-
</span><span class="uncovered0"><a name="line1010"></a>1010 end
|
|
1611
|
-
</span><span class="uncovered1"><a name="line1011"></a>1011
|
|
1612
|
-
</span><span class="uncovered0"><a name="line1012"></a>1012 self.new_with(uri, ref)
|
|
1613
|
-
</span><span class="uncovered1"><a name="line1013"></a>1013 end
|
|
1614
|
-
</span><span class="inferred0"><a name="line1014"></a>1014
|
|
1615
|
-
</span><span class="marked1"><a name="line1015"></a>1015 def self.new_with(uri, ref)
|
|
1616
|
-
</span><span class="uncovered0"><a name="line1016"></a>1016 it = self.allocate
|
|
1617
|
-
</span><span class="uncovered1"><a name="line1017"></a>1017 it.instance_variable_set('@uri', uri)
|
|
1618
|
-
</span><span class="uncovered0"><a name="line1018"></a>1018 it.instance_variable_set('@ref', ref)
|
|
1619
|
-
</span><span class="uncovered1"><a name="line1019"></a>1019 it
|
|
1620
|
-
</span><span class="uncovered0"><a name="line1020"></a>1020 end
|
|
1621
|
-
</span><span class="inferred1"><a name="line1021"></a>1021
|
|
1622
|
-
</span><span class="inferred0"><a name="line1022"></a>1022 # Create a new DRbObject from a URI alone.
|
|
1623
|
-
</span><span class="marked1"><a name="line1023"></a>1023 def self.new_with_uri(uri)
|
|
1624
|
-
</span><span class="uncovered0"><a name="line1024"></a>1024 self.new(nil, uri)
|
|
1625
|
-
</span><span class="uncovered1"><a name="line1025"></a>1025 end
|
|
1626
|
-
</span><span class="inferred0"><a name="line1026"></a>1026
|
|
1627
|
-
</span><span class="inferred1"><a name="line1027"></a>1027 # Marshall this object.
|
|
1628
|
-
</span><span class="inferred0"><a name="line1028"></a>1028 #
|
|
1629
|
-
</span><span class="inferred1"><a name="line1029"></a>1029 # The URI and ref of the object are marshalled.
|
|
1630
|
-
</span><span class="marked0"><a name="line1030"></a>1030 def _dump(lv)
|
|
1631
|
-
</span><span class="uncovered1"><a name="line1031"></a>1031 Marshal.dump([@uri, @ref])
|
|
1632
|
-
</span><span class="uncovered0"><a name="line1032"></a>1032 end
|
|
1633
|
-
</span><span class="inferred1"><a name="line1033"></a>1033
|
|
1634
|
-
</span><span class="inferred0"><a name="line1034"></a>1034 # Create a new remote object stub.
|
|
1635
|
-
</span><span class="inferred1"><a name="line1035"></a>1035 #
|
|
1636
|
-
</span><span class="inferred0"><a name="line1036"></a>1036 # +obj+ is the (local) object we want to create a stub for. Normally
|
|
1637
|
-
</span><span class="inferred1"><a name="line1037"></a>1037 # this is +nil+. +uri+ is the URI of the remote object that this
|
|
1638
|
-
</span><span class="inferred0"><a name="line1038"></a>1038 # will be a stub for.
|
|
1639
|
-
</span><span class="marked1"><a name="line1039"></a>1039 def initialize(obj, uri=nil)
|
|
1640
|
-
</span><span class="uncovered0"><a name="line1040"></a>1040 @uri = nil
|
|
1641
|
-
</span><span class="uncovered1"><a name="line1041"></a>1041 @ref = nil
|
|
1642
|
-
</span><span class="uncovered0"><a name="line1042"></a>1042 if obj.nil?
|
|
1643
|
-
</span><span class="uncovered1"><a name="line1043"></a>1043 return if uri.nil?
|
|
1644
|
-
</span><span class="uncovered0"><a name="line1044"></a>1044 @uri, option = DRbProtocol.uri_option(uri, DRb.config)
|
|
1645
|
-
</span><span class="uncovered1"><a name="line1045"></a>1045 @ref = DRbURIOption.new(option) unless option.nil?
|
|
1646
|
-
</span><span class="uncovered0"><a name="line1046"></a>1046 else
|
|
1647
|
-
</span><span class="uncovered1"><a name="line1047"></a>1047 @uri = uri ? uri : (DRb.uri rescue nil)
|
|
1648
|
-
</span><span class="uncovered0"><a name="line1048"></a>1048 @ref = obj ? DRb.to_id(obj) : nil
|
|
1649
|
-
</span><span class="uncovered1"><a name="line1049"></a>1049 end
|
|
1650
|
-
</span><span class="uncovered0"><a name="line1050"></a>1050 end
|
|
1651
|
-
</span><span class="inferred1"><a name="line1051"></a>1051
|
|
1652
|
-
</span><span class="inferred0"><a name="line1052"></a>1052 # Get the URI of the remote object.
|
|
1653
|
-
</span><span class="marked1"><a name="line1053"></a>1053 def __drburi
|
|
1654
|
-
</span><span class="uncovered0"><a name="line1054"></a>1054 @uri
|
|
1655
|
-
</span><span class="uncovered1"><a name="line1055"></a>1055 end
|
|
1656
|
-
</span><span class="inferred0"><a name="line1056"></a>1056
|
|
1657
|
-
</span><span class="inferred1"><a name="line1057"></a>1057 # Get the reference of the object, if local.
|
|
1658
|
-
</span><span class="marked0"><a name="line1058"></a>1058 def __drbref
|
|
1659
|
-
</span><span class="uncovered1"><a name="line1059"></a>1059 @ref
|
|
1660
|
-
</span><span class="uncovered0"><a name="line1060"></a>1060 end
|
|
1661
|
-
</span><span class="inferred1"><a name="line1061"></a>1061
|
|
1662
|
-
</span><span class="marked0"><a name="line1062"></a>1062 undef :to_s
|
|
1663
|
-
</span><span class="marked1"><a name="line1063"></a>1063 undef :to_a if respond_to?(:to_a)
|
|
1664
|
-
</span><span class="inferred0"><a name="line1064"></a>1064
|
|
1665
|
-
</span><span class="marked1"><a name="line1065"></a>1065 def respond_to?(msg_id, priv=false)
|
|
1666
|
-
</span><span class="uncovered0"><a name="line1066"></a>1066 case msg_id
|
|
1667
|
-
</span><span class="uncovered1"><a name="line1067"></a>1067 when :_dump
|
|
1668
|
-
</span><span class="uncovered0"><a name="line1068"></a>1068 true
|
|
1669
|
-
</span><span class="uncovered1"><a name="line1069"></a>1069 when :marshal_dump
|
|
1670
|
-
</span><span class="uncovered0"><a name="line1070"></a>1070 false
|
|
1671
|
-
</span><span class="uncovered1"><a name="line1071"></a>1071 else
|
|
1672
|
-
</span><span class="uncovered0"><a name="line1072"></a>1072 method_missing(:respond_to?, msg_id, priv)
|
|
1673
|
-
</span><span class="uncovered1"><a name="line1073"></a>1073 end
|
|
1674
|
-
</span><span class="uncovered0"><a name="line1074"></a>1074 end
|
|
1675
|
-
</span><span class="inferred1"><a name="line1075"></a>1075
|
|
1676
|
-
</span><span class="inferred0"><a name="line1076"></a>1076 # Routes method calls to the referenced object.
|
|
1677
|
-
</span><span class="marked1"><a name="line1077"></a>1077 def method_missing(msg_id, *a, &b)
|
|
1678
|
-
</span><span class="uncovered0"><a name="line1078"></a>1078 if DRb.here?(@uri)
|
|
1679
|
-
</span><span class="uncovered1"><a name="line1079"></a>1079 obj = DRb.to_obj(@ref)
|
|
1680
|
-
</span><span class="uncovered0"><a name="line1080"></a>1080 DRb.current_server.check_insecure_method(obj, msg_id)
|
|
1681
|
-
</span><span class="uncovered1"><a name="line1081"></a>1081 return obj.__send__(msg_id, *a, &b)
|
|
1682
|
-
</span><span class="uncovered0"><a name="line1082"></a>1082 end
|
|
1683
|
-
</span><span class="uncovered1"><a name="line1083"></a>1083
|
|
1684
|
-
</span><span class="uncovered0"><a name="line1084"></a>1084 succ, result = self.class.with_friend(@uri) do
|
|
1685
|
-
</span><span class="uncovered1"><a name="line1085"></a>1085 DRbConn.open(@uri) do |conn|
|
|
1686
|
-
</span><span class="uncovered0"><a name="line1086"></a>1086 conn.send_message(self, msg_id, a, b)
|
|
1687
|
-
</span><span class="uncovered1"><a name="line1087"></a>1087 end
|
|
1688
|
-
</span><span class="uncovered0"><a name="line1088"></a>1088 end
|
|
1689
|
-
</span><span class="uncovered1"><a name="line1089"></a>1089
|
|
1690
|
-
</span><span class="uncovered0"><a name="line1090"></a>1090 if succ
|
|
1691
|
-
</span><span class="uncovered1"><a name="line1091"></a>1091 return result
|
|
1692
|
-
</span><span class="uncovered0"><a name="line1092"></a>1092 elsif DRbUnknown === result
|
|
1693
|
-
</span><span class="uncovered1"><a name="line1093"></a>1093 raise result
|
|
1694
|
-
</span><span class="uncovered0"><a name="line1094"></a>1094 else
|
|
1695
|
-
</span><span class="uncovered1"><a name="line1095"></a>1095 bt = self.class.prepare_backtrace(@uri, result)
|
|
1696
|
-
</span><span class="uncovered0"><a name="line1096"></a>1096 result.set_backtrace(bt + caller)
|
|
1697
|
-
</span><span class="uncovered1"><a name="line1097"></a>1097 raise result
|
|
1698
|
-
</span><span class="uncovered0"><a name="line1098"></a>1098 end
|
|
1699
|
-
</span><span class="uncovered1"><a name="line1099"></a>1099 end
|
|
1700
|
-
</span><span class="inferred0"><a name="line1100"></a>1100
|
|
1701
|
-
</span><span class="marked1"><a name="line1101"></a>1101 def self.with_friend(uri)
|
|
1702
|
-
</span><span class="uncovered0"><a name="line1102"></a>1102 friend = DRb.fetch_server(uri)
|
|
1703
|
-
</span><span class="uncovered1"><a name="line1103"></a>1103 return yield() unless friend
|
|
1704
|
-
</span><span class="uncovered0"><a name="line1104"></a>1104
|
|
1705
|
-
</span><span class="uncovered1"><a name="line1105"></a>1105 save = Thread.current['DRb']
|
|
1706
|
-
</span><span class="uncovered0"><a name="line1106"></a>1106 Thread.current['DRb'] = { 'server' => friend }
|
|
1707
|
-
</span><span class="uncovered1"><a name="line1107"></a>1107 return yield
|
|
1708
|
-
</span><span class="uncovered0"><a name="line1108"></a>1108 ensure
|
|
1709
|
-
</span><span class="uncovered1"><a name="line1109"></a>1109 Thread.current['DRb'] = save if friend
|
|
1710
|
-
</span><span class="uncovered0"><a name="line1110"></a>1110 end
|
|
1711
|
-
</span><span class="inferred1"><a name="line1111"></a>1111
|
|
1712
|
-
</span><span class="marked0"><a name="line1112"></a>1112 def self.prepare_backtrace(uri, result)
|
|
1713
|
-
</span><span class="uncovered1"><a name="line1113"></a>1113 prefix = "(#{uri}) "
|
|
1714
|
-
</span><span class="uncovered0"><a name="line1114"></a>1114 bt = []
|
|
1715
|
-
</span><span class="uncovered1"><a name="line1115"></a>1115 result.backtrace.each do |x|
|
|
1716
|
-
</span><span class="uncovered0"><a name="line1116"></a>1116 break if /`__send__'$/ =~ x
|
|
1717
|
-
</span><span class="uncovered1"><a name="line1117"></a>1117 if /^\(druby:\/\// =~ x
|
|
1718
|
-
</span><span class="uncovered0"><a name="line1118"></a>1118 bt.push(x)
|
|
1719
|
-
</span><span class="uncovered1"><a name="line1119"></a>1119 else
|
|
1720
|
-
</span><span class="uncovered0"><a name="line1120"></a>1120 bt.push(prefix + x)
|
|
1721
|
-
</span><span class="uncovered1"><a name="line1121"></a>1121 end
|
|
1722
|
-
</span><span class="uncovered0"><a name="line1122"></a>1122 end
|
|
1723
|
-
</span><span class="uncovered1"><a name="line1123"></a>1123 bt
|
|
1724
|
-
</span><span class="uncovered0"><a name="line1124"></a>1124 end
|
|
1725
|
-
</span><span class="inferred1"><a name="line1125"></a>1125
|
|
1726
|
-
</span><span class="marked0"><a name="line1126"></a>1126 def pretty_print(q) # :nodoc:
|
|
1727
|
-
</span><span class="uncovered1"><a name="line1127"></a>1127 q.pp_object(self)
|
|
1728
|
-
</span><span class="uncovered0"><a name="line1128"></a>1128 end
|
|
1729
|
-
</span><span class="inferred1"><a name="line1129"></a>1129
|
|
1730
|
-
</span><span class="marked0"><a name="line1130"></a>1130 def pretty_print_cycle(q) # :nodoc:
|
|
1731
|
-
</span><span class="uncovered1"><a name="line1131"></a>1131 q.object_address_group(self) {
|
|
1732
|
-
</span><span class="uncovered0"><a name="line1132"></a>1132 q.breakable
|
|
1733
|
-
</span><span class="uncovered1"><a name="line1133"></a>1133 q.text '...'
|
|
1734
|
-
</span><span class="uncovered0"><a name="line1134"></a>1134 }
|
|
1735
|
-
</span><span class="uncovered1"><a name="line1135"></a>1135 end
|
|
1736
|
-
</span><span class="uncovered0"><a name="line1136"></a>1136 end
|
|
1737
|
-
</span><span class="inferred1"><a name="line1137"></a>1137
|
|
1738
|
-
</span><span class="inferred0"><a name="line1138"></a>1138 # Class handling the connection between a DRbObject and the
|
|
1739
|
-
</span><span class="inferred1"><a name="line1139"></a>1139 # server the real object lives on.
|
|
1740
|
-
</span><span class="inferred0"><a name="line1140"></a>1140 #
|
|
1741
|
-
</span><span class="inferred1"><a name="line1141"></a>1141 # This class maintains a pool of connections, to reduce the
|
|
1742
|
-
</span><span class="inferred0"><a name="line1142"></a>1142 # overhead of starting and closing down connections for each
|
|
1743
|
-
</span><span class="inferred1"><a name="line1143"></a>1143 # method call.
|
|
1744
|
-
</span><span class="inferred0"><a name="line1144"></a>1144 #
|
|
1745
|
-
</span><span class="inferred1"><a name="line1145"></a>1145 # This class is used internally by DRbObject. The user does
|
|
1746
|
-
</span><span class="inferred0"><a name="line1146"></a>1146 # not normally need to deal with it directly.
|
|
1747
|
-
</span><span class="marked1"><a name="line1147"></a>1147 class DRbConn
|
|
1748
|
-
</span><span class="marked0"><a name="line1148"></a>1148 POOL_SIZE = 16 # :nodoc:
|
|
1749
|
-
</span><span class="marked1"><a name="line1149"></a>1149 @mutex = Mutex.new
|
|
1750
|
-
</span><span class="marked0"><a name="line1150"></a>1150 @pool = []
|
|
1751
|
-
</span><span class="inferred1"><a name="line1151"></a>1151
|
|
1752
|
-
</span><span class="marked0"><a name="line1152"></a>1152 def self.open(remote_uri) # :nodoc:
|
|
1753
|
-
</span><span class="uncovered1"><a name="line1153"></a>1153 begin
|
|
1754
|
-
</span><span class="uncovered0"><a name="line1154"></a>1154 conn = nil
|
|
1755
|
-
</span><span class="uncovered1"><a name="line1155"></a>1155
|
|
1756
|
-
</span><span class="uncovered0"><a name="line1156"></a>1156 @mutex.synchronize do
|
|
1757
|
-
</span><span class="uncovered1"><a name="line1157"></a>1157 #FIXME
|
|
1758
|
-
</span><span class="uncovered0"><a name="line1158"></a>1158 new_pool = []
|
|
1759
|
-
</span><span class="uncovered1"><a name="line1159"></a>1159 @pool.each do |c|
|
|
1760
|
-
</span><span class="uncovered0"><a name="line1160"></a>1160 if conn.nil? and c.uri == remote_uri
|
|
1761
|
-
</span><span class="uncovered1"><a name="line1161"></a>1161 conn = c if c.alive?
|
|
1762
|
-
</span><span class="uncovered0"><a name="line1162"></a>1162 else
|
|
1763
|
-
</span><span class="uncovered1"><a name="line1163"></a>1163 new_pool.push c
|
|
1764
|
-
</span><span class="uncovered0"><a name="line1164"></a>1164 end
|
|
1765
|
-
</span><span class="uncovered1"><a name="line1165"></a>1165 end
|
|
1766
|
-
</span><span class="uncovered0"><a name="line1166"></a>1166 @pool = new_pool
|
|
1767
|
-
</span><span class="uncovered1"><a name="line1167"></a>1167 end
|
|
1768
|
-
</span><span class="uncovered0"><a name="line1168"></a>1168
|
|
1769
|
-
</span><span class="uncovered1"><a name="line1169"></a>1169 conn = self.new(remote_uri) unless conn
|
|
1770
|
-
</span><span class="uncovered0"><a name="line1170"></a>1170 succ, result = yield(conn)
|
|
1771
|
-
</span><span class="uncovered1"><a name="line1171"></a>1171 return succ, result
|
|
1772
|
-
</span><span class="uncovered0"><a name="line1172"></a>1172
|
|
1773
|
-
</span><span class="uncovered1"><a name="line1173"></a>1173 ensure
|
|
1774
|
-
</span><span class="uncovered0"><a name="line1174"></a>1174 if conn
|
|
1775
|
-
</span><span class="uncovered1"><a name="line1175"></a>1175 if succ
|
|
1776
|
-
</span><span class="uncovered0"><a name="line1176"></a>1176 @mutex.synchronize do
|
|
1777
|
-
</span><span class="uncovered1"><a name="line1177"></a>1177 @pool.unshift(conn)
|
|
1778
|
-
</span><span class="uncovered0"><a name="line1178"></a>1178 @pool.pop.close while @pool.size > POOL_SIZE
|
|
1779
|
-
</span><span class="uncovered1"><a name="line1179"></a>1179 end
|
|
1780
|
-
</span><span class="uncovered0"><a name="line1180"></a>1180 else
|
|
1781
|
-
</span><span class="uncovered1"><a name="line1181"></a>1181 conn.close
|
|
1782
|
-
</span><span class="uncovered0"><a name="line1182"></a>1182 end
|
|
1783
|
-
</span><span class="uncovered1"><a name="line1183"></a>1183 end
|
|
1784
|
-
</span><span class="uncovered0"><a name="line1184"></a>1184 end
|
|
1785
|
-
</span><span class="uncovered1"><a name="line1185"></a>1185 end
|
|
1786
|
-
</span><span class="inferred0"><a name="line1186"></a>1186
|
|
1787
|
-
</span><span class="marked1"><a name="line1187"></a>1187 def initialize(remote_uri) # :nodoc:
|
|
1788
|
-
</span><span class="uncovered0"><a name="line1188"></a>1188 @uri = remote_uri
|
|
1789
|
-
</span><span class="uncovered1"><a name="line1189"></a>1189 @protocol = DRbProtocol.open(remote_uri, DRb.config)
|
|
1790
|
-
</span><span class="uncovered0"><a name="line1190"></a>1190 end
|
|
1791
|
-
</span><span class="marked1"><a name="line1191"></a>1191 attr_reader :uri # :nodoc:
|
|
1792
|
-
</span><span class="inferred0"><a name="line1192"></a>1192
|
|
1793
|
-
</span><span class="marked1"><a name="line1193"></a>1193 def send_message(ref, msg_id, arg, block) # :nodoc:
|
|
1794
|
-
</span><span class="uncovered0"><a name="line1194"></a>1194 @protocol.send_request(ref, msg_id, arg, block)
|
|
1795
|
-
</span><span class="uncovered1"><a name="line1195"></a>1195 @protocol.recv_reply
|
|
1796
|
-
</span><span class="uncovered0"><a name="line1196"></a>1196 end
|
|
1797
|
-
</span><span class="inferred1"><a name="line1197"></a>1197
|
|
1798
|
-
</span><span class="marked0"><a name="line1198"></a>1198 def close # :nodoc:
|
|
1799
|
-
</span><span class="uncovered1"><a name="line1199"></a>1199 @protocol.close
|
|
1800
|
-
</span><span class="uncovered0"><a name="line1200"></a>1200 @protocol = nil
|
|
1801
|
-
</span><span class="uncovered1"><a name="line1201"></a>1201 end
|
|
1802
|
-
</span><span class="inferred0"><a name="line1202"></a>1202
|
|
1803
|
-
</span><span class="marked1"><a name="line1203"></a>1203 def alive? # :nodoc:
|
|
1804
|
-
</span><span class="uncovered0"><a name="line1204"></a>1204 @protocol.alive?
|
|
1805
|
-
</span><span class="uncovered1"><a name="line1205"></a>1205 end
|
|
1806
|
-
</span><span class="uncovered0"><a name="line1206"></a>1206 end
|
|
1807
|
-
</span><span class="inferred1"><a name="line1207"></a>1207
|
|
1808
|
-
</span><span class="inferred0"><a name="line1208"></a>1208 # Class representing a drb server instance.
|
|
1809
|
-
</span><span class="inferred1"><a name="line1209"></a>1209 #
|
|
1810
|
-
</span><span class="inferred0"><a name="line1210"></a>1210 # A DRbServer must be running in the local process before any incoming
|
|
1811
|
-
</span><span class="inferred1"><a name="line1211"></a>1211 # dRuby calls can be accepted, or any local objects can be passed as
|
|
1812
|
-
</span><span class="inferred0"><a name="line1212"></a>1212 # dRuby references to remote processes, even if those local objects are
|
|
1813
|
-
</span><span class="inferred1"><a name="line1213"></a>1213 # never actually called remotely. You do not need to start a DRbServer
|
|
1814
|
-
</span><span class="inferred0"><a name="line1214"></a>1214 # in the local process if you are only making outgoing dRuby calls
|
|
1815
|
-
</span><span class="inferred1"><a name="line1215"></a>1215 # passing marshalled parameters.
|
|
1816
|
-
</span><span class="inferred0"><a name="line1216"></a>1216 #
|
|
1817
|
-
</span><span class="inferred1"><a name="line1217"></a>1217 # Unless multiple servers are being used, the local DRbServer is normally
|
|
1818
|
-
</span><span class="inferred0"><a name="line1218"></a>1218 # started by calling DRb.start_service.
|
|
1819
|
-
</span><span class="marked1"><a name="line1219"></a>1219 class DRbServer
|
|
1820
|
-
</span><span class="marked0"><a name="line1220"></a>1220 @@acl = nil
|
|
1821
|
-
</span><span class="marked1"><a name="line1221"></a>1221 @@idconv = DRbIdConv.new
|
|
1822
|
-
</span><span class="marked0"><a name="line1222"></a>1222 @@secondary_server = nil
|
|
1823
|
-
</span><span class="marked1"><a name="line1223"></a>1223 @@argc_limit = 256
|
|
1824
|
-
</span><span class="marked0"><a name="line1224"></a>1224 @@load_limit = 256 * 102400
|
|
1825
|
-
</span><span class="marked1"><a name="line1225"></a>1225 @@verbose = false
|
|
1826
|
-
</span><span class="marked0"><a name="line1226"></a>1226 @@safe_level = 0
|
|
1827
|
-
</span><span class="inferred1"><a name="line1227"></a>1227
|
|
1828
|
-
</span><span class="inferred0"><a name="line1228"></a>1228 # Set the default value for the :argc_limit option.
|
|
1829
|
-
</span><span class="inferred1"><a name="line1229"></a>1229 #
|
|
1830
|
-
</span><span class="inferred0"><a name="line1230"></a>1230 # See #new(). The initial default value is 256.
|
|
1831
|
-
</span><span class="marked1"><a name="line1231"></a>1231 def self.default_argc_limit(argc)
|
|
1832
|
-
</span><span class="uncovered0"><a name="line1232"></a>1232 @@argc_limit = argc
|
|
1833
|
-
</span><span class="uncovered1"><a name="line1233"></a>1233 end
|
|
1834
|
-
</span><span class="inferred0"><a name="line1234"></a>1234
|
|
1835
|
-
</span><span class="inferred1"><a name="line1235"></a>1235 # Set the default value for the :load_limit option.
|
|
1836
|
-
</span><span class="inferred0"><a name="line1236"></a>1236 #
|
|
1837
|
-
</span><span class="inferred1"><a name="line1237"></a>1237 # See #new(). The initial default value is 25 MB.
|
|
1838
|
-
</span><span class="marked0"><a name="line1238"></a>1238 def self.default_load_limit(sz)
|
|
1839
|
-
</span><span class="uncovered1"><a name="line1239"></a>1239 @@load_limit = sz
|
|
1840
|
-
</span><span class="uncovered0"><a name="line1240"></a>1240 end
|
|
1841
|
-
</span><span class="inferred1"><a name="line1241"></a>1241
|
|
1842
|
-
</span><span class="inferred0"><a name="line1242"></a>1242 # Set the default value for the :acl option.
|
|
1843
|
-
</span><span class="inferred1"><a name="line1243"></a>1243 #
|
|
1844
|
-
</span><span class="inferred0"><a name="line1244"></a>1244 # See #new(). The initial default value is nil.
|
|
1845
|
-
</span><span class="marked1"><a name="line1245"></a>1245 def self.default_acl(acl)
|
|
1846
|
-
</span><span class="uncovered0"><a name="line1246"></a>1246 @@acl = acl
|
|
1847
|
-
</span><span class="uncovered1"><a name="line1247"></a>1247 end
|
|
1848
|
-
</span><span class="inferred0"><a name="line1248"></a>1248
|
|
1849
|
-
</span><span class="inferred1"><a name="line1249"></a>1249 # Set the default value for the :id_conv option.
|
|
1850
|
-
</span><span class="inferred0"><a name="line1250"></a>1250 #
|
|
1851
|
-
</span><span class="inferred1"><a name="line1251"></a>1251 # See #new(). The initial default value is a DRbIdConv instance.
|
|
1852
|
-
</span><span class="marked0"><a name="line1252"></a>1252 def self.default_id_conv(idconv)
|
|
1853
|
-
</span><span class="uncovered1"><a name="line1253"></a>1253 @@idconv = idconv
|
|
1854
|
-
</span><span class="uncovered0"><a name="line1254"></a>1254 end
|
|
1855
|
-
</span><span class="inferred1"><a name="line1255"></a>1255
|
|
1856
|
-
</span><span class="marked0"><a name="line1256"></a>1256 def self.default_safe_level(level)
|
|
1857
|
-
</span><span class="uncovered1"><a name="line1257"></a>1257 @@safe_level = level
|
|
1858
|
-
</span><span class="uncovered0"><a name="line1258"></a>1258 end
|
|
1859
|
-
</span><span class="inferred1"><a name="line1259"></a>1259
|
|
1860
|
-
</span><span class="inferred0"><a name="line1260"></a>1260 # Set the default value of the :verbose option.
|
|
1861
|
-
</span><span class="inferred1"><a name="line1261"></a>1261 #
|
|
1862
|
-
</span><span class="inferred0"><a name="line1262"></a>1262 # See #new(). The initial default value is false.
|
|
1863
|
-
</span><span class="marked1"><a name="line1263"></a>1263 def self.verbose=(on)
|
|
1864
|
-
</span><span class="uncovered0"><a name="line1264"></a>1264 @@verbose = on
|
|
1865
|
-
</span><span class="uncovered1"><a name="line1265"></a>1265 end
|
|
1866
|
-
</span><span class="inferred0"><a name="line1266"></a>1266
|
|
1867
|
-
</span><span class="inferred1"><a name="line1267"></a>1267 # Get the default value of the :verbose option.
|
|
1868
|
-
</span><span class="marked0"><a name="line1268"></a>1268 def self.verbose
|
|
1869
|
-
</span><span class="uncovered1"><a name="line1269"></a>1269 @@verbose
|
|
1870
|
-
</span><span class="uncovered0"><a name="line1270"></a>1270 end
|
|
1871
|
-
</span><span class="inferred1"><a name="line1271"></a>1271
|
|
1872
|
-
</span><span class="marked0"><a name="line1272"></a>1272 def self.make_config(hash={}) # :nodoc:
|
|
1873
|
-
</span><span class="uncovered1"><a name="line1273"></a>1273 default_config = {
|
|
1874
|
-
</span><span class="uncovered0"><a name="line1274"></a>1274 :idconv => @@idconv,
|
|
1875
|
-
</span><span class="uncovered1"><a name="line1275"></a>1275 :verbose => @@verbose,
|
|
1876
|
-
</span><span class="uncovered0"><a name="line1276"></a>1276 :tcp_acl => @@acl,
|
|
1877
|
-
</span><span class="uncovered1"><a name="line1277"></a>1277 :load_limit => @@load_limit,
|
|
1878
|
-
</span><span class="uncovered0"><a name="line1278"></a>1278 :argc_limit => @@argc_limit,
|
|
1879
|
-
</span><span class="uncovered1"><a name="line1279"></a>1279 :safe_level => @@safe_level
|
|
1880
|
-
</span><span class="uncovered0"><a name="line1280"></a>1280 }
|
|
1881
|
-
</span><span class="uncovered1"><a name="line1281"></a>1281 default_config.update(hash)
|
|
1882
|
-
</span><span class="uncovered0"><a name="line1282"></a>1282 end
|
|
1883
|
-
</span><span class="inferred1"><a name="line1283"></a>1283
|
|
1884
|
-
</span><span class="inferred0"><a name="line1284"></a>1284 # Create a new DRbServer instance.
|
|
1885
|
-
</span><span class="inferred1"><a name="line1285"></a>1285 #
|
|
1886
|
-
</span><span class="inferred0"><a name="line1286"></a>1286 # +uri+ is the URI to bind to. This is normally of the form
|
|
1887
|
-
</span><span class="inferred1"><a name="line1287"></a>1287 # 'druby://<hostname>:<port>' where <hostname> is a hostname of
|
|
1888
|
-
</span><span class="inferred0"><a name="line1288"></a>1288 # the local machine. If nil, then the system's default hostname
|
|
1889
|
-
</span><span class="inferred1"><a name="line1289"></a>1289 # will be bound to, on a port selected by the system; these value
|
|
1890
|
-
</span><span class="inferred0"><a name="line1290"></a>1290 # can be retrieved from the +uri+ attribute. 'druby:' specifies
|
|
1891
|
-
</span><span class="inferred1"><a name="line1291"></a>1291 # the default dRuby transport protocol: another protocol, such
|
|
1892
|
-
</span><span class="inferred0"><a name="line1292"></a>1292 # as 'drbunix:', can be specified instead.
|
|
1893
|
-
</span><span class="inferred1"><a name="line1293"></a>1293 #
|
|
1894
|
-
</span><span class="inferred0"><a name="line1294"></a>1294 # +front+ is the front object for the server, that is, the object
|
|
1895
|
-
</span><span class="inferred1"><a name="line1295"></a>1295 # to which remote method calls on the server will be passed. If
|
|
1896
|
-
</span><span class="inferred0"><a name="line1296"></a>1296 # nil, then the server will not accept remote method calls.
|
|
1897
|
-
</span><span class="inferred1"><a name="line1297"></a>1297 #
|
|
1898
|
-
</span><span class="inferred0"><a name="line1298"></a>1298 # If +config_or_acl+ is a hash, it is the configuration to
|
|
1899
|
-
</span><span class="inferred1"><a name="line1299"></a>1299 # use for this server. The following options are recognised:
|
|
1900
|
-
</span><span class="inferred0"><a name="line1300"></a>1300 #
|
|
1901
|
-
</span><span class="inferred1"><a name="line1301"></a>1301 # :idconv :: an id-to-object conversion object. This defaults
|
|
1902
|
-
</span><span class="inferred0"><a name="line1302"></a>1302 # to an instance of the class DRb::DRbIdConv.
|
|
1903
|
-
</span><span class="inferred1"><a name="line1303"></a>1303 # :verbose :: if true, all unsuccessful remote calls on objects
|
|
1904
|
-
</span><span class="inferred0"><a name="line1304"></a>1304 # in the server will be logged to $stdout. false
|
|
1905
|
-
</span><span class="inferred1"><a name="line1305"></a>1305 # by default.
|
|
1906
|
-
</span><span class="inferred0"><a name="line1306"></a>1306 # :tcp_acl :: the access control list for this server. See
|
|
1907
|
-
</span><span class="inferred1"><a name="line1307"></a>1307 # the ACL class from the main dRuby distribution.
|
|
1908
|
-
</span><span class="inferred0"><a name="line1308"></a>1308 # :load_limit :: the maximum message size in bytes accepted by
|
|
1909
|
-
</span><span class="inferred1"><a name="line1309"></a>1309 # the server. Defaults to 25 MB (26214400).
|
|
1910
|
-
</span><span class="inferred0"><a name="line1310"></a>1310 # :argc_limit :: the maximum number of arguments to a remote
|
|
1911
|
-
</span><span class="inferred1"><a name="line1311"></a>1311 # method accepted by the server. Defaults to
|
|
1912
|
-
</span><span class="inferred0"><a name="line1312"></a>1312 # 256.
|
|
1913
|
-
</span><span class="inferred1"><a name="line1313"></a>1313 #
|
|
1914
|
-
</span><span class="inferred0"><a name="line1314"></a>1314 # The default values of these options can be modified on
|
|
1915
|
-
</span><span class="inferred1"><a name="line1315"></a>1315 # a class-wide basis by the class methods #default_argc_limit,
|
|
1916
|
-
</span><span class="inferred0"><a name="line1316"></a>1316 # #default_load_limit, #default_acl, #default_id_conv,
|
|
1917
|
-
</span><span class="inferred1"><a name="line1317"></a>1317 # and #verbose=
|
|
1918
|
-
</span><span class="inferred0"><a name="line1318"></a>1318 #
|
|
1919
|
-
</span><span class="inferred1"><a name="line1319"></a>1319 # If +config_or_acl+ is not a hash, but is not nil, it is
|
|
1920
|
-
</span><span class="inferred0"><a name="line1320"></a>1320 # assumed to be the access control list for this server.
|
|
1921
|
-
</span><span class="inferred1"><a name="line1321"></a>1321 # See the :tcp_acl option for more details.
|
|
1922
|
-
</span><span class="inferred0"><a name="line1322"></a>1322 #
|
|
1923
|
-
</span><span class="inferred1"><a name="line1323"></a>1323 # If no other server is currently set as the primary server,
|
|
1924
|
-
</span><span class="inferred0"><a name="line1324"></a>1324 # this will become the primary server.
|
|
1925
|
-
</span><span class="inferred1"><a name="line1325"></a>1325 #
|
|
1926
|
-
</span><span class="inferred0"><a name="line1326"></a>1326 # The server will immediately start running in its own thread.
|
|
1927
|
-
</span><span class="marked1"><a name="line1327"></a>1327 def initialize(uri=nil, front=nil, config_or_acl=nil)
|
|
1928
|
-
</span><span class="uncovered0"><a name="line1328"></a>1328 if Hash === config_or_acl
|
|
1929
|
-
</span><span class="uncovered1"><a name="line1329"></a>1329 config = config_or_acl.dup
|
|
1930
|
-
</span><span class="uncovered0"><a name="line1330"></a>1330 else
|
|
1931
|
-
</span><span class="uncovered1"><a name="line1331"></a>1331 acl = config_or_acl || @@acl
|
|
1932
|
-
</span><span class="uncovered0"><a name="line1332"></a>1332 config = {
|
|
1933
|
-
</span><span class="uncovered1"><a name="line1333"></a>1333 :tcp_acl => acl
|
|
1934
|
-
</span><span class="uncovered0"><a name="line1334"></a>1334 }
|
|
1935
|
-
</span><span class="uncovered1"><a name="line1335"></a>1335 end
|
|
1936
|
-
</span><span class="uncovered0"><a name="line1336"></a>1336
|
|
1937
|
-
</span><span class="uncovered1"><a name="line1337"></a>1337 @config = self.class.make_config(config)
|
|
1938
|
-
</span><span class="uncovered0"><a name="line1338"></a>1338
|
|
1939
|
-
</span><span class="uncovered1"><a name="line1339"></a>1339 @protocol = DRbProtocol.open_server(uri, @config)
|
|
1940
|
-
</span><span class="uncovered0"><a name="line1340"></a>1340 @uri = @protocol.uri
|
|
1941
|
-
</span><span class="uncovered1"><a name="line1341"></a>1341
|
|
1942
|
-
</span><span class="uncovered0"><a name="line1342"></a>1342 @front = front
|
|
1943
|
-
</span><span class="uncovered1"><a name="line1343"></a>1343 @idconv = @config[:idconv]
|
|
1944
|
-
</span><span class="uncovered0"><a name="line1344"></a>1344 @safe_level = @config[:safe_level]
|
|
1945
|
-
</span><span class="uncovered1"><a name="line1345"></a>1345
|
|
1946
|
-
</span><span class="uncovered0"><a name="line1346"></a>1346 @grp = ThreadGroup.new
|
|
1947
|
-
</span><span class="uncovered1"><a name="line1347"></a>1347 @thread = run
|
|
1948
|
-
</span><span class="uncovered0"><a name="line1348"></a>1348
|
|
1949
|
-
</span><span class="uncovered1"><a name="line1349"></a>1349 DRb.regist_server(self)
|
|
1950
|
-
</span><span class="uncovered0"><a name="line1350"></a>1350 end
|
|
1951
|
-
</span><span class="inferred1"><a name="line1351"></a>1351
|
|
1952
|
-
</span><span class="inferred0"><a name="line1352"></a>1352 # The URI of this DRbServer.
|
|
1953
|
-
</span><span class="marked1"><a name="line1353"></a>1353 attr_reader :uri
|
|
1954
|
-
</span><span class="inferred0"><a name="line1354"></a>1354
|
|
1955
|
-
</span><span class="inferred1"><a name="line1355"></a>1355 # The main thread of this DRbServer.
|
|
1956
|
-
</span><span class="inferred0"><a name="line1356"></a>1356 #
|
|
1957
|
-
</span><span class="inferred1"><a name="line1357"></a>1357 # This is the thread that listens for and accepts connections
|
|
1958
|
-
</span><span class="inferred0"><a name="line1358"></a>1358 # from clients, not that handles each client's request-response
|
|
1959
|
-
</span><span class="inferred1"><a name="line1359"></a>1359 # session.
|
|
1960
|
-
</span><span class="marked0"><a name="line1360"></a>1360 attr_reader :thread
|
|
1961
|
-
</span><span class="inferred1"><a name="line1361"></a>1361
|
|
1962
|
-
</span><span class="inferred0"><a name="line1362"></a>1362 # The front object of the DRbServer.
|
|
1963
|
-
</span><span class="inferred1"><a name="line1363"></a>1363 #
|
|
1964
|
-
</span><span class="inferred0"><a name="line1364"></a>1364 # This object receives remote method calls made on the server's
|
|
1965
|
-
</span><span class="inferred1"><a name="line1365"></a>1365 # URI alone, with an object id.
|
|
1966
|
-
</span><span class="marked0"><a name="line1366"></a>1366 attr_reader :front
|
|
1967
|
-
</span><span class="inferred1"><a name="line1367"></a>1367
|
|
1968
|
-
</span><span class="inferred0"><a name="line1368"></a>1368 # The configuration of this DRbServer
|
|
1969
|
-
</span><span class="marked1"><a name="line1369"></a>1369 attr_reader :config
|
|
1970
|
-
</span><span class="inferred0"><a name="line1370"></a>1370
|
|
1971
|
-
</span><span class="marked1"><a name="line1371"></a>1371 attr_reader :safe_level
|
|
1972
|
-
</span><span class="inferred0"><a name="line1372"></a>1372
|
|
1973
|
-
</span><span class="inferred1"><a name="line1373"></a>1373 # Set whether to operate in verbose mode.
|
|
1974
|
-
</span><span class="inferred0"><a name="line1374"></a>1374 #
|
|
1975
|
-
</span><span class="inferred1"><a name="line1375"></a>1375 # In verbose mode, failed calls are logged to stdout.
|
|
1976
|
-
</span><span class="marked0"><a name="line1376"></a>1376 def verbose=(v); @config[:verbose]=v; end
|
|
1977
|
-
</span><span class="inferred1"><a name="line1377"></a>1377
|
|
1978
|
-
</span><span class="inferred0"><a name="line1378"></a>1378 # Get whether the server is in verbose mode.
|
|
1979
|
-
</span><span class="inferred1"><a name="line1379"></a>1379 #
|
|
1980
|
-
</span><span class="inferred0"><a name="line1380"></a>1380 # In verbose mode, failed calls are logged to stdout.
|
|
1981
|
-
</span><span class="marked1"><a name="line1381"></a>1381 def verbose; @config[:verbose]; end
|
|
1982
|
-
</span><span class="inferred0"><a name="line1382"></a>1382
|
|
1983
|
-
</span><span class="inferred1"><a name="line1383"></a>1383 # Is this server alive?
|
|
1984
|
-
</span><span class="marked0"><a name="line1384"></a>1384 def alive?
|
|
1985
|
-
</span><span class="uncovered1"><a name="line1385"></a>1385 @thread.alive?
|
|
1986
|
-
</span><span class="uncovered0"><a name="line1386"></a>1386 end
|
|
1987
|
-
</span><span class="inferred1"><a name="line1387"></a>1387
|
|
1988
|
-
</span><span class="inferred0"><a name="line1388"></a>1388 # Stop this server.
|
|
1989
|
-
</span><span class="marked1"><a name="line1389"></a>1389 def stop_service
|
|
1990
|
-
</span><span class="uncovered0"><a name="line1390"></a>1390 DRb.remove_server(self)
|
|
1991
|
-
</span><span class="uncovered1"><a name="line1391"></a>1391 if Thread.current['DRb'] && Thread.current['DRb']['server'] == self
|
|
1992
|
-
</span><span class="uncovered0"><a name="line1392"></a>1392 Thread.current['DRb']['stop_service'] = true
|
|
1993
|
-
</span><span class="uncovered1"><a name="line1393"></a>1393 else
|
|
1994
|
-
</span><span class="uncovered0"><a name="line1394"></a>1394 @thread.kill
|
|
1995
|
-
</span><span class="uncovered1"><a name="line1395"></a>1395 end
|
|
1996
|
-
</span><span class="uncovered0"><a name="line1396"></a>1396 end
|
|
1997
|
-
</span><span class="inferred1"><a name="line1397"></a>1397
|
|
1998
|
-
</span><span class="inferred0"><a name="line1398"></a>1398 # Convert a dRuby reference to the local object it refers to.
|
|
1999
|
-
</span><span class="marked1"><a name="line1399"></a>1399 def to_obj(ref)
|
|
2000
|
-
</span><span class="uncovered0"><a name="line1400"></a>1400 return front if ref.nil?
|
|
2001
|
-
</span><span class="uncovered1"><a name="line1401"></a>1401 return front[ref.to_s] if DRbURIOption === ref
|
|
2002
|
-
</span><span class="uncovered0"><a name="line1402"></a>1402 @idconv.to_obj(ref)
|
|
2003
|
-
</span><span class="uncovered1"><a name="line1403"></a>1403 end
|
|
2004
|
-
</span><span class="inferred0"><a name="line1404"></a>1404
|
|
2005
|
-
</span><span class="inferred1"><a name="line1405"></a>1405 # Convert a local object to a dRuby reference.
|
|
2006
|
-
</span><span class="marked0"><a name="line1406"></a>1406 def to_id(obj)
|
|
2007
|
-
</span><span class="uncovered1"><a name="line1407"></a>1407 return nil if obj.__id__ == front.__id__
|
|
2008
|
-
</span><span class="uncovered0"><a name="line1408"></a>1408 @idconv.to_id(obj)
|
|
2009
|
-
</span><span class="uncovered1"><a name="line1409"></a>1409 end
|
|
2010
|
-
</span><span class="inferred0"><a name="line1410"></a>1410
|
|
2011
|
-
</span><span class="marked1"><a name="line1411"></a>1411 private
|
|
2012
|
-
</span><span class="marked0"><a name="line1412"></a>1412 def kill_sub_thread
|
|
2013
|
-
</span><span class="uncovered1"><a name="line1413"></a>1413 Thread.new do
|
|
2014
|
-
</span><span class="uncovered0"><a name="line1414"></a>1414 grp = ThreadGroup.new
|
|
2015
|
-
</span><span class="uncovered1"><a name="line1415"></a>1415 grp.add(Thread.current)
|
|
2016
|
-
</span><span class="uncovered0"><a name="line1416"></a>1416 list = @grp.list
|
|
2017
|
-
</span><span class="uncovered1"><a name="line1417"></a>1417 while list.size > 0
|
|
2018
|
-
</span><span class="uncovered0"><a name="line1418"></a>1418 list.each do |th|
|
|
2019
|
-
</span><span class="uncovered1"><a name="line1419"></a>1419 th.kill if th.alive?
|
|
2020
|
-
</span><span class="uncovered0"><a name="line1420"></a>1420 end
|
|
2021
|
-
</span><span class="uncovered1"><a name="line1421"></a>1421 list = @grp.list
|
|
2022
|
-
</span><span class="uncovered0"><a name="line1422"></a>1422 end
|
|
2023
|
-
</span><span class="uncovered1"><a name="line1423"></a>1423 end
|
|
2024
|
-
</span><span class="uncovered0"><a name="line1424"></a>1424 end
|
|
2025
|
-
</span><span class="inferred1"><a name="line1425"></a>1425
|
|
2026
|
-
</span><span class="marked0"><a name="line1426"></a>1426 def run
|
|
2027
|
-
</span><span class="uncovered1"><a name="line1427"></a>1427 Thread.start do
|
|
2028
|
-
</span><span class="uncovered0"><a name="line1428"></a>1428 begin
|
|
2029
|
-
</span><span class="uncovered1"><a name="line1429"></a>1429 while true
|
|
2030
|
-
</span><span class="uncovered0"><a name="line1430"></a>1430 main_loop
|
|
2031
|
-
</span><span class="uncovered1"><a name="line1431"></a>1431 end
|
|
2032
|
-
</span><span class="uncovered0"><a name="line1432"></a>1432 ensure
|
|
2033
|
-
</span><span class="uncovered1"><a name="line1433"></a>1433 @protocol.close if @protocol
|
|
2034
|
-
</span><span class="uncovered0"><a name="line1434"></a>1434 kill_sub_thread
|
|
2035
|
-
</span><span class="uncovered1"><a name="line1435"></a>1435 end
|
|
2036
|
-
</span><span class="uncovered0"><a name="line1436"></a>1436 end
|
|
2037
|
-
</span><span class="uncovered1"><a name="line1437"></a>1437 end
|
|
2038
|
-
</span><span class="inferred0"><a name="line1438"></a>1438
|
|
2039
|
-
</span><span class="inferred1"><a name="line1439"></a>1439 # List of insecure methods.
|
|
2040
|
-
</span><span class="inferred0"><a name="line1440"></a>1440 #
|
|
2041
|
-
</span><span class="inferred1"><a name="line1441"></a>1441 # These methods are not callable via dRuby.
|
|
2042
|
-
</span><span class="marked0"><a name="line1442"></a>1442 INSECURE_METHOD = [
|
|
2043
|
-
</span><span class="inferred1"><a name="line1443"></a>1443 :__send__
|
|
2044
|
-
</span><span class="inferred0"><a name="line1444"></a>1444 ]
|
|
2045
|
-
</span><span class="inferred1"><a name="line1445"></a>1445
|
|
2046
|
-
</span><span class="inferred0"><a name="line1446"></a>1446 # Has a method been included in the list of insecure methods?
|
|
2047
|
-
</span><span class="marked1"><a name="line1447"></a>1447 def insecure_method?(msg_id)
|
|
2048
|
-
</span><span class="uncovered0"><a name="line1448"></a>1448 INSECURE_METHOD.include?(msg_id)
|
|
2049
|
-
</span><span class="uncovered1"><a name="line1449"></a>1449 end
|
|
2050
|
-
</span><span class="inferred0"><a name="line1450"></a>1450
|
|
2051
|
-
</span><span class="inferred1"><a name="line1451"></a>1451 # Coerce an object to a string, providing our own representation if
|
|
2052
|
-
</span><span class="inferred0"><a name="line1452"></a>1452 # to_s is not defined for the object.
|
|
2053
|
-
</span><span class="marked1"><a name="line1453"></a>1453 def any_to_s(obj)
|
|
2054
|
-
</span><span class="uncovered0"><a name="line1454"></a>1454 obj.to_s + ":#{obj.class}"
|
|
2055
|
-
</span><span class="uncovered1"><a name="line1455"></a>1455 rescue
|
|
2056
|
-
</span><span class="uncovered0"><a name="line1456"></a>1456 sprintf("#<%s:0x%lx>", obj.class, obj.__id__)
|
|
2057
|
-
</span><span class="uncovered1"><a name="line1457"></a>1457 end
|
|
2058
|
-
</span><span class="inferred0"><a name="line1458"></a>1458
|
|
2059
|
-
</span><span class="inferred1"><a name="line1459"></a>1459 # Check that a method is callable via dRuby.
|
|
2060
|
-
</span><span class="inferred0"><a name="line1460"></a>1460 #
|
|
2061
|
-
</span><span class="inferred1"><a name="line1461"></a>1461 # +obj+ is the object we want to invoke the method on. +msg_id+ is the
|
|
2062
|
-
</span><span class="inferred0"><a name="line1462"></a>1462 # method name, as a Symbol.
|
|
2063
|
-
</span><span class="inferred1"><a name="line1463"></a>1463 #
|
|
2064
|
-
</span><span class="inferred0"><a name="line1464"></a>1464 # If the method is an insecure method (see #insecure_method?) a
|
|
2065
|
-
</span><span class="inferred1"><a name="line1465"></a>1465 # SecurityError is thrown. If the method is private or undefined,
|
|
2066
|
-
</span><span class="inferred0"><a name="line1466"></a>1466 # a NameError is thrown.
|
|
2067
|
-
</span><span class="marked1"><a name="line1467"></a>1467 def check_insecure_method(obj, msg_id)
|
|
2068
|
-
</span><span class="uncovered0"><a name="line1468"></a>1468 return true if Proc === obj && msg_id == :__drb_yield
|
|
2069
|
-
</span><span class="uncovered1"><a name="line1469"></a>1469 raise(ArgumentError, "#{any_to_s(msg_id)} is not a symbol") unless Symbol == msg_id.class
|
|
2070
|
-
</span><span class="uncovered0"><a name="line1470"></a>1470 raise(SecurityError, "insecure method `#{msg_id}'") if insecure_method?(msg_id)
|
|
2071
|
-
</span><span class="uncovered1"><a name="line1471"></a>1471
|
|
2072
|
-
</span><span class="uncovered0"><a name="line1472"></a>1472 if obj.private_methods.include?(msg_id.to_s)
|
|
2073
|
-
</span><span class="uncovered1"><a name="line1473"></a>1473 desc = any_to_s(obj)
|
|
2074
|
-
</span><span class="uncovered0"><a name="line1474"></a>1474 raise NoMethodError, "private method `#{msg_id}' called for #{desc}"
|
|
2075
|
-
</span><span class="uncovered1"><a name="line1475"></a>1475 elsif obj.protected_methods.include?(msg_id.to_s)
|
|
2076
|
-
</span><span class="uncovered0"><a name="line1476"></a>1476 desc = any_to_s(obj)
|
|
2077
|
-
</span><span class="uncovered1"><a name="line1477"></a>1477 raise NoMethodError, "protected method `#{msg_id}' called for #{desc}"
|
|
2078
|
-
</span><span class="uncovered0"><a name="line1478"></a>1478 else
|
|
2079
|
-
</span><span class="uncovered1"><a name="line1479"></a>1479 true
|
|
2080
|
-
</span><span class="uncovered0"><a name="line1480"></a>1480 end
|
|
2081
|
-
</span><span class="uncovered1"><a name="line1481"></a>1481 end
|
|
2082
|
-
</span><span class="marked0"><a name="line1482"></a>1482 public :check_insecure_method
|
|
2083
|
-
</span><span class="inferred1"><a name="line1483"></a>1483
|
|
2084
|
-
</span><span class="marked0"><a name="line1484"></a>1484 class InvokeMethod # :nodoc:
|
|
2085
|
-
</span><span class="marked1"><a name="line1485"></a>1485 def initialize(drb_server, client)
|
|
2086
|
-
</span><span class="uncovered0"><a name="line1486"></a>1486 @drb_server = drb_server
|
|
2087
|
-
</span><span class="uncovered1"><a name="line1487"></a>1487 @safe_level = drb_server.safe_level
|
|
2088
|
-
</span><span class="uncovered0"><a name="line1488"></a>1488 @client = client
|
|
2089
|
-
</span><span class="uncovered1"><a name="line1489"></a>1489 end
|
|
2090
|
-
</span><span class="inferred0"><a name="line1490"></a>1490
|
|
2091
|
-
</span><span class="marked1"><a name="line1491"></a>1491 def perform
|
|
2092
|
-
</span><span class="uncovered0"><a name="line1492"></a>1492 @result = nil
|
|
2093
|
-
</span><span class="uncovered1"><a name="line1493"></a>1493 @succ = false
|
|
2094
|
-
</span><span class="uncovered0"><a name="line1494"></a>1494 setup_message
|
|
2095
|
-
</span><span class="uncovered1"><a name="line1495"></a>1495
|
|
2096
|
-
</span><span class="uncovered0"><a name="line1496"></a>1496 if $SAFE < @safe_level
|
|
2097
|
-
</span><span class="uncovered1"><a name="line1497"></a>1497 info = Thread.current['DRb']
|
|
2098
|
-
</span><span class="uncovered0"><a name="line1498"></a>1498 if @block
|
|
2099
|
-
</span><span class="uncovered1"><a name="line1499"></a>1499 @result = Thread.new {
|
|
2100
|
-
</span><span class="uncovered0"><a name="line1500"></a>1500 Thread.current['DRb'] = info
|
|
2101
|
-
</span><span class="uncovered1"><a name="line1501"></a>1501 $SAFE = @safe_level
|
|
2102
|
-
</span><span class="uncovered0"><a name="line1502"></a>1502 perform_with_block
|
|
2103
|
-
</span><span class="uncovered1"><a name="line1503"></a>1503 }.value
|
|
2104
|
-
</span><span class="uncovered0"><a name="line1504"></a>1504 else
|
|
2105
|
-
</span><span class="uncovered1"><a name="line1505"></a>1505 @result = Thread.new {
|
|
2106
|
-
</span><span class="uncovered0"><a name="line1506"></a>1506 Thread.current['DRb'] = info
|
|
2107
|
-
</span><span class="uncovered1"><a name="line1507"></a>1507 $SAFE = @safe_level
|
|
2108
|
-
</span><span class="uncovered0"><a name="line1508"></a>1508 perform_without_block
|
|
2109
|
-
</span><span class="uncovered1"><a name="line1509"></a>1509 }.value
|
|
2110
|
-
</span><span class="uncovered0"><a name="line1510"></a>1510 end
|
|
2111
|
-
</span><span class="uncovered1"><a name="line1511"></a>1511 else
|
|
2112
|
-
</span><span class="uncovered0"><a name="line1512"></a>1512 if @block
|
|
2113
|
-
</span><span class="uncovered1"><a name="line1513"></a>1513 @result = perform_with_block
|
|
2114
|
-
</span><span class="uncovered0"><a name="line1514"></a>1514 else
|
|
2115
|
-
</span><span class="uncovered1"><a name="line1515"></a>1515 @result = perform_without_block
|
|
2116
|
-
</span><span class="uncovered0"><a name="line1516"></a>1516 end
|
|
2117
|
-
</span><span class="uncovered1"><a name="line1517"></a>1517 end
|
|
2118
|
-
</span><span class="uncovered0"><a name="line1518"></a>1518 @succ = true
|
|
2119
|
-
</span><span class="uncovered1"><a name="line1519"></a>1519 if @msg_id == :to_ary && @result.class == Array
|
|
2120
|
-
</span><span class="uncovered0"><a name="line1520"></a>1520 @result = DRbArray.new(@result)
|
|
2121
|
-
</span><span class="uncovered1"><a name="line1521"></a>1521 end
|
|
2122
|
-
</span><span class="uncovered0"><a name="line1522"></a>1522 return @succ, @result
|
|
2123
|
-
</span><span class="uncovered1"><a name="line1523"></a>1523 rescue StandardError, ScriptError, Interrupt
|
|
2124
|
-
</span><span class="uncovered0"><a name="line1524"></a>1524 @result = $!
|
|
2125
|
-
</span><span class="uncovered1"><a name="line1525"></a>1525 return @succ, @result
|
|
2126
|
-
</span><span class="uncovered0"><a name="line1526"></a>1526 end
|
|
2127
|
-
</span><span class="inferred1"><a name="line1527"></a>1527
|
|
2128
|
-
</span><span class="marked0"><a name="line1528"></a>1528 private
|
|
2129
|
-
</span><span class="marked1"><a name="line1529"></a>1529 def init_with_client
|
|
2130
|
-
</span><span class="uncovered0"><a name="line1530"></a>1530 obj, msg, argv, block = @client.recv_request
|
|
2131
|
-
</span><span class="uncovered1"><a name="line1531"></a>1531 @obj = obj
|
|
2132
|
-
</span><span class="uncovered0"><a name="line1532"></a>1532 @msg_id = msg.intern
|
|
2133
|
-
</span><span class="uncovered1"><a name="line1533"></a>1533 @argv = argv
|
|
2134
|
-
</span><span class="uncovered0"><a name="line1534"></a>1534 @block = block
|
|
2135
|
-
</span><span class="uncovered1"><a name="line1535"></a>1535 end
|
|
2136
|
-
</span><span class="inferred0"><a name="line1536"></a>1536
|
|
2137
|
-
</span><span class="marked1"><a name="line1537"></a>1537 def check_insecure_method
|
|
2138
|
-
</span><span class="uncovered0"><a name="line1538"></a>1538 @drb_server.check_insecure_method(@obj, @msg_id)
|
|
2139
|
-
</span><span class="uncovered1"><a name="line1539"></a>1539 end
|
|
2140
|
-
</span><span class="inferred0"><a name="line1540"></a>1540
|
|
2141
|
-
</span><span class="marked1"><a name="line1541"></a>1541 def setup_message
|
|
2142
|
-
</span><span class="uncovered0"><a name="line1542"></a>1542 init_with_client
|
|
2143
|
-
</span><span class="uncovered1"><a name="line1543"></a>1543 check_insecure_method
|
|
2144
|
-
</span><span class="uncovered0"><a name="line1544"></a>1544 end
|
|
2145
|
-
</span><span class="inferred1"><a name="line1545"></a>1545
|
|
2146
|
-
</span><span class="marked0"><a name="line1546"></a>1546 def perform_without_block
|
|
2147
|
-
</span><span class="uncovered1"><a name="line1547"></a>1547 if Proc === @obj && @msg_id == :__drb_yield
|
|
2148
|
-
</span><span class="uncovered0"><a name="line1548"></a>1548 if @argv.size == 1
|
|
2149
|
-
</span><span class="uncovered1"><a name="line1549"></a>1549 ary = @argv
|
|
2150
|
-
</span><span class="uncovered0"><a name="line1550"></a>1550 else
|
|
2151
|
-
</span><span class="uncovered1"><a name="line1551"></a>1551 ary = [@argv]
|
|
2152
|
-
</span><span class="uncovered0"><a name="line1552"></a>1552 end
|
|
2153
|
-
</span><span class="uncovered1"><a name="line1553"></a>1553 ary.collect(&@obj)[0]
|
|
2154
|
-
</span><span class="uncovered0"><a name="line1554"></a>1554 else
|
|
2155
|
-
</span><span class="uncovered1"><a name="line1555"></a>1555 @obj.__send__(@msg_id, *@argv)
|
|
2156
|
-
</span><span class="uncovered0"><a name="line1556"></a>1556 end
|
|
2157
|
-
</span><span class="uncovered1"><a name="line1557"></a>1557 end
|
|
2158
|
-
</span><span class="uncovered0"><a name="line1558"></a>1558
|
|
2159
|
-
</span><span class="uncovered1"><a name="line1559"></a>1559 end
|
|
2160
|
-
</span><span class="inferred0"><a name="line1560"></a>1560
|
|
2161
|
-
</span><span class="marked1"><a name="line1561"></a>1561 if RUBY_VERSION >= '1.8'
|
|
2162
|
-
</span><span class="marked0"><a name="line1562"></a>1562 require 'drb/invokemethod'
|
|
2163
|
-
</span><span class="marked1"><a name="line1563"></a>1563 class InvokeMethod
|
|
2164
|
-
</span><span class="marked0"><a name="line1564"></a>1564 include InvokeMethod18Mixin
|
|
2165
|
-
</span><span class="inferred1"><a name="line1565"></a>1565 end
|
|
2166
|
-
</span><span class="uncovered0"><a name="line1566"></a>1566 else
|
|
2167
|
-
</span><span class="uncovered1"><a name="line1567"></a>1567 require 'drb/invokemethod16'
|
|
2168
|
-
</span><span class="uncovered0"><a name="line1568"></a>1568 class InvokeMethod
|
|
2169
|
-
</span><span class="uncovered1"><a name="line1569"></a>1569 include InvokeMethod16Mixin
|
|
2170
|
-
</span><span class="uncovered0"><a name="line1570"></a>1570 end
|
|
2171
|
-
</span><span class="uncovered1"><a name="line1571"></a>1571 end
|
|
2172
|
-
</span><span class="inferred0"><a name="line1572"></a>1572
|
|
2173
|
-
</span><span class="inferred1"><a name="line1573"></a>1573 # The main loop performed by a DRbServer's internal thread.
|
|
2174
|
-
</span><span class="inferred0"><a name="line1574"></a>1574 #
|
|
2175
|
-
</span><span class="inferred1"><a name="line1575"></a>1575 # Accepts a connection from a client, and starts up its own
|
|
2176
|
-
</span><span class="inferred0"><a name="line1576"></a>1576 # thread to handle it. This thread loops, receiving requests
|
|
2177
|
-
</span><span class="inferred1"><a name="line1577"></a>1577 # from the client, invoking them on a local object, and
|
|
2178
|
-
</span><span class="inferred0"><a name="line1578"></a>1578 # returning responses, until the client closes the connection
|
|
2179
|
-
</span><span class="inferred1"><a name="line1579"></a>1579 # or a local method call fails.
|
|
2180
|
-
</span><span class="marked0"><a name="line1580"></a>1580 def main_loop
|
|
2181
|
-
</span><span class="uncovered1"><a name="line1581"></a>1581 Thread.start(@protocol.accept) do |client|
|
|
2182
|
-
</span><span class="uncovered0"><a name="line1582"></a>1582 @grp.add Thread.current
|
|
2183
|
-
</span><span class="uncovered1"><a name="line1583"></a>1583 Thread.current['DRb'] = { 'client' => client ,
|
|
2184
|
-
</span><span class="uncovered0"><a name="line1584"></a>1584 'server' => self }
|
|
2185
|
-
</span><span class="uncovered1"><a name="line1585"></a>1585 loop do
|
|
2186
|
-
</span><span class="uncovered0"><a name="line1586"></a>1586 begin
|
|
2187
|
-
</span><span class="uncovered1"><a name="line1587"></a>1587 succ = false
|
|
2188
|
-
</span><span class="uncovered0"><a name="line1588"></a>1588 invoke_method = InvokeMethod.new(self, client)
|
|
2189
|
-
</span><span class="uncovered1"><a name="line1589"></a>1589 succ, result = invoke_method.perform
|
|
2190
|
-
</span><span class="uncovered0"><a name="line1590"></a>1590 if !succ && verbose
|
|
2191
|
-
</span><span class="uncovered1"><a name="line1591"></a>1591 p result
|
|
2192
|
-
</span><span class="uncovered0"><a name="line1592"></a>1592 result.backtrace.each do |x|
|
|
2193
|
-
</span><span class="uncovered1"><a name="line1593"></a>1593 puts x
|
|
2194
|
-
</span><span class="uncovered0"><a name="line1594"></a>1594 end
|
|
2195
|
-
</span><span class="uncovered1"><a name="line1595"></a>1595 end
|
|
2196
|
-
</span><span class="uncovered0"><a name="line1596"></a>1596 client.send_reply(succ, result) rescue nil
|
|
2197
|
-
</span><span class="uncovered1"><a name="line1597"></a>1597 ensure
|
|
2198
|
-
</span><span class="uncovered0"><a name="line1598"></a>1598 client.close unless succ
|
|
2199
|
-
</span><span class="uncovered1"><a name="line1599"></a>1599 if Thread.current['DRb']['stop_service']
|
|
2200
|
-
</span><span class="uncovered0"><a name="line1600"></a>1600 Thread.new { stop_service }
|
|
2201
|
-
</span><span class="uncovered1"><a name="line1601"></a>1601 end
|
|
2202
|
-
</span><span class="uncovered0"><a name="line1602"></a>1602 break unless succ
|
|
2203
|
-
</span><span class="uncovered1"><a name="line1603"></a>1603 end
|
|
2204
|
-
</span><span class="uncovered0"><a name="line1604"></a>1604 end
|
|
2205
|
-
</span><span class="uncovered1"><a name="line1605"></a>1605 end
|
|
2206
|
-
</span><span class="uncovered0"><a name="line1606"></a>1606 end
|
|
2207
|
-
</span><span class="uncovered1"><a name="line1607"></a>1607 end
|
|
2208
|
-
</span><span class="inferred0"><a name="line1608"></a>1608
|
|
2209
|
-
</span><span class="marked1"><a name="line1609"></a>1609 @primary_server = nil
|
|
2210
|
-
</span><span class="inferred0"><a name="line1610"></a>1610
|
|
2211
|
-
</span><span class="inferred1"><a name="line1611"></a>1611 # Start a dRuby server locally.
|
|
2212
|
-
</span><span class="inferred0"><a name="line1612"></a>1612 #
|
|
2213
|
-
</span><span class="inferred1"><a name="line1613"></a>1613 # The new dRuby server will become the primary server, even
|
|
2214
|
-
</span><span class="inferred0"><a name="line1614"></a>1614 # if another server is currently the primary server.
|
|
2215
|
-
</span><span class="inferred1"><a name="line1615"></a>1615 #
|
|
2216
|
-
</span><span class="inferred0"><a name="line1616"></a>1616 # +uri+ is the URI for the server to bind to. If nil,
|
|
2217
|
-
</span><span class="inferred1"><a name="line1617"></a>1617 # the server will bind to random port on the default local host
|
|
2218
|
-
</span><span class="inferred0"><a name="line1618"></a>1618 # name and use the default dRuby protocol.
|
|
2219
|
-
</span><span class="inferred1"><a name="line1619"></a>1619 #
|
|
2220
|
-
</span><span class="inferred0"><a name="line1620"></a>1620 # +front+ is the server's front object. This may be nil.
|
|
2221
|
-
</span><span class="inferred1"><a name="line1621"></a>1621 #
|
|
2222
|
-
</span><span class="inferred0"><a name="line1622"></a>1622 # +config+ is the configuration for the new server. This may
|
|
2223
|
-
</span><span class="inferred1"><a name="line1623"></a>1623 # be nil.
|
|
2224
|
-
</span><span class="inferred0"><a name="line1624"></a>1624 #
|
|
2225
|
-
</span><span class="inferred1"><a name="line1625"></a>1625 # See DRbServer::new.
|
|
2226
|
-
</span><span class="marked0"><a name="line1626"></a>1626 def start_service(uri=nil, front=nil, config=nil)
|
|
2227
|
-
</span><span class="uncovered1"><a name="line1627"></a>1627 @primary_server = DRbServer.new(uri, front, config)
|
|
2228
|
-
</span><span class="uncovered0"><a name="line1628"></a>1628 end
|
|
2229
|
-
</span><span class="marked1"><a name="line1629"></a>1629 module_function :start_service
|
|
2230
|
-
</span><span class="inferred0"><a name="line1630"></a>1630
|
|
2231
|
-
</span><span class="inferred1"><a name="line1631"></a>1631 # The primary local dRuby server.
|
|
2232
|
-
</span><span class="inferred0"><a name="line1632"></a>1632 #
|
|
2233
|
-
</span><span class="inferred1"><a name="line1633"></a>1633 # This is the server created by the #start_service call.
|
|
2234
|
-
</span><span class="marked0"><a name="line1634"></a>1634 attr_accessor :primary_server
|
|
2235
|
-
</span><span class="marked1"><a name="line1635"></a>1635 module_function :primary_server=, :primary_server
|
|
2236
|
-
</span><span class="inferred0"><a name="line1636"></a>1636
|
|
2237
|
-
</span><span class="inferred1"><a name="line1637"></a>1637 # Get the 'current' server.
|
|
2238
|
-
</span><span class="inferred0"><a name="line1638"></a>1638 #
|
|
2239
|
-
</span><span class="inferred1"><a name="line1639"></a>1639 # In the context of execution taking place within the main
|
|
2240
|
-
</span><span class="inferred0"><a name="line1640"></a>1640 # thread of a dRuby server (typically, as a result of a remote
|
|
2241
|
-
</span><span class="inferred1"><a name="line1641"></a>1641 # call on the server or one of its objects), the current
|
|
2242
|
-
</span><span class="inferred0"><a name="line1642"></a>1642 # server is that server. Otherwise, the current server is
|
|
2243
|
-
</span><span class="inferred1"><a name="line1643"></a>1643 # the primary server.
|
|
2244
|
-
</span><span class="inferred0"><a name="line1644"></a>1644 #
|
|
2245
|
-
</span><span class="inferred1"><a name="line1645"></a>1645 # If the above rule fails to find a server, a DRbServerNotFound
|
|
2246
|
-
</span><span class="inferred0"><a name="line1646"></a>1646 # error is raised.
|
|
2247
|
-
</span><span class="marked1"><a name="line1647"></a>1647 def current_server
|
|
2248
|
-
</span><span class="uncovered0"><a name="line1648"></a>1648 drb = Thread.current['DRb']
|
|
2249
|
-
</span><span class="uncovered1"><a name="line1649"></a>1649 server = (drb && drb['server']) ? drb['server'] : @primary_server
|
|
2250
|
-
</span><span class="uncovered0"><a name="line1650"></a>1650 raise DRbServerNotFound unless server
|
|
2251
|
-
</span><span class="uncovered1"><a name="line1651"></a>1651 return server
|
|
2252
|
-
</span><span class="uncovered0"><a name="line1652"></a>1652 end
|
|
2253
|
-
</span><span class="marked1"><a name="line1653"></a>1653 module_function :current_server
|
|
2254
|
-
</span><span class="inferred0"><a name="line1654"></a>1654
|
|
2255
|
-
</span><span class="inferred1"><a name="line1655"></a>1655 # Stop the local dRuby server.
|
|
2256
|
-
</span><span class="inferred0"><a name="line1656"></a>1656 #
|
|
2257
|
-
</span><span class="inferred1"><a name="line1657"></a>1657 # This operates on the primary server. If there is no primary
|
|
2258
|
-
</span><span class="inferred0"><a name="line1658"></a>1658 # server currently running, it is a noop.
|
|
2259
|
-
</span><span class="marked1"><a name="line1659"></a>1659 def stop_service
|
|
2260
|
-
</span><span class="uncovered0"><a name="line1660"></a>1660 @primary_server.stop_service if @primary_server
|
|
2261
|
-
</span><span class="uncovered1"><a name="line1661"></a>1661 @primary_server = nil
|
|
2262
|
-
</span><span class="uncovered0"><a name="line1662"></a>1662 end
|
|
2263
|
-
</span><span class="marked1"><a name="line1663"></a>1663 module_function :stop_service
|
|
2264
|
-
</span><span class="inferred0"><a name="line1664"></a>1664
|
|
2265
|
-
</span><span class="inferred1"><a name="line1665"></a>1665 # Get the URI defining the local dRuby space.
|
|
2266
|
-
</span><span class="inferred0"><a name="line1666"></a>1666 #
|
|
2267
|
-
</span><span class="inferred1"><a name="line1667"></a>1667 # This is the URI of the current server. See #current_server.
|
|
2268
|
-
</span><span class="marked0"><a name="line1668"></a>1668 def uri
|
|
2269
|
-
</span><span class="uncovered1"><a name="line1669"></a>1669 current_server.uri
|
|
2270
|
-
</span><span class="uncovered0"><a name="line1670"></a>1670 end
|
|
2271
|
-
</span><span class="marked1"><a name="line1671"></a>1671 module_function :uri
|
|
2272
|
-
</span><span class="inferred0"><a name="line1672"></a>1672
|
|
2273
|
-
</span><span class="inferred1"><a name="line1673"></a>1673 # Is +uri+ the URI for the current local server?
|
|
2274
|
-
</span><span class="marked0"><a name="line1674"></a>1674 def here?(uri)
|
|
2275
|
-
</span><span class="uncovered1"><a name="line1675"></a>1675 (current_server.uri rescue nil) == uri
|
|
2276
|
-
</span><span class="uncovered0"><a name="line1676"></a>1676 end
|
|
2277
|
-
</span><span class="marked1"><a name="line1677"></a>1677 module_function :here?
|
|
2278
|
-
</span><span class="inferred0"><a name="line1678"></a>1678
|
|
2279
|
-
</span><span class="inferred1"><a name="line1679"></a>1679 # Get the configuration of the current server.
|
|
2280
|
-
</span><span class="inferred0"><a name="line1680"></a>1680 #
|
|
2281
|
-
</span><span class="inferred1"><a name="line1681"></a>1681 # If there is no current server, this returns the default configuration.
|
|
2282
|
-
</span><span class="inferred0"><a name="line1682"></a>1682 # See #current_server and DRbServer::make_config.
|
|
2283
|
-
</span><span class="marked1"><a name="line1683"></a>1683 def config
|
|
2284
|
-
</span><span class="uncovered0"><a name="line1684"></a>1684 current_server.config
|
|
2285
|
-
</span><span class="uncovered1"><a name="line1685"></a>1685 rescue
|
|
2286
|
-
</span><span class="uncovered0"><a name="line1686"></a>1686 DRbServer.make_config
|
|
2287
|
-
</span><span class="uncovered1"><a name="line1687"></a>1687 end
|
|
2288
|
-
</span><span class="marked0"><a name="line1688"></a>1688 module_function :config
|
|
2289
|
-
</span><span class="inferred1"><a name="line1689"></a>1689
|
|
2290
|
-
</span><span class="inferred0"><a name="line1690"></a>1690 # Get the front object of the current server.
|
|
2291
|
-
</span><span class="inferred1"><a name="line1691"></a>1691 #
|
|
2292
|
-
</span><span class="inferred0"><a name="line1692"></a>1692 # This raises a DRbServerNotFound error if there is no current server.
|
|
2293
|
-
</span><span class="inferred1"><a name="line1693"></a>1693 # See #current_server.
|
|
2294
|
-
</span><span class="marked0"><a name="line1694"></a>1694 def front
|
|
2295
|
-
</span><span class="uncovered1"><a name="line1695"></a>1695 current_server.front
|
|
2296
|
-
</span><span class="uncovered0"><a name="line1696"></a>1696 end
|
|
2297
|
-
</span><span class="marked1"><a name="line1697"></a>1697 module_function :front
|
|
2298
|
-
</span><span class="inferred0"><a name="line1698"></a>1698
|
|
2299
|
-
</span><span class="inferred1"><a name="line1699"></a>1699 # Convert a reference into an object using the current server.
|
|
2300
|
-
</span><span class="inferred0"><a name="line1700"></a>1700 #
|
|
2301
|
-
</span><span class="inferred1"><a name="line1701"></a>1701 # This raises a DRbServerNotFound error if there is no current server.
|
|
2302
|
-
</span><span class="inferred0"><a name="line1702"></a>1702 # See #current_server.
|
|
2303
|
-
</span><span class="marked1"><a name="line1703"></a>1703 def to_obj(ref)
|
|
2304
|
-
</span><span class="uncovered0"><a name="line1704"></a>1704 current_server.to_obj(ref)
|
|
2305
|
-
</span><span class="uncovered1"><a name="line1705"></a>1705 end
|
|
2306
|
-
</span><span class="inferred0"><a name="line1706"></a>1706
|
|
2307
|
-
</span><span class="inferred1"><a name="line1707"></a>1707 # Get a reference id for an object using the current server.
|
|
2308
|
-
</span><span class="inferred0"><a name="line1708"></a>1708 #
|
|
2309
|
-
</span><span class="inferred1"><a name="line1709"></a>1709 # This raises a DRbServerNotFound error if there is no current server.
|
|
2310
|
-
</span><span class="inferred0"><a name="line1710"></a>1710 # See #current_server.
|
|
2311
|
-
</span><span class="marked1"><a name="line1711"></a>1711 def to_id(obj)
|
|
2312
|
-
</span><span class="uncovered0"><a name="line1712"></a>1712 current_server.to_id(obj)
|
|
2313
|
-
</span><span class="uncovered1"><a name="line1713"></a>1713 end
|
|
2314
|
-
</span><span class="marked0"><a name="line1714"></a>1714 module_function :to_id
|
|
2315
|
-
</span><span class="marked1"><a name="line1715"></a>1715 module_function :to_obj
|
|
2316
|
-
</span><span class="inferred0"><a name="line1716"></a>1716
|
|
2317
|
-
</span><span class="inferred1"><a name="line1717"></a>1717 # Get the thread of the primary server.
|
|
2318
|
-
</span><span class="inferred0"><a name="line1718"></a>1718 #
|
|
2319
|
-
</span><span class="inferred1"><a name="line1719"></a>1719 # This returns nil if there is no primary server. See #primary_server.
|
|
2320
|
-
</span><span class="marked0"><a name="line1720"></a>1720 def thread
|
|
2321
|
-
</span><span class="uncovered1"><a name="line1721"></a>1721 @primary_server ? @primary_server.thread : nil
|
|
2322
|
-
</span><span class="uncovered0"><a name="line1722"></a>1722 end
|
|
2323
|
-
</span><span class="marked1"><a name="line1723"></a>1723 module_function :thread
|
|
2324
|
-
</span><span class="inferred0"><a name="line1724"></a>1724
|
|
2325
|
-
</span><span class="inferred1"><a name="line1725"></a>1725 # Set the default id conv object.
|
|
2326
|
-
</span><span class="inferred0"><a name="line1726"></a>1726 #
|
|
2327
|
-
</span><span class="inferred1"><a name="line1727"></a>1727 # See DRbServer#default_id_conv.
|
|
2328
|
-
</span><span class="marked0"><a name="line1728"></a>1728 def install_id_conv(idconv)
|
|
2329
|
-
</span><span class="uncovered1"><a name="line1729"></a>1729 DRbServer.default_id_conv(idconv)
|
|
2330
|
-
</span><span class="uncovered0"><a name="line1730"></a>1730 end
|
|
2331
|
-
</span><span class="marked1"><a name="line1731"></a>1731 module_function :install_id_conv
|
|
2332
|
-
</span><span class="inferred0"><a name="line1732"></a>1732
|
|
2333
|
-
</span><span class="inferred1"><a name="line1733"></a>1733 # Set the default acl.
|
|
2334
|
-
</span><span class="inferred0"><a name="line1734"></a>1734 #
|
|
2335
|
-
</span><span class="inferred1"><a name="line1735"></a>1735 # See DRb::DRbServer.default_acl.
|
|
2336
|
-
</span><span class="marked0"><a name="line1736"></a>1736 def install_acl(acl)
|
|
2337
|
-
</span><span class="uncovered1"><a name="line1737"></a>1737 DRbServer.default_acl(acl)
|
|
2338
|
-
</span><span class="uncovered0"><a name="line1738"></a>1738 end
|
|
2339
|
-
</span><span class="marked1"><a name="line1739"></a>1739 module_function :install_acl
|
|
2340
|
-
</span><span class="inferred0"><a name="line1740"></a>1740
|
|
2341
|
-
</span><span class="marked1"><a name="line1741"></a>1741 @server = {}
|
|
2342
|
-
</span><span class="marked0"><a name="line1742"></a>1742 def regist_server(server)
|
|
2343
|
-
</span><span class="uncovered1"><a name="line1743"></a>1743 @server[server.uri] = server
|
|
2344
|
-
</span><span class="uncovered0"><a name="line1744"></a>1744 Thread.exclusive do
|
|
2345
|
-
</span><span class="uncovered1"><a name="line1745"></a>1745 @primary_server = server unless @primary_server
|
|
2346
|
-
</span><span class="uncovered0"><a name="line1746"></a>1746 end
|
|
2347
|
-
</span><span class="uncovered1"><a name="line1747"></a>1747 end
|
|
2348
|
-
</span><span class="marked0"><a name="line1748"></a>1748 module_function :regist_server
|
|
2349
|
-
</span><span class="inferred1"><a name="line1749"></a>1749
|
|
2350
|
-
</span><span class="marked0"><a name="line1750"></a>1750 def remove_server(server)
|
|
2351
|
-
</span><span class="uncovered1"><a name="line1751"></a>1751 @server.delete(server.uri)
|
|
2352
|
-
</span><span class="uncovered0"><a name="line1752"></a>1752 end
|
|
2353
|
-
</span><span class="marked1"><a name="line1753"></a>1753 module_function :remove_server
|
|
2354
|
-
</span><span class="inferred0"><a name="line1754"></a>1754
|
|
2355
|
-
</span><span class="marked1"><a name="line1755"></a>1755 def fetch_server(uri)
|
|
2356
|
-
</span><span class="uncovered0"><a name="line1756"></a>1756 @server[uri]
|
|
2357
|
-
</span><span class="uncovered1"><a name="line1757"></a>1757 end
|
|
2358
|
-
</span><span class="marked0"><a name="line1758"></a>1758 module_function :fetch_server
|
|
2359
|
-
</span><span class="inferred1"><a name="line1759"></a>1759 end
|
|
2360
|
-
</span><span class="inferred0"><a name="line1760"></a>1760
|
|
2361
|
-
</span><span class="marked1"><a name="line1761"></a>1761 DRbObject = DRb::DRbObject
|
|
2362
|
-
</span><span class="marked0"><a name="line1762"></a>1762 DRbUndumped = DRb::DRbUndumped
|
|
2363
|
-
</span><span class="marked1"><a name="line1763"></a>1763 DRbIdConv = DRb::DRbIdConv
|
|
2364
|
-
</span></pre><hr/>
|
|
2365
|
-
<p>Generated using the <a href='http://eigenclass.org/hiki.rb?rcov'>rcov code coverage analysis tool for Ruby</a>
|
|
2366
|
-
version 0.8.1.2.</p>
|
|
2367
|
-
<p><a href='http://validator.w3.org/check/referer'><img src='http://www.w3.org/Icons/valid-xhtml10' height='31' alt='Valid XHTML 1.0!' width='88'/>
|
|
2368
|
-
</a>
|
|
2369
|
-
<a href='http://jigsaw.w3.org/css-validator/check/referer'><img src='http://jigsaw.w3.org/css-validator/images/vcss' alt='Valid CSS!' style='border:0;width:88px;height:31px'/>
|
|
2370
|
-
</a>
|
|
2371
|
-
</p>
|
|
2372
|
-
</body>
|
|
2373
|
-
</html>
|