TagBites.Net Logo

TagBites.Net 1.0

TCP client-server .NET library with RMI support.

  • Simple and lightweight
  • RMI (Remote Method Invocation) support
  • Thread safe

Download Get Started

TagBites.Net

Lightweight and simple TCP client-server .NET library with RMI support.

NuGet Package: https://www.nuget.org/packages/TagBites.Net/

Chat example

Client code

var client = new Client("127.0.0.1", 82);
client.Received += (s, e) => Console.WriteLine(e.Message.ToString());
await client.ConnectAsync();

while (true)
    await client.SendAsync(Console.ReadLine());

Server code

var server = new Server("127.0.0.1", 82);
server.Received += (s, e) => server.SendToAllAsync($"{e.Client}: {e.Message}", e.Client);
server.ClientConnected += (s, e) => server.SendToAllAsync($"{e.Client} connected", e.Client);
server.ClientDisconnected += (s, e) => server.SendToAllAsync($"{e.Client} disconnected", e.Client);
server.Listening = true; // starts a new thread

Console.ReadLine(); // for console application to prevent app from closing

In this example a string type is used for communication, but any serializable objects can be send/received.

By default System.Runtime.Serialization.Formatters.Binary.BinaryFormatter is used for serialization, but it can be replaced with a custom implementation.

Full example on github: TagBites.Net-Sample-Chat.

Chat example using RMI (Remote Method Invocation)

Client code

var client = new Client("127.0.0.1", 82);
client.Use<IChatClient, ChatClient>();
await client.ConnectAsync();

while (true)
{
    var message = Console.ReadLine();
    client.GetController<IChatServer>().Send(message);
}

The method Use<TControllerInterface, TController>() registers a controller that can be used by the server. The server site can use the IChatClient interface to execute methods implemented by ChatClient on the client's site. The client/server can registers many controllers. The controller instance will be created on first use.

GetController<T>() returns the proxy interface to the class register in the remote site. The calling method in this instance will invoke method in the remote site. The Controller can invoke methods with primitive or serializable parameter types and returns void/Task or any primitive or serializable type.

Server code

var server = new Server("127.0.0.1", 82);
server.Use<IChatServer, ChatServer>(client => new ChatServer() { Client = client, Server = server });
server.ClientConnected += (s, e) =>
{
    foreach (var client in server.GetClients())
        client.GetController<IChatClient>().MessageReceive(null, $"Client {e.Client} connected.");

    Console.WriteLine($"Client {e.Client.Identity} connected.");
};
server.ClientDisconnected += (s, e) =>
{
    foreach (var client in server.GetClients())
        client.GetController<IChatClient>().MessageReceive(null, $"Client {e.Client} disconnected.");

    Console.WriteLine($"Client {e.Client} disconnected.");
};
server.Listening = true;

Console.ReadLine();

Classes

public interface IChatClient
{
    void MessageReceive(string userName, string message);
}
public class ChatClient : IChatClient 
{
    public void MessageReceive(string userName, string message)
    {
        Console.WriteLine($"{userName ?? "Server"}: {message}");
    }
}

public interface IChatServer
{
    void Send(string message);
}
public class ChatServer : IChatServer 
{
    public Server Server { get; set; }
    public ServerClient Client { get; set; }

    public void Send(string message)
    {
        Console.WriteLine($"{Client.Identity}: {message}");

        foreach (var client in Server.GetClients())
            if (Client != client)
                client.GetController<IChatClient>().MessageReceive(Client.Identity?.ToString(), message);
    }
}

Full example on github: TagBites.Net-Sample-ChatWithControllers.