Ladok 3 Atom Client

Denna produkt innehåller en klient som pratar med Ladok 3:s Atom-gränssnitt och abstraherar all Atom-kommunikation.

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-atom-client</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 följer SemVer från och med nästa release.

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

Konfiguration

För att använda klienten och kunna hämta händelser från Ladoks Atom-gränssnitt måste ett certifikat användas.

Kopiera ett giltigt klientcertifikat för Ladok3 till katalogen src/main/resources/. Certifikatet ska vara på PKCS 12-format.

I src/main/resources finns en exempelfil för fordrade egenskaper. Använd den genom

cp atomclient.properties.sample atomclient.properties

Redigera sedan filen src/main/resources/atomclient.properties så att den innehåller rätt namn på certifikatfil och lösenord.

Integrationstester

När du har gjort konfigurationen enligt ovan kan du köra integrationstesterna med nedanstående kommando:

mvn clean verify -Prun-its

Att göra en release

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

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