Holon - Holon Java Platform

Core

The Holon Platform Core module represents the platform foundation, providing the definition of the overall architecture, base structures and APIs, such as the Property model, the Datastore API and the Context resources support.

Source code: Holon Core GitHub repository
API: Javadocs
Reference manual: HTML | PDF

License: Apache 2.0

Latest release

Latest release version: 5.5.0 | Releases | Issues Module BOM:

<dependencyManagement>
  <dependency>
    <groupId>com.holon-platform.core</groupId>
    <artifactId>bom</artifactId>
    <version>5.5.0</version>
    <type>pom</type>
    <scope>import</scope>
  </dependency>
</dependencyManagement>

Using the platform BOM is recommended.

Artifact list

Group id: com.holon-platform.core

Artifact id	Description
`holon-core`	Platform core components, services and APIs
`holon-http`	HTTP messages support
`holon-async-http`	Asynchronous HTTP messages support
`holon-async-datastore`	Asynchronous Datastore API
`holon-auth`	Authentication and Authorization
`holon-auth-jwt`	JSON Web Tokens support
`holon-spring`	Spring integration
`holon-spring-security`	Spring Security integration
`holon-spring-boot`	Spring Boot integration
`holon-starter`	Base Spring Boot starter
`holon-starter-security`	Base Spring Boot starter with Spring Security integration
`holon-starter-test`	Base Spring Boot starter for Unit tests

Reactor

The Holon Platform Reactor module provides integration with the Project Reactor APIs, a reactive library for building non-blocking applications on the JVM based on the Reactive Streams Specification.
A reactive RestClient and Datastore API version is provided by the module.

Source code: Holon Reactor GitHub repository
API: Javadocs
Reference manual: HTML | PDF

License: Apache 2.0

Latest release

Latest release version: 5.5.0 | Releases | Issues Module BOM:

<dependencyManagement>
  <dependency>
    <groupId>com.holon-platform.reactor</groupId>
    <artifactId>holon-reactor-bom</artifactId>
    <version>5.5.0</version>
    <type>pom</type>
    <scope>import</scope>
  </dependency>
</dependencyManagement>

Using the platform BOM is recommended.

Artifact list

Group id: com.holon-platform.reactor

Artifact id	Description
`holon-reactor-datastore`	Project Reactor integration for the Holon Platform `Datastore` API, using `Mono` and `Flux` as API operations result
`holon-reactor-http`	Project Reactor integration for the Holon Platform `RestClient` API, using `Mono` and `Flux` as API operations result
`holon-reactor-spring`	Spring webflux `WebClient` implementation of the Holon Platform `RestClient` API

JSON

The Holon Platform JSON module provides support for the JSON data-interchange format using the most popular serialization and deserialization libraries: Jackson and Gson. Main features:

1. PropertyBox class JSON serialization and deserialization support.
1. A simple JSON objects serialization and deserialization API, to use concrete JSON parsers implementation in a easier and abstract way.
2. JAX-RS configuration and auto-configuration support.
3. Spring support to configure PropertyBox serialization and deserialization in RestTemplate JSON message converters.
4. Spring Boot support to auto-configure Gson and Jackson ObjectMapper instances with PropertyBox serialization and deserialization capabilities.

Source code: Holon JSON GitHub repository
API: Javadocs
Reference manual: HTML | PDF

License: Apache 2.0

Latest release

Latest release version: 5.5.0 | Releases | Issues Module BOM:

<dependencyManagement>
  <dependency>
    <groupId>com.holon-platform.json</groupId>
    <artifactId>holon-json-bom</artifactId>
    <version>5.5.0</version>
    <type>pom</type>
    <scope>import</scope>
  </dependency>
</dependencyManagement>

Using the platform BOM is recommended.

Artifact list

Group id: com.holon-platform.json

Artifact id	Description
`holon-json`	Holon JSON objects serialization and deserialization API
`holon-gson`	Base Gson configuration for `PropertyBox` serialization and deserialization support
`holon-gson-jaxrs`	JAX-RS configuration support to use Gson as JSON type messages serializer/deserializer
`holon-gson-spring`	Spring `RestTemplate` configuration and `Gson` Spring Boot auto-configuration
`holon-jackson`	Base Jackson configuration for `PropertyBox` serialization and deserialization support
`holon-jackson-jaxrs`	JAX-RS configuration support for Jackson to enable `PropertyBox` serialization and deserialization in JSON format
`holon-jackson-spring`	Spring `RestTemplate` configuration and `ObjectMapper` Spring Boot auto-configuration

JAX-RS

The Holon Platform JAX-RS module provides support, components and configuration helpers concerning the Java API for RESTful Web Services standard. Main features:

1. A JAX-RS implementation of the core platform RestClient API, a complete and easy to use RESTful web services Java client. An asynchronous and a reactive implementation are available too.
2. A set of standard JAX-RS components to implement server-side API authentication and authorization by using the platform core APIs and services.
3. A complete integration with Swagger/OpenAPI specification version 2 and 3, including support for the PropertyBox core platform data container interface and for Swagger API listing endpoints (both in JSON and YAML formats) configuration.
4. Spring Boot auto-configuration classes to automatically register suitable Spring beans (for example beans annotated with @Path or @Provider) as resources in a JAX-RS compliant server.
5. Spring Boot auto-configuration classes to automatically enable and configure a Resteasy server with Spring integration.
6. A set of Spring Boot starters to setup JAX-RS compliant clients and servers using either Jersey or Resteasy as JAX-RS implementation, Jackson or Gson as JSON provider, Tomcat or Undertow as embedded servlet container.

Source code: Holon JAX-RS GitHub repository
API: Javadocs
Reference manual: HTML | PDF

License: Apache 2.0

Latest release

Latest release version: 5.5.0 | Releases | Issues Module BOM:

<dependencyManagement>
  <dependency>
    <groupId>com.holon-platform.jaxrs</groupId>
    <artifactId>holon-jaxrs-bom</artifactId>
    <version>5.5.0</version>
    <type>pom</type>
    <scope>import</scope>
  </dependency>
</dependencyManagement>

Using the platform BOM is recommended.

Artifact list

Group id: com.holon-platform.jaxrs

Artifact id	Description
`holon-jaxrs-client`	JAX-RS implementation of the core platform `RestClient` API
`holon-jaxrs-client-reactor`	Reactive `RestClient` API JAX-RS implementation using Project Reactor
`holon-jaxrs-server`	JAX-RS server-side authentication and authorization features using platform core APIs and services, such as `Realm` and `AuthContext`
`holon-jaxrs-swagger-core`	Core Swagger integration API and annotations
`holon-jaxrs-swagger-v2`	Swagger specification version 2 integration: JAX-RS API listing endpoints auto-configuration with PropertyBox support
`holon-jaxrs-swagger-v3`	Swagger/OpenAPI specification version 3 integration: JAX-RS API listing endpoints auto-configuration with PropertyBox support
`holon-jaxrs-spring-boot-client`	`JaxrsClientBuilder` Spring Boot auto-configuration
`holon-jaxrs-spring-boot-jersey`	Jersey auto-configuration with automatic registration of Spring beans as JAX-RS resources
`holon-jaxrs-spring-boot-resteasy`	Resteasy auto-configuration with Spring integration
`holon-starter-jersey`	Spring Boot JAX-RS server starter using Jersey, Tomcat and Jackson as JSON provider
`holon-starter-jersey-gson`	Spring Boot JAX-RS server starter using Jersey, Tomcat and Gson as JSON provider
`holon-starter-jersey-undertow`	Spring Boot JAX-RS server starter using Jersey, Undertow and Jackson as JSON provider
`holon-starter-jersey-undertow-gson`	Spring Boot JAX-RS server starter using Jersey, Undertow and Gson as JSON provider
`holon-starter-jersey-client`	Spring Boot JAX-RS client starter using Jersey and Jackson as JSON provider
`holon-starter-jersey-client-gson`	Spring Boot JAX-RS client starter using Jersey and Gson as JSON provider
`holon-starter-resteasy`	Spring Boot JAX-RS server starter using Resteasy, Tomcat and Jackson as JSON provider
`holon-starter-resteasy-gson`	Spring Boot JAX-RS server starter using Resteasy, Tomcat and Gson as JSON provider
`holon-starter-resteasy-undertow`	Spring Boot JAX-RS server starter using Resteasy, Undertow and Jackson as JSON provider
`holon-starter-resteasy-undertow-gson`	Spring Boot JAX-RS server starter using Resteasy, Undertow and Gson as JSON provider
`holon-starter-resteasy-client`	Spring Boot JAX-RS client starter using Resteasy and Jackson as JSON provider
`holon-starter-resteasy-client-gson`	Spring Boot JAX-RS client starter using Resteasy and Gson as JSON provider

JDBC

The Holon Platform JDBC module provides the Java DataBase Connectivity support, dealing with javax.sql.DataSource configuration and management in single or multiple persistence source enviroments. Main features:

1. A DataSourceBuilder API to create and configure DataSource instances using a configuration property source and supporting the most popular and best performing pooling DataSource implementations (HikariCP, Apache DBCP2 and Tomcat JDBC Connection Pool).
2. A basic multi-tenant DataSource implementation using the platform foundation TenantResolver interface.
3. Spring integration for DataSource beans configuration and initialization (with Spring’s transaction management support) using the @EnableDataSource configuration annotation.
4. Spring Boot integration for single or multiple DataSource beans auto-configuration using application.properties/application.yaml configuration properties.

Source code: Holon JDBC GitHub repository
API: Javadocs
Reference manual: HTML | PDF

License: Apache 2.0

Latest release

Latest release version: 5.5.0 | Releases | Issues Module BOM:

<dependencyManagement>
  <dependency>
    <groupId>com.holon-platform.jdbc</groupId>
    <artifactId>holon-jdbc-bom</artifactId>
    <version>5.5.0</version>
    <type>pom</type>
    <scope>import</scope>
  </dependency>
</dependencyManagement>

Using the platform BOM is recommended.

Artifact list

Group id: com.holon-platform.jdbc

Artifact id	Description
`holon-jdbc`	Core artifact, providing `DataSourceBuilder` API and multi-tenancy support
`holon-jdbc-spring`	Spring integration using the `@EnableDataSource` annotation
`holon-jdbc-spring-boot`	Spring Boot integration for `DataSource` auto-configuration
`holon-starter-jdbc`	Spring Boot starter for `DataSource` auto-configuration
`holon-starter-jdbc-hikaricp`	Spring Boot starter for `DataSource` auto-configuration using the HikariCP pooling DataSource implementation

JDBC Datastore

The Holon Platform JDBC Datastore module is the reference Datastore implementation using the JDBC API and the SQL language for data access and manipulation.
The JDBC Datastore leverages on dialects to transparently support different RDBMS vendors. Dialects for the following RDBMS are provided out-of-the-box: MySQL, MariaDB, Oracle Database, Microsoft SQL Server, PostgreSQL, IBM DB2, IBM Informix, SAP HANA, H2, HSQLDB, Derby, SQLite.

A complete Spring and Spring Boot support is provided for JDBC Datastore integration in a Spring environment and for auto-configuration facilities.

Source code: Holon JPA Datastore GitHub repository
API: Javadocs
Reference manual: HTML | PDF

License: Apache 2.0

Latest release

Latest release version: 5.5.0 | Releases | Issues Module BOM:

<dependencyManagement>
  <dependency>
    <groupId>com.holon-platform.jdbc</groupId>
    <artifactId>holon-datastore-jdbc-bom</artifactId>
    <version>5.5.0</version>
    <type>pom</type>
    <scope>import</scope>
  </dependency>
</dependencyManagement>

Using the platform BOM is recommended.

Artifact list

Group id: com.holon-platform.jdbc

Artifact id	Description
`holon-datastore-jdbc`	JDBC `Datastore` implementation
`holon-datastore-jdbc-composer`	The SQL composer engine based on the Java JDBC API
`holon-datastore-jdbc-spring`	Spring integration using the `@EnableJdbcDatastore` annotation
`holon-datastore-jdbc-spring-boot`	Spring Boot integration for JDBC Datastore auto-configuration
`holon-starter-jdbc-datastore`	Spring Boot starter for JDBC Datastore auto-configuration
`holon-starter-jdbc-datastore-hikaricp`	Spring Boot starter for JDBC Datastore auto-configuration using the HikariCP pooling DataSource implementation

JPA

Base JPA module of the Holon Platform, which provides base support for the Java Persistence API.

The module makes available a set of Holon bean property and bean property set post processors to deal with JPA entity annotations at bean introspection time, to provide a seamless integration with the Holon Platform Property model.

Source code: Holon JPA GitHub repository
API: Javadocs
Reference manual: HTML | PDF

License: Apache 2.0

Latest release

Latest release version: 5.5.0 | Releases | Issues Module BOM:

<dependencyManagement>
  <dependency>
    <groupId>com.holon-platform.jpa</groupId>
    <artifactId>holon-jpa-bom</artifactId>
    <version>5.5.0</version>
    <type>pom</type>
    <scope>import</scope>
  </dependency>
</dependencyManagement>

Using the platform BOM is recommended.

Artifact list

Group id: com.holon-platform.jpa

Artifact id	Description
`holon-jpa-bean-processors`	A bean post processors set for JPA entity bean introspection

JPA Datastore

The Holon Platform JPA Datastore module is the reference Datastore implementation using the JPA API and the JPQL language for data access and manipulation.
The JPA Datastore supports any standard JPA ORM library, although is tested and optimized specifically for Hibernate and EclipseLink.

A complete Spring and Spring Boot support is provided for JPA Datastore integration in a Spring environment and for auto-configuration facilities.

Source code: Holon JPA Datastore GitHub repository
API: Javadocs
Reference manual: HTML | PDF

License: Apache 2.0

Latest release

Latest release version: 5.5.0 | Releases | Issues Module BOM:

<dependencyManagement>
  <dependency>
    <groupId>com.holon-platform.jpa</groupId>
    <artifactId>holon-datastore-jpa-bom</artifactId>
    <version>5.5.0</version>
    <type>pom</type>
    <scope>import</scope>
  </dependency>
</dependencyManagement>

Using the platform BOM is recommended.

Artifact list

Group id: com.holon-platform.jpa

Artifact id	Description
`holon-datastore-jpa`	JPA `Datastore` implementation
`holon-datastore-jpa-spring`	Spring integration using the `@EnableJpa` and `@EnableJpaDatastore` annotations
`holon-datastore-jpa-spring-boot`	Spring Boot integration for JPA stack and Datastore auto-configuration
`holon-starter-jpa-hibernate`	Spring Boot starter for JPA stack and Datastore auto-configuration using Hibernate ORM
`holon-starter-jpa-eclipselink`	Spring Boot starter for JPA stack and Datastore auto-configuration using EclipseLink ORM

QueryDSL integration for the JPA Datastore

The Holon Platform JPA QueryDSL module provides QueryDSL integration for the JPA Datastore.

The QueryDsl commodity provided by this module allows to mix QueryDSL expressions and predicates with standard platform query expressions, such as QueryFilter, QuerySort and QueryAggregation. Furthermore, this module provides integration classes to use QueryDSL expressions as Datastore expressions (such as EntityPath and Path QueryDSL types) and some Spring Boot starters for auto-configuration.

Source code: Holon JPA QueryDSL GitHub repository
API: Javadocs
Reference manual: HTML | PDF

License: Apache 2.0

Latest release

Latest release version: 5.5.0 | Releases | Issues Module BOM:

<dependencyManagement>
  <dependency>
    <groupId>com.holon-platform.jpa</groupId>
    <artifactId>holon-datastore-jpa-querydsl-bom</artifactId>
    <version>5.5.0</version>
    <type>pom</type>
    <scope>import</scope>
  </dependency>
</dependencyManagement>

Using the platform BOM is recommended.

Artifact list

Group id: com.holon-platform.jpa

Artifact id	Description
`holon-datastore-jpa-querydsl`	JPA `Datastore` QueryDSL integration
`holon-starter-jpa-querydsl-hibernate`	Spring Boot starter for JPA stack and Datastore auto-configuration with QueryDSL integration using Hibernate ORM
`holon-starter-jpa-querydsl-eclipselink`	Spring Boot starter for JPA stack and Datastore auto-configuration with QueryDSL integration using EclipseLink ORM

MongoDB Datastore

The Holon Platform MongoDB Datastore module is the reference Datastore implementation using MongoDB.
The following interaction models are supported:

1. Synchronous interaction, using the holon-datastore-mongo-sync artifact.
2. Asynchronous interaction, using the holon-datastore-mongo-async artifact.
3. Reactive interaction, using the holon-datastore-mongo-reactor artifact and the Project Reactor library.

A complete Spring and Spring Boot support is provided for MongoDB Datastore integration in a Spring environment and for auto-configuration facilities.

Source code: Holon MongoDB Datastore GitHub repository
API: Javadocs
Reference manual: HTML | PDF

License: Apache 2.0

Latest release

Latest release version: 5.5.0 | Releases | Issues Module BOM:

<dependencyManagement>
  <dependency>
    <groupId>com.holon-platform.mongo</groupId>
    <artifactId>holon-datastore-mongo-bom</artifactId>
    <version>5.5.0</version>
    <type>pom</type>
    <scope>import</scope>
  </dependency>
</dependencyManagement>

Using the platform BOM is recommended.

Artifact list

Group id: com.holon-platform.mongo

Artifact id	Description
`holon-datastore-mongo-core`	Common operations and data structures
`holon-datastore-mongo-core-async`	Common operations and data structures for the asynchronous `Datastore` API implementation
`holon-datastore-mongo-sync`	Synchronous MongoDB `Datastore` API implementation
`holon-datastore-mongo-async`	Asynchronous MongoDB `Datastore` API implementation
`holon-datastore-mongo-reactor`	Reactive MongoDB `Datastore` API implementation using Project Reactor
`holon-datastore-mongo-spring`	Spring integration using the `@EnableMongoDatastore`, `@EnableMongoAsyncDatastore` and `@EnableMongoReactiveDatastore` annotations
`holon-datastore-mongo-spring-boot`	Spring Boot integration for MongoDB `Datastore` auto-configuration
`holon-starter-mongo-datastore`	Spring Boot starter for the MongoDB `Datastore` auto-configuration
`holon-starter-mongo-datastore-reactor`	Spring Boot starter for the reactive MongoDB `Datastore` implementation auto-configuration

Vaadin Flow UI

The Holon Platform Vaadin Flow UI module represents the platform support for the Vaadin Flow (10+) web applications platform, focusing on the user interface components, navigation and data binding features. Main features:

1. A Java API to build (using fluent builders), manage and use the web application UI components.
2. Integration with the platform foundation architecture, such as the Property model and the Datastore API, the authentication, authorization and localization support.
3. Routing targets query parameters injection using the @QueryParameter annotation, with extensible Java type conversion support.
4. A Navigator API to manage the web application routing, with query parameters support.
5. A complete Spring and Spring Boot integration.

Source code: Holon Vaadin Flow GitHub repository
API: Javadocs
Reference manual: HTML | PDF

License: Apache 2.0

Latest release

Latest release version: 5.5.0 | Releases | Issues Module BOM:

<dependencyManagement>
  <dependency>
    <groupId>com.holon-platform.vaadin</groupId>
    <artifactId>holon-vaadin-flow-bom</artifactId>
    <version>5.5.0</version>
    <type>pom</type>
    <scope>import</scope>
  </dependency>
</dependencyManagement>

Using the platform BOM is recommended.

Artifact list

Group id: com.holon-platform.vaadin

Artifact id	Description
`holon-vaadin-flow`	Core artifact
`holon-vaadin-flow-navigator`	Query parameters injection and `Navigation` API
`holon-vaadin-flow-spring`	Spring integration
`holon-vaadin-flow-spring-boot`	Spring Boot integration
`holon-starter-flow-vaadin`	Spring Boot starter
`holon-starter-vaadin-flow-undertow`	Spring Boot starter using Undertow as embedded servlet container

Vaadin UI

The Holon Platform Vaadin UI module represents the platform support for the Vaadin 8 web applications framework, focusing on user interface components and data binding features. Main features:

1. A Java API to build (using fluent builders), manage and use the web application UI components.
2. Integration with the platform foundation architecture, such as the Property model and the Datastore API, the authentication, authorization and localization support.
3. A powerful and easy to use View navigator to manage the web application virtual pages.
4. A complete Spring and Spring Boot integration.

Source code: Holon Vaadin GitHub repository
API: Javadocs
Reference manual: HTML | PDF

License: Apache 2.0

Latest release

Latest release version: 5.4.0 | Releases | Issues Module BOM:

<dependencyManagement>
  <dependency>
    <groupId>com.holon-platform.vaadin</groupId>
    <artifactId>holon-vaadin-bom</artifactId>
    <version>5.4.0</version>
    <type>pom</type>
    <scope>import</scope>
  </dependency>
</dependencyManagement>

Using the platform BOM is recommended.

Artifact list

Group id: com.holon-platform.vaadin

Artifact id	Description
`holon-vaadin`	Core artifact
`holon-vaadin-navigator`	View navigation support
`holon-vaadin-spring`	Spring integration
`holon-vaadin-spring-boot`	Spring Boot integration
`holon-starter-vaadin`	Spring Boot starter
`holon-starter-vaadin-undertow`	Spring Boot starter using Undertow as embedded servlet container

Vaadin 7 compatibility module

A Vaadin 7 compatibility module is available, providing an API which matches at 99% the Holon Vaadin 8 module API, only not compatible classes or methods are different for obvious reasons. See the documentation for further information.

Source code: Holon Vaadin 7 GitHub repository
API: Javadocs
Reference manual: HTML | PDF

License: Apache 2.0

Latest release

Latest release version: 5.2.4 | Releases | Issues Module BOM:

<dependencyManagement>
  <dependency>
    <groupId>com.holon-platform.vaadin7</groupId>
    <artifactId>holon-vaadin-bom</artifactId>
    <version>5.2.4</version>
    <type>pom</type>
    <scope>import</scope>
  </dependency>
</dependencyManagement>

Using the platform BOM is recommended.

Artifact list

Group id: com.holon-platform.vaadin7

Artifact id	Description
`holon-vaadin`	Core artifact
`holon-vaadin-navigator`	View navigation support
`holon-vaadin-spring`	Spring integration
`holon-vaadin-spring-boot`	Spring Boot integration
`holon-starter-vaadin`	Spring Boot starter
`holon-starter-vaadin-undertow`	Spring Boot starter using Undertow as embedded servlet container

Modules