當(dāng)前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

cuba_CUBA 7的新功能

發(fā)布時(shí)間：2023/12/20 编程问答 34 豆豆

生活随笔收集整理的這篇文章主要介紹了 cuba_CUBA 7的新功能小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,幫大家做個(gè)參考.

cuba

三年前，我們宣布了該框架的第二個(gè)公開可用的主要版本。 CUBA 6是改變游戲規(guī)則的版本–許可從專有轉(zhuǎn)為Apache 2.0。那些日子，我們甚至無法猜測從長遠(yuǎn)來看它將把框架帶到哪里。 CUBA社區(qū)開始呈指數(shù)增長，因此我們了解了開發(fā)人員如何使用框架的許多可能(有時(shí)甚至是不可能)的方法。現(xiàn)在，我們很高興地宣布CUBA 7 ，我們希望它將使所有社區(qū)成員(從剛開始CUBA和Java之旅的人，到熟練的企業(yè)開發(fā)人員和Java專家)的開發(fā)工作更加連貫和歡樂。

開發(fā)工具

顯然，我們在很大程度上要?dú)w功于CUBA Studio 。它顯著簡化了過度使用的Java企業(yè)例程，在許多地方使它得以簡化，從而在可視化設(shè)計(jì)器中進(jìn)行了瑣碎的配置：無需了解Persistence API或Gradle甚至是Spring來開發(fā)功能豐富的完整CRUD應(yīng)用程序– Studio會(huì)做的它給你。

Studio是一個(gè)單獨(dú)的Web應(yīng)用程序，這個(gè)事實(shí)造成了一些重大限制：

首先，Studio并不是功能齊全的IDE，因此開發(fā)人員必須在Studio和IntelliJ IDEA或Eclipse之間切換才能開發(fā)業(yè)務(wù)邏輯，并從便利的導(dǎo)航，代碼完成和其他必要的事情中受益，這很煩人。
其次，這種神奇的簡單性是建立在大量源代碼解析和生成之上的。改進(jìn)代碼生成功能將意味著朝著開發(fā)功能齊全的IDE的方向邁進(jìn)。

我們決定靠另一巨頭的肩膀來克服這些限制。 Studio由JetBrains合并到IntelliJ IDEA中。現(xiàn)在，您可以將其作為IntelliJ IDEA的插件安裝，也可以作為單獨(dú)的獨(dú)立捆綁包下載。

這開辟了新的視野：

其他JVM語言支持(首先是Kotlin)
改進(jìn)的熱部署
整個(gè)項(xiàng)目的直觀導(dǎo)航
更智能的提示和代碼生成器

目前，新Studio正在積極開發(fā)中：我們正在移植舊版本中的功能。短期計(jì)劃還計(jì)劃使用本地IntelliJ UI重新實(shí)現(xiàn)基于Web的設(shè)計(jì)器，并改善項(xiàng)目導(dǎo)航體驗(yàn)。

堆棧升級

傳統(tǒng)上，基礎(chǔ)堆棧也已進(jìn)行了重大升級，例如Java 8/11，Vaadin 8，Spring 5。

默認(rèn)情況下，新項(xiàng)目使用Java 8，但是您可以通過在build.gradle文件中添加以下子句來指定Java版本：

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

由于Vaadin數(shù)據(jù)綁定API的重大突破性變化，升級到Vaadin 8是一個(gè)巨大的挑戰(zhàn)。幸運(yùn)的是，CUBA通過將Vaadin內(nèi)部包裝到自己的API層中，從而使開發(fā)人員從Vaadin內(nèi)部抽象出來。 CUBA團(tuán)隊(duì)在重新實(shí)現(xiàn)內(nèi)部結(jié)構(gòu)方面做得很出色，保持了自己的API不變。這意味著完全可以保存兼容性，并且可以在不進(jìn)行任何重構(gòu)的情況下將項(xiàng)目遷移到CUBA 7后立即從Vaadin 8中受益。

官方發(fā)行說明中提供了更新后的依賴項(xiàng)的完整列表。

新屏幕API

此部分也可以稱為“第一個(gè)屏幕API”，因?yàn)镃UBA從未在Web客戶端層中有任何正式聲明的API。它來自框架的歷史以及在第一階段做出的某些假設(shè)：

以聲明為中心的方法–可以以聲明方式描述的所有內(nèi)容，都應(yīng)在屏幕描述符中聲明，而不是在其控制器中進(jìn)行編碼

標(biāo)準(zhǔn)屏幕(瀏覽器和編輯器)提供了具體的通用功能，因此無需對其進(jìn)行修改

自從第一千名成員加入我們的社區(qū)以來，我們意識到“標(biāo)準(zhǔn)” CRUD屏幕的要求范圍之廣–遠(yuǎn)遠(yuǎn)超出了最初設(shè)計(jì)的功能集。盡管如此，很長一段時(shí)間以來，即使沒有API層，我們也能夠處理自定義行為的請求-這要?dú)w功于另一個(gè)第一步假設(shè)-開放繼承。有效地，“開放繼承”意味著您可以覆蓋基礎(chǔ)類的任何公共或受保護(hù)方法，以根據(jù)需要調(diào)整其行為。這聽起來似乎可以治愈所有疾病，但實(shí)際上它甚至都無法給您帶來短期合同：如果重寫的方法將被重命名，刪除或在框架的未來版本中根本不使用怎么辦？

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

從上面的示例中，我們可以看到屏幕標(biāo)識符已在控制器類的上方明確定義。換句話說，屏幕ID和控制器類現(xiàn)在彼此唯一對應(yīng)。因此，好消息是，現(xiàn)在可以通過其控制器類以安全的方式直接處理屏幕：

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

屏幕描述符成為補(bǔ)充部分，而不是強(qiáng)制性的。可以以編程方式創(chuàng)建布局，也可以將其聲明為XML屏幕描述符，該描述符由控制器類上的@UiDescriptor批注定義。這使控制器和布局更易于閱讀和理解–這種方法與Android開發(fā)中使用的方法非常相似。

之前還需要在web-screens.xml文件中注冊屏幕描述符并為其分配標(biāo)識符。在CUBA 7中，由于兼容性原因而保留了該文件，但是，以新的方式創(chuàng)建屏幕不需要進(jìn)行此類注冊。

屏幕生命周期

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

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

可以按以下方式訂閱CUBA 7中與屏幕有關(guān)的所有事件：

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

將新的API與舊的方法進(jìn)行比較，您可以看到我們沒有覆蓋鉤子方法，在父類的層次結(jié)構(gòu)中模糊地調(diào)用了鉤子方法，但是在屏幕生命周期的明確預(yù)定義點(diǎn)中定義了邏輯。

事件處理和功能代表

在上一節(jié)中，我們學(xué)習(xí)了如何訂閱生命周期事件，那么其他組件呢？我們是否應(yīng)該像6.x版本中那樣將所有必需的偵聽器分散在屏幕初始化上？新的API非常統(tǒng)一，因此訂閱其他事件與生命周期絕對相似。

讓我們以具有兩個(gè)UI元素的簡單示例為例：一個(gè)按鈕和一個(gè)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>

通過單擊按鈕，我們將調(diào)用中間件服務(wù)返回一個(gè)數(shù)字，該數(shù)字將轉(zhuǎn)到貨幣字段。貨幣字段應(yīng)根據(jù)價(jià)格值更改其樣式。

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

在上面的示例中，我們可以看到兩個(gè)事件處理程序：一個(gè)事件處理程序在單擊按鈕時(shí)被調(diào)用，另一個(gè)事件處理程序在currency字段更改其值時(shí)被執(zhí)行-就這么簡單。

現(xiàn)在，讓我們假設(shè)我們需要驗(yàn)證價(jià)格并檢查其價(jià)格是否為正。直接的方法是在屏幕初始化時(shí)添加驗(yàn)證器：

@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");});}}

在現(xiàn)實(shí)世界的應(yīng)用程序中，屏幕入口點(diǎn)通常會(huì)被此類屏幕元素初始化程序所丟棄。為了解決此問題，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");}}

實(shí)際上，我們將驗(yàn)證邏輯從貨幣字段委派給屏幕中的currencyFieldValidator方法。這可能看起來有些復(fù)雜，但是，開發(fā)人員以驚人的速度采用了此功能。

屏幕構(gòu)建器/通知/對話框

CUBA 7還通過流暢的API引入了一組有用的組件：

ScreenBuilders結(jié)合了流利的工廠來生成標(biāo)準(zhǔn)的查找，編輯器和自定義屏幕。以下示例顯示了如何從另一個(gè)屏幕打開一個(gè)屏幕。注意， build()方法返回正確類型的屏幕實(shí)例，而無需不安全地強(qiáng)制轉(zhuǎn)換它。

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

屏幕組件為創(chuàng)建和顯示屏幕提供了較低層次的抽象，而不是ScreenBuilders 。如果需要迭代它們，它還提供對CUBA應(yīng)用程序中所有打開的屏幕的信息( Screens＃getOpenedScreens )的訪問。
通知和對話框組件都引入了方便的自說明界面。這是創(chuàng)建和顯示對話框和通知的示例：

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();

數(shù)據(jù)綁定

CUBA不僅通過提供具有廣泛代碼生成功能的高級可視化工具，而且還通過立即可用的豐富的數(shù)據(jù)感知組件集，來實(shí)現(xiàn)后臺UI的極快開發(fā)。這樣的組件只需要知道它們使用什么數(shù)據(jù)，其余的將被自動(dòng)管理，例如查找列表，選擇器字段，具有CRUD操作的各種網(wǎng)格等等。

在版本7之前，數(shù)據(jù)綁定是通過所謂的數(shù)據(jù)源實(shí)現(xiàn)的-數(shù)據(jù)對象包裝單個(gè)實(shí)體或?qū)嶓w集合，以將其與數(shù)據(jù)感知組件進(jìn)行React性綁定。這種方法效果很好，但是在實(shí)現(xiàn)方面卻是一個(gè)整體。整體式架構(gòu)通常會(huì)導(dǎo)致其自定義問題，因此在CUBA 7中，這種堅(jiān)固的巨石被分為3個(gè)數(shù)據(jù)組件：

數(shù)據(jù)加載器是數(shù)據(jù)容器的數(shù)據(jù)提供者。數(shù)據(jù)加載器不保留數(shù)據(jù)，它們只是將所有必需的查詢參數(shù)傳遞到數(shù)據(jù)存儲區(qū)，并使用結(jié)果數(shù)據(jù)集提供數(shù)據(jù)容器。
數(shù)據(jù)容器保留加載的數(shù)據(jù)(單個(gè)實(shí)體或多個(gè)實(shí)體)，并以React方式將其提供給數(shù)據(jù)感知組件：包裝實(shí)體的所有更改都暴露給相應(yīng)的UI組件，反之亦然， UI組件將導(dǎo)致其數(shù)據(jù)容器中的相應(yīng)更改。
數(shù)據(jù)上下文是功能強(qiáng)大的數(shù)據(jù)修改管理器，可跟蹤更改并提交所有修改的實(shí)體。實(shí)體可以合并到數(shù)據(jù)上下文中，因此它將提供原始實(shí)體的副本，但唯一但非常重要的區(qū)別是：將跟蹤，存儲和修改對所得實(shí)體及其引用的所有實(shí)體(包括集合)的所有修改作出相應(yīng)的承諾。

數(shù)據(jù)組件可以在屏幕描述符中聲明，也可以使用專門的工廠DataComponents以編程方式實(shí)例化。

雜

介紹了Ufff，它是新屏幕API的最重要部分，因此讓我簡要列出Web客戶端層中的其他重要功能：

URL歷史記錄和導(dǎo)航。此功能通過Web瀏覽器中的“返回”按鈕解決了SPA的一個(gè)非常普遍的問題，提供了一種將路由分配給應(yīng)用程序屏幕的簡便方法，并使API能夠在其URL中反映屏幕的當(dāng)前狀態(tài)。
窗體而不是FieldGroup。 FieldGroup是一個(gè)數(shù)據(jù)感知組件，用于顯示和修改單個(gè)實(shí)體的字段。它推斷運(yùn)行時(shí)為字段顯示的實(shí)際UI。換句話說，如果您的實(shí)體中有一個(gè)Date字段，它將顯示為DateField 。但是，如果您希望通過編程方式使用此字段，則需要將該字段注入到屏幕控制器，然后手動(dòng)將其強(qiáng)制轉(zhuǎn)換為正確的類型(在我們的示例中為DateField )。稍后，我們將字段類型更改為其他類型，并且應(yīng)用程序在運(yùn)行時(shí)崩潰……Form通過顯式字段類型聲明解決了此問題。在此處找到有關(guān)此新組件的更多信息。
第三方JavaScript組件的集成已大大簡化，請按照文檔將自定義JavaScript組件嵌入到CUBA應(yīng)用程序中。
現(xiàn)在，可以直接從xml屏幕描述符中定義HTML / CSS屬性，也可以通過編程方式對其進(jìn)行設(shè)置。在此處查找更多信息。

中間件功能

之前有關(guān)新屏幕API的內(nèi)容比我預(yù)期的要大，因此在本節(jié)中，我將力求簡潔！

實(shí)體變更事件

實(shí)體更改事件是Spring應(yīng)用程序事件，當(dāng)您的實(shí)體進(jìn)入數(shù)據(jù)存儲，被物理插入并距離提交一英寸以內(nèi)時(shí)，將觸發(fā)該事件。在這里，您可以提供一些附加檢查(例如，在確認(rèn)訂單之前檢查庫存中的產(chǎn)品可用性)，并在其他交易將其可見之前(當(dāng)然，已讀取提交的隔離級別)對其進(jìn)行修改(例如，重新計(jì)算總計(jì))。您還可以將此事件用作通過拋出異常來中斷提交事務(wù)的最后機(jī)會(huì)–在某些特殊情況下可能很有用。

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

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

交易數(shù)據(jù)管理器

在開發(fā)應(yīng)用程序時(shí)，我們通常使用分離的實(shí)體(即不受任何事務(wù)管理的實(shí)體)進(jìn)行操作。但是，并非總是可以使用分離的實(shí)體，尤其是在嘗試滿足ACID要求時(shí)-可以使用事務(wù)數(shù)據(jù)管理器時(shí)就是這種情況。它看起來與普通數(shù)據(jù)管理器非常相似，但在以下方面有所不同：

它可以加入現(xiàn)有事務(wù)(如果在事務(wù)上下文中被調(diào)用)或創(chuàng)建自己的事務(wù)。
它沒有提交方法，但是有保存方法，它不會(huì)導(dǎo)致立即提交，但要等到附加的事務(wù)被提交后再進(jìn)行。

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

JPA生命周期回調(diào)

最后，CUBA 7支持JPA生命周期回調(diào)。為了不復(fù)制有關(guān)這些回調(diào)的用途的寫得很好的信息，讓我分享一下此鏈接，該鏈接完全涵蓋了該主題。

兼容性呢？

對于任何主要發(fā)行版，這都是一個(gè)公平的問題，尤其是當(dāng)有許多看似重大的更改時(shí)！我們在設(shè)計(jì)所有這些新功能和API時(shí)都考慮了向后兼容性：

CUBA 7支持舊的屏幕API，并通過幕后的新屏幕API實(shí)現(xiàn)：)
我們還提供了用于舊數(shù)據(jù)綁定的適配器，這些適配器可繼續(xù)用于舊屏幕。

因此，好消息是，從版本6到版本7的遷移路徑應(yīng)該非常簡單。

結(jié)論

在結(jié)束本技術(shù)概述時(shí)，我想提到還有其他重要的創(chuàng)新，尤其是在許可方面：

Studio的10個(gè)實(shí)體限制現(xiàn)已消失
現(xiàn)在免費(fèi)提供報(bào)告，BPM，圖表和地圖以及全文搜索插件。
Studio的商業(yè)版本為實(shí)體，屏幕，菜單和其他平臺元素的可視化設(shè)計(jì)師帶來了額外的開發(fā)舒適度，而免費(fèi)版本則專注于使用代碼
請注意，對于6.x和更早版本的Platform和Studio許可條款保持不變！

最后，讓我再次感謝社區(qū)成員的所有支持和反饋。希望您會(huì)喜歡版本7！更改的完整列表通常在發(fā)行說明中提供。

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