當前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

cuba 平台_CUBA 7的新功能

發布時間：2023/12/3 编程问答 66 豆豆

生活随笔收集整理的這篇文章主要介紹了 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應用程序事件，當您的實體進入數據存儲，被物理插入并距離提交不到一英寸時，將觸發該事件。在這里，您可以提供一些附加檢查（例如，在確認訂單之前檢查庫存中的產品可用性），并在其他交易將其可見之前（當然，已讀取提交的隔離級別）對其進行修改（例如，重新計算總計）。您還可以將此事件用作通過拋出異常來中斷事務提交的最后機會–這在某些特殊情況下可能很有用。

還有一種在提交發生后立即捕獲實體更改事件的方法。

請遵循文檔的本章以查看示例。

交易數據管理器

在開發應用程序時，我們通常使用分離的實體（即不受任何事務管理的實體）進行操作。但是，并非總是可以使用分離的實體，尤其是在嘗試滿足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