ColdBox 平台使用教程

1. 项目的目录结构及介绍

ColdBox 是一个基于 ColdFusion (CFML) 的 HMVC（Hierarchical Model-View-Controller）框架。以下是项目的目录结构及各部分的简要介绍：

• apidocs/: 包含 API 文档。
• build/: 构建脚本和配置文件。
• system/: ColdBox 核心系统文件。
• test-harness/: 测试框架和测试用例。
• tests/: 单元测试和集成测试代码。
• .cfconfig.json: ColdBox 配置文件。
• .cfformat.json: 代码格式化配置。
• .cflintrc: 代码风格配置。
• .editorconfig: 编辑器配置。
• .gitattributes: Git 属性配置。
• .gitignore: Git 忽略文件。
• CONTRIBUTING.md: 贡献者指南。
• box-cachebox.json: 缓存盒子配置文件。
• box-logbox.json: 日志盒子配置文件。
• box-wirebox.json: 依赖注入配置文件。
• box.json: ColdBox 项目配置文件。
• changelog.md: 更改日志。
• license.txt: 许可证文件。
• readme.md: 项目说明文件。
• server-*: 服务器配置文件。

2. 项目的启动文件介绍

要启动 ColdBox 项目，通常会使用 CommandBox，这是 ColdBox 官方推荐的 CLI 和包管理器。以下是如何使用 CommandBox 启动项目的基本步骤：

• 安装 CommandBox。
• 在项目根目录下，打开 CommandBox shell。
• 运行 box server start 命令以启动服务器。

启动后，服务器会默认运行在 http://localhost:3000 上。

3. 项目的配置文件介绍

ColdBox 使用多个配置文件来管理不同方面的设置。以下是一些主要的配置文件及其作用：

• .cfconfig.json: 这是 ColdBox 的主要配置文件，包含数据库连接、缓存、日志等核心配置。
• box.json: 包含有关项目的信息，如版本、名称和描述。
• box-cachebox.json: 用于配置 CacheBox，它是一个缓存引擎，可以用于缓存数据以提高性能。
• box-logbox.json: 用于配置 LogBox，它是 ColdBox 的日志系统，可以记录和跟踪应用中的活动。
• box-wirebox.json: 用于配置 WireBox，它是 ColdBox 的依赖注入和 AOP（面向切面编程）框架。

每个配置文件都包含了相应的配置选项，用户可以根据自己的需求进行自定义配置。在项目开发过程中，正确配置这些文件对于确保应用正常运行至关重要。