Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/amoAHCP/spring-vertx-ext
A spring vertx mod which creates spring aware verticles
https://github.com/amoAHCP/spring-vertx-ext
Last synced: 2 months ago
JSON representation
A spring vertx mod which creates spring aware verticles
- Host: GitHub
- URL: https://github.com/amoAHCP/spring-vertx-ext
- Owner: amoAHCP
- License: apache-2.0
- Created: 2014-03-05T21:39:56.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2019-04-03T17:04:46.000Z (almost 6 years ago)
- Last Synced: 2024-11-17T11:55:27.113Z (2 months ago)
- Language: Java
- Size: 17.6 MB
- Stars: 50
- Watchers: 9
- Forks: 16
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- vertx-awesome - Spring Vert.x Extension - Vert.x verticle factory for Spring DI injection. (Dependency Injection)
README
spring-vertx-ext
================
## changes in 2.4
- update spring to 5.1.6.RELEASE
- update aspectj to 1.9.2
- update Vert.x to 3.7.0
regular dependency is for Java >=9 (``` vertx-spring-ext ```) and a new artifact for Java8 was published with 2.4 (``` vertx-spring-ext-8 ```)
## changes in 2.3
- migrated to Java 9, spring-vertx-ext will be available as Java 9 module in maven central as Java 9 only (java 8 Version will follow, you can still compile it with Java 8)
- the module name is **jacpfx.vertx.spring** (be aware to include spring dependencies, like "requires spring.context;" )
- Update Vert.x to version 3.5.1
- Update Spring to version 5.0.5.RELEASE
### Usage
Add the spring-vertx-ext dependency to your project, in case of maven like this:
```xml
org.jacpfx.vertx.spring
vertx-spring-ext
2.3
```
```java
module vxms.spring.demo {
requires vxms.core;
requires spring.context;
requires jacpfx.vertx.spring;
requires java.logging;
requires java.management;
requires java.ws.rs;
requires javax.inject;
requires io.netty.codec.http;
}
```
## changes in 2.2
- Update Vert.x to version 3.5.0
- Update Spring to version 5.0.0.RELEASE
- Update AspectJ to version 1.8.10
- New: Static initializer to create a Spring-aware Verticle without using the Vert.x Factory mechanism. This means you can skip the maven-shade configuration or adding the "java-spring" prefix while deploying a verticle. This change will not affect the existing mechanism.
- Usage:
```java
@Component
@SpringVerticle(springConfig = TestConfiguration.class)
public class SpringInjectionComponentScanTestVerticle extends AbstractVerticle {
@Autowired
private SayHelloBean bean;
@Override
public void start() {
SpringVerticleFactory.initSpring(this);
assertNotNull(bean);
}
}
```
## changes in 2.1
You can now inject the Vertx instance to your beans
## What it is
A spring-vertx extension which creates spring aware verticles. This extension creates for each spring aware Verticle an own spring context.
Spring Verticles can deploy "normal" Verticles and vice versa.
> You should use Spring-Verticles in „worker mode“ or use vertx.executeBlocking when calling blocking methods. Avoid blocking the event loop!
## Usage
Add the spring-vertx-ext dependency to your project, in case of maven like this:
```xml
org.jacpfx.vertx.spring
vertx-spring-ext
2.2
```
Version 2.1 uses Vert.X 3.3.3 and Spring 4.3.5.RELEASE
To make a Verticle spring aware you first need a (Java) Spring configuration class like this:
```java
@Configuration
@ComponentScan
public class TestConfiguration {
…
}
```
> xml configuration is not supported! (you can import your xml in your java configuration)
Next you create a verticle class and annotate it with @SpringVerticle.
```java
@Component
@SpringVerticle(springConfig=TestConfiguration.class)
public class SpringVerticle extends AbstractVerticle {
@Inject
private SayHelloBean bean;
@Override
public void start() {
...
}
@Override
public void stop() {
...
}
}
```
To access the Vertx instance in your spring beans, you can inject it by using autowiring :
```java
@Component
public class MyService {
@Autowired
private Vertx vertx;
...
}
```
## deployment ##
In case of using a spring-verticle as the initial verticle of your project, add the prefix "java-spring" to your vertex class.
```xml
org.apache.maven.plugins
maven-shade-plugin
2.3
package
shade
io.vertx.core.Starter
java-spring:org.jacpfx.service.SpringVerticle
META-INF/services/io.vertx.core.spi.VerticleFactory
${project.build.directory}/${artifactId}-${version}-fat.jar
```
For embedded deployment use:
```java
vertx.deployVerticle("java-spring:org.jacpfx.service.SpringVerticle");
```