Skip to content

Latest commit

 

History

History
51 lines (36 loc) · 2.14 KB

README.md

File metadata and controls

51 lines (36 loc) · 2.14 KB
Raw

Maven Central

Introduction

This is a Java API client for communicating with the Nuts Node, the reference implementation of the Nuts Specification. It is generated from the latest version of the OpenAPI specifications of the Nuts Node REST API.

Installation

Maven

Maven Central

<dependency>
    <groupId>nl.reinkrul.nuts</groupId>
    <artifactId>java-client</artifactId>
    <version>6.0.0</version>
</dependency>

Find all versions on Maven central.

Usage and examples

Since each module in the Nuts Node has its own OpenAPI specification, there is a client API generated for each of them. You can find in their own subpackage in nl.reinkrul.nuts (e.g. nl.reinkrul.nuts.vdr).

See src/test/java/nl/reinkrul/nuts/IntegrationTest.java for an example of how to use the client.

Versioning

This library will follow the major versioning of the Nuts Node. So if Nuts Node 1.x.x is released, this library will follow with a 1.y.z release. Minor and patch versions will not follow the Nuts Node and are intended for features/bugfixes of the library.

Development

Run make:

  1. Fetches the latest version of the OpenAPI specifications.
  2. Generates the API client.

Publishing

  1. Update nuts.version version in pom.xml.

  2. Run make

  3. Update artifact version to next major/minor (to x.y.z) and then release.

    make release

  4. Log in to Sonatype and close & release staging repository (see https://central.sonatype.org/publish/publish-maven/).

  5. Update dependency version in pom.xml to the new version, update examples if required, commit and push.