如何在 SAP BTP Java 应用里使用 SQLite 数据库

SAP Cloud Application Programming 模型的推荐是将 service 和 model 模型的定义分离开。

因此，我们在 db 文件夹里定义 model model.

新建一个 schema.cds 文件：

    namespace sap.capire.products;
    using { Currency, cuid, managed, sap.common.CodeList } from '@sap/cds/common';
    entity Products : cuid, managed {
        title    : localized String(111);
        descr    : localized String(1111);
        stock    : Integer;
        price    : Decimal(9,2);
        currency : Currency;
        category : Association to Categories;
    }
    entity Categories : CodeList {
        key ID   : Integer;
        parent   : Association to Categories;
        children : Composition of many Categories on children.parent = $self;
    }

内容如下：

这里用关键字 entity 定义了 Products 和 Categories 两个领域模型。其中Currency，cuid 和 CodeList 等标准类型，来自 @sap/cds/common:

localized 关键字可用于标记需要翻译的元素。 存储不同语言的翻译和存储默认后备翻译的能力由 CDS 自动处理。

Associations 和 Compositions

associations 和 compositions 可用于定义实体之间的关系。 它们通常允许您在不明确使用外键的情况下定义这些关系。

虽然关联定义了实体之间相当松散的耦合，但组合定义了包含关系。 组合也可以被认为是定义深层结构。 可以沿这些结构执行深度插入和更新插入。

在域模型中，类别实体定义了父元素和子元素。 这启用了类别的层次结构。 一个类别的 children entity 被建模为一个组合。 一个包含所有子类的类别定义了一个深层嵌套结构。 删除一个类别将自动删除其所有子项。 然而，一个类别的父类被建模为一个关联。 删除一个类别显然不应该删除它的父类。

cuid 和 managed 都是 aspect，后者用附加元素扩展 entity. cuid aspect 将 UUID 类型的关键元素 ID 添加到 entity.

managed aspect 将创建和修改时间戳等字段添加到 entity 内。

我们按住 ctrl 键 + 左键，就能查看到这些 aspect 对应的实现：

CodeLists 可用于存储基于代码（例如货币、国家或语言）的全局可翻译定义。 特别是对于 UI，CodeList 可用于为某些输入字段提供值帮助。

Currency 定义是一种类型。 它定义了与货币实体的关联。 Currencies 实体基于 ISO 4217 并使用三个字母的字母代码作为键，例如 EUR 或 USD，并提供了存储相应货币符号（例如 € 或 $）的可能性。

在 service 定义里，将 domain model 里某些字段暴露出来：

下面我们需要将 domain model 部署到 sqllite 里。

首先使用命令行安装 sqlite：

npm install --save-dev sqlite3

运行如下命令行，使用命令行将 domain model 初始化 sqlite：

cds deploy --to sqlite

下一步我们需要将 spring boot 应用同 sqlite 数据库建立关联关系。

打开 main/resources/application.yaml 文件：

---
spring:
  profiles: default
  datasource:
    url: "jdbc:sqlite:/home/user/projects/products-service/sqlite.db"
    driver-class-name: org.sqlite.JDBC
    initialization-mode: never
    hikari:
      maximum-pool-size: 1

使用 curl 插入一条新的数据：

curl -X POST http://localhost:8080/odata/v4/AdminService/Categories \
-H "Content-Type: application/json" \
-d '{"ID": 1, "name": "TechEd", "descr": "TechEd related topics", "children": [{"ID": 10, "name": "CAP Java", "descr": "Run on Java"}, {"ID": 11, "name": "CAP Node.js", "descr": "Run on Node.js"}]}'

然后使用下面的 url，即可成功访问刚刚插入的 categories 数据：

https://workspaces-ws-pdwk4-app1.us10.trial.applicationstudio.cloud.sap/odata/v4/AdminService/Categories