style(server): 统一 ShortNovel 配置类和 DTO 的字段注释风格

This commit is contained in:
2026-07-19 12:07:26 +08:00
parent 21ce56c6da
commit 8f96239b56
3 changed files with 24 additions and 8 deletions
@@ -15,15 +15,23 @@ import org.springframework.context.annotation.Configuration;
@ConfigurationProperties(prefix = "short-novel") @ConfigurationProperties(prefix = "short-novel")
public class ShortNovelConfig { public class ShortNovelConfig {
/** 外部服务基础 URL */ /**
* 外部服务基础 URL
*/
private String apiBaseUrl; private String apiBaseUrl;
/** 外部服务 API Token */ /**
* 外部服务 API Token
*/
private String apiToken; private String apiToken;
/** 连接超时(毫秒) */ /**
* 连接超时(毫秒)
*/
private Integer connectTimeout = 10000; private Integer connectTimeout = 10000;
/** 读取超时(毫秒) */ /**
* 读取超时(毫秒)
*/
private Integer readTimeout = 300000; private Integer readTimeout = 300000;
} }
@@ -16,14 +16,20 @@ import java.util.Map;
@EqualsAndHashCode(callSuper = true) @EqualsAndHashCode(callSuper = true)
public class ShortNovelFollowupRequest extends BaseRequest { public class ShortNovelFollowupRequest extends BaseRequest {
/** 外部服务返回的 session_id */ /**
* 外部服务返回的 session_id
*/
@NotBlank(message = "sessionId 不能为空") @NotBlank(message = "sessionId 不能为空")
private String sessionId; private String sessionId;
/** 操作类型:answer_clarification | confirm_outline | modify_outline | retry */ /**
* 操作类型:answer_clarification | confirm_outline | modify_outline | retry
*/
@NotBlank(message = "action 不能为空") @NotBlank(message = "action 不能为空")
private String action; private String action;
/** 操作载荷(如回答内容、修改意见) */ /**
* 操作载荷(如回答内容、修改意见)
*/
private Map<String, Object> payload; private Map<String, Object> payload;
} }
@@ -16,7 +16,9 @@ import javax.validation.constraints.Size;
@EqualsAndHashCode(callSuper = true) @EqualsAndHashCode(callSuper = true)
public class ShortNovelStreamRequest extends BaseRequest { public class ShortNovelStreamRequest extends BaseRequest {
/** 用户的心愿文本 */ /**
* 用户的心愿文本
*/
@NotBlank(message = "心愿文本不能为空") @NotBlank(message = "心愿文本不能为空")
@Size(max = 500, message = "心愿文本不能超过 500 字") @Size(max = 500, message = "心愿文本不能超过 500 字")
private String query; private String query;