| T Jake Luciani | 322caa2 | 2010-02-15 03:24:55 +0000 | [diff] [blame] | 1 | Thrift Javascript Library | 
| Henrique Mendonça | 095ddb7 | 2013-09-20 19:38:03 +0200 | [diff] [blame] | 2 | ========================= | 
 | 3 | This browser based Apache Thrift implementation supports | 
| henrique | a2de410 | 2014-02-07 14:12:56 +0100 | [diff] [blame] | 4 | RPC clients using the JSON protocol over Http[s] with XHR. | 
| T Jake Luciani | 322caa2 | 2010-02-15 03:24:55 +0000 | [diff] [blame] | 5 |  | 
 | 6 | License | 
| Henrique Mendonça | 095ddb7 | 2013-09-20 19:38:03 +0200 | [diff] [blame] | 7 | ------- | 
| T Jake Luciani | 322caa2 | 2010-02-15 03:24:55 +0000 | [diff] [blame] | 8 | Licensed to the Apache Software Foundation (ASF) under one | 
 | 9 | or more contributor license agreements. See the NOTICE file | 
 | 10 | distributed with this work for additional information | 
 | 11 | regarding copyright ownership. The ASF licenses this file | 
 | 12 | to you under the Apache License, Version 2.0 (the | 
 | 13 | "License"); you may not use this file except in compliance | 
 | 14 | with the License. You may obtain a copy of the License at | 
 | 15 |  | 
 | 16 |   http://www.apache.org/licenses/LICENSE-2.0 | 
 | 17 |  | 
 | 18 | Unless required by applicable law or agreed to in writing, | 
 | 19 | software distributed under the License is distributed on an | 
 | 20 | "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY | 
 | 21 | KIND, either express or implied. See the License for the | 
 | 22 | specific language governing permissions and limitations | 
 | 23 | under the License. | 
 | 24 |  | 
| Henrique Mendonça | 095ddb7 | 2013-09-20 19:38:03 +0200 | [diff] [blame] | 25 | Example | 
 | 26 | ------- | 
 | 27 | The listing below demonstrates a simple browser based JavaScript | 
| henrique | a2de410 | 2014-02-07 14:12:56 +0100 | [diff] [blame] | 28 | Thrift client and Node.js JavaScript server for the hello_svc  | 
 | 29 | service.  | 
| T Jake Luciani | 322caa2 | 2010-02-15 03:24:55 +0000 | [diff] [blame] | 30 |  | 
| Henrique Mendonça | 095ddb7 | 2013-09-20 19:38:03 +0200 | [diff] [blame] | 31 | ### hello.thrift - Service IDL | 
| henrique | a2de410 | 2014-02-07 14:12:56 +0100 | [diff] [blame] | 32 |     service hello_svc { | 
 | 33 |       string get_message(1: string name) | 
| Henrique Mendonça | 095ddb7 | 2013-09-20 19:38:03 +0200 | [diff] [blame] | 34 |     } | 
| T Jake Luciani | 322caa2 | 2010-02-15 03:24:55 +0000 | [diff] [blame] | 35 |  | 
| Henrique Mendonça | 095ddb7 | 2013-09-20 19:38:03 +0200 | [diff] [blame] | 36 | ### hello.html - Browser Client | 
| henrique | a2de410 | 2014-02-07 14:12:56 +0100 | [diff] [blame] | 37 |     <!DOCTYPE html> | 
| Henrique Mendonça | 095ddb7 | 2013-09-20 19:38:03 +0200 | [diff] [blame] | 38 |     <html lang="en"> | 
| henrique | a2de410 | 2014-02-07 14:12:56 +0100 | [diff] [blame] | 39 |       <head> | 
 | 40 |         <meta charset="utf-8"> | 
 | 41 |         <title>Hello Thrift</title> | 
 | 42 |       </head> | 
 | 43 |       <body> | 
 | 44 |         Name: <input type="text" id="name_in"> | 
 | 45 |         <input type="button" id="get_msg" value="Get Message" > | 
 | 46 |         <div id="output"></div> | 
 | 47 |    | 
 | 48 |         <script src="thrift.js"></script> | 
 | 49 |         <script src="gen-js/hello_svc.js"></script> | 
 | 50 |         <script> | 
 | 51 |           (function() { | 
 | 52 |             var transport = new Thrift.Transport("/hello"); | 
 | 53 |             var protocol  = new Thrift.Protocol(transport); | 
 | 54 |             var client    = new hello_svcClient(protocol); | 
 | 55 |             var nameElement = document.getElementById("name_in"); | 
 | 56 |             var outputElement = document.getElementById("output"); | 
 | 57 |             document.getElementById("get_msg") | 
 | 58 |               .addEventListener("click", function(){ | 
 | 59 |                 client.get_message(nameElement.value, function(result) { | 
 | 60 |                   outputElement.innerHTML = result; | 
 | 61 |                 }); | 
 | 62 |               }); | 
 | 63 |           })(); | 
| Henrique Mendonça | 095ddb7 | 2013-09-20 19:38:03 +0200 | [diff] [blame] | 64 |         </script> | 
| henrique | a2de410 | 2014-02-07 14:12:56 +0100 | [diff] [blame] | 65 |       </body> | 
| Henrique Mendonça | 095ddb7 | 2013-09-20 19:38:03 +0200 | [diff] [blame] | 66 |     </html> | 
| T Jake Luciani | 322caa2 | 2010-02-15 03:24:55 +0000 | [diff] [blame] | 67 |  | 
| Henrique Mendonça | 095ddb7 | 2013-09-20 19:38:03 +0200 | [diff] [blame] | 68 | ### hello.js - Node Server | 
| henrique | a2de410 | 2014-02-07 14:12:56 +0100 | [diff] [blame] | 69 |     var Thrift = require('thrift'); | 
 | 70 |     var TBufferedTransport = require('thrift/lib/thrift/transport').TBufferedTransport; | 
 | 71 |     var TJSONProtocol = require('thrift/lib/thrift/protocol').TJSONProtocol; | 
 | 72 |     var hello_svc = require('./gen-nodejs/hello_svc.js'); | 
| Henrique Mendonça | 095ddb7 | 2013-09-20 19:38:03 +0200 | [diff] [blame] | 73 |      | 
| henrique | a2de410 | 2014-02-07 14:12:56 +0100 | [diff] [blame] | 74 |     var hello_handler = { | 
 | 75 |       get_message: function(name, result) { | 
 | 76 |         var msg = "Hello " + name + "!"; | 
 | 77 |         result(null, msg); | 
| Henrique Mendonça | 095ddb7 | 2013-09-20 19:38:03 +0200 | [diff] [blame] | 78 |       } | 
| henrique | a2de410 | 2014-02-07 14:12:56 +0100 | [diff] [blame] | 79 |     } | 
| Henrique Mendonça | 095ddb7 | 2013-09-20 19:38:03 +0200 | [diff] [blame] | 80 |      | 
| henrique | a2de410 | 2014-02-07 14:12:56 +0100 | [diff] [blame] | 81 |     var hello_svc_opt = { | 
 | 82 |       transport: TBufferedTransport, | 
 | 83 |       protocol: TJSONProtocol, | 
 | 84 |       cls: hello_svc, | 
 | 85 |       handler: hello_handler | 
 | 86 |     }; | 
 | 87 |      | 
 | 88 |     var server_opt = { | 
 | 89 |       staticFilePath: ".", | 
 | 90 |       services: { | 
 | 91 |         "/hello": hello_svc_opt | 
 | 92 |       } | 
 | 93 |     } | 
 | 94 |      | 
 | 95 |     var server = Thrift.createStaticHttpThriftServer(server_opt); | 
 | 96 |     var port = 9099; | 
 | 97 |     server.listen(port); | 
 | 98 |     console.log("Http/Thrift Server running on port: " + port);` |