# EasyServer

**Repository Path**: guozinhs/EasyServer

## Basic Information

- **Project Name**: EasyServer
- **Description**: 一个基于 RESTful 风格请求的服务治理框架。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2020-05-20
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EasyServer

#### 介绍
一个基于 RESTful 风格请求的服务治理框架。

#### 安装教程

1.  服务端

    - Maven 依赖

    ```xml
    <dependency>
        <groupId>com.lilingguo</groupId>
        <artifactId>easyserver-server</artifactId>
        <version>0.0.1</version>
    </dependency>
    ```

    - SpringBoot 配置

    ```yaml
    easyserver:
      server:
        clear-rate: 30000 # 清除过期服务间隔（默认30s）
        self-protection: true # 自我保护机制（默认开启）
        storage-mode: mapdb # 服务信息存储方式（default,sql,mapdb）
        data-persistence-path: D:\data # 数据持久化路径(使用file存储)
    ```

    ​

2.  客户端

    - Maven 依赖

    ```xml
    <dependency>
        <groupId>com.lilingguo</groupId>
        <artifactId>easyserver-client</artifactId>
        <version>0.0.1</version>
    </dependency>
    ```

    - SpringBoot 配置

    ```yaml
    easyserver:
      server:
        address: localhost:17425 # 服务端address
      client:
        ip: 127.0.0.1 # 客户端ip地址
        health-ttl: 90000 # 服务过期时间（默认90s）
        health-tick-rate: 30000 # 心跳间隔（默认30s）
        update-rate: 30000 # 拉取服务间隔（默认30s）
    ```

    ​

#### 使用说明

1.  服务端

    启动项目即可，访问服务端地址 http://ip:port/ 可进入服务可视化界面

    ![easyserver-index](https://gitee.com/guozinhs/EasyServer/raw/master/imgs/easyserver-index.png)

    ​

2.  客户端

    调用核心类 EasyServer 的方法获取服务 URL

    ```java
    String url = easyServer.getServerUrl("appName");
    ```

    ​

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request