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
- 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.