reposis-module-archetype

Ein Template für alle Reposis-Anwendungen als maven-archetype.

reposis-modul in jar umstellen

Archtype bauen, damit man ihn lokal einsetzen kann:

reposis-module-archetype auschecken
mvn clean install

Maven Projekt erstellen

reposis-Projekt, welches migriert werden soll, auschecken
- mvn archetype:generate
  - de.gbv.ostasien groupId
  - artifactID reposis_ostasion
  - version 2022.06-SNAPSHOT
- erstellt reposis_ostasien mit entsprechender Struktur
- die gitignore Datei muss noch in .gitignore umbenannt werden. (liegt an einem Bug in Maven)

Dateien

Kopieren von save/webpages/ zu src/main/resources/META-INF/resources/
Kopieren von resources/ zu src/main/resources
Vorerst löschen von resources/log4j2.xml
Properties
- Es muss unterschieden werden in Properties die nur für das Test oder Produktiv-System sind, oder welche die für alle Allg. sind
- Nur die allg. Properties sollten in dem Modul enthalten sein

Allgemeines

setup-reposis_ostasien.txt - enthält CLI-Befehle z.B. anpassen von Klassifikation die nur für diese Anwendung benötigt werden * CI=true mvn clean install -> baut analog zu Jenkins, benötigt lokal installierten WebDriver
einfacher Seleniumtest zum Prüfen ob Anwendung noch startet → wichtig, muss mit IT enden! (z.B. https://github.com/gbv/reposis_digibib/blob/2021.06/src/test/java/de/vzg/reposis/digibib/DigibibLibIT.java)

Verzeichnissstruktur

src/
- main/ - Alle Dateien die später im Jar Laden
  - java/ - Enthält Java Code speziell für diese Anwendung
  - resources/ - Resourcen die über den "Classpath" zur verfügung stehen
  - META-INF/resources - Web Resourcen welche im Kontext der Anwedung abrufbar sind
- test/ - Alle Dateien für das Testen der Anwendung
  - java/ - Enthält Java Code zum Testen der Anwendung

Troubleshooting

mvn clean install -Pauto-update -> sortiert pom.xml
CI=true mvn solr-runner:stop -> stoppt jenkins-Solr im Falle eines Test-Fehlers