https://github.com/joezeo/reactive-server
Reactive web server template, using Webflux + Reactive-Mongodb as basic framework, a template for efficiently dealing with highly concurrent requests.
https://github.com/joezeo/reactive-server
akka async-events reactive reactive-mongo template-project template-server web-server webflux
Last synced: about 1 year ago
JSON representation
Reactive web server template, using Webflux + Reactive-Mongodb as basic framework, a template for efficiently dealing with highly concurrent requests.
- Host: GitHub
- URL: https://github.com/joezeo/reactive-server
- Owner: Joezeo
- Created: 2021-02-19T03:06:28.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-07-22T18:30:14.000Z (almost 4 years ago)
- Last Synced: 2025-04-13T12:57:47.655Z (about 1 year ago)
- Topics: akka, async-events, reactive, reactive-mongo, template-project, template-server, web-server, webflux
- Language: Java
- Homepage:
- Size: 116 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# reactive_server
This project is a reactive web server template, using webflux + reactive-mongodb as basic framework, a template for efficiently dealing with highly concurrent requests.
A simple test server bases on this template from my own have `4000+` throughput per second(TPS) under `10000+` concurrency with `1s` response time in average via pressure test by Jmeter.
### Usage
**1. Reactive Http action**
The most important class was `com.toocol.common.web.AbstractHttpAction`, one HttpAction represent one http request handler, and add annotation `com.toocol.common.web.ActionMapping` to register http uri mapping. By default, the required HTTP request method is `post`, and the `content-type` is `application/json`.This is an example:
```java
@Slf4j
// uri is represent to "/article/add_article"
@ActionMapping(module = "article", action = "add_article")
public class AddArticleAction extends AbstractHttpAction implements IVessel {
@Override
public Mono action(JSONObject param) throws Exception {
ArticleAddress articleAddress = ArticleAddress.builder()
.digest(UUID.randomUUID().toString())
.url("https://www.toocol.article/1001")
.build();
return vessel().articleAddressRepo.insert(articleAddress)
.thenReturn("Success");
}
}
```
**2. Reactive mongodb repository**
Just create a document class implement `com.toocol.common.database.IDocument` and add annotation `org.springframework.data.mongodb.core.mapping.Document`, then create a interface extends `com.toocol.common.database.mongo.AsyncMongoRepo`:
```yml
spring:
data:
mongodb:
host: localhost
port: 27017
database: your-database
```
```java
public interface ArticleAddressRepo extends AsyncMongoRepo {
}
```
```java
@NoArgsConstructor
@AllArgsConstructor
@Getter
@Setter
@Builder
@Document(collection = "article_address")
public class ArticleAddress implements IDocument {
private static final long serialVersionUID = -4092392708753755910L;
@Id
private ObjectId id;
/**
* the digest of article, use md5 algorithm.
*/
private String digest;
/**
* the url of article's HTML file.
*/
private String url;
public String getId() {
return id.toHexString();
}
public void setId(String id) {
this.id = new ObjectId(id);
}
}
```
**3. Vessel**
This template using extra Vessel to avoid the problem of circular dependency, you need add two class like this in your own project(or you can just ignore it with your own way):
```java
@Primary
@Component
public class Vessel extends DefaultVessel {
/**
* every bean in spring should add to there.
*/
public ArticleAddressRepo articleAddressRepo;
}
```
```java
/**
* This interface was created to acquire Vessel instance
*/
public interface IVessel extends IBasisVessel {
/**
* @return vessel instance
*/
@Override
default Vessel vessel() {
return AbstractVessel.get().as();
}
}
```