This example shows how to connect to a junior using the JnrWebsocket library. It also shows a simple use of the connection listeners.
View on GitHub
Tag Archive: javascript
Sometimes, most times, things don’t work the first time we code them. We need to dig in to find out what we did wrong. Sometimes it’s as simple as a typo. Sometimes it’s complex logic that needs a little work. The browser has great tools to help you out. Press F12 on your keyboard to open the Developer Tools.
Debugger / Sources
Here is a view of a Firefox browser showing the code for an example that Reads a Registry Key. You’ll first notice there is nothing on the HTML page. You need to select the example HTML file in the Debugger tab or Sources in Chrome.
Console
Clicking on Console will show you what output there is from JavaScript.
The JNIOR Web-socket JavaScript Library depends on the INTEG comm.js file. The comm.js file also relies on 2 other JavaScript files. The md5.js file is required for calculating the authentication hash and the base64.js file is required for encoding and decoding file contents.
Your <head> section must include the following lines. The example shows putting the integ files in an integ folder.
<html>
<head>
...
<script src="integ/base64.js" type="text/javascript"></script>
<script src="integ/md5.js" type="text/javascript"></script>
<script src="integ/comm.js" type="text/javascript"></script>
<script src="integ/jnrwebsocket.js" type="text/javascript"></script>
...To use the JnrWebsocket we must instantiate an JnrWebsocket object and call connect().
var jnrWebsocket = new JnrWebsocket();
jnrWebsocket.connect();
By default the connect() call will build the ws:// URI with the hostname from the server where the code is being hosted. If you want to connect to other JNIORs and not just the one hosting the web app then you can pass in the IP Address of the target JNIOR.
var jnrWebsocket = new JnrWebsocket();
jnrWebsocket.connect(ipAddress);
Now What?
Okay? Great, I’m connected to the JNIOR WebSocket Server. Now what can I do?
The short answer: Probably Nothing.
Not what you wanted to hear but it’s only because most likely you need to log in. We find that out by adding an onLoggedIn listener.
There are two ways of doing this which are identical. You can call addEventListener() and supply the type of listener and the callback.
jnrWebsocket.addEventListener('onLoggedIn', function (json) {
alert("we're logged in!");
});
Callback? What is a callback?
You just saw the use of the OnLoggedInListener callback. So what is a callback?
A callback is, as Mozilla MDN Web Docs says, “A callback function is a function passed into another function as an argument, which is then invoked inside the outer function to complete some kind of routine or action.”
In simple terms, it is a piece of code that gets alerted of an event. In the case above, the code was alerted when the login was successful. There are other callback events such as when the login fails, when there was an update to a registry key, when I/O changes, when any message was received from the Web Server, and when there was a reply message from a Java application.
Above you saw the use of the addEventListener() where the type was supplied as well as the callback that will get called. Note that this is an “add” method and not a “set”. Multiple callbacks can be defined per event. So the syntax of the addEventListener is addEventListener( type, callback ).
The addEventListener uses the type to call the correct add*Listener function. Those are available to you as well. Here are the available types and the associated add*Listener function that is called.
onLoggedIncallsaddOnLoggedInListener(callback)onIOChangecallsaddOnIOChangeListener(callback)onMessagecallsaddOnMessageListener(listener)onReplyMessagecallsaddOnReplyMessageListener(listener)
You’ll notice the absence of the registry listener that was mentioned above. This is because you add the callback to get called specifically for the registry key that was requested.
@integpg