em-websocket 0.3.7 → 0.5.2

Sign up to get free protection for your applications and to get access to all the features.
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
- };