Skip to content
This repository has been archived by the owner on Jan 16, 2024. It is now read-only.

UI metadata files. Base Concepts

Jump to bottom
abratashev edited this page Feb 4, 2020 · 3 revisions

image

Liquibase migrations

Tesler profides custom liquibase migrations defined in package \tesler\tesler-liquibase\src\main\java\liquibase\ext\tesler\ui\load This migrations allows to load ui components (such as screen, view, or widget) into database in form of .json files.

  • Widget migration called tesler:widgetload
  • View migration called tesler:viewload
  • Screen migration called tesler:screenload

XSD to specify new migration tags located in tesler\tesler-liquibase\src\main\resources\liquibase\ext\tesler\tesler.xsd

Usage example can be found in archetype module: \tesler\tesler-archetypes\tesler-base-archetype\src\main\resources\archetype-resources\__rootArtifactId__-db\src\main\resources\db\migration\liquibase\latest\widgets\widgets.xml

All migrations provides following properties:

  • path - resource path where .json files can be found
  • filter - Regexp mask to search for files. The following regexp is recommended: ".*.type_of_data.json$"
  • recursive - a boolean flag that indicates to look in subdirectories

the structure of .json files is described on the following wiki pages:

REST controllers

When application starts, user can receive metadata from a Spring REST controller called io.tesler.core.controller.LoginController.

What’s New in Tesler Helper 1.1 plugin for IntelliJ Idea

Key updates

New view.json inlay widget information

New screen.json inlay view information

New sql widget bc , fields autocompletion, glutter icon, inspection and quick-fix

New inspection: view url correctness

New inspections:

  • widget layout field key not defined or hidden in fields
  • view is never used, widget is never used
  • view has duplicate widgetName
  • widget field key duplicate

Improvements:

  • popupBc widget is created with quick-fix, if no existing widget can be found
  • improved performance, when inspections are started for the whole project
  • widget, view and screen names with whitespaces are supported

Fixes:

  • concurrency problems, when multiple ides are opened
  • "picklist bc to popup widget" inspection is now triggered only for fields with type "picklist"

We introduce Tesler Helper 1.0 plugin for IntelliJ Idea!

Navigation, autocompletion

.widget.json bc glutter icon, autocomplete, inspection, navigation to java code and quick-fix

.widget.json fields key glutter icon, autocomplete, inspection, navigation to java dto and quick-fix

bc enum glutter icon or ctl-click navigation to usages in .widget.json files

dto fields glutter icon navigation to usages in .widget.json files

.widget.json ctl-click on name for navigation to usages in .view.json files

.view.json glutter icon or ctl-click on wigdetName navigation to usages in widget.json files

.screen.json glutter icon or ctl-click on viewName navigation to usages in view.json files

Additional inspections

.widget.json inspection for case, when non-hidden filed is added in fields tag, but not added to layout. quick-fix - auto add to layout

.widget.json inspection for case, when name tag + '.widget.json' and widget file name are not equal. Quick-fix - rename file

.view.json inspection for case, when name tag + '.view.json' and view file name are not equal. Quick-fix - rename file

.screen.json inspection for case, when name tag + '.screen.json' and screen file name are not equal. Quick-fix - rename file

Picklist

.widget.json field of type "pickList" support - PopupBcName autocomplete, navigation, inspection and quick-fix

.widget.json field of type "pickList" support - pickMap left side autocomplete, navigation, inspection and quick-fix

.widget.json field of type "pickList" support - pickMap right side autocomplete, navigation, inspection and quick-fix

.widget.json field of type "pickList" support - PopupBcNameglutter icon to navigate to widget of this bc that will be open in UI (e.g. widget on same view as main widget view).

.widget.json field of type "pickList" support - inspection to check if PopupBcName widget is not added to main widget view

What’s New in Tesler 3.0.3

Key updates

(Draft) simplified views to roles mapping (video)

Alt Text

Previously you needed to fill the responsibilities table with liquibase. It was a rather complicated RESPONSIBILITIES.sql file. Now we introduce tesler.meta.view-allowed-roles-enabled = true property, that switch tesler to auto-loading data in responsibilities table based on new "rolesAllowed": [] tag in .view.json file. source code

commonScreens.json

Now commonScreens.json can be deleted from your project if you do not use it. Fill free to make your codebase cleaner =)

Simplified demo project structure (video)

Alt Text

We introduce a simplified "classic" project structure in our demo source code

Spring Data Jpa repository example of usage with Tesler (video)

Alt Text

We provided an example of using "spring data jpa" repository instead of tesler baseDao/jpaDao source code

Simplified tesler data model (video)

Alt Text

Total number of db tables in tesler decreased by ~50% (from 64 to 34)!

Tesler archetype replaced with tesler-demo

In this release we temporarily replace tesler archetype with tesler-demo. In future releases tesler-demo is going to be converted back to tesler archetype source code

Other changes

See CHANGELOG

What’s New in Tesler 3.0.0-3.0.2

Key updates

Debug mode (video)

Alt Text

During local development, one can now determine any widget name with a few clicks. Determine the widget you see on the screen and find it in your ide in a few seconds

Hot-reload meta (video)

Alt Text

During local development, one can now change metafiles in IDE and view changes in the browser in a few seconds without app restart/rebuild. It is recommended to be used only with local DB.

Tester-starter-parent

Alt Text

We introduce tester-starter-parent

<parent>
  <groupId>io.tesler</groupId>
  <artifactId>tesler-starter-parent</artifactId>
  <version>3.0.2</version>
</parent>

Its parent is spring-boot-starter-parent, so you get all benefits of spring-boot-starter-parent now.

When one generates project with https://start.spring.io/ , then spring-boot-starter-parent is used to ease dependency management. Lots of libraries are already tested and we've got their compatible versions listed in spring-boot-starter-parent. No jar hell problems, easy upgrade to new spring version, and so on.

Enums (video)

Alt Text

Enums are now first-class citizens in Tesler. One should consider enums as a strongly typed alternative to LOV's. What does "strongly typed" mean for developers? The compiler now helps you to make fewer mistakes. IDE helps you with autocompletion and highlighting problems before compilation. No liquibase/csv changes are needed to add/edit enum, and so on and so on.

We now recommend you to use LOVs only if you are absolutely sure, that you will need the ability to change dictionaries directly in production. Always use enums now, if your java business logic uses some dictionary (e.g. you cannot change dictionary in production, because this will break your logic). In all other cases, we suggest you use enums too

Archetype simple start

Generate project from archetype: mvn archetype:generate -DarchetypeGroupId='io.tesler' -DarchetypeArtifactId='tesler-simple-archetype' -DarchetypeVersion='3.0.2' -DgroupId='groupId1' -DartifactId='artifactId1' -Dversion='1.0.0'

Then run 3 commands from readme.md. That is all. The app is ready!

We included a docker-compose file with all needed infrastructure (keycloak, Postgres). So you do not need to pre-install or configure anything now

Archetype and your favorite IDE (video)

Alt Text

We refactored archetype to support rebuild and start backend directly with IDE

Previously we suggested building and starting the app during local development with maven. But for most cases it is much faster to build/start the app with IDE (for example IntelliJ IDEA "knows" what files the developer has changed and can incrementally recompile only them. Which is extremely faster for huge projects)

Springboot 2.5.1

We do not want to be legacy upgraded spring-boot to 2.5.1.

Other changes

See CHANGELOG

Clone this wiki locally