Middleware/mq-starter
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(mq-starter): 多模块脚手架 + core 信封/SPI/注解

Browse Source 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
hongawen
2026-06-26 04:41:54 +08:00
parent 69db3fdd01
commit 491b83de94
12 changed files with 172 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
mq-spring-boot-starter/pom.xml Normal file
View File

@@ -0,0 +1,6 @@
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent><groupId>com.njcn</groupId><artifactId>mq-starter</artifactId><version>1.0.0-SNAPSHOT</version></parent>
<artifactId>mq-spring-boot-starter</artifactId>
</project>

18
mq-starter-core/pom.xml Normal file
View File

@@ -0,0 +1,18 @@
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent><groupId>com.njcn</groupId><artifactId>mq-starter</artifactId><version>1.0.0-SNAPSHOT</version></parent>
<artifactId>mq-starter-core</artifactId>
<dependencies>
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-autoconfigure</artifactId><version>${autoconfigure.version}</version></dependency>
<dependency><groupId>com.alibaba</groupId><artifactId>fastjson</artifactId><version>${fastjson.version}</version></dependency>
<dependency><groupId>cn.hutool</groupId><artifactId>hutool-all</artifactId><version>${hutool.version}</version></dependency>
<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>${lombok.version}</version><optional>true</optional></dependency>
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-configuration-processor</artifactId><version>${springboot.version}</version><optional>true</optional></dependency>
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><version>${springboot.version}</version><scope>test</scope></dependency>
</dependencies>
<build><plugins>
<plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId></plugin>
<plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-surefire-plugin</artifactId></plugin>
</plugins></build>
</project>

16
mq-starter-core/src/main/java/com/njcn/mq/annotation/MqListener.java Normal file
View File

@@ -0,0 +1,16 @@
package com.njcn.mq.annotation;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MqListener {
String topic();
String group();
int concurrency() default 1;
int batchSize() default 1;
int maxRetry() default 3;
String tag() default "*";
}

13
mq-starter-core/src/main/java/com/njcn/mq/core/MqContext.java Normal file
View File

@@ -0,0 +1,13 @@
package com.njcn.mq.core;
import java.util.Map;
/** @MqListener 方法可选第二参，只读暴露信封元数据。 */
public class MqContext {
private final MqMessage message;
public MqContext(MqMessage message) { this.message = message; }
public String getKey() { return message.getKey(); }
public String getTag() { return message.getTag(); }
public String getSource() { return message.getSource(); }
public long getTimestamp() { return message.getTimestamp(); }
public Map<String, String> getHeaders() { return message.getHeaders(); }
}

23
mq-starter-core/src/main/java/com/njcn/mq/core/MqMessage.java Normal file
View File

@@ -0,0 +1,23 @@
package com.njcn.mq.core;
import lombok.Builder;
import lombok.Data;
import java.util.HashMap;
import java.util.Map;
@Data
@Builder
public class MqMessage {
private String key;
private String tag;
private String source;
private long timestamp;
private Map<String, String> headers;
private Object payload;
public static MqMessage of(String key, String tag, Object payload) {
return MqMessage.builder()
.key(key).tag(tag == null ? "" : tag).source("")
.timestamp(System.currentTimeMillis())
.headers(new HashMap<>(4)).payload(payload).build();
}
}

8
mq-starter-core/src/main/java/com/njcn/mq/spi/MqDriver.java Normal file
View File

@@ -0,0 +1,8 @@
package com.njcn.mq.spi;
import com.njcn.mq.core.MqMessage;
public interface MqDriver {
void send(String topic, MqMessage message);
void subscribe(MqSubscription subscription);
void stop();
}

6
mq-starter-core/src/main/java/com/njcn/mq/spi/MqMessageListener.java Normal file
View File

@@ -0,0 +1,6 @@
package com.njcn.mq.spi;
import com.njcn.mq.core.MqMessage;
public interface MqMessageListener {
void onMessage(MqMessage message) throws Exception;
}

16
mq-starter-core/src/main/java/com/njcn/mq/spi/MqSubscription.java Normal file
View File

@@ -0,0 +1,16 @@
package com.njcn.mq.spi;
import lombok.Builder;
import lombok.Data;
@Data
@Builder
public class MqSubscription {
private String topic;
private String group;
private String tag;
private Class<?> payloadType;
private int concurrency;
private int batchSize;
private int maxRetry;
private MqMessageListener listener;
}

16
mq-starter-core/src/test/java/com/njcn/mq/core/MqMessageTest.java Normal file
View File

@@ -0,0 +1,16 @@
package com.njcn.mq.core;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
class MqMessageTest {
@Test
void of_setsKeyTagPayload_andContextReflectsThem() {
MqMessage m = MqMessage.of("k1", "nodeA", "hello");
assertEquals("k1", m.getKey());
assertEquals("nodeA", m.getTag());
assertEquals("hello", m.getPayload());
MqContext ctx = new MqContext(m);
assertEquals("k1", ctx.getKey());
assertEquals("nodeA", ctx.getTag());
}
}

6
mq-starter-redis-stream/pom.xml Normal file
View File

@@ -0,0 +1,6 @@
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent><groupId>com.njcn</groupId><artifactId>mq-starter</artifactId><version>1.0.0-SNAPSHOT</version></parent>
<artifactId>mq-starter-redis-stream</artifactId>
</project>

6
mq-starter-rocketmq/pom.xml Normal file
View File

@@ -0,0 +1,6 @@
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent><groupId>com.njcn</groupId><artifactId>mq-starter</artifactId><version>1.0.0-SNAPSHOT</version></parent>
<artifactId>mq-starter-rocketmq</artifactId>
</project>

38
pom.xml Normal file
View File

@@ -0,0 +1,38 @@
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.njcn</groupId>
<artifactId>mq-starter</artifactId>
<version>1.0.0-SNAPSHOT</version>
<packaging>pom</packaging>
<name>mq-starter 统一 MQ 抽象层</name>
<modules>
<module>mq-starter-core</module>
<module>mq-starter-rocketmq</module>
<module>mq-starter-redis-stream</module>
<module>mq-spring-boot-starter</module>
</modules>
<distributionManagement>
<repository><id>nexus-releases</id><url>http://192.168.1.22:8001/nexus/content/repositories/releases/</url></repository>
<snapshotRepository><id>nexus-snapshots</id><url>http://192.168.1.22:8001/nexus/content/repositories/snapshots/</url></snapshotRepository>
</distributionManagement>
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<springboot.version>2.3.12.RELEASE</springboot.version>
<autoconfigure.version>2.3.12.RELEASE</autoconfigure.version>
<fastjson.version>1.2.83</fastjson.version>
<hutool.version>5.7.9</hutool.version>
<lombok.version>1.18.18</lombok.version>
</properties>
<build>
<pluginManagement>
<plugins>
<plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.8.1</version>
<configuration><source>1.8</source><target>1.8</target><encoding>UTF-8</encoding></configuration></plugin>
<plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-surefire-plugin</artifactId><version>2.22.2</version></plugin>
</plugins>
</pluginManagement>
</build>
</project>