Commit 2a300b79 authored by Kai-Holger Brassel's avatar Kai-Holger Brassel
Browse files

Update HTML

parent 98147856
Pipeline #2828 passed with stage
in 15 seconds
......@@ -790,10 +790,12 @@ E.g., a user could drag an electric system component from a catalog onto an INSE
<h2 id="truehow-to-implement-parameter-catalogs-with-eclipse"><a class="anchor" href="#truehow-to-implement-parameter-catalogs-with-eclipse"></a>How to Implement Parameter Catalogs with Eclipse</h2>
<div class="sectionbody">
<div class="paragraph">
<p>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.</p>
<p>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.</p>
</div>
<div class="paragraph">
<p>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 <em>Ecore</em> 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.</p>
</div>
<div class="sect2">
<h3 id="trueeclipse-basics"><a class="anchor" href="#trueeclipse-basics"></a>Eclipse Basics</h3>
......@@ -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 <em>feature</em>.</p>
</div>
<div class="paragraph">
<p>Often, a user will add plug-ins or features to an Eclipse installation to add new capabilities.
<p>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 <a href="https://marketplace.eclipse.org/content/asciidoctor-editor">Asciidoctor Editor</a>.
Plug-ins can easily be installed via main menu command <code>Help → Eclipse Marketplace&#8230;&#8203;</code> or <code>Help → Install New Software&#8230;&#8203;</code>.
Some plug-ins may be self-made like our plug-in <code>de.hftstuttgart.units</code> that enables Ecore to deal with quantities.
These may be provided via <em>Git</em> or as download and have to be added to an Eclipse installation manually.</p>
Some plug-ins may be self-made like our <em>City Units</em> plug-in that enables Ecore to deal with physical quantities.</p>
</div>
<div class="paragraph">
<div class="title">Git</div>
......@@ -929,14 +930,14 @@ That way, we can follow the convention that local Git repositories should all be
<div class="paragraph">
<div class="title">Install Java</div>
<p>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 <strong>15</strong> or newer for your operating system from <a href="https://adoptopenjdk.net">AdoptOpenJDK</a>.
Even if such JDK already exists, please download OpenJDK, version <strong>16</strong> or newer for your operating system from <a href="https://adoptopenjdk.net">AdoptOpenJDK</a>.
<sup class="footnote">[<a id="_footnoteref_6" class="footnote" href="#_footnotedef_6" title="View footnote.">6</a>]</sup>
Choose <code>HotSpot</code> as Java Virtual Machine.
Installation process is straight forward, but you can also find links to exhaustive instructions for your operating system.</p>
</div>
<div class="paragraph">
<p>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.</p>
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.</p>
</div>
<div class="paragraph">
<p>Note that different versions of Java coexist peacefully.</p>
......@@ -1076,7 +1077,7 @@ Since it is not always clear where names provided during modeling are used later
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Base Package (reverse domain)<sup class="footnote">[<a id="_footnoteref_7" class="footnote" href="#_footnotedef_7" title="View footnote.">7</a>]</sup></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">org.example</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">hft-stuttgart.de</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">de.hftstuttgart</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Main Package</p></td>
......@@ -1086,7 +1087,7 @@ Since it is not always clear where names provided during modeling are used later
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Eclipse Project<sup class="footnote">[<a id="_footnoteref_8" class="footnote" href="#_footnotedef_8" title="View footnote.">8</a>]</sup></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">org.example.democatalog.model</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">de.hft-stuttgart.buildingphysics</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">de.hftstuttgart.buildingphysics</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Class Prefix</p></td>
......@@ -1237,7 +1238,7 @@ Instead of artificial example classes like <em>Foo</em> and <em>Bar</em> it show
</div>
<div class="imageblock thumb">
<div class="content">
<img src="http://localhost:52486/afx/cache/28c119036261e39473751e5cb111acc9.png" alt="28c119036261e39473751e5cb111acc9">
<img src="http://localhost:53031/afx/cache/28c119036261e39473751e5cb111acc9.png" alt="28c119036261e39473751e5cb111acc9">
</div>
<div class="title">Figure 4. Principle Structure of a Parameter Catalog</div>
</div>
......@@ -2221,7 +2222,7 @@ Verify that Maven version 3.6.3 or above is now installed in <code>Window &#8594
</div>
<div id="footer">
<div id="footer-text">
Last updated 2021-04-18 10:06:04 +0200
Last updated 2021-04-18 11:27:10 +0200
</div>
</div>
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.15.6/styles/github.min.css">
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment