生态Web 与网络

迁移到言枢 0.2

保留 yanxu-web 技术包标识,分阶段迁移模块别名、配置、命名路由、言标页面和测试客户端。

言枢 0.2 保留yanxu-web技术包标识和主要 0.1 API,可以逐步升级。

更新模块别名

# 旧
「包:yanxu-web」 Web;

# 新
「包:yanxu-web」 言枢;

配置化创建

 配置项  言枢.配置()
    .设模板根「templates」
    .设静态根「static」);
 应用  言枢.创建应用(配置项);

创建应用默认加入安全首部。已有等价中间件的项目应删除重复实现,或调用设自动安全首部(假)

命名路由

应用.命名取「/posts/:id」「文章详情」,文章);
 地址  上下文.反向「文章详情」,{「id」「first」});

优先命名页面会链接到的路由,再逐步消除硬编码地址。

渐进迁移页面

HTML响应继续支持yanxu-html节点。新页面可先改为.yb.html并使用应用.模板响应,旧页面无需一次性重写。

原有HTML.原始使用点必须逐项审计;只有可信内容才迁移为言枢.言标.信任HTML

测试

旧测试仍可构造HTTP请求并调用应用.处理。推荐改用:

 客户端  言枢.测试客户端(应用);
 响应  客户端.「/posts/first」);

兼容类型Web应用Web上下文Web开发服务器分别继承新的言枢类型,旧类型标注继续有效。

跨仓发布顺序

先提交并发布言枢 0.2,再把博客等消费项目的版本要求更新为^0.2,最后由言包重新生成锁文件。不要手工猜测 Git 修订或内容校验和。