tree: 1d545015264f1cc3c4535456138587b38bdd7f07 [path history] [tgz]
  1. README.md
  2. pom.xml
  3. src/
examples/karaf-websocket-example/README.md

Apache Karaf Websocket example

Abstract

This example show how to register a websocket in the Karaf HTTP Service.

Artifacts

  • karaf-websocket-example is the main bundle using @WebSocket annotation.

Build

The build uses Apache Maven. Simply use:

mvn clean install

Deployment

On a running Karaf instance, first, you have to install the http, jetty and scr features:

karaf@root()> feature:install http
karaf@root()> feature:inistal jetty
karaf@root()> feature:install scr

Then, you can install the websocket example bundle:

karaf@root()> bundle:install -s mvn:org.apache.karaf.examples/karaf-websocket-example/LATEST

You can see the websocket registered in the HTTP service:

karaf@root()> http:list
ID │ Servlet                 │ Servlet-Name   │ State       │ Alias              │ Url
───┼─────────────────────────┼────────────────┼─────────────┼────────────────────┼───────────────────────
92 │ WebsocketExampleServlet │ ServletModel-2 │ Deployed    │ /example-websocket │ [/example-websocket/*]

Usage

The websocket is available on http://localhost:8181/example-websocket.

You can now register your client (like curl) on this URL:

curl --include \
     --no-buffer \
     --header "Connection: Upgrade" \
     --header "Upgrade: websocket" \
     --header "Host: localhost:8181" \
     --header "Origin: http://localhost:8181/example-websocket" \
     --header "Sec-WebSocket-Key: SGVsbG8sIHdvcmxkIQ==" \
     --header "Sec-WebSocket-Version: 13" \
     http://localhost:8181/example-websocket

Your client will have a Hello World message on your client every second.