SuperAPI AI 工具集

b2c-controllers

通用与其它

查看项目

更新于 10-16 01:08

技能介绍

用途:指导为 Salesforce B2C Commerce 店面创建控制器(Controller),处理 HTTP 请求并渲染响应。控制器 URL 结构为 https://{domain}/on/demandware.store/Sites-{SiteName}-Site/{locale}/{ControllerName}-{FunctionName},例如 Home-Show。

两种模式:SFRA 适用于 Storefront Reference Architecture 站点,使用 server 模块与中间件,官方推荐用于多数店面开发;Classic 适用于非 SFRA 站点或简单 API,使用直接导出并标记 .public = true。

文件位置:控制器放在 cartridge 的 controllers 目录,文件名即 URL 前缀,如 Home.js 处理 Home-* 请求。

主要能力:SFRA 用 server.get/server.post 定义路由,可调用 res.render 渲染 ISML、res.json 返回 JSON、res.redirect 跳转、res.setViewData/getViewData 操作视图数据、res.setStatusCode 设置状态码。req 提供 querystring、form、httpMethod、httpHeaders、currentCustomer、locale、session。中间件可处理缓存、HTTPS、CSRF、同意跟踪、登录校验等。支持 server.extend 扩展控制器,并用 replace、prepend、append 修改既有路由,也可监听 route:BeforeComplete 事件。

Classic 模式:用 exports.FunctionName 定义并设 .public = true,通过 ISML.renderTemplate 渲染,或用 response.setContentType 与 response.writer.print 输出 JSON。

用法要点:用 require() 引入 dw/* API 与 */cartridge/... 模块;用 URLUtils 生成 URL;在 try-catch 中处理错误并记录日志,避免暴露堆栈;SFRA 中间件链中始终调用 next();保持控制器精简,业务逻辑放入 scripts/helpers。

限制:资料未提供安装命令、收费、价格、平台或效果信息,暂未提供。