https://github.com/gbv/reposis-module-archetype

https://github.com/gbv/reposis-module-archetype

mycore reposis

Last synced: 19 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/gbv/reposis-module-archetype
• Owner: gbv
• Created: 2021-09-01T11:41:09.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-09-26T11:40:11.000Z (4 months ago)
• Last Synced: 2024-11-10T03:17:53.331Z (3 months ago)
• Topics: mycore, reposis
• Language: SCSS
• Homepage:
• Size: 55.7 KB
• Stars: 0
• Watchers: 5
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 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