Portable Abstractions and Patterns for Java

This module is a part of the Pip.Services polyglot microservices toolkit. It provides a set of basic patterns used in microservices or backend services. Also the module implemenets a reasonably thin abstraction layer over most fundamental functions across all languages supported by the toolkit to facilitate symmetric implementation.

The module contains the following packages:

• Commands - Commanding and Eventing patterns
• Config - configuration framework
• Convert - portable soft value converters
• Data - data value objects and random value generators
• Errors - portable application errors
• Random - random data generators
• Refer - component referencing framework
• Reflect - portable reflection helpers
• Run - execution framework
• Validate - data validators

Quick links:

• Configuration Pattern
• Locator Pattern
• Component Lifecycle
• Components with Active Logic
• Data Patterns
• API Reference
• Change Log
• Get Help
• Contribute

Use

Go to the pom.xml file in Maven project and add dependencies::

<dependency>
  <groupId>org.pipservices3</groupId>
  <artifactId>pip-services3-commons</artifactId>
  <version>3.0.0</version>
</dependency>

Develop

For development you shall install the following prerequisites:

• Java SE Development Kit 8+
• Eclipse Java Photon or another IDE of your choice
• Docker
• Apache Maven

Build the project:

mvn install

Run automated tests:

mvn test

Generate API documentation:

./docgen.ps1

Before committing changes run dockerized build and test as:

./build.ps1
./test.ps1
./clear.ps1

Contacts

The initial implementation is done by Sergey Seroukhov. Pip.Services team is looking for volunteers to take ownership over Java implementation in the project.