doubleluxu / polaris-java

Lightweight Java SDK used as Proxyless Service Governance Solution

Polaris Java

English | 简体中文

README：

• Introduction
• How to build
• How to use
• Examples
• Frameworks

Introduction

polaris-java is the Java SDK, support SDK API for application to use polaris

How to build

polaris-java uses Maven for most build-related activities, and JDK 1.8 or later versions are supported. You should be able to get off the ground quite quickly by cloning the project you are interested in and typing:

mvn clean install

How to use

Modify pom.xml in application root, add dependencyManagement for polaris-java:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.tencent.polaris</groupId>
            <artifactId>polaris-dependencies</artifactId>
            <version>1.9.1</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

add the module in dependencies.

Examples

A polaris-examples module is included in our project for you to get started with polaris-java quickly. It contains an example, and you can refer to the readme file in the example project for a quick walkthrough.

• QuickStart Example
• Discovery Example
• Router Example
• CircuitBreaker Example
• RateLimit Example
• Configuration Example

Frameworks

Developers usually use HTTP or RPC frameworks to develop distributed service. Polaris SDK is already integrated into some development frameworks. If using these frameworks, you can enable Polaris Service Governance functions without using Polaris SDK directly.

• spring cloud
• spring boot
• dubbo-java
  • registry and discovery
  • routing and load balance
  • circuit breaker and rate limiter
• grpc-java