Schnellstart
Diese Seite zeigt den kürzesten Weg zu einer ersten lauffähigen Integration und was danach vor dem Produktivbetrieb noch zu tun ist.
1. Frontend wählen
Das jadice web toolkit besteht aus einem Java-Server auf Basis von Spring Boot und einem Frontend im Browser. Für das Frontend gibt es zwei Varianten:
| Frontend | Geeignet für | Einstieg |
|---|---|---|
| TypeScript/Angular | Neue Integrationen in Angular-Anwendungen | Getting started (Angular) |
| GWT | Bestehende GWT-Integrationen, voller Funktionsumfang | Frontend (GWT) |
Das TypeScript-Frontend hat nicht denselben Funktionsumfang wie das GWT-Frontend, siehe Known Issues / Limitations.
2. Zugang und Lizenz
- Für die Maven- und npm-Artefakte benötigen Sie einen Account für das levigo-Repository. Diesen erhalten Sie über den jadice support.
- Die Lizenzdatei
License.propertiesmuss auf dem Klassenpfad der Integration liegen.
3. Server aufsetzen
Binden Sie die BOM und den Spring-Boot-Starter in die pom.xml ein:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.levigo.jadice.webtoolkit</groupId>
<artifactId>webtoolkit-bom</artifactId>
<version>${webtoolkit.version}</version>
<scope>import</scope>
<type>pom</type>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>com.levigo.jadice.webtoolkit</groupId>
<artifactId>webtoolkit-spring-boot-starter</artifactId>
</dependency>
</dependencies>
Aktivieren Sie das jadice web toolkit in der Spring-Boot-Anwendung mit
@EnableJWTSpringBootApplication und stellen Sie Dokumente über einen DocumentDataProvider
bereit, der als @Component automatisch registriert wird. Details:
4. Tutorials und Beispielcode
Die Tutorials bauen schrittweise eine Integration auf, vom leeren Projekt bis zu eigenen Commands:
- Getting-Started-Tutorials (GWT), Beispielcode auf GitHub
- Getting Started (Angular)
- Weitere Getting-Started-Artikel in der Knowledge-Base, u. a. zu Docker-Images und Performancetests
Die Beispielanwendungen zeigen den Funktionsumfang im Einsatz.
5. Vor dem Produktivbetrieb
Eine Integration, die auf einer einzelnen Instanz einwandfrei läuft, ist noch nicht für den Produktivbetrieb vorbereitet. Mehrere Instanzen ohne Session Affinity, fehlende Container-Limits oder ein zu kleiner Cache fallen erst unter Last auf.
Gehen Sie vor der Inbetriebnahme die Checkliste Produktivbetrieb durch. Sie verweist auf die Kapitel zu Dimensionierung, Load-Balancing und Container-Betrieb.