MicroSerializationLibrary.Android 1.1.4.3

Micro Serialization Library

MicroSerializationLibrary is a Network & Serialization library intended for ease of use.

Real-World Examples

• Chat servers
• Data Transfer
• Local Communication
• Unity Multiplayer Development

No Serializer is inlcuded in this package.

Please Install MicroSerializationLibrary.JSON or MicroserializionLibrary.MsgPack to use this package.

https://www.nuget.org/packages/MicroSerializationLibrary.JSON/

https://www.nuget.org/packages/MicroSerializationLibrary.MessagePack/

CLI

dotnet add package MicroSerializationLibrary.JSON

dotnet add package MicroSerializationLibrary.MessagePack

NuGet Package Manager

PM> NuGet\Install-Package MicroSerializationLibrary.JSON

PM> NuGet\Install-Package MicroSerializationLibrary.MessagePack 

All Serializers will only serialize Properties within each Serializable Class.

Note

MicroSerializationLibrary exposes the ISerializationProtocol interface which can be used to add another serializer.

Preferential use of Serializers

MsgPack Serializer

MsgPack is a fast serializer, which comes at the cost of stability.

Used when Performance is key in your application.

JSON Serializer

JSON is a serializer used by many, and will not fail.

While it is very accurate, JSON does not compare to MsgPack when it comes to performance.

Client & Server are Event Driven.

The events are executed on a separate thread.

C#

    Serialization.JsonSerializer Serializer = new Serialization.JsonSerializer();
    MicroSerializationLibrary.Networking.Client.TcpClient TcpClient;
    MicroSerializationLibrary.Networking.Server.TcpServer TcpServer;

    private const string Host = "127.0.0.1";
    private const int Port = 7474;

    // Handle  the incoming object
    private void TcpServer_OnReceive(ConnectedSocket Client, object obj, int BytesReceived) {
        // Send The Client an Object
        TcpServer.Send(Client, MySerializableClass);

        // Send All Clients an Object
        TcpServer.Broadcast(MySerializableClass);

    }

    private void TcpClient_OnConnected(ConnectedSocket Client) {
        TcpClient.Send(new AuthorizationRequestObject());
    }


    public SurroundingClass() {
        // Creating a server.
        TcpServer = new Server.TcpServer(Serializer, Port);
        TcpServer.OnReceive += TcpServer_OnReceive;
        // '9999' being the max amount of pending connections allowed.
        TcpServer.Listen(9999);

        // Creating a client.
        TcpClient = new Client.TcpClient(Serializer);
        TcpClient.OnConnected += TcpClient_OnConnected;
        TcpClient.Connect("127.0.0.1", Port);
    }

VB.NET

    Dim Serializer As Serialization.JsonSerializer = New Serialization.JsonSerializer()
    Dim WithEvents TcpClient As New MicroSerializationLibrary.Networking.Client.TcpClient(Serializer)
    Dim WithEvents TcpServer As New MicroSerializationLibrary.Networking.Server.TcpServer(Serializer)

    Private Const Host As string = "127.0.0.1"
    Private Const Port As Integer = 7474


    Private Sub TcpServer_OnReceive(Client As ConnectedSocket, obj As Object, BytesReceived As Integer) Handles TcpServer.OnReceive
        ' Handle  the incoming object

        ' Send The Client an Object
        TcpServer.Send(Client, MySerializableClass)

        ' Send All Clients an Object
        TcpServer.Broadcast(MySerializableClass)
    End Sub

    Private Sub TcpClient_OnConnected(Client As ConnectedSocket) Handles TcpClient.OnConnected
        TcpClient.Send(New AuthorizationRequestObject)
    End Sub

   Public Sub New()
   ' Creating a server.
    TcpServer = New Server.TcpServer(Serializer, Port)
    ' "9999" being the max amount of pending connections allowed.
    TcpServer.Listen(9999)

    ' Creating a client.
    TcpClient = New Client.TcpClient(Serializer)
    TcpClient.Connect(Host, Port)
End Sub

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

MIT