Skip to content

Latest commit

 

History

History
118 lines (89 loc) · 5.05 KB

README.md

File metadata and controls

118 lines (89 loc) · 5.05 KB

x2

x2 is a set of concepts and specifications that facilitates the development of highly flexible cross-platform, cross-language distributed systems. Based on a few old simple yet powerful concepts, it encourages a unified loosely coupled event-driven approach throughout an application of any scale.

Although x2 also specifies its own wire format and most ports come with their default protocol code generators, x2 is differentiated from dedicated protocol code generators (such as Google ProtoBuf or Apache Thrift) in that it provides a macroscopic model to flexibly organize your event-based distributed systems.

In a nutshell, x2 is all about how you organize your distributed application.

Ports

Since x2 itself is not a concrete framework or library, we need its specific implementation in order to make use of it. A port is an actual implementation of x2, targeting a specific platform or language. A port is usually named in the form of x2[target], where target signifies its platform or language. Especially when a port is targeting a specific programming language, it would be normally named as x2[source file extension].

Follows the currently available ports of x2.

  • x2net (reference port) : Universal .NET port of x2, written in C#

Under-developed early-stage ports:

  • x2boost : C++ port of x2, based on C++98 and Boost libraries
  • x2java : Java 5 port of x2
  • x2py : Python port of x2

Concepts

The conceptual constructs of x2 are defined in concepts.md.

Most of the concepts of x2 came from quite old tradition: flows are similar to actors and events are exactly messages. There is nothing breaking new, but all the concepts are tweaked to form a flexibly distributable architecture.

Fingerprint is just a trivial trick but it plays an important role in precise event dispatching (with event equivalence) and efficient wire formatting.

Specifications

The following documents provides the specifications that x2 ports should confirm:

x2 binary format is focused to reduce the payload size. It supports backwards-compatibility if adding or removing properties happens only at the end of cells/events preserving the order of the rest.

How Distribution Works

        +---------+           +---------+            +---------+
    +--------+    |       +--------+    |            |    +--------+
    | Flow A |    |       | Flow A |    |            |    | Flow B |
    +--------+    |       +--------+    |            |    +--------+
        |   Hub   |  <=>      |   Hub   |            |   Hub   |
    +--------+    |           |    +--------+    +--------+    |
    | Flow B |    |           |    | Link 1 |----| Likn 2 |    |
    +--------+    |           |    +--------+    +--------+    |
        +---------+           +---------+            +---------+

Assume that two flows(cases) run independent logic, communicate only through events, and have no other coupling. Then you can either run them in a single process or split them into two separate processes distributed across a network. In any case, your application logic remains unchanged, while links handle the proper event transmission over the network.

Thought Behind

x2 is not the most efficient way to go in terms of runtime performance. It is built on top of the modern belief that human efficiency should gain more and more emphasis over machine efficiency.

The core virtue of x2 is that it forces nothing upon developers but an event-based architectural outline. That is why x2 is just a set of concepts and specifications, instead of being a single complete product. You can use freely any programming technique you want within your cases/flows. And you can even write your own links to integrate legacy services.

Why x2

Productivity

Set up a loosely-coupled event-driven architecture as your distributed application backbone. In addition to generating protocol code that emits efficient payload, it supports enhanced features such as cell/event inheritance hierarchy and precise event dispatching, which enables programming-by-difference and multi-property pattern matching respectively.

Flexibility and Reusability

Once you carefully organized events and partitioned your application logic, you can easily change the deployment of your application in either inter-process (distribution over network) or intra-process (threading model) scope.

Testability

If your cases/flows stick to the rule that exchanging events are the only way they communicate, then you can simply isolate a single case/flow for functional test with a test case feeding the required events and investigating posted ones.