lecnet C++ network library
The lecnet library is a networking library designed for the rapid development of modern, efficient and easy to maintain C++ networking applications. It is part of the liblec libraries (https://github.com/alecmus/liblec).
The library uses embedded XML-style documentation. An HTML version of this documentation is available here.
The library is used in the collab and StudentSync apps.
Prebuild binaries of the library can be found under releases: https://github.com/alecmus/lecnet/releases.
This library uses OpenSSL (https://www.openssl.org/) for various functions, e.g. SSL encryption and making digital certificates. The user is free to compile OpenSSL on their own, but for convenience, OpenSSL binaries that I have compiled can be obtained from https://github.com/alecmus/files/tree/master/openssl. Kindly note that I prefer compiling OpenSSL so that the 32 and 64 bit binaries have different names to avoid ambiguity and deployment mistakes and,a also for other advantages that I won't get into here.
By default, the lecnet project is configured to look for OpenSSL in C:\local\libs\openssl. Placing the OpenSSL files I compiled into this location will enable building without modifications; placing them (or differently named variants) elsewhere will require appropriate modification of the project properties and source files.
Create a folder '\liblec' and clone the repository into it such that it resides in 'liblec\lecnet'. Open the Microsoft Visual Studio Solution file liblec\lecnet\lecnet.sln. Select Build -> Batch Build, then select the desired configurations of the given four:
- Debug x86
- Relese x86 (32 bit Release Build)
- Debug x64
- Release x64 (64 bit Release Build)
Build.
Three folders will be created in the \liblec directory, namely bin, lib and include. Below is a description of these subdirectories.
- bin - contains the binary files. The following files will be created:
| File | Description |
|---|---|
| lecnet32.dll | 32 bit release build |
| lecnet64.dll | 64 bit release build |
| lecnet32d.dll | 32 bit debug build |
| lecnet64d.dll | 64 bit debug build |
- lib - contains the static library files that accompany the dlls. The files are names after the respective dlls.
- include - contains the include files
Open your project's properties and for All Configurations and All Platforms set the following:
- C/C++ -> General -> Additional Include Directories -> Edit -> New Line ... add \liblec\include
- Linker -> General -> Additional Library Directories -> Edit -> New Line ... add \liblec\lib
- Debugging -> Environment -> Edit ... add PATH=\liblec\bin;\openssl\bin;PATH%
Now you can use the required functions by calling #include <liblec/lecnet/...>
Build.
Usage guidelines are available in-code in the respective header files. Below are minimalistic example programs.
Below is sample code for implementing a TCP/IP server (with default parameters):
#include <liblec/lecnet/tcp.h>
#include <thread>
#include <chrono>
#include <iostream>
class tcp_server : public liblec::lecnet::tcp::server_async {
public:
void log(const std::string& time_stamp, const std::string& event) override {
std::cout << time_stamp + ": " << event << std::endl;
}
std::string on_receive(const client_address& address,
const std::string& data_received) override {
return data_received;
}
};
int main() {
liblec::lecnet::tcp::server::server_params params;
tcp_server server;
if (server.start(params)) {
while (server.starting())
std::this_thread::sleep_for(std::chrono::milliseconds(1));
while (server.running())
std::this_thread::sleep_for(std::chrono::milliseconds(1));
server.stop();
}
return 0;
}
The code above results in the following output:
Below is sample code for implementing a TCP/IP client (with default parameters):
#include <liblec/lecnet/tcp.h>
#include <thread>
#include <chrono>
#include <iostream>
int main() {
liblec::lecnet::tcp::client::client_params params;
params.use_ssl = false;
liblec::lecnet::tcp::client client;
std::string error;
if (client.connect(params, error)) {
while (client.connecting())
std::this_thread::sleep_for(std::chrono::milliseconds(1));
if (client.connected(error)) {
while (client.running()) {
std::string received;
if (client.send_data("Sample message", received, 10, nullptr, error))
std::cout << "Reply from server: " << received << std::endl;
std::this_thread::sleep_for(std::chrono::milliseconds(1000));
}
}
else
std::cout << error << std::endl;
}
return 0;
}
The code above results in the following output:
If it's a 32 bit build you will need to deploy it with lecnet32.dll in the same folder, together with libeay32.dll (32bit build of OpenSSL). If it's a 64 bit build use the lecnet64.dll, together with libeay64.dll (64 bit build of OpenSSL).