From 8a94b69767245bfa8bf87f8e52a55554ba5618af Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=9C=B1=E8=89=AF=E6=89=8D?= <1024955966@qq.com>
Date: Tue, 10 Sep 2019 08:59:40 +0800
Subject: [PATCH 01/17] jvm
---
...\275\275\345\234\250jvm\344\270\212\344\272\206" | 13 +++++++++++++
1 file changed, 13 insertions(+)
create mode 100644 "\351\235\242\350\257\225\345\217\210\350\275\275\345\234\250jvm\344\270\212\344\272\206"
diff --git "a/\351\235\242\350\257\225\345\217\210\350\275\275\345\234\250jvm\344\270\212\344\272\206" "b/\351\235\242\350\257\225\345\217\210\350\275\275\345\234\250jvm\344\270\212\344\272\206"
new file mode 100644
index 00000000000..e797775aeb5
--- /dev/null
+++ "b/\351\235\242\350\257\225\345\217\210\350\275\275\345\234\250jvm\344\270\212\344\272\206"
@@ -0,0 +1,13 @@
+
+无论什么级别的Java从业者，JVM都是进阶时必须迈过的坎。不管是工作还是面试中，JVM都是必考题。如果不懂JVM的话，薪酬会非常吃亏（近70%的面试者挂在JVM上了）。
+
+
+掌握了JVM机制，就等于学会了深层次解决问题的方法。对于Java开发者而言，只有熟悉底层虚拟机的运行机制，才能通过JVM日志深入到字节码的层次去分析排查问题，发现隐性的系统缺陷，进而提升系统性能。
+
+
+一些技术人员开发工具用得很熟练，触及JVM问题时却是模棱两可，甚至连内存模型和内存区域，HotSpot和JVM规范，都混淆不清。工作很长时间，在生产时还在用缺省参数来直接启动，以致系统运行时出现性能、稳定性等问题时束手无措，不知该如何追踪排查。久而久之，这对自己的职业成长是极为不利的。
+
+
+掌握JVM，是深入Java技术栈的必经之路。
+
+
From d793bb4a42d26171cd033b4d8e99ed0a7fc2612b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=9C=B1=E8=89=AF=E6=89=8D?= <1024955966@qq.com>
Date: Tue, 10 Sep 2019 08:59:55 +0800
Subject: [PATCH 02/17] =?UTF-8?q?=E9=87=8D=E5=91=BD=E5=90=8D=20=E9=9D=A2?=
=?UTF-8?q?=E8=AF=95=E5=8F=88=E8=BD=BD=E5=9C=A8jvm=E4=B8=8A=E4=BA=86=20?=
=?UTF-8?q?=E4=B8=BA=20=E9=9D=A2=E8=AF=95=E5=8F=88=E8=BD=BD=E5=9C=A8jvm?=
=?UTF-8?q?=E4=B8=8A=E4=BA=86.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
...217\210\350\275\275\345\234\250jvm\344\270\212\344\272\206.md" | 0
1 file changed, 0 insertions(+), 0 deletions(-)
rename "\351\235\242\350\257\225\345\217\210\350\275\275\345\234\250jvm\344\270\212\344\272\206" => "\351\235\242\350\257\225\345\217\210\350\275\275\345\234\250jvm\344\270\212\344\272\206.md" (100%)
diff --git "a/\351\235\242\350\257\225\345\217\210\350\275\275\345\234\250jvm\344\270\212\344\272\206" "b/\351\235\242\350\257\225\345\217\210\350\275\275\345\234\250jvm\344\270\212\344\272\206.md"
similarity index 100%
rename from "\351\235\242\350\257\225\345\217\210\350\275\275\345\234\250jvm\344\270\212\344\272\206"
rename to "\351\235\242\350\257\225\345\217\210\350\275\275\345\234\250jvm\344\270\212\344\272\206.md"
From 6f7f2cce78e3168e9418e656b269554dc6382953 Mon Sep 17 00:00:00 2001
From: zhuliangcai <1024955966@qq.com>
Date: Sat, 12 Oct 2019 16:37:53 +0800
Subject: [PATCH 03/17] =?UTF-8?q?=E9=94=99=E5=88=AB=E5=AD=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/system-design/data-communication/dubbo.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/system-design/data-communication/dubbo.md b/docs/system-design/data-communication/dubbo.md
index 17a08d8853a..f2e0ac48047 100644
--- a/docs/system-design/data-communication/dubbo.md
+++ b/docs/system-design/data-communication/dubbo.md
@@ -251,7 +251,7 @@ HelloService helloService;
zookeeper宕机与dubbo直连的情况在面试中可能会被经常问到，所以要引起重视。
-在实际生产中，假如zookeeper注册中心宕掉，一段时间内服务消费方还是能够调用提供方的服务的，实际上它使用的本地缓存进行通讯，这只是dubbo健壮性的一种提现。
+在实际生产中，假如zookeeper注册中心宕掉，一段时间内服务消费方还是能够调用提供方的服务的，实际上它使用的本地缓存进行通讯，这只是dubbo健壮性的一种体现。
**dubbo的健壮性表现：**
From 9e6bbcb5a78fc18eed97c2389a0cebe0b8c92386 Mon Sep 17 00:00:00 2001
From: Kou Shuang
Date: Mon, 14 Oct 2019 23:13:27 +0800
Subject: [PATCH 04/17] Update spring-boot-practical-projects.md
---
docs/data/spring-boot-practical-projects.md | 33 ++++++++++++++++++++-
1 file changed, 32 insertions(+), 1 deletion(-)
diff --git a/docs/data/spring-boot-practical-projects.md b/docs/data/spring-boot-practical-projects.md
index 09c545b198e..046af88a271 100644
--- a/docs/data/spring-boot-practical-projects.md
+++ b/docs/data/spring-boot-practical-projects.md
@@ -1,3 +1,5 @@
+最近经常被读者问到有没有 Spring Boot 实战项目可以学习，于是，我就去 Github 上找了 10 个我觉得还不错的实战项目。对于这些实战项目，有部分是比较适合 Spring Boot 刚入门的朋友学习的，还有一部分可能要求你对 Spring Boot 相关技术比较熟悉。需要的朋友可以根据个人实际情况进行选择。如果你对 Spring Boot 不太熟悉的话，可以看我最近开源的 springboot-guide：https://github.com/Snailclimb/springboot-guide 入门（还在持续更新中）。
+
### mall
- **Github地址**： [https://github.com/macrozheng/mall](https://github.com/macrozheng/mall)
@@ -32,4 +34,33 @@
- **Github地址**：[https://github.com/YunaiV/onemall](https://github.com/YunaiV/onemall)
- **star**: 1.2k
-- **介绍**: mall 商城，基于微服务的思想，构建在 B2C 电商场景下的项目实战。核心技术栈，是 Spring Boot + Dubbo 。未来，会重构成 Spring Cloud Alibaba 。
\ No newline at end of file
+- **介绍**: mall 商城，基于微服务的思想，构建在 B2C 电商场景下的项目实战。核心技术栈，是 Spring Boot + Dubbo 。未来，会重构成 Spring Cloud Alibaba 。
+
+### Guns
+
+- **Github地址**：[https://github.com/stylefeng/Guns](https://github.com/stylefeng/Guns)
+- **star**: 2.3k
+- **介绍**: Guns基于SpringBoot 2，致力于做更简洁的后台管理系统，完美整合springmvc + shiro + mybatis-plus + beetl!Guns项目代码简洁，注释丰富，上手容易，同时Guns包含许多基础模块(用户管理，角色管理，部门管理，字典管理等10个模块)，可以直接作为一个后台管理系统的脚手架!
+
+### SpringCloud
+
+- **Github地址**：[https://github.com/YunaiV/onemall](https://github.com/YunaiV/onemall)
+- **star**: 1.2k
+- **介绍**: mall 商城，基于微服务的思想，构建在 B2C 电商场景下的项目实战。核心技术栈，是 Spring Boot + Dubbo 。未来，会重构成 Spring Cloud Alibaba 。
+
+### SpringBoot-Shiro-Vue
+
+- **Github地址**：[https://github.com/Heeexy/SpringBoot-Shiro-Vue](https://github.com/Heeexy/SpringBoot-Shiro-Vue)
+- **star**: 1.8k
+- **介绍**: 提供一套基于Spring Boot-Shiro-Vue的权限管理思路.前后端都加以控制,做到按钮/接口级别的权限。
+
+### newbee-mall
+
+最近开源的一个商城项目。
+
+- **Github地址**：[https://github.com/newbee-ltd/newbee-mall](https://github.com/newbee-ltd/newbee-mall)
+- **star**: 50
+- **介绍**: newbee-mall 项目是一套电商系统，包括 newbee-mall 商城系统及 newbee-mall-admin 商城后台管理系统，基于 Spring Boot 2.X 及相关技术栈开发。 前台商城系统包含首页门户、商品分类、新品上线、首页轮播、商品推荐、商品搜索、商品展示、购物车、订单结算、订单流程、个人订单管理、会员中心、帮助中心等模块。 后台管理系统包含数据面板、轮播图管理、商品管理、订单管理、会员管理、分类管理、设置等模块。
+
+
+
From 0da7385b1c397d919b9f082d2eaffca73b652d1e Mon Sep 17 00:00:00 2001
From: Yixi Chen
Date: Mon, 14 Oct 2019 21:44:47 -0700
Subject: [PATCH 05/17] Adding correction for #497
---
...\270\270\350\247\201\351\235\242\350\257\225\351\242\230.md" | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git "a/docs/java/collection/Java\351\233\206\345\220\210\346\241\206\346\236\266\345\270\270\350\247\201\351\235\242\350\257\225\351\242\230.md" "b/docs/java/collection/Java\351\233\206\345\220\210\346\241\206\346\236\266\345\270\270\350\247\201\351\235\242\350\257\225\351\242\230.md"
index a920af8b5ec..db10324fcc3 100644
--- "a/docs/java/collection/Java\351\233\206\345\220\210\346\241\206\346\236\266\345\270\270\350\247\201\351\235\242\350\257\225\351\242\230.md"
+++ "b/docs/java/collection/Java\351\233\206\345\220\210\346\241\206\346\236\266\345\270\270\350\247\201\351\235\242\350\257\225\351\242\230.md"
@@ -47,7 +47,7 @@
- **2. 底层数据结构：** `Arraylist` 底层使用的是 **`Object` 数组**；`LinkedList` 底层使用的是 **双向链表** 数据结构（JDK1.6之前为循环链表，JDK1.7取消了循环。注意双向链表和双向循环链表的区别，下面有介绍到！）
-- **3. 插入和删除是否受元素位置的影响：** ① **`ArrayList` 采用数组存储，所以插入和删除元素的时间复杂度受元素位置的影响。** 比如：执行`add(E e) `方法的时候， `ArrayList` 会默认在将指定的元素追加到此列表的末尾，这种情况时间复杂度就是O(1)。但是如果要在指定位置 i 插入和删除元素的话（`add(int index, E element) `）时间复杂度就为 O(n-i)。因为在进行上述操作的时候集合中第 i 和第 i 个元素之后的(n-i)个元素都要执行向后位/向前移一位的操作。 ② **`LinkedList` 采用链表存储，所以插入，删除元素时间复杂度不受元素位置的影响，都是近似 O（1）而数组为近似 O（n）。**
+- **3. 插入和删除是否受元素位置的影响：** ① **`ArrayList` 采用数组存储，所以插入和删除元素的时间复杂度受元素位置的影响。** 比如：执行`add(E e) `方法的时候， `ArrayList` 会默认在将指定的元素追加到此列表的末尾，这种情况时间复杂度就是O(1)。但是如果要在指定位置 i 插入和删除元素的话（`add(int index, E element) `）时间复杂度就为 O(n-i)。因为在进行上述操作的时候集合中第 i 和第 i 个元素之后的(n-i)个元素都要执行向后位/向前移一位的操作。 ② **`LinkedList` 采用链表存储，所以对于`add(E e)`方法的插入，删除元素时间复杂度不受元素位置的影响，近似 O（1），如果是要在指定位置`i`插入和删除元素的话（`(add(int index, E element)`） 时间复杂度应为`o(n))`因为需要新创立一个新的链表，复制前i-1个元素并在第i位加入新的元素，最后附上n-i个元素。**
- **4. 是否支持快速随机访问：** `LinkedList` 不支持高效的随机元素访问，而 `ArrayList` 支持。快速随机访问就是通过元素的序号快速获取元素对象(对应于`get(int index) `方法)。
From 99e7e29bae5812c5a038c1616f951d2c105827b3 Mon Sep 17 00:00:00 2001
From: Kou Shuang
Date: Thu, 17 Oct 2019 16:12:09 +0800
Subject: [PATCH 06/17] =?UTF-8?q?=E5=88=86=E5=BA=93=E5=88=86=E8=A1=A8?=
=?UTF-8?q?=E4=B9=8B=E5=90=8E,id=20=E4=B8=BB=E9=94=AE=E5=A6=82=E4=BD=95?=
=?UTF-8?q?=E5=A4=84=E7=90=86=EF=BC=9F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/database/MySQL.md | 15 +-
.../kafaka/\345\211\215\350\250\200.md" | 202 ++++++++++++++++++
2 files changed, 215 insertions(+), 2 deletions(-)
create mode 100644 "media/pictures/kafaka/\345\211\215\350\250\200.md"
diff --git a/docs/database/MySQL.md b/docs/database/MySQL.md
index 144607da393..0619c629393 100644
--- a/docs/database/MySQL.md
+++ b/docs/database/MySQL.md
@@ -1,7 +1,5 @@
点击关注[公众号](#公众号)及时获取笔主最新更新文章，并可免费领取本文档配套的《Java面试突击》以及Java工程师必备学习资源。
-
-
- [书籍推荐](#书籍推荐)
- [文字教程推荐](#文字教程推荐)
- [视频教程推荐](#视频教程推荐)
@@ -288,6 +286,19 @@ InnoDB 存储引擎在 **分布式事务** 的情况下一般会用到 **SERIALI
详细内容可以参考： MySQL大表优化方案: [https://segmentfault.com/a/1190000006158186](https://segmentfault.com/a/1190000006158186)
+### 分库分表之后,id 主键如何处理？
+
+因为要是分成多个表之后，每个表都是从 1 开始累加，这样是不对的，我们需要一个全局唯一的 id 来支持。
+
+生成全局 id 有下面这几种方式：
+
+- **UUID**：不适合作为主键，因为太长了，并且无序不可读，查询效率低。比较适合用于生成唯一的名字的标示比如文件的名字。
+- **数据库自增 id** : 两台数据库分别设置不同步长，生成不重复ID的策略来实现高可用。这种方式生成的 id 有序，但是需要独立部署数据库实例，成本高，还会有性能瓶颈。
+- **利用 redis 生成 id :** 性能比较好，灵活方便，不依赖于数据库。但是，引入了新的组件造成系统更加复杂，可用性降低，编码更加复杂，增加了系统成本。
+- **Twitter的snowflake算法** ：Github 地址：https://github.com/twitter-archive/snowflake。
+- **美团的[Leaf](https://tech.meituan.com/2017/04/21/mt-leaf.html)分布式ID生成系统** ：Leaf 是美团开源的分布式ID生成器，能保证全局唯一性、趋势递增、单调递增、信息安全，里面也提到了几种分布式方案的对比，但也需要依赖关系数据库、Zookeeper等中间件。感觉还不错。美团技术团队的一篇文章：https://tech.meituan.com/2017/04/21/mt-leaf.html 。
+- ......
+
### 一条SQL语句在MySQL中如何执行的
[一条SQL语句在MySQL中如何执行的]()
diff --git "a/media/pictures/kafaka/\345\211\215\350\250\200.md" "b/media/pictures/kafaka/\345\211\215\350\250\200.md"
new file mode 100644
index 00000000000..24d6e370e5d
--- /dev/null
+++ "b/media/pictures/kafaka/\345\211\215\350\250\200.md"
@@ -0,0 +1,202 @@
+# 前言
+
+谈到java的线程池最熟悉的莫过于ExecutorService接口了，jdk1.5新增的java.util.concurrent包下的这个api，大大的简化了多线程代码的开发。而不论你用FixedThreadPool还是CachedThreadPool其背后实现都是ThreadPoolExecutor。ThreadPoolExecutor是一个典型的缓存池化设计的产物，因为池子有大小，当池子体积不够承载时，就涉及到拒绝策略。JDK中已经预设了4种线程池拒绝策略，下面结合场景详细聊聊这些策略的使用场景，以及我们还能扩展哪些拒绝策略。
+
+# 池化设计思想
+
+池话设计应该不是一个新名词。我们常见的如java线程池、jdbc连接池、redis连接池等就是这类设计的代表实现。这种设计会初始预设资源，解决的问题就是抵消每次获取资源的消耗，如创建线程的开销，获取远程连接的开销等。就好比你去食堂打饭，打饭的大妈会先把饭盛好几份放那里，你来了就直接拿着饭盒加菜即可，不用再临时又盛饭又打菜，效率就高了。除了初始化资源，池化设计还包括如下这些特征：池子的初始值、池子的活跃值、池子的最大值等，这些特征可以直接映射到java线程池和数据库连接池的成员属性中。
+
+# 线程池触发拒绝策略的时机
+
+和数据源连接池不一样，线程池除了初始大小和池子最大值，还多了一个阻塞队列来缓冲。数据源连接池一般请求的连接数超过连接池的最大值的时候就会触发拒绝策略，策略一般是阻塞等待设置的时间或者直接抛异常。而线程池的触发时机如下图：
+
+
+
+如图，想要了解线程池什么时候触发拒绝粗略，需要明确上面三个参数的具体含义，是这三个参数总体协调的结果，而不是简单的超过最大线程数就会触发线程拒绝粗略，当提交的任务数大于corePoolSize时，会优先放到队列缓冲区，只有填满了缓冲区后，才会判断当前运行的任务是否大于maxPoolSize，小于时会新建线程处理。大于时就触发了拒绝策略，总结就是：当前提交任务数大于（maxPoolSize + queueCapacity）时就会触发线程池的拒绝策略了。
+
+# JDK内置4种线程池拒绝策略
+
+# 拒绝策略接口定义
+
+在分析JDK自带的线程池拒绝策略前，先看下JDK定义的 拒绝策略接口，如下：
+
+```java
+public interface RejectedExecutionHandler {
+ void rejectedExecution(Runnable r, ThreadPoolExecutor executor);
+}
+```
+
+接口定义很明确，当触发拒绝策略时，线程池会调用你设置的具体的策略，将当前提交的任务以及线程池实例本身传递给你处理，具体作何处理，不同场景会有不同的考虑，下面看JDK为我们内置了哪些实现：
+
+# CallerRunsPolicy（调用者运行策略）
+
+```java
+ public static class CallerRunsPolicy implements RejectedExecutionHandler {
+
+ public CallerRunsPolicy() { }
+
+ public void rejectedExecution(Runnable r, ThreadPoolExecutor e) {
+ if (!e.isShutdown()) {
+ r.run();
+ }
+ }
+ }
+```
+
+功能：当触发拒绝策略时，只要线程池没有关闭，就由提交任务的当前线程处理。
+
+使用场景：一般在不允许失败的、对性能要求不高、并发量较小的场景下使用，因为线程池一般情况下不会关闭，也就是提交的任务一定会被运行，但是由于是调用者线程自己执行的，当多次提交任务时，就会阻塞后续任务执行，性能和效率自然就慢了。
+
+# AbortPolicy（中止策略）
+
+```java
+ public static class AbortPolicy implements RejectedExecutionHandler {
+
+ public AbortPolicy() { }
+
+ public void rejectedExecution(Runnable r, ThreadPoolExecutor e) {
+ throw new RejectedExecutionException("Task " + r.toString() +
+ " rejected from " +
+ e.toString());
+ }
+ }
+```
+
+功能：当触发拒绝策略时，直接抛出拒绝执行的异常，中止策略的意思也就是打断当前执行流程
+
+使用场景：这个就没有特殊的场景了，但是一点要正确处理抛出的异常。ThreadPoolExecutor中默认的策略就是AbortPolicy，ExecutorService接口的系列ThreadPoolExecutor因为都没有显示的设置拒绝策略，所以默认的都是这个。但是请注意，ExecutorService中的线程池实例队列都是无界的，也就是说把内存撑爆了都不会触发拒绝策略。当自己自定义线程池实例时，使用这个策略一定要处理好触发策略时抛的异常，因为他会打断当前的执行流程。
+
+# DiscardPolicy（丢弃策略）
+
+```java
+ public static class DiscardPolicy implements RejectedExecutionHandler {
+
+ public DiscardPolicy() { }
+
+ public void rejectedExecution(Runnable r, ThreadPoolExecutor e) {
+ }
+ }
+```
+
+功能：如果线程池未关闭，就弹出队列头部的元素，然后尝试执行
+
+使用场景：这个策略还是会丢弃任务，丢弃时也是毫无声息，但是特点是丢弃的是老的未执行的任务，而且是待执行优先级较高的任务。基于这个特性，我能想到的场景就是，发布消息，和修改消息，当消息发布出去后，还未执行，此时更新的消息又来了，这个时候未执行的消息的版本比现在提交的消息版本要低就可以被丢弃了。因为队列中还有可能存在消息版本更低的消息会排队执行，所以在真正处理消息的时候一定要做好消息的版本比较
+
+# 第三方实现的拒绝策略
+
+# dubbo中的线程拒绝策略
+
+```java
+public class AbortPolicyWithReport extends ThreadPoolExecutor.AbortPolicy {
+
+ protected static final Logger logger = LoggerFactory.getLogger(AbortPolicyWithReport.class);
+
+ private final String threadName;
+
+ private final URL url;
+
+ private static volatile long lastPrintTime = 0;
+
+ private static Semaphore guard = new Semaphore(1);
+
+ public AbortPolicyWithReport(String threadName, URL url) {
+ this.threadName = threadName;
+ this.url = url;
+ }
+
+ @Override
+ public void rejectedExecution(Runnable r, ThreadPoolExecutor e) {
+ String msg = String.format("Thread pool is EXHAUSTED!" +
+ " Thread Name: %s, Pool Size: %d (active: %d, core: %d, max: %d, largest: %d), Task: %d (completed: %d)," +
+ " Executor status:(isShutdown:%s, isTerminated:%s, isTerminating:%s), in %s://%s:%d!",
+ threadName, e.getPoolSize(), e.getActiveCount(), e.getCorePoolSize(), e.getMaximumPoolSize(), e.getLargestPoolSize(),
+ e.getTaskCount(), e.getCompletedTaskCount(), e.isShutdown(), e.isTerminated(), e.isTerminating(),
+ url.getProtocol(), url.getIp(), url.getPort());
+ logger.warn(msg);
+ dumpJStack();
+ throw new RejectedExecutionException(msg);
+ }
+
+ private void dumpJStack() {
+ //省略实现
+ }
+}
+```
+
+可以看到，当dubbo的工作线程触发了线程拒绝后，主要做了三个事情，原则就是尽量让使用者清楚触发线程拒绝策略的真实原因
+
+- 输出了一条警告级别的日志，日志内容为线程池的详细设置参数，以及线程池当前的状态，还有当前拒绝任务的一些详细信息。可以说，这条日志，使用dubbo的有过生产运维经验的或多或少是见过的，这个日志简直就是日志打印的典范，其他的日志打印的典范还有spring。得益于这么详细的日志，可以很容易定位到问题所在
+- 输出当前线程堆栈详情，这个太有用了，当你通过上面的日志信息还不能定位问题时，案发现场的dump线程上下文信息就是你发现问题的救命稻草。
+- 继续抛出拒绝执行异常，使本次任务失败，这个继承了JDK默认拒绝策略的特性
+
+# Netty中的线程池拒绝策略
+
+```java
+ private static final class NewThreadRunsPolicy implements RejectedExecutionHandler {
+ NewThreadRunsPolicy() {
+ super();
+ }
+
+ public void rejectedExecution(Runnable r, ThreadPoolExecutor executor) {
+ try {
+ final Thread t = new Thread(r, "Temporary task executor");
+ t.start();
+ } catch (Throwable e) {
+ throw new RejectedExecutionException(
+ "Failed to start a new thread", e);
+ }
+ }
+ }
+```
+
+Netty中的实现很像JDK中的CallerRunsPolicy，舍不得丢弃任务。不同的是，CallerRunsPolicy是直接在调用者线程执行的任务。而 Netty是新建了一个线程来处理的。所以，Netty的实现相较于调用者执行策略的使用面就可以扩展到支持高效率高性能的场景了。但是也要注意一点，Netty的实现里，在创建线程时未做任何的判断约束，也就是说只要系统还有资源就会创建新的线程来处理，直到new不出新的线程了，才会抛创建线程失败的异常
+
+# ActiveMq中的线程池拒绝策略
+
+```java
+new RejectedExecutionHandler() {
+ @Override
+ public void rejectedExecution(final Runnable r, final ThreadPoolExecutor executor) {
+ try {
+ executor.getQueue().offer(r, 60, TimeUnit.SECONDS);
+ } catch (InterruptedException e) {
+ throw new RejectedExecutionException("Interrupted waiting for BrokerService.worker");
+ }
+
+ throw new RejectedExecutionException("Timed Out while attempting to enqueue Task.");
+ }
+ });
+```
+
+ActiveMq中的策略属于最大努力执行任务型，当触发拒绝策略时，在尝试一分钟的时间重新将任务塞进任务队列，当一分钟超时还没成功时，就抛出异常
+
+# pinpoint中的线程池拒绝策略
+
+```java
+public class RejectedExecutionHandlerChain implements RejectedExecutionHandler {
+ private final RejectedExecutionHandler[] handlerChain;
+
+ public static RejectedExecutionHandler build(List chain) {
+ Objects.requireNonNull(chain, "handlerChain must not be null");
+ RejectedExecutionHandler[] handlerChain = chain.toArray(new RejectedExecutionHandler[0]);
+ return new RejectedExecutionHandlerChain(handlerChain);
+ }
+
+ private RejectedExecutionHandlerChain(RejectedExecutionHandler[] handlerChain) {
+ this.handlerChain = Objects.requireNonNull(handlerChain, "handlerChain must not be null");
+ }
+
+ @Override
+ public void rejectedExecution(Runnable r, ThreadPoolExecutor executor) {
+ for (RejectedExecutionHandler rejectedExecutionHandler : handlerChain) {
+ rejectedExecutionHandler.rejectedExecution(r, executor);
+ }
+ }
+}
+```
+
+pinpoint的拒绝策略实现很有特点，和其他的实现都不同。他定义了一个拒绝策略链，包装了一个拒绝策略列表，当触发拒绝策略时，会将策略链中的rejectedExecution依次执行一遍
+
+# 结语
+
+前文从线程池设计思想，以及线程池触发拒绝策略的时机引出java线程池拒绝策略接口的定义。并辅以JDK内置4种以及四个第三方开源软件的拒绝策略定义描述了线程池拒绝策略实现的各种思路和使用场景。希望阅读此文后能让你对java线程池拒绝策略有更加深刻的认识，能够根据不同的使用场景更加灵活的应用。
\ No newline at end of file
From 53f1a60b7b014939795d01f75d3e6fdf4eb7ade2 Mon Sep 17 00:00:00 2001
From: Kou Shuang
Date: Thu, 17 Oct 2019 17:03:36 +0800
Subject: [PATCH 07/17] =?UTF-8?q?Create=20=E9=98=BF=E9=87=8C=E5=B7=B4?=
=?UTF-8?q?=E5=B7=B4=E5=BC=80=E5=8F=91=E6=89=8B=E5=86=8C=E6=95=B0=E6=8D=AE?=
=?UTF-8?q?=E5=BA=93=E9=83=A8=E5=88=86=E7=9A=84=E4=B8=80=E4=BA=9B=E6=9C=80?=
=?UTF-8?q?=E4=BD=B3=E5=AE=9E=E8=B7=B5.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
...00\344\275\263\345\256\236\350\267\265.md" | 41 +++++++++++++++++++
1 file changed, 41 insertions(+)
create mode 100644 "docs/database/\351\230\277\351\207\214\345\267\264\345\267\264\345\274\200\345\217\221\346\211\213\345\206\214\346\225\260\346\215\256\345\272\223\351\203\250\345\210\206\347\232\204\344\270\200\344\272\233\346\234\200\344\275\263\345\256\236\350\267\265.md"
diff --git "a/docs/database/\351\230\277\351\207\214\345\267\264\345\267\264\345\274\200\345\217\221\346\211\213\345\206\214\346\225\260\346\215\256\345\272\223\351\203\250\345\210\206\347\232\204\344\270\200\344\272\233\346\234\200\344\275\263\345\256\236\350\267\265.md" "b/docs/database/\351\230\277\351\207\214\345\267\264\345\267\264\345\274\200\345\217\221\346\211\213\345\206\214\346\225\260\346\215\256\345\272\223\351\203\250\345\210\206\347\232\204\344\270\200\344\272\233\346\234\200\344\275\263\345\256\236\350\267\265.md"
new file mode 100644
index 00000000000..7eb84001c00
--- /dev/null
+++ "b/docs/database/\351\230\277\351\207\214\345\267\264\345\267\264\345\274\200\345\217\221\346\211\213\345\206\214\346\225\260\346\215\256\345\272\223\351\203\250\345\210\206\347\232\204\344\270\200\344\272\233\346\234\200\344\275\263\345\256\236\350\267\265.md"
@@ -0,0 +1,41 @@
+# 阿里巴巴Java开发手册数据库部分的一些最佳实践总结
+
+## 模糊查询
+
+对于模糊查询阿里巴巴开发手册这样说到：
+
+> 【强制】页面搜索严禁左模糊或者全模糊，如果需要请走搜索引擎来解决。
+>
+> 说明:索引文件具有 B-Tree 的最左前缀匹配特性，如果左边的值未确定，那么无法使用此索引。
+
+## 外键和级联
+
+对于外键和级联，阿里巴巴开发手册这样说到：
+
+>【强制】不得使用外键与级联，一切外键概念必须在应用层解决。
+>
+>说明:以学生和成绩的关系为例，学生表中的 student_id 是主键，那么成绩表中的 student_id 则为外键。如果更新学生表中的 student_id，同时触发成绩表中的 student_id 更新，即为级联更新。外键与级联更新适用于单机低并发，不适合分布式、高并发集群;级联更新是强阻塞，存在数据库更新风暴的风 险;外键影响数据库的插入速度
+
+为什么不要用外键呢？大部分人可能会这样回答：
+
+> 1. **增加了复杂性：** a.每次做DELETE 或者UPDATE都必须考虑外键约束，会导致开发的时候很痛苦,测试数据极为不方便;b.外键的主从关系是定的，假如那天需求有变化，数据库中的这个字段根本不需要和其他表有关联的话就会增加很多麻烦。
+> 2. **增加了额外工作**： 数据库需要增加维护外键的工作，比如当我们做一些涉及外键字段的增，删，更新操作之后，需要触发相关操作去检查，保证数据的的一致性和正确性，这样会不得不消耗资源；（个人觉得这个不是不用外键的原因，因为即使你不使用外键，你在应用层面也还是要保证的。所以，我觉得这个影响可以忽略不计。）
+> 3. 外键还会因为需要请求对其他表内部加锁而容易出现死锁情况；
+> 4. **对分不分表不友好** ：因为分库分表下外键是无法生效的。
+> 5. ......
+
+我个人觉得上面这种回答不是特别的全面，只是说了外键存在的一个常见的问题。实际上，我们知道外键也是有很多好处的，比如：
+
+1. 保证了数据库数据的一致性和完整性；
+2. 级联操作方便，减轻了程序代码量；
+3. ......
+
+所以说，不要一股脑的就抛弃了外键这个概念，既然它存在就有它存在的道理，如果系统不涉及分不分表，并发量不是很高的情况还是可以考虑使用外键的。
+
+我个人是不太喜欢外键约束，比较喜欢在应用层去进行相关操作。
+
+## 关于@Transactional注解
+
+对于`@Transactional`事务注解，阿里巴巴开发手册这样说到：
+
+>【参考】@Transactional事务不要滥用。事务会影响数据库的QPS，另外使用事务的地方需要考虑各方面的回滚方案，包括缓存回滚、搜索引擎回滚、消息补偿、统计修正等。
From 57a4669d8865cecbb9f3d16522a293da76c9c948 Mon Sep 17 00:00:00 2001
From: Kou Shuang
Date: Thu, 17 Oct 2019 17:03:39 +0800
Subject: [PATCH 08/17] Update README.md
---
README.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/README.md b/README.md
index 2055a367f2d..2054b257062 100644
--- a/README.md
+++ b/README.md
@@ -143,6 +143,7 @@
### MySQL
* **[MySQL 学习与面试](docs/database/MySQL.md)**
+* **[阿里巴巴开发手册数据库部分的一些最佳实践](docs/database/阿里巴巴开发手册数据库部分的一些最佳实践.md)**
* **[一千行MySQL学习笔记](docs/database/一千行MySQL命令.md)**
* [MySQL高性能优化规范建议](docs/database/MySQL高性能优化规范建议.md)
* [数据库索引总结](docs/database/MySQL%20Index.md)
From fec28d749c8210d3296539008b84c727d1a09680 Mon Sep 17 00:00:00 2001
From: Kou Shuang
Date: Thu, 17 Oct 2019 22:17:03 +0800
Subject: [PATCH 09/17] add sponsor
---
README.md | 5 ++++-
media/sponsor/WechatIMG143.jpeg | Bin 0 -> 52098 bytes
2 files changed, 4 insertions(+), 1 deletion(-)
create mode 100644 media/sponsor/WechatIMG143.jpeg
diff --git a/README.md b/README.md
index 2054b257062..02a7956b69a 100644
--- a/README.md
+++ b/README.md
@@ -21,6 +21,9 @@
+Sponsor
+
+
推荐使用 https://snailclimb.top/JavaGuide/ 在线阅读(访问速度慢的话，请使用 https://snailclimb.gitee.io/javaguide )，在线阅读内容本仓库同步一致。这种方式阅读的优势在于：有侧边栏阅读体验更好，Gitee pages 的访问速度相对来说也比较快。
## 目录
@@ -142,7 +145,7 @@
### MySQL
-* **[MySQL 学习与面试](docs/database/MySQL.md)**
+* **[【推荐】MySQL/数据库 知识点总结](docs/database/MySQL.md)**
* **[阿里巴巴开发手册数据库部分的一些最佳实践](docs/database/阿里巴巴开发手册数据库部分的一些最佳实践.md)**
* **[一千行MySQL学习笔记](docs/database/一千行MySQL命令.md)**
* [MySQL高性能优化规范建议](docs/database/MySQL高性能优化规范建议.md)
diff --git a/media/sponsor/WechatIMG143.jpeg b/media/sponsor/WechatIMG143.jpeg
new file mode 100644
index 0000000000000000000000000000000000000000..5e1b53b496252d515066a3a99b5c633d9f183029
GIT binary patch
literal 52098
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