CIB doXiview - Integration

Optimierung zum laden der JavaScript-Ressourcen

In diesem Kapitel werden Details zu einem optimierten Deployment der benötigten JavaScript-Ressourcen erläutert.

In unserem Beispiel-Code wurde CIB iwc mit dem folgenden Script-Tag geladen:

<script type="text/javascript" src="lib-js/cib.iwc.1.0.0.min.js"></script>

Das vom Master genutzte Kommunikationsinterface wurde zusätzlich mit diesem Script-Tag geladen:

<script type="text/javascript" src="lib-js/cib.iwc.master.webview.js"></script>

Beide Ressourcen liegen hier innerhalb der (Master-)Anwendung als Kopie vor. Das ist einfach zu handhaben und Sie können die JavaScript-Ressourcen mit einem konstanten, relativen src-Pfad adressieren, den Sie daher nicht konfigurierbar halten müssen.

Falls eine größere Zahl von Webapplikationen im Unternehmen über CIB iwc kommuniziert, ist es effizienter, diese Ressourcen insgesamt nur einmal vom Browser laden zu lassen, statt von jeder Anwendung in Kopie.

Dies lässt sich erreichen, indem alle Anwendungen diese Ressourcen über dieselbe URL laden, etwa

<script type="text/javascript" 
src="http://mycompany.com/lib-js/cib.iwc.1.0.0.min.js"></script>

CIB doXiview sollte ebenfalls solche geteilten JavaScript-Ressourcen laden. Es kann in CIB doXiview konfiguriert werden, welche JavaScript-Dateien in welchem iwc-Modus (internal, standalone, external) geladen werden sollen.

Per Voreinstellung werden alle benötigten JavaScript-Dateien (JQuery, CIB iwc sowie die dazugehörigen Kommunikationsschnittstellen) aus CIB doXiview selbst geladen. Sofern es nicht gewünscht ist, die JavaScript-Ressourcen zentral bereit zu stellen, besteht demnach auch keine Notwendigkeit diese Konfiguration zu ändern.

Ansonsten geschieht dies durch Überschreiben der existierenden Standardeinstellungen, welche in der Datei default-config.properties definiert sind. Das Überschreiben der dort vorhandenen Einstellungen wird stets in der Datei environment-config.properties vorgenommen, welche sich im selben Verzeichnis befindet. Die Datei default-config.properties sollte nicht modifiziert werden.

Folgende Standardeinstellungen können überschrieben werden:

# Define jquery java script location
jquery=webview_gwt/jquery/jquery-1.11.1.min.js
 
# Define iwc core framework
iwc=webview_gwt/iwc/cib.iwc.1.0.0.min.js
 
# Define communicational adapters for iwc framework
iwc.interface=webview_gwt/iwc/iwc-interfaces-min.js
 
# Define iwc_mode java scripts and the default mode if no start parameter is used. (iwc_mode=external needs to be defined in environment-config.properties)
iwc.mode.standalone=${jquery}
iwc.mode.internal=${jquery},${iwc},${iwc.interface}
iwc.mode.default=INTERNAL

 

Die Konfiguration beschreibt die Quellen für JQuery, CIB iwc und allen Kommunikationsinterfaces für CIB iwc. Anschließend werden für die verschiedenen iwc.mode-Möglichkeiten die JavaScript-Dateien definiert, die im jeweiligen Modus von CIB doXiview geladen werden sollen.

In welchem Modus CIB doXiview arbeitet, wird per Startparameter an CIB doXiview übergeben.