em-websocket 0.3.7 → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG.rdoc +52 -0
  3. data/Gemfile +6 -0
  4. data/LICENCE +7 -0
  5. data/README.md +105 -40
  6. data/examples/echo.rb +22 -6
  7. data/examples/test.html +5 -6
  8. data/lib/em-websocket.rb +2 -1
  9. data/lib/em-websocket/close03.rb +3 -0
  10. data/lib/em-websocket/close05.rb +3 -0
  11. data/lib/em-websocket/close06.rb +3 -0
  12. data/lib/em-websocket/close75.rb +2 -1
  13. data/lib/em-websocket/connection.rb +154 -48
  14. data/lib/em-websocket/framing03.rb +3 -2
  15. data/lib/em-websocket/framing05.rb +3 -2
  16. data/lib/em-websocket/framing07.rb +16 -4
  17. data/lib/em-websocket/framing76.rb +1 -4
  18. data/lib/em-websocket/handler.rb +61 -15
  19. data/lib/em-websocket/handler03.rb +0 -1
  20. data/lib/em-websocket/handler05.rb +0 -1
  21. data/lib/em-websocket/handler06.rb +0 -1
  22. data/lib/em-websocket/handler07.rb +0 -1
  23. data/lib/em-websocket/handler08.rb +0 -1
  24. data/lib/em-websocket/handler13.rb +0 -1
  25. data/lib/em-websocket/handler76.rb +2 -0
  26. data/lib/em-websocket/handshake.rb +156 -0
  27. data/lib/em-websocket/handshake04.rb +18 -16
  28. data/lib/em-websocket/handshake75.rb +15 -8
  29. data/lib/em-websocket/handshake76.rb +15 -14
  30. data/lib/em-websocket/masking04.rb +3 -6
  31. data/lib/em-websocket/message_processor_03.rb +6 -3
  32. data/lib/em-websocket/message_processor_06.rb +30 -9
  33. data/lib/em-websocket/version.rb +1 -1
  34. data/lib/em-websocket/websocket.rb +24 -15
  35. data/spec/helper.rb +84 -51
  36. data/spec/integration/common_spec.rb +89 -69
  37. data/spec/integration/draft03_spec.rb +84 -56
  38. data/spec/integration/draft05_spec.rb +14 -12
  39. data/spec/integration/draft06_spec.rb +67 -7
  40. data/spec/integration/draft13_spec.rb +30 -19
  41. data/spec/integration/draft75_spec.rb +46 -40
  42. data/spec/integration/draft76_spec.rb +59 -45
  43. data/spec/integration/gte_03_examples.rb +42 -0
  44. data/spec/integration/shared_examples.rb +119 -0
  45. data/spec/unit/framing_spec.rb +24 -4
  46. data/spec/unit/handshake_spec.rb +216 -0
  47. data/spec/unit/masking_spec.rb +2 -0
  48. metadata +32 -86
  49. data/examples/flash_policy_file_server.rb +0 -21
  50. data/examples/js/FABridge.js +0 -604
  51. data/examples/js/WebSocketMain.swf +0 -0
  52. data/examples/js/swfobject.js +0 -4
  53. data/examples/js/web_socket.js +0 -312
  54. data/lib/em-websocket/handler_factory.rb +0 -109
  55. data/spec/unit/handler_spec.rb +0 -159
metadata CHANGED
@@ -1,94 +1,44 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: em-websocket
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.3.7
5
- prerelease:
4
+ version: 0.5.2
6
5
  platform: ruby
7
6
  authors:
8
7
  - Ilya Grigorik
9
8
  - Martyn Loughran
10
- autorequire:
9
+ autorequire:
11
10
  bindir: bin
12
11
  cert_chain: []
13
- date: 2012-07-11 00:00:00.000000000 Z
12
+ date: 2020-09-23 00:00:00.000000000 Z
14
13
  dependencies:
15
14
  - !ruby/object:Gem::Dependency
16
15
  name: eventmachine
17
- requirement: &70199777824640 !ruby/object:Gem::Requirement
18
- none: false
16
+ requirement: !ruby/object:Gem::Requirement
19
17
  requirements:
20
- - - ! '>='
18
+ - - ">="
21
19
  - !ruby/object:Gem::Version
22
20
  version: 0.12.9
23
21
  type: :runtime
24
22
  prerelease: false
25
- version_requirements: *70199777824640
26
- - !ruby/object:Gem::Dependency
27
- name: addressable
28
- requirement: &70199777824040 !ruby/object:Gem::Requirement
29
- none: false
30
- requirements:
31
- - - ! '>='
32
- - !ruby/object:Gem::Version
33
- version: 2.1.1
34
- type: :runtime
35
- prerelease: false
36
- version_requirements: *70199777824040
37
- - !ruby/object:Gem::Dependency
38
- name: em-spec
39
- requirement: &70199777823420 !ruby/object:Gem::Requirement
40
- none: false
41
- requirements:
42
- - - ~>
43
- - !ruby/object:Gem::Version
44
- version: 0.2.6
45
- type: :development
46
- prerelease: false
47
- version_requirements: *70199777823420
48
- - !ruby/object:Gem::Dependency
49
- name: eventmachine
50
- requirement: &70199777822580 !ruby/object:Gem::Requirement
51
- none: false
52
- requirements:
53
- - - ~>
54
- - !ruby/object:Gem::Version
55
- version: 0.12.10
56
- type: :development
57
- prerelease: false
58
- version_requirements: *70199777822580
59
- - !ruby/object:Gem::Dependency
60
- name: em-http-request
61
- requirement: &70199777821520 !ruby/object:Gem::Requirement
62
- none: false
23
+ version_requirements: !ruby/object:Gem::Requirement
63
24
  requirements:
64
- - - ~>
25
+ - - ">="
65
26
  - !ruby/object:Gem::Version
66
- version: 0.2.6
67
- type: :development
68
- prerelease: false
69
- version_requirements: *70199777821520
27
+ version: 0.12.9
70
28
  - !ruby/object:Gem::Dependency
71
- name: rspec
72
- requirement: &70199777818940 !ruby/object:Gem::Requirement
73
- none: false
29
+ name: http_parser.rb
30
+ requirement: !ruby/object:Gem::Requirement
74
31
  requirements:
75
- - - ~>
32
+ - - "~>"
76
33
  - !ruby/object:Gem::Version
77
- version: 2.8.0
78
- type: :development
34
+ version: 0.6.0
35
+ type: :runtime
79
36
  prerelease: false
80
- version_requirements: *70199777818940
81
- - !ruby/object:Gem::Dependency
82
- name: rake
83
- requirement: &70199777817860 !ruby/object:Gem::Requirement
84
- none: false
37
+ version_requirements: !ruby/object:Gem::Requirement
85
38
  requirements:
86
- - - ! '>='
39
+ - - "~>"
87
40
  - !ruby/object:Gem::Version
88
- version: '0'
89
- type: :development
90
- prerelease: false
91
- version_requirements: *70199777817860
41
+ version: 0.6.0
92
42
  description: EventMachine based WebSocket server
93
43
  email:
94
44
  - ilya@igvita.com
@@ -97,18 +47,14 @@ executables: []
97
47
  extensions: []
98
48
  extra_rdoc_files: []
99
49
  files:
100
- - .gitignore
50
+ - ".gitignore"
101
51
  - CHANGELOG.rdoc
102
52
  - Gemfile
53
+ - LICENCE
103
54
  - README.md
104
55
  - Rakefile
105
56
  - em-websocket.gemspec
106
57
  - examples/echo.rb
107
- - examples/flash_policy_file_server.rb
108
- - examples/js/FABridge.js
109
- - examples/js/WebSocketMain.swf
110
- - examples/js/swfobject.js
111
- - examples/js/web_socket.js
112
58
  - examples/multicast.rb
113
59
  - examples/ping.rb
114
60
  - examples/test.html
@@ -133,7 +79,7 @@ files:
133
79
  - lib/em-websocket/handler13.rb
134
80
  - lib/em-websocket/handler75.rb
135
81
  - lib/em-websocket/handler76.rb
136
- - lib/em-websocket/handler_factory.rb
82
+ - lib/em-websocket/handshake.rb
137
83
  - lib/em-websocket/handshake04.rb
138
84
  - lib/em-websocket/handshake75.rb
139
85
  - lib/em-websocket/handshake76.rb
@@ -150,33 +96,33 @@ files:
150
96
  - spec/integration/draft13_spec.rb
151
97
  - spec/integration/draft75_spec.rb
152
98
  - spec/integration/draft76_spec.rb
99
+ - spec/integration/gte_03_examples.rb
153
100
  - spec/integration/shared_examples.rb
154
101
  - spec/unit/framing_spec.rb
155
- - spec/unit/handler_spec.rb
102
+ - spec/unit/handshake_spec.rb
156
103
  - spec/unit/masking_spec.rb
157
104
  homepage: http://github.com/igrigorik/em-websocket
158
- licenses: []
159
- post_install_message:
105
+ licenses:
106
+ - MIT
107
+ metadata: {}
108
+ post_install_message:
160
109
  rdoc_options: []
161
110
  require_paths:
162
111
  - lib
163
112
  required_ruby_version: !ruby/object:Gem::Requirement
164
- none: false
165
113
  requirements:
166
- - - ! '>='
114
+ - - ">="
167
115
  - !ruby/object:Gem::Version
168
116
  version: '0'
169
117
  required_rubygems_version: !ruby/object:Gem::Requirement
170
- none: false
171
118
  requirements:
172
- - - ! '>='
119
+ - - ">="
173
120
  - !ruby/object:Gem::Version
174
121
  version: '0'
175
122
  requirements: []
176
- rubyforge_project: em-websocket
177
- rubygems_version: 1.8.10
178
- signing_key:
179
- specification_version: 3
123
+ rubygems_version: 3.0.3
124
+ signing_key:
125
+ specification_version: 4
180
126
  summary: EventMachine based WebSocket server
181
127
  test_files:
182
128
  - spec/helper.rb
@@ -187,8 +133,8 @@ test_files:
187
133
  - spec/integration/draft13_spec.rb
188
134
  - spec/integration/draft75_spec.rb
189
135
  - spec/integration/draft76_spec.rb
136
+ - spec/integration/gte_03_examples.rb
190
137
  - spec/integration/shared_examples.rb
191
138
  - spec/unit/framing_spec.rb
192
- - spec/unit/handler_spec.rb
139
+ - spec/unit/handshake_spec.rb
193
140
  - spec/unit/masking_spec.rb
194
- has_rdoc:
@@ -1,21 +0,0 @@
1
- # Super simple flash policy file server
2
- # See https://github.com/igrigorik/em-websocket/issues/61
3
-
4
- require 'eventmachine'
5
-
6
- module FlashPolicy
7
- def post_init
8
- cross_domain_xml =<<-EOF
9
- <cross-domain-policy>
10
- <allow-access-from domain="*" to-ports="*" />
11
- </cross-domain-policy>
12
- EOF
13
-
14
- send_data cross_domain_xml
15
- close_connection_after_writing
16
- end
17
- end
18
-
19
- EM.run {
20
- EventMachine::start_server '0.0.0.0', 843, FlashPolicy
21
- }
@@ -1,604 +0,0 @@
1
- /*
2
- /*
3
- Copyright 2006 Adobe Systems Incorporated
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"),
6
- to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
7
- and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
8
-
9
- The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
10
-
11
-
12
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
13
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
14
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
15
- OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
16
-
17
- */
18
-
19
-
20
- /*
21
- * The Bridge class, responsible for navigating AS instances
22
- */
23
- function FABridge(target,bridgeName)
24
- {
25
- this.target = target;
26
- this.remoteTypeCache = {};
27
- this.remoteInstanceCache = {};
28
- this.remoteFunctionCache = {};
29
- this.localFunctionCache = {};
30
- this.bridgeID = FABridge.nextBridgeID++;
31
- this.name = bridgeName;
32
- this.nextLocalFuncID = 0;
33
- FABridge.instances[this.name] = this;
34
- FABridge.idMap[this.bridgeID] = this;
35
-
36
- return this;
37
- }
38
-
39
- // type codes for packed values
40
- FABridge.TYPE_ASINSTANCE = 1;
41
- FABridge.TYPE_ASFUNCTION = 2;
42
-
43
- FABridge.TYPE_JSFUNCTION = 3;
44
- FABridge.TYPE_ANONYMOUS = 4;
45
-
46
- FABridge.initCallbacks = {};
47
- FABridge.userTypes = {};
48
-
49
- FABridge.addToUserTypes = function()
50
- {
51
- for (var i = 0; i < arguments.length; i++)
52
- {
53
- FABridge.userTypes[arguments[i]] = {
54
- 'typeName': arguments[i],
55
- 'enriched': false
56
- };
57
- }
58
- }
59
-
60
- FABridge.argsToArray = function(args)
61
- {
62
- var result = [];
63
- for (var i = 0; i < args.length; i++)
64
- {
65
- result[i] = args[i];
66
- }
67
- return result;
68
- }
69
-
70
- function instanceFactory(objID)
71
- {
72
- this.fb_instance_id = objID;
73
- return this;
74
- }
75
-
76
- function FABridge__invokeJSFunction(args)
77
- {
78
- var funcID = args[0];
79
- var throughArgs = args.concat();//FABridge.argsToArray(arguments);
80
- throughArgs.shift();
81
-
82
- var bridge = FABridge.extractBridgeFromID(funcID);
83
- return bridge.invokeLocalFunction(funcID, throughArgs);
84
- }
85
-
86
- FABridge.addInitializationCallback = function(bridgeName, callback)
87
- {
88
- var inst = FABridge.instances[bridgeName];
89
- if (inst != undefined)
90
- {
91
- callback.call(inst);
92
- return;
93
- }
94
-
95
- var callbackList = FABridge.initCallbacks[bridgeName];
96
- if(callbackList == null)
97
- {
98
- FABridge.initCallbacks[bridgeName] = callbackList = [];
99
- }
100
-
101
- callbackList.push(callback);
102
- }
103
-
104
- // updated for changes to SWFObject2
105
- function FABridge__bridgeInitialized(bridgeName) {
106
- var objects = document.getElementsByTagName("object");
107
- var ol = objects.length;
108
- var activeObjects = [];
109
- if (ol > 0) {
110
- for (var i = 0; i < ol; i++) {
111
- if (typeof objects[i].SetVariable != "undefined") {
112
- activeObjects[activeObjects.length] = objects[i];
113
- }
114
- }
115
- }
116
- var embeds = document.getElementsByTagName("embed");
117
- var el = embeds.length;
118
- var activeEmbeds = [];
119
- if (el > 0) {
120
- for (var j = 0; j < el; j++) {
121
- if (typeof embeds[j].SetVariable != "undefined") {
122
- activeEmbeds[activeEmbeds.length] = embeds[j];
123
- }
124
- }
125
- }
126
- var aol = activeObjects.length;
127
- var ael = activeEmbeds.length;
128
- var searchStr = "bridgeName="+ bridgeName;
129
- if ((aol == 1 && !ael) || (aol == 1 && ael == 1)) {
130
- FABridge.attachBridge(activeObjects[0], bridgeName);
131
- }
132
- else if (ael == 1 && !aol) {
133
- FABridge.attachBridge(activeEmbeds[0], bridgeName);
134
- }
135
- else {
136
- var flash_found = false;
137
- if (aol > 1) {
138
- for (var k = 0; k < aol; k++) {
139
- var params = activeObjects[k].childNodes;
140
- for (var l = 0; l < params.length; l++) {
141
- var param = params[l];
142
- if (param.nodeType == 1 && param.tagName.toLowerCase() == "param" && param["name"].toLowerCase() == "flashvars" && param["value"].indexOf(searchStr) >= 0) {
143
- FABridge.attachBridge(activeObjects[k], bridgeName);
144
- flash_found = true;
145
- break;
146
- }
147
- }
148
- if (flash_found) {
149
- break;
150
- }
151
- }
152
- }
153
- if (!flash_found && ael > 1) {
154
- for (var m = 0; m < ael; m++) {
155
- var flashVars = activeEmbeds[m].attributes.getNamedItem("flashVars").nodeValue;
156
- if (flashVars.indexOf(searchStr) >= 0) {
157
- FABridge.attachBridge(activeEmbeds[m], bridgeName);
158
- break;
159
- }
160
- }
161
- }
162
- }
163
- return true;
164
- }
165
-
166
- // used to track multiple bridge instances, since callbacks from AS are global across the page.
167
-
168
- FABridge.nextBridgeID = 0;
169
- FABridge.instances = {};
170
- FABridge.idMap = {};
171
- FABridge.refCount = 0;
172
-
173
- FABridge.extractBridgeFromID = function(id)
174
- {
175
- var bridgeID = (id >> 16);
176
- return FABridge.idMap[bridgeID];
177
- }
178
-
179
- FABridge.attachBridge = function(instance, bridgeName)
180
- {
181
- var newBridgeInstance = new FABridge(instance, bridgeName);
182
-
183
- FABridge[bridgeName] = newBridgeInstance;
184
-
185
- /* FABridge[bridgeName] = function() {
186
- return newBridgeInstance.root();
187
- }
188
- */
189
- var callbacks = FABridge.initCallbacks[bridgeName];
190
- if (callbacks == null)
191
- {
192
- return;
193
- }
194
- for (var i = 0; i < callbacks.length; i++)
195
- {
196
- callbacks[i].call(newBridgeInstance);
197
- }
198
- delete FABridge.initCallbacks[bridgeName]
199
- }
200
-
201
- // some methods can't be proxied. You can use the explicit get,set, and call methods if necessary.
202
-
203
- FABridge.blockedMethods =
204
- {
205
- toString: true,
206
- get: true,
207
- set: true,
208
- call: true
209
- };
210
-
211
- FABridge.prototype =
212
- {
213
-
214
-
215
- // bootstrapping
216
-
217
- root: function()
218
- {
219
- return this.deserialize(this.target.getRoot());
220
- },
221
- //clears all of the AS objects in the cache maps
222
- releaseASObjects: function()
223
- {
224
- return this.target.releaseASObjects();
225
- },
226
- //clears a specific object in AS from the type maps
227
- releaseNamedASObject: function(value)
228
- {
229
- if(typeof(value) != "object")
230
- {
231
- return false;
232
- }
233
- else
234
- {
235
- var ret = this.target.releaseNamedASObject(value.fb_instance_id);
236
- return ret;
237
- }
238
- },
239
- //create a new AS Object
240
- create: function(className)
241
- {
242
- return this.deserialize(this.target.create(className));
243
- },
244
-
245
-
246
- // utilities
247
-
248
- makeID: function(token)
249
- {
250
- return (this.bridgeID << 16) + token;
251
- },
252
-
253
-
254
- // low level access to the flash object
255
-
256
- //get a named property from an AS object
257
- getPropertyFromAS: function(objRef, propName)
258
- {
259
- if (FABridge.refCount > 0)
260
- {
261
- throw new Error("You are trying to call recursively into the Flash Player which is not allowed. In most cases the JavaScript setTimeout function, can be used as a workaround.");
262
- }
263
- else
264
- {
265
- FABridge.refCount++;
266
- retVal = this.target.getPropFromAS(objRef, propName);
267
- retVal = this.handleError(retVal);
268
- FABridge.refCount--;
269
- return retVal;
270
- }
271
- },
272
- //set a named property on an AS object
273
- setPropertyInAS: function(objRef,propName, value)
274
- {
275
- if (FABridge.refCount > 0)
276
- {
277
- throw new Error("You are trying to call recursively into the Flash Player which is not allowed. In most cases the JavaScript setTimeout function, can be used as a workaround.");
278
- }
279
- else
280
- {
281
- FABridge.refCount++;
282
- retVal = this.target.setPropInAS(objRef,propName, this.serialize(value));
283
- retVal = this.handleError(retVal);
284
- FABridge.refCount--;
285
- return retVal;
286
- }
287
- },
288
-
289
- //call an AS function
290
- callASFunction: function(funcID, args)
291
- {
292
- if (FABridge.refCount > 0)
293
- {
294
- throw new Error("You are trying to call recursively into the Flash Player which is not allowed. In most cases the JavaScript setTimeout function, can be used as a workaround.");
295
- }
296
- else
297
- {
298
- FABridge.refCount++;
299
- retVal = this.target.invokeASFunction(funcID, this.serialize(args));
300
- retVal = this.handleError(retVal);
301
- FABridge.refCount--;
302
- return retVal;
303
- }
304
- },
305
- //call a method on an AS object
306
- callASMethod: function(objID, funcName, args)
307
- {
308
- if (FABridge.refCount > 0)
309
- {
310
- throw new Error("You are trying to call recursively into the Flash Player which is not allowed. In most cases the JavaScript setTimeout function, can be used as a workaround.");
311
- }
312
- else
313
- {
314
- FABridge.refCount++;
315
- args = this.serialize(args);
316
- retVal = this.target.invokeASMethod(objID, funcName, args);
317
- retVal = this.handleError(retVal);
318
- FABridge.refCount--;
319
- return retVal;
320
- }
321
- },
322
-
323
- // responders to remote calls from flash
324
-
325
- //callback from flash that executes a local JS function
326
- //used mostly when setting js functions as callbacks on events
327
- invokeLocalFunction: function(funcID, args)
328
- {
329
- var result;
330
- var func = this.localFunctionCache[funcID];
331
-
332
- if(func != undefined)
333
- {
334
- result = this.serialize(func.apply(null, this.deserialize(args)));
335
- }
336
-
337
- return result;
338
- },
339
-
340
- // Object Types and Proxies
341
-
342
- // accepts an object reference, returns a type object matching the obj reference.
343
- getTypeFromName: function(objTypeName)
344
- {
345
- return this.remoteTypeCache[objTypeName];
346
- },
347
- //create an AS proxy for the given object ID and type
348
- createProxy: function(objID, typeName)
349
- {
350
- var objType = this.getTypeFromName(typeName);
351
- instanceFactory.prototype = objType;
352
- var instance = new instanceFactory(objID);
353
- this.remoteInstanceCache[objID] = instance;
354
- return instance;
355
- },
356
- //return the proxy associated with the given object ID
357
- getProxy: function(objID)
358
- {
359
- return this.remoteInstanceCache[objID];
360
- },
361
-
362
- // accepts a type structure, returns a constructed type
363
- addTypeDataToCache: function(typeData)
364
- {
365
- newType = new ASProxy(this, typeData.name);
366
- var accessors = typeData.accessors;
367
- for (var i = 0; i < accessors.length; i++)
368
- {
369
- this.addPropertyToType(newType, accessors[i]);
370
- }
371
-
372
- var methods = typeData.methods;
373
- for (var i = 0; i < methods.length; i++)
374
- {
375
- if (FABridge.blockedMethods[methods[i]] == undefined)
376
- {
377
- this.addMethodToType(newType, methods[i]);
378
- }
379
- }
380
-
381
-
382
- this.remoteTypeCache[newType.typeName] = newType;
383
- return newType;
384
- },
385
-
386
- //add a property to a typename; used to define the properties that can be called on an AS proxied object
387
- addPropertyToType: function(ty, propName)
388
- {
389
- var c = propName.charAt(0);
390
- var setterName;
391
- var getterName;
392
- if(c >= "a" && c <= "z")
393
- {
394
- getterName = "get" + c.toUpperCase() + propName.substr(1);
395
- setterName = "set" + c.toUpperCase() + propName.substr(1);
396
- }
397
- else
398
- {
399
- getterName = "get" + propName;
400
- setterName = "set" + propName;
401
- }
402
- ty[setterName] = function(val)
403
- {
404
- this.bridge.setPropertyInAS(this.fb_instance_id, propName, val);
405
- }
406
- ty[getterName] = function()
407
- {
408
- return this.bridge.deserialize(this.bridge.getPropertyFromAS(this.fb_instance_id, propName));
409
- }
410
- },
411
-
412
- //add a method to a typename; used to define the methods that can be callefd on an AS proxied object
413
- addMethodToType: function(ty, methodName)
414
- {
415
- ty[methodName] = function()
416
- {
417
- return this.bridge.deserialize(this.bridge.callASMethod(this.fb_instance_id, methodName, FABridge.argsToArray(arguments)));
418
- }
419
- },
420
-
421
- // Function Proxies
422
-
423
- //returns the AS proxy for the specified function ID
424
- getFunctionProxy: function(funcID)
425
- {
426
- var bridge = this;
427
- if (this.remoteFunctionCache[funcID] == null)
428
- {
429
- this.remoteFunctionCache[funcID] = function()
430
- {
431
- bridge.callASFunction(funcID, FABridge.argsToArray(arguments));
432
- }
433
- }
434
- return this.remoteFunctionCache[funcID];
435
- },
436
-
437
- //reutrns the ID of the given function; if it doesnt exist it is created and added to the local cache
438
- getFunctionID: function(func)
439
- {
440
- if (func.__bridge_id__ == undefined)
441
- {
442
- func.__bridge_id__ = this.makeID(this.nextLocalFuncID++);
443
- this.localFunctionCache[func.__bridge_id__] = func;
444
- }
445
- return func.__bridge_id__;
446
- },
447
-
448
- // serialization / deserialization
449
-
450
- serialize: function(value)
451
- {
452
- var result = {};
453
-
454
- var t = typeof(value);
455
- //primitives are kept as such
456
- if (t == "number" || t == "string" || t == "boolean" || t == null || t == undefined)
457
- {
458
- result = value;
459
- }
460
- else if (value instanceof Array)
461
- {
462
- //arrays are serializesd recursively
463
- result = [];
464
- for (var i = 0; i < value.length; i++)
465
- {
466
- result[i] = this.serialize(value[i]);
467
- }
468
- }
469
- else if (t == "function")
470
- {
471
- //js functions are assigned an ID and stored in the local cache
472
- result.type = FABridge.TYPE_JSFUNCTION;
473
- result.value = this.getFunctionID(value);
474
- }
475
- else if (value instanceof ASProxy)
476
- {
477
- result.type = FABridge.TYPE_ASINSTANCE;
478
- result.value = value.fb_instance_id;
479
- }
480
- else
481
- {
482
- result.type = FABridge.TYPE_ANONYMOUS;
483
- result.value = value;
484
- }
485
-
486
- return result;
487
- },
488
-
489
- //on deserialization we always check the return for the specific error code that is used to marshall NPE's into JS errors
490
- // the unpacking is done by returning the value on each pachet for objects/arrays
491
- deserialize: function(packedValue)
492
- {
493
-
494
- var result;
495
-
496
- var t = typeof(packedValue);
497
- if (t == "number" || t == "string" || t == "boolean" || packedValue == null || packedValue == undefined)
498
- {
499
- result = this.handleError(packedValue);
500
- }
501
- else if (packedValue instanceof Array)
502
- {
503
- result = [];
504
- for (var i = 0; i < packedValue.length; i++)
505
- {
506
- result[i] = this.deserialize(packedValue[i]);
507
- }
508
- }
509
- else if (t == "object")
510
- {
511
- for(var i = 0; i < packedValue.newTypes.length; i++)
512
- {
513
- this.addTypeDataToCache(packedValue.newTypes[i]);
514
- }
515
- for (var aRefID in packedValue.newRefs)
516
- {
517
- this.createProxy(aRefID, packedValue.newRefs[aRefID]);
518
- }
519
- if (packedValue.type == FABridge.TYPE_PRIMITIVE)
520
- {
521
- result = packedValue.value;
522
- }
523
- else if (packedValue.type == FABridge.TYPE_ASFUNCTION)
524
- {
525
- result = this.getFunctionProxy(packedValue.value);
526
- }
527
- else if (packedValue.type == FABridge.TYPE_ASINSTANCE)
528
- {
529
- result = this.getProxy(packedValue.value);
530
- }
531
- else if (packedValue.type == FABridge.TYPE_ANONYMOUS)
532
- {
533
- result = packedValue.value;
534
- }
535
- }
536
- return result;
537
- },
538
- //increases the reference count for the given object
539
- addRef: function(obj)
540
- {
541
- this.target.incRef(obj.fb_instance_id);
542
- },
543
- //decrease the reference count for the given object and release it if needed
544
- release:function(obj)
545
- {
546
- this.target.releaseRef(obj.fb_instance_id);
547
- },
548
-
549
- // check the given value for the components of the hard-coded error code : __FLASHERROR
550
- // used to marshall NPE's into flash
551
-
552
- handleError: function(value)
553
- {
554
- if (typeof(value)=="string" && value.indexOf("__FLASHERROR")==0)
555
- {
556
- var myErrorMessage = value.split("||");
557
- if(FABridge.refCount > 0 )
558
- {
559
- FABridge.refCount--;
560
- }
561
- throw new Error(myErrorMessage[1]);
562
- return value;
563
- }
564
- else
565
- {
566
- return value;
567
- }
568
- }
569
- };
570
-
571
- // The root ASProxy class that facades a flash object
572
-
573
- ASProxy = function(bridge, typeName)
574
- {
575
- this.bridge = bridge;
576
- this.typeName = typeName;
577
- return this;
578
- };
579
- //methods available on each ASProxy object
580
- ASProxy.prototype =
581
- {
582
- get: function(propName)
583
- {
584
- return this.bridge.deserialize(this.bridge.getPropertyFromAS(this.fb_instance_id, propName));
585
- },
586
-
587
- set: function(propName, value)
588
- {
589
- this.bridge.setPropertyInAS(this.fb_instance_id, propName, value);
590
- },
591
-
592
- call: function(funcName, args)
593
- {
594
- this.bridge.callASMethod(this.fb_instance_id, funcName, args);
595
- },
596
-
597
- addRef: function() {
598
- this.bridge.addRef(this);
599
- },
600
-
601
- release: function() {
602
- this.bridge.release(this);
603
- }
604
- };