Apache OFBiz Developer Manual Release 18.12

• 语言: 英语
• 格式: .pdf
• 来源: nightlies.apache.org

摘要

The document provides an overview of the Apache OFBiz system, its architecture, and key components. It explains the core systems including the web server, MVC framework, entity engine, service engine, and widget system. The document details the structure of OFBiz components, which include directories for configuration, data, entities, services, and user interface elements. It also covers security features such as SameSite cookie attributes and password management. The manual emphasizes the modular nature of OFBiz, where both core applications and plugins are treated as components, and provides guidance on development and customization.

AI总结

《Apache OFBiz 开发者手册（版本 18.12）》总结如下：

### 1. 系统架构
Apache OFBiz 是一个大型系统，由多个子系统组成：
- **Web 服务器**：基于 Apache Tomcat。
- **Web MVC 框架**：用于路由和处理请求。
- **实体引擎**：定义、加载和操作数据。
- **服务引擎**：定义和控制业务逻辑。
- **小部件系统**：用于绘制和交互用户界面。

此外，OFBiz 还提供：
- **数据模型**：定义通用业务数据（如订单、发票、客户等）。
- **服务库**：包含预定义服务（如 `createBillingAccount` 或 `updateInvoice`）。
- **应用程序**：提供用户界面，允许用户与系统交互。
- **插件**：作为可选扩展，主要用于添加自定义逻辑。

### 2. 组件结构
- **组件（Component）** 是 OFBiz 的基本单位，最小包含一个 `ofbiz-component.xml` 文件。
- 每个组件具有以下目录结构：

  component-name-here/
  ├── config/
  ├── data/
  ├── entitydef/
  ├── groovyScripts/
  ├── minilang/
  ├── ofbiz-component.xml
  ├── servicedef/
  ├── src/
  │   ├── main/java/
  │   └── test/java/
  ├── testdef/
  └── webapp/
      └── widget/

- 核心组件位于 `applications` 文件夹，插件位于 `plugins` 文件夹。

### 3. 安全性
- **CSRF 防御**：
- 默认启用 SameSite 属性，值为 `strict`。
- 可通过 `security.properties` 修改为 `lax`。
- 相关属性：`SameSiteCookieAttribute`。
- **密码与 JWT**：
- 演示和初始密码存储在 `security.xml` 文件中。
- 参考《技术生产设置指南》中的 `Initial Data Loading` 和 `Security Settings` 部分。

### 4. 数据模型变更
- **OFBiz 9 到 16 的变更**：
- 新增 77 个实体，包括 `JobRequisition`、`ProductPromoCodeEmail` 等。
- **即将到来的分支（主分支）的变更**：
- 新增 1 个实体 `ProdPromoCodeContactMech`。
- 移除/弃用 1 个实体 `ProductPromoCodeEmail`。

### 5. 示例工作流程
- 用户在浏览器中输入 URL（如 `https://localhost:8443/accounting/control/findInvoices`）并访问：
- URL 解析：
- `localhost:8443`：OFBiz 运行的服务器及端口。
- `accounting`：Web 应用名称。
- `control`：路由到控制 servlet。
- `findInvoices`：请求名称。
- 控制 servlet 负责将请求路由到相应的响应，配置文件为 `controller.xml`。

### 总结
Apache OFBiz 是一个功能完善的业务自动化平台，其架构由多个核心子系统和组件构成。开发者可以通过组件化的方式扩展功能，同时需要注意安全性配置（如 CSRF 防御和密码管理）。数据模型的变更和组件结构的复杂性是开发和维护时需要重点关注的内容。