https://github.com/manoelcampos/java-gossip-simulator

An experimental Java 17 API to enable simulating the dissemination of data across nodes in a network using the Gossip Epidemic Protocol ☕️🗣🐞
https://github.com/manoelcampos/java-gossip-simulator

api experimental gossip-protocol java simulation simulator

Last synced: 6 days ago
JSON representation

An experimental Java 17 API to enable simulating the dissemination of data across nodes in a network using the Gossip Epidemic Protocol ☕️🗣🐞

• Host: GitHub
• URL: https://github.com/manoelcampos/java-gossip-simulator
• Owner: manoelcampos
• License: gpl-3.0
• Created: 2020-09-03T19:07:12.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-11-29T22:44:12.000Z (about 1 year ago)
• Last Synced: 2024-11-05T10:47:12.147Z (about 2 months ago)
• Topics: api, experimental, gossip-protocol, java, simulation, simulator
• Language: Java
• Homepage: https://manoelcampos.com/java-gossip-simulator/
• Size: 238 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Java Gossip Protocol Simulator API [![Build Status](https://github.com/manoelcampos/java-gossip-simulator/actions/workflows/maven.yml/badge.svg)](https://github.com/manoelcampos/java-gossip-simulator/actions/workflows/maven.yml) [![Maven Central](https://img.shields.io/maven-central/v/com.manoelcampos/gossip-simulator.svg?label=Maven%20Central)](https://search.maven.org/search?q=g:%22com.manoelcampos%22%20AND%20a:%22gossip-simulator%22) [![javadoc](https://javadoc.io/badge2/com.manoelcampos/gossip-simulator/javadoc.svg)](https://javadoc.io/doc/com.manoelcampos/gossip-simulator)

An experimental Java 17 API to enable simulating the dissemination of data

across nodes (Hosts) in a network using the [Gossip epidemic protocol](https://en.wikipedia.org/wiki/Gossip_protocol).

The API enables running the simulation using a single computer.

Every node is represented by a [Plain Old Java Object](https://en.wikipedia.org/wiki/Plain_old_Java_object) `GossipNode`.

Therefore, since this is a simulation API, there is no actual

network communication, not even in localhost.

## 1. Examples

The figure below shows an example of the output for a simulation cycle,

where nodes send a message to their neighbors.

An infected node 🐞 is that one which has already received a message,

otherwise it's a non-infected node 💚.

![Simulation Results](results.png)

A complete [example is available here](src/main/java/com/manoelcampos/gossipsimulator/examples/GossipSimulatorExample1.java).

## 2. Links

If you want to understand how the Gossip Protocol works, check this

nice [online graphical simulator](https://flopezluis.github.io/gossip-simulator/).