EntityOrientedCommunication 1.1.2

.NET Framework 4.5
There is a newer version of this package available.
See the version list below for details.
Install-Package EntityOrientedCommunication -Version 1.1.2
dotnet add package EntityOrientedCommunication --version 1.1.2
<PackageReference Include="EntityOrientedCommunication" Version="1.1.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add EntityOrientedCommunication --version 1.1.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: EntityOrientedCommunication, 1.1.2"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install EntityOrientedCommunication as a Cake Addin
#addin nuget:?package=EntityOrientedCommunication&version=1.1.2

// Install EntityOrientedCommunication as a Cake Tool
#tool nuget:?package=EntityOrientedCommunication&version=1.1.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

EntityOrientedCommunication

A C/S framework library which allows object2object communication based on TCP/IP written in C#.

Highlights

⭐ Easy to use ⭐ Lightweight ⭐ Flexible

Table of Contents

  1. Quick Start </br> 1.1 Server Console </br> 1.2 Client Console </br> 1.3 Excution Results </br>
  2. Intoduction </br>
  3. EOC Server </br>
  4. Entity </br>
  5. Client Postoffice </br>
  6. Client Mailbox </br>

<a name="QuickStart"></a>

1.Quick Start

Assume there are 2 objects A and B on different computers, now they need to send messages to each other.

  • It is able to use the libraray without downloading source code of which. Since the compiled library was published on nuget.org, we might use EntityOrientedCommunication library by installing the nuget packge through some facilities. e.g. PackageManager, etc.
    PM> Install-Package EntityOrientedCommunication -Source nuget.org
    

<a name="section1_1"></a>

1.1 Server Console

Firstly we need to create a server console application, the code of the Mail(string[]) is shown as follwing.

using System.Threading;
using EntityOrientedCommunication;
using EntityOrientedCommunication.Server;

namespace ServerDemo
{
    class Program
    {
        public static void Main(string[] args)
        {
        	// create a server named 'EOCServerDemo' at 127.0.0.1:1350
            var server = new Server("EOCServerDemo", "127.0.0.1", 1350);

            // create 2 users without password
            server.MailCenter.Update(new User() { Name = "Mary" });
            server.MailCenter.Update(new User() { Name = "Tom" });

            // run the server
            server.Run();

            while (true) Thread.Sleep(1);
        }
    }
}

Now the code of server program is done, we will get a server execution file after the code is compiled, execute the file to run the server.


<a name="section1_2"></a>

1.2 Client Console

Similiar to section 1.1, we need to create a client console application first. Then declare a class that implements the interface named IEntity in the application. In order to make this quick start conciser, we suppose the objects A and B are of same type named SignalStation.

using EntityOrientedCommunication;
using System;


namespace ClientDemo
{
    class SignalStation : IEntity
    {
        public string EntityName { get; }

        public SignalStation(string name)
        {
            this.EntityName = name;
        }

        public LetterContent Pickup(ILetter letter)  // handle the incoming message
        {
            Console.WriteLine($"{this.EntityName} received message from {letter.Sender}: {letter.Title}, {letter.Content}");
            return null;
        }
    }
}

Hitherto we have a class named SignalStation in the client console assembly, then code the Mail(string[]) function of client program.

using EntityOrientedCommunication.Client;
using System;

namespace ClientDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            /****** A@Mary START ******/  // Code block 1
            var postoffice1 = new ClientPostOffice();
            var agent1 = postoffice1.Connect("127.0.0.1", 1350);  // create a client agent with specified server IP and port
            agent1.Login("Mary", "", 10000);  // login with account 'Mary' without password
            var objA = new SignalStation("A");  // create a 'SignalStation' instance named 'A'
            var boxA = postoffice1.Register(objA);  // register a mailbox for 'A' to grant it to communicate with other entities
            /****** A@Mary END ******/

            /****** B@Tom START ******/  // Code block 2
            var postoffice2 = new ClientPostOffice();
            var agent2 = postoffice2.Connect("127.0.0.1", 1350);
            agent2.Login("Tom", "", 10000);
            var objB = new SignalStation("B");
            var boxB = postoffice2.Register(objB);
            /****** B@Tom END ******/

            // 'B' send a message to 'A'
            boxB.Post("A@Mary", "hello A!", "put the content here.");

            Console.ReadKey();
        }
    }
}

Certainly the code block 1 and 2 could be put at two diffrenct applications, and the two applications could run on different computers. Just make the agents point to same server if you want to connect the objects.


<a name="section1_3"></a>

1.3 Execution Results

The execution result of the client console seems like following.

Client console execution result

And similiar the server console is.

Server console execution result

Product Versions
.NET Framework net45 net451 net452 net46 net461 net462 net463 net47 net471 net472 net48
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.1.5 279 5/25/2020
1.1.4 285 5/20/2020
1.1.3 255 5/16/2020
1.1.2 248 5/14/2020
1.1.1 248 5/13/2020
1.1.0 230 5/13/2020
1.0.7 245 5/12/2020
1.0.6 272 5/8/2020
1.0.5 285 5/8/2020
1.0.4 254 5/7/2020
1.0.3 245 5/7/2020
1.0.1 259 5/6/2020
1.0.0 252 5/6/2020

Fix login bug.