Server

Using the Java API Server-Side

Updated: December 4, 2024

This page explains how to use the Nuxeo Java API.

Java Services

The Nuxeo Platform contains a built-in notion of service. Services are Java interfaces exposed and implemented by a Component.

From within a Nuxeo Runtime aware context, you can access a service locally (in the same JVM) by simply looking up its interface with Framework#getService(T):

RelationManager rm = Framework.getService(RelationManager.class)

You can find the list of existing services on the Nuxeo Platform Explorer. You will also need to understand main Java classes, using the javadoc.

You must not store the service itself as a field of a long-running component in Nuxeo, as this would prevent proper hot-reloading.

 

Typical Use Cases

You may want to use this API from:

  • A Seam component when customizing the default webapp,
  • An Event Listener that would do some specific things,
  • A custom operation that would use the built-in services,
  • ...