# xRPC-java

**Repository Path**: xiaoshengfu/xRPC

## Basic Information

- **Project Name**: xRPC-java
- **Description**: 简单的RPC框架。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2020-02-16
- **Last Updated**: 2021-04-15

## Categories & Tags

**Categories**: rpc

**Tags**: None

## README

# xRPC 

#### 介绍
xRPC是借鉴Dubbo，基于Netty编写的一个简单的RPC框架。

主要实现思路：https://www.cnblogs.com/LBSer/p/4853234.html

#### 软件架构
<img src="https://gitee.com/xiaoshengfu/xRPC/raw/master/image/xrpc.png" style="zoom: 50%;" />

#### 主要技术

Netty

Spring

jboss-marshalling-serial

Redis

JDK动态代理

#### 安装教程

1：项目未上传至Maven中央仓库，使用xRPC需要下载项目源码并执行maven install。

2：Maven依赖配置

```xml
<dependency>
    <groupId>xyz.xiaoshengfu.xrpc</groupId>
	<artifactId>xrpc-all</artifactId>
	<version>0.0.1-SNAPSHOT</version>
</dependency>
```

3：Spring配置

```xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:xrpc="http://www.xiaoshengfu.xyz/schema/xrpc"
	xsi:schemaLocation="
            http://www.xiaoshengfu.xyz/schema/xrpc
            http://www.xiaoshengfu.xyz/schema/xrpc.xsd">
	<!-- [应用信息配置] name：应用名称，不可重复 -->
	<xrpc:application name="xrpc-ucenter" />
	<!-- [注册中心配置] protocol：协议名称，暂只支持redis；address：注册中心地址；port：注册中心服务端口，默认6379；password：访问注册中心密码，默认无需密码-->
	<xrpc:registry protocol="redis" address="127.0.0.1" port="6379" password="password" />
	<!-- [协议配置] name:协议名称，暂只支持xrpc；port:服务对外暴露端口-->
	<xrpc:protocol name="xrpc" port="9910" />
	<!-- [暴露服务配置] interface：服务接口全限定类名；ref：本地实现服务的SpringBean名称；weight：服务消费者调用服务的权重，默认为1-->
	<xrpc:service interface="xxx.service.IUserService" ref="userServiceImpl" weight="1" />
	<!-- [引用服务配置] interface：服务接口全限定类名；id：引用远程服务的本地SpringBean名称-->
	<xrpc:reference interface="xxx.service.IUserService" id="userService" timeout="600000" />
</beans>
```



#### 使用说明

xRPC框架使用实例：https://gitee.com/xiaoshengfu/bookstore

#### xRPC-Admin

###### 介绍

xRPC-Admin是对使用xRPC框架构建的应用的服务调用关系可视化平台。

###### xRPC-Admin配置

配置文件位置：xrpc-admin/src/main/resources/conf/conf.properties

```properties
#登陆用户名，默认root
login.account=root
#登陆密码，默认root
login.password=root
#注册中心协议名称，仅支持redis
register.protocol=redis
#注册中心主机地址
register.address=127.0.0.1
#注册中心服务端口
register.port=6379
#注册中心访问密码
register.password=root
```

###### xRPC-Admin页面效果

![](https://gitee.com/xiaoshengfu/xRPC/raw/master/image/xrpc-admin1.png)



![](https://gitee.com/xiaoshengfu/xRPC/raw/master/image/xrpc-admin2.png)