Testat - Verteilte Systeme - Gruppe 7

Christoph Koßlowski, Lukas Adrion, Thibault Rey, Ralf Ehli, Philipp Thümler

📮 Publisher-Subscriber-System

The publisher-subscriber pattern in distributed systems is a messaging pattern that facilitates asynchronous communication between components. Publishers produce messages and send them to a central broker, while subscribers express their interest by subscribing to specific message types. The broker then delivers relevant messages to the interested subscribers, enabling loose coupling and scalability in distributed architectures. This pattern is commonly used for event-driven architectures, real-time data streaming, and building resilient and decoupled systems.

ℹ️ The system can be used independently of the console implementation. The use of the console merely demonstrates an example implementation to showcase the capabilities of the model.

📝 Documentation

Learn more about the concepts behind the implementation.

• German: DE.md
• English: EN.md

🏃 Get up and running

Switch to the build directory (you may need to compile the application first):

cd build/

Start the broker using:

./broker_main_exe --server-address insert_address --server-port insert_port

Start a client using:

./client_main_exe --server-address insert_broker_address --server-port insert_broker_port --action insert_action

For --action there are the following options:

SUBSCRIBE_TOPIC --topic-name insert_topic_name
PUBLISH_TOPIC --topic-name insert_topic_name --message "insert your message here"
LIST_TOPIC
GET_TOPIC_STATUS --topic-name insert_topic_name

The client will terminate automatically after receiving the response from the broker, except if you used SUBSCRIBE_TOPIC in which case the connection remains open to receive topics. You can use the key combination Ctrl+C to properly close the client and the broker.

💻 Contributing

⚙️ compile via script

Navigate to /scripts directory:

cd scripts/

Grant execute permission to the file:

chmod +x compile.sh

Compile all:

./compile.sh

Add parameters to compile individual files:

-b broker_main.cpp
-c client_main.cpp

🧪 unit tests

Navigate to /scripts directory:

cd scripts/

Grant execute permission to the files:

chmod +x compile_tests.sh run_tests.sh

Compile all unit tests:

./compile_tests.sh

Run all unit tests:

./run_tests.sh