"use strict";
/**
* @module opcua.transport
*/
// system requires
var assert = require("node-opcua-assert");
var net = require("net");
var _ = require("underscore");
var util = require("util");
// opcua requires
var BinaryStream = require("node-opcua-binary-stream").BinaryStream;
// this modules
var TCP_transport = require("./tcp_transport").TCP_transport;
var getFakeTransport = require("./tcp_transport").getFakeTransport;
var packTcpMessage = require("./tools").packTcpMessage;
var parseEndpointUrl = require("./tools").parseEndpointUrl;
var HelloMessage = require("../_generated_/_auto_generated_HelloMessage").HelloMessage;
var TCPErrorMessage = require("../_generated_/_auto_generated_TCPErrorMessage").TCPErrorMessage;
var AcknowledgeMessage = require("../_generated_/_auto_generated_AcknowledgeMessage").AcknowledgeMessage;
var debugLog = require("node-opcua-debug").make_debugLog(__filename);
var readMessageHeader = require("node-opcua-chunkmanager").readMessageHeader;
var decodeMessage = require("./tools").decodeMessage;
function createClientSocket(endpoint_url) {
// create a socket based on Url
var ep = parseEndpointUrl(endpoint_url);
var port = ep.port;
var hostname = ep.hostname;
switch (ep.protocol) {
case "opc.tcp":
return net.connect({host: hostname, port: port});
case "fake":
var fakeSocket = getFakeTransport();
assert(ep.protocol === "fake", " Unsupported transport protocol");
process.nextTick(function () {
fakeSocket.emit("connect");
});
return fakeSocket;
case "http":
case "https":
default:
throw new Error("this transport protocol is currently not supported :" + ep.protocol);
return null;
}
}
/**
* a ClientTCP_transport connects to a remote server socket and
* initiates a communication with a HEL/ACK transaction.
* It negociates the communication parameters with the other end.
*
* @class ClientTCP_transport
* @extends TCP_transport
* @constructor
*
*
*
* @example
*
* ```javascript
* var transport = ClientTCP_transport(url);
*
* transport.timeout = 1000;
*
* transport.connect(function(err)) {
* if (err) {
* // cannot connect
* } else {
* // connected
*
* }
* });
* ....
*
* transport.write(message_chunk,'F');
*
* ....
*
* transport.on("message",function(message_chunk) {
* // do something with message from server...
* });
*
*
* ```
*
*
*/
var ClientTCP_transport = function () {
TCP_transport.call(this);
var self = this;
self.connected = false;
};
util.inherits(ClientTCP_transport, TCP_transport);
ClientTCP_transport.prototype.on_socket_ended = function(err) {
var self = this;
if (self.connected) {
TCP_transport.prototype.on_socket_ended.call(self,err);
}
};
/**
* @method connect
* @async
* @param endpoint_url {String}
* @param callback {Function} the callback function
* @param [options={}]
*/
ClientTCP_transport.prototype.connect = function (endpoint_url, callback, options) {
assert(_.isFunction(callback));
options = options || {};
var self = this;
self.protocolVersion = (options.protocolVersion !== undefined) ? options.protocolVersion : self.protocolVersion;
assert(_.isFinite(self.protocolVersion));
var ep = parseEndpointUrl(endpoint_url);
var hostname = require("os").hostname();
self.endpoint_url = endpoint_url;
self.serverUri = "urn:" + hostname + ":Sample";
debugLog("endpoint_url =", endpoint_url, "ep", ep);
try {
self._socket = createClientSocket(endpoint_url);
}
catch (err) {
return callback(err);
}
self._socket.name = "CLIENT";
self._install_socket(self._socket);
function _on_socket_error_for_connect(err) {
// this handler will catch attempt to connect to an inaccessible address.
assert(err instanceof Error);
_remove_connect_listeners();
callback(err);
}
function _on_socket_end_for_connect(err) {
console.log("Socket has been closed by server",err);
}
function _remove_connect_listeners() {
self._socket.removeListener("error", _on_socket_error_for_connect);
self._socket.removeListener("end" , _on_socket_end_for_connect);
}
function _on_socket_error_after_connection(err) {
debugLog(" ClientTCP_transport Socket Error",err.message);
// EPIPE : EPIPE (Broken pipe): A write on a pipe, socket, or FIFO for which there is no process to read the
// data. Commonly encountered at the net and http layers, indicative that the remote side of the stream being
// written to has been closed.
// ECONNRESET (Connection reset by peer): A connection was forcibly closed by a peer. This normally results
// from a loss of the connection on the remote socket due to a timeout or reboot. Commonly encountered via the
// http and net modu
if (err.message.match(/ECONNRESET|EPIPE/)) {
/**
* @event connection_break
*
*/
self.emit("connection_break");
}
}
self._socket.once("error", _on_socket_error_for_connect);
self._socket.once("end",_on_socket_end_for_connect);
self._socket.on("connect", function () {
_remove_connect_listeners();
self._perform_HEL_ACK_transaction(function(err) {
if(!err) {
// install error handler to detect connection break
self._socket.on("error",_on_socket_error_after_connection);
self.connected = true;
/**
* notify the observers that the transport is connected (the socket is connected and the the HEL/ACK
* transaction has been done)
* @event connect
*
*/
self.emit("connect");
} else {
debugLog("_perform_HEL_ACK_transaction has failed with err=",err.message);
}
callback(err);
});
});
};
ClientTCP_transport.prototype._handle_ACK_response = function (message_chunk, callback) {
var self = this;
var _stream = new BinaryStream(message_chunk);
var messageHeader = readMessageHeader(_stream);
var err;
if (messageHeader.isFinal !== "F") {
err = new Error(" invalid ACK message");
callback(err);
return;
}
var responseClass, response;
if (messageHeader.msgType === "ERR") {
responseClass = TCPErrorMessage;
_stream.rewind();
response = decodeMessage(_stream, responseClass);
var err =new Error("ACK: ERR received " + response.statusCode.toString() + " : " + response.reason);
err.statusCode = response.statusCode;
callback(err);
} else {
responseClass = AcknowledgeMessage;
_stream.rewind();
response = decodeMessage(_stream, responseClass);
self.parameters = response;
callback(null);
}
};
ClientTCP_transport.prototype._send_HELLO_request = function () {
var self = this;
assert(self._socket);
assert(_.isFinite(self.protocolVersion));
assert(self.endpoint_url.length > 0, " expecting a valid endpoint url");
// Write a message to the socket as soon as the client is connected,
// the server will receive it as message from the client
var request = new HelloMessage({
protocolVersion: self.protocolVersion,
receiveBufferSize: 1024 * 64 * 10,
sendBufferSize: 1024 * 64 * 10,// 8196 min,
maxMessageSize: 0, // 0 - no limits
maxChunkCount: 0, // 0 - no limits
endpointUrl: self.endpoint_url
});
var messageChunk = packTcpMessage("HEL", request);
self._write_chunk(messageChunk);
};
ClientTCP_transport.prototype._perform_HEL_ACK_transaction = function (callback) {
var self = this;
assert(self._socket);
assert(_.isFunction(callback));
var counter = 0;
self._install_one_time_message_receiver(function on_ACK_response(err, data) {
assert(counter === 0);
counter += 1;
if (err) {
callback(err);
self._socket.end();
} else {
self._handle_ACK_response(data, function (inner_err) {
callback(inner_err);
});
}
});
self._send_HELLO_request();
};
exports.ClientTCP_transport = ClientTCP_transport;