Java API Datenquellen anlegen

Voraussetzungen

• Java Development Kit (JDK) 11 oder höher
• Eine Java IDE wie IntelliJ IDEA, Eclipse oder Visual Studio Code
• Basiskenntnisse in Java-Programmierung
• QuickHMI-Editor Version 12.1.1 (Jellyfish) oder höher
• QuickHMI Java Datasource API (qhmi_datasource_api_vX.jar) 

Den API Download finden Sie in folgendem Github Repository: https://github.com/IndiAnGmbH/QuickHMI-Java-Datasource-API

---

Einführung

Mit der QuickHMI Java API können Sie eigene Treiber und Schnittstellen entwickeln, um QuickHMI an individuelle Anforderungen anzupassen. Die einzige Voraussetzung ist ein grundlegendes Verständnis der Programmiersprache Java.

QuickHMI stellt Ihnen hierfür die Java-Datenquellen-Schnittstelle (qhmi_datasource_api.jar) zur Verfügung. Sie können diese Bibliothek direkt aus unserem GitHub-Repository herunterladen. Dort finden Sie auch eine Beispielimplementierung, die Ihnen als Vorlage für Ihre eigene Entwicklung dienen kann.

---

Programmierung

1. Einrichtung des Projektes

• Richten Sie ein neues Java-Projekt in einer beliebigen IDE (z. B. IntelliJ IDEA, Eclipse) ein.
• Binden Sie die qhmi_datasource_api.jar in Ihr Projekt ein.

2. Klasse erstellen und API implementieren

• Erstellen Sie eine Klasse, die com.indian.quickhmi.server.api.IDataSource_VX implementiert.
• Überschreiben Sie alle notwendigen Methoden entsprechend Ihrer Anforderungen.

3. Export der .jar-Datei

• Exportieren Sie Ihr Projekt als .jar-Datei und speichern Sie diese im Verzeichnis runtime\java_api_datasources von QuickHMI.

Eine vollständige Beschreibung aller verfügbaren Klassen, Schnittstellen und Methoden finden Sie in der offiziellen API-Dokumentation.

---

Integration im QuickHMI-Editor

1. Datenquelle hinzufügen

• Öffnen Sie die Datenquellenübersicht im QuickHMI Editor und fügen Sie eine neue Datenquelle hinzu.
• Setzen Sie den Datenquellen-Typ auf Java_API.

2. Konfiguration der Datenquelle

• Name der .jar-Datei: Geben Sie den Namen Ihrer .jar-Datei an. Alternativ können Sie den Dateiordner über den Button neben dem Eingabefeld direkt öffnen und eine Datei auswählen.
• Vollständig qualifizierter Klassenname: Tragen Sie den vollständigen Klassennamen inklusive Package ein (z. B. com.example.MyCustomDataSource).
• Adresse: Optionaler Text, der als Parameter an die init-Methode Ihrer Datenquelle übergeben wird.

---