@rdmind/rdmind 0.1.8-alpha.9 → 0.1.9-alpha.0

package/template/sns-demo-common/src/main/java/com/xiaohongshu/sns/demo/common/utils/AssertUtils.java

@@ -0,0 +1,137 @@
+package com.xiaohongshu.sns.demo.common.utils;
+
+import com.xiaohongshu.sns.demo.common.enums.ErrorCodeEnum;
+import com.xiaohongshu.sns.demo.common.exception.AppBizException;
+import org.apache.commons.collections4.CollectionUtils;
+import org.apache.commons.collections4.MapUtils;
+import org.apache.commons.lang3.StringUtils;
+
+import java.util.Collection;
+import java.util.Map;
+import java.util.function.Supplier;
+
+
+/**
+ * @author chenhuanjie
+ */
+public final class AssertUtils {
+    private AssertUtils() {
+        // 私有构造函数，防止实例化
+    }
+
+    /**
+     * 断言为true
+     *
+     * @param condition
+     * @param code
+     * @param supplier
+     */
+    public static void isTrue(boolean condition, int code, Supplier<String> supplier) {
+        if (!condition) {
+            throw new AppBizException(code, supplier.get());
+        }
+    }
+
+    public static void isTrue(boolean condition, ErrorCodeEnum error) {
+        if (!condition) {
+            throw new AppBizException(error.getCode(), error.getMsg());
+        }
+    }
+
+    /**
+     * 断言为false
+     *
+     * @param condition
+     * @param code
+     * @param supplier
+     */
+    public static void isFalse(boolean condition, int code, Supplier<String> supplier) {
+        if (condition) {
+            throw new AppBizException(code, supplier.get());
+        }
+    }
+
+    public static void isFalse(boolean condition, ErrorCodeEnum error) {
+        if (condition) {
+            throw new AppBizException(error.getCode(), error.getMsg());
+        }
+    }
+
+    /**
+     * 断言为字符串非空
+     *
+     * @param s
+     * @param code
+     * @param supplier
+     */
+    public static void notBlank(String s, int code, Supplier<String> supplier) {
+        if (StringUtils.isBlank(s)) {
+            throw new AppBizException(code, supplier.get());
+        }
+    }
+
+    public static void notBlank(String s, ErrorCodeEnum error) {
+        if (StringUtils.isBlank(s)) {
+            throw new AppBizException(error.getCode(), error.getMsg());
+        }
+    }
+
+
+    /**
+     * 断言为集合非空
+     *
+     * @param c
+     * @param code
+     * @param supplier
+     */
+    public static void notEmpty(Collection c, int code, Supplier<String> supplier) {
+        if (CollectionUtils.isEmpty(c)) {
+            throw new AppBizException(code, supplier.get());
+        }
+    }
+
+    public static void notEmpty(Collection m, ErrorCodeEnum error) {
+        if (CollectionUtils.isEmpty(m)) {
+            throw new AppBizException(error.getCode(), error.getMsg());
+        }
+    }
+
+    /**
+     * 断言map非空
+     *
+     * @param m
+     * @param code
+     * @param supplier
+     */
+    public static void notEmpty(Map m, int code, Supplier<String> supplier) {
+        if (MapUtils.isEmpty(m)) {
+            throw new AppBizException(code, supplier.get());
+        }
+    }
+
+    public static void notEmpty(Map m, ErrorCodeEnum error) {
+        if (MapUtils.isEmpty(m)) {
+            throw new AppBizException(error.getCode(), error.getMsg());
+        }
+    }
+
+
+    /**
+     * 断言为对象非空
+     *
+     * @param o
+     * @param code
+     * @param supplier
+     */
+    public static void notNull(Object o, int code, Supplier<String> supplier) {
+        if (o == null) {
+            throw new AppBizException(code, supplier.get());
+        }
+    }
+
+    public static void notNull(Object o, ErrorCodeEnum error) {
+        if (o == null) {
+            throw new AppBizException(error.getCode(), error.getMsg());
+        }
+    }
+}

package/template/sns-demo-common/src/main/java/com/xiaohongshu/sns/demo/common/utils/JsonHelper.java

@@ -0,0 +1,129 @@
+package com.xiaohongshu.sns.demo.common.utils;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.databind.DeserializationFeature;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.PropertyNamingStrategies;
+import com.fasterxml.jackson.databind.type.CollectionType;
+import com.fasterxml.jackson.databind.type.MapType;
+import lombok.extern.slf4j.Slf4j;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+@Slf4j
+public final class JsonHelper {
+    private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper();
+    private static final ObjectMapper SNAKE_CASE_OBJECT_MAPPER = new ObjectMapper();
+
+    static {
+        OBJECT_MAPPER.setSerializationInclusion(JsonInclude.Include.NON_NULL);
+        OBJECT_MAPPER.enable(DeserializationFeature.ACCEPT_EMPTY_STRING_AS_NULL_OBJECT);
+        OBJECT_MAPPER.disable(DeserializationFeature.FAIL_ON_IGNORED_PROPERTIES);
+        OBJECT_MAPPER.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
+
+        SNAKE_CASE_OBJECT_MAPPER.setSerializationInclusion(JsonInclude.Include.NON_NULL);
+        SNAKE_CASE_OBJECT_MAPPER.setPropertyNamingStrategy(new PropertyNamingStrategies.SnakeCaseStrategy());
+        SNAKE_CASE_OBJECT_MAPPER.enable(DeserializationFeature.ACCEPT_EMPTY_STRING_AS_NULL_OBJECT);
+        SNAKE_CASE_OBJECT_MAPPER.disable(DeserializationFeature.FAIL_ON_IGNORED_PROPERTIES);
+        SNAKE_CASE_OBJECT_MAPPER.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
+    }
+
+
+    /**
+     * 将对象转换为 JSON 字符串
+     *
+     * @param object
+     * @param snakeCase
+     * @param <T>
+     * @return
+     */
+    public static <T> String toJson(T object, boolean snakeCase) {
+        try {
+            ObjectMapper mapper = snakeCase ? SNAKE_CASE_OBJECT_MAPPER : OBJECT_MAPPER;
+            return mapper.writeValueAsString(object);
+        } catch (Exception e) {
+            log.error("Error converting object to JSON: {}", e.getMessage(), e);
+            return null;
+        }
+    }
+
+    /**
+     * 将 JSON 字符串转换为对象
+     *
+     * @param json
+     * @param clazz
+     * @param snakeCase
+     * @param <T>
+     * @return
+     */
+    public static <T> T fromJson(String json, Class<T> clazz, boolean snakeCase) {
+        try {
+            ObjectMapper mapper = snakeCase ? SNAKE_CASE_OBJECT_MAPPER : OBJECT_MAPPER;
+            return mapper.readValue(json, clazz);
+        } catch (Exception e) {
+            log.error("Error converting JSON to object: {}", e.getMessage(), e);
+            return null;
+        }
+    }
+
+    /**
+     * 将 JSON 字符串转换为 List
+     *
+     * @param json
+     * @param clazz
+     * @param <T>
+     * @return
+     */
+    public static <T> List<T> fromJsonToList(String json, Class<T> clazz, boolean snakeCase) {
+        try {
+            ObjectMapper mapper = snakeCase ? SNAKE_CASE_OBJECT_MAPPER : OBJECT_MAPPER;
+            CollectionType type = mapper.getTypeFactory().constructCollectionType(List.class, clazz);
+            return mapper.readValue(json, type);
+        } catch (Exception e) {
+            log.error("Error converting JSON to List: {}", e.getMessage(), e);
+            return null;
+        }
+    }
+
+    /**
+     * 将 JSON 字符串转换为 List
+     *
+     * @param json
+     * @param clazz
+     * @param <T>
+     * @return
+     */
+    public static <T> Set<T> fromJsonToSet(String json, Class<T> clazz, boolean snakeCase) {
+        try {
+            ObjectMapper mapper = snakeCase ? SNAKE_CASE_OBJECT_MAPPER : OBJECT_MAPPER;
+            CollectionType type = mapper.getTypeFactory().constructCollectionType(Set.class, clazz);
+            return mapper.readValue(json, type);
+        } catch (Exception e) {
+            log.error("Error converting JSON to Set: {}", e.getMessage(), e);
+            return null;
+        }
+    }
+
+    /**
+     * 将 JSON 字符串转换为 Map
+     *
+     * @param json
+     * @param keyClass
+     * @param valueClass
+     * @param <K>
+     * @param <V>
+     * @return
+     */
+    public static <K, V> Map<K, V> fromJsonToMap(String json, Class<K> keyClass, Class<V> valueClass, boolean snakeCase) {
+        try {
+            ObjectMapper mapper = snakeCase ? SNAKE_CASE_OBJECT_MAPPER : OBJECT_MAPPER;
+            MapType type = mapper.getTypeFactory().constructMapType(Map.class, keyClass, valueClass);
+            return mapper.readValue(json, type);
+        } catch (Exception e) {
+            log.error("Error converting JSON to Map: {}", e.getMessage(), e);
+            return null;
+        }
+    }
+}

package/template/sns-demo-common/src/main/java/com/xiaohongshu/sns/demo/common/utils/WrappedContextHelper.java

@@ -0,0 +1,182 @@
+package com.xiaohongshu.sns.demo.common.utils;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.xiaohongshu.infra.apm.utils.ContextHelper;
+import com.xiaohongshu.infra.rpc.base.Context;
+
+import com.xiaohongshu.sns.demo.common.constants.AppPlatform;
+import lombok.Data;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.commons.lang3.ObjectUtils;
+import org.apache.commons.lang3.StringUtils;
+import org.apache.commons.lang3.math.NumberUtils;
+import org.springframework.stereotype.Component;
+import org.springframework.util.CollectionUtils;
+
+import java.net.URLDecoder;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Optional;
+
+/**
+ * 对中间件 ContextHelper 的封装，便于拿到当前的请求信息。
+ * 整合了 ContextUtils 现有功能及增强的上下文解析能力。
+ *
+ * @author RDMind
+ */
+@Component
+@Slf4j
+public class WrappedContextHelper {
+
+    public static final String APP_CONTEXT_PREFIX = "__app_context:";
+    public static final String HTTP_HEADER = "httpHeader";
+
+    /**
+     * 获取原始 Context
+     */
+    public static Context get() {
+        return ContextHelper.getContext();
+    }
+
+    /**
+     * 获取当前用户 ID
+     */
+    public static String getUserId() {
+        Context context = get();
+        if (context == null) {
+            return StringUtils.EMPTY;
+        }
+        String userId = context.getUserID();
+        if (StringUtils.isBlank(userId)) {
+            Map<String, String> baggageMap = context.getBaggage();
+            if (!CollectionUtils.isEmpty(baggageMap)) {
+                userId = baggageMap.get("viewerUserId");
+            }
+        }
+        return StringUtils.isBlank(userId) ? StringUtils.EMPTY : userId;
+    }
+
+    /**
+     * 获取当前操作者邮箱
+     */
+    public static String getUserEmail() {
+        Context context = get();
+        return context == null ? StringUtils.EMPTY : context.getBaggage().getOrDefault("__app_context:operatorEmail", StringUtils.EMPTY);
+    }
+
+    /**
+     * 获取当前操作者展示名称
+     */
+    public static String getUserDisplayName() {
+        Context context = get();
+        return context == null ? StringUtils.EMPTY : context.getBaggage().getOrDefault("__app_context:displayName", StringUtils.EMPTY);
+    }
+
+    /**
+     * 获取当前操作者真实姓名
+     */
+    public static String getUserRealName() {
+        Context context = get();
+        return context == null ? StringUtils.EMPTY : context.getBaggage().getOrDefault("__app_context:operatorName", StringUtils.EMPTY);
+    }
+
+    /**
+     * 获取当前用户IP
+     */
+    public static String getUserIp() {
+        Context context = get();
+        if (context == null) {
+            return StringUtils.EMPTY;
+        }
+        return StringUtils.isBlank(context.getUserIP()) ? StringUtils.EMPTY : context.getUserIP();
+    }
+
+    /**
+     * 获取 requestId
+     */
+    public static String getRequestId() {
+        Context context = get();
+        if (context == null || CollectionUtils.isEmpty(context.getBaggage())) {
+            return StringUtils.EMPTY;
+        }
+        return context.getBaggage().getOrDefault(APP_CONTEXT_PREFIX + "requestId", StringUtils.EMPTY);
+    }
+
+    /**
+     * 获取当前客户端平台
+     */
+    public static String getPlatform() {
+        Context context = get();
+        if (context == null) {
+            return AppPlatform.UNKNOWN.value();
+        }
+        String platform = context.getAppPlatform();
+        return StringUtils.isBlank(platform) ? AppPlatform.UNKNOWN.value() : AppPlatform.findBy(platform).value();
+    }
+
+    /**
+     * 获取 networkType
+     */
+    public static int getNetworkType() {
+        String cAppNetworkType = ContextHelper.getAppContext("c_app_network_type");
+        return NumberUtils.toInt(cAppNetworkType);
+    }
+
+    public static String getHttpHeaderStr() {
+        Context context = get();
+        if (context == null) {
+            return StringUtils.EMPTY;
+        }
+        Map<String, String> baggage = Optional.ofNullable(context.getBaggage()).orElse(Collections.emptyMap());
+        return baggage.getOrDefault(APP_CONTEXT_PREFIX + HTTP_HEADER, "");
+    }
+
+    private HttpHeader getParsedHttpHeader() {
+        Context context = get();
+        if (context != null && context.getBaggage().containsKey(APP_CONTEXT_PREFIX + HTTP_HEADER)) {
+            String headerJson = ContextHelper.getAppContext(HTTP_HEADER);
+            HttpHeader header = JsonHelper.fromJson(headerJson, HttpHeader.class, false);
+            return ObjectUtils.defaultIfNull(header, new HttpHeader());
+        }
+        return new HttpHeader();
+    }
+
+    /**
+     * 内部封装的 Http Header 对象 (使用 Jackson 注解)
+     */
+    @Data
+    static class HttpHeader {
+        @JsonProperty("User-Agent")
+        private String userAgent;
+        @JsonProperty("xy-common-params")
+        private String commonParams;
+        @JsonProperty("X-Network-Source")
+        private String xNetworkSource;
+        @JsonProperty("Xy-Platform-Info")
+        private String platformInfo;
+    }
+
+    private Map<String, String> parseCommonParams() {
+        String paramStr = this.getParsedHttpHeader().getCommonParams();
+        if (StringUtils.isEmpty(paramStr)) {
+            return Collections.emptyMap();
+        }
+        Map<String, String> params = new HashMap<>();
+        for (String kv : paramStr.split("&")) {
+            String[] arr = kv.split("=");
+            if (arr.length == 2) {
+                try {
+                    params.put(arr[0], URLDecoder.decode(arr[1], "UTF-8"));
+                } catch (Exception e) {
+                    // ignore
+                }
+            }
+        }
+        return params;
+    }
+
+    public String getDeviceId() {
+        return StringUtils.trimToEmpty(parseCommonParams().get("deviceId"));
+    }
+}

package/template/sns-demo-domain/pom.xml

@@ -26,11 +26,6 @@
             <groupId>com.xiaohongshu</groupId>
             <artifactId>infra-framework-context</artifactId>
         </dependency>
-        <dependency>
-            <groupId>org.springframework.boot</groupId>
-            <artifactId>spring-boot-starter-test</artifactId>
-            <scope>test</scope>
-        </dependency>
     </dependencies>
 
 </project>

package/template/sns-demo-infrastructure/pom.xml

@@ -47,11 +47,6 @@
             <groupId>com.xiaohongshu</groupId>
             <artifactId>infra-framework-rpc-core</artifactId>
         </dependency>
-        <dependency>
-            <groupId>org.springframework.boot</groupId>
-            <artifactId>spring-boot-starter-test</artifactId>
-            <scope>test</scope>
-        </dependency>
     </dependencies>
 
 </project>

package/template/sns-demo-start/pom.xml

@@ -24,11 +24,6 @@
             <groupId>com.xiaohongshu.xray</groupId>
             <artifactId>xray-logging</artifactId>
         </dependency>
-        <dependency>
-            <groupId>org.springframework.boot</groupId>
-            <artifactId>spring-boot-starter-test</artifactId>
-            <scope>test</scope>
-        </dependency>
     </dependencies>
 
     <build>

package/template/sns-demo-start/src/main/resources/logback-spring.xml

@@ -1,22 +1,19 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <configuration>
-    <property name="LOG_LEVEL" value="INFO"/>
-    <include resource="logback-xray-base.xml"/>
+  <property name="LOG_LEVEL" value="INFO"/>
+  <include resource="logback-xray-base.xml"/>
 
-    <root level="${LOG_LEVEL}">
-        <appender-ref ref="ASYNC-CONSOLE-APPENDER"/>
-        <!--        <appender-ref ref="Sentry"/>-->
-    </root>
-
-    <logger name="com.xiaohongshu.sns" level="debug"></logger>
-    <logger name="org.apache.ibatis" level="INFO"></logger>
-    <logger name="org.apache.catalina" level="ERROR"></logger>
-    <logger name="org.apache.zookeeper" level="INFO"></logger>
-    <logger name="org.springframework" level="INFO"></logger>
-    <logger name="com.xiaohongshu.infra" level="ERROR"></logger>
-    <logger name="com.xiaohongshu.racing" level="WARN"></logger>
-    <logger name="com.dianping.cat" level="INFO"></logger>
-    <logger name="red.midware.shaded" level="INFO"></logger>
-    <logger name="events" level="INFO"></logger>
-
-</configuration>
+  <logger name="org.apache.ibatis" level="INFO"></logger>
+  <logger name="org.apache.catalina" level="ERROR"></logger>
+  <logger name="org.apache.zookeeper" level="INFO"></logger>
+  <logger name="org.springframework" level="INFO"></logger>
+  <logger name="com.xiaohongshu.infra" level="ERROR"></logger>
+  <logger name="com.xiaohongshu.racing" level="WARN"></logger>
+  <logger name="com.dianping.cat" level="INFO"></logger>
+  <logger name="red.midware.shaded" level="INFO"></logger>
+  <logger name="com.xiaohongshu.infra.xds.cds.CDSSharedStubWrapper" level="ERROR"></logger>
+  <logger name="events" level="INFO"></logger>
+  <logger name="com.zaxxer.hikari.HikariConfig" level="WARN"></logger>
+  <logger name="com.zaxxer.hikari.HikariDataSource" level="WARN"></logger>
+  <logger name="com.xiaohongshu.infra.rpc.core.registry.eds.MultiRegionsEdsThriftAddressSubscriberProvider" level="off"/>
+</configuration>

package/templates/idl-template/wiki/.idea/codeStyles/Project.xml

@@ -0,0 +1,7 @@
+<component name="ProjectCodeStyleConfiguration">
+  <code_scheme name="Project" version="173">
+    <ScalaCodeStyleSettings>
+      <option name="MULTILINE_STRING_CLOSING_QUOTES_ON_NEW_LINE" value="true" />
+    </ScalaCodeStyleSettings>
+  </code_scheme>
+</component>

package/templates/idl-template/wiki/.idea/codeStyles/codeStyleConfig.xml

@@ -0,0 +1,5 @@
+<component name="ProjectCodeStyleConfiguration">
+  <state>
+    <option name="PREFERRED_PROJECT_CODE_STYLE" value="Default" />
+  </state>
+</component>

package/templates/idl-template/wiki/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,5 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+  </profile>
+</component>

package/templates/idl-template/wiki/.idea/misc.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AnalysisProjectProfileManager">
+    <option name="PROJECT_PROFILE" />
+    <option name="USE_PROJECT_LEVEL_SETTINGS" value="false" />
+    <list size="0" />
+  </component>
+  <component name="ProjectRootManager">
+    <output url="file://$PROJECT_DIR$/out" />
+  </component>
+  <component name="SuppressionsComponent">
+    <option name="suppComments" value="[]" />
+  </component>
+</project>

package/templates/idl-template/wiki/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/wiki.iml" filepath="$PROJECT_DIR$/.idea/wiki.iml" />
+    </modules>
+  </component>
+</project>

package/templates/idl-template/wiki/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$/../../../../.." vcs="Git" />
+  </component>
+</project>

package/templates/idl-template/wiki/.idea/wiki.iml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/templates/idl-template/wiki/SDK-Dev-Guide.md

@@ -49,8 +49,6 @@ thrift idl开发参考[Thrift IDL开发规范](./README.md)
 
 Java sdk会以`maven_project`目录作为打包的基础目录，因此可以在目录中添加代码来定制sdk的功能。
 
-例如，使用[SpringBoot AutoConfiguration](https://docs.spring.io/spring-boot/docs/current/reference/html/boot-features-developing-auto-configuration.html)为sdk开发自动配置功能，参考[例子](example)。
-
 ## 常见问题
 
 1. Invalid remote: origin

package/templates/idl-template/wiki/example/.gitlab-ci.yml

@@ -1,26 +1,12 @@
+image: docker-reg.devops.xiaohongshu.com/shequ/sns-sdk-ci:latest
+
 stages:
   - build
-# 根据项目类型保留需要build的stage 并删掉其他stage
-build:java:
-  stage: build
-  image: docker-reg.devops.xiaohongshu.com/shequ/sns-sdk-ci:latest
-  script:
-    - skr -p ${CI_PROJECT_NAME} -c ${CI_COMMIT_REF_NAME}
-  only:
-    - branches
-    - /^\d+\.\d+\.\d+$/
 
-build:go:
+build:java:
   stage: build
-  image: docker-reg.devops.xiaohongshu.com/shequ/sns-gosdk-ci:latest
   script:
     - skr -p ${CI_PROJECT_NAME} -c ${CI_COMMIT_REF_NAME}
   only:
     - branches
     - /^\d+\.\d+\.\d+$/
-
-build:node:
-  stage: build
-  image: docker-reg.devops.xiaohongshu.com/fe/ts-generator:latest
-  script:
-    - DEBUG=common-bin tsGen build --branch ${CI_COMMIT_REF_NAME} --userEmail ${GITLAB_USER_EMAIL} --ciId ${CI_COMMIT_SHA:0:8} --pId ${CI_PROJECT_ID}