wastnet v1.0.2 的变化重点不在于“又增加了多少组件”，而在于把应用开发中两个容易失控的部分重新划清边界：配置从弱类型字符串走向强类型模型，MVC 模块则进一步独立。对于希望使用纯 JDK 能力构建 Java 网络服务的团队来说，这意味着框架的底层实现与上层业务代码之间可以更容易地解耦。
wastnet 本身是一款完全自研、零第三方依赖的轻量级 Java 网络应用框架。它的核心基于 JDK 原生 NIO 构建 Reactor 多路复用模型，不依赖 Netty、Tomcat 等第三方网络库；HTTP/2 协议栈中的 HPACK、Huffman、ALPN 等部分也由项目自行实现，并支持直接加载 PEM 证书。v1.0.2 则把注意力进一步放到了“如何让开发者使用它”。
强类型配置解决的不是格式问题，而是边界问题
传统配置系统常把所有值都当作字符串处理：端口需要手动转换，超时时间需要自行解析，布尔值和列表还可能因为拼写或默认值产生隐蔽错误。配置规模一旦增长，问题通常不是“配置文件能不能读取”，而是错误要到运行很久之后才暴露。
强类型配置的价值在于把配置文件映射为明确的 Java 模型。端口是整数，开关是布尔值，超时可以统一为时间类型，应用代码不必在各个角落重复解析字符串。理想的配置链路可以抽象为：
配置文件 -> 类型转换 -> 校验 -> 不可变配置对象 -> HTTP/MVC 模块
这种链路还带来一个重要收益：配置错误更接近启动阶段暴露，而不是等到请求进入某个分支后才失败。对于服务端程序，快速失败通常比带着错误配置继续运行更安全。
下面是一个可以直接改造到项目中的配置模型示例。示例使用 Java 17 的 record 表达不可变配置对象；其中 ConfigLoader 代表项目实际提供的配置绑定入口，具体类名和方法名应以 wastnet v1.0.2 的 API 为准。
import java.time.Duration;
public record ServerConfig(
int port,
boolean http2,
Duration requestTimeout,
TlsConfig tls
) {
public ServerConfig {
if (port < 1 || port > 65535) {
throw new IllegalArgumentException("port must be between 1 and 65535");
}
if (requestTimeout.isZero() || requestTimeout.isNegative()) {
throw new IllegalArgumentException("requestTimeout must be positive");
}
}
public record TlsConfig(boolean enabled, String certificatePem, String privateKeyPem) {}
}
final class Application {
public static void main(String[] args) {
// 将 ConfigLoader 替换为 wastnet v1.0.2 实际提供的强类型配置绑定 API。
ServerConfig config = ConfigLoader.load("application.yaml", ServerConfig.class);
System.out.println("port=" + config.port());
System.out.println("http2=" + config.http2());
System.out.println("timeout=" + config.requestTimeout());
}
}
对应的配置文件可以保持接近业务含义：
server:
port: 8080
http2: true
request-timeout: 5s
tls:
enabled: true
certificate-pem: ./cert/server.crt
private-key-pem: ./cert/server.key
实践时应特别注意配置模型的职责边界。配置对象负责表达和校验“服务应该如何启动”，不应顺便承载数据库连接、请求上下文或可变运行状态。这样做可以避免配置对象变成一个新的全局服务定位器。
MVC 模块独立，让网络内核与业务层各自演进
网络框架通常包含两类能力：一类负责连接、协议、多路复用和字节流处理；另一类负责路由、控制器、参数绑定和响应生成。它们都很重要，但变化速度和使用场景并不相同。
v1.0.2 将 MVC 模块独立出来，带来的直接好处是边界更清楚：
- 只需要底层 HTTP 能力的程序，不必被完整 MVC 编程模型绑定。
- 使用 MVC 的应用可以把控制器、路由和业务服务放在更稳定的上层结构中。
- 网络内核与 Web 应用抽象可以分别演进，减少模块之间的隐式依赖。
- 测试时可以针对控制器和路由进行更小范围的验证，而不必每次都覆盖整个网络栈。
可以把一次请求的处理路径理解为：
TCP/NIO Reactor
-> HTTP 解码
-> 路由匹配
-> 控制器调用
-> 业务服务
-> HTTP 响应编码
MVC 独立之后，应用代码最好不要直接依赖 Reactor 的选择器、连接状态或底层缓冲区。控制器接收的是已解析的请求数据，返回的是明确的响应结果；协议细节应该停留在框架边界内。
下面是一个与具体框架 API 解耦的 MVC 结构示意。它不是对 wastnet 类名的硬编码，而是一种可以映射到实际 API 的最小组织方式：
// 类名为示意，请根据 wastnet v1.0.2 的 MVC API 替换注解和接口。
@Controller
final class HealthController {
@Get("/health")
Response health() {
return Response.json("{\"status\":\"ok\"}");
}
}
public final class Main {
public static void main(String[] args) {
ServerConfig config = loadConfig();
WastApplication app = WastApplication.builder()
.serverConfig(config)
.scanControllers("example.web")
.build();
app.start();
}
private static ServerConfig loadConfig() {
return new ServerConfig(
8080,
true,
java.time.Duration.ofSeconds(5),
new ServerConfig.TlsConfig(false, "", "")
);
}
}
启动后可以用下面的命令检查路由是否工作。若实际应用启用了 TLS，应将地址改为 https://，并按证书环境调整 curl 参数。
curl --http2 -i http://127.0.0.1:8080/health
原生协议能力带来的取舍
零第三方依赖并不等于没有复杂度，而是把复杂度放回项目自身。wastnet 自研 Reactor、HTTP/2 协议栈和 TLS 证书加载路径，可以减少外部依赖和运行时组件数量，也让框架对底层行为拥有更直接的控制权。
与此同时，使用者需要更重视以下问题：
- 协议兼容性：HTTP/2、HPACK、Huffman 和 ALPN 都有严格的协议边界，升级或接入代理时应覆盖真实客户端和网关场景。
- TLS 运维：直接加载 PEM 证书很方便，但证书轮换、文件权限、私钥保护和容器挂载策略仍需要由部署系统负责。
- 模块选择：如果服务只是做高性能协议接入，不必强行引入 MVC；如果应用需要路由和控制器，则应把业务逻辑留在 MVC 及其服务层，不要穿透到 NIO 细节。
- 观测能力：轻量内核不应意味着缺少日志、请求耗时、错误计数和连接状态指标。生产接入前应确认这些能力如何接入。
升级到 v1.0.2 时可以这样检查
可以按下面的顺序改造现有项目：
# 1. 记录当前 Java 和构建工具版本
java -version
./mvnw -version 2>/dev/null || mvn -version
# 2. 编译并运行单元测试；具体命令按项目构建方式调整
./mvnw clean test
# 3. 启动服务后检查健康路由和 HTTP/2 请求
curl -i http://127.0.0.1:8080/health
curl --http2 -i https://127.0.0.1:8443/health
迁移时不要一次性把所有字符串配置替换成复杂对象。更稳妥的做法是先为端口、超时、TLS 开关等高风险字段建立类型模型，再逐步加入默认值和启动校验。MVC 部分则可以先抽出一个独立模块，让控制器只依赖请求、响应和业务服务接口。
结语：让框架的轻量化落到可维护性上
wastnet v1.0.2 的强类型配置和 MVC 模块独立，分别对应了运行可靠性和代码组织两个问题。前者减少配置解析的隐式行为，后者降低网络内核与业务代码之间的耦合。
如果准备在项目中采用，可以用三条标准判断是否适合：配置错误能否在启动时明确失败，MVC 是否可以独立测试，底层协议能力是否有足够的兼容性和观测手段。满足这些条件后，零第三方依赖带来的可控性才会真正转化为长期维护收益。