From 2a300b7965ac751a222e825fe079a59347a32ff9 Mon Sep 17 00:00:00 2001 From: Kai Brassel Date: Sun, 18 Apr 2021 11:28:10 +0200 Subject: [PATCH] Update HTML --- ParameterCatalogs.html | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/ParameterCatalogs.html b/ParameterCatalogs.html index e13e588..252aad3 100644 --- a/ParameterCatalogs.html +++ b/ParameterCatalogs.html @@ -790,10 +790,12 @@ E.g., a user could drag an electric system component from a catalog onto an INSE

How to Implement Parameter Catalogs with Eclipse

-

To build a new parameter catalog from scratch, we first have to understand some basics about Eclipse, and then install the correct Eclipse package. -Thereafter, we can model our data with Ecore considering some best practices, followed by the generation of Java classes and user interface (UI). -We, then, will add some plug-ins to "pimp" our Eclipse installation, (a) to enable deployment of parameter catalog applications, and (b) to add units and quantities to the mix. -Some hints on special modeling problems and versioning parameter catalogs conclude this how-to guide.

+

At the end of this chapter, you should be able to build a running software prototype for creating and maintaining parameter catalogs based on a graphical data model of the domain you are an expert in.

+
+
+

To build data models and parameter catalogs from scratch, we first have to understand some basics about Eclipse, and then install the correct Eclipse package. +Thereafter, we can model our data with Ecore considering some best practices, followed by the generation of Java classes and user interface (UI). +Finally, we will install some plug-ins to "pimp" our Eclipse installation in order to add units and quantities to the mix.

Eclipse Basics

@@ -834,11 +836,10 @@ Technically, a plug-in is just a special kind of Java archive (JAR file) that us Groups of plug-ins that belong together are called a feature.

-

Often, a user will add plug-ins or features to an Eclipse installation to add new capabilities. +

Sometimes, a user will add plug-ins or features to an Eclipse installation to add new capabilities. E.g. writing this documentation within my Eclipse IDE is facilitated by the plug-in Asciidoctor Editor. Plug-ins can easily be installed via main menu command Help → Eclipse Marketplace…​ or Help → Install New Software…​. -Some plug-ins may be self-made like our plug-in de.hftstuttgart.units that enables Ecore to deal with quantities. -These may be provided via Git or as download and have to be added to an Eclipse installation manually.

+Some plug-ins may be self-made like our City Units plug-in that enables Ecore to deal with physical quantities.

Git
@@ -929,14 +930,14 @@ That way, we can follow the convention that local Git repositories should all be
Install Java

Eclipse runs on 64-bit versions of Windows, Linux, and macOS and requires an according Java Development Kit (JDK), version 11 or higher, to be installed on your machine. -Even if such JDK already exists, please download OpenJDK, version 15 or newer for your operating system from AdoptOpenJDK. +Even if such JDK already exists, please download OpenJDK, version 16 or newer for your operating system from AdoptOpenJDK. [6] Choose HotSpot as Java Virtual Machine. Installation process is straight forward, but you can also find links to exhaustive instructions for your operating system.

New Java versions appear every six months, so one could tend to stick with older version 11 that comes with long time support (LTE) until next LTE version 17 arrives in autumn 2021. -However, actual version 15 conforms to the latest security measures built into macOS Catalina, so it is a must if software we build here shall be deployed to these systems, too.

+However, actual version 16 conforms to the latest security measures built into macOS Catalina, so it is a must if software we build here shall be deployed to these systems, too.

Note that different versions of Java coexist peacefully.

@@ -1076,7 +1077,7 @@ Since it is not always clear where names provided during modeling are used later

Base Package (reverse domain)[7]

org.example

-

hft-stuttgart.de

+

de.hftstuttgart

Main Package

@@ -1086,7 +1087,7 @@ Since it is not always clear where names provided during modeling are used later

Eclipse Project[8]

org.example.democatalog.model

-

de.hft-stuttgart.buildingphysics

+

de.hftstuttgart.buildingphysics

Class Prefix

@@ -1237,7 +1238,7 @@ Instead of artificial example classes like Foo and Bar it show
-28c119036261e39473751e5cb111acc9 +28c119036261e39473751e5cb111acc9
Figure 4. Principle Structure of a Parameter Catalog
@@ -2221,7 +2222,7 @@ Verify that Maven version 3.6.3 or above is now installed in Window →
-- GitLab