提交 8bfae9b4 编写于 作者: H haocao

Update docs.

上级 228dd807
...@@ -3,8 +3,8 @@ toc = true ...@@ -3,8 +3,8 @@ toc = true
date = "2017-04-12T16:06:17+08:00" date = "2017-04-12T16:06:17+08:00"
title = "贡献代码" title = "贡献代码"
weight = 3 weight = 3
prev = "/00-overview/release-note" prev = "/00-overview/release-notes/"
next = "/01-start/index" next = "/01-start/index/"
+++ +++
......
...@@ -3,14 +3,19 @@ icon = "<b>0. </b>" ...@@ -3,14 +3,19 @@ icon = "<b>0. </b>"
date = "2017-04-12T16:06:17+08:00" date = "2017-04-12T16:06:17+08:00"
title = "概览" title = "概览"
weight = 0 weight = 0
prev = "/03-design/roadmap" prev = "/03-design/roadmap/"
next = "/00-overview/intro" next = "/00-overview/intro/"
chapter = true chapter = true
+++ +++
# 概述 # 概述
[![GitHub release](https://img.shields.io/github/release/dangdangdotcom/sharding-jdbc.svg?style=social&label=Release)](https://github.com/dangdangdotcom/sharding-jdbc/releases)&nbsp;
[![GitHub stars](https://img.shields.io/github/stars/dangdangdotcom/sharding-jdbc.svg?style=social&label=Star)](https://github.com/dangdangdotcom/sharding-jdbc/stargazers)&nbsp;
[![GitHub forks](https://img.shields.io/github/forks/dangdangdotcom/sharding-jdbc.svg?style=social&label=Fork)](https://github.com/dangdangdotcom/sharding-jdbc/fork)&nbsp;
[![GitHub watchers](https://img.shields.io/github/watchers/dangdangdotcom/sharding-jdbc.svg?style=social&label=Watch)](https://github.com/dangdangdotcom/sharding-jdbc/watchers)
Sharding-JDBC是当当应用框架ddframe中,关系型数据库模块dd-rdb中分离出来的数据库水平扩展框架,即透明化数据库分库分表访问。Sharding-JDBC继dubbox和Elastic-Job之后,是ddframe系列开源的第三个产品。 Sharding-JDBC是当当应用框架ddframe中,关系型数据库模块dd-rdb中分离出来的数据库水平扩展框架,即透明化数据库分库分表访问。Sharding-JDBC继dubbox和Elastic-Job之后,是ddframe系列开源的第三个产品。
Sharding-JDBC定位为轻量级java框架,使用客户端直连数据库,以jar包形式提供服务,未使用中间层,无需额外部署,无其他依赖,DBA也无需改变原有的运维方式,可理解为增强版的JDBC驱动,旧代码迁移成本几乎为零。 Sharding-JDBC定位为轻量级java框架,使用客户端直连数据库,以jar包形式提供服务,未使用中间层,无需额外部署,无其他依赖,DBA也无需改变原有的运维方式,可理解为增强版的JDBC驱动,旧代码迁移成本几乎为零。
...@@ -18,8 +23,7 @@ Sharding-JDBC定位为轻量级java框架,使用客户端直连数据库,以 ...@@ -18,8 +23,7 @@ Sharding-JDBC定位为轻量级java框架,使用客户端直连数据库,以
[![Maven Status](https://maven-badges.herokuapp.com/maven-central/com.dangdang/sharding-jdbc/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.dangdang/sharding-jdbc) [![Maven Status](https://maven-badges.herokuapp.com/maven-central/com.dangdang/sharding-jdbc/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.dangdang/sharding-jdbc)
[![Build Status](https://secure.travis-ci.org/dangdangdotcom/sharding-jdbc.svg?branch=master)](https://travis-ci.org/dangdangdotcom/sharding-jdbc) [![Build Status](https://secure.travis-ci.org/dangdangdotcom/sharding-jdbc.svg?branch=master)](https://travis-ci.org/dangdangdotcom/sharding-jdbc)
[![Coverage Status](https://coveralls.io/repos/dangdangdotcom/sharding-jdbc/badge.svg?branch=master&service=github)](https://coveralls.io/github/dangdangdotcom/sharding-jdbc?branch=master) [![Coverage Status](https://coveralls.io/repos/dangdangdotcom/sharding-jdbc/badge.svg?branch=master&service=github)](https://coveralls.io/github/dangdangdotcom/sharding-jdbc?branch=master)
[![GitHub release](https://img.shields.io/github/release/dangdangdotcom/sharding-jdbc.svg)](https://github.com/dangdangdotcom/sharding-jdbc/releases) [![Hex.pm](http://dangdangdotcom.github.io/sharding-jdbc/img/license.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)
[![Hex.pm](http://dangdangdotcom.github.io/elastic-job/img/license.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)
# 功能列表 # 功能列表
......
...@@ -3,8 +3,8 @@ toc = true ...@@ -3,8 +3,8 @@ toc = true
date = "2016-12-06T22:38:50+08:00" date = "2016-12-06T22:38:50+08:00"
title = "简介" title = "简介"
weight = 1 weight = 1
prev = "/00-overview" prev = "/00-overview/index/"
next = "/00-overview/release-notes" next = "/00-overview/release-notes/"
+++ +++
......
...@@ -3,8 +3,8 @@ toc = true ...@@ -3,8 +3,8 @@ toc = true
date = "2016-12-06T22:38:50+08:00" date = "2016-12-06T22:38:50+08:00"
title = "Release Notes" title = "Release Notes"
weight = 2 weight = 2
prev = "/00-overview/intro" prev = "/00-overview/intro/"
next = "/00-overview/contribution" next = "/00-overview/contribution/"
+++ +++
......
...@@ -3,8 +3,8 @@ toc = true ...@@ -3,8 +3,8 @@ toc = true
date = "2016-12-06T22:38:50+08:00" date = "2016-12-06T22:38:50+08:00"
title = "FAQ" title = "FAQ"
weight = 2 weight = 2
prev = "/01-start/quick-start" prev = "/01-start/quick-start/"
next = "/01-start/features" next = "/01-start/features/"
+++ +++
...@@ -14,7 +14,13 @@ next = "/01-start/features" ...@@ -14,7 +14,13 @@ next = "/01-start/features"
Sharding-JDBC使用lombok实现极简代码。关于更多使用和安装细节,请参考[lombok官网](https://projectlombok.org/download.html) Sharding-JDBC使用lombok实现极简代码。关于更多使用和安装细节,请参考[lombok官网](https://projectlombok.org/download.html)
### 2. 使用Spring命名空间时在网上相应地址找不到xsd? ### 2. java.lang.NoSuchMethodError:com.alibaba.druid.sql.ast.expr.SQLAggregateExpr.getOption().....异常的解决方法?
回答:
目前Sharding-JDBC使用Druid作为SQL解析的基础库,请确保业务代码中使用的Druid与Sharding-JDBC使用的版本一致,目前Sharding-JDBC使用的是`1.0.12`版本。
### 3. 使用Spring命名空间时在网上相应地址找不到xsd?
回答: 回答:
...@@ -22,7 +28,7 @@ Spring命名空间使用规范并未强制要求将xsd文件部署至公网地 ...@@ -22,7 +28,7 @@ Spring命名空间使用规范并未强制要求将xsd文件部署至公网地
sharding-jdbc-config-spring的jar包中`META-INF\spring.schemas`配置了xsd文件的位置:`META-INF\namespace\rdb.xsd`,需确保jar包中该文件存在。 sharding-jdbc-config-spring的jar包中`META-INF\spring.schemas`配置了xsd文件的位置:`META-INF\namespace\rdb.xsd`,需确保jar包中该文件存在。
### 3. Cloud not resolve placeholder ... in string value ...异常的解决方法? ### 4. Cloud not resolve placeholder ... in string value ...异常的解决方法?
回答: 回答:
...@@ -32,9 +38,10 @@ sharding-jdbc-config-spring的jar包中`META-INF\spring.schemas`配置了xsd文 ...@@ -32,9 +38,10 @@ sharding-jdbc-config-spring的jar包中`META-INF\spring.schemas`配置了xsd文
<context:property-placeholder location="classpath:conf/rdb/conf.properties" ignore-unresolvable="true"/> <context:property-placeholder location="classpath:conf/rdb/conf.properties" ignore-unresolvable="true"/>
``` ```
### 4. inline表达式返回结果为何出现浮点数? ### 5. inline表达式返回结果为何出现浮点数?
回答: 回答:
Java的整数相除结果是整数,但是对于inline表达式中的Groovy语法则不同,整数相除结果是浮点数。 Java的整数相除结果是整数,但是对于inline表达式中的Groovy语法则不同,整数相除结果是浮点数。
想获得除法整数结果需要将A/B改为A.intdiv(B)。 想获得除法整数结果需要将A/B改为A.intdiv(B)。
...@@ -3,8 +3,8 @@ toc = true ...@@ -3,8 +3,8 @@ toc = true
date = "2016-12-06T22:38:50+08:00" date = "2016-12-06T22:38:50+08:00"
title = "详细功能列表" title = "详细功能列表"
weight = 3 weight = 3
prev = "/01-start/faq" prev = "/01-start/faq/"
next = "/01-start/limitations" next = "/01-start/limitations/"
+++ +++
......
...@@ -3,16 +3,16 @@ icon = "<b>1. </b>" ...@@ -3,16 +3,16 @@ icon = "<b>1. </b>"
date = "2016-12-02T16:06:17+08:00" date = "2016-12-02T16:06:17+08:00"
title = "起航" title = "起航"
weight = 0 weight = 0
prev = "/00-overview/release-notes" prev = "/00-overview/contribution/"
next = "/01-start/quick-start" next = "/01-start/quick-start/"
chapter = true chapter = true
+++ +++
# 本章导航 # 本章导航
- 如果想快速体验Sharding-JDBC的强大功能,请阅读[快速入门](/01-start/quick-start) - 如果想快速体验Sharding-JDBC的强大功能,请阅读[快速入门](/01-start/quick-start/)
- 如果在使用中遇到什么问题,请首先在[FAQ](/01-start/faq)中寻找解决问题的答案。 - 如果在使用中遇到什么问题,请首先在[FAQ](/01-start/faq/)中寻找解决问题的答案。
- 想要在自己的项目中集成Sharding-JDBC,您一定很关心它[能做什么](/01-start/features)[不能做什么](/01-start/limitations) - 想要在自己的项目中集成Sharding-JDBC,您一定很关心它[能做什么](/01-start/features)[不能做什么](/01-start/limitations/)
- 数据库中间件一般都不会支持完全的SQL语法,在这里能了解到[支持的SQL语法](/01-start/sql-supported) - 数据库中间件一般都不会支持完全的SQL语法,在这里能了解到[支持的SQL语法](/01-start/sql-supported/)
- 最后,你会关心中间件的性能情况。这里将展示我们的[性能测试结果](/01-start/stress-test) - 最后,你会关心中间件的性能情况。这里将展示我们的[性能测试结果](/01-start/stress-test/)
...@@ -115,4 +115,4 @@ try ( ...@@ -115,4 +115,4 @@ try (
</rdb:data-source> </rdb:data-source>
</beans> </beans>
``` ```
>详细的规则配置请参考[配置指南](/02-guide/configuration) >详细的规则配置请参考[配置手册](/02-guide/configuration)
\ No newline at end of file \ No newline at end of file
...@@ -3,8 +3,8 @@ toc = true ...@@ -3,8 +3,8 @@ toc = true
date = "2016-12-06T22:38:50+08:00" date = "2016-12-06T22:38:50+08:00"
title = "核心概念" title = "核心概念"
weight = 1 weight = 1
prev = "/02-guide" prev = "/02-guide/index/"
next = "/02-guide/sharding" next = "/02-guide/sharding/"
+++ +++
......
...@@ -3,8 +3,8 @@ toc = true ...@@ -3,8 +3,8 @@ toc = true
date = "2016-12-06T22:38:50+08:00" date = "2016-12-06T22:38:50+08:00"
title = "配置手册" title = "配置手册"
weight = 5 weight = 5
prev = "/02-guide/master-slave" prev = "/02-guide/master-slave/"
next = "/02-guide/hint-sharding-value" next = "/02-guide/hint-sharding-value/"
+++ +++
......
...@@ -11,10 +11,10 @@ chapter = true ...@@ -11,10 +11,10 @@ chapter = true
# 本章导航 # 本章导航
- 想一览基本的概念,请阅读[基本概念](/02-guide/concepts) - 想一览基本的概念,请阅读[基本概念](/02-guide/concepts/)
- 想通过一个完整的例子使用Sharding-JDBC进行分库分表,请阅读[如何分库分表](/02-guide/sharding)章节。 - 想通过一个完整的例子使用Sharding-JDBC进行分库分表,请阅读[如何分库分表](/02-guide/sharding/)章节。
- 分库分表后,要进一步提高性能,可以使用[读写分离](/02-guide/master-slave)功能。 - 分库分表后,要进一步提高性能,可以使用[读写分离](/02-guide/master-slave/)功能。
- [使用配置文件](/02-guide/configuration)介绍了如何通过YAML和Spring两种方式配置。 - [配置手册](/02-guide/configuration/)介绍了如何通过YAML和Spring两种方式配置。
- 一般情况Sharding-JDBC是通过SQL解析来获取数据路由数据的,但也可以使用[强制路由](/02-guide/hint-sharding-value)方式来设置分片数据。该模式非常适合存量系统扩容。 - 一般情况Sharding-JDBC是通过SQL解析来获取数据路由数据的,但也可以使用[强制路由](/02-guide/hint-sharding-value/)方式来设置分片数据。该模式非常适合存量系统扩容。
- 分库分表后主键如何生成?[分布式主键](/02-guide/id-generator)将给你答案。 - 分库分表后主键如何生成?[分布式主键](/02-guide/id-generator/)将给你答案。
- 分库后事务如何保证?[事务支持](/02-guide/transaction)将介绍Sharding-JDBC如何通过使用柔性事务的方式来实现分布式事务。 - 分库后事务如何保证?[事务支持](/02-guide/transaction/)将介绍Sharding-JDBC如何通过使用柔性事务的方式来实现分布式事务。
...@@ -3,8 +3,8 @@ toc = true ...@@ -3,8 +3,8 @@ toc = true
date = "2016-12-06T22:38:50+08:00" date = "2016-12-06T22:38:50+08:00"
title = "读写分离" title = "读写分离"
weight = 3 weight = 3
prev = "/02-guide/sharding" prev = "/02-guide/sharding/"
next = "/02-guide/configuration" next = "/02-guide/configuration/"
+++ +++
......
...@@ -3,8 +3,8 @@ toc = true ...@@ -3,8 +3,8 @@ toc = true
date = "2016-12-06T22:38:50+08:00" date = "2016-12-06T22:38:50+08:00"
title = "分库分表" title = "分库分表"
weight = 2 weight = 2
prev = "/02-guide/concepts" prev = "/02-guide/concepts/"
next = "/02-guide/master-slave" next = "/02-guide/master-slave/"
+++ +++
......
...@@ -3,8 +3,8 @@ toc = true ...@@ -3,8 +3,8 @@ toc = true
date = "2016-12-06T22:38:50+08:00" date = "2016-12-06T22:38:50+08:00"
title = "事务支持" title = "事务支持"
weight = 8 weight = 8
prev = "/02-guide/master-slave" prev = "/02-guide/id-generator/"
next = "/03-design" next = "/03-design/index/"
+++ +++
......
...@@ -3,18 +3,18 @@ toc = true ...@@ -3,18 +3,18 @@ toc = true
date = "2016-12-06T22:38:50+08:00" date = "2016-12-06T22:38:50+08:00"
title = "架构设计" title = "架构设计"
weight = 1 weight = 1
prev = "/03-design" prev = "/03-design/index/"
next = "/03-design/module" next = "/03-design/module/"
+++ +++
![整体架构图](../../img/architecture.png) ![整体架构图](/img/architecture.png)
![SQL解析](../../img/parse.png) ![SQL解析](/img/parse.png)
![SQL路由](../../img/route.png) ![SQL路由](/img/route.png)
![SQL执行](../../img/execute.png) ![SQL执行](/img/execute.png)
![结果归并](../../img/merge.png) ![结果归并](/img/merge.png)
...@@ -3,13 +3,13 @@ icon = "<b>3. </b>" ...@@ -3,13 +3,13 @@ icon = "<b>3. </b>"
date = "2016-12-12T16:06:17+08:00" date = "2016-12-12T16:06:17+08:00"
title = "设计规划" title = "设计规划"
weight = 0 weight = 0
prev = "/02-guide/soft-transaction" prev = "/02-guide/transaction/"
next = "/03-design/architecture" next = "/03-design/architecture/"
chapter = true chapter = true
+++ +++
# 本章导航 # 本章导航
- 想了解架构设计及项目模块设计的概念,请阅读[架构设计](/03-design/architecture)[目录结构说明](/03-design/module) - 想了解架构设计及项目模块设计的概念,请阅读[架构设计](/03-design/architecture/)[目录结构说明](/03-design/module/)
- Sharding-JDBC未来规划有哪些呢?请阅读[未来规划](/03-design/roadmap) - Sharding-JDBC未来规划有哪些呢?请阅读[未来规划](/03-design/roadmap/)
\ No newline at end of file \ No newline at end of file
...@@ -3,8 +3,8 @@ toc = true ...@@ -3,8 +3,8 @@ toc = true
date = "2016-12-06T22:38:50+08:00" date = "2016-12-06T22:38:50+08:00"
title = "目录结构说明" title = "目录结构说明"
weight = 3 weight = 3
prev = "/03-design/architecture" prev = "/03-design/architecture/"
next = "/03-design/roadmap" next = "/03-design/roadmap/"
+++ +++
......
...@@ -5,7 +5,6 @@ title = "未来线路规划" ...@@ -5,7 +5,6 @@ title = "未来线路规划"
weight = 4 weight = 4
prev = "/03-design/module" prev = "/03-design/module"
next = "/00-overview" next = "/00-overview"
+++ +++
## 已完成 ## 已完成
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册