diff --git a/Makefile b/Makefile index 8a844eb414..f943894bf1 100644 --- a/Makefile +++ b/Makefile @@ -28,7 +28,7 @@ # It's authors were Jonathan Wallace and Bernhard Fluehmann. -objects = websocket_session.o websocket_server.o websocket_frame.o \ +objects = websocket_server_session.o websocket_client_session.o websocket_session.o websocket_server.o websocket_client.o websocket_frame.o \ network_utilities.o sha1.o base64.o OS=$(shell uname) diff --git a/examples/chat_client/Makefile b/examples/chat_client/Makefile new file mode 100644 index 0000000000..adb21c13b5 --- /dev/null +++ b/examples/chat_client/Makefile @@ -0,0 +1,23 @@ +CFLAGS = -O2 +LDFLAGS = + +CXX ?= c++ +SHARED ?= "1" + +ifeq ($(SHARED), 1) + LDFLAGS := $(LDFLAGS) -lboost_system -lboost_thread -lboost_date_time -lwebsocketpp +else + LDFLAGS := $(LDFLAGS) -lboost_system -lboost_thread -lboost_date_time ../../libwebsocketpp.a +endif + +chat_client: chat_client.o chat_client_handler.o + $(CXX) $(CFLAGS) $^ -o $@ $(LDFLAGS) + +%.o: %.cpp + $(CXX) -c $(CFLAGS) -o $@ $^ + +# cleanup by removing generated files +# +.PHONY: clean +clean: + rm -f *.o chat_client diff --git a/examples/chat_client/chat_client b/examples/chat_client/chat_client new file mode 100755 index 0000000000..3763f4a732 Binary files /dev/null and b/examples/chat_client/chat_client differ diff --git a/examples/chat_client/chat_client.cpp b/examples/chat_client/chat_client.cpp new file mode 100644 index 0000000000..eaa19a4636 --- /dev/null +++ b/examples/chat_client/chat_client.cpp @@ -0,0 +1,78 @@ +/* + * Copyright (c) 2011, Peter Thorson. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the name of the WebSocket++ Project nor the + * names of its contributors may be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + */ + +#include "chat_client_handler.hpp" + +#include +#include +#include +#include + +#include + +using boost::asio::ip::tcp; +using namespace websocketchat; + +int main(int argc, char* argv[]) { + std::string url; + + if (argc != 2) { + std::cout << "Usage: `chat_client ws_url`" << std::endl; + } else { + url = argv[1]; + } + + chat_client_handler_ptr c(new chat_client_handler()); + + try { + boost::asio::io_service io_service; + + websocketpp::client_ptr client(new websocketpp::client(io_service,c)); + + client->init(); + + client->set_header("User Agent","WebSocket++/2011-09-25"); + client->add_subprotocol("com.zaphoyd.websocketpp.chat"); + + client->set_origin("http://zaphoyd.com"); + + client->connect(url); + + boost::thread t(boost::bind(&boost::asio::io_service::run, &io_service)); + + char line[512]; + while (std::cin.getline(line, 512)) { + c->send(line); + } + + t.join(); + } catch (std::exception& e) { + std::cerr << "Exception: " << e.what() << std::endl; + } + + return 0; +} diff --git a/examples/chat_client/chat_client.html b/examples/chat_client/chat_client.html new file mode 100644 index 0000000000..3e7c08ad28 --- /dev/null +++ b/examples/chat_client/chat_client.html @@ -0,0 +1,177 @@ + + + + + + + + + + + +
+
+ + +
+ +
+
+

Chat Participants

+
+
+
+ + + \ No newline at end of file diff --git a/examples/chat_client/chat_client_handler.cpp b/examples/chat_client/chat_client_handler.cpp new file mode 100644 index 0000000000..cac166b1d9 --- /dev/null +++ b/examples/chat_client/chat_client_handler.cpp @@ -0,0 +1,107 @@ +/* + * Copyright (c) 2011, Peter Thorson. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the name of the WebSocket++ Project nor the + * names of its contributors may be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + */ + +#include "chat_client_handler.hpp" + +#include + +using websocketchat::chat_client_handler; +using websocketpp::client_session_ptr; + +void chat_client_handler::on_open(session_ptr s) { + // not sure if anything needs to happen here. + m_session = s; + + std::cout << "Successfully connected" << std::endl; +} + +void chat_client_handler::on_close(session_ptr s,uint16_t status,const std::string &reason) { + // not sure if anything needs to happen here either. + + m_session = client_session_ptr(); + + std::cout << "client was disconnected" << std::endl; +} + +void chat_client_handler::on_message(session_ptr s,const std::string &msg) { + std::cout << "message from server: " << msg << std::endl; + + decode_server_msg(msg); +} + +// CLIENT API +// client api methods will be called from outside the io_service.run thread +// they need to be careful to not touch unsyncronized member variables. + +void chat_client_handler::send(const std::string &msg) { + if (!m_session) { + std::cerr << "Error: no connected session" << std::endl; + return; + } + m_session->io_service().post(boost::bind(&chat_client_handler::do_send, this, msg)); +} + +void chat_client_handler::close() { + if (!m_session) { + std::cerr << "Error: no connected session" << std::endl; + return; + } + m_session->io_service().post(boost::bind(&chat_client_handler::do_close,this)); +} + +// END CLIENT API + +void chat_client_handler::do_send(const std::string &msg) { + if (!m_session) { + std::cerr << "Error: no connected session" << std::endl; + return; + } + + // check for local commands + if (msg == "list") { + std::cout << "list all participants" << std::endl; + } else if (msg == "close") { + do_close(); + } else { + m_session->send(msg); + } +} + +void chat_client_handler::do_close() { + if (!m_session) { + std::cerr << "Error: no connected session" << std::endl; + return; + } + m_session->close(websocketpp::session::CLOSE_STATUS_GOING_AWAY,""); +} + +// {"type":"participants","value":[,...]} +// {"type":"msg","sender":"","value":"" } +void chat_client_handler::decode_server_msg(const std::string &msg) { + // for messages of type participants, erase and rebuild m_participants + // for messages of type msg, print out message +} diff --git a/examples/chat_client/chat_client_handler.hpp b/examples/chat_client/chat_client_handler.hpp new file mode 100644 index 0000000000..fb90a6e7aa --- /dev/null +++ b/examples/chat_client/chat_client_handler.hpp @@ -0,0 +1,94 @@ +/* + * Copyright (c) 2011, Peter Thorson. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the name of the WebSocket++ Project nor the + * names of its contributors may be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + */ + +#ifndef CHAT_CLIENT_HANDLER_HPP +#define CHAT_CLIENT_HANDLER_HPP + +// com.zaphoyd.websocketpp.chat protocol +// +// client messages: +// alias [UTF8 text, 16 characters max] +// msg [UTF8 text] +// +// server messages: +// {"type":"msg","sender":"","value":"" } +// {"type":"participants","value":[,...]} + +#include + +#include "../../src/websocketpp.hpp" +#include "../../src/websocket_connection_handler.hpp" + +#include +#include +#include + +using websocketpp::session_ptr; + +namespace websocketchat { + +class chat_client_handler : public websocketpp::connection_handler { +public: + chat_client_handler() {} + virtual ~chat_client_handler() {} + + // ignored for clients? + void validate(session_ptr s) {} + + // connection to chat room complete + void on_open(session_ptr s); + + // connection to chat room closed + void on_close(session_ptr s,uint16_t status,const std::string &reason); + + // got a new message from server + void on_message(session_ptr s,const std::string &msg); + + // ignore messages + void on_message(session_ptr s,const std::vector &data) {} + + // CLIENT API + void send(const std::string &msg); + void close(); + +private: + // Client API internal + void do_send(const std::string &msg); + void do_close(); + + void decode_server_msg(const std::string &msg); + + // list of other chat participants + std::set m_participants; + std::queue m_msg_queue; + session_ptr m_session; +}; + +typedef boost::shared_ptr chat_client_handler_ptr; + +} +#endif // CHAT_CLIENT_HANDLER_HPP diff --git a/examples/chat_client/jquery-1.6.3.min.js b/examples/chat_client/jquery-1.6.3.min.js new file mode 100644 index 0000000000..20d7f61e39 --- /dev/null +++ b/examples/chat_client/jquery-1.6.3.min.js @@ -0,0 +1,4 @@ +/*! jQuery v1.6.3 http://jquery.com/ | http://jquery.org/license */ +(function(a,b){function cu(a){return f.isWindow(a)?a:a.nodeType===9?a.defaultView||a.parentWindow:!1}function cr(a){if(!cg[a]){var b=c.body,d=f("<"+a+">").appendTo(b),e=d.css("display");d.remove();if(e==="none"||e===""){ch||(ch=c.createElement("iframe"),ch.frameBorder=ch.width=ch.height=0),b.appendChild(ch);if(!ci||!ch.createElement)ci=(ch.contentWindow||ch.contentDocument).document,ci.write((c.compatMode==="CSS1Compat"?"":"")+""),ci.close();d=ci.createElement(a),ci.body.appendChild(d),e=f.css(d,"display"),b.removeChild(ch)}cg[a]=e}return cg[a]}function cq(a,b){var c={};f.each(cm.concat.apply([],cm.slice(0,b)),function(){c[this]=a});return c}function cp(){cn=b}function co(){setTimeout(cp,0);return cn=f.now()}function cf(){try{return new a.ActiveXObject("Microsoft.XMLHTTP")}catch(b){}}function ce(){try{return new a.XMLHttpRequest}catch(b){}}function b$(a,c){a.dataFilter&&(c=a.dataFilter(c,a.dataType));var d=a.dataTypes,e={},g,h,i=d.length,j,k=d[0],l,m,n,o,p;for(g=1;g0){c!=="border"&&f.each(e,function(){c||(d-=parseFloat(f.css(a,"padding"+this))||0),c==="margin"?d+=parseFloat(f.css(a,c+this))||0:d-=parseFloat(f.css(a,"border"+this+"Width"))||0});return d+"px"}d=bv(a,b,b);if(d<0||d==null)d=a.style[b]||0;d=parseFloat(d)||0,c&&f.each(e,function(){d+=parseFloat(f.css(a,"padding"+this))||0,c!=="padding"&&(d+=parseFloat(f.css(a,"border"+this+"Width"))||0),c==="margin"&&(d+=parseFloat(f.css(a,c+this))||0)});return d+"px"}function bl(a,b){b.src?f.ajax({url:b.src,async:!1,dataType:"script"}):f.globalEval((b.text||b.textContent||b.innerHTML||"").replace(bd,"/*$0*/")),b.parentNode&&b.parentNode.removeChild(b)}function bk(a){f.nodeName(a,"input")?bj(a):"getElementsByTagName"in a&&f.grep(a.getElementsByTagName("input"),bj)}function bj(a){if(a.type==="checkbox"||a.type==="radio")a.defaultChecked=a.checked}function bi(a){return"getElementsByTagName"in a?a.getElementsByTagName("*"):"querySelectorAll"in a?a.querySelectorAll("*"):[]}function bh(a,b){var c;if(b.nodeType===1){b.clearAttributes&&b.clearAttributes(),b.mergeAttributes&&b.mergeAttributes(a),c=b.nodeName.toLowerCase();if(c==="object")b.outerHTML=a.outerHTML;else if(c!=="input"||a.type!=="checkbox"&&a.type!=="radio"){if(c==="option")b.selected=a.defaultSelected;else if(c==="input"||c==="textarea")b.defaultValue=a.defaultValue}else a.checked&&(b.defaultChecked=b.checked=a.checked),b.value!==a.value&&(b.value=a.value);b.removeAttribute(f.expando)}}function bg(a,b){if(b.nodeType===1&&!!f.hasData(a)){var c=f.expando,d=f.data(a),e=f.data(b,d);if(d=d[c]){var g=d.events;e=e[c]=f.extend({},d);if(g){delete e.handle,e.events={};for(var h in g)for(var i=0,j=g[h].length;i=0===c})}function U(a){return!a||!a.parentNode||a.parentNode.nodeType===11}function M(a,b){return(a&&a!=="*"?a+".":"")+b.replace(y,"`").replace(z,"&")}function L(a){var b,c,d,e,g,h,i,j,k,l,m,n,o,p=[],q=[],r=f._data(this,"events");if(!(a.liveFired===this||!r||!r.live||a.target.disabled||a.button&&a.type==="click")){a.namespace&&(n=new RegExp("(^|\\.)"+a.namespace.split(".").join("\\.(?:.*\\.)?")+"(\\.|$)")),a.liveFired=this;var s=r.live.slice(0);for(i=0;ic)break;a.currentTarget=e.elem,a.data=e.handleObj.data,a.handleObj=e.handleObj,o=e.handleObj.origHandler.apply(e.elem,arguments);if(o===!1||a.isPropagationStopped()){c=e.level,o===!1&&(b=!1);if(a.isImmediatePropagationStopped())break}}return b}}function J(a,c,d){var e=f.extend({},d[0]);e.type=a,e.originalEvent={},e.liveFired=b,f.event.handle.call(c,e),e.isDefaultPrevented()&&d[0].preventDefault()}function D(){return!0}function C(){return!1}function m(a,c,d){var e=c+"defer",g=c+"queue",h=c+"mark",i=f.data(a,e,b,!0);i&&(d==="queue"||!f.data(a,g,b,!0))&&(d==="mark"||!f.data(a,h,b,!0))&&setTimeout(function(){!f.data(a,g,b,!0)&&!f.data(a,h,b,!0)&&(f.removeData(a,e,!0),i.resolve())},0)}function l(a){for(var b in a)if(b!=="toJSON")return!1;return!0}function k(a,c,d){if(d===b&&a.nodeType===1){var e="data-"+c.replace(j,"$1-$2").toLowerCase();d=a.getAttribute(e);if(typeof d=="string"){try{d=d==="true"?!0:d==="false"?!1:d==="null"?null:f.isNaN(d)?i.test(d)?f.parseJSON(d):d:parseFloat(d)}catch(g){}f.data(a,c,d)}else d=b}return d}var c=a.document,d=a.navigator,e=a.location,f=function(){function K(){if(!e.isReady){try{c.documentElement.doScroll("left")}catch(a){setTimeout(K,1);return}e.ready()}}var e=function(a,b){return new e.fn.init(a,b,h)},f=a.jQuery,g=a.$,h,i=/^(?:[^#<]*(<[\w\W]+>)[^>]*$|#([\w\-]*)$)/,j=/\S/,k=/^\s+/,l=/\s+$/,m=/\d/,n=/^<(\w+)\s*\/?>(?:<\/\1>)?$/,o=/^[\],:{}\s]*$/,p=/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g,q=/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g,r=/(?:^|:|,)(?:\s*\[)+/g,s=/(webkit)[ \/]([\w.]+)/,t=/(opera)(?:.*version)?[ \/]([\w.]+)/,u=/(msie) ([\w.]+)/,v=/(mozilla)(?:.*? rv:([\w.]+))?/,w=/-([a-z]|[0-9])/ig,x=/^-ms-/,y=function(a,b){return(b+"").toUpperCase()},z=d.userAgent,A,B,C,D=Object.prototype.toString,E=Object.prototype.hasOwnProperty,F=Array.prototype.push,G=Array.prototype.slice,H=String.prototype.trim,I=Array.prototype.indexOf,J={};e.fn=e.prototype={constructor:e,init:function(a,d,f){var g,h,j,k;if(!a)return this;if(a.nodeType){this.context=this[0]=a,this.length=1;return this}if(a==="body"&&!d&&c.body){this.context=c,this[0]=c.body,this.selector=a,this.length=1;return this}if(typeof a=="string"){a.charAt(0)!=="<"||a.charAt(a.length-1)!==">"||a.length<3?g=i.exec(a):g=[null,a,null];if(g&&(g[1]||!d)){if(g[1]){d=d instanceof e?d[0]:d,k=d?d.ownerDocument||d:c,j=n.exec(a),j?e.isPlainObject(d)?(a=[c.createElement(j[1])],e.fn.attr.call(a,d,!0)):a=[k.createElement(j[1])]:(j=e.buildFragment([g[1]],[k]),a=(j.cacheable?e.clone(j.fragment):j.fragment).childNodes);return e.merge(this,a)}h=c.getElementById(g[2]);if(h&&h.parentNode){if(h.id!==g[2])return f.find(a);this.length=1,this[0]=h}this.context=c,this.selector=a;return this}return!d||d.jquery?(d||f).find(a):this.constructor(d).find(a)}if(e.isFunction(a))return f.ready(a);a.selector!==b&&(this.selector=a.selector,this.context=a.context);return e.makeArray(a,this)},selector:"",jquery:"1.6.3",length:0,size:function(){return this.length},toArray:function(){return G.call(this,0)},get:function(a){return a==null?this.toArray():a<0?this[this.length+a]:this[a]},pushStack:function(a,b,c){var d=this.constructor();e.isArray(a)?F.apply(d,a):e.merge(d,a),d.prevObject=this,d.context=this.context,b==="find"?d.selector=this.selector+(this.selector?" ":"")+c:b&&(d.selector=this.selector+"."+b+"("+c+")");return d},each:function(a,b){return e.each(this,a,b)},ready:function(a){e.bindReady(),B.done(a);return this},eq:function(a){return a===-1?this.slice(a):this.slice(a,+a+1)},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},slice:function(){return this.pushStack(G.apply(this,arguments),"slice",G.call(arguments).join(","))},map:function(a){return this.pushStack(e.map(this,function(b,c){return a.call(b,c,b)}))},end:function(){return this.prevObject||this.constructor(null)},push:F,sort:[].sort,splice:[].splice},e.fn.init.prototype=e.fn,e.extend=e.fn.extend=function(){var a,c,d,f,g,h,i=arguments[0]||{},j=1,k=arguments.length,l=!1;typeof i=="boolean"&&(l=i,i=arguments[1]||{},j=2),typeof i!="object"&&!e.isFunction(i)&&(i={}),k===j&&(i=this,--j);for(;j0)return;B.resolveWith(c,[e]),e.fn.trigger&&e(c).trigger("ready").unbind("ready")}},bindReady:function(){if(!B){B=e._Deferred();if(c.readyState==="complete")return setTimeout(e.ready,1);if(c.addEventListener)c.addEventListener("DOMContentLoaded",C,!1),a.addEventListener("load",e.ready,!1);else if(c.attachEvent){c.attachEvent("onreadystatechange",C),a.attachEvent("onload",e.ready);var b=!1;try{b=a.frameElement==null}catch(d){}c.documentElement.doScroll&&b&&K()}}},isFunction:function(a){return e.type(a)==="function"},isArray:Array.isArray||function(a){return e.type(a)==="array"},isWindow:function(a){return a&&typeof a=="object"&&"setInterval"in a},isNaN:function(a){return a==null||!m.test(a)||isNaN(a)},type:function(a){return a==null?String(a):J[D.call(a)]||"object"},isPlainObject:function(a){if(!a||e.type(a)!=="object"||a.nodeType||e.isWindow(a))return!1;try{if(a.constructor&&!E.call(a,"constructor")&&!E.call(a.constructor.prototype,"isPrototypeOf"))return!1}catch(c){return!1}var d;for(d in a);return d===b||E.call(a,d)},isEmptyObject:function(a){for(var b in a)return!1;return!0},error:function(a){throw a},parseJSON:function(b){if(typeof b!="string"||!b)return null;b=e.trim(b);if(a.JSON&&a.JSON.parse)return a.JSON.parse(b);if(o.test(b.replace(p,"@").replace(q,"]").replace(r,"")))return(new Function("return "+b))();e.error("Invalid JSON: "+b)},parseXML:function(c){var d,f;try{a.DOMParser?(f=new DOMParser,d=f.parseFromString(c,"text/xml")):(d=new ActiveXObject("Microsoft.XMLDOM"),d.async="false",d.loadXML(c))}catch(g){d=b}(!d||!d.documentElement||d.getElementsByTagName("parsererror").length)&&e.error("Invalid XML: "+c);return d},noop:function(){},globalEval:function(b){b&&j.test(b)&&(a.execScript||function(b){a.eval.call(a,b)})(b)},camelCase:function(a){return a.replace(x,"ms-").replace(w,y)},nodeName:function(a,b){return a.nodeName&&a.nodeName.toUpperCase()===b.toUpperCase()},each:function(a,c,d){var f,g=0,h=a.length,i=h===b||e.isFunction(a);if(d){if(i){for(f in a)if(c.apply(a[f],d)===!1)break}else for(;g0&&a[0]&&a[j-1]||j===0||e.isArray(a));if(k)for(;i1?h.call(arguments,0):c,--e||g.resolveWith(g,h.call(b,0))}}var b=arguments,c=0,d=b.length,e=d,g=d<=1&&a&&f.isFunction(a.promise)?a:f.Deferred();if(d>1){for(;c
a",d=a.getElementsByTagName("*"),e=a.getElementsByTagName("a")[0];if(!d||!d.length||!e)return{};g=c.createElement("select"),h=g.appendChild(c.createElement("option")),i=a.getElementsByTagName("input")[0],k={leadingWhitespace:a.firstChild.nodeType===3,tbody:!a.getElementsByTagName("tbody").length,htmlSerialize:!!a.getElementsByTagName("link").length,style:/top/.test(e.getAttribute("style")),hrefNormalized:e.getAttribute("href")==="/a",opacity:/^0.55$/.test(e.style.opacity),cssFloat:!!e.style.cssFloat,checkOn:i.value==="on",optSelected:h.selected,getSetAttribute:a.className!=="t",submitBubbles:!0,changeBubbles:!0,focusinBubbles:!1,deleteExpando:!0,noCloneEvent:!0,inlineBlockNeedsLayout:!1,shrinkWrapBlocks:!1,reliableMarginRight:!0},i.checked=!0,k.noCloneChecked=i.cloneNode(!0).checked,g.disabled=!0,k.optDisabled=!h.disabled;try{delete a.test}catch(v){k.deleteExpando=!1}!a.addEventListener&&a.attachEvent&&a.fireEvent&&(a.attachEvent("onclick",function(){k.noCloneEvent=!1}),a.cloneNode(!0).fireEvent("onclick")),i=c.createElement("input"),i.value="t",i.setAttribute("type","radio"),k.radioValue=i.value==="t",i.setAttribute("checked","checked"),a.appendChild(i),l=c.createDocumentFragment(),l.appendChild(a.firstChild),k.checkClone=l.cloneNode(!0).cloneNode(!0).lastChild.checked,a.innerHTML="",a.style.width=a.style.paddingLeft="1px",m=c.getElementsByTagName("body")[0],o=c.createElement(m?"div":"body"),p={visibility:"hidden",width:0,height:0,border:0,margin:0,background:"none"},m&&f.extend(p,{position:"absolute",left:"-1000px",top:"-1000px"});for(t in p)o.style[t]=p[t];o.appendChild(a),n=m||b,n.insertBefore(o,n.firstChild),k.appendChecked=i.checked,k.boxModel=a.offsetWidth===2,"zoom"in a.style&&(a.style.display="inline",a.style.zoom=1,k.inlineBlockNeedsLayout=a.offsetWidth===2,a.style.display="",a.innerHTML="
",k.shrinkWrapBlocks=a.offsetWidth!==2),a.innerHTML="
t
",q=a.getElementsByTagName("td"),u=q[0].offsetHeight===0,q[0].style.display="",q[1].style.display="none",k.reliableHiddenOffsets=u&&q[0].offsetHeight===0,a.innerHTML="",c.defaultView&&c.defaultView.getComputedStyle&&(j=c.createElement("div"),j.style.width="0",j.style.marginRight="0",a.appendChild(j),k.reliableMarginRight=(parseInt((c.defaultView.getComputedStyle(j,null)||{marginRight:0}).marginRight,10)||0)===0),o.innerHTML="",n.removeChild(o);if(a.attachEvent)for(t in{submit:1,change:1,focusin:1})s="on"+t,u=s in a,u||(a.setAttribute(s,"return;"),u=typeof a[s]=="function"),k[t+"Bubbles"]=u;o=l=g=h=m=j=a=i=null;return k}(),f.boxModel=f.support.boxModel;var i=/^(?:\{.*\}|\[.*\])$/,j=/([a-z])([A-Z])/g;f.extend({cache:{},uuid:0,expando:"jQuery"+(f.fn.jquery+Math.random()).replace(/\D/g,""),noData:{embed:!0,object:"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000",applet:!0},hasData:function(a){a=a.nodeType?f.cache[a[f.expando]]:a[f.expando];return!!a&&!l(a)},data:function(a,c,d,e){if(!!f.acceptData(a)){var g,h,i=f.expando,j=typeof c=="string",k=a.nodeType,l=k?f.cache:a,m=k?a[f.expando]:a[f.expando]&&f.expando;if((!m||e&&m&&l[m]&&!l[m][i])&&j&&d===b)return;m||(k?a[f.expando]=m=++f.uuid:m=f.expando),l[m]||(l[m]={},k||(l[m].toJSON=f.noop));if(typeof c=="object"||typeof c=="function")e?l[m][i]=f.extend(l[m][i],c):l[m]=f.extend(l[m],c);g=l[m],e&&(g[i]||(g[i]={}),g=g[i]),d!==b&&(g[f.camelCase(c)]=d);if(c==="events"&&!g[c])return g[i]&&g[i].events;j?(h=g[c],h==null&&(h=g[f.camelCase(c)])):h=g;return h}},removeData:function(a,b,c){if(!!f.acceptData(a)){var d,e=f.expando,g=a.nodeType,h=g?f.cache:a,i=g?a[f.expando]:f.expando;if(!h[i])return;if(b){d=c?h[i][e]:h[i];if(d){d[b]||(b=f.camelCase(b)),delete d[b];if(!l(d))return}}if(c){delete h[i][e];if(!l(h[i]))return}var j=h[i][e];f.support.deleteExpando||!h.setInterval?delete h[i]:h[i]=null,j?(h[i]={},g||(h[i].toJSON=f.noop),h[i][e]=j):g&&(f.support.deleteExpando?delete a[f.expando]:a.removeAttribute?a.removeAttribute(f.expando):a[f.expando]=null)}},_data:function(a,b,c){return f.data(a,b,c,!0)},acceptData:function(a){if(a.nodeName){var b=f.noData[a.nodeName.toLowerCase()];if(b)return b!==!0&&a.getAttribute("classid")===b}return!0}}),f.fn.extend({data:function(a,c){var d=null;if(typeof a=="undefined"){if(this.length){d=f.data(this[0]);if(this[0].nodeType===1){var e=this[0].attributes,g;for(var h=0,i=e.length;h-1)return!0;return!1},val:function(a){var c,d,e=this[0];if(!arguments.length){if(e){c=f.valHooks[e.nodeName.toLowerCase()]||f.valHooks[e.type];if(c&&"get"in c&&(d=c.get(e,"value"))!==b)return d;d=e.value;return typeof d=="string"?d.replace(p,""):d==null?"":d}return b}var g=f.isFunction(a);return this.each(function(d){var e=f(this),h;if(this.nodeType===1){g?h=a.call(this,d,e.val()):h=a,h==null?h="":typeof h=="number"?h+="":f.isArray(h)&&(h=f.map(h,function(a){return a==null?"":a+""})),c=f.valHooks[this.nodeName.toLowerCase()]||f.valHooks[this.type];if(!c||!("set"in c)||c.set(this,h,"value")===b)this.value=h}})}}),f.extend({valHooks:{option:{get:function(a){var b=a.attributes.value;return!b||b.specified?a.value:a.text}},select:{get:function(a){var b,c=a.selectedIndex,d=[],e=a.options,g=a.type==="select-one";if(c<0)return null;for(var h=g?c:0,i=g?c+1:e.length;h=0}),c.length||(a.selectedIndex=-1);return c}}},attrFn:{val:!0,css:!0,html:!0,text:!0,data:!0,width:!0,height:!0,offset:!0},attrFix:{tabindex:"tabIndex"},attr:function(a,c,d,e){var g=a.nodeType;if(!a||g===3||g===8||g===2)return b;if(e&&c in f.attrFn)return f(a)[c](d);if(!("getAttribute"in a))return f.prop(a,c,d);var h,i,j=g!==1||!f.isXMLDoc(a);j&&(c=f.attrFix[c]||c,i=f.attrHooks[c],i||(t.test(c)?i=v:u&&(i=u)));if(d!==b){if(d===null){f.removeAttr(a,c);return b}if(i&&"set"in i&&j&&(h=i.set(a,d,c))!==b)return h;a.setAttribute(c,""+d);return d}if(i&&"get"in i&&j&&(h=i.get(a,c))!==null)return h;h=a.getAttribute(c);return h===null?b:h},removeAttr:function(a,b){var c;a.nodeType===1&&(b=f.attrFix[b]||b,f.attr(a,b,""),a.removeAttribute(b),t.test(b)&&(c=f.propFix[b]||b)in a&&(a[c]=!1))},attrHooks:{type:{set:function(a,b){if(q.test(a.nodeName)&&a.parentNode)f.error("type property can't be changed");else if(!f.support.radioValue&&b==="radio"&&f.nodeName(a,"input")){var c=a.value;a.setAttribute("type",b),c&&(a.value=c);return b}}},value:{get:function(a,b){if(u&&f.nodeName(a,"button"))return u.get(a,b);return b in a?a.value:null},set:function(a,b,c){if(u&&f.nodeName(a,"button"))return u.set(a,b,c);a.value=b}}},propFix:{tabindex:"tabIndex",readonly:"readOnly","for":"htmlFor","class":"className",maxlength:"maxLength",cellspacing:"cellSpacing",cellpadding:"cellPadding",rowspan:"rowSpan",colspan:"colSpan",usemap:"useMap",frameborder:"frameBorder",contenteditable:"contentEditable"},prop:function(a,c,d){var e=a.nodeType;if(!a||e===3||e===8||e===2)return b;var g,h,i=e!==1||!f.isXMLDoc(a);i&&(c=f.propFix[c]||c,h=f.propHooks[c]);return d!==b?h&&"set"in h&&(g=h.set(a,d,c))!==b?g:a[c]=d:h&&"get"in h&&(g=h.get(a,c))!==null?g:a[c]},propHooks:{tabIndex:{get:function(a){var c=a.getAttributeNode("tabindex");return c&&c.specified?parseInt(c.value,10):r.test(a.nodeName)||s.test(a.nodeName)&&a.href?0:b}}}}),f.attrHooks.tabIndex=f.propHooks.tabIndex,v={get:function(a,c){var d;return f.prop(a,c)===!0||(d=a.getAttributeNode(c))&&d.nodeValue!==!1?c.toLowerCase():b},set:function(a,b,c){var d;b===!1?f.removeAttr(a,c):(d=f.propFix[c]||c,d in a&&(a[d]=!0),a.setAttribute(c,c.toLowerCase()));return c}},f.support.getSetAttribute||(u=f.valHooks.button={get:function(a,c){var d;d=a.getAttributeNode(c);return d&&d.nodeValue!==""?d.nodeValue:b},set:function(a,b,d){var e=a.getAttributeNode(d);e||(e=c.createAttribute(d),a.setAttributeNode(e));return e.nodeValue=b+""}},f.each(["width","height"],function(a,b){f.attrHooks[b]=f.extend(f.attrHooks[b],{set:function(a,c){if(c===""){a.setAttribute(b,"auto");return c}}})})),f.support.hrefNormalized||f.each(["href","src","width","height"],function(a,c){f.attrHooks[c]=f.extend(f.attrHooks[c],{get:function(a){var d=a.getAttribute(c,2);return d===null?b:d}})}),f.support.style||(f.attrHooks.style={get:function(a){return a.style.cssText.toLowerCase()||b},set:function(a,b){return a.style.cssText=""+b}}),f.support.optSelected||(f.propHooks.selected=f.extend(f.propHooks.selected,{get:function(a){var b=a.parentNode;b&&(b.selectedIndex,b.parentNode&&b.parentNode.selectedIndex);return null}})),f.support.checkOn||f.each(["radio","checkbox"],function(){f.valHooks[this]={get:function(a){return a.getAttribute("value")===null?"on":a.value}}}),f.each(["radio","checkbox"],function(){f.valHooks[this]=f.extend(f.valHooks[this],{set:function(a,b){if(f.isArray(b))return a.checked=f.inArray(f(a).val(),b)>=0}})});var w=/\.(.*)$/,x=/^(?:textarea|input|select)$/i,y=/\./g,z=/ /g,A=/[^\w\s.|`]/g,B=function(a){return a.replace(A,"\\$&")};f.event={add:function(a,c,d,e){if(a.nodeType!==3&&a.nodeType!==8){if(d===!1)d=C;else if(!d)return;var g,h;d.handler&&(g=d,d=g.handler),d.guid||(d.guid=f.guid++);var i=f._data(a);if(!i)return;var j=i.events,k=i.handle;j||(i.events=j={}),k||(i.handle=k=function(a){return typeof f!="undefined"&&(!a||f.event.triggered!==a.type)?f.event.handle.apply(k.elem,arguments):b}),k.elem=a,c=c.split(" ");var l,m=0,n;while(l=c[m++]){h=g?f.extend({},g):{handler:d,data:e},l.indexOf(".")>-1?(n=l.split("."),l=n.shift(),h.namespace=n.slice(0).sort().join(".")):(n=[],h.namespace=""),h.type=l,h.guid||(h.guid=d.guid);var o=j[l],p=f.event.special[l]||{};if(!o){o=j[l]=[];if(!p.setup||p.setup.call(a,e,n,k)===!1)a.addEventListener?a.addEventListener(l,k,!1):a.attachEvent&&a.attachEvent("on"+l,k)}p.add&&(p.add.call(a,h),h.handler.guid||(h.handler.guid=d.guid)),o.push(h),f.event.global[l]=!0}a=null}},global:{},remove:function(a,c,d,e){if(a.nodeType!==3&&a.nodeType!==8){d===!1&&(d=C);var g,h,i,j,k=0,l,m,n,o,p,q,r,s=f.hasData(a)&&f._data(a),t=s&&s.events;if(!s||!t)return;c&&c.type&&(d=c.handler,c=c.type);if(!c||typeof c=="string"&&c.charAt(0)==="."){c=c||"";for(h in t)f.event.remove(a,h+c);return}c=c.split(" ");while(h=c[k++]){r=h,q=null,l=h.indexOf(".")<0,m=[],l||(m=h.split("."),h=m.shift(),n=new RegExp("(^|\\.)"+f.map(m.slice(0).sort(),B).join("\\.(?:.*\\.)?")+"(\\.|$)")),p=t[h];if(!p)continue;if(!d){for(j=0;j=0&&(h=h.slice(0,-1),j=!0),h.indexOf(".")>=0&&(i=h.split("."),h=i.shift(),i.sort());if(!!e&&!f.event.customEvent[h]||!!f.event.global[h]){c=typeof c=="object"?c[f.expando]?c:new f.Event(h,c):new f.Event(h),c.type=h,c.exclusive=j,c.namespace=i.join("."),c.namespace_re=new RegExp("(^|\\.)"+i.join("\\.(?:.*\\.)?")+"(\\.|$)");if(g||!e)c.preventDefault(),c.stopPropagation();if(!e){f.each(f.cache,function(){var a=f.expando,b=this[a];b&&b.events&&b.events[h]&&f.event.trigger(c,d,b.handle.elem)});return}if(e.nodeType===3||e.nodeType===8)return;c.result=b,c.target=e,d=d!=null?f.makeArray(d):[],d.unshift(c);var k=e,l=h.indexOf(":")<0?"on"+h:"";do{var m=f._data(k,"handle");c.currentTarget=k,m&&m.apply(k,d),l&&f.acceptData(k)&&k[l]&&k[l].apply(k,d)===!1&&(c.result=!1,c.preventDefault()),k=k.parentNode||k.ownerDocument||k===c.target.ownerDocument&&a}while(k&&!c.isPropagationStopped());if(!c.isDefaultPrevented()){var n,o=f.event.special[h]||{};if((!o._default||o._default.call(e.ownerDocument,c)===!1)&&(h!=="click"||!f.nodeName(e,"a"))&&f.acceptData(e)){try{l&&e[h]&&(n=e[l],n&&(e[l]=null),f.event.triggered=h,e[h]())}catch(p){}n&&(e[l]=n),f.event.triggered=b}}return c.result}},handle:function(c){c=f.event.fix(c||a.event);var d=((f._data(this,"events")||{})[c.type]||[]).slice(0),e=!c.exclusive&&!c.namespace,g=Array.prototype.slice.call(arguments,0);g[0]=c,c.currentTarget=this;for(var h=0,i=d.length;h-1?f.map(a.options,function(a){return a.selected}).join("-"):"":f.nodeName(a,"select")&&(c=a.selectedIndex);return c},I=function(c){var d=c.target,e,g;if(!!x.test(d.nodeName)&&!d.readOnly){e=f._data(d,"_change_data"),g=H(d),(c.type!=="focusout"||d.type!=="radio")&&f._data(d,"_change_data",g);if(e===b||g===e)return;if(e!=null||g)c.type="change",c.liveFired=b,f.event.trigger(c,arguments[1],d)}};f.event.special.change={filters:{focusout:I,beforedeactivate:I,click:function(a){var b=a.target,c=f.nodeName(b,"input")?b.type:"";(c==="radio"||c==="checkbox"||f.nodeName(b,"select"))&&I.call(this,a)},keydown:function(a){var b=a.target,c=f.nodeName(b,"input")?b.type:"";(a.keyCode===13&&!f.nodeName(b,"textarea")||a.keyCode===32&&(c==="checkbox"||c==="radio")||c==="select-multiple")&&I.call(this,a)},beforeactivate:function(a){var b=a.target;f._data(b,"_change_data",H(b))}},setup:function(a,b){if(this.type==="file")return!1;for(var c in G)f.event.add(this,c+".specialChange",G[c]);return x.test(this.nodeName)},teardown:function(a){f.event.remove(this,".specialChange");return x.test(this.nodeName)}},G=f.event.special.change.filters,G.focus=G.beforeactivate}f.support.focusinBubbles||f.each({focus:"focusin",blur:"focusout"},function(a,b){function e(a){var c=f.event.fix(a);c.type=b,c.originalEvent={},f.event.trigger(c,null,c.target),c.isDefaultPrevented()&&a.preventDefault()}var d=0;f.event.special[b]={setup:function(){d++===0&&c.addEventListener(a,e,!0)},teardown:function(){--d===0&&c.removeEventListener(a,e,!0)}}}),f.each(["bind","one"],function(a,c){f.fn[c]=function(a,d,e){var g;if(typeof a=="object"){for(var h in a)this[c](h,d,a[h],e);return this}if(arguments.length===2||d===!1)e=d,d=b;c==="one"?(g=function(a){f(this).unbind(a,g);return e.apply(this,arguments)},g.guid=e.guid||f.guid++):g=e;if(a==="unload"&&c!=="one")this.one(a,d,e);else for(var i=0,j=this.length;i0?this.bind(b,a,c):this.trigger(b)},f.attrFn&&(f.attrFn[b]=!0)}),function(){function u(a,b,c,d,e,f){for(var g=0,h=d.length;g0){j=i;break}}i=i[a]}d[g]=j}}}function t(a,b,c,d,e,f){for(var g=0,h=d.length;g+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g,d=0,e=Object.prototype.toString,g=!1,h=!0,i=/\\/g,j=/\W/;[0,0].sort(function(){h=!1;return 0});var k=function(b,d,f,g){f=f||[],d=d||c;var h=d;if(d.nodeType!==1&&d.nodeType!==9)return[];if(!b||typeof b!="string")return f;var i,j,n,o,q,r,s,t,u=!0,w=k.isXML(d),x=[],y=b;do{a.exec(""),i=a.exec(y);if(i){y=i[3],x.push(i[1]);if(i[2]){o=i[3];break}}}while(i);if(x.length>1&&m.exec(b))if(x.length===2&&l.relative[x[0]])j=v(x[0]+x[1],d);else{j=l.relative[x[0]]?[d]:k(x.shift(),d);while(x.length)b=x.shift(),l.relative[b]&&(b+=x.shift()),j=v(b,j)}else{!g&&x.length>1&&d.nodeType===9&&!w&&l.match.ID.test(x[0])&&!l.match.ID.test(x[x.length-1])&&(q=k.find(x.shift(),d,w),d=q.expr?k.filter(q.expr,q.set)[0]:q.set[0]);if(d){q=g?{expr:x.pop(),set:p(g)}:k.find(x.pop(),x.length===1&&(x[0]==="~"||x[0]==="+")&&d.parentNode?d.parentNode:d,w),j=q.expr?k.filter(q.expr,q.set):q.set,x.length>0?n=p(j):u=!1;while(x.length)r=x.pop(),s=r,l.relative[r]?s=x.pop():r="",s==null&&(s=d),l.relative[r](n,s,w)}else n=x=[]}n||(n=j),n||k.error(r||b);if(e.call(n)==="[object Array]")if(!u)f.push.apply(f,n);else if(d&&d.nodeType===1)for(t=0;n[t]!=null;t++)n[t]&&(n[t]===!0||n[t].nodeType===1&&k.contains(d,n[t]))&&f.push(j[t]);else for(t=0;n[t]!=null;t++)n[t]&&n[t].nodeType===1&&f.push(j[t]);else p(n,f);o&&(k(o,h,f,g),k.uniqueSort(f));return f};k.uniqueSort=function(a){if(r){g=h,a.sort(r);if(g)for(var b=1;b0},k.find=function(a,b,c){var d;if(!a)return[];for(var e=0,f=l.order.length;e":function(a,b){var c,d=typeof b=="string",e=0,f=a.length;if(d&&!j.test(b)){b=b.toLowerCase();for(;e=0)?c||d.push(h):c&&(b[g]=!1));return!1},ID:function(a){return a[1].replace(i,"")},TAG:function(a,b){return a[1].replace(i,"").toLowerCase()},CHILD:function(a){if(a[1]==="nth"){a[2]||k.error(a[0]),a[2]=a[2].replace(/^\+|\s*/g,"");var b=/(-?)(\d*)(?:n([+\-]?\d*))?/.exec(a[2]==="even"&&"2n"||a[2]==="odd"&&"2n+1"||!/\D/.test(a[2])&&"0n+"+a[2]||a[2]);a[2]=b[1]+(b[2]||1)-0,a[3]=b[3]-0}else a[2]&&k.error(a[0]);a[0]=d++;return a},ATTR:function(a,b,c,d,e,f){var g=a[1]=a[1].replace(i,"");!f&&l.attrMap[g]&&(a[1]=l.attrMap[g]),a[4]=(a[4]||a[5]||"").replace(i,""),a[2]==="~="&&(a[4]=" "+a[4]+" ");return a},PSEUDO:function(b,c,d,e,f){if(b[1]==="not")if((a.exec(b[3])||"").length>1||/^\w/.test(b[3]))b[3]=k(b[3],null,null,c);else{var g=k.filter(b[3],c,d,!0^f);d||e.push.apply(e,g);return!1}else if(l.match.POS.test(b[0])||l.match.CHILD.test(b[0]))return!0;return b},POS:function(a){a.unshift(!0);return a}},filters:{enabled:function(a){return a.disabled===!1&&a.type!=="hidden"},disabled:function(a){return a.disabled===!0},checked:function(a){return a.checked===!0},selected:function(a){a.parentNode&&a.parentNode.selectedIndex;return a.selected===!0},parent:function(a){return!!a.firstChild},empty:function(a){return!a.firstChild},has:function(a,b,c){return!!k(c[3],a).length},header:function(a){return/h\d/i.test(a.nodeName)},text:function(a){var b=a.getAttribute("type"),c=a.type;return a.nodeName.toLowerCase()==="input"&&"text"===c&&(b===c||b===null)},radio:function(a){return a.nodeName.toLowerCase()==="input"&&"radio"===a.type},checkbox:function(a){return a.nodeName.toLowerCase()==="input"&&"checkbox"===a.type},file:function(a){return a.nodeName.toLowerCase()==="input"&&"file"===a.type},password:function(a){return a.nodeName.toLowerCase()==="input"&&"password"===a.type},submit:function(a){var b=a.nodeName.toLowerCase();return(b==="input"||b==="button")&&"submit"===a.type},image:function(a){return a.nodeName.toLowerCase()==="input"&&"image"===a.type},reset:function(a){var b=a.nodeName.toLowerCase();return(b==="input"||b==="button")&&"reset"===a.type},button:function(a){var b=a.nodeName.toLowerCase();return b==="input"&&"button"===a.type||b==="button"},input:function(a){return/input|select|textarea|button/i.test(a.nodeName)},focus:function(a){return a===a.ownerDocument.activeElement}},setFilters:{first:function(a,b){return b===0},last:function(a,b,c,d){return b===d.length-1},even:function(a,b){return b%2===0},odd:function(a,b){return b%2===1},lt:function(a,b,c){return bc[3]-0},nth:function(a,b,c){return c[3]-0===b},eq:function(a,b,c){return c[3]-0===b}},filter:{PSEUDO:function(a,b,c,d){var e=b[1],f=l.filters[e];if(f)return f(a,c,b,d);if(e==="contains")return(a.textContent||a.innerText||k.getText([a])||"").indexOf(b[3])>=0;if(e==="not"){var g=b[3];for(var h=0,i=g.length;h=0}},ID:function(a,b){return a.nodeType===1&&a.getAttribute("id")===b},TAG:function(a,b){return b==="*"&&a.nodeType===1||a.nodeName.toLowerCase()===b},CLASS:function(a,b){return(" "+(a.className||a.getAttribute("class"))+" ").indexOf(b)>-1},ATTR:function(a,b){var c=b[1],d=l.attrHandle[c]?l.attrHandle[c](a):a[c]!=null?a[c]:a.getAttribute(c),e=d+"",f=b[2],g=b[4];return d==null?f==="!=":f==="="?e===g:f==="*="?e.indexOf(g)>=0:f==="~="?(" "+e+" ").indexOf(g)>=0:g?f==="!="?e!==g:f==="^="?e.indexOf(g)===0:f==="$="?e.substr(e.length-g.length)===g:f==="|="?e===g||e.substr(0,g.length+1)===g+"-":!1:e&&d!==!1},POS:function(a,b,c,d){var e=b[2],f=l.setFilters[e];if(f)return f(a,c,b,d)}}},m=l.match.POS,n=function(a,b){return"\\"+(b-0+1)};for(var o in l.match)l.match[o]=new RegExp(l.match[o].source+/(?![^\[]*\])(?![^\(]*\))/.source),l.leftMatch[o]=new RegExp(/(^(?:.|\r|\n)*?)/.source+l.match[o].source.replace(/\\(\d+)/g,n));var p=function(a,b){a=Array.prototype.slice.call(a,0);if(b){b.push.apply(b,a);return b}return a};try{Array.prototype.slice.call(c.documentElement.childNodes,0)[0].nodeType}catch(q){p=function(a,b){var c=0,d=b||[];if(e.call(a)==="[object Array]")Array.prototype.push.apply(d,a);else if(typeof a.length=="number")for(var f=a.length;c",e.insertBefore(a,e.firstChild),c.getElementById(d)&&(l.find.ID=function(a,c,d){if(typeof c.getElementById!="undefined"&&!d){var e=c.getElementById(a[1]);return e?e.id===a[1]||typeof e.getAttributeNode!="undefined"&&e.getAttributeNode("id").nodeValue===a[1]?[e]:b:[]}},l.filter.ID=function(a,b){var c=typeof a.getAttributeNode!="undefined"&&a.getAttributeNode("id");return a.nodeType===1&&c&&c.nodeValue===b}),e.removeChild(a),e=a=null}(),function(){var a=c.createElement("div");a.appendChild(c.createComment("")),a.getElementsByTagName("*").length>0&&(l.find.TAG=function(a,b){var c=b.getElementsByTagName(a[1]);if(a[1]==="*"){var d=[];for(var e=0;c[e];e++)c[e].nodeType===1&&d.push(c[e]);c=d}return c}),a.innerHTML="",a.firstChild&&typeof a.firstChild.getAttribute!="undefined"&&a.firstChild.getAttribute("href")!=="#"&&(l.attrHandle.href=function(a){return a.getAttribute("href",2)}),a=null}(),c.querySelectorAll&&function(){var a=k,b=c.createElement("div"),d="__sizzle__";b.innerHTML="

";if(!b.querySelectorAll||b.querySelectorAll(".TEST").length!==0){k=function(b,e,f,g){e=e||c;if(!g&&!k.isXML(e)){var h=/^(\w+$)|^\.([\w\-]+$)|^#([\w\-]+$)/.exec(b);if(h&&(e.nodeType===1||e.nodeType===9)){if(h[1])return p(e.getElementsByTagName(b),f);if(h[2]&&l.find.CLASS&&e.getElementsByClassName)return p(e.getElementsByClassName(h[2]),f)}if(e.nodeType===9){if(b==="body"&&e.body)return p([e.body],f);if(h&&h[3]){var i=e.getElementById(h[3]);if(!i||!i.parentNode)return p([],f);if(i.id===h[3])return p([i],f)}try{return p(e.querySelectorAll(b),f)}catch(j){}}else if(e.nodeType===1&&e.nodeName.toLowerCase()!=="object"){var m=e,n=e.getAttribute("id"),o=n||d,q=e.parentNode,r=/^\s*[+~]/.test(b);n?o=o.replace(/'/g,"\\$&"):e.setAttribute("id",o),r&&q&&(e=e.parentNode);try{if(!r||q)return p(e.querySelectorAll("[id='"+o+"'] "+b),f)}catch(s){}finally{n||m.removeAttribute("id")}}}return a(b,e,f,g)};for(var e in a)k[e]=a[e];b=null}}(),function(){var a=c.documentElement,b=a.matchesSelector||a.mozMatchesSelector||a.webkitMatchesSelector||a.msMatchesSelector;if(b){var d=!b.call(c.createElement("div"),"div"),e=!1;try{b.call(c.documentElement,"[test!='']:sizzle")}catch(f){e=!0}k.matchesSelector=function(a,c){c=c.replace(/\=\s*([^'"\]]*)\s*\]/g,"='$1']");if(!k.isXML(a))try{if(e||!l.match.PSEUDO.test(c)&&!/!=/.test(c)){var f=b.call(a,c);if(f||!d||a.document&&a.document.nodeType!==11)return f}}catch(g){}return k(c,null,null,[a]).length>0}}}(),function(){var a=c.createElement("div");a.innerHTML="
";if(!!a.getElementsByClassName&&a.getElementsByClassName("e").length!==0){a.lastChild.className="e";if(a.getElementsByClassName("e").length===1)return;l.order.splice(1,0,"CLASS"),l.find.CLASS=function(a,b,c){if(typeof b.getElementsByClassName!="undefined"&&!c)return b.getElementsByClassName(a[1])},a=null}}(),c.documentElement.contains?k.contains=function(a,b){return a!==b&&(a.contains?a.contains(b):!0)}:c.documentElement.compareDocumentPosition?k.contains=function(a,b){return!!(a.compareDocumentPosition(b)&16)}:k.contains=function(){return!1},k.isXML=function(a){var b=(a?a.ownerDocument||a:0).documentElement;return b?b.nodeName!=="HTML":!1};var v=function(a,b){var c,d=[],e="",f=b.nodeType?[b]:b;while(c=l.match.PSEUDO.exec(a))e+=c[0],a=a.replace(l.match.PSEUDO,"");a=l.relative[a]?a+"*":a;for(var g=0,h=f.length;g0)for(h=g;h0:this.filter(a).length>0)},closest:function(a,b){var c=[],d,e,g=this[0];if(f.isArray(a)){var h,i,j={},k=1;if(g&&a.length){for(d=0,e=a.length;d-1:f(g).is(h))&&c.push({selector:i,elem:g,level:k});g=g.parentNode,k++}}return c}var l=S.test(a)||typeof a!="string"?f(a,b||this.context):0;for(d=0,e=this.length;d-1:f.find.matchesSelector(g,a)){c.push(g);break}g=g.parentNode;if(!g||!g.ownerDocument||g===b||g.nodeType===11)break}}c=c.length>1?f.unique(c):c;return this.pushStack(c,"closest",a)},index:function(a){if(!a)return this[0]&&this[0].parentNode?this.prevAll().length:-1;if(typeof a=="string")return f.inArray(this[0],f(a));return f.inArray(a.jquery?a[0]:a,this)},add:function(a,b){var c=typeof a=="string"?f(a,b):f.makeArray(a&&a.nodeType?[a]:a),d=f.merge(this.get(),c);return this.pushStack(U(c[0])||U(d[0])?d:f.unique(d))},andSelf:function(){return this.add(this.prevObject)}}),f.each({parent:function(a){var b=a.parentNode;return b&&b.nodeType!==11?b:null},parents:function(a){return f.dir(a,"parentNode")},parentsUntil:function(a,b,c){return f.dir(a,"parentNode",c)},next:function(a){return f.nth(a,2,"nextSibling")},prev:function(a){return f.nth(a,2,"previousSibling")},nextAll:function(a){return f.dir(a,"nextSibling")},prevAll:function(a){return f.dir(a,"previousSibling")},nextUntil:function(a,b,c){return f.dir(a,"nextSibling",c)},prevUntil:function(a,b,c){return f.dir(a,"previousSibling",c)},siblings:function(a){return f.sibling(a.parentNode.firstChild,a)},children:function(a){return f.sibling(a.firstChild)},contents:function(a){return f.nodeName(a,"iframe")?a.contentDocument||a.contentWindow.document:f.makeArray(a.childNodes)}},function(a,b){f.fn[a]=function(c,d){var e=f.map(this,b,c),g=R.call(arguments);N.test(a)||(d=c),d&&typeof d=="string"&&(e=f.filter(d,e)),e=this.length>1&&!T[a]?f.unique(e):e,(this.length>1||P.test(d))&&O.test(a)&&(e=e.reverse());return this.pushStack(e,a,g.join(","))}}),f.extend({filter:function(a,b,c){c&&(a=":not("+a+")");return b.length===1?f.find.matchesSelector(b[0],a)?[b[0]]:[]:f.find.matches(a,b)},dir:function(a,c,d){var e=[],g=a[c];while(g&&g.nodeType!==9&&(d===b||g.nodeType!==1||!f(g).is(d)))g.nodeType===1&&e.push(g),g=g[c];return e},nth:function(a,b,c,d){b=b||1;var e=0;for(;a;a=a[c])if(a.nodeType===1&&++e===b)break;return a},sibling:function(a,b){var c=[];for(;a;a=a.nextSibling)a.nodeType===1&&a!==b&&c.push(a);return c}});var W=/ jQuery\d+="(?:\d+|null)"/g,X=/^\s+/,Y=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/ig,Z=/<([\w:]+)/,$=/",""],legend:[1,"
","
"],thead:[1,"","
"],tr:[2,"","
"],td:[3,"","
"],col:[2,"","
"],area:[1,"",""],_default:[0,"",""]};be.optgroup=be.option,be.tbody=be.tfoot=be.colgroup=be.caption=be.thead,be.th=be.td,f.support.htmlSerialize||(be._default=[1,"div
","
"]),f.fn.extend({text:function(a){if(f.isFunction(a))return this.each(function(b){var c=f(this);c.text(a.call(this,b,c.text()))});if(typeof a!="object"&&a!==b)return this.empty().append((this[0]&&this[0].ownerDocument||c).createTextNode(a));return f.text(this)},wrapAll:function(a){if(f.isFunction(a))return this.each(function(b){f(this).wrapAll(a.call(this,b))});if(this[0]){var b=f(a,this[0].ownerDocument).eq(0).clone(!0);this[0].parentNode&&b.insertBefore(this[0]),b.map(function(){var a=this;while(a.firstChild&&a.firstChild.nodeType===1)a=a.firstChild;return a}).append(this)}return this},wrapInner:function(a){if(f.isFunction(a))return this.each(function(b){f(this).wrapInner(a.call(this,b))});return this.each(function(){var b=f(this),c=b.contents();c.length?c.wrapAll(a):b.append(a)})},wrap:function(a){return this.each(function(){f(this).wrapAll(a)})},unwrap:function(){return this.parent().each(function(){f.nodeName(this,"body")||f(this).replaceWith(this.childNodes)}).end()},append:function(){return this.domManip(arguments,!0,function(a){this.nodeType===1&&this.appendChild(a)})},prepend:function(){return this.domManip(arguments,!0,function(a){this.nodeType===1&&this.insertBefore(a,this.firstChild)})},before:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,!1,function(a){this.parentNode.insertBefore(a,this)});if(arguments.length){var a=f(arguments[0]);a.push.apply(a,this.toArray());return this.pushStack(a,"before",arguments)}},after:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,!1,function(a){this.parentNode.insertBefore(a,this.nextSibling)});if(arguments.length){var a=this.pushStack(this,"after",arguments);a.push.apply(a,f(arguments[0]).toArray());return a}},remove:function(a,b){for(var c=0,d;(d=this[c])!=null;c++)if(!a||f.filter(a,[d]).length)!b&&d.nodeType===1&&(f.cleanData(d.getElementsByTagName("*")),f.cleanData([d])),d.parentNode&&d.parentNode.removeChild(d);return this},empty:function(){for(var a=0,b;(b=this[a])!=null;a++){b.nodeType===1&&f.cleanData(b.getElementsByTagName("*"));while(b.firstChild)b.removeChild(b.firstChild)}return this},clone:function(a,b){a=a==null?!1:a,b=b==null?a:b;return this.map(function(){return f.clone(this,a,b)})},html:function(a){if(a===b)return this[0]&&this[0].nodeType===1?this[0].innerHTML.replace(W,""):null;if(typeof a=="string"&&!ba.test(a)&&(f.support.leadingWhitespace||!X.test(a))&&!be[(Z.exec(a)||["",""])[1].toLowerCase()]){a=a.replace(Y,"<$1>");try{for(var c=0,d=this.length;c1&&l0?this.clone(!0):this).get();f(e[h])[b](j),d=d.concat(j)}return this.pushStack(d,a,e.selector)}}),f.extend({clone:function(a,b,c){var d=a.cloneNode(!0),e,g,h;if((!f.support.noCloneEvent||!f.support.noCloneChecked)&&(a.nodeType===1||a.nodeType===11)&&!f.isXMLDoc(a)){bh(a,d),e=bi(a),g=bi(d);for(h=0;e[h];++h)g[h]&&bh(e[h],g[h])}if(b){bg(a,d);if(c){e=bi(a),g=bi(d);for(h=0;e[h];++h)bg(e[h],g[h])}}e=g=null;return d},clean:function(a,b,d,e){var g;b=b||c,typeof b.createElement=="undefined"&&(b=b.ownerDocument||b[0]&&b[0].ownerDocument||c);var h=[],i;for(var j=0,k;(k=a[j])!=null;j++){typeof k=="number"&&(k+="");if(!k)continue;if(typeof k=="string")if(!_.test(k))k=b.createTextNode(k);else{k=k.replace(Y,"<$1>");var l=(Z.exec(k)||["",""])[1].toLowerCase(),m=be[l]||be._default,n=m[0],o=b.createElement("div");o.innerHTML=m[1]+k+m[2];while(n--)o=o.lastChild;if(!f.support.tbody){var p=$.test(k),q=l==="table"&&!p?o.firstChild&&o.firstChild.childNodes:m[1]===""&&!p?o.childNodes:[];for(i=q.length-1;i>=0;--i)f.nodeName(q[i],"tbody")&&!q[i].childNodes.length&&q[i].parentNode.removeChild(q[i])}!f.support.leadingWhitespace&&X.test(k)&&o.insertBefore(b.createTextNode(X.exec(k)[0]),o.firstChild),k=o.childNodes}var r;if(!f.support.appendChecked)if(k[0]&&typeof (r=k.length)=="number")for(i=0;i=0)return b+"px"}}}),f.support.opacity||(f.cssHooks.opacity={get:function(a,b){return bn.test((b&&a.currentStyle?a.currentStyle.filter:a.style.filter)||"")?parseFloat(RegExp.$1)/100+"":b?"1":""},set:function(a,b){var c=a.style,d=a.currentStyle,e=f.isNaN(b)?"":"alpha(opacity="+b*100+")",g=d&&d.filter||c.filter||"";c.zoom=1;if(b>=1&&f.trim(g.replace(bm,""))===""){c.removeAttribute("filter");if(d&&!d.filter)return}c.filter=bm.test(g)?g.replace(bm,e):g+" "+e}}),f(function(){f.support.reliableMarginRight||(f.cssHooks.marginRight={get:function(a,b){var c;f.swap(a,{display:"inline-block"},function(){b?c=bv(a,"margin-right","marginRight"):c=a.style.marginRight});return c}})}),c.defaultView&&c.defaultView.getComputedStyle&&(bw=function(a,c){var d,e,g;c=c.replace(bo,"-$1").toLowerCase();if(!(e=a.ownerDocument.defaultView))return b;if(g=e.getComputedStyle(a,null))d=g.getPropertyValue(c),d===""&&!f.contains(a.ownerDocument.documentElement,a)&&(d=f.style(a,c));return d}),c.documentElement.currentStyle&&(bx=function(a,b){var c,d=a.currentStyle&&a.currentStyle[b],e=a.runtimeStyle&&a.runtimeStyle[b],f=a.style;!bp.test(d)&&bq.test(d)&&(c=f.left,e&&(a.runtimeStyle.left=a.currentStyle.left),f.left=b==="fontSize"?"1em":d||0,d=f.pixelLeft+"px",f.left=c,e&&(a.runtimeStyle.left=e));return d===""?"auto":d}),bv=bw||bx,f.expr&&f.expr.filters&&(f.expr.filters.hidden=function(a){var b=a.offsetWidth,c=a.offsetHeight;return b===0&&c===0||!f.support.reliableHiddenOffsets&&(a.style.display||f.css(a,"display"))==="none"},f.expr.filters.visible=function(a){return!f.expr.filters.hidden(a)});var bz=/%20/g,bA=/\[\]$/,bB=/\r?\n/g,bC=/#.*$/,bD=/^(.*?):[ \t]*([^\r\n]*)\r?$/mg,bE=/^(?:color|date|datetime|datetime-local|email|hidden|month|number|password|range|search|tel|text|time|url|week)$/i,bF=/^(?:about|app|app\-storage|.+\-extension|file|res|widget):$/,bG=/^(?:GET|HEAD)$/,bH=/^\/\//,bI=/\?/,bJ=/)<[^<]*)*<\/script>/gi,bK=/^(?:select|textarea)/i,bL=/\s+/,bM=/([?&])_=[^&]*/,bN=/^([\w\+\.\-]+:)(?:\/\/([^\/?#:]*)(?::(\d+))?)?/,bO=f.fn.load,bP={},bQ={},bR,bS,bT=["*/"]+["*"];try{bR=e.href}catch(bU){bR=c.createElement("a"),bR.href="",bR=bR.href}bS=bN.exec(bR.toLowerCase())||[],f.fn.extend({load:function(a,c,d){if(typeof a!="string"&&bO)return bO.apply(this,arguments);if(!this.length)return this;var e=a.indexOf(" ");if(e>=0){var g=a.slice(e,a.length);a=a.slice(0,e)}var h="GET";c&&(f.isFunction(c)?(d=c,c=b):typeof c=="object"&&(c=f.param(c,f.ajaxSettings.traditional),h="POST"));var i=this;f.ajax({url:a,type:h,dataType:"html",data:c,complete:function(a,b,c){c=a.responseText,a.isResolved()&&(a.done(function(a){c=a}),i.html(g?f("
").append(c.replace(bJ,"")).find(g):c)),d&&i.each(d,[c,b,a])}});return this},serialize:function(){return f.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?f.makeArray(this.elements):this}).filter(function(){return this.name&&!this.disabled&&(this.checked||bK.test(this.nodeName)||bE.test(this.type))}).map(function(a,b){var c=f(this).val();return c==null?null:f.isArray(c)?f.map(c,function(a,c){return{name:b.name,value:a.replace(bB,"\r\n")}}):{name:b.name,value:c.replace(bB,"\r\n")}}).get()}}),f.each("ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split(" "),function(a,b){f.fn[b]=function(a){return this.bind(b,a)}}),f.each(["get","post"],function(a,c){f[c]=function(a,d,e,g){f.isFunction(d)&&(g=g||e,e=d,d=b);return f.ajax({type:c,url:a,data:d,success:e,dataType:g})}}),f.extend({getScript:function(a,c){return f.get(a,b,c,"script")},getJSON:function(a,b,c){return f.get(a,b,c,"json")},ajaxSetup:function(a,b){b?bX(a,f.ajaxSettings):(b=a,a=f.ajaxSettings),bX(a,b);return a},ajaxSettings:{url:bR,isLocal:bF.test(bS[1]),global:!0,type:"GET",contentType:"application/x-www-form-urlencoded",processData:!0,async:!0,accepts:{xml:"application/xml, text/xml",html:"text/html",text:"text/plain",json:"application/json, text/javascript","*":bT},contents:{xml:/xml/,html:/html/,json:/json/},responseFields:{xml:"responseXML",text:"responseText"},converters:{"* text":a.String,"text html":!0,"text json":f.parseJSON,"text xml":f.parseXML},flatOptions:{context:!0,url:!0}},ajaxPrefilter:bV(bP),ajaxTransport:bV(bQ),ajax:function(a,c){function w(a,c,l,m){if(s!==2){s=2,q&&clearTimeout(q),p=b,n=m||"",v.readyState=a>0?4:0;var o,r,u,w=c,x=l?bZ(d,v,l):b,y,z;if(a>=200&&a<300||a===304){if(d.ifModified){if(y=v.getResponseHeader("Last-Modified"))f.lastModified[k]=y;if(z=v.getResponseHeader("Etag"))f.etag[k]=z}if(a===304)w="notmodified",o=!0;else try{r=b$(d,x),w="success",o=!0}catch(A){w="parsererror",u=A}}else{u=w;if(!w||a)w="error",a<0&&(a=0)}v.status=a,v.statusText=""+(c||w),o?h.resolveWith(e,[r,w,v]):h.rejectWith(e,[v,w,u]),v.statusCode(j),j=b,t&&g.trigger("ajax"+(o?"Success":"Error"),[v,d,o?r:u]),i.resolveWith(e,[v,w]),t&&(g.trigger("ajaxComplete",[v,d]),--f.active||f.event.trigger("ajaxStop"))}}typeof a=="object"&&(c=a,a=b),c=c||{};var d=f.ajaxSetup({},c),e=d.context||d,g=e!==d&&(e.nodeType||e instanceof f)?f(e):f.event,h=f.Deferred(),i=f._Deferred(),j=d.statusCode||{},k,l={},m={},n,o,p,q,r,s=0,t,u,v={readyState:0,setRequestHeader:function(a,b){if(!s){var c=a.toLowerCase();a=m[c]=m[c]||a,l[a]=b}return this},getAllResponseHeaders:function(){return s===2?n:null},getResponseHeader:function(a){var c;if(s===2){if(!o){o={};while(c=bD.exec(n))o[c[1].toLowerCase()]=c[2]}c=o[a.toLowerCase()]}return c===b?null:c},overrideMimeType:function(a){s||(d.mimeType=a);return this},abort:function(a){a=a||"abort",p&&p.abort(a),w(0,a);return this}};h.promise(v),v.success=v.done,v.error=v.fail,v.complete=i.done,v.statusCode=function(a){if(a){var b;if(s<2)for(b in a)j[b]=[j[b],a[b]];else b=a[v.status],v.then(b,b)}return this},d.url=((a||d.url)+"").replace(bC,"").replace(bH,bS[1]+"//"),d.dataTypes=f.trim(d.dataType||"*").toLowerCase().split(bL),d.crossDomain==null&&(r=bN.exec(d.url.toLowerCase()),d.crossDomain=!(!r||r[1]==bS[1]&&r[2]==bS[2]&&(r[3]||(r[1]==="http:"?80:443))==(bS[3]||(bS[1]==="http:"?80:443)))),d.data&&d.processData&&typeof d.data!="string"&&(d.data=f.param(d.data,d.traditional)),bW(bP,d,c,v);if(s===2)return!1;t=d.global,d.type=d.type.toUpperCase(),d.hasContent=!bG.test(d.type),t&&f.active++===0&&f.event.trigger("ajaxStart");if(!d.hasContent){d.data&&(d.url+=(bI.test(d.url)?"&":"?")+d.data,delete d.data),k=d.url;if(d.cache===!1){var x=f.now(),y=d.url.replace(bM,"$1_="+x);d.url=y+(y===d.url?(bI.test(d.url)?"&":"?")+"_="+x:"")}}(d.data&&d.hasContent&&d.contentType!==!1||c.contentType)&&v.setRequestHeader("Content-Type",d.contentType),d.ifModified&&(k=k||d.url,f.lastModified[k]&&v.setRequestHeader("If-Modified-Since",f.lastModified[k]),f.etag[k]&&v.setRequestHeader("If-None-Match",f.etag[k])),v.setRequestHeader("Accept",d.dataTypes[0]&&d.accepts[d.dataTypes[0]]?d.accepts[d.dataTypes[0]]+(d.dataTypes[0]!=="*"?", "+bT+"; q=0.01":""):d.accepts["*"]);for(u in d.headers)v.setRequestHeader(u,d.headers[u]);if(d.beforeSend&&(d.beforeSend.call(e,v,d)===!1||s===2)){v.abort();return!1}for(u in{success:1,error:1,complete:1})v[u](d[u]);p=bW(bQ,d,c,v);if(!p)w(-1,"No Transport");else{v.readyState=1,t&&g.trigger("ajaxSend",[v,d]),d.async&&d.timeout>0&&(q=setTimeout(function(){v.abort("timeout")},d.timeout));try{s=1,p.send(l,w)}catch(z){s<2?w(-1,z):f.error(z)}}return v},param:function(a,c){var d=[],e=function(a,b){b=f.isFunction(b)?b():b,d[d.length]=encodeURIComponent(a)+"="+encodeURIComponent(b)};c===b&&(c=f.ajaxSettings.traditional);if(f.isArray(a)||a.jquery&&!f.isPlainObject(a))f.each(a,function(){e(this.name,this.value)});else for(var g in a)bY(g,a[g],c,e);return d.join("&").replace(bz,"+")}}),f.extend({active:0,lastModified:{},etag:{}});var b_=f.now(),ca=/(\=)\?(&|$)|\?\?/i;f.ajaxSetup({jsonp:"callback",jsonpCallback:function(){return f.expando+"_"+b_++}}),f.ajaxPrefilter("json jsonp",function(b,c,d){var e=b.contentType==="application/x-www-form-urlencoded"&&typeof b.data=="string";if(b.dataTypes[0]==="jsonp"||b.jsonp!==!1&&(ca.test(b.url)||e&&ca.test(b.data))){var g,h=b.jsonpCallback=f.isFunction(b.jsonpCallback)?b.jsonpCallback():b.jsonpCallback,i=a[h],j=b.url,k=b.data,l="$1"+h+"$2";b.jsonp!==!1&&(j=j.replace(ca,l),b.url===j&&(e&&(k=k.replace(ca,l)),b.data===k&&(j+=(/\?/.test(j)?"&":"?")+b.jsonp+"="+h))),b.url=j,b.data=k,a[h]=function(a){g=[a]},d.always(function(){a[h]=i,g&&f.isFunction(i)&&a[h](g[0])}),b.converters["script json"]=function(){g||f.error(h+" was not called");return g[0]},b.dataTypes[0]="json";return"script"}}),f.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/javascript|ecmascript/},converters:{"text script":function(a){f.globalEval(a);return a}}}),f.ajaxPrefilter("script",function(a){a.cache===b&&(a.cache=!1),a.crossDomain&&(a.type="GET",a.global=!1)}),f.ajaxTransport("script",function(a){if(a.crossDomain){var d,e=c.head||c.getElementsByTagName("head")[0]||c.documentElement;return{send:function(f,g){d=c.createElement("script"),d.async="async",a.scriptCharset&&(d.charset=a.scriptCharset),d.src=a.url,d.onload=d.onreadystatechange=function(a,c){if(c||!d.readyState||/loaded|complete/.test(d.readyState))d.onload=d.onreadystatechange=null,e&&d.parentNode&&e.removeChild(d),d=b,c||g(200,"success")},e.insertBefore(d,e.firstChild)},abort:function(){d&&d.onload(0,1)}}}});var cb=a.ActiveXObject?function(){for(var a in cd)cd[a](0,1)}:!1,cc=0,cd;f.ajaxSettings.xhr=a.ActiveXObject?function(){return!this.isLocal&&ce()||cf()}:ce,function(a){f.extend(f.support,{ajax:!!a,cors:!!a&&"withCredentials"in a})}(f.ajaxSettings.xhr()),f.support.ajax&&f.ajaxTransport(function(c){if(!c.crossDomain||f.support.cors){var d;return{send:function(e,g){var h=c.xhr(),i,j;c.username?h.open(c.type,c.url,c.async,c.username,c.password):h.open(c.type,c.url,c.async);if(c.xhrFields)for(j in c.xhrFields)h[j]=c.xhrFields[j];c.mimeType&&h.overrideMimeType&&h.overrideMimeType(c.mimeType),!c.crossDomain&&!e["X-Requested-With"]&&(e["X-Requested-With"]="XMLHttpRequest");try{for(j in e)h.setRequestHeader(j,e[j])}catch(k){}h.send(c.hasContent&&c.data||null),d=function(a,e){var j,k,l,m,n;try{if(d&&(e||h.readyState===4)){d=b,i&&(h.onreadystatechange=f.noop,cb&&delete cd[i]);if(e)h.readyState!==4&&h.abort();else{j=h.status,l=h.getAllResponseHeaders(),m={},n=h.responseXML,n&&n.documentElement&&(m.xml=n),m.text=h.responseText;try{k=h.statusText}catch(o){k=""}!j&&c.isLocal&&!c.crossDomain?j=m.text?200:404:j===1223&&(j=204)}}}catch(p){e||g(-1,p)}m&&g(j,k,m,l)},!c.async||h.readyState===4?d():(i=++cc,cb&&(cd||(cd={},f(a).unload(cb)),cd[i]=d),h.onreadystatechange=d)},abort:function(){d&&d(0,1)}}}});var cg={},ch,ci,cj=/^(?:toggle|show|hide)$/,ck=/^([+\-]=)?([\d+.\-]+)([a-z%]*)$/i,cl,cm=[["height","marginTop","marginBottom","paddingTop","paddingBottom"],["width","marginLeft","marginRight","paddingLeft","paddingRight"],["opacity"]],cn;f.fn.extend({show:function(a,b,c){var d,e;if(a||a===0)return this.animate(cq("show",3),a,b,c);for(var g=0,h=this.length;g=e.duration+this.startTime){this.now=this.end,this.pos=this.state=1,this.update(),e.animatedProperties[this.prop]=!0;for(g in e.animatedProperties)e.animatedProperties[g]!==!0&&(c=!1);if(c){e.overflow!=null&&!f.support.shrinkWrapBlocks&&f.each(["","X","Y"],function(a,b){d.style["overflow"+b]=e.overflow[a]}),e.hide&&f(d).hide();if(e.hide||e.show)for(var i in e.animatedProperties)f.style(d,i,e.orig[i]);e.complete.call(d)}return!1}e.duration==Infinity?this.now=b:(h=b-this.startTime,this.state=h/e.duration,this.pos=f.easing[e.animatedProperties[this.prop]](this.state,h,0,1,e.duration),this.now=this.start+(this.end-this.start)*this.pos),this.update();return!0}},f.extend(f.fx,{tick:function(){for(var a=f.timers,b=0;b
";f.extend(b.style,{position:"absolute",top:0,left:0,margin:0,border:0,width:"1px",height:"1px",visibility:"hidden"}),b.innerHTML=j,a.insertBefore(b,a.firstChild),d=b.firstChild,e=d.firstChild,h=d.nextSibling.firstChild.firstChild,this.doesNotAddBorder=e.offsetTop!==5,this.doesAddBorderForTableAndCells=h.offsetTop===5,e.style.position="fixed",e.style.top="20px",this.supportsFixedPosition=e.offsetTop===20||e.offsetTop===15,e.style.position=e.style.top="",d.style.overflow="hidden",d.style.position="relative",this.subtractsBorderForOverflowNotVisible=e.offsetTop===-5,this.doesNotIncludeMarginInBodyOffset=a.offsetTop!==i,a.removeChild(b),f.offset.initialize=f.noop},bodyOffset:function(a){var b=a.offsetTop,c=a.offsetLeft;f.offset.initialize(),f.offset.doesNotIncludeMarginInBodyOffset&&(b+=parseFloat(f.css(a,"marginTop"))||0,c+=parseFloat(f.css(a,"marginLeft"))||0);return{top:b,left:c}},setOffset:function(a,b,c){var d=f.css(a,"position");d==="static"&&(a.style.position="relative");var e=f(a),g=e.offset(),h=f.css(a,"top"),i=f.css(a,"left"),j=(d==="absolute"||d==="fixed")&&f.inArray("auto",[h,i])>-1,k={},l={},m,n;j?(l=e.position(),m=l.top,n=l.left):(m=parseFloat(h)||0,n=parseFloat(i)||0),f.isFunction(b)&&(b=b.call(a,c,g)),b.top!=null&&(k.top=b.top-g.top+m),b.left!=null&&(k.left=b.left-g.left+n),"using"in b?b.using.call(a,k):e.css(k)}},f.fn.extend({position:function(){if(!this[0])return null;var a=this[0],b=this.offsetParent(),c=this.offset(),d=ct.test(b[0].nodeName)?{top:0,left:0}:b.offset();c.top-=parseFloat(f.css(a,"marginTop"))||0,c.left-=parseFloat(f.css(a,"marginLeft"))||0,d.top+=parseFloat(f.css(b[0],"borderTopWidth"))||0,d.left+=parseFloat(f.css(b[0],"borderLeftWidth"))||0;return{top:c.top-d.top,left:c.left-d.left}},offsetParent:function(){return this.map(function(){var a=this.offsetParent||c.body;while(a&&!ct.test(a.nodeName)&&f.css(a,"position")==="static")a=a.offsetParent;return a})}}),f.each(["Left","Top"],function(a,c){var d="scroll"+c;f.fn[d]=function(c){var e,g;if(c===b){e=this[0];if(!e)return null;g=cu(e);return g?"pageXOffset"in g?g[a?"pageYOffset":"pageXOffset"]:f.support.boxModel&&g.document.documentElement[d]||g.document.body[d]:e[d]}return this.each(function(){g=cu(this),g?g.scrollTo(a?f(g).scrollLeft():c,a?c:f(g).scrollTop()):this[d]=c})}}),f.each(["Height","Width"],function(a,c){var d=c.toLowerCase();f.fn["inner"+c]=function(){var a=this[0];return a&&a.style?parseFloat(f.css(a,d,"padding")):null},f.fn["outer"+c]=function(a){var b=this[0];return b&&b.style?parseFloat(f.css(b,d,a?"margin":"border")):null},f.fn[d]=function(a){var e=this[0];if(!e)return a==null?null:this;if(f.isFunction(a))return this.each(function(b){var c=f(this);c[d](a.call(this,b,c[d]()))});if(f.isWindow(e)){var g=e.document.documentElement["client"+c],h=e.document.body;return e.document.compatMode==="CSS1Compat"&&g||h&&h["client"+c]||g}if(e.nodeType===9)return Math.max(e.documentElement["client"+c],e.body["scroll"+c],e.documentElement["scroll"+c],e.body["offset"+c],e.documentElement["offset"+c]);if(a===b){var i=f.css(e,d),j=parseFloat(i);return f.isNaN(j)?i:j}return this.css(d,typeof a=="string"?a:a+"px")}}),a.jQuery=a.$=f})(window); \ No newline at end of file diff --git a/examples/chat_server/Makefile b/examples/chat_server/Makefile index 2afcf3bbfd..06150c10ab 100644 --- a/examples/chat_server/Makefile +++ b/examples/chat_server/Makefile @@ -5,9 +5,9 @@ CXX ?= c++ SHARED ?= "1" ifeq ($(SHARED), 1) - LDFLAGS := $(LDFLAGS) -lboost_system -lwebsocketpp + LDFLAGS := $(LDFLAGS) -lboost_system -boost_date_time -lwebsocketpp else - LDFLAGS := $(LDFLAGS) -lboost_system ../../libwebsocketpp.a + LDFLAGS := $(LDFLAGS) -lboost_system -lboost_date_time ../../libwebsocketpp.a endif chat_server: chat_server.o chat.o diff --git a/examples/chat_server/chat.cpp b/examples/chat_server/chat.cpp index 6cd0fbbebc..4db52eaeb1 100644 --- a/examples/chat_server/chat.cpp +++ b/examples/chat_server/chat.cpp @@ -29,15 +29,15 @@ #include -using websocketchat::chat_handler; +using websocketchat::chat_server_handler; using websocketpp::session_ptr; -void chat_handler::validate(session_ptr client) { +void chat_server_handler::validate(session_ptr client) { std::stringstream err; // We only know about the chat resource - if (client->get_request() != "/chat") { - err << "Request for unknown resource " << client->get_request(); + if (client->get_resource() != "/chat") { + err << "Request for unknown resource " << client->get_resource(); throw(websocketpp::handshake_error(err.str(),404)); } @@ -49,7 +49,7 @@ void chat_handler::validate(session_ptr client) { } -void chat_handler::connect(session_ptr client) { +void chat_server_handler::on_open(session_ptr client) { std::cout << "client " << client << " joined the lobby." << std::endl; m_connections.insert(std::pair(client,get_con_id(client))); @@ -59,7 +59,7 @@ void chat_handler::connect(session_ptr client) { send_to_all(encode_message("server",m_connections[client]+" has joined the chat.")); } -void chat_handler::disconnect(session_ptr client,uint16_t status,const std::string &reason) { +void chat_server_handler::on_close(session_ptr client,uint16_t status,const std::string &reason) { std::map::iterator it = m_connections.find(client); if (it == m_connections.end()) { @@ -80,7 +80,7 @@ void chat_handler::disconnect(session_ptr client,uint16_t status,const std::stri send_to_all(encode_message("server",alias+" has left the chat.")); } -void chat_handler::message(session_ptr client,const std::string &msg) { +void chat_server_handler::on_message(session_ptr client,const std::string &msg) { std::cout << "message from client " << client << ": " << msg << std::endl; @@ -126,7 +126,7 @@ void chat_handler::message(session_ptr client,const std::string &msg) { } // {"type":"participants","value":[,...]} -std::string chat_handler::serialize_state() { +std::string chat_server_handler::serialize_state() { std::stringstream s; s << "{\"type\":\"participants\",\"value\":["; @@ -147,7 +147,7 @@ std::string chat_handler::serialize_state() { } // {"type":"msg","sender":"","value":"" } -std::string chat_handler::encode_message(std::string sender,std::string msg,bool escape) { +std::string chat_server_handler::encode_message(std::string sender,std::string msg,bool escape) { std::stringstream s; // escape JSON characters @@ -167,13 +167,13 @@ std::string chat_handler::encode_message(std::string sender,std::string msg,bool return s.str(); } -std::string chat_handler::get_con_id(session_ptr s) { +std::string chat_server_handler::get_con_id(session_ptr s) { std::stringstream endpoint; endpoint << s->socket().remote_endpoint(); return endpoint.str(); } -void chat_handler::send_to_all(std::string data) { +void chat_server_handler::send_to_all(std::string data) { std::map::iterator it; for (it = m_connections.begin(); it != m_connections.end(); it++) { (*it).first->send(data); diff --git a/examples/chat_server/chat.hpp b/examples/chat_server/chat.hpp index 6b01e97c18..3eb9b721ce 100644 --- a/examples/chat_server/chat.hpp +++ b/examples/chat_server/chat.hpp @@ -39,7 +39,7 @@ // {"type":"participants","value":[,...]} #include - +#include "../../src/websocketpp.hpp" #include "../../src/websocket_connection_handler.hpp" #include @@ -48,23 +48,23 @@ namespace websocketchat { -class chat_handler : public websocketpp::connection_handler { +class chat_server_handler : public websocketpp::connection_handler { public: - chat_handler() {} - virtual ~chat_handler() {} + chat_server_handler() {} + virtual ~chat_server_handler() {} void validate(websocketpp::session_ptr client); // add new connection to the lobby - void connect(websocketpp::session_ptr client); + void on_open(websocketpp::session_ptr client); // someone disconnected from the lobby, remove them - void disconnect(websocketpp::session_ptr client,uint16_t status,const std::string &reason); + void on_close(websocketpp::session_ptr client,uint16_t status,const std::string &reason); - void message(websocketpp::session_ptr client,const std::string &msg); + void on_message(websocketpp::session_ptr client,const std::string &msg); // lobby will ignore binary messages - void message(websocketpp::session_ptr client, + void on_message(websocketpp::session_ptr client, const std::vector &data) {} private: std::string serialize_state(); @@ -77,7 +77,7 @@ private: std::map m_connections; }; -typedef boost::shared_ptr chat_handler_ptr; +typedef boost::shared_ptr chat_server_handler_ptr; } #endif // CHAT_HPP diff --git a/examples/chat_server/chat_server.cpp b/examples/chat_server/chat_server.cpp index 6b9fce101e..80d65d9fab 100644 --- a/examples/chat_server/chat_server.cpp +++ b/examples/chat_server/chat_server.cpp @@ -27,29 +27,32 @@ #include "chat.hpp" -#include +#include "../../src/websocketpp.hpp" #include #include using boost::asio::ip::tcp; +using namespace websocketchat; int main(int argc, char* argv[]) { - std::string host = "localhost:9000"; - short port = 9000; + std::string host = "localhost"; + short port = 9003; + std::string full_host; if (argc == 3) { // TODO: input validation? + host = argv[1]; port = atoi(argv[2]); - - - std::stringstream temp; - temp << argv[1] << ":" << port; - - host = temp.str(); } + + std::stringstream temp; - websocketchat::chat_handler_ptr chat_handler(new websocketchat::chat_handler()); + temp << host << ":" << port; + full_host = temp.str(); + + + chat_server_handler_ptr chat_handler(new chat_server_handler()); try { boost::asio::io_service io_service; @@ -61,7 +64,7 @@ int main(int argc, char* argv[]) { // setup server settings server->add_host(host); - + server->add_host(full_host); // Chat server should only be receiving small text messages, reduce max // message size limit slightly to save memory, improve performance, and // guard against DoS attacks. @@ -70,7 +73,7 @@ int main(int argc, char* argv[]) { // start the server server->start_accept(); - std::cout << "Starting chat server on " << host << std::endl; + std::cout << "Starting chat server on " << full_host << std::endl; io_service.run(); } catch (std::exception& e) { diff --git a/examples/echo_server/echo.cpp b/examples/echo_server/echo.cpp index 313b5d100f..202e725cee 100644 --- a/examples/echo_server/echo.cpp +++ b/examples/echo_server/echo.cpp @@ -27,15 +27,15 @@ #include "echo.hpp" -using websocketecho::echo_handler; +using websocketecho::echo_server_handler; -void echo_handler::validate(websocketpp::session_ptr client) {} +void echo_server_handler::validate(websocketpp::session_ptr client) {} -void echo_handler::message(websocketpp::session_ptr client, const std::string &msg) { +void echo_server_handler::on_message(websocketpp::session_ptr client, const std::string &msg) { client->send(msg); } -void echo_handler::message(websocketpp::session_ptr client, +void echo_server_handler::on_message(websocketpp::session_ptr client, const std::vector &data) { client->send(data); } diff --git a/examples/echo_server/echo.hpp b/examples/echo_server/echo.hpp index 3cc9a768f9..3416f8b0b2 100644 --- a/examples/echo_server/echo.hpp +++ b/examples/echo_server/echo.hpp @@ -25,38 +25,40 @@ * */ -#ifndef ECHO_HANDLER_HPP -#define ECHO_HANDLER_HPP - +#ifndef ECHO_SERVER_HANDLER_HPP +#define ECHO_SERVER_HANDLER_HPP +#include "../../src/websocketpp.hpp" #include "../../src/websocket_connection_handler.hpp" #include #include #include +using websocketpp::session_ptr; + namespace websocketecho { -class echo_handler : public websocketpp::connection_handler { +class echo_server_handler : public websocketpp::connection_handler { public: - echo_handler() {} - virtual ~echo_handler() {} + echo_server_handler() {} + virtual ~echo_server_handler() {} // The echo server allows all domains is protocol free. - void validate(websocketpp::session_ptr client); + void validate(session_ptr client); - // an echo server is stateless. The handler has no need to keep track of connected - // clients. - void connect(websocketpp::session_ptr client) {} - void disconnect(websocketpp::session_ptr client,uint16_t status,const std::string &reason) {} + // an echo server is stateless. + // The handler has no need to keep track of connected clients. + void on_open(session_ptr client) {} + void on_close(session_ptr client,uint16_t status,const std::string &reason) {} // both text and binary messages are echoed back to the sending client. - void message(websocketpp::session_ptr client,const std::string &msg); - void message(websocketpp::session_ptr client, + void on_message(session_ptr client,const std::string &msg); + void on_message(session_ptr client, const std::vector &data); }; -typedef boost::shared_ptr echo_handler_ptr; +typedef boost::shared_ptr echo_server_handler_ptr; } -#endif // ECHO_HANDLER_HPP +#endif // ECHO_SERVER_HANDLER_HPP diff --git a/examples/echo_server/echo_server b/examples/echo_server/echo_server index d79f41c27b..ac8dfcf6ca 100755 Binary files a/examples/echo_server/echo_server and b/examples/echo_server/echo_server differ diff --git a/examples/echo_server/echo_server.cpp b/examples/echo_server/echo_server.cpp index 6282e0c671..021c2656de 100644 --- a/examples/echo_server/echo_server.cpp +++ b/examples/echo_server/echo_server.cpp @@ -36,7 +36,7 @@ using boost::asio::ip::tcp; int main(int argc, char* argv[]) { std::string host = "localhost"; - short port = 5000; + short port = 9002; std::string full_host; if (argc == 3) { @@ -47,10 +47,10 @@ int main(int argc, char* argv[]) { std::stringstream temp; - temp << argv[1] << ":" << port; + temp << host << ":" << port; full_host = temp.str(); - websocketecho::echo_handler_ptr echo_handler(new websocketecho::echo_handler()); + websocketecho::echo_server_handler_ptr echo_handler(new websocketecho::echo_server_handler()); try { boost::asio::io_service io_service; diff --git a/examples/echo_server/echo_server_old b/examples/echo_server/echo_server_old new file mode 100755 index 0000000000..c3a38d68c7 Binary files /dev/null and b/examples/echo_server/echo_server_old differ diff --git a/src/websocket_client.cpp b/src/websocket_client.cpp new file mode 100644 index 0000000000..081b5c6742 --- /dev/null +++ b/src/websocket_client.cpp @@ -0,0 +1,191 @@ +/* + * Copyright (c) 2011, Peter Thorson. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the name of the WebSocket++ Project nor the + * names of its contributors may be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + */ + +#include "websocket_client.hpp" + +#include +#include + +#include + +using websocketpp::client; +using boost::asio::ip::tcp; + +client::client(boost::asio::io_service& io_service,connection_handler_ptr defc) + : m_elog_level(LOG_ALL), + m_alog_level(ALOG_ALL), + m_state(CLIENT_STATE_NULL), + m_max_message_size(DEFAULT_MAX_MESSAGE_SIZE), + m_io_service(io_service), + m_resolver(io_service), + m_def_con_handler(defc) {} + +void client::init() { + m_client_session = client_session_ptr( + new client_session( + shared_from_this(), + m_io_service, + m_def_con_handler + ) + ); + m_state = CLIENT_STATE_INITIALIZED; +} + +void client::connect(const std::string& url) { + if (m_state != CLIENT_STATE_INITIALIZED) { + throw client_error("connect can only be called after init and before a connection has been established"); + } + + m_client_session->set_url(url); + + std::stringstream port; + port << m_client_session->get_port(); + + + tcp::resolver::query query(m_client_session->get_host(), + port.str()); + tcp::resolver::iterator iterator = m_resolver.resolve(query); + + boost::asio::async_connect(m_client_session->socket(), + iterator,boost::bind(&client::handle_connect, + this, + boost::asio::placeholders::error)); + m_state = CLIENT_STATE_CONNECTING; +} + + +void client::add_subprotocol(const std::string& p) { + if (m_state != CLIENT_STATE_INITIALIZED) { + throw client_error("add_protocol can only be called after init and before connect"); + } + m_client_session->add_subprotocol(p); +} + +void client::set_header(const std::string& key,const std::string& val) { + if (m_state != CLIENT_STATE_INITIALIZED) { + throw client_error("set_header can only be called after init and before connect"); + } + m_client_session->set_header(key,val); +} + +void client::set_origin(const std::string& val) { + if (m_state != CLIENT_STATE_INITIALIZED) { + throw client_error("set_origin can only be called after init and before connect"); + } + m_client_session->set_origin(val); +} + + +void client::set_max_message_size(uint64_t val) { + if (val > frame::PAYLOAD_64BIT_LIMIT) { + std::stringstream err; + err << "Invalid maximum message size: " << val; + + // TODO: Figure out what the ideal error behavior for this method. + // Options: + // Throw exception + // Log error and set value to maximum allowed + // Log error and leave value at whatever it was before + log(err.str(),LOG_WARN); + //throw client_error(err.str()); + } + m_max_message_size = val; +} + +bool client::test_elog_level(uint16_t level) { + return (level >= m_elog_level); +} +void client::set_elog_level(uint16_t level) { + std::stringstream msg; + msg << "Error logging level changing from " + << m_elog_level << " to " << level; + log(msg.str(),LOG_INFO); + + m_elog_level = level; +} +bool client::test_alog_level(uint16_t level) { + return (level & m_alog_level); +} +void client::set_alog_level(uint16_t level) { + if (test_alog_level(level)) { + return; + } + std::stringstream msg; + msg << "Access logging level " << level << " being set"; + access_log(msg.str(),ALOG_INFO); + + m_alog_level |= level; +} +void client::unset_alog_level(uint16_t level) { + if (!test_alog_level(level)) { + return; + } + std::stringstream msg; + msg << "Access logging level " << level << " being unset"; + access_log(msg.str(),ALOG_INFO); + + m_alog_level &= ~level; +} + +bool client::validate_message_size(uint64_t val) { + if (val > m_max_message_size) { + return false; + } + return true; +} + +void client::log(std::string msg,uint16_t level) { + if (!test_elog_level(level)) { + return; + } + std::cerr << "[Error Log] " + << boost::posix_time::to_iso_extended_string( + boost::posix_time::second_clock::local_time()) + << " " << msg << std::endl; +} +void client::access_log(std::string msg,uint16_t level) { + if (!test_alog_level(level)) { + return; + } + std::cout << "[Access Log] " + << boost::posix_time::to_iso_extended_string( + boost::posix_time::second_clock::local_time()) + << " " << msg << std::endl; +} + +void client::handle_connect(const boost::system::error_code& error) { + if (!error) { + m_state = CLIENT_STATE_CONNECTED; + m_client_session->on_connect(); + } else { + std::stringstream err; + err << "An error occurred while establishing a connection: " << error; + + log(err.str(),LOG_ERROR); + throw client_error(err.str()); + } +} diff --git a/src/websocket_client.hpp b/src/websocket_client.hpp new file mode 100644 index 0000000000..89bbe27395 --- /dev/null +++ b/src/websocket_client.hpp @@ -0,0 +1,160 @@ +/* + * Copyright (c) 2011, Peter Thorson. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the name of the WebSocket++ Project nor the + * names of its contributors may be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + */ + +#ifndef WEBSOCKET_CLIENT_HPP +#define WEBSOCKET_CLIENT_HPP + +#include +#include + +#include + +namespace websocketpp { + class client; + typedef boost::shared_ptr client_ptr; +} + +#include "websocketpp.hpp" +#include "websocket_client_session.hpp" +#include "websocket_connection_handler.hpp" + +using boost::asio::ip::tcp; + +namespace websocketpp { + +class client_error : public std::exception { +public: + client_error(const std::string& msg) + : m_msg(msg) {} + ~client_error() throw() {} + + virtual const char* what() const throw() { + return m_msg.c_str(); + } +private: + std::string m_msg; +}; + +class client : public boost::enable_shared_from_this { + public: + // System logging levels + /* static const uint16_t LOG_ALL = 0; + static const uint16_t LOG_DEBUG = 1; + static const uint16_t LOG_INFO = 2; + static const uint16_t LOG_WARN = 3; + static const uint16_t LOG_ERROR = 4; + static const uint16_t LOG_FATAL = 5; + static const uint16_t LOG_OFF = 6; + + // Access logging controls + // Individual bits + static const uint16_t ALOG_CONNECT = 0x1; + static const uint16_t ALOG_DISCONNECT = 0x2; + static const uint16_t ALOG_MISC_CONTROL = 0x4; + static const uint16_t ALOG_FRAME = 0x8; + static const uint16_t ALOG_MESSAGE = 0x10; + static const uint16_t ALOG_INFO = 0x20; + static const uint16_t ALOG_HANDSHAKE = 0x40; + // Useful groups + static const uint16_t ALOG_OFF = 0x0; + static const uint16_t ALOG_CONTROL = ALOG_CONNECT + & ALOG_DISCONNECT + & ALOG_MISC_CONTROL; + static const uint16_t ALOG_ALL = 0xFFFF; + */ + static const uint16_t CLIENT_STATE_NULL = 0; + static const uint16_t CLIENT_STATE_INITIALIZED = 1; + static const uint16_t CLIENT_STATE_CONNECTING = 2; + static const uint16_t CLIENT_STATE_CONNECTED = 3; + + client(boost::asio::io_service& io_service, + connection_handler_ptr defc); + + // INTERFACE FOR LOCAL APPLICATIONS + + // initializes the session. Methods that affect the opening handshake + // such as add_protocol and set_header must be called after init and + // before connect. + void init(); + + // starts the connection process. Should be called before + // io_service.run(), connection process will not start until run() has + // been called. + void connect(const std::string& url); + + // Adds a protocol to the opening handshake. + // Must be called before connect + void add_subprotocol(const std::string& p); + + // Sets the value of the given HTTP header to be sent during the + // opening handshake. Must be called before connect + void set_header(const std::string& key,const std::string& val); + + void set_origin(const std::string& val); + + void set_max_message_size(uint64_t val); + + // Test methods determine if a message of the given level should be + // written. elog shows all values above the level set. alog shows only + // the values explicitly set. + bool test_elog_level(uint16_t level); + void set_elog_level(uint16_t level); + + bool test_alog_level(uint16_t level); + void set_alog_level(uint16_t level); + void unset_alog_level(uint16_t level); + + // INTERFACE FOR SESSIONS + + // Check if message size is within server's acceptable parameters + bool validate_message_size(uint64_t val); + + // write to the server's logs + void log(std::string msg,uint16_t level = LOG_ERROR); + void access_log(std::string msg,uint16_t level); + private: + // if no errors starts the session's read loop and returns to the + // start_accept phase. + void handle_connect(const boost::system::error_code& error); + + private: + uint16_t m_elog_level; + uint16_t m_alog_level; + + uint16_t m_state; + + std::set m_hosts; + uint64_t m_max_message_size; + boost::asio::io_service& m_io_service; + tcp::resolver m_resolver; + client_session_ptr m_client_session; + connection_handler_ptr m_def_con_handler; +}; + +} + +#endif // WEBSOCKET_CLIENT_HPP diff --git a/src/websocket_client_session.cpp b/src/websocket_client_session.cpp new file mode 100644 index 0000000000..22eed0ef7f --- /dev/null +++ b/src/websocket_client_session.cpp @@ -0,0 +1,313 @@ +/* + * Copyright (c) 2011, Peter Thorson. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the name of the WebSocket++ Project nor the + * names of its contributors may be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + */ + +#include "websocketpp.hpp" +#include "websocket_client_session.hpp" + +#include "websocket_frame.hpp" +#include "utf8_validator/utf8_validator.hpp" + +#include +#include +#include + + +#include +#include +#include +#include + +using websocketpp::client_session; + +client_session::client_session (client_ptr c, + boost::asio::io_service& io_service, + connection_handler_ptr defc) + : session(io_service,defc),m_client(c) {} + +void client_session::on_connect() { + write_handshake(); +} + +void client_session::set_url(const std::string& url) { + // TODO: impliment + // TODO: input validation + + m_host = "thor-websocket.zaphoyd.net"; + m_port = 9003; + m_resource = "/chat"; + +} + +bool client_session::get_secure() const { + return m_secure; +} + +std::string client_session::get_host() const{ + return m_host; +} + +uint16_t client_session::get_port() const { + return m_port; +} + +void client_session::set_header(const std::string &key,const std::string &val) { + // TODO: prevent use of reserved headers + m_client_headers[key] = val; +} + +void client_session::set_origin(const std::string& val) { + // TODO: input validation + m_client_origin = val; +} + +void client_session::add_subprotocol(const std::string &val) { + // TODO: input validation + m_client_subprotocols.push_back(val); +} + +void client_session::add_extension(const std::string& val) { + // TODO: input validation + m_client_extensions.push_back(val); +} + +void client_session::read_handshake() { + boost::asio::async_read_until( + m_socket, + m_buf, + "\r\n\r\n", + boost::bind( + &session::handle_read_handshake, + shared_from_this(), + boost::asio::placeholders::error, + boost::asio::placeholders::bytes_transferred + ) + ); +} + +void client_session::handle_read_handshake(const boost::system::error_code& e, + std::size_t bytes_transferred) { + // parse server handshake + + + // read handshake and set local state (or pass to write_handshake) + std::ostringstream line; + line << &m_buf; + m_raw_server_handshake += line.str(); + + m_client->access_log(m_raw_server_handshake,ALOG_HANDSHAKE); + + std::vector tokens; + std::string::size_type start = 0; + std::string::size_type end; + + // Get request and parse headers + end = m_raw_server_handshake.find("\r\n",start); + + while(end != std::string::npos) { + tokens.push_back(m_raw_server_handshake.substr(start, end - start)); + + start = end + 2; + + end = m_raw_server_handshake.find("\r\n",start); + } + + for (size_t i = 0; i < tokens.size(); i++) { + if (i == 0) { + m_server_http_request = tokens[i]; + } + + end = tokens[i].find(": ",0); + + if (end != std::string::npos) { + std::string h = tokens[i].substr(0,end); + if (get_server_header(h) == "") { + m_server_headers[h] = tokens[i].substr(end+2); + } else { + m_server_headers[h] += ", " + tokens[i].substr(end+2); + } + } + } + + // handshake error checking + try { + std::stringstream err; + std::string h; + + // TODO: allow versions greater than 1.1 + if (m_server_http_request.substr(0,9) != "HTTP/1.1 ") { + err << "Websocket handshake has invalid HTTP version: " + << m_server_http_request.substr(0,9); + + throw(handshake_error(err.str(),400)); + } + + // check the HTTP version + if (m_server_http_request.substr(9,3) != "101") { + err << "Websocket handshake ended with status " + << m_server_http_request.substr(9); + + // TODO: check version header for other supported versions. + + throw(handshake_error(err.str(),400)); + } + + // verify the presence of required headers + h = get_server_header("Upgrade"); + if (h == "") { + throw(handshake_error("Required Upgrade header is missing",400)); + } else if (!boost::iequals(h,"websocket")) { + err << "Upgrade header was " << h << " instead of \"websocket\""; + throw(handshake_error(err.str(),400)); + } + + h = get_server_header("Connection"); + if (h == "") { + throw(handshake_error("Required Connection header is missing",400)); + } else if (!boost::ifind_first(h,"upgrade")) { + err << "Connection header, \"" << h + << "\", does not contain required token \"upgrade\""; + throw(handshake_error(err.str(),400)); + } + + if (get_server_header("Sec-WebSocket-Accept") == "") { + throw(handshake_error("Required Sec-WebSocket-Key header is missing",400)); + } else { + // TODO: make a helper function for this. + std::string server_key = m_client_key; + server_key += "258EAFA5-E914-47DA-95CA-C5AB0DC85B11"; + + SHA1 sha; + uint32_t message_digest[5]; + + sha.Reset(); + sha << server_key.c_str(); + + if (!sha.Result(message_digest)) { + m_client->log("Error computing handshake sha1 hash.",LOG_ERROR); + // TODO: close behavior + return; + } + + // convert sha1 hash bytes to network byte order because this sha1 + // library works on ints rather than bytes + for (int i = 0; i < 5; i++) { + message_digest[i] = htonl(message_digest[i]); + } + + server_key = base64_encode( + reinterpret_cast(message_digest),20); + if (server_key != get_server_header("Sec-WebSocket-Accept")) { + m_client->log("Server key does not match",LOG_ERROR); + // TODO: close behavior + return; + } + } + } catch (const handshake_error& e) { + std::stringstream err; + err << "Caught handshake exception: " << e.what(); + + m_client->access_log(e.what(),ALOG_HANDSHAKE); + m_client->log(err.str(),LOG_ERROR); + + // TODO: close behavior + return; + } + + log_open_result(); + + m_status = OPEN; + + if (m_local_interface) { + m_local_interface->on_open(shared_from_this()); + } + + reset_message(); + read_frame(); +} + +void client_session::write_handshake() { + // generate client handshake. + std::string client_handshake; + + client_handshake += "GET "+m_resource+" HTTP/1.1\r\n"; + + set_header("Upgrade","websocket"); + set_header("Connection","Upgrade"); + set_header("Sec-WebSocket-Version","13"); + + set_header("Host",m_host); + + if (m_client_origin != "") { + set_header("Origin",m_client_origin); + } + + // TODO: generate proper key + m_client_key = "XO4pxrIMLnK1CEVQP9untQ=="; + set_header("Sec-WebSocket-Key",m_client_key); + + + + set_header("User Agent","WebSocket++/2011-09-25"); + + header_list::iterator it; + for (it = m_client_headers.begin(); it != m_client_headers.end(); it++) { + client_handshake += it->first + ": " + it->second + "\r\n"; + } + + client_handshake += "\r\n"; + + m_raw_client_handshake = client_handshake; + + // start async write to handle_write_handshake + boost::asio::async_write( + m_socket, + boost::asio::buffer(m_raw_client_handshake), + boost::bind( + &session::handle_write_handshake, + shared_from_this(), + boost::asio::placeholders::error + ) + ); +} + +void client_session::handle_write_handshake(const boost::system::error_code& error) { + if (error) { + handle_error("Error writing handshake",error); + // TODO: close behavior + return; + } + + read_handshake(); +} + +void client_session::log(const std::string& msg, uint16_t level) const { + m_client->log(msg,level); +} + +void client_session::access_log(const std::string& msg, uint16_t level) const { + m_client->access_log(msg,level); +} diff --git a/src/websocket_client_session.hpp b/src/websocket_client_session.hpp new file mode 100644 index 0000000000..303a740976 --- /dev/null +++ b/src/websocket_client_session.hpp @@ -0,0 +1,129 @@ +/* + * Copyright (c) 2011, Peter Thorson. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the name of the WebSocket++ Project nor the + * names of its contributors may be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + */ + +#ifndef WEBSOCKET_CLIENT_SESSION_HPP +#define WEBSOCKET_CLIENT_SESSION_HPP + +#include +#include + +#include +#include + +#include + +#include +#include +#include +#include +#include +#include +#include +#include + +namespace websocketpp { + class client_session; + typedef boost::shared_ptr client_session_ptr; +} + +#include "websocket_session.hpp" +#include "websocket_client.hpp" + +using boost::asio::ip::tcp; + +namespace websocketpp { + +class client_session : public session { +public: + client_session (client_ptr c, + boost::asio::io_service& io_service, + connection_handler_ptr defc); + + /*** CLIENT INTERFACE ***/ + + // This function is called when a tcp connection has been established and + // the connection is ready to start the opening handshake. + void on_connect(); + + /*** HANDSHAKE INTERFACE ***/ + + void set_url(const std::string& url); + + bool get_secure() const; + std::string get_host() const; + uint16_t get_port() const; + + // Set an HTTP header for the outgoing client handshake. + void set_header(const std::string& key,const std::string& val); + + // adds a subprotocol. This will result in the appropriate + // Sec-WebSocket-Protocol header being sent with the opening connection. + // Values will be sent in the order they were added. Servers interpret this + // order as the preferred order. + void add_subprotocol(const std::string &val); + + // Sets the origin value that will be sent to the server + void set_origin(const std::string &val); + + // Adds an extension to the extension list. Extensions are sent in the + // order added + void add_extension(const std::string& val); + + /*** SESSION INTERFACE ***/ + // see session + bool is_server() const {return false;} + + void log(const std::string& msg, uint16_t level) const; + void access_log(const std::string& msg, uint16_t level) const; +protected: + // Opening handshake processors and callbacks. + virtual void write_handshake(); + virtual void handle_write_handshake(const boost::system::error_code& e); + virtual void read_handshake(); + virtual void handle_read_handshake(const boost::system::error_code& e, + std::size_t bytes_transferred); + +private: + +protected: + // url parts + bool m_secure; + std::string m_host; + uint16_t m_port; + + // handshake stuff + std::string m_client_key; + + // connection resources + client_ptr m_client; +private: + +}; + +} + +#endif // WEBSOCKET_CLIENT_SESSION_HPP diff --git a/src/websocket_connection_handler.hpp b/src/websocket_connection_handler.hpp index 0d192b7278..5a1778e274 100644 --- a/src/websocket_connection_handler.hpp +++ b/src/websocket_connection_handler.hpp @@ -56,11 +56,14 @@ public: // client (useful for returning non-standard error codes) virtual void validate(session_ptr client) = 0; + + // this will be called once the connected websocket is avaliable for // writing messages. client may be a new websocket session or an existing // session that was recently passed to this handler. - virtual void connect(session_ptr client) = 0; + virtual void on_open(session_ptr client) = 0; + // this will be called when the connected websocket is no longer avaliable // for writing messages. This occurs under the following conditions: // - Disconnect message recieved from the remote endpoint @@ -69,15 +72,15 @@ public: // calls the disconnect method of session // - The connection handler assigned to this client was set to another // handler - virtual void disconnect(session_ptr client,uint16_t status,const std::string &reason) = 0; + virtual void on_close(session_ptr client,uint16_t status,const std::string &reason) = 0; // this will be called when a text message is recieved. Text will be // encoded as UTF-8. - virtual void message(session_ptr client,const std::string &msg) = 0; + virtual void on_message(session_ptr client,const std::string &msg) = 0; // this will be called when a binary message is recieved. Argument is a // vector of the raw bytes in the message body. - virtual void message(session_ptr client, + virtual void on_message(session_ptr client, const std::vector &data) = 0; }; diff --git a/src/websocket_server.cpp b/src/websocket_server.cpp index 7498e39e73..984a1c8441 100644 --- a/src/websocket_server.cpp +++ b/src/websocket_server.cpp @@ -37,7 +37,9 @@ using websocketpp::server; server::server(boost::asio::io_service& io_service, const tcp::endpoint& endpoint, connection_handler_ptr defc) - : m_max_message_size(DEFAULT_MAX_MESSAGE_SIZE), + : m_elog_level(LOG_ALL), + m_alog_level(ALOG_ALL), + m_max_message_size(DEFAULT_MAX_MESSAGE_SIZE), m_io_service(io_service), m_acceptor(io_service, endpoint), m_def_con_handler(defc) {} @@ -61,11 +63,47 @@ void server::set_max_message_size(uint64_t val) { // Throw exception // Log error and set value to maximum allowed // Log error and leave value at whatever it was before - throw server_error(err.str()); + log(err.str(),LOG_WARN); + //throw server_error(err.str()); } m_max_message_size = val; } +bool server::test_elog_level(uint16_t level) { + return (level >= m_elog_level); +} +void server::set_elog_level(uint16_t level) { + std::stringstream msg; + msg << "Error logging level changing from " + << m_elog_level << " to " << level; + log(msg.str(),LOG_INFO); + + m_elog_level = level; +} +bool server::test_alog_level(uint16_t level) { + return (level & m_alog_level); +} +void server::set_alog_level(uint16_t level) { + if (test_alog_level(level)) { + return; + } + std::stringstream msg; + msg << "Access logging level " << level << " being set"; + access_log(msg.str(),ALOG_INFO); + + m_alog_level |= level; +} +void server::unset_alog_level(uint16_t level) { + if (!test_alog_level(level)) { + return; + } + std::stringstream msg; + msg << "Access logging level " << level << " being unset"; + access_log(msg.str(),ALOG_INFO); + + m_alog_level &= ~level; +} + bool server::validate_host(std::string host) { if (m_hosts.find(host) == m_hosts.end()) { return false; @@ -80,13 +118,19 @@ bool server::validate_message_size(uint64_t val) { return true; } -void server::error_log(std::string msg) { +void server::log(std::string msg,uint16_t level) { + if (!test_elog_level(level)) { + return; + } std::cerr << "[Error Log] " << boost::posix_time::to_iso_extended_string( boost::posix_time::second_clock::local_time()) << " " << msg << std::endl; } -void server::access_log(std::string msg) { +void server::access_log(std::string msg,uint16_t level) { + if (!test_alog_level(level)) { + return; + } std::cout << "[Access Log] " << boost::posix_time::to_iso_extended_string( boost::posix_time::second_clock::local_time()) @@ -94,31 +138,31 @@ void server::access_log(std::string msg) { } void server::start_accept() { - session_ptr new_ws(new session(shared_from_this(), - m_io_service, - m_def_con_handler)); + server_session_ptr new_session(new server_session(shared_from_this(), + m_io_service, + m_def_con_handler)); m_acceptor.async_accept( - new_ws->socket(), + new_session->socket(), boost::bind( &server::handle_accept, this, - new_ws, + new_session, boost::asio::placeholders::error ) ); } -void server::handle_accept(session_ptr session, +void server::handle_accept(server_session_ptr session, const boost::system::error_code& error) { if (!error) { - session->start(); + session->on_connect(); } else { std::stringstream err; err << "Error accepting socket connection: " << error; - error_log(err.str()); + log(err.str(),LOG_ERROR); throw server_error(err.str()); } diff --git a/src/websocket_server.hpp b/src/websocket_server.hpp index 4821511825..a1415b63ed 100644 --- a/src/websocket_server.hpp +++ b/src/websocket_server.hpp @@ -39,7 +39,7 @@ namespace websocketpp { } #include "websocketpp.hpp" -#include "websocket_session.hpp" +#include "websocket_server_session.hpp" #include "websocket_connection_handler.hpp" using boost::asio::ip::tcp; @@ -61,6 +61,31 @@ private: class server : public boost::enable_shared_from_this { public: + // System logging levels + /*static const uint16_t LOG_ALL = 0; + static const uint16_t LOG_DEBUG = 1; + static const uint16_t LOG_INFO = 2; + static const uint16_t LOG_WARN = 3; + static const uint16_t LOG_ERROR = 4; + static const uint16_t LOG_FATAL = 5; + static const uint16_t LOG_OFF = 6; + + // Access logging controls + // Individual bits + static const uint16_t ALOG_CONNECT = 0x1; + static const uint16_t ALOG_DISCONNECT = 0x2; + static const uint16_t ALOG_MISC_CONTROL = 0x4; + static const uint16_t ALOG_FRAME = 0x8; + static const uint16_t ALOG_MESSAGE = 0x10; + static const uint16_t ALOG_INFO = 0x20; + static const uint16_t ALOG_HANDSHAKE = 0x40; + // Useful groups + static const uint16_t ALOG_OFF = 0x0; + static const uint16_t ALOG_CONTROL = ALOG_CONNECT + & ALOG_DISCONNECT + & ALOG_MISC_CONTROL; + static const uint16_t ALOG_ALL = 0xFFFF; +*/ server(boost::asio::io_service& io_service, const tcp::endpoint& endpoint, connection_handler_ptr defc); @@ -68,7 +93,9 @@ class server : public boost::enable_shared_from_this { // creates a new session object and connects the next websocket // connection to it. void start_accept(); - + + // INTERFACE FOR LOCAL APPLICATIONS + // Add or remove a host string (host:port) to the list of acceptable // hosts to accept websocket connections from. Additions/deletions here // only affect new connections. @@ -77,6 +104,18 @@ class server : public boost::enable_shared_from_this { void set_max_message_size(uint64_t val); + // Test methods determine if a message of the given level should be + // written. elog shows all values above the level set. alog shows only + // the values explicitly set. + bool test_elog_level(uint16_t level); + void set_elog_level(uint16_t level); + + bool test_alog_level(uint16_t level); + void set_alog_level(uint16_t level); + void unset_alog_level(uint16_t level); + + // INTERFACE FOR SESSIONS + // Check if this server will respond to this host. bool validate_host(std::string host); @@ -84,17 +123,18 @@ class server : public boost::enable_shared_from_this { bool validate_message_size(uint64_t val); // write to the server's logs - void error_log(std::string msg); - void access_log(std::string msg); + void log(std::string msg,uint16_t level = LOG_ERROR); + void access_log(std::string msg,uint16_t level); private: - - // if no errors starts the session's read loop and returns to the // start_accept phase. - void handle_accept(session_ptr session, + void handle_accept(server_session_ptr session, const boost::system::error_code& error); private: + uint16_t m_elog_level; + uint16_t m_alog_level; + std::set m_hosts; uint64_t m_max_message_size; boost::asio::io_service& m_io_service; @@ -104,4 +144,4 @@ class server : public boost::enable_shared_from_this { } -#endif // WEBSOCKET_SERVER_HPP \ No newline at end of file +#endif // WEBSOCKET_SERVER_HPP diff --git a/src/websocket_server_session.cpp b/src/websocket_server_session.cpp new file mode 100644 index 0000000000..b1015c7bde --- /dev/null +++ b/src/websocket_server_session.cpp @@ -0,0 +1,346 @@ +/* + * Copyright (c) 2011, Peter Thorson. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the name of the WebSocket++ Project nor the + * names of its contributors may be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + */ + +#include "websocketpp.hpp" +#include "websocket_server_session.hpp" + +#include "websocket_frame.hpp" +#include "utf8_validator/utf8_validator.hpp" + +#include +#include +#include + + +#include +#include +#include +#include + +using websocketpp::server_session; + +server_session::server_session(server_ptr s, + boost::asio::io_service& io_service, + connection_handler_ptr defc) + : session(io_service,defc),m_server(s) {} + +void server_session::on_connect() { + read_handshake(); +} + + +void server_session::set_header(const std::string &key,const std::string &val) { + // TODO: prevent use of reserved headers; + m_server_headers[key] = val; +} + +void server_session::select_subprotocol(const std::string& val) { + std::vector::iterator it; + + it = std::find(m_client_subprotocols.begin(), + m_client_subprotocols.end(), + val); + + if (val != "" && it == m_client_subprotocols.end()) { + throw server_error("Attempted to choose a subprotocol not proposed by the client"); + } + + m_server_subprotocol = val; +} + +void server_session::select_extension(const std::string& val) { + if (val == "") { + return; + } + + std::vector::iterator it; + + it = std::find(m_client_extensions.begin(), + m_client_extensions.end(), + val); + + if (it == m_client_extensions.end()) { + throw server_error("Attempted to choose an extension not proposed by the client"); + } + + m_server_extensions.push_back(val); +} + +void server_session::read_handshake() { + boost::asio::async_read_until( + m_socket, + m_buf, + "\r\n\r\n", + boost::bind( + &session::handle_read_handshake, + shared_from_this(), + boost::asio::placeholders::error, + boost::asio::placeholders::bytes_transferred + ) + ); +} + +void server_session::handle_read_handshake(const boost::system::error_code& e, + std::size_t bytes_transferred) { + std::ostringstream line; + line << &m_buf; + m_raw_client_handshake += line.str(); + + access_log(m_raw_client_handshake,ALOG_HANDSHAKE); + + std::vector tokens; + std::string::size_type start = 0; + std::string::size_type end; + + // Get request and parse headers + end = m_raw_client_handshake.find("\r\n",start); + + while(end != std::string::npos) { + tokens.push_back(m_raw_client_handshake.substr(start, end - start)); + + start = end + 2; + + end = m_raw_client_handshake.find("\r\n",start); + } + + for (size_t i = 0; i < tokens.size(); i++) { + if (i == 0) { + m_client_http_request = tokens[i]; + } + + end = tokens[i].find(": ",0); + + if (end != std::string::npos) { + std::string h = tokens[i].substr(0,end); + + if (get_client_header(h) == "") { + m_client_headers[h] = tokens[i].substr(end+2); + } else { + m_client_headers[h] += ", " + tokens[i].substr(end+2); + } + } + } + + // handshake error checking + try { + std::stringstream err; + std::string h; + + // check the method + if (m_client_http_request.substr(0,4) != "GET ") { + err << "Websocket handshake has invalid method: " + << m_client_http_request.substr(0,4); + + throw(handshake_error(err.str(),400)); + } + + // check the HTTP version + // TODO: allow versions greater than 1.1 + end = m_client_http_request.find(" HTTP/1.1",4); + if (end == std::string::npos) { + err << "Websocket handshake has invalid HTTP version"; + throw(handshake_error(err.str(),400)); + } + + m_resource = m_client_http_request.substr(4,end-4); + + // verify the presence of required headers + h = get_client_header("Host"); + if (h == "") { + throw(handshake_error("Required Host header is missing",400)); + } else if (!m_server->validate_host(h)) { + err << "Host " << h << " is not one of this server's names."; + throw(handshake_error(err.str(),400)); + } + + h = get_client_header("Upgrade"); + if (h == "") { + throw(handshake_error("Required Upgrade header is missing",400)); + } else if (!boost::iequals(h,"websocket")) { + err << "Upgrade header was " << h << " instead of \"websocket\""; + throw(handshake_error(err.str(),400)); + } + + h = get_client_header("Connection"); + if (h == "") { + throw(handshake_error("Required Connection header is missing",400)); + } else if (!boost::ifind_first(h,"upgrade")) { + err << "Connection header, \"" << h + << "\", does not contain required token \"upgrade\""; + throw(handshake_error(err.str(),400)); + } + + if (get_client_header("Sec-WebSocket-Key") == "") { + throw(handshake_error("Required Sec-WebSocket-Key header is missing",400)); + } + + h = get_client_header("Sec-WebSocket-Version"); + if (h == "") { + throw(handshake_error("Required Sec-WebSocket-Version header is missing",400)); + } else { + m_version = atoi(h.c_str()); + + if (m_version != 7 && m_version != 8 && m_version != 13) { + err << "This server doesn't support WebSocket protocol version " + << m_version; + throw(handshake_error(err.str(),400)); + } + } + + if (m_version < 13) { + h = get_client_header("Sec-WebSocket-Origin"); + } else { + h = get_client_header("Origin"); + } + + if (h != "") { + m_client_origin = h; + } + + // TODO: extract subprotocols + // TODO: extract extensions + + // optional headers (delegated to the local interface) + if (m_local_interface) { + m_local_interface->validate(shared_from_this()); + } + + m_server_http_code = 101; + m_server_http_string = "Switching Protocols"; + } catch (const handshake_error& e) { + std::stringstream err; + err << "Caught handshake exception: " << e.what(); + + access_log(e.what(),ALOG_HANDSHAKE); + log(err.str(),LOG_ERROR); + + m_server_http_code = e.m_http_error_code; + m_server_http_string = e.m_http_error_msg; + } + + write_handshake(); +} + +void server_session::write_handshake() { + std::stringstream h; + + + + if (m_server_http_code == 101) { + std::string server_key = get_client_header("Sec-WebSocket-Key"); + server_key += "258EAFA5-E914-47DA-95CA-C5AB0DC85B11"; + + SHA1 sha; + uint32_t message_digest[5]; + + sha.Reset(); + sha << server_key.c_str(); + + if (sha.Result(message_digest)){ + // convert sha1 hash bytes to network byte order because this sha1 + // library works on ints rather than bytes + for (int i = 0; i < 5; i++) { + message_digest[i] = htonl(message_digest[i]); + } + + server_key = base64_encode( + reinterpret_cast(message_digest),20); + + // set handshake accept headers + set_header("Sec-WebSocket-Accept",server_key); + set_header("Upgrade","websocket"); + set_header("Connection","Upgrade"); + } else { + log("Error computing handshake sha1 hash.",LOG_ERROR); + m_server_http_code = 500; + m_server_http_string = ""; + } + } + + // hardcoded server headers + set_header("Server","WebSocket++/2011-09-25"); + + h << "HTTP/1.1 " << m_server_http_code << " " + << (m_server_http_string != "" ? m_server_http_string : + lookup_http_error_string(m_server_http_code)) + << "\r\n"; + + header_list::iterator it; + for (it = m_server_headers.begin(); it != m_server_headers.end(); it++) { + h << it->first << ": " << it->second << "\r\n"; + } + + h << "\r\n"; + + m_raw_server_handshake = h.str(); + + // start async write to handle_write_handshake + boost::asio::async_write( + m_socket, + boost::asio::buffer(m_raw_server_handshake), + boost::bind( + &session::handle_write_handshake, + shared_from_this(), + boost::asio::placeholders::error + ) + ); +} + +void server_session::handle_write_handshake(const boost::system::error_code& error) { + if (error) { + handle_error("Error writing handshake response",error); + return; + } + + log_open_result(); + + if (m_server_http_code != 101) { + std::stringstream err; + err << "Handshake ended with HTTP error: " << m_server_http_code << " " + << (m_server_http_string != "" ? m_server_http_string : lookup_http_error_string(m_server_http_code)); + log(err.str(),LOG_ERROR); + // TODO: close behavior + return; + } + + m_status = OPEN; + + if (m_local_interface) { + m_local_interface->on_open(shared_from_this()); + } + + reset_message(); + this->read_frame(); +} + +void server_session::log(const std::string& msg, uint16_t level) const { + m_server->log(msg,level); +} + +void server_session::access_log(const std::string& msg, uint16_t level) const { + m_server->access_log(msg,level); +} diff --git a/src/websocket_server_session.hpp b/src/websocket_server_session.hpp new file mode 100644 index 0000000000..73b9ed59cd --- /dev/null +++ b/src/websocket_server_session.hpp @@ -0,0 +1,112 @@ +/* + * Copyright (c) 2011, Peter Thorson. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the name of the WebSocket++ Project nor the + * names of its contributors may be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + */ + +#ifndef WEBSOCKET_SERVER_SESSION_HPP +#define WEBSOCKET_SERVER_SESSION_HPP + +#include +#include + +#include +#include + +#include + +#include +#include +#include +#include +#include +#include +#include +#include + +namespace websocketpp { + class server_session; + typedef boost::shared_ptr server_session_ptr; +} + +#include "websocket_session.hpp" +#include "websocket_server.hpp" + +using boost::asio::ip::tcp; + +namespace websocketpp { + +class server_session : public session { +public: + server_session (server_ptr s, + boost::asio::io_service& io_service, + connection_handler_ptr defc); + + /*** SERVER INTERFACE ***/ + + // This function is called when a connection to a new client has been + // established and the server is ready to read the client handshake. + void on_connect(); + + /*** HANDSHAKE INTERFACE ***/ + + // Set an HTTP header for the outgoing server handshake response. + void set_header(const std::string& key, const std::string& val); + + // Selects a subprotocol for the connection to use. val must be a value + // present in the client's opening handshake or the empty string for null. + void select_subprotocol(const std::string& val); + + // Selects an extension from the list offered by the client. Each extension + // selected must have been offered by the client. Extensions will be used + // in the order that they were selected here. + void select_extension(const std::string& val); + + /*** SESSION INTERFACE ***/ + // see session + virtual bool is_server() const { return true;} + + void log(const std::string& msg, uint16_t level) const; + void access_log(const std::string& msg, uint16_t level) const; +protected: + // Opening handshake processors and callbacks. These need to be defined in + virtual void write_handshake(); + virtual void handle_write_handshake(const boost::system::error_code& e); + virtual void read_handshake(); + virtual void handle_read_handshake(const boost::system::error_code& e, + std::size_t bytes_transferred); + + +private: + +protected: + // connection resources + server_ptr m_server; +private: + +}; + +} + +#endif // WEBSOCKET_SERVER_SESSION_HPP diff --git a/src/websocket_session.cpp b/src/websocket_session.cpp index 77c5e3003d..da5d7b7806 100644 --- a/src/websocket_session.cpp +++ b/src/websocket_session.cpp @@ -25,6 +25,7 @@ * */ +#include "websocketpp.hpp" #include "websocket_session.hpp" #include "websocket_frame.hpp" @@ -42,7 +43,7 @@ using websocketpp::session; -session::session (server_ptr s,boost::asio::io_service& io_service, +session::session (boost::asio::io_service& io_service, connection_handler_ptr defc) : m_status(CONNECTING), m_local_close_code(CLOSE_STATUS_NO_STATUS), @@ -50,8 +51,8 @@ session::session (server_ptr s,boost::asio::io_service& io_service, m_was_clean(false), m_closed_by_me(false), m_dropped_by_me(false), - m_server(s), m_socket(io_service), + m_io_service(io_service), m_local_interface(defc), @@ -62,58 +63,65 @@ tcp::socket& session::socket() { return m_socket; } -void session::start() { - // async read to handle_read_handshake - boost::asio::async_read_until( - m_socket, - m_buf, - "\r\n\r\n", - boost::bind( - &session::handle_read_handshake, - shared_from_this(), - boost::asio::placeholders::error, - boost::asio::placeholders::bytes_transferred - ) - ); +boost::asio::io_service& session::io_service() { + return m_io_service; } void session::set_handler(connection_handler_ptr new_con) { if (m_local_interface) { - m_local_interface->disconnect(shared_from_this(),4000,"Setting new connection handler"); + // TODO: this should be another method and not reusing onclose + //m_local_interface->disconnect(shared_from_this(),4000,"Setting new connection handler"); } m_local_interface = new_con; - m_local_interface->connect(shared_from_this()); + m_local_interface->on_open(shared_from_this()); } -std::string session::get_header(const std::string& key) const { - std::map::const_iterator h = m_headers.find(key); +const std::string& session::get_subprotocol() const { + if (m_status == CONNECTING) { + log("Subprotocol is not avaliable before the handshake has completed.",LOG_WARN); + throw server_error("Subprotocol is not avaliable before the handshake has completed."); + } + return m_server_subprotocol; +} + +const std::string& session::get_resource() const { + return m_resource; +} + +const std::string& session::get_origin() const { + return m_client_origin; +} + +std::string session::get_client_header(const std::string& key) const { + return get_header(key,m_client_headers); +} + +std::string session::get_server_header(const std::string& key) const { + return get_header(key,m_server_headers); +} + +std::string session::get_header(const std::string& key, + const header_list& list) const { + header_list::const_iterator h = list.find(key); - if (h == m_headers.end()) { - return std::string(); + if (h == list.end()) { + return ""; } else { return h->second; } } -void session::add_header(const std::string &key,const std::string &value) { - throw "unimplimented"; +const std::vector& session::get_extensions() const { + return m_server_extensions; } -std::string session::get_request() const { - return m_request; -} - -std::string session::get_origin() const { - if (m_version < 13) { - return get_header("Sec-WebSocket-Origin"); - } else { - return get_header("Origin"); - } +unsigned int session::get_version() const { + return m_version; } void session::send(const std::string &msg) { if (m_status != OPEN) { - // error? + log("Tried to send a message from a session that wasn't open",LOG_WARN); return; } m_write_frame.set_fin(true); @@ -123,10 +131,9 @@ void session::send(const std::string &msg) { write_frame(); } -// send binary frame void session::send(const std::vector &data) { if (m_status != OPEN) { - // error? + log("Tried to send a message from a session that wasn't open",LOG_WARN); return; } m_write_frame.set_fin(true); @@ -136,10 +143,15 @@ void session::send(const std::vector &data) { write_frame(); } -// send close frame +void session::close(uint16_t status,const std::string& msg) { + disconnect(status,msg); + // TODO: close behavior +} + +// TODO: clean this up, needs to be broken out into more specific methods void session::disconnect(uint16_t status,const std::string &message) { if (m_status != OPEN) { - m_server->error_log("got a disconnect call from invalid state"); + log("Tried to disconnect a session that wasn't open",LOG_WARN); return; } @@ -158,6 +170,7 @@ void session::disconnect(uint16_t status,const std::string &message) { m_write_frame.set_status(CLOSE_STATUS_NORMAL,""); } else if (status == CLOSE_STATUS_ABNORMAL_CLOSE) { // unknown internal error, don't set a status? use protocol error? + log("Tried to disconnect with status ABNORMAL_CLOSE",LOG_DEBUG); } else { m_write_frame.set_status(status,message); } @@ -166,6 +179,10 @@ void session::disconnect(uint16_t status,const std::string &message) { } void session::ping(const std::string &msg) { + if (m_status != OPEN) { + log("Tried to send a ping from a session that wasn't open",LOG_WARN); + return; + } m_write_frame.set_fin(true); m_write_frame.set_opcode(frame::PING); m_write_frame.set_payload(msg); @@ -174,6 +191,10 @@ void session::ping(const std::string &msg) { } void session::pong(const std::string &msg) { + if (m_status != OPEN) { + log("Tried to send a pong from a session that wasn't open",LOG_WARN); + return; + } m_write_frame.set_fin(true); m_write_frame.set_opcode(frame::PONG); m_write_frame.set_payload(msg); @@ -181,230 +202,6 @@ void session::pong(const std::string &msg) { write_frame(); } -void session::handle_read_handshake(const boost::system::error_code& e, - std::size_t bytes_transferred) { - // read handshake and set local state (or pass to write_handshake) - std::ostringstream line; - line << &m_buf; - m_handshake += line.str(); - - //std::cout << "=== Raw Message ===" << std::endl; - //std::cout << m_handshake << std::endl; - //std::cout << "=== Raw Message end ===" << std::endl; - - std::vector tokens; - std::string::size_type start = 0; - std::string::size_type end; - - // Get request and parse headers - end = m_handshake.find("\r\n",start); - - while(end != std::string::npos) { - tokens.push_back(m_handshake.substr(start, end - start)); - - start = end + 2; - - end = m_handshake.find("\r\n",start); - } - - for (size_t i = 0; i < tokens.size(); i++) { - if (i == 0) { - m_request = tokens[i]; - } - - end = tokens[i].find(": ",0); - - if (end != std::string::npos) { - m_headers[tokens[i].substr(0,end)] = tokens[i].substr(end+2); - } - } - - // handshake error checking - try { - std::stringstream err; - std::string h; - - // check the method - if (m_request.substr(0,4) != "GET ") { - err << "Websocket handshake has invalid method: " - << m_request.substr(0,4); - - throw(handshake_error(err.str(),400)); - } - - // check the HTTP version - // TODO: allow versions greater than 1.1 - end = m_request.find(" HTTP/1.1",4); - if (end == std::string::npos) { - err << "Websocket handshake has invalid HTTP version"; - throw(handshake_error(err.str(),400)); - } - - m_request = m_request.substr(4,end-4); - - // verify the presence of required headers - h = get_header("Host"); - if (h == "") { - throw(handshake_error("Required Host header is missing",400)); - } else if (!m_server->validate_host(h)) { - err << "Host " << h << " is not one of this server's names."; - throw(handshake_error(err.str(),400)); - } - - h = get_header("Upgrade"); - if (h == "") { - throw(handshake_error("Required Upgrade header is missing",400)); - } else if (!boost::iequals(h,"websocket")) { - err << "Upgrade header was " << h << " instead of \"websocket\""; - throw(handshake_error(err.str(),400)); - } - - h = get_header("Connection"); - if (h == "") { - throw(handshake_error("Required Connection header is missing",400)); - } else if (!boost::ifind_first(h,"upgrade")) { - err << "Connection header, \"" << h - << "\", does not contain required token \"upgrade\""; - throw(handshake_error(err.str(),400)); - } - - if (get_header("Sec-WebSocket-Key") == "") { - throw(handshake_error("Required Sec-WebSocket-Key header is missing",400)); - } - - h = get_header("Sec-WebSocket-Version"); - if (h == "") { - throw(handshake_error("Required Sec-WebSocket-Version header is missing",400)); - } else { - m_version = atoi(h.c_str()); - - if (m_version != 7 && m_version != 8 && m_version != 13) { - err << "This server doesn't support WebSocket protocol version " - << m_version; - throw(handshake_error(err.str(),400)); - } - } - - // optional headers (delegated to the local interface) - if (m_local_interface) { - m_local_interface->validate(shared_from_this()); - } - - } catch (const handshake_error& e) { - std::stringstream err; - err << "Caught handshake exception: " << e.what(); - - m_server->error_log(err.str()); - e.write(shared_from_this()); - return; - } - - this->write_handshake(); -} - -void session::write_handshake() { - std::string server_handshake = ""; - std::string server_key = m_headers["Sec-WebSocket-Key"]; - server_key += "258EAFA5-E914-47DA-95CA-C5AB0DC85B11"; - - SHA1 sha; - uint32_t message_digest[5]; - - sha.Reset(); - sha << server_key.c_str(); - - if (!sha.Result(message_digest)) { - m_server->error_log("Error computing handshake sha1 hash."); - write_http_error(500,""); - return; - } - - // convert sha1 hash bytes to network byte order because this sha1 - // library works on ints rather than bytes - for (int i = 0; i < 5; i++) { - message_digest[i] = htonl(message_digest[i]); - } - - server_key = base64_encode( - reinterpret_cast(message_digest),20); - - server_handshake += "HTTP/1.1 101 Switching Protocols\r\n"; - server_handshake += "Upgrade: websocket\r\n"; - server_handshake += "Connection: Upgrade\r\n"; - server_handshake += "Sec-WebSocket-Accept: "+server_key+"\r\n"; - server_handshake += "Server: WebSocket++/2011-09-22\r\n\r\n"; - - // TODO: handler requested headers - - // start async write to handle_write_handshake - boost::asio::async_write( - m_socket, - boost::asio::buffer(server_handshake), - boost::bind( - &session::handle_write_handshake, - shared_from_this(), - boost::asio::placeholders::error - ) - ); -} - -void session::handle_write_handshake(const boost::system::error_code& error) { - if (error) { - handle_error("Error writing handshake",error); - return; - } - - access_log_open(101); - - m_status = OPEN; - - if (m_local_interface) { - m_local_interface->connect(shared_from_this()); - } - - reset_message(); - this->read_frame(); -} - -void session::write_http_error(int code,const std::string &msg) { - std::stringstream server_handshake; - - server_handshake << "HTTP/1.1 " << code << " " - << (msg != "" ? msg : lookup_http_error_string(code)) - << "\r\n" - << "Server: WebSocket++/2011-09-22\r\n"; - - // additional headers? - - server_handshake << "\r\n"; - - // start async write to handle_write_handshake - boost::asio::async_write( - m_socket, - boost::asio::buffer(server_handshake.str()), - boost::bind( - &session::handle_write_http_error, - shared_from_this(), - boost::asio::placeholders::error - ) - ); - - access_log_open(code); - - std::stringstream err; - err << "Handshake ended with HTTP error: " << code << " " - << (msg != "" ? msg : lookup_http_error_string(code)); - - m_server->error_log(err.str()); -} - -void session::handle_write_http_error(const boost::system::error_code& error) { - if (error) { - handle_error("Error writing http response",error); - return; - } -} - void session::read_frame() { boost::asio::async_read( m_socket, @@ -418,11 +215,10 @@ void session::read_frame() { ); } - - void session::handle_frame_header(const boost::system::error_code& error) { if (error) { handle_error("Error reading basic frame header",error); + // TODO: close behavior return; } @@ -431,6 +227,7 @@ void session::handle_frame_header(const boost::system::error_code& error) { if (!m_read_frame.validate_basic_header()) { handle_error("Basic header validation failed",boost::system::error_code()); disconnect(CLOSE_STATUS_PROTOCOL_ERROR,""); + // TODO: close behavior return; } @@ -454,6 +251,7 @@ void session::handle_extended_frame_header( const boost::system::error_code& error) { if (error) { handle_error("Error reading extended frame header",error); + // TODO: close behavior return; } @@ -464,16 +262,6 @@ void session::handle_extended_frame_header( } void session::read_payload() { - /*char * foo = m_read_frame.get_header(); - - std::cout << std::hex << ((uint16_t*)foo)[0] << std::endl; - - std::cout << "opcode: " << m_read_frame.get_opcode() << std::endl; - std::cout << "fin: " << m_read_frame.get_fin() << std::endl; - std::cout << "mask: " << m_read_frame.get_masked() << std::endl; - std::cout << "size: " << (uint16_t)m_read_frame.get_basic_size() << std::endl; - std::cout << "payload_size: " << m_read_frame.get_payload_size() << std::endl;*/ - boost::asio::async_read( m_socket, boost::asio::buffer(m_read_frame.get_payload()), @@ -488,11 +276,11 @@ void session::read_payload() { void session::handle_read_payload (const boost::system::error_code& error) { if (error) { handle_error("Error reading payload data frame header",error); + // TODO: close behavior return; } m_read_frame.process_payload(); - if (m_status == OPEN) { switch (m_read_frame.get_opcode()) { @@ -516,6 +304,7 @@ void session::handle_read_payload (const boost::system::error_code& error) { break; default: disconnect(CLOSE_STATUS_PROTOCOL_ERROR,"Invalid Opcode"); + // TODO: close behavior break; } } else if (m_status == CLOSING) { @@ -526,23 +315,26 @@ void session::handle_read_payload (const boost::system::error_code& error) { } } else { // Recieved message before or after connection was opened/closed + // TODO: close behavior return; } // check if there was an error processing this frame and fail the connection if (m_error) { - m_server->error_log("Connection has been closed uncleanly"); + log("Connection has been closed uncleanly",LOG_ERROR); + // TODO: close behavior return; } if (m_status == CLOSED) { - access_log_close(); + log_close_result(); if (m_local_interface) { - m_local_interface->disconnect(shared_from_this(), - m_close_code, - m_close_message); + m_local_interface->on_close(shared_from_this(), + m_close_code, + m_close_message); } + // TODO: close behavior return; } @@ -552,14 +344,16 @@ void session::handle_read_payload (const boost::system::error_code& error) { void session::handle_write_frame (const boost::system::error_code& error) { if (error) { handle_error("Error writing frame data",error); + // TODO: close behavior } //std::cout << "Successfully wrote frame." << std::endl; } void session::process_ping() { - m_server->access_log("Ping"); - + access_log("Ping",ALOG_MISC_CONTROL); + // TODO: on_ping + // send pong m_write_frame.set_fin(true); m_write_frame.set_opcode(frame::PONG); @@ -569,12 +363,14 @@ void session::process_ping() { } void session::process_pong() { - m_server->access_log("Pong"); + access_log("Pong",ALOG_MISC_CONTROL); + // TODO: on_pong } void session::process_text() { if (!m_read_frame.validate_utf8(&m_utf8_state,&m_utf8_codepoint)) { disconnect(CLOSE_STATUS_INVALID_PAYLOAD,"Invalid UTF8 Data"); + // TODO: close behavior return; } @@ -586,6 +382,7 @@ void session::process_binary() { handle_error("Got a new message before the previous was finished.", boost::system::error_code()); disconnect(CLOSE_STATUS_PROTOCOL_ERROR,""); + // TODO: close behavior return; } @@ -605,12 +402,14 @@ void session::process_continuation() { handle_error("Got a continuation frame without an outstanding message.", boost::system::error_code()); disconnect(CLOSE_STATUS_PROTOCOL_ERROR,""); + // TODO: close behavior return; } if (m_current_opcode == frame::TEXT_FRAME) { if (!m_read_frame.validate_utf8(&m_utf8_state,&m_utf8_codepoint)) { disconnect(CLOSE_STATUS_INVALID_PAYLOAD,"Invalid UTF8 Data"); + // TODO: close behavior return; } } @@ -635,6 +434,7 @@ void session::process_close() { if (m_status == OPEN) { // This is the case where the remote initiated the close. m_closed_by_me = false; + // TODO: close behavior disconnect(status,message); } else if (m_status == CLOSING) { // this is an ack of our close message @@ -654,9 +454,9 @@ void session::deliver_message() { if (m_current_opcode == frame::BINARY_FRAME) { if (m_fragmented) { - m_local_interface->message(shared_from_this(),m_current_message); + m_local_interface->on_message(shared_from_this(),m_current_message); } else { - m_local_interface->message(shared_from_this(), + m_local_interface->on_message(shared_from_this(), m_read_frame.get_payload()); } } else if (m_current_opcode == frame::TEXT_FRAME) { @@ -665,6 +465,7 @@ void session::deliver_message() { // make sure the finished frame is valid utf8 if (m_utf8_state != utf8_validator::UTF8_ACCEPT) { disconnect(CLOSE_STATUS_INVALID_PAYLOAD,"Invalid UTF8 Data"); + // TODO: close behavior return; } @@ -677,12 +478,12 @@ void session::deliver_message() { ); } - m_local_interface->message(shared_from_this(),msg); + m_local_interface->on_message(shared_from_this(),msg); } else { // Not sure if this should be a fatal error or not std::stringstream err; err << "Attempted to deliver a message of unsupported opcode " << m_current_opcode; - m_server->error_log(err.str()); + log(err.str(),LOG_ERROR); } } @@ -694,9 +495,6 @@ void session::extract_payload() { } void session::write_frame() { - // print debug info - m_write_frame.print_frame(); - std::vector data; data.push_back( @@ -729,7 +527,7 @@ void session::reset_message() { m_utf8_codepoint = 0; } -void session::access_log_close() { +void session::log_close_result() { std::stringstream msg; msg << "[Connection " << this << "] " @@ -739,19 +537,19 @@ void session::access_log_close() { << "] remote:[" << m_remote_close_code << (m_remote_close_msg == "" ? "" : ","+m_remote_close_msg) << "]"; - m_server->access_log(msg.str()); + access_log(msg.str(),ALOG_DISCONNECT); } -void session::access_log_open(int code) { +void session::log_open_result() { std::stringstream msg; msg << "[Connection " << this << "] " << m_socket.remote_endpoint() << " v" << m_version << " " - << (get_header("User-Agent") == "" ? "NULL" : get_header("User-Agent")) - << " " << m_request << " " << code; + << (get_client_header("User-Agent") == "" ? "NULL" : get_client_header("User-Agent")) + << " " << m_resource << " " << m_server_http_code; - m_server->access_log(msg.str()); + access_log(msg.str(),ALOG_HANDSHAKE); } void session::handle_error(std::string msg, @@ -760,10 +558,10 @@ void session::handle_error(std::string msg, e << "[Connection " << this << "] " << msg << " (" << error << ")"; - m_server->error_log(e.str()); + log(e.str(),LOG_ERROR); if (m_local_interface) { - m_local_interface->disconnect(shared_from_this(),1006,e.str()); + m_local_interface->on_close(shared_from_this(),1006,e.str()); } m_error = true; diff --git a/src/websocket_session.hpp b/src/websocket_session.hpp index 37f752024e..19e33cb8fd 100644 --- a/src/websocket_session.hpp +++ b/src/websocket_session.hpp @@ -52,7 +52,7 @@ namespace websocketpp { class handshake_error; } -#include "websocket_server.hpp" +#include "websocketpp.hpp" #include "websocket_frame.hpp" #include "websocket_connection_handler.hpp" @@ -63,6 +63,8 @@ using boost::asio::ip::tcp; namespace websocketpp { +typedef std::map header_list; + class session : public boost::enable_shared_from_this { public: friend class handshake_error; @@ -86,12 +88,12 @@ public: static const uint16_t CLOSE_STATUS_POLICY_VIOLATION = 1008; static const uint16_t CLOSE_STATUS_MESSAGE_TOO_BIG = 1009; static const uint16_t CLOSE_STATUS_EXTENSION_REQUIRE = 1010; - - session (server_ptr s, - boost::asio::io_service& io_service, + + session (boost::asio::io_service& io_service, connection_handler_ptr defc); tcp::socket& socket(); + boost::asio::io_service& io_service(); /*** SERVER INTERFACE ***/ @@ -99,7 +101,7 @@ public: // that come after it are called as a result of an async event completing. // if any method in this chain returns before adding a new async event the // session will end. - void start(); + virtual void on_connect() = 0; // sets the internal connection handler of this connection to new_con. // This is useful if you want to switch handler objects during a connection @@ -110,24 +112,20 @@ public: /*** HANDSHAKE INTERFACE ***/ + // Set session connection information (avaliable only before/during the + // opening handshake) - // gets the value of a header or the empty string if not present. - std::string get_header(const std::string &key) const; - // adds an arbitrary header to the server handshake HTTP response. - void add_header(const std::string &key,const std::string &value); + // Get session status (valid once the connection is open) - std::string get_request() const; - std::string get_origin() const; - - // sets the subprotocol being used. This will result in the appropriate - // Sec-WebSocket-Protocol header being sent back to the client. The value - // here must have been present in the client's opening handshake. - void set_subprotocol(const std::string &protocol); - - - //int get_version(); - - //void add_extension(); + // returns the subprotocol that was negotiated during the opening handshake + // or the empty string if no subprotocol was requested. + const std::string& get_subprotocol() const; + const std::string& get_resource() const; + const std::string& get_origin() const; + std::string get_client_header(const std::string& key) const; + std::string get_server_header(const std::string& key) const; + const std::vector& get_extensions() const; + unsigned int get_version() const; /*** SESSION INTERFACE ***/ @@ -137,45 +135,29 @@ public: void ping(const std::string &msg); void pong(const std::string &msg); - void disconnect(uint16_t status,const std::string &reason); -private: - // handle_read_handshake reads the HTTP headers of the initial websocket - // handshake, parses out the request and headers, and does error checking - // TODO: Generalize a lot of the hard coded things in this method. - void handle_read_handshake(const boost::system::error_code& e, - std::size_t bytes_transferred); - - // write_handshake calculates the server portion of the handshake and - // sends it back. - // TODO: Generalize this to include things like protocols, cookies, etc - void write_handshake(); - // handle_write_handshake checks for errors writing the server handshake, - // officially declares a connection open, notifies the local interface, - // and starts the frame reading loop. - void handle_write_handshake(const boost::system::error_code& error); - - // construct and write an HTTP error in the case the handshake goes poorly - void write_http_error(int http_code,const std::string &http_err_str); - void handle_write_http_error(const boost::system::error_code& error); + // initiate a connection close + void close(uint16_t status,const std::string &reason); + void disconnect(uint16_t status,const std::string& reason); // temp + + virtual bool is_server() const = 0; +protected: + // Opening handshake processors and callbacks. These need to be defined in + // derived classes. + virtual void write_handshake() = 0; + virtual void handle_write_handshake(const boost::system::error_code& e) = 0; + virtual void read_handshake() = 0; + virtual void handle_read_handshake(const boost::system::error_code& e, + std::size_t bytes_transferred) = 0; // start async read for a websocket frame (2 bytes) to handle_frame_header void read_frame(); - - // reads frame header and devices if it needs to read more header or go - // straight to the payload. void handle_frame_header(const boost::system::error_code& error); - - // process extra headers and start payload read void handle_extended_frame_header(const boost::system::error_code& error); - - // initiate payload read void read_payload(); - - // now the frame object should be complete. Process and send it on then - // reset for new frame void handle_read_payload (const boost::system::error_code& error); - // checks for errors writing frames + // write m_write_frame out to the socket. + void write_frame(); void handle_write_frame (const boost::system::error_code& error); // helper functions for processing each opcode @@ -194,27 +176,43 @@ private: // messages are recieved. void extract_payload(); - // write m_write_frame out to the socket. - void write_frame(); - // reset session for a new message void reset_message(); - // prints connection state to the server access log with given http response - // code - void access_log_close(); - void access_log_open(int code); + // logging + virtual void log(const std::string& msg, uint16_t level) const = 0; + virtual void access_log(const std::string& msg, uint16_t level) const = 0; + + void log_close_result(); + void log_open_result(); // prints a diagnostic message and disconnects the local interface void handle_error(std::string msg,const boost::system::error_code& error); private: + std::string get_header(const std::string& key, + const header_list& list) const; + +protected: // Immutable state about the current connection from the handshake - std::string m_handshake; - std::string m_request; - std::map m_headers; - unsigned int m_version; - std::string m_subprotocol; - + // Client handshake + std::string m_raw_client_handshake; + std::string m_client_http_request; + std::string m_resource; + std::string m_client_origin; + header_list m_client_headers; + std::vector m_client_subprotocols; + std::vector m_client_extensions; + unsigned int m_version; + + // Server handshake + std::string m_raw_server_handshake; + std::string m_server_http_request; + header_list m_server_headers; + std::string m_server_subprotocol; + std::vector m_server_extensions; + uint16_t m_server_http_code; + std::string m_server_http_string; + // Mutable connection state; status_code m_status; uint16_t m_close_code; @@ -230,9 +228,9 @@ private: bool m_dropped_by_me; // Connection Resources - server_ptr m_server; - tcp::socket m_socket; - connection_handler_ptr m_local_interface; + tcp::socket m_socket; + boost::asio::io_service& m_io_service; + connection_handler_ptr m_local_interface; // Buffers boost::asio::streambuf m_buf; @@ -266,11 +264,6 @@ public: return m_msg.c_str(); } - void write(session_ptr s) const { - s->write_http_error(m_http_error_code,m_http_error_msg); - } - -private: std::string m_msg; int m_http_error_code; std::string m_http_error_msg; diff --git a/src/websocketpp.hpp b/src/websocketpp.hpp index 82d4bc8ba6..0b8322ec7b 100644 --- a/src/websocketpp.hpp +++ b/src/websocketpp.hpp @@ -30,11 +30,42 @@ #ifndef WEBSOCKETPP_HPP #define WEBSOCKETPP_HPP +#include + // Defaults namespace websocketpp { const uint64_t DEFAULT_MAX_MESSAGE_SIZE = 0xFFFFFF; // ~16MB + + // System logging levels + static const uint16_t LOG_ALL = 0; + static const uint16_t LOG_DEBUG = 1; + static const uint16_t LOG_INFO = 2; + static const uint16_t LOG_WARN = 3; + static const uint16_t LOG_ERROR = 4; + static const uint16_t LOG_FATAL = 5; + static const uint16_t LOG_OFF = 6; + + // Access logging controls + // Individual bits + static const uint16_t ALOG_CONNECT = 0x1; + static const uint16_t ALOG_DISCONNECT = 0x2; + static const uint16_t ALOG_MISC_CONTROL = 0x4; + static const uint16_t ALOG_FRAME = 0x8; + static const uint16_t ALOG_MESSAGE = 0x10; + static const uint16_t ALOG_INFO = 0x20; + static const uint16_t ALOG_HANDSHAKE = 0x40; + // Useful groups + static const uint16_t ALOG_OFF = 0x0; + static const uint16_t ALOG_CONTROL = ALOG_CONNECT + & ALOG_DISCONNECT + & ALOG_MISC_CONTROL; + static const uint16_t ALOG_ALL = 0xFFFF; } +#include "websocket_session.hpp" +#include "websocket_server_session.hpp" +#include "websocket_client_session.hpp" #include "websocket_server.hpp" +#include "websocket_client.hpp" #endif // WEBSOCKETPP_HPP