使用 SAP BTP 试用版

Tips :

如果没有权限 , 按照https://help.sap.com/docs/bas/sap-business-application-studio/manage-role-collections进行角色权限

创建 Dev Space

创建CAP 应用程序框架

• 该项目名为 products-service

• db 文件夹存储与数据库相关的项目

• srv 文件夹存储 Java 应用程序

如果看到一条通知，询问是否要同步 Java classpath/configuration ，请选择 Always （始终）。

如果目前对任何 pom.xml 文件有任何问题指示，请不要担心暂时忽略它们。

定义服务

• 使用实体定义数据结构

• 如何使用服务定义使用数据结构

编译

运行

如你所见，该文件不包含特定于 CAP 的启动说明。这是每个Spring Boot应用程序中的典型样板代码。CAP Java 运行时的初始化由 Spring 根据 .pom.xml

检查 OData 元数据

odata/v4/AdminService/$metadata

添加自定义事件处理程序

管理“AdminService”服务中的“Products”实体。它处理创建和读取这些实体的事件，并将数据存储在一个内部映射中。

通过HTTP请求插入数据

访问数据

创建通用的服务

• 创建一个服务，稍后将在另一个 CAP Java 项目中重用该服务。

• 使用 CDS 建模时，最佳做法是将服务与模型分开。

• 转到的 db 文件夹并创建一个名为 schema.cds 的文件

• 将以下代码添加到新创建的 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;}

了解关键字

如你所见，域模型定义了两个实体：

• Products

• Categories

它还从包（全局可用的重用 @sap/cds/common 包）导入各种通用定义：

• Currency

• cuid

• managed

• CodeList

此外，域模型还使用 CDS 关键字 localized 、 Association 和 Composition

localized

Associations and Compositions

• 关联就像是朋友关系。比如，一本书和它的类别之间的关系就是关联。

• 在关联中，书和类别是相互独立的。如果你删除了一个类别，它并不会影响到书。这就像是，如果你和你的朋友不再联系，你们各自的生活还是会继续。

• 组合则更像是父母和孩子的关系。在你的数据模型中，一个类别可以有子类别，这种父子类别的关系就是组合。

• 在组合中，子类别依赖于父类别。如果父类别被删除了，它的所有子类别也会被删除。这就像是，如果一个家庭解散了，那么家庭成员之间的关系也就不存在了。

aspect : cuid and managed

1. cuid（Client Unique ID）:
• cuid是一个aspect，它向实体添加了一个名为ID的关键元素。
• 这个ID元素的类型是UUID（Universally Unique Identifier，通用唯一识别码），这意味着每个实体都会有一个独一无二的标识符。
• 使用cuid可以确保每个实体都能被唯一地识别，这在数据库中是非常重要的。

2. managed:
• managed是另一个aspect，它向实体添加了四个额外的元素。
• 这些元素用于捕捉实体的创建时间、最后更新时间，以及执行创建和最后更新的用户。
• 具体来说，这四个元素通常是：创建时间（createdAt）、创建者（createdBy）、最后更新时间（modifiedAt）、以及最后更新者（modifiedBy）。
• 这对于跟踪和维护数据的历史记录非常有用，尤其是在需要审计或了解数据变更历史的情况下。

aspect : CodeList

• CodeList是一种特殊的aspect，用于存储基于代码的全球性、可翻译的定义。这些定义可以包括货币、国家、语言等。

• 在用户界面（UI）中，CodeList特别有用，因为它可以为某些输入字段提供值帮助。比如，如果你有一个让用户选择国家的下拉菜单，你可以使用CodeList来填充这个菜单的选项，其中包括所有国家的名称和相应的代码。

• CodeList的一个关键优点是它支持国际化，这意味着你可以根据用户的语言偏好显示不同语言的值。

Type : Currency

• Currency是一个定义了货币的类型。

• 它定义了一个到Currencies实体的关联。这个Currencies实体基于ISO 4217标准，使用三字母的字母代码作为键，例如“EUR”（欧元）或“USD”（美元）。

• 除了货币代码，Currencies实体还提供存储相应货币符号的可能性，比如“€”（欧元符号）或“$”（美元符号）。

• 这种类型的设计使得在处理涉及货币的数据时更加方便和标准化，尤其是在需要处理多种货币的国际化应用中。

获取有关 '@sap/cds/common ' 的更多信息

重写AdminService

• 投影是一种在服务中暴露实体的方式。通过投影，你可以选择性地包含或排除实体的某些元素，甚至可以重命名元素。

• 在你的例子中，你将使用最简单的投影形式，即不对领域模型实体进行任何更改地直接暴露它们。

• 首先，你需要进入srv文件夹并打开admin-service.cds文件。

• 然后，用下面的代码替换该文件的内容，并确保保存文件：

• 这段代码的意思是，你在AdminService中定义了两个实体：Products和Categories。这些实体是通过对db（你的数据库模型）中的相应实体进行投影得到的。

• using { sap.capire.products as db } from '../db/schema';: 这行代码导入了你的数据库模型，这样你就可以在服务中引用它了。

• entity Products as projection on db.Products;: 这表示Products实体是对数据库模型中Products实体的直接投影。

• entity Categories as projection on db.Categories;: 同样，这表示Categories实体是对数据库模型中Categories实体的直接投影。

使用CAP的通用持久化处理

1. CAP的通用持久性处理:
• CAP Java SDK提供了开箱即用的功能，可以从数据库中存储和检索实体。
• 如果实体存储在数据库中，通常不需要自定义编码。

2. 自动服务实体:
• 在你的AdminService中定义的实体将通过OData自动提供服务。
• 由于CAP处理了大部分工作，你可以删除之前创建的AdminService.java文件。

3. 操作步骤:
• 删除handlers文件夹中的AdminService.java文件。

4. 数据库选择:
• 默认情况下，CAP Java SDK使用内存中的H2数据库。这意味着当应用程序停止时，数据库中的内容将丢失。
• 如果你需要在应用程序运行之间持久化数据库，可以使用基于文件的SQLite数据库。这在CAP文档的“使用数据库”部分有详细描述。

运行并测试应用程序

1. 停止应用程序:
• 如果你的应用程序仍在运行，首先需要将其停止。

2. 重新启动应用程序:
• 在终端中运行命令mvn spring-boot:run来重新启动你的应用程序。
• 一旦应用程序启动，你可以在新标签页中打开它。

3. 创建类别（Categories）:
• 你将通过HTTP请求来创建一些类别。
• 在你之前创建的
文件中添加以下内容：
• 然后选择出现在新请求上方的“Send Request”（发送请求）。这个请求将通过深度插入一次性创建多个嵌套类别。

4. 查询单个类别:
• 尝试查询单个类别，例如，通过在你的应用程序URL末尾添加以下内容：

5. 展开嵌套结构:
• 你还可以展开嵌套的结构。在应用程序URL的末尾添加以下内容：

6. 测试完成后停止应用程序:
• 测试完成后，可以使用CTRL+C停止你的应用程序。

为重用做准备

1. 修改package.json文件:
• 首先，打开位于~/projects/products-service文件夹中的package.json文件。
• 将name字段的值从products-service-cds更改为@sap/capire-products。这将定义你的重用模块的名称。
• 如果你愿意，也可以在description字段中提供一个有意义的描述。

2. 添加index.cds文件:
• 为了更容易重用模块，并确保与其他应用程序的更好解耦，你可以在products-service中添加一个index.cds文件。
• 在~/projects/products-service文件夹中创建一个新的index.cds文件。
• 将以下内容放入这个文件中，并确保保存文件：
• 这个文件将作为模块的入口点，它引用了数据库模式和服务定义。

3. 完成这些步骤后，你就成功地开发了基于CDS领域模型和服务定义的products-service应用程序，并为将来的重用做好了准备。

创建书店项目

请确保停止了应用程序

引入服务

1. 模拟发布product-service模块:
• 首先，你需要模拟发布product-service模块，并在书店应用程序中使用这个版本。

2. 打开新的终端:
• 在SAP Business Application Studio的主菜单中，选择“Terminal → New Terminal”。
• 在终端中执行以下命令以切换到书店项目的目录：
• cd ~/projects/bookstore

3. 安装可重用服务项目作为NPM依赖项:
• 执行以下命令来安装product-service作为依赖项：
• npm pack命令会从products-service创建一个tarball（压缩包文件），然后直接将其用作书店应用程序中的依赖项。

4. 查找压缩包文件:
• 在书店项目的根文件夹中，你将找到一个名为sap-capire-products-1.0.0.tgz的文件，这是products-service项目的tarball文件。

5. 安装其他包并简化依赖结构:
• 执行以下命令来安装所有其他包并简化整体依赖结构：
• npm install && npm dedupe

6. 检查package.json文件:
• 打开你的书店项目的package.json文件，你将看到对@sap/capire-products的依赖。

定义书店域模型

1. 创建schema.cds文件:
• 在~/projects/bookstore/db文件夹中，创建一个名为schema.cds的文件。

2. 添加代码到schema.cds文件:
• 将以下代码添加到你刚创建的schema.cds文件中，并确保保存文件：
• namespace sap.capire.bookstore;using { Currency, cuid, managed } from '@sap/cds/common';using { sap.capire.products.Products } from '@sap/capire-products';entity Books as projection on Products; extend Products with { // Note: we map Books to Products to allow reusing AdminService as is author : Association to Authors;}entity Authors : cuid { firstname : String(111); lastname : String(111); books : Association to many Books on books.author = $self;}@Capabilities.Updatable: falseentity Orders : cuid, managed { items : Composition of many OrderItems on items.parent = $self; total : Decimal(9,2) @readonly; currency : Currency;}@Capabilities.Updatable: falseentity OrderItems : cuid { parent : Association to Orders not null; book_ID : UUID; amount : Integer; netAmount : Decimal(9,2) @readonly;}
• 这个领域模型定义了四个实体：Books、Authors、Orders和OrderItems。

3. 理解代码:
• 导入了Currency、cuid和managed类型和aspects，这些在之前的教程中有描述。
• 导入了Products实体，并将其重用为Books实体。为了建立书籍和作者之间的关系，Products实体被扩展了一个额外的关联到Authors。
• Orders实体的total元素和OrderItems实体的netAmount元素被标注为@readonly，意味着这些元素的值不能由客户端设置，而是通过自定义代码计算。这部分自定义代码将在后续教程中实现。
• Orders和OrderItems实体都被标注为@Capabilities.Updatable: false，意味着它们不能被更新，只能被创建和删除。

定义书店服务

1. 创建services.cds文件:
• 在~/projects/bookstore/srv文件夹中，创建一个名为services.cds的文件。

2. 添加代码到services.cds文件:
• 将以下代码添加到services.cds文件中，并确保保存文件：
• 这个services.cds文件定义了三个服务：BooksService、OrdersService和AdminService。

3. 理解代码:
• BooksService用于提供对Books和Authors数据的只读视图。通过这个服务无法修改这些实体。
• OrdersService允许查看、创建和删除订单。
• AdminService是从产品服务中重用的，但我们向其中添加了Authors实体。它可以用于创建、更新和删除产品和作者。

4. 服务的最佳实践:
• 通常最好根据单一用例来定义服务。例如，AdminService用于管理产品、作者和类别，而BooksService用于展示书籍和作者的目录，对最终用户隐藏了诸如创建和修改时间等管理数据。

加载示例数据

1. 创建数据文件夹:
• 在你的书店项目中，右键点击db文件夹并选择“新建文件夹”。将这个新文件夹命名为data。

2. 进入数据文件夹:
• 在终端中运行以下命令以进入data文件夹：

3. 下载CSV数据文件:
• 为Authors实体下载CSV数据文件：
• 为Books实体下载CSV数据文件：
• 将下载的Books CSV文件重命名：
• 下载Books实体的翻译CSV数据文件：
• 将下载的Books_texts CSV文件重命名：
• 为Categories实体下载CSV数据文件：

4. 确认CSV文件:
• 确保你现在有4个CSV文件，包含示例数据。这些文件为我们重用的服务和在书店服务中创建的一个实体提供初始数据：
• sap.capire.products-Categories.csv
• sap.capire.products-Products.csv
• sap.capire.products-Products_texts.csv
• sap.capire.bookstore-Authors.csv

5. 注意CSV文件命名:
• CSV文件的命名必须精确匹配模式[namespace]-[entity name]，否则应用程序将无法启动。

运行和测试你的书店应用程序

1. 进入书店项目的根目录:
• 在终端中运行以下命令以进入书店项目的根目录：

2. 停止之前运行的应用程序:
• 确保你已经使用CTRL+C停止了所有之前运行的应用程序（包括products-service应用程序）。

3. 启动应用程序:
• 通过运行以下命令来启动应用程序：
• 在SAP Business Application Studio中，你将看到一个弹出窗口。选择“在新标签页中打开”。

4. 打开URL并查看数据:
• 当你在新标签页中打开URL时，你将看到一个欢迎页面。要查看书籍数据，可以直接从欢迎页面上点击“Books”。
• 作为另一种方式，你也可以在URL后面直接添加/odata/v4/BooksService/Books来访问书籍数据。

5. 阅读本地化的德语示例数据:
• 要阅读本地化的德语示例数据，请在URL中添加查询参数sap-locale=de。例如，<APP_URL>/odata/v4/BooksService/Books?sap-locale=de。尝试在德语（de）和英语（en）之间切换语言。

使用自定义代码扩展书店

1. 停止应用程序:
• 如果你的应用程序仍在运行，请使用CTRL+C停止它。

2. 创建handlers文件夹:
• 在终端中，进入srv/src/main/java/com/sap/cap/bookstore目录。
• 创建一个新的文件夹，命名为handlers。

3. 创建OrdersService.java文件:
• 在handlers包中，创建一个名为OrdersService.java的文件。
• 将以下内容添加到OrdersService.java文件中，并确保保存文件：
• 这个类将作为OrdersService的事件处理器。

4. 解决编辑器中的验证错误:
• 如果你在编辑器中看到验证错误，请在srv目录中的pom.xml上打开上下文菜单并选择“重新加载项目”。
• 这将重新生成类并使它们可用。

创建订单时减少库存

1. 添加方法到OrdersService Java类:
• 将以下代码添加到你的OrdersService Java类中，并确保保存文件：
• @AutowiredPersistenceService db;@Before(event = CqnService.EVENT_CREATE, entity = OrderItems_.CDS_NAME)public void validateBookAndDecreaseStock(List<OrderItems> items) { for (OrderItems item : items) { String bookId = item.getBookId(); Integer amount = item.getAmount(); // check if the book that should be ordered is existing CqnSelect sel = Select.from(Books_.class).columns(b -> b.stock()).where(b -> b.ID().eq(bookId)); Books book = db.run(sel).first(Books.class) .orElseThrow(() -> new ServiceException(ErrorStatuses.NOT_FOUND, "Book does not exist")); // check if order could be fulfilled int stock = book.getStock(); if (stock < amount) { throw new ServiceException(ErrorStatuses.BAD_REQUEST, "Not enough books on stock"); } // update the book with the new stock, means minus the order amount book.setStock(stock - amount); CqnUpdate update = Update.entity(Books_.class).data(book).where(b -> b.ID().eq(bookId)); db.run(update); }}@Before(event = CqnService.EVENT_CREATE, entity = Orders_.CDS_NAME)public void validateBookAndDecreaseStockViaOrders(List<Orders> orders) { for (Orders order : orders) { if (order.getItems() != null) { validateBookAndDecreaseStock(order.getItems()); } }}

2. 添加导入语句:
• 在OrdersService Java类的顶部添加以下导入语句，并确保保存文件：
• import java.util.List;import org.springframework.beans.factory.annotation.Autowired;import com.sap.cds.ql.Select;import com.sap.cds.ql.Update;import com.sap.cds.ql.cqn.CqnSelect;import com.sap.cds.ql.cqn.CqnUpdate;import com.sap.cds.services.ErrorStatuses;import com.sap.cds.services.ServiceException;import com.sap.cds.services.cds.CqnService;import com.sap.cds.services.handler.annotations.Before;import com.sap.cds.services.persistence.PersistenceService;import cds.gen.ordersservice.OrderItems;import cds.gen.ordersservice.OrderItems_;import cds.gen.ordersservice.Orders;import cds.gen.ordersservice.Orders_;import cds.gen.sap.capire.bookstore.Books;import cds.gen.sap.capire.bookstore.Books_;

3. 理解代码逻辑:
• validateBookAndDecreaseStock方法使用@Before注解注册，这意味着该方法在OrderItems实体持久化之前被调用。该注解还指定了在创建OrderItems实体时调用该方法。
• 方法检查要订购的书籍是否存在，并比较可用库存与订购数量。如果库存足够，则减少书籍的库存并在数据库中更新书籍。
• validateBookAndDecreaseStockViaOrders方法用于处理通过Orders实体的深度插入创建的订单项。

4. 处理可能的错误:
• 如果OrdersService.java文件仍然显示错误，请在srv目录中右键单击pom.xml并选择“重新加载项目”。
• 关闭并重新打开OrderService.java文件后，错误应该消失。

测试处理程序

1. 停止应用程序:
• 在SAP Business Application Studio的终端中，如果应用程序仍在运行，请使用CTRL+C停止它。

2. 设置运行配置:
• 在SAP Business Application Studio的侧边栏中，选择运行配置图标。
• 选择创建配置图标（加号），然后选择Bookstore作为你要运行的项目。按Enter确认名称。

3. 启动应用程序:
• 点击绿色箭头来启动应用程序。
• 你应该在调试控制台中看到应用程序正在启动。

4. 测试应用程序:
• 在根目录中创建一个新的文件requests.http。
• 在文件中输入以下内容：
• 选择“发送请求”来执行请求。

5. 查看库存变化:
• 从欢迎页面上，选择Books，你将看到书籍《Wuthering Heights》的库存减少到10。
• 你也可以在应用程序URL的末尾添加/odata/v4/BooksService/Books来查看。
• 记住应用程序URL是在你运行应用程序时创建的。

6. 添加并执行第二个请求:
• 在你创建的requests.http文件中添加第二个请求：
• 选择第二个请求上方的“发送请求”来执行请求。你将看到你正在订购的书籍的当前库存。

7. 重复请求直到库存耗尽:
• 重复请求，直到你得到一个错误，表明书籍已经缺货。
• 通过重复请求，你每次都在订购2本书，因此每次都会减少2本书的库存。

计算订单项的netAmount

1. 添加计算净金额的方法:
• 将以下代码添加到OrdersService类中，并确保保存文件：

2. 添加导入语句:
• 在OrdersService Java类的顶部添加以下导入语句，并保存文件：

3. 理解代码逻辑:
• calculateNetAmount方法使用@After注解注册，这意味着该方法在从数据库读取OrderItems实体后被调用。该注解还指定了在读取或创建OrderItems实体时调用该方法。
• 方法的items参数提供了对所有读取或创建的OrderItems实体的访问。
• CqnSelect sel变量定义了一个数据库查询，用于检索订单项引用的书籍。执行查询后，使用Books的POJO接口访问查询结果。
• 在最后一行中，根据书籍的价格和订购的数量计算订单项的净金额。

再次测试

send Request 发送请求

计算订单总额

1. 添加计算总金额的方法:
• 将以下代码添加到OrdersService类中，并确保保存文件：
• @After(event = { CqnService.EVENT_READ, CqnService.EVENT_CREATE }, entity = Orders_.CDS_NAME)public void calculateTotal(List<Orders> orders) { for (Orders order : orders) { // calculate net amount for expanded items if(order.getItems() != null) { calculateNetAmount(order.getItems()); } // get all items of the order CqnSelect selItems = Select.from(OrderItems_.class).where(i -> i.parent().ID().eq(order.getId())); List<OrderItems> allItems = db.run(selItems).listOf(OrderItems.class); // calculate net amount of all items calculateNetAmount(allItems); // calculate and set the orders total BigDecimal total = new BigDecimal(0); for(OrderItems item : allItems) { total = total.add(item.getNetAmount()); } order.setTotal(total); }}

2. 理解代码逻辑:
• calculateTotal方法使用@After注解注册，这意味着该方法在从数据库读取Orders实体后被调用。该注解还指定了在读取或创建Orders实体时调用该方法。
• 对于作为操作一部分可能返回的订单项，使用calculateNetAmount方法计算净金额。请注意，这可能只是订单所有项的一部分。
• 对于每个订单，使用在CqnSelect selItems中定义的查询从数据库中读取所有订单项。
• 对于每个订单项，首先通过重用calculateNetAmount方法计算净金额。然后将所有净金额加到订单的总金额中。

测试订单总额

1. 将 requests.http 文件的第三个请求中将 amount 更新为 10

2. 选择第三个请求上方的 Send Request （发送请求）

3. 在欢迎页面中，选择 Orders。你将看到元素 total 填充了计算值。

4. URL 末尾加入?$expand=items

添加身份验证和授权

向订单服务添加身份验证

1. 启动应用程序:
• 使用命令mvn spring-boot:run启动应用程序。

2. 尝试未经认证的请求:
• 打开requests.http文件，并执行第一个“创建订单”的请求，方法是选择请求上方的“发送请求”。
• 观察响应是否包含状态HTTP/1.1 401。这表明请求由于未经认证而被拒绝。

3. 修改请求以包含认证信息:
• 为了创建订单，你需要提供凭据。对于本地开发，CAP提供了内置的模拟用户。修改请求如下：
• 在这里，你已经向请求中添加了Authorization HTTP头，并为内置的已认证模拟用户提供了凭据。这个用户的密码为空。

4. 再次执行请求并验证结果:
• 再次执行请求，并查看订单是否现在被创建。
• 当在欢迎页面上选择OrdersService的实体时，你现在也需要提供凭据。在那里，你也可以使用已认证用户和空密码。

将模拟用户添加到项目

1. 添加安全配置:
• 在srv/src/main/resources下的application.yaml文件中添加安全配置部分：
• 这里你定义了两个用户，它们没有明确的角色分配，将隐式地属于authenticated-user伪角色。

2. 重启应用程序:
• 使用命令mvn spring-boot:run重启应用程序。
• 在启动日志中，你可以观察到创建的模拟用户及其用户名、角色和密码。这些用户是除了内置模拟用户之外添加的。

3. 修改HTTP请求以包含模拟用户的凭据:
• 修改你之前使用的HTTP请求，以包含其中一个模拟用户的凭据：
• 选择请求上方的“发送请求”，查看是否创建了新订单。

4. 观察响应内容:
• 响应的有效载荷应包含在createdBy和modifiedBy字段中的用户名称，这是由你之前在领域模型中添加的managed方面提供的。

将用户角色添加到项目

1. 添加具有角色的模拟用户:
• 在application.yaml文件中，在现有用户后添加一个新的模拟用户，如下所示：
• 使用roles属性为该用户添加“Administrators”角色。

2. 限制AdminService的访问:
• 在srv目录中的services.cds文件末尾添加注释定义，以使AdminService仅对具有“Administrators”角色的用户可用：

3. 重启应用程序:
• 使用命令mvn spring-boot:run重启应用程序。

4. 添加新的HTTP请求:
• 在requests.http文件中添加一个新的请求：
• 选择这个请求上方的“发送请求”，查看是否收到产品列表。

5. 测试访问控制:
• 移除Authorization头或将凭据更改为不同的模拟用户。
• 观察AdminService是否对他们不可用。

实体的高级授权

• 每个经过身份验证的用户只能查看他们自己的订单和订单项。

• 管理员应该能够查看所有用户的所有订单。

1. 修改OrdersService的服务定义:
• 在srv文件夹中的services.cds文件中，修改OrdersService的服务定义如下：
• 这样，你为管理员授予了访问所有订单的权限，而普通用户只能看到他们自己创建的订单。由于你将OrderItems作为一个单独的实体暴露，你也需要在那里添加安全配置。

2. 重启应用程序:
• 使用命令mvn spring-boot:run重启应用程序。

3. 执行HTTP请求以创建订单:
• 使用你之前添加的模拟用户的凭据执行HTTP请求来创建订单：

4. 验证不同用户的访问权限:
• 通过添加以下请求到requests.http文件来验证每个用户（除了管理员）只能访问他们自己的订单和项：
• 你将看到自己的订单和项。
• 你将不会看到任何项。
• 你将看到所有订单和项。

将 CAP Java 应用部署到 SAP Business Technology Platform

在SAP BTP驾驶舱中使用SAP HANA Cloud试用版

• SAP HANA Cloud: tools (Application), hana, hana-cloud-connection, and relational-data-lake

• SAP HANA Schemas & HDI Containers: hdi-shared, schema, and securestore

添加对SAP HANA Cloud工具的订阅

1. 从SAP BTP驾驶舱中，单击服务，然后单击服务市场。搜索SAP HANA云，然后单击右上角的创建。

1. 在服务下选择SAP HANA Cloud，在计划下选择 tools。 然后点击 Create

2. 要确保你所需的用户具有在HANA Cloud Central中管理实例的必要权限，请导航到左侧菜单中的“安全”>“用户”。然后单击你的用户。

创建一个Instanse

增强生产项目配置

• 这个命令会执行以下操作：
• hana: 为SAP HANA数据库配置部署，将数据源类型为hana的配置添加到requires.[production].db块中。
• mta: 添加mta.yaml文件，该文件反映了你的项目配置。
• xsuaa: 创建xs-security.json文件，并在mta.yaml文件中添加所需配置。在requires.[production].auth块中添加xsuaa类型的认证。
• approuter: 添加独立AppRouter的配置和所需文件，以确保部署后身份验证流程正常工作。

• 确保cds-starter-cloudfoundry依赖项包含在你的项目中
• <dependency> <groupId>com.sap.cds</groupId> <artifactId>cds-starter-cloudfoundry</artifactId></dependency>

更新xs-security.json和xs-app.json

1. 更新xs-security.json文件:
• 打开SAP Business Application Studio中的xs-security.json文件。
• 更新文件内容，以便它看起来像这样：
• 在xsappname属性中添加你的应用程序名称，并声明一个角色集合，以便你稍后可以将用户分配给它。

2. 根据部署环境更新OAuth2配置:
• oauth2-configuration的值取决于你的账户部署的环境。
• 检查命令cf target返回的API URL，并相应地更改值中的数据中心ID，例如https://*.cfapps.us10-001.hana.ondemand.com/**。

3. 更新xs-app.json文件:
• 打开app/xs-app.json文件。
• 移除welcomeFile属性。

查看SAP BTP Cloud Foundry地址

登录SAP BTP Cloud Foundry环境

1. 在SAP Business Application Studio中，选择“终端”打开终端→ 从主菜单中新建终端。

2. 运行以下命令以配置要在终端中连接到的Cloud Foundry环境。将<CF_API_ENDPOINT>替换为在上一步骤中获得的实际值
1. cf api <CF_API_ENDPOINT>

3. 在终端中使用以下命令，使用登录凭据进行身份验证：
1. cf login

使用cf Deploy进行部署

1. 构建部署档案:
• 在项目的根目录中，执行以下命令来构建部署档案：
• 这需要MBT构建工具，SAP Business Application Studio已经安装了这个工具。
• t选项定义构建结果的目标文件夹为项目的gen文件夹。作为这个构建的一部分，隐式地执行了cds build --production。这个隐式构建然后使用了你在使用-for production时添加的所有配置。

2. 部署档案:
• 使用cf deploy命令部署档案：
• 这需要MultiApps CF CLI插件，SAP Business Application Studio已经安装了这个插件。
• 在部署过程中，将创建所有需要的服务实例，并部署应用程序以及数据库工件。

3. 观察部署过程:
• 这个过程可能需要几分钟。在这一步中，档案被上传到Cloud Foundry，服务实例被创建，应用程序被准备，并部署到它们的目标运行时。
• 如果部署在部署bookstore-db-deployer时失败，请确保你的IP地址已配置为允许连接到SAP HANA Cloud。或者，你可以自行冒险允许所有IP地址的连接。我们建议在完成教程后恢复该设置。

4. 找到应用程序的URL:
• 在部署日志中，找到bookstore应用程序的URL：
• 这是AppRouter的URL，它强制执行身份验证流程。

5. 在浏览器中打开应用程序:
• 在浏览器中打开这个URL，并尝试提供的链接，例如.../catalog/Books。应用程序数据从SAP HANA中获取。
• 相应的路由可以在上一步的routes下找到。

6. 观察应用程序的安全性:
• 观察你的应用程序现在通过要求在服务和实体端点上进行身份验证来确保安全性。

在SAP BTP上配置身份验证和授权

参考