client-core

Clients for NPO API's

License	GPLv3
Categories	CLI User Interface
GroupId	nl.vpro.api-client
ArtifactId	client-core
Last Version	5.10.0
Release Date	Mar 29, 2019
Type	jar
Description	client-core Clients for NPO API's
Project Organization	NPO

Download client-core

Filename	Size
client-core-5.10.0.pom
client-core-5.10.0.jar	6 KB
client-core-5.10.0-sources.jar	4 KB
client-core-5.10.0-javadoc.jar	23 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/nl.vpro.api-client/client-core/ -->
<dependency>
    <groupId>nl.vpro.api-client</groupId>
    <artifactId>client-core</artifactId>
    <version>5.10.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/nl.vpro.api-client/client-core/
implementation 'nl.vpro.api-client:client-core:5.10.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/nl.vpro.api-client/client-core/
implementation ("nl.vpro.api-client:client-core:5.10.0")

Apache Buildr

'nl.vpro.api-client:client-core:jar:5.10.0'

Apache Ivy

<dependency org="nl.vpro.api-client" name="client-core" rev="5.10.0">
  <artifact name="client-core" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='nl.vpro.api-client', module='client-core', version='5.10.0')
)

Scala SBT

libraryDependencies += "nl.vpro.api-client" % "client-core" % "5.10.0"

Leiningen

[nl.vpro.api-client/client-core "5.10.0"]

Dependencies

compile (2)

Group / Artifact	Type	Version
org.apache.httpcomponents : httpclient	jar	4.5.6
org.apache.commons : commons-lang3	jar	3.8.1

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

api-clients

Table of Contents

• TODO

Java API clients for the POMS Rest API’s (Frontend API, Backend API, Pages Publisher)

The clients are basicly generated using resteasy to proxy the actual service interface, and they are decorated with some interceptors and similar techniques to arrange the appropriate authentication, to let the generated client automaticly fill common parameters, and things like that.

We also add a common way to instantiate (using the builder pattern) and configure them.

It is split up in several modules. These are the important ones:

• frontend-api-client Provides clients for the NPO Frontend API

• media-backend-api-client. Provides a client for the POMS Backend API.

• pages-backend-api-client Provides clients for the Pages Publisher API

• client-extras Provides some utilities which will make interaction with some calls simpler.

The clients can be configured by code and/or a configuration file in ${user.home}/conf/apiclient.properties.

    NpoApiClients clients = NpoApiClients.configured(nl.vpro.util.Env.TEST).build();
    NpoApiMediaUtil util = new NpoApiMediaUtil(clients);
    try(CloseableIterator<MediaObject> i = util.iterate(null, "vpro-predictions")) {
      i.forEachRemaining(mediaObject -> {
         log.info("{}", i.next());
      });
    }

There are also 'providers' available to configure them easily via spring XML’s or for example XML’s of magnolia CMS (which uses guice)

TODO

• Document how to wire via spring xml

NPO/POMS

Repositories related to POMS and the NPO Frontend API. Maintained by VPRO.

Versions

Version
5.10.0 Mar 29, 2019