xdiamond: A Java repository from tom9211

简介

全局配置中心，存储应用的配置项，解决配置混乱分散的问题。名字来源于淘宝的开源项目diamond，前面加上一个字母X以示区别。

wiki

设计思路

交流QQ群 450548123

在线演示

地址：xdiamond.coding.io，登陆选择standard，用户名密码：admin/admin

特性

所见即所得，在管理界面上看到的所有配置即项目运行时的配置
支持groupId，artifactId，version，profile四个维度以应对复杂环境
支持公共组件的配置继承，client jar包配置继承
配置修改实时通知客户端
和spring集成，使用简单
完善的权限系统
集成LDAP登陆，支持同步LDAP组/用户
支持http RESTful api获取配置
以secret key防止非法获取配置
丰富的metrics, connection统计

使用技术

netty
mybatis
spring mvc
shiro
ehcache
dropwizard metrics
crash shell
swagger
angularjs
bootstrap
bower

工作原理

每个项目有groupId，artifactId，version，然后在不同的环境里对应不同的profile，比如：test, dev, product。
应用在启动时，通过网络连接到xdiamond配置中心，获取到最新的配置。如果没有获取到，从本地备份读取最后拉取的配置。
在Spring初始化时，把配置转为Properties，应用可以通过${}表达式或者@Value来获取配置。
如果配置有更新，可以通过Listener来通知应用。

每个项目都有一个base的profile，所有的profile都会继承base的配置。在base可以放一些公共的配置，比如某个服务的端口。

对于使用者，xdiamond提供的是一个Properties对象。用户可以结合Spring等来使用。

界面截图

项目管理：
Profile管理：
Config管理：
项目依赖关系图：
Metrics信息：
Connection信息：

本地开发环境

git clone 代码
运行xdiamond server：

git clone https://github.com/hengyunabc/xdiamond.git --depth=1
cd xdiamond/xdiamond-server
mvn tomcat7:run -DskipTests

然后访问 http://localhost:8080/xdiamond-server ，用admin/admin, standard登录

执行client例子代码：

cd xdiamond-client-example/
mvn exec:java -Dexec.mainClass="io.github.xdiamond.example.ClientExampleMain"

默认是获取product环境的配置，如果想获取dev环境的配置，则可以执行：

mvn exec:exec -Dexec.executable="java" -Dexec.args="-Dxdiamond.project.profile=dev -classpath %classpath io.github.xdiamond.example.ClientExampleMain"

演示结果

client启动时会打印获取到的配置，另外在web界面上connections里可以看到当前连接的客户端信息。

maven dependency

maven依赖已经发布到**仓库：http://search.maven.org/#search%7Cga%7C1%7Cxdiamond

<dependency>
    <groupId>io.github.hengyunabc.xdiamond</groupId>
    <artifactId>xdiamond-client</artifactId>
    <version>1.0.4</version>
</dependency>

tom9211/xdiamond