RIC-1076: Add the TcpRangeCounter Client to the CodeRT Samples (#61)

* A new Node.js Express Client sample is provided that sends events to the TcpRangeCounter sample.

* Removed some dependencies, removed HCL image, moved some styling to style.css, put under client-ui folder.

Author: Mary ellen Kerr

.gitignore

@@ -9,3 +9,4 @@ art-comp-test/tests/**/*_target/*
 art-comp-test/**/.vscode/art_build_settings.json
 art-comp-test/testLib_target/*
 art-comp-test/tests/*/logs/application.log
+art-samples/TcpRangeCounter/client-ui/node_modules

art-samples/TcpRangeCounter/client-ui/.project

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>TcpRangeCounter_Client</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.wst.common.project.facet.core.builder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.wst.validation.validationbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.wst.jsdt.core.jsNature</nature>
+		<nature>org.eclipse.wst.common.project.facet.core.nature</nature>
+		<nature>com.hcl.nodejs.jsnature.nature</nature>
+	</natures>
+</projectDescription>

art-samples/TcpRangeCounter/client-ui/.settings/org.eclipse.wst.common.project.facet.core.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<faceted-project>
+  <installed facet="nodejs.app" version="1.0"/>
+</faceted-project>

art-samples/TcpRangeCounter/client-ui/README.md

@@ -0,0 +1,19 @@
+# TcpRangeCounter Client
+
+This Node.js Express sample client works with the TcpRangeCounter sample by sending events to the TcpRangeCounter sample.  The TcpRangeCounter sample implements a counter that starts at a min value and increments until it reaches a max value.  It embeds a TCP server which allows it to be dynamically configured by means of sending TCP requests.  These requests corresponds to the events of the Events protocol:
+
+* setMin: Sets the min value of the range (default 0).
+
+* setMax: Sets the max value of the range (default 10).
+
+* setDelta: Sets the delta by which the counter increments in each step (default 1; Use a negative value to count down instead of up).
+
+* resumeCounting: Resume the counter when it has stopped.
+
+The following are instructions to run this sample client.
+
+* Build and start the TcpRangeCounter sample by following the directions in its README file.
+
+* Start this sample client by entering 'npm install' and then 'npm start' in a terminal session.  The client listens on port 3000.
+
+* Invoke the sample client in a web browser at http://localhost:3000/.

art-samples/TcpRangeCounter/client-ui/app.js

@@ -0,0 +1,39 @@
+var createError = require('http-errors');
+var express = require('express');
+var path = require('path');
+var bodyParser = require('body-parser');
+
+var indexRouter = require('./routes/index');
+var usersRouter = require('./routes/users');
+
+var app = express();
+
+// view engine setup
+app.set('views', path.join(__dirname, 'views'));
+app.set('view engine', 'ejs');
+
+app.use(express.json());
+app.use(express.urlencoded({ extended: false }));
+app.use(express.static(path.join(__dirname, 'public')));
+app.use(bodyParser.json());
+
+app.use('/', indexRouter);
+app.use('/users', usersRouter);
+
+// catch 404 and forward to error handler
+app.use(function(req, res, next) {
+  next(createError(404));
+});
+
+// error handler
+app.use(function(err, req, res, next) {
+  // set locals, only providing error in development
+  res.locals.message = err.message;
+  res.locals.error = req.app.get('env') === 'development' ? err : {};
+
+  // render the error page
+  res.status(err.status || 500);
+  res.render('error');
+});
+
+module.exports = app;

art-samples/TcpRangeCounter/client-ui/bin/www

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+
+/**
+ * Module dependencies.
+ */
+
+var app = require('../app');
+var debug = require('debug')('TcpRangeCounter_Client:server');
+var http = require('http');
+
+/**
+ * Get port from environment and store in Express.
+ */
+
+var port = normalizePort(process.env.PORT || '3000');
+app.set('port', port);
+
+/**
+ * Create HTTP server.
+ */
+
+var server = http.createServer(app);
+
+/**
+ * Listen on provided port, on all network interfaces.
+ */
+
+server.listen(port);
+server.on('error', onError);
+server.on('listening', onListening);
+
+/**
+ * Normalize a port into a number, string, or false.
+ */
+
+function normalizePort(val) {
+  var port = parseInt(val, 10);
+
+  if (isNaN(port)) {
+    // named pipe
+    return val;
+  }
+
+  if (port >= 0) {
+    // port number
+    return port;
+  }
+
+  return false;
+}
+
+/**
+ * Event listener for HTTP server "error" event.
+ */
+
+function onError(error) {
+  if (error.syscall !== 'listen') {
+    throw error;
+  }
+
+  var bind = typeof port === 'string'
+    ? 'Pipe ' + port
+    : 'Port ' + port;
+
+  // handle specific listen errors with friendly messages
+  switch (error.code) {
+    case 'EACCES':
+      console.error(bind + ' requires elevated privileges');
+      process.exit(1);
+      break;
+    case 'EADDRINUSE':
+      console.error(bind + ' is already in use');
+      process.exit(1);
+      break;
+    default:
+      throw error;
+  }
+}
+
+/**
+ * Event listener for HTTP server "listening" event.
+ */
+
+function onListening() {
+  var addr = server.address();
+  var bind = typeof addr === 'string'
+    ? 'pipe ' + addr
+    : 'port ' + addr.port;
+  debug('Listening on ' + bind);
+}