cuba 平台_CUBA 7的新功能

cuba 平台

三年前，我们宣布了该框架的第二个公开可用的主要版本。 CUBA 6是改变游戏规则的版本–许可从专有转为Apache 2.0。那些日子，我们甚至无法猜测从长远来看它将把框架带到哪里。 CUBA社区开始呈指数级增长，因此我们了解了开发人员如何使用框架的许多可能（有时甚至是不可能的）方法。现在，我们很高兴地宣布CUBA 7 ，我们希望这将使所有社区成员（从刚开始CUBA和Java之旅的人到熟练的企业开发人员和Java专家）的开发工作都更加连贯和欢乐。

开发工具

显然，我们在很大程度上要归功于CUBA Studio 。它显着简化了过度使用的Java企业例程，在许多地方使它得以简化，从而在可视化设计器中进行了琐碎的配置：无需了解Persistence API或Gradle甚至是Spring来开发功能丰富的完整CRUD应用程序– Studio会做它给你。

Studio是一个单独的Web应用程序，这个事实造成了一些重大限制：

首先，Studio不是功能齐全的IDE，因此开发人员必须在Studio和IntelliJ IDEA或Eclipse之间切换才能开发业务逻辑，并得益于便捷的导航，代码完成和其他必不可少的事情，这很烦人。
其次，这种神奇的简单性是建立在大量源代码解析和生成之上的。改进代码生成功能将意味着朝着开发功能齐全的IDE的方向迈进。

我们决定靠另一巨头的肩膀克服这些局限。 Studio由JetBrains合并到IntelliJ IDEA中。现在，您可以将其作为IntelliJ IDEA的插件安装，也可以作为单独的独立捆绑包下载。

这开辟了新的视野：

其他JVM语言支持（首先是Kotlin）
改进的热部署
整个项目的直观导航
更智能的提示和代码生成器

目前，新Studio正在积极开发中：我们正在移植旧版本中的功能。短期计划还计划使用本地IntelliJ UI重新实现基于Web的设计器，并改善项目导航体验。

堆栈升级

传统上，基础堆栈也已进行了重大升级，例如Java 8/11，Vaadin 8，Spring 5。

默认情况下，新项目使用Java 8，但是您可以通过在build.gradle文件中添加以下子句来指定Java版本：

subprojects {sourceCompatibility = JavaVersion.VERSION_11targetCompatibility = JavaVersion.VERSION_11
}

由于Vaadin数据绑定API的重大突破性变化，升级到Vaadin 8是一个巨大的挑战。幸运的是，CUBA通过将Vaadin内部包装到自己的API层中，使开发人员从Vaadin内部抽象出来。 CUBA团队在重新实现内部结构方面做得很出色，保持了自己的API不变。这意味着完全可以保存兼容性，并且可以在将项目迁移到CUBA 7之后立即使用Vaadin 8，而无需进行任何重构。

官方发行说明中提供了更新后的依赖项的完整列表。

新屏幕API

此部分也可以称为“第一个屏幕API”，因为CUBA从未在Web客户端层中有任何正式声明的API。它来自框架的历史以及在第一阶段做出的某些假设：

以声明为中心的方法–可以以声明方式描述的所有内容，都应在屏幕描述符中声明，而不是在其控制器中进行编码

标准屏幕（浏览器和编辑器）提供了具体的通用功能，因此无需对其进行修改

自从第一千名成员加入我们的社区以来，我们意识到“标准” CRUD屏幕的要求范围之广–远远超出了最初设计的功能集。尽管如此，很长一段时间以来，即使没有API层，我们也能够处理自定义行为的请求-这要归功于另一个第一步假设-开放继承。有效地，“开放继承”意味着您可以覆盖基础类的任何公共方法或受保护方法，以根据需要调整其行为。这听起来似乎可以治愈所有疾病，但实际上它甚至都无法给您带来短期合同：如果重写的方法将被重命名，删除或在框架的未来版本中根本不使用怎么办？

@UiController("new-screen")  // screen id
public class NewScreen extends Screen {
}

从上面的示例中，我们可以看到屏幕标识符已在控制器类的上方明确定义。换句话说，屏幕ID和控制器类现在彼此唯一对应。因此，好消息是，现在可以通过其控制器类以安全的方式直接处理屏幕：

@Inject
private ScreenBuilders screenBuilders;@Subscribe
private void onBeforeClose(BeforeCloseEvent event) {screenBuilders.screen(this).withScreenClass(SomeConfirmationScreen.class).build().show();
}

屏幕描述符成为补充部分，而不是强制性的。可以以编程方式创建布局，也可以将其声明为XML屏幕描述符，该描述符由控制器类上的@UiDescriptor批注定义。这使控制器和布局更易于阅读和理解–这种方法与Android开发中使用的方法非常相似。

之前还需要在web-screens.xml文件中注册屏幕描述符并为其分配标识符。在CUBA 7中，由于兼容性原因而保留了该文件，但是，以新的方式创建屏幕不需要进行此类注册。

屏幕生命周期

新的API引入了清晰明了的屏幕生命周期事件：

在里面
初始化后
演出前
表演后
收盘前
收盘后

可以按以下方式订阅CUBA 7中所有与屏幕相关的事件：

@UiController("new-screen")
public class NewScreen extends Screen {@Subscribeprivate void onInit(InitEvent event) { }@Subscribeprivate void onBeforeShow(BeforeShowEvent event) {      }}

将新的API与旧的方法进行比较，您可以看到我们没有覆盖钩子方法，在父类的层次结构中模糊地调用了钩子方法，但是在屏幕生命周期的明确预定义点中定义了逻辑。

事件处理和功能代表

在上一节中，我们学习了如何订阅生命周期事件，那么其他组件呢？我们是否应该像6.x版本中那样将所有必需的侦听器分散在屏幕初始化上？新的API非常统一，因此订阅其他事件与生命周期绝对相似。

让我们以具有两个UI元素的简单示例为例：一个按钮和一个Currency字段，因此其XML描述符如下所示：

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<window xmlns="http://schemas.haulmont.com/cuba/screen/window.xsd"caption="msg://caption"messagesPack="com.company.demo.web"><layout><hbox spacing="true"><currencyField id="currencyField" currency="$"currencyLabelPosition="LEFT"/><button id="calcPriceBtn" caption="Calculate Price"/></hbox></layout>
</window>

通过单击按钮，我们将调用中间件服务返回一个数字，该数字将转到货币字段。货币字段应根据价格值更改其样式。

@UiController("demo_MyFirstScreen")
@UiDescriptor("my-first-screen.xml")
public class MyFirstScreen extends Screen {@Injectprivate PricingService pricingService;@Injectprivate CurrencyFieldcurrencyField;@Subscribe("calcPriceBtn")private void onCalcPriceBtnClick(Button.ClickEvent event) {currencyField.setValue(pricingService.calculatePrice());}@Subscribe("currencyField")private void onPriceChange(HasValue.ValueChangeEventevent) {BigDecimal price = pricingService.calculatePrice();currencyField.setStyleName(getStyleNameByPrice(price));}private String getStyleNameByPrice(BigDecimal price) {...}}

在上面的示例中，我们可以看到两个事件处理程序：一个事件处理程序在单击按钮时被调用，而另一个在货币字段更改其值时被执行-就这么简单。

现在，让我们想象一下，我们需要验证价格并检查其价格是否为正。直接的方法是在屏幕初始化时添加验证器：

@UiController("demo_MyFirstScreen")
@UiDescriptor("my-first-screen.xml")
public class MyFirstScreen extends Screen {@Injectprivate CurrencyField<BigDecimal> currencyField;@Subscribeprivate void onInit(InitEvent event) {currencyField.addValidator(value -> {if (value.compareTo(BigDecimal.ZERO) <= 0)throw new ValidationException("Price should be greater than zero");});}}

在现实世界的应用程序中，屏幕入口点通常会被此类屏幕元素初始化程序所丢弃。为了解决这个问题，CUBA提供了有用的注释@Install 。让我们看看它对我们的案例有何帮助：

@UiController("demo_MyFirstScreen")
@UiDescriptor("my-first-screen.xml")
public class MyFirstScreen extends Screen {@Injectprivate CurrencyField<BigDecimal> currencyField;@Install(to = "currencyField", subject = "validator")private void currencyFieldValidator(BigDecimal value) {if (value.compareTo(BigDecimal.ZERO) <= 0)throw new ValidationException("Price should be greater than zero");}}

实际上，我们将验证逻辑从货币字段委托给屏幕中的currencyFieldValidator方法。这可能看起来有些复杂，但是，开发人员以惊人的速度采用了此功能。

屏幕构建器/通知/对话框

CUBA 7还通过流畅的API引入了一组有用的组件：

ScreenBuilders结合了流利的工厂，以生成标准的查找，编辑器和自定义屏幕。以下示例显示了如何从另一个屏幕打开一个屏幕。注意， build（）方法返回正确类型的屏幕实例，而无需不安全地强制转换它。

CurrencyConversions currencyConversions = screenBuilders.screen(this).withScreenClass(CurrencyConversions.class).withLaunchMode(OpenMode.DIALOG).build();
currencyConversions.setBaseCurrency(Currency.EUR);
currencyConversions.show();

屏幕组件为创建和显示屏幕提供了较低层次的抽象，而不是ScreenBuilders 。如果需要进行遍历，它还提供对CUBA应用程序中所有打开的屏幕（ Screens＃getOpenedScreens ）的信息的访问。
通知和对话框组件都引入了方便的自说明界面。这是创建和显示对话框和通知的示例：

dialogs.createOptionDialog().withCaption("My first dialog").withMessage("Would you like to thank CUBA team?")
.withActions(new DialogAction(DialogAction.Type.YES).withHandler(e -> 
notifications.create().withCaption("Thank you!").withDescription("We appreciate all community members").withPosition(Notifications.Position.MIDDLE_CENTER).withHideDelayMs(3000).show()),new DialogAction(DialogAction.Type.CANCEL)
).show();

数据绑定

CUBA不仅可以通过提供具有广泛代码生成功能的高级可视化工具，还可以通过即用型的丰富数据感知组件集，来快速开发后台UI。这样的组件只需要知道它们使用什么数据，其余的将被自动管理，例如查找列表，选择器字段，带有CRUD操作的各种网格等等。

在版本7之前，数据绑定是通过所谓的数据源实现的-数据对象包装单个实体或实体集合，以将其与数据感知组件进行React性绑定。这种方法效果很好，但是在实现方面却是一个整体。整体架构通常会导致其自定义问题，因此在CUBA 7中，此坚固的巨石分为3个数据组件：

数据加载器是数据容器的数据提供者。数据加载器不保留数据，它们只是将所有必需的查询参数传递到数据存储区，并使用结果数据集提供数据容器。
数据容器保留加载的数据（单个实体或多个实体），并以React方式将其提供给数据感知组件：包装实体的所有更改都暴露给相应的UI组件，反之亦然， UI组件将导致其数据容器中的相应更改。
数据上下文是功能强大的数据修改管理器，可跟踪更改并提交所有修改的实体。可以将实体合并到数据上下文中，因此它将提供原始实体的副本，但具有唯一但非常重要的区别：对结果实体及其引用的所有实体（包括集合）的所有修改都将被跟踪，存储和相应地承诺。

数据组件可以在屏幕描述符中声明，也可以使用专门的工厂DataComponents以编程方式实例化。

杂

介绍了Ufff，它是新屏幕API的最重要部分，因此让我简要列出Web客户端层中的其他重要功能：

URL历史记录和导航 。此功能使用Web浏览器中的“返回”按钮解决了SPA的一个非常普遍的问题，提供了一种将路由分配给应用程序屏幕的简便方法，并使API能够在其URL中反映屏幕的当前状态。
窗体而不是FieldGroup。 FieldGroup是一个数据感知组件，用于显示和修改单个实体的字段。它推断在运行时为字段显示的实际UI。换句话说，如果您的实体中有一个Date字段，它将显示为DateField 。但是，如果您希望通过编程方式对此字段进行操作，则需要将该字段注入到屏幕控制器，然后手动将其强制转换为正确的类型（在我们的示例中为DateField ）。稍后，我们将字段类型更改为其他类型，并且应用程序在运行时崩溃……Form通过显式字段类型声明解决了此问题。在此处找到有关此新组件的更多信息。
第三方 JavaScript组件集成已大大简化，请按照文档将自定义JavaScript组件嵌入到CUBA应用程序中。
现在，可以从xml屏幕描述符中轻松定义HTML / CSS属性，也可以通过编程方式对其进行设置。在此处查找更多信息。

中间件功能

之前有关新屏幕API的内容超出了我的预期，因此在本节中，我将力求简洁！

实体变更事件

实体更改事件是Spring应用程序事件，当您的实体进入数据存储，被物理插入并距离提交不到一英寸时，将触发该事件。在这里，您可以提供一些附加检查（例如，在确认订单之前检查库存中的产品可用性），并在其他交易将其可见之前（当然，已读取提交的隔离级别）对其进行修改（例如，重新计算总计）。您还可以将此事件用作通过抛出异常来中断事务提交的最后机会–这在某些特殊情况下可能很有用。

还有一种在提交发生后立即捕获实体更改事件的方法。

请遵循文档的本章以查看示例。