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) {...}}

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

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

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

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

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

交易数据管理器

在开发应用程序时，我们通常使用分离的实体(即不受任何事务管理的实体)进行操作。但是，并非总是可以使用分离的实体，尤其是在尝试满足ACID要求时-可以使用事务数据管理器时就是这种情况。它看起来与普通数据管理器非常相似，但在以下方面有所不同：

它可以加入现有事务(如果在事务上下文中被调用)或创建自己的事务。
它没有提交方法，但是有保存方法，它不会导致立即提交，但要等到附加的事务被提交后再进行。

在此处找到使用它的示例。

JPA生命周期回调

最后，CUBA 7支持JPA生命周期回调。为了不复制有关这些回调的用途的写得很好的信息，让我分享一下此链接，该链接完全涵盖了该主题。

兼容性呢？

对于任何主要发行版，这都是一个公平的问题，尤其是当有许多看似重大的更改时！我们在设计所有这些新功能和API时都考虑了向后兼容性：

CUBA 7支持旧的屏幕API，并通过幕后的新屏幕API实现：)
我们还提供了用于旧数据绑定的适配器，这些适配器可继续用于旧屏幕。

因此，好消息是，从版本6到版本7的迁移路径应该非常简单。

结论

在结束本技术概述时，我想提到还有其他重要的创新，尤其是在许可方面：

Studio的10个实体限制现已消失
现在免费提供报告，BPM，图表和地图以及全文搜索插件。
Studio的商业版本为实体，屏幕，菜单和其他平台元素的可视化设计师带来了额外的开发舒适度，而免费版本则专注于使用代码
请注意，对于6.x和更早版本的Platform和Studio许可条款保持不变！

最后，让我再次感谢社区成员的所有支持和反馈。希望您会喜欢版本7！更改的完整列表通常在发行说明中提供。

翻译自: https://www.javacodegeeks.com/2019/04/whats-new-cuba-7.html

cuba