policyfile

<html> <head> <title>FlashPolicyFileServer</title> <script src="http://ajax.googleapis.com/ajax/libs/jquery/1/jquery.min.js"></script> <style>body { margin: 0; padding: 0; font: 14px/1.5 'Palatino Linotype', 'Book Antiqua', Palatino, FreeSerif, serif; color: #252519; } a { color: #252519; } a:hover { text-decoration: underline; color: #19469D; } p { margin: 12px 0; } h1, h2, h3 { margin: 0; padding: 0; } table#source { width: 100%; border-collapse: collapse; } table#source td:first-child { padding: 30px 40px 30px 40px; vertical-align: top; } table#source td:first-child, table#source td:first-child pre { width: 450px; } table#source td:last-child { padding: 30px 0 30px 40px; border-left: 1px solid #E5E5EE; background: #F5F5FF; } table#source tr { border-bottom: 1px solid #E5E5EE; } table#source tr.filename { padding-top: 40px; border-top: 1px solid #E5E5EE; } table#source tr.filename td:first-child { text-transform: capitalize; } table#source tr.filename td:last-child { font-size: 12px; } table#source tr.filename h2 { margin: 0; padding: 0; cursor: pointer; } table#source tr.code h1, table#source tr.code h2, table#source tr.code h3 { margin-top: 30px; font-family: "Lucida Grande", "Helvetica Nueue", Arial, sans-serif; font-size: 18px; } table#source tr.code h2 { font-size: 16px; } table#source tr.code h3 { font-size: 14px; } table#source tr.code ul { margin: 15px 0 15px 35px; padding: 0; } table#source tr.code ul li { margin: 0; padding: 1px 0; } table#source tr.code ul li p { margin: 0; padding: 0; } table#source tr.code td:first-child pre { padding: 20px; } #ribbon { position: fixed; top: 0; right: 0; } code .string { color: #219161; } code .regexp { color: #219161; } code .keyword { color: #954121; } code .number { color: #19469D; } code .comment { color: #bbb; } code .this { color: #19469D; }</style> <script> $(function(){ $('tr.code').hide(); $('tr.filename').toggle(function(){ $(this).nextUntil('.filename').fadeIn(); }, function(){ $(this).nextUntil('.filename').fadeOut(); }); }); </script> </head> <body> <table id="source"><tbody><tr><td><h1>FlashPolicyFileServer</h1></td><td></td></tr><tr class="filename"><td><h2 id="lib/server.js"><a href="#">server</a></h2></td><td>lib/server.js</td></tr><tr class="code"> <td class="docs"> Module dependencies and cached references. </td> <td class="code"> <pre><code>var slice = Array.prototype.slice , net = require('net');</code></pre> </td> </tr> <tr class="code"> <td class="docs"> The server that does the Policy File severing <h2>Options</h2> <ul><li><code>log</code> false or a function that can output log information, defaults to console.log?</li></ul> <h2></h2> <ul><li>param: Object options Options to customize the servers functionality.</li><li>param: Array origins The origins that are allowed on this server, defaults to <code>*:*</code>.</li><li>api: public</li></ul> </td> <td class="code"> <pre><code>function Server (options, origins) { var me = this; this.origins = origins || ['*:*']; this.port = 843; this.log = console.log; // merge `this` with the options Object.keys(options).forEach(function (key) { me[key] &amp;&amp; (me[key] = options[key]) }); // create the net server this.socket = net.createServer(function createServer (socket) { socket.on('error', function socketError () { me.responder.call(me, socket); }); me.responder.call(me, socket); }); // Listen for errors as the port might be blocked because we do not have root priv. this.socket.on('error', function serverError (err) { // Special and common case error handling if (err.errno == 13) { me.log &amp;&amp; me.log( 'Unable to listen to port `' + me.port + '` as your Node.js instance does not have root privileges. ' + ( me.server ? 'The Flash Policy File requests will only be served inline over the supplied HTTP server. Inline serving is slower than a dedicated server instance.' : 'No fallback server supplied, we will be unable to answer Flash Policy File requests.' ) ); me.emit('connect_failed', err); me.socket.removeAllListeners(); delete me.socket; } else { me.log &amp;&amp; me.log('FlashPolicyFileServer received an error event:\n' + (err.message ? err.message : err)); } }); this.socket.on('timeout', function serverTimeout () {}); this.socket.on('close', function serverClosed (err) { err &amp;&amp; me.log &amp;&amp; me.log('Server closing due to an error: \n' + (err.message ? err.message : err)); if (me.server) { // Remove the inline policy listener if we close down // but only when the server was `online` (see listen prototype) if (me.server['@'] &amp;&amp; me.server.online) { me.server.removeListener('connection', me.server['@']); } // not online anymore delete me.server.online; } }); // Compile the initial `buffer` this.compile(); }</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Start listening for requests <h2></h2> <ul><li>param: Number port The port number it should be listening to.</li><li>param: Server server A HTTP server instance, this will be used to listen for inline requests</li><li>param: Function cb The callback needs to be called once server is ready</li><li>api: public</li></ul> </td> <td class="code"> <pre><code>Server.prototype.listen = function listen (port, server, cb){ var me = this , args = slice.call(arguments, 0) , callback; // assign the correct vars, for flexible arguments args.forEach(function args (arg){ var type = typeof arg; if (type === 'number') me.port = arg; if (type === 'function') callback = arg; if (type === 'object') me.server = arg; }); if (this.server) { // no one in their right mind would ever create a `@` prototype, so Im just gonna store // my function on the server, so I can remove it later again once the server(s) closes this.server['@'] = function connection (socket) { socket.once('data', function requestData (data) { // if it's a Flash policy request, and we can write to the if ( data &amp;&amp; data[0] === 60 &amp;&amp; data.toString() === '<policy-file-request/>\0' &amp;&amp; socket &amp;&amp; (socket.readyState === 'open' || socket.readyState === 'writeOnly') ){ // send the buffer try { socket.end(me.buffer); } catch (e) {} } }); }; // attach it this.server.on('connection', this.server['@']); } // We add a callback method, so we can set a flag for when the server is `enabled` or `online`. // this flag is needed because if a error occurs and the we cannot boot up the server the // fallback functionality should not be removed during the `close` event this.port &gt;= 0 &amp;&amp; this.socket.listen(this.port, function serverListening () { me.socket.online = true; if (callback) { callback.call(me); callback = undefined; } }); return this; };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Adds a new origin to the Flash Policy File. <h2></h2> <ul><li>param: Arguments The origins that need to be added.</li><li>api: public</li></ul> </td> <td class="code"> <pre><code>Server.prototype.add = function add(){ var args = slice.call(arguments, 0) , i = args.length; // flag duplicates while (i--) { if (this.origins.indexOf(args[i]) &gt;= 0){ args[i] = null; } } // Add all the arguments to the array // but first we want to remove all `falsy` values from the args Array.prototype.push.apply( this.origins , args.filter(function filter (value) { return !!value; }) ); this.compile(); return this; };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Removes a origin from the Flash Policy File. <h2></h2> <ul><li>param: String origin The origin that needs to be removed from the server</li><li>api: public</li></ul> </td> <td class="code"> <pre><code>Server.prototype.remove = function remove (origin){ var position = this.origins.indexOf(origin); // only remove and recompile if we have a match if (position &gt; 0) { this.origins.splice(position, 1); this.compile(); } return this; };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Closes and cleans up the server <ul><li>api: public</li></ul> </td> <td class="code"> <pre><code>Server.prototype.close = function close () { this.socket.removeAllListeners(); try { this.socket.close(); } catch (e) {} return this; };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Proxy the event listener requests to the created Net server </td> <td class="code"> <pre><code>Object.keys(process.EventEmitter.prototype).forEach(function proxy (key){ Server.prototype[key] = Server.prototype[key] || function () { if (this.socket) { this.socket[key].apply(this.socket, arguments); } return this; }; });</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Creates a new server instance. <h2></h2> <ul><li>param: Object options A options object to override the default config</li><li>param: Array origins The origins that should be allowed by the server</li><li>api: public</li></ul> </td> <td class="code"> <pre><code>exports.createServer = function createServer (options, origins) { origins = Array.isArray(origins) ? origins : (Array.isArray(options) ? options : false); options = !Array.isArray(options) &amp;&amp; options ? options : {}; return new Server(options, origins); };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Provide a hook to the original server, so it can be extended if needed. <h2></h2> <ul><li>type: Net.Server </li></ul> </td> <td class="code"> <pre><code>exports.Server = Server;</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Module version <h2></h2> <ul><li>type: String </li></ul> </td> <td class="code"> <pre><code>exports.version = '0.0.5'; </code></pre> </td> </tr> </body> </html></tbody></table>