WebSockets are a new way for Web clients to communicate with servers and vice versa, without the overhead of an HTTP protocol. Using a WebSocket connection, Web applications can perform real-time communication instead of having to poll for changes back and forth.

WebSockets feature a full duplex bi-directional communication between the server and the client which will produce a faster, more scalable and more robust high performance real time applications on the web.

How to create your first WebSocket application ? Basically the WebSocket API is available as JavaScript API which communicates with the server. On the Server side, the Expert Group that defined JSR 356 wanted to define some common patterns and techniques to handle the WebSocket communication.

Let's see with a basic example, which shows how a JavaScript WebSocket client communicates with a Server running Wildfly 8.

        <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">

        <meta charset="utf-8">
        <title>HelloWorld Web sockets</title>
        <script language="javascript" type="text/javascript">
            var wsUri = getRootUri() + "/websocket-hello/hello";

            function getRootUri() {
                return "ws://" + (document.location.hostname == "" ? "localhost" : document.location.hostname) + ":" +
                        (document.location.port == "" ? "8080" : document.location.port);

            function init() {
                output = document.getElementById("output");

            function send_message() {

                websocket = new WebSocket(wsUri);
                websocket.onopen = function(evt) {
                websocket.onmessage = function(evt) {
                websocket.onerror = function(evt) {


            function onOpen(evt) {
                writeToScreen("Connected to Endpoint!");


            function onMessage(evt) {
                writeToScreen("Message Received: " + evt.data);

            function onError(evt) {
                writeToScreen('<span style="color: red;">ERROR:</span> ' + evt.data);

            function doSend(message) {
                writeToScreen("Message Sent: " + message);

            function writeToScreen(message) {
                var pre = document.createElement("p");
                pre.style.wordWrap = "break-word";
                pre.innerHTML = message;

            window.addEventListener("load", init, false);


        <h1 style="text-align: center;">Hello World WebSocket Client</h2>


        <div style="text-align: center;">
            <form action="">
                <input onclick="send_message()" value="Send" type="button">
                <input id="textID" name="message" value="Hello WebSocket!" type="text"><br>
        <div id="output"></div>

As you can see, in order to communicate using the WebSocket protocol, you need to create a WebSocket object; this will automatically attempt to open the connection to the server.
 websocket = new WebSocket(wsUri);

Opening a connection will result in the following event which is triggered once the connection is opened:
 websocket.onopen = function(evt) {

Within the onOpen callback method, a message is sent to the Server Endpoint containing barely an Hello world string: