Skip to content

Latest commit

 

History

History

order-processor

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
src
src
 
 
README.adoc
README.adoc
 
 
pom.xml
pom.xml
 
 

README.adoc

Order Processor Demo

The Order Processor Demo showcases the implementation of services using messages based on the Financial Information Exchange (FIX) protocol. This project simulates an order processing system, including features such as creating new orders, cancelling specific orders, and cancelling all orders. The project is designed to mimic real-world financial trading systems, demonstrating how such a system can be built using Java.

Getting Started

To get started with the Order Processor Demo, you need to clone the repository to your local machine. Once you have cloned the repository, you can open it in your IDE of choice (we recommend IntelliJ CE for this project).

Prerequisites

Before you begin, ensure you have the following installed:

  • Java Development Kit (JDK): Java 8 Update 202+, Java 11, Java 17, or Java 21

  • Apache Maven: Version 3.6.5 or higher

  • Integrated Development Environment (IDE): IntelliJ IDEA Community Edition (recommended) or any other IDE

  • Internet Access: Required for Maven to download necessary dependencies

Installation

Here are the steps to clone the repository and open it in IntelliJ:

  1. Clone the repository with git clone <repository_url>

  2. Open IntelliJ IDE and select 'Open'

  3. Navigate to the cloned repository and click 'Open'

  4. Wait for the IDE to import the project and download the necessary dependencies

Running the Project

sequenceDiagram
autonumber
Client->>+OMS: NewOrderSingle
Note right of Client: via Chronicle Queue, persisted
Note right of OMS: processes event
OMS->>-Client: ExecutionReport
Note right of Client: via Chronicle Queue, persisted
Loading

To run the project, you need to compile the project and run the main classes for different features:

  • OrderAdderMain: This class simulates the creation of new orders.

  • OrderViewerMain: This class simulates the viewing of created orders.

  • OrderBenchmarkMain: This class benchmarks round trip time of writing a NewOrderSingle a queue, have the OMSImpl produce an ExecutionReport and read that report.

  • OMSImpl: This class handles the processing of the orders, including cancelling orders.

You can run these classes directly from your IDE, or you can use mvn compile exec:exec@id on the command line to run the compiled classes.

Contributing

We appreciate any contributions to the Order Processor Demo. If you find any bugs or issues, please open an issue in the repository. If you want to contribute to the code, please fork the repository, make your changes, and open a pull request.

Acknowledgments

  • Inspired by real-world financial trading systems.

  • Uses the FIX protocol for message exchange.