=this.options.duration+this.startTime){this.now=this.end;this.pos=this.state=1;this.update();this.options.curAnim[this.prop]=true;var E=true;for(var F in this.options.curAnim){if(this.options.curAnim[F]!==true){E=false}}if(E){if(this.options.display!=null){this.elem.style.overflow=this.options.overflow;this.elem.style.display=this.options.display;if(o.css(this.elem,"display")=="none"){this.elem.style.display="block"}}if(this.options.hide){o(this.elem).hide()}if(this.options.hide||this.options.show){for(var I in this.options.curAnim){o.attr(this.elem.style,I,this.options.orig[I])}}this.options.complete.call(this.elem)}return false}else{var J=G-this.startTime;this.state=J/this.options.duration;this.pos=o.easing[this.options.easing||(o.easing.swing?"swing":"linear")](this.state,J,0,1,this.options.duration);this.now=this.start+((this.end-this.start)*this.pos);this.update()}return true}};o.extend(o.fx,{speeds:{slow:600,fast:200,_default:400},step:{opacity:function(E){o.attr(E.elem.style,"opacity",E.now)},_default:function(E){if(E.elem.style&&E.elem.style[E.prop]!=null){E.elem.style[E.prop]=E.now+E.unit}else{E.elem[E.prop]=E.now}}}});if(document.documentElement.getBoundingClientRect){o.fn.offset=function(){if(!this[0]){return{top:0,left:0}}if(this[0]===this[0].ownerDocument.body){return o.offset.bodyOffset(this[0])}var G=this[0].getBoundingClientRect(),J=this[0].ownerDocument,F=J.body,E=J.documentElement,L=E.clientTop||F.clientTop||0,K=E.clientLeft||F.clientLeft||0,I=G.top+(self.pageYOffset||o.boxModel&&E.scrollTop||F.scrollTop)-L,H=G.left+(self.pageXOffset||o.boxModel&&E.scrollLeft||F.scrollLeft)-K;return{top:I,left:H}}}else{o.fn.offset=function(){if(!this[0]){return{top:0,left:0}}if(this[0]===this[0].ownerDocument.body){return o.offset.bodyOffset(this[0])}o.offset.initialized||o.offset.initialize();var J=this[0],G=J.offsetParent,F=J,O=J.ownerDocument,M,H=O.documentElement,K=O.body,L=O.defaultView,E=L.getComputedStyle(J,null),N=J.offsetTop,I=J.offsetLeft;while((J=J.parentNode)&&J!==K&&J!==H){M=L.getComputedStyle(J,null);N-=J.scrollTop,I-=J.scrollLeft;if(J===G){N+=J.offsetTop,I+=J.offsetLeft;if(o.offset.doesNotAddBorder&&!(o.offset.doesAddBorderForTableAndCells&&/^t(able|d|h)$/i.test(J.tagName))){N+=parseInt(M.borderTopWidth,10)||0,I+=parseInt(M.borderLeftWidth,10)||0}F=G,G=J.offsetParent}if(o.offset.subtractsBorderForOverflowNotVisible&&M.overflow!=="visible"){N+=parseInt(M.borderTopWidth,10)||0,I+=parseInt(M.borderLeftWidth,10)||0}E=M}if(E.position==="relative"||E.position==="static"){N+=K.offsetTop,I+=K.offsetLeft}if(E.position==="fixed"){N+=Math.max(H.scrollTop,K.scrollTop),I+=Math.max(H.scrollLeft,K.scrollLeft)}return{top:N,left:I}}}o.offset={initialize:function(){if(this.initialized){return}var L=document.body,F=document.createElement("div"),H,G,N,I,M,E,J=L.style.marginTop,K='';M={position:"absolute",top:0,left:0,margin:0,border:0,width:"1px",height:"1px",visibility:"hidden"};for(E in M){F.style[E]=M[E]}F.innerHTML=K;L.insertBefore(F,L.firstChild);H=F.firstChild,G=H.firstChild,I=H.nextSibling.firstChild.firstChild;this.doesNotAddBorder=(G.offsetTop!==5);this.doesAddBorderForTableAndCells=(I.offsetTop===5);H.style.overflow="hidden",H.style.position="relative";this.subtractsBorderForOverflowNotVisible=(G.offsetTop===-5);L.style.marginTop="1px";this.doesNotIncludeMarginInBodyOffset=(L.offsetTop===0);L.style.marginTop=J;L.removeChild(F);this.initialized=true},bodyOffset:function(E){o.offset.initialized||o.offset.initialize();var G=E.offsetTop,F=E.offsetLeft;if(o.offset.doesNotIncludeMarginInBodyOffset){G+=parseInt(o.curCSS(E,"marginTop",true),10)||0,F+=parseInt(o.curCSS(E,"marginLeft",true),10)||0}return{top:G,left:F}}};o.fn.extend({position:function(){var I=0,H=0,F;if(this[0]){var G=this.offsetParent(),J=this.offset(),E=/^body|html$/i.test(G[0].tagName)?{top:0,left:0}:G.offset();J.top-=j(this,"marginTop");J.left-=j(this,"marginLeft");E.top+=j(G,"borderTopWidth");E.left+=j(G,"borderLeftWidth");F={top:J.top-E.top,left:J.left-E.left}}return F},offsetParent:function(){var E=this[0].offsetParent||document.body;while(E&&(!/^body|html$/i.test(E.tagName)&&o.css(E,"position")=="static")){E=E.offsetParent}return o(E)}});o.each(["Left","Top"],function(F,E){var G="scroll"+E;o.fn[G]=function(H){if(!this[0]){return null}return H!==g?this.each(function(){this==l||this==document?l.scrollTo(!F?H:o(l).scrollLeft(),F?H:o(l).scrollTop()):this[G]=H}):this[0]==l||this[0]==document?self[F?"pageYOffset":"pageXOffset"]||o.boxModel&&document.documentElement[G]||document.body[G]:this[0][G]}});o.each(["Height","Width"],function(I,G){var E=I?"Left":"Top",H=I?"Right":"Bottom",F=G.toLowerCase();o.fn["inner"+G]=function(){return this[0]?o.css(this[0],F,false,"padding"):null};o.fn["outer"+G]=function(K){return this[0]?o.css(this[0],F,false,K?"margin":"border"):null};var J=G.toLowerCase();o.fn[J]=function(K){return this[0]==l?document.compatMode=="CSS1Compat"&&document.documentElement["client"+G]||document.body["client"+G]:this[0]==document?Math.max(document.documentElement["client"+G],document.body["scroll"+G],document.documentElement["scroll"+G],document.body["offset"+G],document.documentElement["offset"+G]):K===g?(this.length?o.css(this[0],J):null):this.css(J,typeof K==="string"?K:K+"px")}})})();
--------------------------------------------------------------------------------
/mqttws31.js:
--------------------------------------------------------------------------------
1 | /*******************************************************************************
2 | * Copyright (c) 2013 IBM Corp.
3 | *
4 | * All rights reserved. This program and the accompanying materials
5 | * are made available under the terms of the Eclipse Public License v1.0
6 | * and Eclipse Distribution License v1.0 which accompany this distribution.
7 | *
8 | * The Eclipse Public License is available at
9 | * http://www.eclipse.org/legal/epl-v10.html
10 | * and the Eclipse Distribution License is available at
11 | * http://www.eclipse.org/org/documents/edl-v10.php.
12 | *
13 | * Contributors:
14 | * Andrew Banks - initial API and implementation and initial documentation
15 | *******************************************************************************/
16 |
17 |
18 | // Only expose a single object name in the global namespace.
19 | // Everything must go through this module. Global Paho.MQTT module
20 | // only has a single public function, client, which returns
21 | // a Paho.MQTT client object given connection details.
22 |
23 | /**
24 | * Send and receive messages using web browsers.
25 | *
26 | * This programming interface lets a JavaScript client application use the MQTT V3.1 or
27 | * V3.1.1 protocol to connect to an MQTT-supporting messaging server.
28 | *
29 | * The function supported includes:
30 | *
31 | * - Connecting to and disconnecting from a server. The server is identified by its host name and port number.
32 | *
- Specifying options that relate to the communications link with the server,
33 | * for example the frequency of keep-alive heartbeats, and whether SSL/TLS is required.
34 | *
- Subscribing to and receiving messages from MQTT Topics.
35 | *
- Publishing messages to MQTT Topics.
36 | *
37 | *
38 | * The API consists of two main objects:
39 | *
40 | * - {@link Paho.MQTT.Client}
41 | * - This contains methods that provide the functionality of the API,
42 | * including provision of callbacks that notify the application when a message
43 | * arrives from or is delivered to the messaging server,
44 | * or when the status of its connection to the messaging server changes.
45 | * - {@link Paho.MQTT.Message}
46 | * - This encapsulates the payload of the message along with various attributes
47 | * associated with its delivery, in particular the destination to which it has
48 | * been (or is about to be) sent.
49 | *
50 | *
51 | * The programming interface validates parameters passed to it, and will throw
52 | * an Error containing an error message intended for developer use, if it detects
53 | * an error with any parameter.
54 | *
55 | * Example:
56 | *
57 | *
58 | client = new Paho.MQTT.Client(location.hostname, Number(location.port), "clientId");
59 | client.onConnectionLost = onConnectionLost;
60 | client.onMessageArrived = onMessageArrived;
61 | client.connect({onSuccess:onConnect});
62 |
63 | function onConnect() {
64 | // Once a connection has been made, make a subscription and send a message.
65 | console.log("onConnect");
66 | client.subscribe("/World");
67 | message = new Paho.MQTT.Message("Hello");
68 | message.destinationName = "/World";
69 | client.send(message);
70 | };
71 | function onConnectionLost(responseObject) {
72 | if (responseObject.errorCode !== 0)
73 | console.log("onConnectionLost:"+responseObject.errorMessage);
74 | };
75 | function onMessageArrived(message) {
76 | console.log("onMessageArrived:"+message.payloadString);
77 | client.disconnect();
78 | };
79 | *
1519 | * The send, subscribe and unsubscribe methods are implemented as asynchronous JavaScript methods
1520 | * (even though the underlying protocol exchange might be synchronous in nature).
1521 | * This means they signal their completion by calling back to the application,
1522 | * via Success or Failure callback functions provided by the application on the method in question.
1523 | * Such callbacks are called at most once per method invocation and do not persist beyond the lifetime
1524 | * of the script that made the invocation.
1525 | *
1526 | * In contrast there are some callback functions, most notably onMessageArrived,
1527 | * that are defined on the {@link Paho.MQTT.Client} object.
1528 | * These may get called multiple times, and aren't directly related to specific method invocations made by the client.
1529 | *
1530 | * @name Paho.MQTT.Client
1531 | *
1532 | * @constructor
1533 | *
1534 | * @param {string} host - the address of the messaging server, as a fully qualified WebSocket URI, as a DNS name or dotted decimal IP address.
1535 | * @param {number} port - the port number to connect to - only required if host is not a URI
1536 | * @param {string} path - the path on the host to connect to - only used if host is not a URI. Default: '/mqtt'.
1537 | * @param {string} clientId - the Messaging client identifier, between 1 and 23 characters in length.
1538 | *
1539 | * @property {string} host - read only the server's DNS hostname or dotted decimal IP address.
1540 | * @property {number} port - read only the server's port.
1541 | * @property {string} path - read only the server's path.
1542 | * @property {string} clientId - read only used when connecting to the server.
1543 | * @property {function} onConnectionLost - called when a connection has been lost.
1544 | * after a connect() method has succeeded.
1545 | * Establish the call back used when a connection has been lost. The connection may be
1546 | * lost because the client initiates a disconnect or because the server or network
1547 | * cause the client to be disconnected. The disconnect call back may be called without
1548 | * the connectionComplete call back being invoked if, for example the client fails to
1549 | * connect.
1550 | * A single response object parameter is passed to the onConnectionLost callback containing the following fields:
1551 | *
1552 | * - errorCode
1553 | *
- errorMessage
1554 | *
1555 | * @property {function} onMessageDelivered called when a message has been delivered.
1556 | * All processing that this Client will ever do has been completed. So, for example,
1557 | * in the case of a Qos=2 message sent by this client, the PubComp flow has been received from the server
1558 | * and the message has been removed from persistent storage before this callback is invoked.
1559 | * Parameters passed to the onMessageDelivered callback are:
1560 | *
1561 | * - {@link Paho.MQTT.Message} that was delivered.
1562 | *
1563 | * @property {function} onMessageArrived called when a message has arrived in this Paho.MQTT.client.
1564 | * Parameters passed to the onMessageArrived callback are:
1565 | *
1566 | * - {@link Paho.MQTT.Message} that has arrived.
1567 | *
1568 | */
1569 | var Client = function (host, port, path, clientId) {
1570 |
1571 | var uri;
1572 |
1573 | if (typeof host !== "string")
1574 | throw new Error(format(ERROR.INVALID_TYPE, [typeof host, "host"]));
1575 |
1576 | if (arguments.length == 2) {
1577 | // host: must be full ws:// uri
1578 | // port: clientId
1579 | clientId = port;
1580 | uri = host;
1581 | var match = uri.match(/^(wss?):\/\/((\[(.+)\])|([^\/]+?))(:(\d+))?(\/.*)$/);
1582 | if (match) {
1583 | host = match[4]||match[2];
1584 | port = parseInt(match[7]);
1585 | path = match[8];
1586 | } else {
1587 | throw new Error(format(ERROR.INVALID_ARGUMENT,[host,"host"]));
1588 | }
1589 | } else {
1590 | if (arguments.length == 3) {
1591 | clientId = path;
1592 | path = "/mqtt";
1593 | }
1594 | if (typeof port !== "number" || port < 0)
1595 | throw new Error(format(ERROR.INVALID_TYPE, [typeof port, "port"]));
1596 | if (typeof path !== "string")
1597 | throw new Error(format(ERROR.INVALID_TYPE, [typeof path, "path"]));
1598 |
1599 | var ipv6AddSBracket = (host.indexOf(":") != -1 && host.slice(0,1) != "[" && host.slice(-1) != "]");
1600 | uri = "ws://"+(ipv6AddSBracket?"["+host+"]":host)+":"+port+path;
1601 | }
1602 |
1603 | var clientIdLength = 0;
1604 | for (var i = 0; i 65535)
1612 | throw new Error(format(ERROR.INVALID_ARGUMENT, [clientId, "clientId"]));
1613 |
1614 | var client = new ClientImpl(uri, host, port, path, clientId);
1615 | this._getHost = function() { return host; };
1616 | this._setHost = function() { throw new Error(format(ERROR.UNSUPPORTED_OPERATION)); };
1617 |
1618 | this._getPort = function() { return port; };
1619 | this._setPort = function() { throw new Error(format(ERROR.UNSUPPORTED_OPERATION)); };
1620 |
1621 | this._getPath = function() { return path; };
1622 | this._setPath = function() { throw new Error(format(ERROR.UNSUPPORTED_OPERATION)); };
1623 |
1624 | this._getURI = function() { return uri; };
1625 | this._setURI = function() { throw new Error(format(ERROR.UNSUPPORTED_OPERATION)); };
1626 |
1627 | this._getClientId = function() { return client.clientId; };
1628 | this._setClientId = function() { throw new Error(format(ERROR.UNSUPPORTED_OPERATION)); };
1629 |
1630 | this._getOnConnectionLost = function() { return client.onConnectionLost; };
1631 | this._setOnConnectionLost = function(newOnConnectionLost) {
1632 | if (typeof newOnConnectionLost === "function")
1633 | client.onConnectionLost = newOnConnectionLost;
1634 | else
1635 | throw new Error(format(ERROR.INVALID_TYPE, [typeof newOnConnectionLost, "onConnectionLost"]));
1636 | };
1637 |
1638 | this._getOnMessageDelivered = function() { return client.onMessageDelivered; };
1639 | this._setOnMessageDelivered = function(newOnMessageDelivered) {
1640 | if (typeof newOnMessageDelivered === "function")
1641 | client.onMessageDelivered = newOnMessageDelivered;
1642 | else
1643 | throw new Error(format(ERROR.INVALID_TYPE, [typeof newOnMessageDelivered, "onMessageDelivered"]));
1644 | };
1645 |
1646 | this._getOnMessageArrived = function() { return client.onMessageArrived; };
1647 | this._setOnMessageArrived = function(newOnMessageArrived) {
1648 | if (typeof newOnMessageArrived === "function")
1649 | client.onMessageArrived = newOnMessageArrived;
1650 | else
1651 | throw new Error(format(ERROR.INVALID_TYPE, [typeof newOnMessageArrived, "onMessageArrived"]));
1652 | };
1653 |
1654 | this._getTrace = function() { return client.traceFunction; };
1655 | this._setTrace = function(trace) {
1656 | if(typeof trace === "function"){
1657 | client.traceFunction = trace;
1658 | }else{
1659 | throw new Error(format(ERROR.INVALID_TYPE, [typeof trace, "onTrace"]));
1660 | }
1661 | };
1662 |
1663 | /**
1664 | * Connect this Messaging client to its server.
1665 | *
1666 | * @name Paho.MQTT.Client#connect
1667 | * @function
1668 | * @param {Object} connectOptions - attributes used with the connection.
1669 | * @param {number} connectOptions.timeout - If the connect has not succeeded within this
1670 | * number of seconds, it is deemed to have failed.
1671 | * The default is 30 seconds.
1672 | * @param {string} connectOptions.userName - Authentication username for this connection.
1673 | * @param {string} connectOptions.password - Authentication password for this connection.
1674 | * @param {Paho.MQTT.Message} connectOptions.willMessage - sent by the server when the client
1675 | * disconnects abnormally.
1676 | * @param {Number} connectOptions.keepAliveInterval - the server disconnects this client if
1677 | * there is no activity for this number of seconds.
1678 | * The default value of 60 seconds is assumed if not set.
1679 | * @param {boolean} connectOptions.cleanSession - if true(default) the client and server
1680 | * persistent state is deleted on successful connect.
1681 | * @param {boolean} connectOptions.useSSL - if present and true, use an SSL Websocket connection.
1682 | * @param {object} connectOptions.invocationContext - passed to the onSuccess callback or onFailure callback.
1683 | * @param {function} connectOptions.onSuccess - called when the connect acknowledgement
1684 | * has been received from the server.
1685 | * A single response object parameter is passed to the onSuccess callback containing the following fields:
1686 | *
1687 | * - invocationContext as passed in to the onSuccess method in the connectOptions.
1688 | *
1689 | * @config {function} [onFailure] called when the connect request has failed or timed out.
1690 | * A single response object parameter is passed to the onFailure callback containing the following fields:
1691 | *
1692 | * - invocationContext as passed in to the onFailure method in the connectOptions.
1693 | *
- errorCode a number indicating the nature of the error.
1694 | *
- errorMessage text describing the error.
1695 | *
1696 | * @config {Array} [hosts] If present this contains either a set of hostnames or fully qualified
1697 | * WebSocket URIs (ws://example.com:1883/mqtt), that are tried in order in place
1698 | * of the host and port paramater on the construtor. The hosts are tried one at at time in order until
1699 | * one of then succeeds.
1700 | * @config {Array} [ports] If present the set of ports matching the hosts. If hosts contains URIs, this property
1701 | * is not used.
1702 | * @throws {InvalidState} if the client is not in disconnected state. The client must have received connectionLost
1703 | * or disconnected before calling connect for a second or subsequent time.
1704 | */
1705 | this.connect = function (connectOptions) {
1706 | connectOptions = connectOptions || {} ;
1707 | validate(connectOptions, {timeout:"number",
1708 | userName:"string",
1709 | password:"string",
1710 | willMessage:"object",
1711 | keepAliveInterval:"number",
1712 | cleanSession:"boolean",
1713 | useSSL:"boolean",
1714 | invocationContext:"object",
1715 | onSuccess:"function",
1716 | onFailure:"function",
1717 | hosts:"object",
1718 | ports:"object",
1719 | mqttVersion:"number"});
1720 |
1721 | // If no keep alive interval is set, assume 60 seconds.
1722 | if (connectOptions.keepAliveInterval === undefined)
1723 | connectOptions.keepAliveInterval = 60;
1724 |
1725 | if (connectOptions.mqttVersion > 4 || connectOptions.mqttVersion < 3) {
1726 | throw new Error(format(ERROR.INVALID_ARGUMENT, [connectOptions.mqttVersion, "connectOptions.mqttVersion"]));
1727 | }
1728 |
1729 | if (connectOptions.mqttVersion === undefined) {
1730 | connectOptions.mqttVersionExplicit = false;
1731 | connectOptions.mqttVersion = 4;
1732 | } else {
1733 | connectOptions.mqttVersionExplicit = true;
1734 | }
1735 |
1736 | //Check that if password is set, so is username
1737 | if (connectOptions.password === undefined && connectOptions.userName !== undefined)
1738 | throw new Error(format(ERROR.INVALID_ARGUMENT, [connectOptions.password, "connectOptions.password"]))
1739 |
1740 | if (connectOptions.willMessage) {
1741 | if (!(connectOptions.willMessage instanceof Message))
1742 | throw new Error(format(ERROR.INVALID_TYPE, [connectOptions.willMessage, "connectOptions.willMessage"]));
1743 | // The will message must have a payload that can be represented as a string.
1744 | // Cause the willMessage to throw an exception if this is not the case.
1745 | connectOptions.willMessage.stringPayload;
1746 |
1747 | if (typeof connectOptions.willMessage.destinationName === "undefined")
1748 | throw new Error(format(ERROR.INVALID_TYPE, [typeof connectOptions.willMessage.destinationName, "connectOptions.willMessage.destinationName"]));
1749 | }
1750 | if (typeof connectOptions.cleanSession === "undefined")
1751 | connectOptions.cleanSession = true;
1752 | if (connectOptions.hosts) {
1753 |
1754 | if (!(connectOptions.hosts instanceof Array) )
1755 | throw new Error(format(ERROR.INVALID_ARGUMENT, [connectOptions.hosts, "connectOptions.hosts"]));
1756 | if (connectOptions.hosts.length <1 )
1757 | throw new Error(format(ERROR.INVALID_ARGUMENT, [connectOptions.hosts, "connectOptions.hosts"]));
1758 |
1759 | var usingURIs = false;
1760 | for (var i = 0; i
1809 | * @param {object} subscribeOptions - used to control the subscription
1810 | *
1811 | * @param {number} subscribeOptions.qos - the maiximum qos of any publications sent
1812 | * as a result of making this subscription.
1813 | * @param {object} subscribeOptions.invocationContext - passed to the onSuccess callback
1814 | * or onFailure callback.
1815 | * @param {function} subscribeOptions.onSuccess - called when the subscribe acknowledgement
1816 | * has been received from the server.
1817 | * A single response object parameter is passed to the onSuccess callback containing the following fields:
1818 | *
1819 | * - invocationContext if set in the subscribeOptions.
1820 | *
1821 | * @param {function} subscribeOptions.onFailure - called when the subscribe request has failed or timed out.
1822 | * A single response object parameter is passed to the onFailure callback containing the following fields:
1823 | *
1824 | * - invocationContext - if set in the subscribeOptions.
1825 | *
- errorCode - a number indicating the nature of the error.
1826 | *
- errorMessage - text describing the error.
1827 | *
1828 | * @param {number} subscribeOptions.timeout - which, if present, determines the number of
1829 | * seconds after which the onFailure calback is called.
1830 | * The presence of a timeout does not prevent the onSuccess
1831 | * callback from being called when the subscribe completes.
1832 | * @throws {InvalidState} if the client is not in connected state.
1833 | */
1834 | this.subscribe = function (filter, subscribeOptions) {
1835 | if (typeof filter !== "string")
1836 | throw new Error("Invalid argument:"+filter);
1837 | subscribeOptions = subscribeOptions || {} ;
1838 | validate(subscribeOptions, {qos:"number",
1839 | invocationContext:"object",
1840 | onSuccess:"function",
1841 | onFailure:"function",
1842 | timeout:"number"
1843 | });
1844 | if (subscribeOptions.timeout && !subscribeOptions.onFailure)
1845 | throw new Error("subscribeOptions.timeout specified with no onFailure callback.");
1846 | if (typeof subscribeOptions.qos !== "undefined"
1847 | && !(subscribeOptions.qos === 0 || subscribeOptions.qos === 1 || subscribeOptions.qos === 2 ))
1848 | throw new Error(format(ERROR.INVALID_ARGUMENT, [subscribeOptions.qos, "subscribeOptions.qos"]));
1849 | client.subscribe(filter, subscribeOptions);
1850 | };
1851 |
1852 | /**
1853 | * Unsubscribe for messages, stop receiving messages sent to destinations described by the filter.
1854 | *
1855 | * @name Paho.MQTT.Client#unsubscribe
1856 | * @function
1857 | * @param {string} filter - describing the destinations to receive messages from.
1858 | * @param {object} unsubscribeOptions - used to control the subscription
1859 | * @param {object} unsubscribeOptions.invocationContext - passed to the onSuccess callback
1860 | or onFailure callback.
1861 | * @param {function} unsubscribeOptions.onSuccess - called when the unsubscribe acknowledgement has been received from the server.
1862 | * A single response object parameter is passed to the
1863 | * onSuccess callback containing the following fields:
1864 | *
1865 | * - invocationContext - if set in the unsubscribeOptions.
1866 | *
1867 | * @param {function} unsubscribeOptions.onFailure called when the unsubscribe request has failed or timed out.
1868 | * A single response object parameter is passed to the onFailure callback containing the following fields:
1869 | *
1870 | * - invocationContext - if set in the unsubscribeOptions.
1871 | *
- errorCode - a number indicating the nature of the error.
1872 | *
- errorMessage - text describing the error.
1873 | *
1874 | * @param {number} unsubscribeOptions.timeout - which, if present, determines the number of seconds
1875 | * after which the onFailure callback is called. The presence of
1876 | * a timeout does not prevent the onSuccess callback from being
1877 | * called when the unsubscribe completes
1878 | * @throws {InvalidState} if the client is not in connected state.
1879 | */
1880 | this.unsubscribe = function (filter, unsubscribeOptions) {
1881 | if (typeof filter !== "string")
1882 | throw new Error("Invalid argument:"+filter);
1883 | unsubscribeOptions = unsubscribeOptions || {} ;
1884 | validate(unsubscribeOptions, {invocationContext:"object",
1885 | onSuccess:"function",
1886 | onFailure:"function",
1887 | timeout:"number"
1888 | });
1889 | if (unsubscribeOptions.timeout && !unsubscribeOptions.onFailure)
1890 | throw new Error("unsubscribeOptions.timeout specified with no onFailure callback.");
1891 | client.unsubscribe(filter, unsubscribeOptions);
1892 | };
1893 |
1894 | /**
1895 | * Send a message to the consumers of the destination in the Message.
1896 | *
1897 | * @name Paho.MQTT.Client#send
1898 | * @function
1899 | * @param {string|Paho.MQTT.Message} topic - mandatory The name of the destination to which the message is to be sent.
1900 | * - If it is the only parameter, used as Paho.MQTT.Message object.
1901 | * @param {String|ArrayBuffer} payload - The message data to be sent.
1902 | * @param {number} qos The Quality of Service used to deliver the message.
1903 | *
1904 | * - 0 Best effort (default).
1905 | *
- 1 At least once.
1906 | *
- 2 Exactly once.
1907 | *
1908 | * @param {Boolean} retained If true, the message is to be retained by the server and delivered
1909 | * to both current and future subscriptions.
1910 | * If false the server only delivers the message to current subscribers, this is the default for new Messages.
1911 | * A received message has the retained boolean set to true if the message was published
1912 | * with the retained boolean set to true
1913 | * and the subscrption was made after the message has been published.
1914 | * @throws {InvalidState} if the client is not connected.
1915 | */
1916 | this.send = function (topic,payload,qos,retained) {
1917 | var message ;
1918 |
1919 | if(arguments.length == 0){
1920 | throw new Error("Invalid argument."+"length");
1921 |
1922 | }else if(arguments.length == 1) {
1923 |
1924 | if (!(topic instanceof Message) && (typeof topic !== "string"))
1925 | throw new Error("Invalid argument:"+ typeof topic);
1926 |
1927 | message = topic;
1928 | if (typeof message.destinationName === "undefined")
1929 | throw new Error(format(ERROR.INVALID_ARGUMENT,[message.destinationName,"Message.destinationName"]));
1930 | client.send(message);
1931 |
1932 | }else {
1933 | //parameter checking in Message object
1934 | message = new Message(payload);
1935 | message.destinationName = topic;
1936 | if(arguments.length >= 3)
1937 | message.qos = qos;
1938 | if(arguments.length >= 4)
1939 | message.retained = retained;
1940 | client.send(message);
1941 | }
1942 | };
1943 |
1944 | /**
1945 | * Normal disconnect of this Messaging client from its server.
1946 | *
1947 | * @name Paho.MQTT.Client#disconnect
1948 | * @function
1949 | * @throws {InvalidState} if the client is already disconnected.
1950 | */
1951 | this.disconnect = function () {
1952 | client.disconnect();
1953 | };
1954 |
1955 | /**
1956 | * Get the contents of the trace log.
1957 | *
1958 | * @name Paho.MQTT.Client#getTraceLog
1959 | * @function
1960 | * @return {Object[]} tracebuffer containing the time ordered trace records.
1961 | */
1962 | this.getTraceLog = function () {
1963 | return client.getTraceLog();
1964 | }
1965 |
1966 | /**
1967 | * Start tracing.
1968 | *
1969 | * @name Paho.MQTT.Client#startTrace
1970 | * @function
1971 | */
1972 | this.startTrace = function () {
1973 | client.startTrace();
1974 | };
1975 |
1976 | /**
1977 | * Stop tracing.
1978 | *
1979 | * @name Paho.MQTT.Client#stopTrace
1980 | * @function
1981 | */
1982 | this.stopTrace = function () {
1983 | client.stopTrace();
1984 | };
1985 |
1986 | this.isConnected = function() {
1987 | return client.connected;
1988 | };
1989 | };
1990 |
1991 | Client.prototype = {
1992 | get host() { return this._getHost(); },
1993 | set host(newHost) { this._setHost(newHost); },
1994 |
1995 | get port() { return this._getPort(); },
1996 | set port(newPort) { this._setPort(newPort); },
1997 |
1998 | get path() { return this._getPath(); },
1999 | set path(newPath) { this._setPath(newPath); },
2000 |
2001 | get clientId() { return this._getClientId(); },
2002 | set clientId(newClientId) { this._setClientId(newClientId); },
2003 |
2004 | get onConnectionLost() { return this._getOnConnectionLost(); },
2005 | set onConnectionLost(newOnConnectionLost) { this._setOnConnectionLost(newOnConnectionLost); },
2006 |
2007 | get onMessageDelivered() { return this._getOnMessageDelivered(); },
2008 | set onMessageDelivered(newOnMessageDelivered) { this._setOnMessageDelivered(newOnMessageDelivered); },
2009 |
2010 | get onMessageArrived() { return this._getOnMessageArrived(); },
2011 | set onMessageArrived(newOnMessageArrived) { this._setOnMessageArrived(newOnMessageArrived); },
2012 |
2013 | get trace() { return this._getTrace(); },
2014 | set trace(newTraceFunction) { this._setTrace(newTraceFunction); }
2015 |
2016 | };
2017 |
2018 | /**
2019 | * An application message, sent or received.
2020 | *
2021 | * All attributes may be null, which implies the default values.
2022 | *
2023 | * @name Paho.MQTT.Message
2024 | * @constructor
2025 | * @param {String|ArrayBuffer} payload The message data to be sent.
2026 | *
2027 | * @property {string} payloadString read only The payload as a string if the payload consists of valid UTF-8 characters.
2028 | * @property {ArrayBuffer} payloadBytes read only The payload as an ArrayBuffer.
2029 | *
2030 | * @property {string} destinationName mandatory The name of the destination to which the message is to be sent
2031 | * (for messages about to be sent) or the name of the destination from which the message has been received.
2032 | * (for messages received by the onMessage function).
2033 | *
2034 | * @property {number} qos The Quality of Service used to deliver the message.
2035 | *
2036 | * - 0 Best effort (default).
2037 | *
- 1 At least once.
2038 | *
- 2 Exactly once.
2039 | *
2040 | *
2041 | * @property {Boolean} retained If true, the message is to be retained by the server and delivered
2042 | * to both current and future subscriptions.
2043 | * If false the server only delivers the message to current subscribers, this is the default for new Messages.
2044 | * A received message has the retained boolean set to true if the message was published
2045 | * with the retained boolean set to true
2046 | * and the subscrption was made after the message has been published.
2047 | *
2048 | * @property {Boolean} duplicate read only If true, this message might be a duplicate of one which has already been received.
2049 | * This is only set on messages received from the server.
2050 | *
2051 | */
2052 | var Message = function (newPayload) {
2053 | var payload;
2054 | if ( typeof newPayload === "string"
2055 | || newPayload instanceof ArrayBuffer
2056 | || newPayload instanceof Int8Array
2057 | || newPayload instanceof Uint8Array
2058 | || newPayload instanceof Int16Array
2059 | || newPayload instanceof Uint16Array
2060 | || newPayload instanceof Int32Array
2061 | || newPayload instanceof Uint32Array
2062 | || newPayload instanceof Float32Array
2063 | || newPayload instanceof Float64Array
2064 | ) {
2065 | payload = newPayload;
2066 | } else {
2067 | throw (format(ERROR.INVALID_ARGUMENT, [newPayload, "newPayload"]));
2068 | }
2069 |
2070 | this._getPayloadString = function () {
2071 | if (typeof payload === "string")
2072 | return payload;
2073 | else
2074 | return parseUTF8(payload, 0, payload.length);
2075 | };
2076 |
2077 | this._getPayloadBytes = function() {
2078 | if (typeof payload === "string") {
2079 | var buffer = new ArrayBuffer(UTF8Length(payload));
2080 | var byteStream = new Uint8Array(buffer);
2081 | stringToUTF8(payload, byteStream, 0);
2082 |
2083 | return byteStream;
2084 | } else {
2085 | return payload;
2086 | };
2087 | };
2088 |
2089 | var destinationName = undefined;
2090 | this._getDestinationName = function() { return destinationName; };
2091 | this._setDestinationName = function(newDestinationName) {
2092 | if (typeof newDestinationName === "string")
2093 | destinationName = newDestinationName;
2094 | else
2095 | throw new Error(format(ERROR.INVALID_ARGUMENT, [newDestinationName, "newDestinationName"]));
2096 | };
2097 |
2098 | var qos = 0;
2099 | this._getQos = function() { return qos; };
2100 | this._setQos = function(newQos) {
2101 | if (newQos === 0 || newQos === 1 || newQos === 2 )
2102 | qos = newQos;
2103 | else
2104 | throw new Error("Invalid argument:"+newQos);
2105 | };
2106 |
2107 | var retained = false;
2108 | this._getRetained = function() { return retained; };
2109 | this._setRetained = function(newRetained) {
2110 | if (typeof newRetained === "boolean")
2111 | retained = newRetained;
2112 | else
2113 | throw new Error(format(ERROR.INVALID_ARGUMENT, [newRetained, "newRetained"]));
2114 | };
2115 |
2116 | var duplicate = false;
2117 | this._getDuplicate = function() { return duplicate; };
2118 | this._setDuplicate = function(newDuplicate) { duplicate = newDuplicate; };
2119 | };
2120 |
2121 | Message.prototype = {
2122 | get payloadString() { return this._getPayloadString(); },
2123 | get payloadBytes() { return this._getPayloadBytes(); },
2124 |
2125 | get destinationName() { return this._getDestinationName(); },
2126 | set destinationName(newDestinationName) { this._setDestinationName(newDestinationName); },
2127 |
2128 | get qos() { return this._getQos(); },
2129 | set qos(newQos) { this._setQos(newQos); },
2130 |
2131 | get retained() { return this._getRetained(); },
2132 | set retained(newRetained) { this._setRetained(newRetained); },
2133 |
2134 | get duplicate() { return this._getDuplicate(); },
2135 | set duplicate(newDuplicate) { this._setDuplicate(newDuplicate); }
2136 | };
2137 |
2138 | // Module contents.
2139 | return {
2140 | Client: Client,
2141 | Message: Message
2142 | };
2143 | })(window);
2144 |
--------------------------------------------------------------------------------