The Spring Server Sent Events client is a java client that allows to receive events when :
Please refer to the documentation of the Master SSE endpoints for further details.
Add this dependency to your project’s POM:
<dependency>
<groupId>com.decisionbrain</groupId>
<artifactId>optimserver-client-sse-spring</artifactId>
<version>PROJECT_VERSION</version>
<scope>compile</scope>
</dependency>
Add this dependency to your project’s build file:
compile "com.decisionbrain:optimserver-client-sse-spring:PROJECT_VERSION"
A SseListener implementation is defined in the Spring context and allows you to register and unregister a listener to a job events.
You will need to define a optim-server.sse.client.master.url
property in your spring context that allows the client
to connect to the Master API .
You will also need to define a @Bean of type AuthenticationService to be able to authenticate upon the Master API
The following code is a spring boot example of the application :
import com.decisionbrain.optimserver.client.sse.AuthenticationService;
import com.decisionbrain.optimserver.client.sse.JobEventListener;
import com.decisionbrain.optimserver.client.sse.SseListener;
import com.decisionbrain.optimserver.client.sse.config.KeycloakClientConfig;
import com.decisionbrain.optimserver.client.sse.impl.KeycloakAuthenticationServiceImpl;
import com.decisionbrain.optimserver.master.model.JobSolution;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.WebApplicationType;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.dao.PersistenceExceptionTranslationAutoConfiguration;
import org.springframework.boot.autoconfigure.web.reactive.ReactiveWebServerFactoryAutoConfiguration;
import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.util.function.Consumer;
@SpringBootApplication(exclude = {PersistenceExceptionTranslationAutoConfiguration.class, ReactiveWebServerFactoryAutoConfiguration.class})
@Configuration
public class OptimserverSseClientApplication implements CommandLineRunner {
@Autowired
private SseListener sseListener;
@Autowired
private JobEventListener jobEventListener;
public static void main(String[] args) {
// This is the main Spring boot application, without web profile
new SpringApplicationBuilder(OptimserverSseClientApplication.class)
.web(WebApplicationType.NONE)
.run(args);
}
// This bean is the keycloak authentication Service. You could also use the BasicAuthenticationServiceImpl
@Bean
public AuthenticationService authenticationService(KeycloakClientConfig keycloakClientConfig) {
return new KeycloakAuthenticationServiceImpl(keycloakClientConfig);
}
// This bean is the keycloak config : you can get the values from the application.yml file
@Bean
public KeycloakClientConfig keycloakClientConfig(
@Value("${keycloak.url}") String url,
@Value("${keycloak.realm}") String realm,
@Value("${keycloak.client}") String client,
@Value("${keycloak.user}") String user,
@Value("${keycloak.password}") String password
) {
return KeycloakClientConfig.builder()
.url(url)
.realm(realm)
.client(client)
.user(user)
.password(password)
.build();
}
// This bean is your main listener
@Bean
public JobEventListener jobEventListener(){
return new JobEventListener() {
@Override
public Consumer<JobSolution> onSolution() {
return (jobSolution) -> System.out.println("Do whatever you want with the jobSolution : " + jobSolution);
}
@Override
public Consumer<com.decisionbrain.optimserver.master.model.JobStatusEvent> onJobStatusEvent() {
return (jobStatusEvent) -> System.out.println("Do whatever you want with the jobStatusEvent : " + jobStatusEvent);
}
@Override
public Consumer<Throwable> onSolutionError() {
return (exception) -> System.out.println("Do whatever you want with the Exception : " + exception);
}
@Override
public Consumer<Throwable> onJobStatusEventError() {
return (exception) -> System.out.println("Do whatever you want with the Exception : " + exception);
}
};
}
@Override
public void run(String... args) throws Exception {
sseListener.register(args[0], jobEventListener);
Thread.currentThread().join();
}
}
optim-server:
sse:
client:
master:
url: http://localhost:8080
keycloak:
url: http://KEYCLOAK_HOST/auth
realm: decisionbrain
client: optimserver
user: optimserver
password: optimserver
You can then launch your application with a simple java -jar or inside your IDE.
The client Javadoc is available in this page.