Ladok 3 Java Data Transfer Objects

Java värdeobjekt (Data Transfer Objects - DTO) för Ladok 3 finns i denna produkt. DTO:er för marshalling/unmarshalling genereras från Ladok 3:s XSD:er.

Lägga till som ett beroende

För att använda denna produkt som ett beroende i ett Maven-bygge behöver du lägga till två saker i ditt eget projekts pom.xml

  <dependencies>
    <dependency>
      <groupId>se.sunet.ati.ladok</groupId>
      <artifactId>ati-ladok3-dto</artifactId>
      <version>1.0.0-SNAPSHOT</version>
      <type>bundle</type>
    </dependency>
    ...
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.felix</groupId>
        <artifactId>maven-bundle-plugin</artifactId>
        <version>2.3.7</version>
      </plugin>
      ...
    </plugins>
  </build>

Anledningen till att du behöver lägga till maven-bundle-plugin är att denna produkt är av typen bundle (OSGi-bundle), vilket är en typ som normalt inte stöds av Maven. Detta stöd tillhandahålls istället av maven-bundle-plugin.

Policy för versionsnummer

Detta projekt använder versionsnummer som motsvarar den version av Ladok3 vars XSD:er projektet använder.

Använda releaser

Om du vill använda en relase av denna produkt behöver du inte lägga till något speciellt repository, då alla releaser publiceras i Maven Central Repository.

Använda SNAPSHOTs

Om du vill använda en SNAPSHOT-version av denna produkt så behöver du lägga till en konfiguration för detta. SHAPSHOTs publiceras i OSSRH. För Maven är det enklast att lägga till en profil i settings.xml som ser ut så här:

    <!-- For projects requiring SNAPSHOTs from OSSRH -->
    <profile>
      <id>ossrh-snapshots</id>
      <repositories>
        <repository>
          <id>ossrh-snapshots</id>
          <url>https://oss.sonatype.org/content/repositories/snapshots</url>
          <releases>
            <enabled>false</enabled>
          </releases>
          <snapshots>
            <enabled>true</enabled>
          </snapshots>
        </repository>
      </repositories>
    </profile>

När du sedan bygger din egen produkt med Maven så behöver du aktivera profilen:

mvn clean verify -Possrh-snapshots

Att göra en release

Man kan göra en release via Jenkins eller via sin egen dator (som i så fall behöver inställningar i settings.xml, toolchains.xml samt ha stöd för gpg)

Jenkins

Gå till projektet ati-ladok3-dto och kör Perform Maven Release, ange versionsnummer för den release som ska göras och den snapshot-versionen som ska användas efter att release är gjord (inga inloggningsuppgifter behöver anges)

Lokalt via egen dator

För att göra en release behöver du lägga till nedanstående inställningar i din settings.xml.

    <server>
      <id>github</id>
      <username>ditt-github-användarnamn</username>
      <password>ditt-github-lösenord</password>
    </server>
    <server>
      <id>ossrh</id>
      <username>ATI:s användarnamn hos OSSRH</username>
      <password>Tillhörande lösenord</password>
    </server>
    ...
    <profile>
      <id>ati-release</id>
      <properties>
        <gpg.passphrase>Din GPG passphrase</gpg.passphrase>
      </properties>
    </profile>

För att göra releasen använder du dig av Maven Release Plugin:

mvn clean release:prepare
mvn release:perform

Publicera releasen externt via OSSRH

Slutligen behöver du gå till OSSRH för att avsluta jobbet genom att följa deras instrutioner.

I korthet, logga in på [OSSRH] (https://oss.sonatype.org/#welcome), gå till Staging Repositories (i vänstermenyn), markera artifakten i listan (kolla att det är rätt artefakt) och klicka på Close (då sker en kvalitetskontroll av OSSRH) och klicka sedan på Release.