Like the project?

🛠️ Get Deezpatch

Gradle

implementation"io.github.joel-jeremy.deezpatch:deezpatch-core:${version}"

Maven

<dependency>    <groupId>io.github.joel-jeremy.deezpatch</groupId>    <artifactId>deezpatch-core</artifactId>    <version>${version}</version></dependency>

🧩 Java 9 Module Names

modulefoo.bar {requiresio.github.joeljeremy.deezpatch.core;}

🚀 Performance

~ 1000% more throughput compared to other similar libraries (Spring Events, Pipelinr, etc)

~ 90% less time compared to other similar libraries (Spring Events, Pipelinr, etc)

Java 11 Benchmarks

Java 17 Benchmarks

✉️ Requests

publicclassGreetCommandimplementsRequest<Void> {privatefinalStringname;publicGreetRequest(Stringname) {this.name =name;    }publicStringname() {returnname;    }}publicclassPingQueryimplementsRequest<Pong> {}

📨 Request Handlers

publicclassGreetCommandHandler {@RequestHandlerpublicvoidhandle(GreetCommandcommand) {sayHi(command.name());    }}publicclassPingQueryHandler {@RequestHandlerpublicPonghandle(PingQueryquery) {returnnewPong("Here's your pong!");    }}

🏤 Request Dispatcher

publicstaticvoidmain(String[]args) {// Use Spring's application context as InstanceProvider in this example// but any other DI framework can be used e.g. Guice, Dagger, etc.ApplicationContextapplicationContext =springApplicationContext();// Deezpatch implements the Dispatcher interface.Dispatcherdispatcher =Deezpatch.builder()        .instanceProvider(applicationContext::getBean)        .requests(config ->config.handlers(GreetCommandHandler.java,PingQueryHandler.java        ))        .build();// Send command!dispatcher.send(newGreetCommand("Deez"));// Send query!Optional<Pong>pong =dispatcher.send(newPingQuery());}

✉️ Events

publicclassGreetedEventimplementsEvent {privatefinalStringgreeting;publicGreetedEvent(Stringgreeting) {this.greeting =greeting;    }publicStringgreeting() {returngreeting;    }}

📨 Event Handlers

publicclassGreetedEventHandler {@EventHandlerpublicvoidsayHello(GreetedEventevent) {// Well, hello!    }@EventHandlerpublicvoidsayKumusta(GreetedEventevent) {// Well, kumusta?    }@EventHandlerpublicvoidsayGotEm(GreetedEventevent) {// Got 'em!    }}

📣 Event Publisher

publicstaticvoidmain(String[]args) {// Use Spring's application context as InstanceProvider in this example// but any other DI framework can be used e.g. Guice, Dagger, etc.ApplicationContextapplicationContext =springApplicationContext();// Deezpatch implements the Publisher interface.Publisherpublisher =Deezpatch.builder()        .instanceProvider(applicationContext::getBean)        .events(config ->config.handlers(GreetedEventHandler.java        ))        .build();// Publish event!publisher.publish(newGreetedEvent("Hi from Deez!"));}

🔩 Easy Integration with Dependency Injection (DI) Frameworks

Example with No DI framework

// Application.javapublicstaticvoidmain(String[]args) {Deezpatchdeezpatch =Deezpatch.builder()      .instanceProvider(Application::getInstance)      .requests(...)      .events(...)      .build();}privatestaticObjectgetInstance(Class<?>handlerType) {if (MyRequestHandler.class.equals(handlerType)) {returnnewMyRequestHandler();  }elseif (MyEventHandler.class.equals(handlerType)) {returnnewMyEventHandler();  }thrownewIllegalStateException("Failed to get instance for " +handlerType.getName() +".");}

Example with Spring's ApplicationContext

publicstaticvoidmain(String[]args) {ApplicationContextapplicationContext =springApplicationContext();Deezpatchdeezpatch =Deezpatch.builder()      .instanceProvider(applicationContext::getBean)      .requests(...)      .events(...)      .build();}

Example with Guice's Injector

publicstaticvoidmain(String[]args) {Injectorinjector =guiceInjector();Deezpatchdeezpatch =Deezpatch.builder()      .instanceProvider(injector::getInstance)      .requests(...)      .events(...)      .build();}

🎛️ Custom Request/Event Handler Annotations

// Let's say below classes are declared in a project's core/domain package:@Retention(RetentionPolicy.RUNTIME)@Target(ElementType.METHOD)public @interfaceAwesomeRequestHandler {}@Retention(RetentionPolicy.RUNTIME)@Target(ElementType.METHOD)public @interfaceAwesomeEventHandler {}publicclassMyRequestHandler {@AwesomeRequestHandlerpublicvoidhandle(TestRequestrequest) {// Handle.  }}publicclassMyEventHandler {@AwesomeEventHandlerpublicvoidhandle(TestEventevent) {// Handle.  }}// To wire things up:publicstaticvoidmain(String[]args) {// Use Spring's application context as InstanceProvider in this example// but any other DI framework can be used e.g. Guice, Dagger, etc.ApplicationContextapplicationContext =springApplicationContext();// Register handlers and custom annotations.Deezpatchdeezpatch =Deezpatch.builder()      .instanceProvider(applicationContext::getBean)      .requests(config ->config.handlerAnnotations(AwesomeRequestHandler.class)              .handlers(MyRequestHandler.class))      .events(config ->config.handlerAnnotations(AwesomeEventHandler.java)              .handlers(MyEventHandler.class))      .build();}

🎛️ Custom Invocation Strategies

// Register custom invocation strategy.Deezpatchdeezpatch =Deezpatch.builder()    .requests(config ->config.invocationStrategy(newLoggingInvocationStrategy(newRetryOnErrorInvocationStrategy())))    .events(config ->config.invocationStrategy(newLoggingInvocationStrategy(newOrderGuaranteedInvocationStrategy())))      .build();