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_11
   targetCompatibility = 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 {
   
   @Subscribe
   private void onInit(InitEvent event) { 
   }
   
   @Subscribe
   private 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 {

   @Inject
   private PricingService pricingService;

   @Inject
   private CurrencyField
   
   
    
     currencyField;

   @Subscribe("calcPriceBtn")
   private void onCalcPriceBtnClick(Button.ClickEvent event) {
       currencyField.setValue(pricingService.calculatePrice());
   }

   @Subscribe("currencyField")
   private void onPriceChange(HasValue.ValueChangeEvent
    
    
     
      event) {
       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 {

   @Inject
   private CurrencyField<BigDecimal> currencyField;

   @Subscribe
   private 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 {

   @Inject
   private 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 平台