From ea02f1c503ae97951cb6960c469c7ef995db01f9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=B3=95=E7=84=B6?= Date: Mon, 5 Dec 2022 11:53:08 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E4=B8=80=E4=B8=AA=E9=9D=9E?= =?UTF-8?q?=E5=B8=B8=E4=BC=98=E7=A7=80=E7=9A=84=E4=BB=A3=E7=A0=81=E5=BA=93?= =?UTF-8?q?=E3=80=82redis=E5=92=8CMysql=E6=94=BE=E5=88=B0=E4=BA=86?= =?UTF-8?q?=E5=A4=96=E8=BE=B9=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Java基础教程/Java学习路线.md | 14 +- Java基础教程/Java容器/10 Java容器.md | 31 - Java基础教程/Java容器/11 JavaList.md | 0 Java基础教程/Java标准库/01 Object类.md | 39 ++ Java基础教程/Java标准库/02 包装器类.md | 72 +- Java基础教程/Java标准库/03 String类.md | 210 +++++- Java基础教程/Java标准库/04 Math类.md | 28 - Java基础教程/Java标准库/04 数学计算.md | 71 ++ Java基础教程/Java标准库/05 日期时间.md | 168 ++++- Java基础教程/Java标准库/07 正则表达式.md | 304 ++++++++- Java基础教程/Java标准库/08 随机数Random.md | 47 ++ Java基础教程/Java标准库/09 System类.md | 59 ++ Java基础教程/Java标准库/Arrays类.md | 20 - Java基础教程/Java标准库/StringBuffer.md | 140 ---- .../Java标准库/image/2022-07-12-11-07-56.png | Bin 0 -> 37828 bytes .../codedemo/aspectj/BusinessService.java | 142 ++++ .../codedemo/aspectj/BusinessServiceInterceptor.java | 122 ++++ .../Java源代码/codedemo/aspectj/build.xml | 64 ++ .../Java源代码/codedemo/dbutils/DbUtilsDemo.java | 205 ++++++ .../Java源代码/codedemo/dbutils/README.md | 226 +++++++ .../Java源代码/codedemo/dbutils/Student.java | 86 +++ .../Java源代码/codedemo/easymock/README.md | 258 ++++++++ .../Java源代码/codedemo/easymock/UserService.java | 56 ++ .../codedemo/easymock/UserServiceTest.java | 87 +++ .../Java源代码/codedemo/encrypt/AES.java | 54 ++ .../Java源代码/codedemo/encrypt/Blowfish.java | 51 ++ .../codedemo/encrypt/EncryptAndDecrypt.java | 125 ++++ .../Java源代码/codedemo/encrypt/HmacSha1.java | 53 ++ .../codedemo/encrypt/PerformanceCompare.java | 70 ++ .../codedemo/eventdriver_improve/ClientMain.java | 38 ++ .../codedemo/eventdriver_improve/Event.java | 28 + .../codedemo/eventdriver_improve/EventListener.java | 16 + .../eventdriver_improve/EventManagement.java | 64 ++ .../codedemo/eventdriver_improve/EventSource.java | 38 ++ .../codedemo/eventdriver_normal/ClientMain.java | 33 + .../codedemo/eventdriver_normal/Event.java | 17 + .../codedemo/eventdriver_normal/EventListener.java | 16 + .../codedemo/eventdriver_normal/EventSource.java | 47 ++ .../Java源代码/codedemo/httpclient/FluentApi.java | 85 +++ .../codedemo/httpclient/HttpClientBasic.java | 110 ++++ .../Java源代码/codedemo/httpclient/README.md | 9 + .../codedemo/httpclient/server/AbstractHandler.java | 71 ++ .../codedemo/httpclient/server/BinaryHandler.java | 66 ++ .../codedemo/httpclient/server/CharacterHandler.java | 50 ++ .../codedemo/httpclient/server/SimpleHttpServer.java | 41 ++ .../codedemo/io/MultiThreadEchoServer.java | 53 ++ .../codedemo/io/ThreadPoolEchoServer.java | 55 ++ .../Java源代码/codedemo/io/Worker.java | 77 +++ .../java/lang/instrument/FirstInstrumentation.java | 25 + .../java/lang/instrument/FirstTransformer.java | 26 + .../codedemo/java/lang/instrument/Hello.java | 14 + .../codedemo/java/lang/instrument/README.md | 40 ++ .../codedemo/java/lang/instrument/build.xml | 57 ++ .../codedemo/java/lang/reflect/ClassAnalyze.java | 143 ++++ .../codedemo/java/lang/reflect/CreateInstance.java | 36 + .../codedemo/java/lang/reflect/InvokeField.java | 37 ++ .../codedemo/java/lang/reflect/InvokeMethod.java | 84 +++ .../codedemo/java/lang/reflect/Man.java | 63 ++ .../codedemo/java/lang/serialization/Man.java | 74 +++ .../codedemo/java/lang/serialization/People.java | 79 +++ .../java/lang/serialization/TransientDemo.java | 126 ++++ .../Java源代码/codedemo/java/rmi/Gender.java | 20 + .../Java源代码/codedemo/java/rmi/RmiClient.java | 60 ++ .../Java源代码/codedemo/java/rmi/RmiServer.java | 53 ++ .../Java源代码/codedemo/java/rmi/User.java | 170 +++++ .../Java源代码/codedemo/java/rmi/UserService.java | 19 + .../codedemo/java/rmi/UserServiceImpl.java | 70 ++ .../util/concurret/ScheduledExecutorServiceDemo.java | 78 +++ .../codedemo/java/util/forkjoin/HelloForkJoin.java | 103 +++ .../codedemo/java/util/future/Future.ucls | 101 +++ .../codedemo/java/util/future/HelloFuture.java | 106 +++ .../codedemo/java/util/map/Map接口及其实现类.ucls | 139 ++++ .../codedemo/java/util/timer/TimerDemo.java | 47 ++ .../Java源代码/codedemo/jdbc/JDBCUtils.java | 64 ++ .../Java源代码/codedemo/jdbc/MetaDataExample.java | 82 +++ .../Java源代码/codedemo/jetty/HttpGet.java | 42 ++ .../Java源代码/codedemo/jetty/HttpGetTest.java | 55 ++ .../Java源代码/codedemo/jetty/HttpServerMock.java | 90 +++ .../Java源代码/codedemo/jetty/README.md | 216 ++++++ .../codedemo/json/gson/ArrayDeserialize.java | 45 ++ .../codedemo/json/gson/ArraySerialize.java | 41 ++ .../codedemo/json/gson/CollectionDeserialize.java | 55 ++ .../codedemo/json/gson/CollectionsSerialize.java | 54 ++ .../codedemo/json/gson/CustomDeserialize.java | 46 ++ .../codedemo/json/gson/CustomSerialize.java | 42 ++ .../Java源代码/codedemo/json/gson/Person.java | 50 ++ .../codedemo/json/gson/SimpleObjectSerialize.java | 39 ++ .../Java源代码/codedemo/misc/GetHostInfo.java | 63 ++ .../Java源代码/codedemo/mockito/Commodity.java | 50 ++ .../Java源代码/codedemo/mockito/CommodityDao.java | 20 + .../Java源代码/codedemo/mockito/User.java | 70 ++ .../Java源代码/codedemo/mockito/UserDao.java | 19 + .../Java源代码/codedemo/mockito/UserService.java | 54 ++ .../codedemo/mockito/UserServiceTest.java | 66 ++ .../codedemo/mybatis/MyBatisClient.java | 62 ++ .../Java源代码/codedemo/mybatis/README.md | 5 + .../codedemo/mybatis/dao/MonitNotifyHistoryDao.java | 79 +++ .../codedemo/mybatis/entity/MonitNotifyHistory.java | 105 +++ .../mybatis/mapper/MonitNotifyHistoryMapper.xml | 139 ++++ .../codedemo/netty40x/echo/EchoClient.java | 55 ++ .../codedemo/netty40x/echo/EchoClientHandler.java | 49 ++ .../codedemo/netty40x/echo/EchoServer.java | 58 ++ .../codedemo/netty40x/echo/EchoServerHandler.java | 38 ++ .../Java源代码/codedemo/nio/BufferIO.java | 61 ++ .../Java源代码/codedemo/nio/MemoryMapper.java | 73 +++ .../Java源代码/codedemo/nio/NioEchoServer.java | 296 +++++++++ .../Java源代码/codedemo/proxy/AccountService.java | 27 + .../codedemo/proxy/AccountServiceClient.java | 28 + .../codedemo/proxy/AccountServiceDynamicProxy.java | 42 ++ .../codedemo/proxy/AccountServiceImpl.java | 53 ++ .../codedemo/proxy/AccountServiceStaticProxy.java | 39 ++ .../Java源代码/codedemo/proxy/Result.java | 65 ++ .../Java源代码/codedemo/proxy/User.java | 38 ++ .../Java源代码/codedemo/reactor/Acceptor.java | 48 ++ .../Java源代码/codedemo/reactor/Constant.java | 25 + .../Java源代码/codedemo/reactor/Decoder.java | 20 + .../Java源代码/codedemo/reactor/Encoder.java | 20 + .../Java源代码/codedemo/reactor/LineDecoder.java | 50 ++ .../Java源代码/codedemo/reactor/LineEncoder.java | 31 + .../codedemo/reactor/ProcessService.java | 46 ++ .../Java源代码/codedemo/reactor/Reactor.java | 113 ++++ .../Java源代码/codedemo/reactor/Reader.java | 94 +++ .../Java源代码/codedemo/reactor/Writer.java | 41 ++ .../Java源代码/codedemo/redis/JedisDemo.java | 133 ++++ .../codedemo/script/MultiScriptEngineCompare.java | 250 +++++++ .../Java源代码/codedemo/script/PrettyTable.java | 125 ++++ .../codedemo/script/ScriptRunPerformence.java | 112 ++++ .../codedemo/script/SupportScriptEngine.java | 36 + .../Java源代码/codedemo/slf4j/HelloSlf4j.java | 31 + .../codedemo/thread/DaemonThreadDemo.java | 45 ++ .../Java源代码/codedemo/tree/PrettyTree.java | 118 ++++ .../Java源代码/codedemo/tree/PrettyTreeTest.java | 41 ++ .../Java源代码/codedemo/util/DateUtil.java | 32 + .../Java源代码/codedemo/util/LogUtil.java | 18 + .../Java源代码/codedemo/wiremock/HttpGetTest.java | 66 ++ .../Java源代码/codedemo/wiremock/README.md | 131 ++++ .../Java源代码/codedemo/xml/BookStore.xml | 33 + .../Java源代码/codedemo/xml/XPathDemo.java | 34 + .../{Java标准库 => Java网站开发}/41 Rest接口.md | 0 Java基础教程/Java语言基础/04 Java数组.md | 10 +- .../Java语言基础/05 面向对象的类与对象.md | 24 +- Java基础教程/Java语言基础/10 Java泛型.md | 239 +++++-- .../Java语言基础/18 ClassLoader机制.md | 0 Java基础教程/Java语言基础/19 staic关键字.md | 274 ++++++++ Java基础教程/Java语言基础/20 final关键字.md | 27 + .../Java语言基础/21 Java类加载机制.md | 89 +++ Java基础教程/Java语言基础/22 Java包机制.md | 43 ++ .../Java语言基础/image/2022-12-04-13-14-56.png | Bin 0 -> 105399 bytes .../Java语言基础/image/2022-12-04-13-15-46.png | Bin 0 -> 60584 bytes Java基础教程/Java集合类/01 Java数据结构.md | 267 ++++++++ Java基础教程/Java集合类/02 JavaCollection.md | 64 ++ Java基础教程/Java集合类/03 List-ArrayList.md | 616 ++++++++++++++++++ .../{Java容器 => Java集合类}/12 JavaQueue.md | 0 .../{Java容器 => Java集合类}/13 JavaSet.md | 0 .../{Java容器 => Java集合类}/14 JavaMap.md | 0 .../15 Java容器底层结构.md | 0 .../image/2022-11-08-10-51-54.png | Bin .../image/2022-11-08-10-54-19.png | Bin .../Java集合类/image/2022-12-04-22-09-27.png | Bin 0 -> 33420 bytes .../Java集合类/image/2022-12-04-22-17-09.png | Bin 0 -> 43974 bytes .../Java集合类/image/2022-12-04-22-20-35.png | Bin 0 -> 73071 bytes .../Java集合类/image/2022-12-04-22-53-11.png | Bin 0 -> 289910 bytes .../01.String 是如何实现的？它有哪些重要的方法？.md | 306 +++++++++ ...HashMap 底层实现原理是什么？JDK8 做了哪些优化？.md | 355 ++++++++++ Java基础教程/Java面试原理/03 关键字.md | 170 ----- .../03.线程的状态有哪些？它是如何工作的？.md | 332 ++++++++++ ...解 ThreadPoolExecutor 的参数含义及源码执行流程？.md | 362 ++++++++++ .../05.synchronized和ReentrantLock.md | 258 ++++++++ .../06.谈谈你对锁的理解？如何手动模拟一个死锁？.md | 235 +++++++ ....深克隆和浅克隆有什么区别？它的实现方式有哪些？.md | 519 +++++++++++++++ ...代理是如何实现的？JDK Proxy 和 CGLib 有什么区别？.md | 270 ++++++++ .../09.如何实现本地缓存和分布式缓存？.md | 416 ++++++++++++ .../10.如何手写一个消息队列和延迟消息队列？.md | 244 +++++++ .../11.底层源码分析Spring的核心功能和执行流程(上).md | 422 ++++++++++++ ...12.底层源码分析 Spring 的核心功能和执行流程(下).md | 366 +++++++++++ ...Batis使用了哪些设计模式？在源码中是如何体现的？.md | 314 +++++++++ ...14.SpringBoot有哪些优点？它和Spring有什么区别？.md | 266 ++++++++ .../15.MQ有什么作用？你都用过哪些MQ中间件.md | 112 ++++ .../16.MySQL 的运行机制是什么？它有哪些引擎？.md | 111 ++++ .../Java面试原理/17.MySQL 的优化方案有哪些？.md | 135 ++++ .../18.关系型数据和文档型数据库有什么区别？.md | 104 +++ .../19.Redis的过期策略和内存淘汰机制有什么区别？.md | 217 ++++++ .../Java面试原理/20.Redis怎样实现的分布式锁？.md | 130 ++++ ...1.Redis中如何实现的消息队列？实现的方式有几种？.md | 313 +++++++++ .../Java面试原理/22.Redis是如何实现高可用的？.md | 100 +++ .../Java面试原理/23.JVM 的内存布局和运行原理.md | 121 ++++ .../Java面试原理/24.垃圾回收算法有哪些？.md | 146 +++++ .../25.你用过哪些垃圾回收器？它们有什么区别？.md | 81 +++ .../26.生产环境如何排除和优化JVM？.md | 372 +++++++++++ .../27.单例的实现方式有几种？它们有什么优缺点？.md | 293 +++++++++ ....你知道哪些设计模式？分别对应的应用场景有哪些？.md | 201 ++++++ .../29.红黑树和平衡二叉树有什么区别.md | 164 +++++ .../30.如何保证接口的幂等性常见的实现方案有哪些.md | 197 ++++++ .../Java面试原理/31.TCP 为什么需要三次握手.md | 140 ++++ .../Java面试原理/java开发人员最常犯的10中错误.md | 159 +++++ .../Java面试原理/什么是OOM,怎么解决OOM.md | 64 ++ {数据库/MySQL => MySQL}/1 创建数据库.md | 0 {数据库/MySQL => MySQL}/10 正则表查询.md | 0 {数据库/MySQL => MySQL}/11 数学函数.md | 0 {数据库/MySQL => MySQL}/12 索引.md | 0 {数据库/MySQL => MySQL}/13 常见操作指令.md | 0 {数据库/MySQL => MySQL}/14 注册表文件修改.md | 0 {数据库/MySQL => MySQL}/2 创建数据表.md | 0 {数据库/MySQL => MySQL}/3 完整性约束.md | 0 {数据库/MySQL => MySQL}/4 修改表结构.md | 0 {数据库/MySQL => MySQL}/5 修改表数据.md | 0 {数据库/MySQL => MySQL}/6 查询表数据.md | 0 {数据库/MySQL => MySQL}/7 高级表查询.md | 0 {数据库/MySQL => MySQL}/8 连接表查询.md | 0 {数据库/MySQL => MySQL}/9 外键与查询.md | 0 .../image/2021-04-23-12-41-46.png | Bin .../image/2021-04-23-12-46-47.png | Bin .../image/2021-09-01-22-02-49.png | Bin .../image/2021-09-01-22-05-53.png | Bin .../image/2021-09-01-22-06-49.png | Bin .../image/2021-09-01-22-14-07.png | Bin .../image/2021-09-01-22-16-48.png | Bin .../image/2021-09-01-22-17-34.png | Bin .../image/2021-09-02-00-50-45.png | Bin .../image/2021-09-02-00-51-00.png | Bin .../image/2021-09-02-00-54-06.png | Bin .../image/2021-09-02-00-54-18.png | Bin .../image/2021-09-02-10-11-38.png | Bin .../image/2021-09-02-10-14-13.png | Bin .../image/2021-09-02-10-15-31.png | Bin .../image/2021-09-02-10-16-47.png | Bin .../image/2021-09-02-10-17-53.png | Bin .../image/2021-09-02-10-19-31.png | Bin .../image/2021-09-02-12-05-03.png | Bin .../image/2021-09-09-15-21-22.png | Bin .../image/2021-09-09-15-22-11.png | Bin .../image/2021-09-09-15-23-14.png | Bin .../image/2021-09-09-15-24-05.png | Bin .../image/2021-09-09-15-24-47.png | Bin .../image/2021-09-09-15-24-57.png | Bin .../image/2021-09-09-15-25-26.png | Bin .../image/2021-09-09-15-26-10.png | Bin .../MySQL => MySQL}/附录0 MySQL架构原理.md | 0 .../MySQL => MySQL}/附录1 MySQL存储引擎.md | 0 .../MySQL => MySQL}/附录2 MySql性能优化.md | 0 .../MySQL => MySQL}/附录3 MySQL索引类型.md | 0 .../MySQL => MySQL}/附录4 MySQL事务管理.md | 0 .../MySQL => MySQL}/附录5 MySQL连接查询.md | 0 .../MySQL => MySQL}/附录6 MySQL分库分表.md | 0 .../MySQL => MySQL}/附录7 MySQL并发机制.md | 0 .../MySQL => MySQL}/附录8 MySQL一致哈希.md | 0 {数据库/Redis => Redis}/01 Redis概述.md | 0 {数据库/Redis => Redis}/02 对象类型.md | 0 {数据库/Redis => Redis}/03 数据结构.md | 0 {数据库/Redis => Redis}/04 数据库.md | 0 {数据库/Redis => Redis}/05 生命周期.md | 0 {数据库/Redis => Redis}/06 RDB持久化.md | 0 {数据库/Redis => Redis}/07 AOF持久化.md | 0 {数据库/Redis => Redis}/08 事务.md | 0 {数据库/Redis => Redis}/09 事件与并发.md | 0 {数据库/Redis => Redis}/10 复制.md | 0 {数据库/Redis => Redis}/11 Sentinel.md | 0 {数据库/Redis => Redis}/12 集群与分片.md | 0 {数据库/Redis => Redis}/13 发布与订阅.md | 0 {数据库/Redis => Redis}/14 Redis使用场景.md | 0 {数据库/Redis => Redis}/15 Redis缓存.md | 0 {数据库/Redis => Redis}/16 Redis消息队列.md | 0 {数据库/Redis => Redis}/20 Lua脚本.md | 0 {数据库/Redis => Redis}/21 排序.md | 0 {数据库/Redis => Redis}/22 二进制数组.md | 0 {数据库/Redis => Redis}/23 慢查询日志.md | 0 {数据库/Redis => Redis}/24 监视器.md | 0 .../Redis命令总结/01.redis安装.md | 0 .../Redis命令总结/02.库和key操作命令.md | 0 .../Redis命令总结/03.字符串类型操作.md | 0 .../Redis命令总结/04.链表类型操作.md | 0 .../Redis命令总结/05.无序集合操作.md | 0 .../Redis命令总结/06.有序集合操作.md | 0 .../Redis命令总结/07.哈希数据类操作.md | 0 .../Redis命令总结/08.经纬度数据操作.md | 0 {数据库 => Redis}/Redis命令总结/09.事务.md | 0 .../Redis命令总结/10.频道发布与订阅.md | 0 .../11.redis持久化和导入导出数据库.md | 0 .../Redis命令总结/12.redis应用示例.md | 0 {数据库 => Redis}/Redis命令总结/README.md | 0 .../image/2021-04-07-23-24-02.png | Bin .../image/2021-04-07-23-24-24.png | Bin .../image/2021-04-07-23-46-25.png | Bin .../image/2021-08-24-16-39-38.png | Bin .../image/2021-08-24-16-39-58.png | Bin .../image/2021-09-02-16-24-45.png | Bin .../image/2021-09-02-23-00-43.png | Bin .../image/2021-09-02-23-16-20.png | Bin .../image/2021-09-02-23-16-42.png | Bin .../image/2021-09-02-23-17-35.png | Bin .../image/2021-09-02-23-19-57.png | Bin .../image/2021-09-02-23-20-54.png | Bin .../image/2021-09-03-00-19-56.png | Bin .../image/2021-09-03-00-42-41.png | Bin .../image/2021-09-03-00-51-35.png | Bin .../image/2021-09-03-00-51-44.png | Bin .../image/2021-09-03-00-51-53.png | Bin .../image/2021-09-03-09-15-05.png | Bin .../image/2021-09-03-09-18-36.png | Bin .../image/2021-09-03-09-22-19.png | Bin .../image/2021-09-03-09-24-24.png | Bin .../image/2021-09-03-09-26-34.png | Bin .../image/2021-09-03-09-30-04.png | Bin .../image/2021-09-03-09-34-18.png | Bin .../image/2021-09-03-09-35-40.png | Bin .../image/2021-09-03-11-49-02.png | Bin .../image/2021-10-14-10-06-20.png | Bin .../image/2021-10-14-10-08-28.png | Bin .../image/2021-10-14-10-09-50.png | Bin {数据库/Redis => Redis}/img/chap10/img0.png | Bin {数据库/Redis => Redis}/img/chap12/img0.png | Bin {数据库/Redis => Redis}/img/chap14/img0.png | Bin {数据库/Redis => Redis}/img/chap15/img0.png | Bin {数据库/Redis => Redis}/img/chap15/img1.png | Bin {数据库/Redis => Redis}/img/chap15/img2.png | Bin {数据库/Redis => Redis}/img/chap17/img0.png | Bin {数据库/Redis => Redis}/img/chap17/img1.png | Bin .../Redis => Redis}/img/chap2/sds-example.png | Bin {数据库/Redis => Redis}/img/chap20/img0.png | Bin {数据库/Redis => Redis}/img/chap21/img0.png | Bin {数据库/Redis => Redis}/img/chap21/img1.png | Bin {数据库/Redis => Redis}/img/chap21/img2.png | Bin {数据库/Redis => Redis}/img/chap21/img3.png | Bin {数据库/Redis => Redis}/img/chap22/img0.png | Bin {数据库/Redis => Redis}/img/chap3/list.png | Bin .../Redis => Redis}/img/chap3/listNode.png | Bin .../Redis => Redis}/img/chap4/collision.png | Bin {数据库/Redis => Redis}/img/chap4/k1-k0.png | Bin .../Redis => Redis}/img/chap5/skiplist.png | Bin .../Redis => Redis}/img/chap6/five-int16.png | Bin {数据库/Redis => Redis}/img/chap8/img0.png | Bin {数据库/Redis => Redis}/img/chap8/img1.png | Bin {数据库/Redis => Redis}/img/chap8/img2.png | Bin {数据库/Redis => Redis}/img/chap8/img3.png | Bin {数据库/Redis => Redis}/img/chap8/img4.png | Bin {数据库/Redis => Redis}/img/chap9/img0.png | Bin {数据库/Redis => Redis}/img/chap9/img1.png | Bin {数据库/Redis => Redis}/img/chap9/img2.png | Bin {数据库/Redis => Redis}/附录1 面试问题.md | 0 数据库/MongoDB/增删查改.md | 55 -- 数据库/MongoDB/聚合管道.md | 18 - 数据库/MongoDB/设置索引.md | 24 - 342 files changed, 18929 insertions(+), 570 deletions(-) delete mode 100644 Java基础教程/Java容器/10 Java容器.md delete mode 100644 Java基础教程/Java容器/11 JavaList.md delete mode 100644 Java基础教程/Java标准库/04 Math类.md create mode 100644 Java基础教程/Java标准库/04 数学计算.md create mode 100644 Java基础教程/Java标准库/08 随机数Random.md create mode 100644 Java基础教程/Java标准库/09 System类.md delete mode 100644 Java基础教程/Java标准库/Arrays类.md delete mode 100644 Java基础教程/Java标准库/StringBuffer.md create mode 100644 Java基础教程/Java标准库/image/2022-07-12-11-07-56.png create mode 100644 Java基础教程/Java源代码/codedemo/aspectj/BusinessService.java create mode 100644 Java基础教程/Java源代码/codedemo/aspectj/BusinessServiceInterceptor.java create mode 100644 Java基础教程/Java源代码/codedemo/aspectj/build.xml create mode 100644 Java基础教程/Java源代码/codedemo/dbutils/DbUtilsDemo.java create mode 100644 Java基础教程/Java源代码/codedemo/dbutils/README.md create mode 100644 Java基础教程/Java源代码/codedemo/dbutils/Student.java create mode 100644 Java基础教程/Java源代码/codedemo/easymock/README.md create mode 100644 Java基础教程/Java源代码/codedemo/easymock/UserService.java create mode 100644 Java基础教程/Java源代码/codedemo/easymock/UserServiceTest.java create mode 100644 Java基础教程/Java源代码/codedemo/encrypt/AES.java create mode 100644 Java基础教程/Java源代码/codedemo/encrypt/Blowfish.java create mode 100644 Java基础教程/Java源代码/codedemo/encrypt/EncryptAndDecrypt.java create mode 100644 Java基础教程/Java源代码/codedemo/encrypt/HmacSha1.java create mode 100644 Java基础教程/Java源代码/codedemo/encrypt/PerformanceCompare.java create mode 100644 Java基础教程/Java源代码/codedemo/eventdriver_improve/ClientMain.java create mode 100755 Java基础教程/Java源代码/codedemo/eventdriver_improve/Event.java create mode 100755 Java基础教程/Java源代码/codedemo/eventdriver_improve/EventListener.java create mode 100755 Java基础教程/Java源代码/codedemo/eventdriver_improve/EventManagement.java create mode 100755 Java基础教程/Java源代码/codedemo/eventdriver_improve/EventSource.java create mode 100644 Java基础教程/Java源代码/codedemo/eventdriver_normal/ClientMain.java create mode 100755 Java基础教程/Java源代码/codedemo/eventdriver_normal/Event.java create mode 100755 Java基础教程/Java源代码/codedemo/eventdriver_normal/EventListener.java create mode 100755 Java基础教程/Java源代码/codedemo/eventdriver_normal/EventSource.java create mode 100644 Java基础教程/Java源代码/codedemo/httpclient/FluentApi.java create mode 100644 Java基础教程/Java源代码/codedemo/httpclient/HttpClientBasic.java create mode 100644 Java基础教程/Java源代码/codedemo/httpclient/README.md create mode 100644 Java基础教程/Java源代码/codedemo/httpclient/server/AbstractHandler.java create mode 100644 Java基础教程/Java源代码/codedemo/httpclient/server/BinaryHandler.java create mode 100644 Java基础教程/Java源代码/codedemo/httpclient/server/CharacterHandler.java create mode 100644 Java基础教程/Java源代码/codedemo/httpclient/server/SimpleHttpServer.java create mode 100644 Java基础教程/Java源代码/codedemo/io/MultiThreadEchoServer.java create mode 100644 Java基础教程/Java源代码/codedemo/io/ThreadPoolEchoServer.java create mode 100644 Java基础教程/Java源代码/codedemo/io/Worker.java create mode 100644 Java基础教程/Java源代码/codedemo/java/lang/instrument/FirstInstrumentation.java create mode 100644 Java基础教程/Java源代码/codedemo/java/lang/instrument/FirstTransformer.java create mode 100644 Java基础教程/Java源代码/codedemo/java/lang/instrument/Hello.java create mode 100644 Java基础教程/Java源代码/codedemo/java/lang/instrument/README.md create mode 100644 Java基础教程/Java源代码/codedemo/java/lang/instrument/build.xml create mode 100644 Java基础教程/Java源代码/codedemo/java/lang/reflect/ClassAnalyze.java create mode 100644 Java基础教程/Java源代码/codedemo/java/lang/reflect/CreateInstance.java create mode 100644 Java基础教程/Java源代码/codedemo/java/lang/reflect/InvokeField.java create mode 100644 Java基础教程/Java源代码/codedemo/java/lang/reflect/InvokeMethod.java create mode 100644 Java基础教程/Java源代码/codedemo/java/lang/reflect/Man.java create mode 100644 Java基础教程/Java源代码/codedemo/java/lang/serialization/Man.java create mode 100644 Java基础教程/Java源代码/codedemo/java/lang/serialization/People.java create mode 100644 Java基础教程/Java源代码/codedemo/java/lang/serialization/TransientDemo.java create mode 100644 Java基础教程/Java源代码/codedemo/java/rmi/Gender.java create mode 100644 Java基础教程/Java源代码/codedemo/java/rmi/RmiClient.java create mode 100644 Java基础教程/Java源代码/codedemo/java/rmi/RmiServer.java create mode 100644 Java基础教程/Java源代码/codedemo/java/rmi/User.java create mode 100644 Java基础教程/Java源代码/codedemo/java/rmi/UserService.java create mode 100644 Java基础教程/Java源代码/codedemo/java/rmi/UserServiceImpl.java create mode 100644 Java基础教程/Java源代码/codedemo/java/util/concurret/ScheduledExecutorServiceDemo.java create mode 100644 Java基础教程/Java源代码/codedemo/java/util/forkjoin/HelloForkJoin.java create mode 100644 Java基础教程/Java源代码/codedemo/java/util/future/Future.ucls create mode 100644 Java基础教程/Java源代码/codedemo/java/util/future/HelloFuture.java create mode 100644 Java基础教程/Java源代码/codedemo/java/util/map/Map接口及其实现类.ucls create mode 100644 Java基础教程/Java源代码/codedemo/java/util/timer/TimerDemo.java create mode 100644 Java基础教程/Java源代码/codedemo/jdbc/JDBCUtils.java create mode 100644 Java基础教程/Java源代码/codedemo/jdbc/MetaDataExample.java create mode 100644 Java基础教程/Java源代码/codedemo/jetty/HttpGet.java create mode 100644 Java基础教程/Java源代码/codedemo/jetty/HttpGetTest.java create mode 100644 Java基础教程/Java源代码/codedemo/jetty/HttpServerMock.java create mode 100644 Java基础教程/Java源代码/codedemo/jetty/README.md create mode 100644 Java基础教程/Java源代码/codedemo/json/gson/ArrayDeserialize.java create mode 100644 Java基础教程/Java源代码/codedemo/json/gson/ArraySerialize.java create mode 100644 Java基础教程/Java源代码/codedemo/json/gson/CollectionDeserialize.java create mode 100644 Java基础教程/Java源代码/codedemo/json/gson/CollectionsSerialize.java create mode 100644 Java基础教程/Java源代码/codedemo/json/gson/CustomDeserialize.java create mode 100644 Java基础教程/Java源代码/codedemo/json/gson/CustomSerialize.java create mode 100644 Java基础教程/Java源代码/codedemo/json/gson/Person.java create mode 100644 Java基础教程/Java源代码/codedemo/json/gson/SimpleObjectSerialize.java create mode 100644 Java基础教程/Java源代码/codedemo/misc/GetHostInfo.java create mode 100644 Java基础教程/Java源代码/codedemo/mockito/Commodity.java create mode 100644 Java基础教程/Java源代码/codedemo/mockito/CommodityDao.java create mode 100644 Java基础教程/Java源代码/codedemo/mockito/User.java create mode 100644 Java基础教程/Java源代码/codedemo/mockito/UserDao.java create mode 100644 Java基础教程/Java源代码/codedemo/mockito/UserService.java create mode 100644 Java基础教程/Java源代码/codedemo/mockito/UserServiceTest.java create mode 100644 Java基础教程/Java源代码/codedemo/mybatis/MyBatisClient.java create mode 100644 Java基础教程/Java源代码/codedemo/mybatis/README.md create mode 100644 Java基础教程/Java源代码/codedemo/mybatis/dao/MonitNotifyHistoryDao.java create mode 100644 Java基础教程/Java源代码/codedemo/mybatis/entity/MonitNotifyHistory.java create mode 100644 Java基础教程/Java源代码/codedemo/mybatis/mapper/MonitNotifyHistoryMapper.xml create mode 100644 Java基础教程/Java源代码/codedemo/netty40x/echo/EchoClient.java create mode 100644 Java基础教程/Java源代码/codedemo/netty40x/echo/EchoClientHandler.java create mode 100644 Java基础教程/Java源代码/codedemo/netty40x/echo/EchoServer.java create mode 100644 Java基础教程/Java源代码/codedemo/netty40x/echo/EchoServerHandler.java create mode 100644 Java基础教程/Java源代码/codedemo/nio/BufferIO.java create mode 100644 Java基础教程/Java源代码/codedemo/nio/MemoryMapper.java create mode 100644 Java基础教程/Java源代码/codedemo/nio/NioEchoServer.java create mode 100644 Java基础教程/Java源代码/codedemo/proxy/AccountService.java create mode 100644 Java基础教程/Java源代码/codedemo/proxy/AccountServiceClient.java create mode 100644 Java基础教程/Java源代码/codedemo/proxy/AccountServiceDynamicProxy.java create mode 100644 Java基础教程/Java源代码/codedemo/proxy/AccountServiceImpl.java create mode 100644 Java基础教程/Java源代码/codedemo/proxy/AccountServiceStaticProxy.java create mode 100644 Java基础教程/Java源代码/codedemo/proxy/Result.java create mode 100644 Java基础教程/Java源代码/codedemo/proxy/User.java create mode 100644 Java基础教程/Java源代码/codedemo/reactor/Acceptor.java create mode 100644 Java基础教程/Java源代码/codedemo/reactor/Constant.java create mode 100644 Java基础教程/Java源代码/codedemo/reactor/Decoder.java create mode 100644 Java基础教程/Java源代码/codedemo/reactor/Encoder.java create mode 100644 Java基础教程/Java源代码/codedemo/reactor/LineDecoder.java create mode 100644 Java基础教程/Java源代码/codedemo/reactor/LineEncoder.java create mode 100644 Java基础教程/Java源代码/codedemo/reactor/ProcessService.java create mode 100644 Java基础教程/Java源代码/codedemo/reactor/Reactor.java create mode 100644 Java基础教程/Java源代码/codedemo/reactor/Reader.java create mode 100644 Java基础教程/Java源代码/codedemo/reactor/Writer.java create mode 100644 Java基础教程/Java源代码/codedemo/redis/JedisDemo.java create mode 100644 Java基础教程/Java源代码/codedemo/script/MultiScriptEngineCompare.java create mode 100644 Java基础教程/Java源代码/codedemo/script/PrettyTable.java create mode 100644 Java基础教程/Java源代码/codedemo/script/ScriptRunPerformence.java create mode 100644 Java基础教程/Java源代码/codedemo/script/SupportScriptEngine.java create mode 100644 Java基础教程/Java源代码/codedemo/slf4j/HelloSlf4j.java create mode 100644 Java基础教程/Java源代码/codedemo/thread/DaemonThreadDemo.java create mode 100644 Java基础教程/Java源代码/codedemo/tree/PrettyTree.java create mode 100644 Java基础教程/Java源代码/codedemo/tree/PrettyTreeTest.java create mode 100644 Java基础教程/Java源代码/codedemo/util/DateUtil.java create mode 100644 Java基础教程/Java源代码/codedemo/util/LogUtil.java create mode 100644 Java基础教程/Java源代码/codedemo/wiremock/HttpGetTest.java create mode 100644 Java基础教程/Java源代码/codedemo/wiremock/README.md create mode 100644 Java基础教程/Java源代码/codedemo/xml/BookStore.xml create mode 100644 Java基础教程/Java源代码/codedemo/xml/XPathDemo.java rename Java基础教程/{Java标准库 => Java网站开发}/41 Rest接口.md (100%) delete mode 100644 Java基础教程/Java语言基础/18 ClassLoader机制.md create mode 100644 Java基础教程/Java语言基础/19 staic关键字.md create mode 100644 Java基础教程/Java语言基础/20 final关键字.md create mode 100644 Java基础教程/Java语言基础/21 Java类加载机制.md create mode 100644 Java基础教程/Java语言基础/22 Java包机制.md create mode 100644 Java基础教程/Java语言基础/image/2022-12-04-13-14-56.png create mode 100644 Java基础教程/Java语言基础/image/2022-12-04-13-15-46.png create mode 100644 Java基础教程/Java集合类/01 Java数据结构.md create mode 100644 Java基础教程/Java集合类/02 JavaCollection.md create mode 100644 Java基础教程/Java集合类/03 List-ArrayList.md rename Java基础教程/{Java容器 => Java集合类}/12 JavaQueue.md (100%) rename Java基础教程/{Java容器 => Java集合类}/13 JavaSet.md (100%) rename Java基础教程/{Java容器 => Java集合类}/14 JavaMap.md (100%) rename Java基础教程/{Java容器 => Java集合类}/15 Java容器底层结构.md (100%) rename Java基础教程/{Java标准库 => Java集合类}/image/2022-11-08-10-51-54.png (100%) rename Java基础教程/{Java标准库 => Java集合类}/image/2022-11-08-10-54-19.png (100%) create mode 100644 Java基础教程/Java集合类/image/2022-12-04-22-09-27.png create mode 100644 Java基础教程/Java集合类/image/2022-12-04-22-17-09.png create mode 100644 Java基础教程/Java集合类/image/2022-12-04-22-20-35.png create mode 100644 Java基础教程/Java集合类/image/2022-12-04-22-53-11.png create mode 100644 Java基础教程/Java面试原理/01.String 是如何实现的？它有哪些重要的方法？.md create mode 100644 Java基础教程/Java面试原理/02.HashMap 底层实现原理是什么？JDK8 做了哪些优化？.md create mode 100644 Java基础教程/Java面试原理/03.线程的状态有哪些？它是如何工作的？.md create mode 100644 Java基础教程/Java面试原理/04.详解 ThreadPoolExecutor 的参数含义及源码执行流程？.md create mode 100644 Java基础教程/Java面试原理/05.synchronized和ReentrantLock.md create mode 100644 Java基础教程/Java面试原理/06.谈谈你对锁的理解？如何手动模拟一个死锁？.md create mode 100644 Java基础教程/Java面试原理/07.深克隆和浅克隆有什么区别？它的实现方式有哪些？.md create mode 100644 Java基础教程/Java面试原理/08.动态代理是如何实现的？JDK Proxy 和 CGLib 有什么区别？.md create mode 100644 Java基础教程/Java面试原理/09.如何实现本地缓存和分布式缓存？.md create mode 100644 Java基础教程/Java面试原理/10.如何手写一个消息队列和延迟消息队列？.md create mode 100644 Java基础教程/Java面试原理/11.底层源码分析Spring的核心功能和执行流程(上).md create mode 100644 Java基础教程/Java面试原理/12.底层源码分析 Spring 的核心功能和执行流程(下).md create mode 100644 Java基础教程/Java面试原理/13.MyBatis使用了哪些设计模式？在源码中是如何体现的？.md create mode 100644 Java基础教程/Java面试原理/14.SpringBoot有哪些优点？它和Spring有什么区别？.md create mode 100644 Java基础教程/Java面试原理/15.MQ有什么作用？你都用过哪些MQ中间件.md create mode 100644 Java基础教程/Java面试原理/16.MySQL 的运行机制是什么？它有哪些引擎？.md create mode 100644 Java基础教程/Java面试原理/17.MySQL 的优化方案有哪些？.md create mode 100644 Java基础教程/Java面试原理/18.关系型数据和文档型数据库有什么区别？.md create mode 100644 Java基础教程/Java面试原理/19.Redis的过期策略和内存淘汰机制有什么区别？.md create mode 100644 Java基础教程/Java面试原理/20.Redis怎样实现的分布式锁？.md create mode 100644 Java基础教程/Java面试原理/21.Redis中如何实现的消息队列？实现的方式有几种？.md create mode 100644 Java基础教程/Java面试原理/22.Redis是如何实现高可用的？.md create mode 100644 Java基础教程/Java面试原理/23.JVM 的内存布局和运行原理.md create mode 100644 Java基础教程/Java面试原理/24.垃圾回收算法有哪些？.md create mode 100644 Java基础教程/Java面试原理/25.你用过哪些垃圾回收器？它们有什么区别？.md create mode 100644 Java基础教程/Java面试原理/26.生产环境如何排除和优化JVM？.md create mode 100644 Java基础教程/Java面试原理/27.单例的实现方式有几种？它们有什么优缺点？.md create mode 100644 Java基础教程/Java面试原理/28.你知道哪些设计模式？分别对应的应用场景有哪些？.md create mode 100644 Java基础教程/Java面试原理/29.红黑树和平衡二叉树有什么区别.md create mode 100644 Java基础教程/Java面试原理/30.如何保证接口的幂等性常见的实现方案有哪些.md create mode 100644 Java基础教程/Java面试原理/31.TCP 为什么需要三次握手.md create mode 100644 Java基础教程/Java面试原理/java开发人员最常犯的10中错误.md create mode 100644 Java基础教程/Java面试原理/什么是OOM,怎么解决OOM.md rename {数据库/MySQL => MySQL}/1 创建数据库.md (100%) rename {数据库/MySQL => MySQL}/10 正则表查询.md (100%) rename {数据库/MySQL => MySQL}/11 数学函数.md (100%) rename {数据库/MySQL => MySQL}/12 索引.md (100%) rename {数据库/MySQL => MySQL}/13 常见操作指令.md (100%) rename {数据库/MySQL => MySQL}/14 注册表文件修改.md (100%) rename {数据库/MySQL => MySQL}/2 创建数据表.md (100%) rename {数据库/MySQL => MySQL}/3 完整性约束.md (100%) rename {数据库/MySQL => MySQL}/4 修改表结构.md (100%) rename {数据库/MySQL => MySQL}/5 修改表数据.md (100%) rename {数据库/MySQL => MySQL}/6 查询表数据.md (100%) rename {数据库/MySQL => MySQL}/7 高级表查询.md (100%) rename {数据库/MySQL => MySQL}/8 连接表查询.md (100%) rename {数据库/MySQL => MySQL}/9 外键与查询.md (100%) rename {数据库/MySQL => MySQL}/image/2021-04-23-12-41-46.png (100%) rename {数据库/MySQL => MySQL}/image/2021-04-23-12-46-47.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-01-22-02-49.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-01-22-05-53.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-01-22-06-49.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-01-22-14-07.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-01-22-16-48.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-01-22-17-34.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-02-00-50-45.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-02-00-51-00.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-02-00-54-06.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-02-00-54-18.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-02-10-11-38.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-02-10-14-13.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-02-10-15-31.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-02-10-16-47.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-02-10-17-53.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-02-10-19-31.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-02-12-05-03.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-09-15-21-22.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-09-15-22-11.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-09-15-23-14.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-09-15-24-05.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-09-15-24-47.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-09-15-24-57.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-09-15-25-26.png (100%) rename {数据库/MySQL => MySQL}/image/2021-09-09-15-26-10.png (100%) rename {数据库/MySQL => MySQL}/附录0 MySQL架构原理.md (100%) rename {数据库/MySQL => MySQL}/附录1 MySQL存储引擎.md (100%) rename {数据库/MySQL => MySQL}/附录2 MySql性能优化.md (100%) rename {数据库/MySQL => MySQL}/附录3 MySQL索引类型.md (100%) rename {数据库/MySQL => MySQL}/附录4 MySQL事务管理.md (100%) rename {数据库/MySQL => MySQL}/附录5 MySQL连接查询.md (100%) rename {数据库/MySQL => MySQL}/附录6 MySQL分库分表.md (100%) rename {数据库/MySQL => MySQL}/附录7 MySQL并发机制.md (100%) rename {数据库/MySQL => MySQL}/附录8 MySQL一致哈希.md (100%) rename {数据库/Redis => Redis}/01 Redis概述.md (100%) rename {数据库/Redis => Redis}/02 对象类型.md (100%) rename {数据库/Redis => Redis}/03 数据结构.md (100%) rename {数据库/Redis => Redis}/04 数据库.md (100%) rename {数据库/Redis => Redis}/05 生命周期.md (100%) rename {数据库/Redis => Redis}/06 RDB持久化.md (100%) rename {数据库/Redis => Redis}/07 AOF持久化.md (100%) rename {数据库/Redis => Redis}/08 事务.md (100%) rename {数据库/Redis => Redis}/09 事件与并发.md (100%) rename {数据库/Redis => Redis}/10 复制.md (100%) rename {数据库/Redis => Redis}/11 Sentinel.md (100%) rename {数据库/Redis => Redis}/12 集群与分片.md (100%) rename {数据库/Redis => Redis}/13 发布与订阅.md (100%) rename {数据库/Redis => Redis}/14 Redis使用场景.md (100%) rename {数据库/Redis => Redis}/15 Redis缓存.md (100%) rename {数据库/Redis => Redis}/16 Redis消息队列.md (100%) rename {数据库/Redis => Redis}/20 Lua脚本.md (100%) rename {数据库/Redis => Redis}/21 排序.md (100%) rename {数据库/Redis => Redis}/22 二进制数组.md (100%) rename {数据库/Redis => Redis}/23 慢查询日志.md (100%) rename {数据库/Redis => Redis}/24 监视器.md (100%) rename {数据库 => Redis}/Redis命令总结/01.redis安装.md (100%) rename {数据库 => Redis}/Redis命令总结/02.库和key操作命令.md (100%) rename {数据库 => Redis}/Redis命令总结/03.字符串类型操作.md (100%) rename {数据库 => Redis}/Redis命令总结/04.链表类型操作.md (100%) rename {数据库 => Redis}/Redis命令总结/05.无序集合操作.md (100%) rename {数据库 => Redis}/Redis命令总结/06.有序集合操作.md (100%) rename {数据库 => Redis}/Redis命令总结/07.哈希数据类操作.md (100%) rename {数据库 => Redis}/Redis命令总结/08.经纬度数据操作.md (100%) rename {数据库 => Redis}/Redis命令总结/09.事务.md (100%) rename {数据库 => Redis}/Redis命令总结/10.频道发布与订阅.md (100%) rename {数据库 => Redis}/Redis命令总结/11.redis持久化和导入导出数据库.md (100%) rename {数据库 => Redis}/Redis命令总结/12.redis应用示例.md (100%) rename {数据库 => Redis}/Redis命令总结/README.md (100%) rename {数据库/Redis => Redis}/image/2021-04-07-23-24-02.png (100%) rename {数据库/Redis => Redis}/image/2021-04-07-23-24-24.png (100%) rename {数据库/Redis => Redis}/image/2021-04-07-23-46-25.png (100%) rename {数据库/Redis => Redis}/image/2021-08-24-16-39-38.png (100%) rename {数据库/Redis => Redis}/image/2021-08-24-16-39-58.png (100%) rename {数据库/Redis => Redis}/image/2021-09-02-16-24-45.png (100%) rename {数据库/Redis => Redis}/image/2021-09-02-23-00-43.png (100%) rename {数据库/Redis => Redis}/image/2021-09-02-23-16-20.png (100%) rename {数据库/Redis => Redis}/image/2021-09-02-23-16-42.png (100%) rename {数据库/Redis => Redis}/image/2021-09-02-23-17-35.png (100%) rename {数据库/Redis => Redis}/image/2021-09-02-23-19-57.png (100%) rename {数据库/Redis => Redis}/image/2021-09-02-23-20-54.png (100%) rename {数据库/Redis => Redis}/image/2021-09-03-00-19-56.png (100%) rename {数据库/Redis => Redis}/image/2021-09-03-00-42-41.png (100%) rename {数据库/Redis => Redis}/image/2021-09-03-00-51-35.png (100%) rename {数据库/Redis => Redis}/image/2021-09-03-00-51-44.png (100%) rename {数据库/Redis => Redis}/image/2021-09-03-00-51-53.png (100%) rename {数据库/Redis => Redis}/image/2021-09-03-09-15-05.png (100%) rename {数据库/Redis => Redis}/image/2021-09-03-09-18-36.png (100%) rename {数据库/Redis => Redis}/image/2021-09-03-09-22-19.png (100%) rename {数据库/Redis => Redis}/image/2021-09-03-09-24-24.png (100%) rename {数据库/Redis => Redis}/image/2021-09-03-09-26-34.png (100%) rename {数据库/Redis => Redis}/image/2021-09-03-09-30-04.png (100%) rename {数据库/Redis => Redis}/image/2021-09-03-09-34-18.png (100%) rename {数据库/Redis => Redis}/image/2021-09-03-09-35-40.png (100%) rename {数据库/Redis => Redis}/image/2021-09-03-11-49-02.png (100%) rename {数据库/Redis => Redis}/image/2021-10-14-10-06-20.png (100%) rename {数据库/Redis => Redis}/image/2021-10-14-10-08-28.png (100%) rename {数据库/Redis => Redis}/image/2021-10-14-10-09-50.png (100%) rename {数据库/Redis => Redis}/img/chap10/img0.png (100%) rename {数据库/Redis => Redis}/img/chap12/img0.png (100%) rename {数据库/Redis => Redis}/img/chap14/img0.png (100%) rename {数据库/Redis => Redis}/img/chap15/img0.png (100%) rename {数据库/Redis => Redis}/img/chap15/img1.png (100%) rename {数据库/Redis => Redis}/img/chap15/img2.png (100%) rename {数据库/Redis => Redis}/img/chap17/img0.png (100%) rename {数据库/Redis => Redis}/img/chap17/img1.png (100%) rename {数据库/Redis => Redis}/img/chap2/sds-example.png (100%) rename {数据库/Redis => Redis}/img/chap20/img0.png (100%) rename {数据库/Redis => Redis}/img/chap21/img0.png (100%) rename {数据库/Redis => Redis}/img/chap21/img1.png (100%) rename {数据库/Redis => Redis}/img/chap21/img2.png (100%) rename {数据库/Redis => Redis}/img/chap21/img3.png (100%) rename {数据库/Redis => Redis}/img/chap22/img0.png (100%) rename {数据库/Redis => Redis}/img/chap3/list.png (100%) rename {数据库/Redis => Redis}/img/chap3/listNode.png (100%) rename {数据库/Redis => Redis}/img/chap4/collision.png (100%) rename {数据库/Redis => Redis}/img/chap4/k1-k0.png (100%) rename {数据库/Redis => Redis}/img/chap5/skiplist.png (100%) rename {数据库/Redis => Redis}/img/chap6/five-int16.png (100%) rename {数据库/Redis => Redis}/img/chap8/img0.png (100%) rename {数据库/Redis => Redis}/img/chap8/img1.png (100%) rename {数据库/Redis => Redis}/img/chap8/img2.png (100%) rename {数据库/Redis => Redis}/img/chap8/img3.png (100%) rename {数据库/Redis => Redis}/img/chap8/img4.png (100%) rename {数据库/Redis => Redis}/img/chap9/img0.png (100%) rename {数据库/Redis => Redis}/img/chap9/img1.png (100%) rename {数据库/Redis => Redis}/img/chap9/img2.png (100%) rename {数据库/Redis => Redis}/附录1 面试问题.md (100%) delete mode 100644 数据库/MongoDB/增删查改.md delete mode 100644 数据库/MongoDB/聚合管道.md delete mode 100644 数据库/MongoDB/设置索引.md diff --git a/Java基础教程/Java学习路线.md b/Java基础教程/Java学习路线.md index ef48c58e..87e26c2d 100644 --- a/Java基础教程/Java学习路线.md +++ b/Java基础教程/Java学习路线.md @@ -11,9 +11,10 @@ * [ ] 设计模式 * [ ] Java基础教程（Java的基本语法和使用及原理，晚上自学，第一周学完） * [X] Java语言基础。语言语法。：20200830 - * [ ] Java标注库开发.(自动拆装箱、String、集合类、枚举类、IO类、反射、动态代理、序列化、注解、泛型、单元测试、正则表达式、工具库、异常、日期时间、编码方式) + * [x] Java标注库.(自动拆装箱、String枚举类、反射、动态代理、序列化、注解、泛型、单元测试、正则表达式、工具库、异常、日期时间、编码方式) + * [x] Java集合类 + * [x] JavaIO与网络编程（网络基础、Socket编程） * [ ] Java并发编程（线程、锁、同步、并发包） - * [ ] Java网络编程（网络基础、Socket编程） * [ ] Java基本原理。JVM底层的原理和技术。（内存结构、垃圾回收） * [ ] Java架构模式。面向对象和设计模式 * [ ] Java网站开发（JavaWeb相关的技术知识。） @@ -72,4 +73,11 @@ > 一份可以参考的文档。其中大数据、网络安全和扩展篇不学。 -> ![](image/2022-10-27-20-26-36.png) \ No newline at end of file +> ![](image/2022-10-27-20-26-36.png) + + +> 找到了两个很不得了的东西。如果有时间，可以把这两个文档全部重新看一遍。完全有书籍的质量的基础知识介绍。常看常新。自己接下来的笔记就从这上边找吧。 +> +> 入门小站。https://rumenz.com/ +> BestJavaer。https://github.com/crisxuan/bestJavaer +> \ No newline at end of file diff --git a/Java基础教程/Java容器/10 Java容器.md b/Java基础教程/Java容器/10 Java容器.md deleted file mode 100644 index c6f694f1..00000000 --- a/Java基础教程/Java容器/10 Java容器.md +++ /dev/null @@ -1,31 +0,0 @@ - -数据结构分为 - -* 线性数据结构 -* 树型数据结构 -* 图型数据结构 - - -C++中的容器分为（都是线性的） -* 顺序容器 - * array 数组 - * vector向量 - * list 链表 -* 关联容器 - * map 映射 - * set 集合 -* 容器适配器 - * stack 栈 - * queue 队列 - - -Java中的容器分为（都是线性的） -* 集合collection - * List - * Queue - * Map - * Set - -![](image/2022-11-08-10-51-54.png) - -![](image/2022-11-08-10-54-19.png) \ No newline at end of file diff --git a/Java基础教程/Java容器/11 JavaList.md b/Java基础教程/Java容器/11 JavaList.md deleted file mode 100644 index e69de29b..00000000 diff --git a/Java基础教程/Java标准库/01 Object类.md b/Java基础教程/Java标准库/01 Object类.md index 257e6674..0dfdd4fc 100644 --- a/Java基础教程/Java标准库/01 Object类.md +++ b/Java基础教程/Java标准库/01 Object类.md @@ -2,6 +2,10 @@ ### 概览 +`java.lang.Object`类是Java语言中的根类，即所有类的父类。它中描述的所有方法子类都可以使用。在对象实例化的时候，最终找的父类就是Object。 + +如果一个类没有特别指定父类， 那么默认则继承自Object类。 + ```java public native int hashCode() @@ -354,3 +358,38 @@ CloneConstructorExample e2 = new CloneConstructorExample(e1); e1.set(2, 222); System.out.println(e2.get(2)); // 2 ``` + + +## 2 Objects工具类 + + +Objects类是对象工具类，它里面的的方法都是用来操作对象的。 + +### equals方法 + +在**JDK7**添加了一个Objects工具类，它提供了一些方法来操作对象，它由一些静态的实用方法组成，这些方法是null-save（空指针安全的）或null-tolerant（容忍空指针的），用于计算对象的hashcode、返回对象的字符串表示形式、比较两个对象。 + +在比较两个对象的时候，Object的equals方法容易抛出空指针异常，而Objects类中的equals方法就优化了这个问题。方法如下： + +* `public static boolean equals(Object a, Object b)`:判断两个对象是否相等。 + +我们可以查看一下源码，学习一下： + +```java +public static boolean equals(Object a, Object b) { + return (a == b) || (a != null && a.equals(b)); +} +``` + +### isNull + +`static boolean isNull(Object obj)` 判断对象是否为null，如果为null返回true。 + +```java +Student s1 = null; +Student s2 = new Student("蔡徐坤", 22); + +// static boolean isNull(Object obj) 判断对象是否为null,如果为null返回true +System.out.println(Objects.isNull(s1)); // true +System.out.println(Objects.isNull(s2)); // false +``` \ No newline at end of file diff --git a/Java基础教程/Java标准库/02 包装器类.md b/Java基础教程/Java标准库/02 包装器类.md index 76ca3b53..b275b0a0 100644 --- a/Java基础教程/Java标准库/02 包装器类.md +++ b/Java基础教程/Java标准库/02 包装器类.md @@ -34,7 +34,19 @@ Integer i = new Interger(1); Double d = Double.valueOf(3.14); ``` -### 包装器类转换 +### 装箱拆箱 + +* 装箱Boxing: 将基本类型转化为包装器类型 包装器类.valueOf(基本数据类型变量或常量)。装箱共享内存。 +* 拆箱unBoxing：将包装器类型转化为基本数据类型XX.XXXvalue();拆箱也共享内存 + +装箱操作 + +```java +Integer i = Integer.valueOf(10);//10是基本数据类型，i是包装器类型 +int n = i.intValue();//i是包装器类型，n是包装器类型 +``` + +拆箱操作 ```java Boolean.booleanValue() @@ -47,17 +59,18 @@ Float.floatValue() Double.doubleValue() ``` -* 装箱Boxing: 将基本类型转化为包装器类型 包装器类.valueOf(基本数据类型变量或常量)。装箱共享内存。 -* 拆箱unBoxing：将包装器类型转化为基本数据类型XX.XXXvalue();拆箱也共享内存 - +可以自动进行拆箱装箱 ```java -Integer i = Integer.valueOf(10);//10是基本数据类型，i是包装器类型 -int n = i.intValue();//i是包装器类型，n是包装器类型 +Integer i = 4;//自动装箱。相当于Integer i = Integer.valueOf(4); +i = i + 5;//等号右边：将i对象转成基本数值(自动拆箱) i.intValue() + 5; +//加法运算完成后，再次装箱，把基本数值转成对象。 + ``` -### 包装器类 + +> 注意事项 * 对象一旦赋值，其值不能在改变。 * ++/--自增自减运算符只能对基本数据类型操作 -* 集合中只能存放帮装起类型的对象 +* 集合中只能存放包装器类型的对象 @@ -175,4 +188,45 @@ System.out.println(m == n); // true 7. toLowerCase() 指定字母的小写形式 8. toString() -返回字符的字符串形式，字符串的长度仅为1 \ No newline at end of file +返回字符的字符串形式，字符串的长度仅为1 + +## 2 Integer类 + +- Integer类概述 + + 包装一个对象中的原始类型 int 的值 + +- Integer类构造方法及静态方法 + +| 方法名 | 说明 | +| --------------------------------------- | -------------------------------------- | +| public Integer(int value) | 根据 int 值创建 Integer 对象(过时) | +| public Integer(String s) | 根据 String 值创建 Integer 对象(过时) | +| public static Integer valueOf(int i) | 返回表示指定的 int 值的 Integer 实例 | +| public static Integer valueOf(String s) | 返回保存指定String值的 Integer 对象 | + +- 示例代码 + +```java +public class IntegerDemo { + public static void main(String[] args) { + //public Integer(int value)：根据 int 值创建 Integer 对象(过时) + Integer i1 = new Integer(100); + System.out.println(i1); + + //public Integer(String s)：根据 String 值创建 Integer 对象(过时) + Integer i2 = new Integer("100"); + //Integer i2 = new Integer("abc"); //NumberFormatException + System.out.println(i2); + System.out.println("--------"); + + //public static Integer valueOf(int i)：返回表示指定的 int 值的 Integer 实例 + Integer i3 = Integer.valueOf(100); + System.out.println(i3); + + //public static Integer valueOf(String s)：返回保存指定String值的Integer对象 + Integer i4 = Integer.valueOf("100"); + System.out.println(i4); + } +} +``` \ No newline at end of file diff --git a/Java基础教程/Java标准库/03 String类.md b/Java基础教程/Java标准库/03 String类.md index 1ab4c3f9..586cbf2e 100644 --- a/Java基础教程/Java标准库/03 String类.md +++ b/Java基础教程/Java标准库/03 String类.md @@ -198,7 +198,7 @@ String s5 = new String("Runoob"); // String 对象创建 * String(byte数组,起始下标,长度) * String(StringBuffer buffer) * String(StringBuilder builder) -### 关键方法 +### 字符串拼接 * 字符串链接concat和+号的功能类似。 @@ -207,6 +207,7 @@ String s5 = new String("Runoob"); // String 对象创建 "Hello," + " runoob" + "!" ``` +### 格式化方法 * 创建格式化字符串printf和format两个方法 ```java @@ -216,13 +217,13 @@ System.out.printf("浮点型变量的值为 " + "is %s", floatVar, intVar, stringVar); ``` -``` -String fs; -fs = String.format("浮点型变量的值为 " + - "%f, 整型变量的值为 " + - " %d, 字符串变量的值为 " + - " %s", floatVar, intVar, stringVar); -``` +### 带正则表达式的方法 +* boolean matches(String regex)告知此字符串是否匹配给定的正则表达式。 +* String replaceAll(String regex, String replacement)使用给定的 replacement 替换此字符串所有匹配给定的正则表达式的子字符串。 +* String replaceFirst(String regex, String replacement) 使用给定的 replacement 替换此字符串匹配给定的正则表达式的第一个子字符串。 +* String[] split(String regex)根据给定正则表达式的匹配拆分此字符串。 +* String[] split(String regex, int limit)根据匹配给定的正则表达式来拆分此字符串。 + ### 其他方法 * char charAt(int index)返回指定索引处的 char 值。 @@ -250,14 +251,11 @@ fs = String.format("浮点型变量的值为 " + * int lastIndexOf(String str)返回指定子字符串在此字符串中最右边出现处的索引。 * int lastIndexOf(String str, int fromIndex) 返回指定子字符串在此字符串中最后一次出现处的索引，从指定的索引开始反向搜索。 * int length()返回此字符串的长度。 -* boolean matches(String regex)告知此字符串是否匹配给定的正则表达式。 + * boolean regionMatches(boolean ignoreCase, int toffset, String other, int ooffset, int len)测试两个字符串区域是否相等。 * boolean regionMatches(int toffset, String other, int ooffset, int len)测试两个字符串区域是否相等。 * String replace(char oldChar, char newChar)返回一个新的字符串，它是通过用 newChar 替换此字符串中出现的所有 oldChar 得到的。 -* String replaceAll(String regex, String replacement)使用给定的 replacement 替换此字符串所有匹配给定的正则表达式的子字符串。 -* String replaceFirst(String regex, String replacement) 使用给定的 replacement 替换此字符串匹配给定的正则表达式的第一个子字符串。 -* String[] split(String regex)根据给定正则表达式的匹配拆分此字符串。 -* String[] split(String regex, int limit)根据匹配给定的正则表达式来拆分此字符串。 + * boolean startsWith(String prefix)测试此字符串是否以指定的前缀开始。 * boolean startsWith(String prefix, int toffset)测试此字符串从指定索引开始的子字符串是否以指定前缀开始。 * CharSequence subSequence(int beginIndex, int endIndex) 返回一个新的字符序列，它是此序列的一个子序列。 @@ -290,6 +288,10 @@ StringBuffer 和 StringBuilder 类的对象能够被多次的修改，并且不 * 由于 StringBuilder 相较于 StringBuffer 有速度优势，所以多数情况下建议使用 StringBuilder 类。 +StringBuffer的内部实现方式和String不同. +* StringBuffer在进行字符串处理时，不生成新的对象，在内存使用上要优于String类。所以在实际使用时，如果经常需要对一个字符串进行修改，例如插入、删除等操作，使用StringBuffer要更加适合一些。 +* String:在String类中没有用来改变已有字符串中的某个字符的方法，由于不能改变一个java字符串中的某个单独字符，所以在JDK文档中称String类的对象是不可改变的。然而，不可改变的字符串具有一个很大的优点:编译器可以把字符串设为共享的。 + ### 使用 ```java @@ -343,3 +345,185 @@ public class RunoobTest{ +## 4 字符串格式化 + +利用了Formatter类。printf、printfln等方法原理一直。 + +字符串的格式化相当于将字符串按照指定的格式进行toString(),一般有两种形式： + +```java +//使用指定的格式字符串和参数返回一个格式化字符串。 + public static String format(String format, Object... args) { + return new Formatter().format(format, args).toString(); + } + +//使用指定的语言环境、格式字符串和参数返回一个格式化字符串。 +public static String format(Locale l, String format, Object... args) { + return new Formatter(l).format(format, args).toString(); + } +``` +* 实例 + +``` +String fs; +fs = String.format("浮点型变量的值为 " + + "%f, 整型变量的值为 " + + " %d, 字符串变量的值为 " + + " %s", floatVar, intVar, stringVar); +``` + +### 数据转化符 + +| 数据类型 | 说明 | 转化形式 | +|------|------------|------------| +| %s | 字符串类型 | “string” | +| %c | 字符类型 | ‘A’ | +| %b | 布尔类型 | true/false | +| %o | 整数类型（八进制） | 111 | +| %d | 整数类型（十进制） | 17 | +| %x | 整数类型（十六进制） | 11 | +| %f | 浮点类型（基本） | 66.66 | +| %e | 指数类型 | 1.11e+5 | +| %a | 浮点类型（十六进制） | FF.22 | +| %h | 散列码 | 11 | +| %% | 百分比类型 | 17% | +| %n | 换行符 | +| %tx | 日期与时间类型 | + +```java +public class Format01 { + public static void main(String[] args) { + System.out.println(String.format("字符串：%s", "String")); + System.out.println(String.format("字符：%c", 'M')); + System.out.println(String.format("布尔类型：%b", 'M'>'A')); + System.out.println(String.format("八进制整数类型：%o", 17)); + System.out.println(String.format("十进制整数类型：%d", 17)); + System.out.println(String.format("十六进制整数类型：%x", 17)); + System.out.println(String.format("基本浮点类型：%f", 99.1)); + System.out.println(String.format("指数类型：%e", 100.111111111)); + System.out.println(String.format("十六进制浮点类型：%a", 17.111111)); + System.out.println(String.format("散列码：%h", 17)); + System.out.println(String.format("百分比类型：17%%")); + System.out.print(String.format("换行符：%n", 17)); + } + +} +``` + +### 格式化控制符 + +| 标志 | 说明 | 示例 | 输出 | +|---|---|---|---| +| + | 为正数添加符号 | (“正数：%+f”,11.11)) | 正数：+11.110000 | +| - | 左对齐 | (“左对齐：%-5d”,11) | 左对齐：11 | +| 0 | 整数前面补0 | (“数字前面补0：%04d”,11) | 数字前面补0：0011 | +| , | 对数字分组 | (“按,对数字分组：%,d”,111111111) | 按,对数字分组：111,111,111 | +| 空格 | 数字前面补空格 | (“空格：% 4d”,11) | 空格： 11 | +| （ | 包含负数 | (“使用括号包含负数：%(f”,-11.11) | 使用括号包含负数：(11.110000) | +| # | 浮点数包含小数，八进制包含0，十六进制包含0x | +| < | 格式化前一个转换符描述的参数 | (“格式化前描述的参数：%f转化后%❤️.3f”,111.1111111) | 格式化前描述的参数：111.111111转化后111.111 | +| $ | 被格式化的参数索引 | (“被格式化的参数索引：%1 + + +```java +public class formatString { + public static void main(String[] args) { + System.out.println(String.format("正数：%+f",11.11)); + System.out.println(String.format("右对齐：%+10d",11)); + System.out.println(String.format("左对齐：%-5d",11)); + System.out.println(String.format("数字前面补0：%044d",11)); + System.out.println(String.format("空格：% 4d",11)); + System.out.println(String.format("按,对数字分组：%,d",111111111)); + System.out.println(String.format("使用括号包含负数：%(f",-11.11)); + System.out.println(String.format("浮点数包含小数点：%#f",11.1)); + System.out.println(String.format("八进制包含0：%#o",11)); + System.out.println(String.format("十六进制包含0x：%#x",11)); + System.out.println(String.format("格式化前描述的参数：%f转化后%<3.3f",111.1111111)); + System.out.println(String.format("被格式化的参数索引：%1$d,%2$s",11,"111.1111111")); + + } + +} +``` + +### 日期格式化符 + +| 转换符 | 说明 | 示例 | +|---|---|---| +| c | 全部时间日期 | 星期四 十二月 17 13:11:35 CST 2020 | +| F | 年-月-日格式 | 2020-12-17 | +| D | 月/日/年格式 | 12/17/20 | +| r | HH:MM:SS PM格式（12时制） | 01:11:35 下午 | +| T | HH:MM:SS格式（24时制） | 13:11:35 | +| R | HH:MM格式（24时制） | 13:11 | + + +```java +public class formatDate { + public static void main(String[] args) { + Date date = new Date(); + System.out.println(String.format("全部时间日期：%tc",date)); + System.out.println(String.format("年-月-日格式：%tF",date)); + System.out.println(String.format("月/日/年格式：%tD",date)); + System.out.println(String.format("HH:MM:SS PM格式（12时制）：%tr",date)); + System.out.println(String.format("HH:MM:SS格式（24时制）：%tT",date)); + System.out.println(String.format("HH:MM格式（24时制）：%tR",date)); + } +} +``` + + +### 时间格式化符 + +| 转换符 | 说明 | 示例 | +|---|---|---| +| H | 2位数字24时制的小时（不足2位前面补0） | 13 | +| l | 2位数字12时制的小时 | 1 | +| k | 2位数字24时制的小时 | 13 | +| M | 2位数字的分钟 | 33 | +| L | 3位数字的毫秒 | 745 | +| S | 2位数字的秒 | 33 | +| N | 9位数字的毫秒数 | 745000000 | +| p | Locale.US,"小写字母的上午或下午标记(英) | 下午 | +| Z | 时区缩写字符串 | CST | +| z | 相对于GMT的RFC822时区的偏移量 | +0800 | +| s | 1970-1-1 00:00:00 到现在所经过的秒数 | 1608183213 | +| Q | 1970-1-1 00:00:00 到现在所经过的毫秒数 | 1608183213745 | + +```java +public class formatTime { + public static void main(String[] args) { + Date date = new Date(); + System.out.println(String.format("2位数字24时制的小时（不足2位前面补0）：%tH", date)); + System.out.println(String.format("2位数字12时制的小时：%tl", date)); + System.out.println(String.format("2位数字24时制的小时：%tk", date)); + System.out.println(String.format("2位数字的分钟：%tM", date)); + System.out.println(String.format("3位数字的毫秒：%tL", date)); + System.out.println(String.format("2位数字的秒：%tS", date)); + System.out.println(String.format("9位数字的毫秒数：%tN", date)); + System.out.println(String.format("时区缩写字符串：%tZ", date)); + System.out.println(String.format("相对于GMT的RFC822时区的偏移量：%tz", date)); + System.out.println(String.format("Locale.US,\"小写字母的上午或下午标记(英)：%tp", date)); + System.out.println(String.format("1970-1-1 00:00:00 到现在所经过的秒数：%ts", date)); + System.out.println(String.format("1970-1-1 00:00:00 到现在所经过的毫秒数：%tQ", date)); + + } + +} +``` +### 类型转换 + +* 其他类型转字符串 + +```java +1.String s=""+i; +2.String s=Integer.toString(i); +3.String s=String.valueOf(i); +``` + +* 字符串转其他类型 + +```java +1.int i=Integer.parsenInt(s); +2.int i=Integer.valueOf(s).intValue(); +``` diff --git a/Java基础教程/Java标准库/04 Math类.md b/Java基础教程/Java标准库/04 Math类.md deleted file mode 100644 index b1d38b24..00000000 --- a/Java基础教程/Java标准库/04 Math类.md +++ /dev/null @@ -1,28 +0,0 @@ -## 1 概述 - -### Math类 -Java 的 Math 包含了用于执行基本数学运算的属性和方法，如初等指数、对数、平方根和三角函数。 - -### Math中的常量 -* Math.PI 记录的圆周率 -* Math.E 记录e的常量 - -### Math中的函数 -* Math.abs 求绝对值 -* Math.sin 正弦函数 Math.asin 反正弦函数 -* Math.cos 余弦函数 Math.acos 反余弦函数 -* Math.tan 正切函数 Math.atan 反正切函数 Math.atan2 商的反正切函数 -* Math.toDegrees 弧度转化为角度 Math.toRadians 角度转化为弧度 -* Math.ceil 得到不小于某数的最大整数 -* Math.floor 得到不大于某数的最大整数 -* Math.IEEEremainder 求余 -* Math.max 求两数中最大 -* Math.min 求两数中最小 -* Math.sqrt 求开方 -* Math.pow 求某数的任意次方, 抛出ArithmeticException处理溢出异常 -* Math.exp 求e的任意次方 -* Math.log10 以10为底的对数 -* Math.log 自然对数 -* Math.rint 求距离某数最近的整数（可能比某数大，也可能比它小） -* Math.round 同上，返回int型或者long型（上一个函数返回double型） -* Math.random 返回0，1之间的一个随机数 diff --git a/Java基础教程/Java标准库/04 数学计算.md b/Java基础教程/Java标准库/04 数学计算.md new file mode 100644 index 00000000..ae21806a --- /dev/null +++ b/Java基础教程/Java标准库/04 数学计算.md @@ -0,0 +1,71 @@ +## 1 Math + +### Math类 +Java 的 Math 包含了用于执行基本数学运算的属性和方法，如初等指数、对数、平方根和三角函数。 + +### Math中的常量 +* Math.PI 记录的圆周率 +* Math.E 记录e的常量 + +### Math中的函数 +三角函数 +* Math.sin 正弦函数 Math.asin 反正弦函数 +* Math.cos 余弦函数 Math.acos 反余弦函数 +* Math.tan 正切函数 Math.atan 反正切函数 Math.atan2 商的反正切函数 +* Math.toDegrees 弧度转化为角度 Math.toRadians 角度转化为弧度 + +舍入函数 +* Math.abs 求绝对值 +* Math.ceil 得到不小于某数的最大整数 +* Math.floor 得到不大于某数的最大整数 +* Math.IEEEremainder 求余 +* Math.max 求两数中最大 +* Math.min 求两数中最小 +* Math.round 同上，返回int型或者long型（上一个函数返回double型） + +指数幂计算 +* Math.sqrt 求开方 +* Math.pow 求某数的任意次方, 抛出ArithmeticException处理溢出异常 +* Math.exp 求e的任意次方 +* Math.log10 以10为底的对数 +* Math.log 自然对数 +* Math.rint 求距离某数最近的整数（可能比某数大，也可能比它小） + +随机数 +* Math.random 返回0，1之间的一个随机数 + +## 2 BigDecimal类 + +### 概述 + +| 相关内容 | 具体描述 | +| -------- | :----------------------------------------------------------- | +| 包 | java.math 使用时需要导包 | +| 类声明 | public class BigDecimal extends Number implements Comparable | +| 描述 | BigDecimal类提供了算术，缩放操作，舍入，比较，散列和格式转换的操作。提供了更加精准的数据计算方式 | + +### 构造方法 + +| 构造方法名 | 描述 | +| ---------------------- | ----------------------------------------------- | +| BigDecimal(double val) | 将double类型的数据封装为BigDecimal对象 | +| BigDecimal(String val) | 将 BigDecimal 的字符串表示形式转换为 BigDecimal | + +注意：推荐使用第二种方式，第一种存在精度问题； + +### 常用方法 + +BigDecimal类中使用最多的还是提供的进行四则运算的方法，如下： + +| 方法声明 | 描述 | +| -------------------------------------------- | -------- | +| public BigDecimal add(BigDecimal value) | 加法运算 | +| public BigDecimal subtract(BigDecimal value) | 减法运算 | +| public BigDecimal multiply(BigDecimal value) | 乘法运算 | +| public BigDecimal divide(BigDecimal value) | 触发运算 | + +注意：对于divide方法来说，如果除不尽的话，就会出现java.lang.ArithmeticException异常。此时可以使用divide方法的另一个重载方法； + +> BigDecimal divide(BigDecimal divisor, int scale, int roundingMode): divisor：除数对应的BigDecimal对象；scale:精确的位数；roundingMode取舍模式 + +> 小结：Java中小数运算有可能会有精度问题，如果要解决这种精度问题，可以使用BigDecimal \ No newline at end of file diff --git a/Java基础教程/Java标准库/05 日期时间.md b/Java基础教程/Java标准库/05 日期时间.md index 32287666..72c41eda 100644 --- a/Java基础教程/Java标准库/05 日期时间.md +++ b/Java基础教程/Java标准库/05 日期时间.md @@ -47,7 +47,7 @@ Java使用以下三种方法来比较两个日期： ## 2 日期格式化SimpleDateFormat -### 格式化的方法 +### 格式化的方法format SimpleDateFormat 是一个以语言环境敏感的方式来格式化和分析日期的类。SimpleDateFormat 允许你选择任何用户自定义日期时间格式来运行。 ```java @@ -65,7 +65,27 @@ public class DateDemo { } ``` -### 格式化编码 +### 反格式化方法parse + +```java +import java.text.DateFormat; +import java.text.ParseException; +import java.text.SimpleDateFormat; +import java.util.Date; +/** + * 把String转换成Date对象 +*/ +public class Demo04DateFormatMethod { + public static void main(String[] args) throws ParseException { + DateFormat df = new SimpleDateFormat("yyyy年MM月dd日"); + String str = "2020年6月11日"; + Date date = df.parse(str); + System.out.println(date); + } +} +``` + +### SimpleDateFormat格式化编码 | 字母 | 描述 | 示例 | |---|---|---| @@ -90,7 +110,7 @@ public class DateDemo { | ' | 文字定界符 | Delimiter | | " | 单引号 | ` | -### printf格式化日期 +### Printf&String.format格式化日期 printf 方法可以很轻松地格式化时间和日期。使用两个字母格式，它以 %t 开头并且以下面表格中的一个字母结尾。 @@ -174,4 +194,144 @@ public class DiffDemo { ## 4 Calendar类 -> 日后补充把 \ No newline at end of file + +## 概念 + +`java.util.Calendar`是日历类，在Date后出现，替换掉了许多Date的方法。该类将所有可能用到的时间信息封装为静态成员变量，方便获取。日历类就是方便获取各个时间属性的。 + +## 获取方式 + +Calendar为抽象类，由于语言敏感性，Calendar类在创建对象时并非直接创建，而是通过静态方法创建，返回子类对象，如下： + +Calendar静态方法 + +* `public static Calendar getInstance()`：使用默认时区和语言环境获得一个日历 + +例如： + +```java +import java.util.Calendar; + +public class Demo06CalendarInit { + public static void main(String[] args) { + Calendar cal = Calendar.getInstance(); + } +} +``` + +## 常用方法 + +根据Calendar类的API文档，常用方法有： + +- `public int get(int field)`：返回给定日历字段的值。 +- `public void set(int field, int value)`：将给定的日历字段设置为给定值。 +- `public abstract void add(int field, int amount)`：根据日历的规则，为给定的日历字段添加或减去指定的时间量。 +- `public Date getTime()`：返回一个表示此Calendar时间值（从历元到现在的毫秒偏移量）的Date对象。 + +Calendar类中提供很多成员常量，代表给定的日历字段： + +| 字段值 | 含义 | +| ------------ | ------------------------------------- | +| YEAR | 年 | +| MONTH | 月（从0开始，可以+1使用） | +| DAY_OF_MONTH | 月中的天（几号） | +| HOUR | 时（12小时制） | +| HOUR_OF_DAY | 时（24小时制） | +| MINUTE | 分 | +| SECOND | 秒 | +| DAY_OF_WEEK | 周中的天（周几，周日为1，可以-1使用） | + +### get/set方法 + +get方法用来获取指定字段的值，set方法用来设置指定字段的值，代码使用演示： + +```java +import java.util.Calendar; + +public class CalendarUtil { + public static void main(String[] args) { + // 创建Calendar对象 + Calendar cal = Calendar.getInstance(); + // 获取年 + int year = cal.get(Calendar.YEAR); + // 获取月 + int month = cal.get(Calendar.MONTH) + 1; + // 获取日 + int dayOfMonth = cal.get(Calendar.DAY_OF_MONTH); + System.out.print(year + "年" + month + "月" + dayOfMonth + "日"); + } +} +``` + +```java +import java.util.Calendar; + +public class Demo07CalendarMethod { + public static void main(String[] args) { + Calendar cal = Calendar.getInstance(); + // 设置年 + cal.set(Calendar.YEAR, 2020); + System.out.print(year + "年" + month + "月" + dayOfMonth + "日"); // 2020年6月11日 + } +} +``` + +### add方法 + +add方法可以对指定日历字段的值进行加减操作，如果第二个参数为正数则加上偏移量，如果为负数则减去偏移量。代码如： + +```java +import java.util.Calendar; + +public class CalendarMethod { + public static void main(String[] args) { + Calendar cal = Calendar.getInstance(); + // 获取年 + int year = cal.get(Calendar.YEAR); + // 获取月 + int month = cal.get(Calendar.MONTH) + 1; + // 获取日 + int dayOfMonth = cal.get(Calendar.DAY_OF_MONTH); + // 2020年6月11日 + System.out.println(year + "年" + month + "月" + dayOfMonth + "日"); + // 使用add方法 + // 加2天 + cal.add(Calendar.DAY_OF_MONTH, 2); + // 减3年 + cal.add(Calendar.YEAR, -3); + // 获取年 + int year1 = cal.get(Calendar.YEAR); + // 获取月 + int month1 = cal.get(Calendar.MONTH) + 1; + // 获取日 + int dayOfMonth1 = cal.get(Calendar.DAY_OF_MONTH); + // 2017年6月13日; + System.out.println(year1 + "年" + month1 + "月" + dayOfMonth1 + "日"); + } +} +``` + +### getTime方法 + +Calendar中的getTime方法并不是获取毫秒时刻，而是拿到对应的Date对象。 + +```java +import java.util.Calendar; +import java.util.Date; + +public class Demo09CalendarMethod { + public static void main(String[] args) { + Calendar cal = Calendar.getInstance(); + Date date = cal.getTime(); + System.out.println(date); // Thu Jun 11 09:37:57 CST 2020 + } +} +``` + +> 小贴士： +> +> 西方星期的开始为周日，中国为周一。 +> +> 在Calendar类中，月份的表示是以0-11代表1-12月。 +> +> 日期是有大小关系的，时间靠后，时间越大。 \ No newline at end of file diff --git a/Java基础教程/Java标准库/07 正则表达式.md b/Java基础教程/Java标准库/07 正则表达式.md index 994cebca..b6d93ed3 100644 --- a/Java基础教程/Java标准库/07 正则表达式.md +++ b/Java基础教程/Java标准库/07 正则表达式.md @@ -1,2 +1,304 @@ -## Java 正则表达式 +> https://blog.csdn.net/m0_62618110/article/details/123704869 + + + +# Java 正则表达式 + +## 0 概述 + +### 简介 +正则表达式（regex）是一个字符串，由字面值字符和特殊符号组成，是用来描述匹配一个字符串集合的模式，可以用来匹配、查找字符串。 + +正则表达式的两个主要作用： +* 查找：在字符串中查找符合固定模式的子串 +* 匹配：整个字符串是否符合某个格式 + +在匹配和查找的基础上，实现替换、分割等操作。 + +### 基本实例 + +```java +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +public class RegexMatches +{ + public static void main( String[] args ){ + + // 按指定模式在字符串查找 + String line = "This order was placed for QT3000! OK?"; + String pattern = "(\\D*)(\\d+)(.*)"; + + // 创建 Pattern 对象 + Pattern r = Pattern.compile(pattern); + + // 现在创建 matcher 对象 + Matcher m = r.matcher(line); + if (m.find( )) { + System.out.println("Found value: " + m.group(0) ); + System.out.println("Found value: " + m.group(1) ); + System.out.println("Found value: " + m.group(2) ); + System.out.println("Found value: " + m.group(3) ); + } else { + System.out.println("NO MATCH"); + } + } +} +``` + + +## 1 正则表达式语法 + +* 在其他语言中，`\\`表示：我想要在正则表达式中插入一个普通的（字面上的）反斜杠，请不要给它任何特殊的意义。 +* 在 Java 中，`\\` 表示：我要插入一个正则表达式的反斜线，所以其后的字符具有特殊的意义。 +* 不要在重复词符中使用空白。如B{3,6} ，不能写成 B{3, 6}。空格也是有含义的。 +* 可以使用括号来将模式分组。(ab){3}匹配ababab , 而ab{3} 匹配 abbb。 + +| 字符 | 匹配 | 示例 | +|---|---|---| +| . | 任意单个字符，除换行符外 | jav.匹配java | +| [ ] | [ ] 中的任意一个字符 | java匹配j[abc]va | +| - | [ ] 内表示字符范围 | java匹配[a-z]av[a-g] | +| ^ | 在[ ]内的开头，匹配除[ ]内的字符之外的任意一个字符 | java匹配j[^b-f]va | +| | | 或 | x|y匹配x或y | +| \ | 将下一字符标记为特殊字符、文本、反向引用或八进制转义符 | \(匹配( | +| $ | 匹配输入字符串结尾的位置。如果设置了 RegExp 对象的 Multiline 属性，$ 还会与"\n"或"\r"之前的位置匹配。 | ;$匹配位于一行及外围的;号 | +| * | 零次或多次匹配前面的字符 | zo*匹配zoo或z | +| + | 一次或多次匹配前面的字符 | zo+匹配zo或zoo | +| ? | 零次或一次匹配前面的字符 | zo?匹配z或zo | +| p{n} | n 是非负整数。正好匹配 n 次 | o{2}匹配food中的两个o | +| p{n,} | n 是非负整数。至少匹配 n 次 | o{2}匹配foood中的所有o | +| p{n,m} | M 和 n 是非负整数，其中 n <= m。匹配至少 n 次，至多 m 次 | o{1,3}匹配fooood中的三个o | +| \p{P} | 一个标点字符 !"#$%&'()*+,-./:;<=>?@[\]^_'{|}~ | J\p{P}a匹配J?a | +| \b | 匹配一个字边界 | va\b匹配java中的va，但不匹配javar中的va | +| \B | 非字边界匹配 | va\B匹配javar中的va，但不匹配java中的va | +| \d | 数字字符匹配 | 1[\\d]匹配13 | +| \D | 非数字字符匹配 | [\\D]java匹配Jjava | +| \w | 单词字符 | java匹配[\\w]ava | +| \W | 非单词字符 | $java匹配[\\W]java | +| \s | 空白字符 | Java 2匹配Java\\s2 | +| \S | 非空白字符 | java匹配 j[\\S]va | +| \f | 匹配换页符 | 等效于\x0c和\cL | +| \n | 匹配换行符 | 等效于\x0a和\cJ | + + + + +### 分组说明 +``` +正则表达式-字符类 + +- 语法示例： + +1. \[abc\]：代表a或者b，或者c字符中的一个。 +2. \[^abc\]：代表除a,b,c以外的任何字符。 +3. [a-z]：代表a-z的所有小写字符中的一个。 +4. [A-Z]：代表A-Z的所有大写字符中的一个。 +5. [0-9]：代表0-9之间的某一个数字字符。 +6. [a-zA-Z0-9]：代表a-z或者A-Z或者0-9之间的任意一个字符。 +7. [a-dm-p]：a 到 d 或 m 到 p之间的任意一个字符。 + +正则表达式-逻辑运算符 + +- 语法示例： + 1. &&：并且 + 2. | ：或者 + +正则表达式-预定义字符 + +- 语法示例： + 1. "." ： 匹配任何字符。 + 2. "\d"：任何数字[0-9]的简写； + 3. "\D"：任何非数字\[^0-9\]的简写； + 4. "\s"： 空白字符：[ \t\n\x0B\f\r] 的简写 + 5. "\S"： 非空白字符：\[^\s\] 的简写 + 6. "\w"：单词字符：[a-zA-Z_0-9]的简写 + 7. "\W"：非单词字符：\[^\w\] + +正则表达式-数量词 + +- 语法示例： + 1. X? : 0次或1次 + 2. X* : 0次到多次 + 3. X+ : 1次或多次 + 4. X{n} : 恰好n次 + 5. X{n,} : 至少n次 + 6. X{n,m}: n到m次(n和m都是包含的) + + +正则表达式-分组括号() +``` + + +## 2 基本概念 +### Patter类和Matcher类 +Pattern 类： +pattern 对象是一个正则表达式的编译表示。Pattern 类没有公共构造方法。要创建一个 Pattern 对象，你必须首先调用其公共静态编译方法，它返回一个 Pattern 对象。该方法接受一个正则表达式作为它的第一个参数。 + +Matcher 类： +Matcher 对象是对输入字符串进行解释和匹配操作的引擎。与Pattern 类一样，Matcher 也没有公共构造方法。你需要调用 Pattern 对象的 matcher 方法来获得一个 Matcher 对象。 + +### 捕获组 + + +1. 捕获组是把多个字符当成一个单独单元进行处理的方法，它通过对括号内的字符分组来创建。 +``` +捕获组通过从左到右计算其括号来编号。 + +例如：在表达式((A)(B(C))) 中，存在四个这样的组： + +((A)(B(C))) +(A) +(B(C)) +(C) +``` +2. 捕获组可以通过调用matcher对象的groupCount方法来查看表达式有多少个分组。（groupCount方法返回一个int值，来表示matcher对象当前有多少个捕获组） + +3. 还有一个特殊的组零（group(0)），它代表整个表达式。（该组不包括在groupCount的返回值中） + +4. 以 (?) 开头的组是纯的非捕获 组，它不捕获文本，也不针对组合计进行计数。 + + +## 3 Matcher用法 + + + +### 索引方法 + +1. public int start() +返回以前匹配的初始索引。 +2. public int start(int group) + 返回在以前的匹配操作期间，由给定组所捕获的子序列的初始索引 +3. public int end() +返回最后匹配字符之后的偏移量。 +4. public int end(int group) +返回在以前的匹配操作期间，由给定组所捕获子序列的最后字符之后的偏移量。 + +```java +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +public class RegexMatches +{ + private static final String REGEX = "\\bcat\\b"; + private static final String INPUT = + "cat cat cat cattie cat"; + + public static void main( String[] args ){ + Pattern p = Pattern.compile(REGEX); + Matcher m = p.matcher(INPUT); // 获取 matcher 对象 + int count = 0; + + while(m.find()) { + count++; + System.out.println("Match number "+count); + System.out.println("start(): "+m.start()); + System.out.println("end(): "+m.end()); + } + } +} +``` + +### 匹配和查找方法 + +1. public boolean lookingAt() + 尝试将从区域开头开始的输入序列与该模式匹配。开头匹配。 +2. public boolean find() +尝试查找与该模式匹配的输入序列的下一个子序列。 +3. public boolean find(int start） +重置此匹配器，然后尝试查找匹配该模式、从指定索引开始的输入序列的下一个子序列。 +4. public boolean matches() +尝试将整个区域与模式匹配。全局匹配。 + +```java +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +public class RegexMatches +{ + private static final String REGEX = "foo"; + private static final String INPUT = "fooooooooooooooooo"; + private static final String INPUT2 = "ooooofoooooooooooo"; + private static Pattern pattern; + private static Matcher matcher; + private static Matcher matcher2; + + public static void main( String[] args ){ + pattern = Pattern.compile(REGEX); + matcher = pattern.matcher(INPUT); + matcher2 = pattern.matcher(INPUT2); + + System.out.println("Current REGEX is: "+REGEX); + System.out.println("Current INPUT is: "+INPUT); + System.out.println("Current INPUT2 is: "+INPUT2); + + + System.out.println("lookingAt(): "+matcher.lookingAt()); + System.out.println("matches(): "+matcher.matches()); + System.out.println("lookingAt(): "+matcher2.lookingAt()); + } +} +``` +### 替换方法 + +1. public Matcher appendReplacement(StringBuffer sb, String replacement) +实现非终端添加和替换步骤。 +2. public StringBuffer appendTail(StringBuffer sb) +实现终端添加和替换步骤。 +3. public String replaceAll(String replacement) + 替换模式与给定替换字符串相匹配的输入序列的每个子序列。 +4. public String replaceFirst(String replacement) + 替换模式与给定替换字符串匹配的输入序列的第一个子序列。 +5. public static String quoteReplacement(String s) +返回指定字符串的字面替换字符串。这个方法返回一个字符串，就像传递给Matcher类的appendReplacement 方法一个字面字符串一样工作。 + + +```java +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +public class RegexMatches +{ + private static String REGEX = "dog"; + private static String INPUT = "The dog says meow. " + + "All dogs say meow."; + private static String REPLACE = "cat"; + + public static void main(String[] args) { + Pattern p = Pattern.compile(REGEX); + // get a matcher object + Matcher m = p.matcher(INPUT); + INPUT = m.replaceAll(REPLACE); + System.out.println(INPUT); + } +} +``` + +```java +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +public class RegexMatches +{ + private static String REGEX = "a*b"; + private static String INPUT = "aabfooaabfooabfoobkkk"; + private static String REPLACE = "-"; + public static void main(String[] args) { + Pattern p = Pattern.compile(REGEX); + // 获取 matcher 对象 + Matcher m = p.matcher(INPUT); + StringBuffer sb = new StringBuffer(); + while(m.find()){ + m.appendReplacement(sb,REPLACE); + } + m.appendTail(sb); + System.out.println(sb.toString()); + } +} +``` + + +## 4 String自带的正则表达式功能 + +见String \ No newline at end of file diff --git a/Java基础教程/Java标准库/08 随机数Random.md b/Java基础教程/Java标准库/08 随机数Random.md new file mode 100644 index 00000000..7dec24a1 --- /dev/null +++ b/Java基础教程/Java标准库/08 随机数Random.md @@ -0,0 +1,47 @@ + +## 2 Random + +### 简介 + +在 Java中要生成一个指定范围之内的随机数字有两种方法：一种是调用 Math 类的 random() 方法，一种是使用 Random 类。 + +Random()：该构造方法使用一个和当前系统时间对应的数字作为种子数，然后使用这个种子数构造 Random 对象。 +Random(long seed)：使用单个 long 类型的参数创建一个新的随机数生成器。 + +Random 类提供的所有方法生成的随机数字都是均匀分布的，也就是说区间内部的数字生成的概率是均等的 + +### 实例 + +```java +package cn.itcast.demo1; + +import java.util.Random;//使用时需要先导包 +import java.util.Scanner; + + +public class RAndom { + public static void main(String[] args) { + Random r = new Random();//以系统自身时间为种子数 + int i = r.nextInt(); + System.out.println("i"+i); + Scanner sc =new Scanner(System.in); + int j = sc.nextInt(); + Random r2 = new Random(j);//自定义种子数 + Random r3 = new Random(j);//这里是为了验证上方的注意事项：Random类是伪随机，相同种子数相同次数产生的随机数相同 + int num = r2.nextInt(); + int num2 = r3.nextInt(); + System.out.println("num"+num); + System.out.println("num2"+num2); + } +} +``` + +### 常用方法 + +| random.nextInt() | 返回值为整数,范围是int类型范围 | +|---|---| +| random.nextLong() | 返回值为长整型，范围是long类型的范围 | +| random.nextFloat() | 返回值为小数，范围是[0,0.1] | +| random.nextDouble() | 返回值为小数，范围是[0,0.1] | +| random.nextBoolean（） | 返回值为boolean值，true和false概率相同 | +| radom.nextGaussian() | 返回值为呈高斯（“正态”）分布的 double 值，其平均值是 0.0，标准差是 1.0 | diff --git a/Java基础教程/Java标准库/09 System类.md b/Java基础教程/Java标准库/09 System类.md new file mode 100644 index 00000000..2bbcb2e4 --- /dev/null +++ b/Java基础教程/Java标准库/09 System类.md @@ -0,0 +1,59 @@ +## 1 System + + +### 比较有用的方法 +```java +static void setIn(InputStream in) // 标准输入的重定向 +static void setOut(PrintStream out) // 标准输出的重定向 +static void setErr(PrintStream err) // 标准错误的重定向 +/******************************/ +static Map getenv() // 返回所有的环境变量的键值对 +static String getenv(String name) // 返回特定环境变量的值 +/******************************/ +static Properties getProperties() // 返回所有的系统属性 +static String getProperty(String key) // 返回特定的系统属性的值 +/******************************/ +static void setProperties(Properties props) // 设置所有的系统属性 +static String setProperty(String key, String value) // 设置特定的系统属性的值 +/******************************/ +static long currentTimeMillis() // 获取当前系统时间，用毫秒表示，从 1970 年开始。HotSpot VM 中可用 +``` + +### arraycopy(…)方法 + +arraycopy(…)方法将指定原数组中的数据从指定位置复制到目标数组的指定位置。 + +```java +static void arraycopy(Object src, int srcPos, Object dest, int destPos, int length) +``` + +```java +package com.ibelifly.commonclass.system; + +public class Test1 { + public static void main(String[] args) { + int[] arr={23,45,20,67,57,34,98,95}; + int[] dest=new int[8]; + System.arraycopy(arr,4,dest,4,4); + for (int x:dest) { + System.out.print(x+" "); + } + } +} +``` + +### exit(int status)方法 + +exit(int status)方法用于终止当前运行的Java虚拟机。如果参数是0，表示正常退出JVM；如果参数非0，表示异常退出JVM。 + +```java +package com.ibelifly.commonclass.system; + +public class Test4 { + public static void main(String[] args) { + System.out.println("程序开始了"); + System.exit(0); //因为此处已经终止当前运行的Java虚拟机，故不会执行之后的代码 + System.out.println("程序结束了"); + } +} +``` \ No newline at end of file diff --git a/Java基础教程/Java标准库/Arrays类.md b/Java基础教程/Java标准库/Arrays类.md deleted file mode 100644 index 5b1b4bbc..00000000 --- a/Java基础教程/Java标准库/Arrays类.md +++ /dev/null @@ -1,20 +0,0 @@ -## Arrays类中的方法 - -### 方法概述 - -* 给数组赋值：通过 fill 方法。 -* 对数组排序：通过 sort 方法,按升序。 -* 比较数组：通过 equals 方法比较数组中元素值是否相等。 -* 查找数组元素：通过 binarySearch 方法能对排序好的数组进行二分查找法操作。 - - -### 具体方法 - -* public static int binarySearch(Object[] a, Object key) -用二分查找算法在给定数组中搜索给定值的对象(Byte,Int,double等)。数组在调用前必须排序好的。如果查找值包含在数组中，则返回搜索键的索引；否则返回 (-(插入点) - 1)。 -* public static boolean equals(long[] a, long[] a2) -如果两个指定的 long 型数组彼此相等，则返回 true。如果两个数组包含相同数量的元素，并且两个数组中的所有相应元素对都是相等的，则认为这两个数组是相等的。换句话说，如果两个数组以相同顺序包含相同的元素，则两个数组是相等的。同样的方法适用于所有的其他基本数据类型（Byte，short，Int等）。 -* public static void fill(int[] a, int val) -将指定的 int 值分配给指定 int 型数组指定范围中的每个元素。同样的方法适用于所有的其他基本数据类型（Byte，short，Int等）。 -* public static void sort(Object[] a) -对指定对象数组根据其元素的自然顺序进行升序排列。同样的方法适用于所有的其他基本数据类型（Byte，short，Int等）。 \ No newline at end of file diff --git a/Java基础教程/Java标准库/StringBuffer.md b/Java基础教程/Java标准库/StringBuffer.md deleted file mode 100644 index 3b3f69c7..00000000 --- a/Java基础教程/Java标准库/StringBuffer.md +++ /dev/null @@ -1,140 +0,0 @@ -String与StringBuffer的区别 - -简单地说，就是一个变量和常量的关系。StringBuffer对象的内容可以修改；而String对象一旦产生后就不可以被修改，重新赋值其实是两个对象。 - -StringBuffer的内部实现方式和String不同，StringBuffer在进行字符串处理时，不生成新的对象，在内存使用上要优于String类。所以在实际使用时，如果经常需要对一个字符串进行修改，例如插入、删除等操作，使用StringBuffer要更加适合一些。 - -String:在String类中没有用来改变已有字符串中的某个字符的方法，由于不能改变一个java字符串中的某个单独字符，所以在JDK文档中称String类的对象是不可改变的。然而，不可改变的字符串具有一个很大的优点:编译器可以把字符串设为共享的。 - -StringBuffer:StringBuffer类属于一种辅助类，可预先分配指定长度的内存块建立一个字符串缓冲区。这样使用StringBuffer类的append方法追加字符 -比 String使用 + 操作符添加字符 到 一个已经存在的字符串后面有效率得多。因为使用 + -操作符每一次将字符添加到一个字符串中去时，字符串对象都需要寻找一个新的内存空间来容纳更大的字符串，这无凝是一个非常消耗时间的操作。添加多个字符也就意味着要一次又一次的对字符串重新分配内存。使用StringBuffer类就避免了这个问题。 - -StringBuffer是线程安全的，在多线程程序中也可以很方便的进行使用，但是程序的执行效率相对来说就要稍微慢一些。 - -StringBuffer的常用方法 - -StringBuffer类中的方法要偏重于对字符串的变化例如追加、插入和删除等，这个也是StringBuffer和String类的主要区别。 - -1、append方法 - -public StringBuffer append(boolean b) - -该方法的作用是追加内容到当前StringBuffer对象的末尾，类似于字符串的连接。调用该方法以后，StringBuffer对象的内容也发生改变，例如： - -StringBuffer sb = new StringBuffer(“abc”); - -sb.append(true); - -则对象sb的值将变成”abctrue”。 - -使用该方法进行字符串的连接，将比String更加节约内容，例如应用于数据库SQL语句的连接，例如： - -StringBuffer sb = new StringBuffer(); - -String user = “test”; - -String pwd = “123”; - -sb.append(“select \* from userInfo where username=“) - -.append(user) - -.append(“ and pwd=”) - -.append(pwd); - -这样对象sb的值就是字符串“select \* from userInfo where username=test and -pwd=123”。 - -2、deleteCharAt方法 - -public StringBuffer deleteCharAt(int index) - -该方法的作用是删除指定位置的字符，然后将剩余的内容形成新的字符串。例如： - -StringBuffer sb = new StringBuffer(“Test”); - -sb. deleteCharAt(1); - -该代码的作用删除字符串对象sb中索引值为1的字符，也就是删除第二个字符，剩余的内容组成一个新的字符串。所以对象sb的值变为”Tst”。 - -还存在一个功能类似的delete方法： - -public StringBuffer delete(int start,int end) - -该方法的作用是删除指定区间以内的所有字符，包含start，不包含end索引值的区间。例如： - -StringBuffer sb = new StringBuffer(“TestString”); - -sb. delete (1,4); - -该代码的作用是删除索引值1(包括)到索引值4(不包括)之间的所有字符，剩余的字符形成新的字符串。则对象sb的值是”TString”。 - -3、insert方法 - -public StringBuffer insert(int offset, String s) - -该方法的作用是在StringBuffer对象中插入内容，然后形成新的字符串。例如： - -StringBuffer sb = new StringBuffer(“TestString”); - -sb.insert(4,“false”); - -该示例代码的作用是在对象sb的索引值4的位置插入字符串false，形成新的字符串，则执行以后对象sb的值是”TestfalseString”。 - -4、reverse方法 - -public StringBuffer reverse() - -该方法的作用是将StringBuffer对象中的内容反转，然后形成新的字符串。例如： - -StringBuffer sb = new StringBuffer(“abc”); - -sb.reverse(); - -经过反转以后，对象sb中的内容将变为”cba”。 - -5、setCharAt方法 - -public void setCharAt(int index, char ch) - -该方法的作用是修改对象中索引值为index位置的字符为新的字符ch。例如： - -StringBuffer sb = new StringBuffer(“abc”); - -sb.setCharAt(1,’D’); - -则对象sb的值将变成”aDc”。 - -6、trimToSize方法 - -public void trimToSize() - -该方法的作用是将StringBuffer对象的中存储空间缩小到和字符串长度一样的长度，减少空间的浪费。 - -7、构造方法： - -StringBuffer s0=new StringBuffer();分配了长16字节的字符缓冲区 - -StringBuffer s1=new StringBuffer(512);分配了512字节的字符缓冲区 - -8、获取字符串的长度: length() - -StringBuffer s = new StringBuffer("www"); - -int i=s.length(); - -m.返回字符串的一部分值 - -substring(int start) //返回从start下标开始以后的字符串 - -substring(int start,int end) //返回从start到 end-1字符串 - -9.替换字符串 - -replace(int start,int end,String str) - -s.replace(0,1,"qqq"); - -10.转换为不变字符串:toString()。 diff --git a/Java基础教程/Java标准库/image/2022-07-12-11-07-56.png b/Java基础教程/Java标准库/image/2022-07-12-11-07-56.png new file mode 100644 index 0000000000000000000000000000000000000000..5eb881b7dd02c87102d54f99f5f5c0af859db479 GIT binary patch literal 37828 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 literal 0 HcmV?d00001 diff --git a/Java基础教程/Java源代码/codedemo/aspectj/BusinessService.java b/Java基础教程/Java源代码/codedemo/aspectj/BusinessService.java new file mode 100644 index 00000000..36f465c4 --- /dev/null +++ b/Java基础教程/Java源代码/codedemo/aspectj/BusinessService.java @@ -0,0 +1,142 @@ +package cn.aofeng.demo.aspectj; + +/** + * 模拟业务方法，将被Aspectj织入代码，增加功能。 + * + * @author 聂勇 + */ +public class BusinessService { + + public long add(int a, int b) { + return a+b; + } + + public long add(int a, int b, int... other) { + long result = a + b; + for (int i : other) { + result += i; + } + + return result; + } + + public String join(String first, String... appends) { + if (null == first) { + throw new IllegalArgumentException("first is null"); + } + StringBuilder buffer = new StringBuilder(); + buffer.append(first); + for (String str : appends) { + buffer.append(str); + } + + return buffer.toString(); + } + + public String addPrefix(String src) { + if (null == src) { + throw new IllegalArgumentException("src is null"); + } + + return "-->"+src; + } + + public static void printLine(char style) { + if ('=' == style) { + System.out.println("========================================================================================"); + } else if ('-' == style) { + System.out.println("----------------------------------------------------------------------------------------"); + } else { + System.out.println(" "); + } + } + + public static void main(String[] args) { + final BusinessService bs = new BusinessService(); + + System.out.println("1、执行方法add(int, int)"); + RunMethod rm = new RunMethod() { + + @Override + public void run() { + long result = bs.add(1, 2); + System.out.println(">>> 结果：" + result); + } + }; + rm.execute(); + + System.out.println("2、执行方法add(int, int, int...)"); + rm = new RunMethod() { + + @Override + public void run() { + long result = bs.add(1, 2, 3, 4, 5, 6, 7, 8, 9, 10); + System.out.println(">>> 结果：" + result); + } + }; + rm.execute(); + + System.out.println("3、执行方法join(String, String...)"); + rm = new RunMethod() { + + @Override + public void run() { + String str = bs.join("first", "-second", "-third"); + System.out.println(">>> 结果：" + str); + } + }; + rm.execute(); + + System.out.println("4、执行方法join(String, String...)"); + rm = new RunMethod() { + + @Override + public void run() { + String str = bs.join(null, "-second", "-third"); + System.out.println(">>> 结果：" + str); + } + }; + rm.execute(); + + System.out.println("5、执行方法addPrefix(String)"); + rm = new RunMethod() { + + @Override + public void run() { + String str = bs.addPrefix("原字符串"); + System.out.println(">>> 结果：" + str); + } + }; + rm.execute(); + + System.out.println("6、执行方法addPrefix(String)"); + rm = new RunMethod() { + + @Override + public void run() { + String str = bs.addPrefix(null); + System.out.println(">>> 结果：" + str); + } + }; + rm.execute(); + } + + public static abstract class RunMethod { + + private char _style = '='; + + public void execute() { + printLine(_style); + try { + run(); + } catch (Exception e) { + e.printStackTrace(System.err); + } + printLine(_style); + printLine(' '); + } + + public abstract void run(); + } + +} diff --git a/Java基础教程/Java源代码/codedemo/aspectj/BusinessServiceInterceptor.java b/Java基础教程/Java源代码/codedemo/aspectj/BusinessServiceInterceptor.java new file mode 100644 index 00000000..847a2a41 --- /dev/null +++ b/Java基础教程/Java源代码/codedemo/aspectj/BusinessServiceInterceptor.java @@ -0,0 +1,122 @@ +package cn.aofeng.demo.aspectj; + +import org.apache.commons.lang.ArrayUtils; +import org.aspectj.lang.JoinPoint; +import org.aspectj.lang.ProceedingJoinPoint; +import org.aspectj.lang.annotation.After; +import org.aspectj.lang.annotation.AfterReturning; +import org.aspectj.lang.annotation.AfterThrowing; +import org.aspectj.lang.annotation.Around; +import org.aspectj.lang.annotation.Aspect; +import org.aspectj.lang.annotation.Before; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +/** + * 拦截器。 + * + * @author 聂勇 + */ +@Aspect +public class BusinessServiceInterceptor { + + private static Logger _logger = LoggerFactory.getLogger(BusinessServiceInterceptor.class); + + private char _style = '-'; + + /** + * 
+     * Before通知不能修改方法传入的参数。
+     *
+ */ + @Before("execution(public * cn.aofeng.demo.aspectj.BusinessService.add(..))") + public void beforeAdd(JoinPoint joinPoint) { + _logger.info( String.format("拦截到方法：%s, 传入参数：%s", + joinPoint.getSignature().getName(), + ArrayUtils.toString(joinPoint.getArgs()) ) ); + BusinessService.printLine(_style); + } + + /** + * 
+     * After通知不能修改方法的返回值。
+     * 如果被拦截的方法抛出异常，拦截代码仍然正常执行。
+     *
+ */ + @After("execution(public * cn.aofeng.demo.aspectj.BusinessService.join(..))") + public void beforeAddSupportMultiArgs(JoinPoint joinPoint) { + _logger.info("Signature.name："+joinPoint.getSignature().getName()); + _logger.info("Args：" + ArrayUtils.toString(joinPoint.getArgs())); + _logger.info("Target：" + ArrayUtils.toString(joinPoint.getTarget())); + _logger.info("This：" + ArrayUtils.toString(joinPoint.getThis())); + _logger.info("Kind：" + ArrayUtils.toString(joinPoint.getKind())); + _logger.info("SourceLocation：" + ArrayUtils.toString(joinPoint.getSourceLocation())); + + // 试图修改传入的参数 + joinPoint.getArgs()[0] = "100"; + + BusinessService.printLine(_style); + } + + /** + * 
+     * AfterReturning通知不能修改方法的返回值。
+     * 如果被拦截的方法抛出异常，拦截代码不再执行。
+     *
+ */ + @AfterReturning(pointcut="execution(public * cn.aofeng.demo.aspectj.BusinessService.join(..))", returning="result") + public void afterReturnAdd(JoinPoint joinPoint, Object result) { + _logger.info( String.format("拦截到方法：%s, 传入参数：%s, 执行结果：%s", + joinPoint.getSignature().getName(), + ArrayUtils.toString(joinPoint.getArgs()), + result) ); + + // 试图修改返回值 + result = "hello, changed"; + + BusinessService.printLine(_style); + } + + /** + * 
+     * 只在被拦截的方法抛出异常时才执行。
+     *
+ */ + @AfterThrowing(pointcut="execution(public * cn.aofeng.demo.aspectj.BusinessService.join(..))", throwing="ex") + public void afterThrowingAdd(JoinPoint joinPoint, Exception ex) { + _logger.info( String.format("拦截到方法：%s, 传入参数：%s", + joinPoint.getSignature().getName(), + ArrayUtils.toString(joinPoint.getArgs()) ) ); + if (null != ex) { + _logger.info("拦截到异常：", ex); + } + + BusinessService.printLine(_style); + } + + /** + * 
+     * {@link ProceedingJoinPoint}只能在Around通知中使用。
+     * Around通知可以修改被拦截方法的传入参数和返回值。
+     *
+ */ + @Around("execution(public * cn.aofeng.demo.aspectj.BusinessService.addPrefix(..))") + public Object afterAround(ProceedingJoinPoint joinPoint) throws Throwable { + _logger.info( String.format("拦截到方法：%s, 传入参数：%s", + joinPoint.getSignature().getName(), + ArrayUtils.toString(joinPoint.getArgs()) ) ); + + Object result = null; + try { + result = joinPoint.proceed(); + _logger.info("执行结果：" + result); + } catch (Throwable e) { + throw e; + } finally { + BusinessService.printLine(_style); + } + + return result; + } + +} diff --git a/Java基础教程/Java源代码/codedemo/aspectj/build.xml b/Java基础教程/Java源代码/codedemo/aspectj/build.xml new file mode 100644 index 00000000..b5375f9c --- /dev/null +++ b/Java基础教程/Java源代码/codedemo/aspectj/build.xml @@ -0,0 +1,64 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/Java基础教程/Java源代码/codedemo/dbutils/DbUtilsDemo.java b/Java基础教程/Java源代码/codedemo/dbutils/DbUtilsDemo.java new file mode 100644 index 00000000..08f60967 --- /dev/null +++ b/Java基础教程/Java源代码/codedemo/dbutils/DbUtilsDemo.java @@ -0,0 +1,205 @@ +package cn.aofeng.demo.dbutils; + +import java.sql.ResultSet; +import java.sql.SQLException; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.Properties; + +import javax.sql.DataSource; + +import org.apache.commons.dbutils.QueryRunner; +import org.apache.commons.dbutils.ResultSetHandler; +import org.apache.commons.dbutils.handlers.BeanHandler; +import org.apache.commons.dbutils.handlers.BeanListHandler; +import org.apache.commons.dbutils.handlers.MapHandler; +import org.apache.commons.dbutils.handlers.MapListHandler; +import org.apache.log4j.Logger; + +import com.mysql.jdbc.jdbc2.optional.MysqlDataSource; + +/** + * Apache DbUtils使用示例。 + * + * @author 聂勇 + */ +public class DbUtilsDemo { + + private static Logger _logger = Logger.getLogger(DbUtilsDemo.class); + + /** + * 创建JDBC连接池。 + * + * @param pros 数据库连接信息，里面包含4个键值对。 + * 
+     * jdbcDriver => JDBC驱动类名称
+     * url => 数据库JDBC连接地址
+     * user => 连接数据库的用户名
+     * password => 连接数据库的密码
+     * 
+     * @return 连接池对象
+     */
+    private DataSource createDataSource(Properties pros) {
+        MysqlDataSource ds = new MysqlDataSource();
+        ds.setURL(pros.getProperty("url"));
+        ds.setUser(pros.getProperty("user"));
+        ds.setPassword(pros.getProperty("password"));
+        
+        return ds;
+    }
+    
+    /**
+     * 将查询结果集转换成Bean列表返回。
+     * 
+     * @param ds JDBC连接池
+     */
+    public void queryBeanList(DataSource ds) {
+        String sql = "select userId, userName, gender, age from student";
+        
+        QueryRunner run = new QueryRunner(ds);
+        ResultSetHandler> handler = new BeanListHandler(Student.class);
+        List result = null;
+        try {
+            result = run.query(sql, handler);
+        } catch (SQLException e) {
+            _logger.error("获取JDBC连接出错或执行SQL出错", e);
+        }
+        
+        if (null == result) {
+            return;
+        }
+        for (Student student : result) {
+            System.out.println(student);
+        }
+    }
+    
+    /**
+     * 将查询结果转换成Bean返回。
+     * 
+     * @param ds JDBC连接池
+     */
+    public void queryBean(DataSource ds, int userId) {
+        String sql = "select userId, userName, gender, age from student where userId=?";
+        
+        QueryRunner run = new QueryRunner(ds);
+        ResultSetHandler handler = new BeanHandler(Student.class);
+        Student result = null;
+        try {
+            result = run.query(sql, handler, userId);
+        } catch (SQLException e) {
+            _logger.error("获取JDBC连接出错或执行SQL出错", e);
+        }
+        
+        System.out.println(result);
+    }
+    
+    /**
+     * 将查询结果集转换成键值对列表返回。
+     * 
+     * @param ds JDBC连接池
+     */
+    public void queryMapList(DataSource ds) {
+        String sql = "select userId, userName, gender, age from student";
+        
+        QueryRunner run = new QueryRunner(ds);
+        ResultSetHandler>> handler = new MapListHandler();
+        List> result = null;
+        try {
+            result = run.query(sql, handler);
+        } catch (SQLException e) {
+            _logger.error("获取JDBC连接出错或执行SQL出错", e);
+        }
+        
+        if (null == result) {
+            return;
+        }
+        for (Map map : result) {
+            System.out.println(map);
+        }
+    }
+    
+    /**
+     * 将查询结果集转换成键值对列表返回。
+     * 
+     * @param ds JDBC连接池
+     * @param userId 用户编号
+     */
+    public void queryMap(DataSource ds, int userId) {
+        String sql = "select userId, userName, gender, age from student where userId=?";
+        
+        QueryRunner run = new QueryRunner(ds);
+        ResultSetHandler> handler = new MapHandler();
+        Map result = null;
+        try {
+            result = run.query(sql, handler, userId);
+        } catch (SQLException e) {
+            _logger.error("获取JDBC连接出错或执行SQL出错", e);
+        }
+        
+        System.out.println(result);
+    }
+    
+    /**
+     * 将查询结果集转换成键值对列表返回。
+     * 
+     * @param ds JDBC连接池
+     */
+    public void queryCustomHandler(DataSource ds) {
+        String sql = "select userId, userName, gender, age from student";
+        
+        // 新实现一个ResultSetHandler
+        ResultSetHandler> handler = new ResultSetHandler>() {
+            @Override
+            public List handle(ResultSet resultset)
+                    throws SQLException {
+                List result = new ArrayList();
+                while (resultset.next()) {
+                    Student student = new Student();
+                    student.setUserId(resultset.getInt("userId"));
+                    student.setUserName(resultset.getString("userName"));
+                    student.setGender(resultset.getString("gender"));
+                    student.setAge(resultset.getInt("age"));
+                    result.add(student);
+                }
+                
+                return result;
+            }
+            
+        };
+        
+        QueryRunner run = new QueryRunner(ds);
+        List result = null;
+        try {
+            result = run.query(sql, handler);
+        } catch (SQLException e) {
+            _logger.error("获取JDBC连接出错或执行SQL出错", e);
+        }
+        
+        if (null == result) {
+            return;
+        }
+        for (Student student : result) {
+            System.out.println(student);
+        }
+    }
+    
+    public static void main(String[] args) {
+        Properties pros = new Properties();
+        pros.put("jdbcDriver", "com.mysql.jdbc.Driver");
+        pros.put("url", "jdbc:mysql://192.168.56.102:19816/test?useUnicode=true&characterEncoding=UTF8");
+        pros.put("user", "uzone");
+        pros.put("password", "uzone");
+        
+        DbUtilsDemo demo = new DbUtilsDemo();
+        DataSource ds = demo.createDataSource(pros);
+        demo.queryBeanList(ds);
+        demo.queryBean(ds, 1);
+        demo.queryBean(ds, 9);
+        demo.queryMapList(ds);
+        demo.queryMap(ds, 3);
+        demo.queryMap(ds, 9);
+        demo.queryCustomHandler(ds);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/dbutils/README.md b/Java基础教程/Java源代码/codedemo/dbutils/README.md
new file mode 100644
index 00000000..ee80be8e
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/dbutils/README.md
@@ -0,0 +1,226 @@
+Apache DbUtils 使用教程
+===
+用JDBC编程时，需要关注和处理的内容非常多，而且很容易造成连接资源没有释放导致泄漏的问题。一个普通的查询操作其处理过程如下：
+
+1. 创建Connection。
+1. 创建Statement。
+1. 执行SQL生成ResultSet，历遍ResultSet中的所有行记录提取列数据并转换成所需的对象。
+1. 关闭ResultSet。
+1. 关闭Statement。
+1. 关闭Connection。
+
+`Apache DbUtils`对JDBC操作进行了轻量地封装，解决了两个问题：
+
+1. 自动创建和释放连接资源，不再有泄漏问题。
+2. 自动将Result转换成对象。填入不同的`ResultSetHandler`，可将ResultSet转换成不同的对象。
+
+使得代码更加简洁和健壮，让你将精力更多地投入到业务处理中。
+
+预备
+---
+* MySQL数据库
+* commons-dbutils-1.5.jar
+* mysql-connector-java-5.1.22-bin.jar
+
+创建表和初始化数据
+---
+1、表结构。
+```sql
+CREATE TABLE `student` (
+  `userId` int(11) NOT NULL,
+  `userName` varchar(30) NOT NULL,
+  `gender` char(1) NOT NULL,
+  `age` int(11) DEFAULT NULL,
+  PRIMARY KEY (`userId`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8 ;
+```
+
+2、初始化数据。
+
+| userId | userName | gender | age |
+| :--- | :--- | :--- | :--- |
+| 1 |  张三 | M | 20 |
+| 2 | 李四 | M | 21 |
+| 3 | 王五 | M | 22 |
+| 4 | 小明 | M | 6 |
+| 5 | 小丽 | F | 9 |
+
+编写查询代码
+---
+###1、将查询结果转换成POJO对象列表。
+
+1）定义一个与表student相对应的对象Student（[源代码下载](https://raw.githubusercontent.com/aofeng/JavaDemo/master/src/cn/aofeng/demo/dbutils/Student.java)）。
+
+2）使用`BeanListHandler`将查询结果转换成POJO对象列表。
+```java
+public void queryBeanList(DataSource ds) {
+    String sql = "select userId, userName, gender, age from student";
+    
+    QueryRunner run = new QueryRunner(ds);
+    ResultSetHandler> handler = new BeanListHandler(Student.class);
+    List result = null;
+    try {
+        result = run.query(sql, handler);
+    } catch (SQLException e) {
+        _logger.error("获取JDBC连接出错或执行SQL出错", e);
+    }
+     
+    if (null == result) {
+        return;
+    }
+    for (Student student : result) {
+        System.out.println(student);
+    }
+}
+```
+执行queryBeanList方法，控制台输出如下信息：
+```
+Student [userId=1, userName=张三, gender=M, age=20]
+Student [userId=2, userName=李四, gender=M, age=21]
+Student [userId=3, userName=王五, gender=M, age=22]
+Student [userId=4, userName=小明, gender=M, age=6]
+Student [userId=5, userName=小丽, gender=F, age=9]
+```
+
+###2、将查询结果转换成一个POJO象。
+
+1）定义一个与表student相对应的对象Student（[源代码下载](https://raw.githubusercontent.com/aofeng/JavaDemo/master/src/cn/aofeng/demo/dbutils/Student.java)）。
+
+2）使用`BeanHandler`将查询结果转换成一个POJO对象。
+```java
+public void queryBean(DataSource ds, int userId) {
+    String sql = "select userId, userName, gender, age from student where userId=?";
+    
+    QueryRunner run = new QueryRunner(ds);
+    ResultSetHandler handler = new BeanHandler(Student.class);
+    Student result = null;
+    try {
+        result = run.query(sql, handler, userId);
+    } catch (SQLException e) {
+        _logger.error("获取JDBC连接出错或执行SQL出错", e);
+    }
+       
+    System.out.println(result);
+}
+```
+执行queryBean方法，控制台输出如下信息：
+```
+Student [userId=1, userName=张三, gender=M, age=20]
+```
+
+###3、将查询结果转换成Map对象列表。
+
+1）使用`MapListHandler`将ResultSet转换成Map对象列表。
+```java
+public void queryMapList(DataSource ds) {
+    String sql = "select userId, userName, gender, age from student";
+    
+    QueryRunner run = new QueryRunner(ds);
+    ResultSetHandler>> handler = new MapListHandler();
+    List> result = null;
+    try {
+        result = run.query(sql, handler);
+    } catch (SQLException e) {
+        _logger.error("获取JDBC连接出错或执行SQL出错", e);
+    }
+    
+    if (null == result) {
+        return;
+    }
+    for (Map map : result) {
+        System.out.println(map);
+    }
+}
+```
+执行queryMapList方法，控制台输出如下信息：
+```
+{age=20, userId=1, gender=M, userName=张三}
+{age=21, userId=2, gender=M, userName=李四}
+{age=22, userId=3, gender=M, userName=王五}
+{age=6, userId=4, gender=M, userName=小明}
+{age=9, userId=5, gender=F, userName=小丽}
+```
+
+###4、将查询结果转换成一个Map对象。
+
+1）使用`MapHandler`将ResultSet转换成一个Map对象。
+```java
+public void queryMap(DataSource ds, int userId) {
+    String sql = "select userId, userName, gender, age from student where userId=?";
+    
+    QueryRunner run = new QueryRunner(ds);
+    ResultSetHandler> handler = new MapHandler();
+    Map result = null;
+    try {
+        result = run.query(sql, handler, userId);
+    } catch (SQLException e) {
+        _logger.error("获取JDBC连接出错或执行SQL出错", e);
+    }
+    
+    System.out.println(result);
+}
+```
+执行queryMap方法，控制台输出如下信息：
+```
+{age=22, userId=3, gender=M, userName=王五}
+```
+
+###5、自定义ResultSetHandler。
+
+`Apache DbUtils`自带的各种`ResultSetHandler`已经可以满足绝大部分的查询需求，如果有一些特殊的要求满足不了，可以自己实现一个。
+```java
+public void queryCustomHandler(DataSource ds) {
+    String sql = "select userId, userName, gender, age from student";
+    
+    // 新实现一个ResultSetHandler
+    ResultSetHandler> handler = new ResultSetHandler>() {
+        @Override
+        public List handle(ResultSet resultset)
+                throws SQLException {
+            List result = new ArrayList();
+            while (resultset.next()) {
+                Student student = new Student();
+                student.setUserId(resultset.getInt("userId"));
+                student.setUserName(resultset.getString("userName"));
+                student.setGender(resultset.getString("gender"));
+                student.setAge(resultset.getInt("age"));
+                result.add(student);
+            }
+            
+            return result;
+        }
+        
+    };
+    
+    QueryRunner run = new QueryRunner(ds);
+    List result = null;
+    try {
+        result = run.query(sql, handler);
+    } catch (SQLException e) {
+        _logger.error("获取JDBC连接出错或执行SQL出错", e);
+    }
+      
+    if (null == result) {
+        return;
+    }
+    for (Student student : result) {
+        System.out.println(student);
+    }
+}
+```
+执行queryCustomHandler方法，控制台输出如下信息：
+```
+Student [userId=1, userName=张三, gender=M, age=20]
+Student [userId=2, userName=李四, gender=M, age=21]
+Student [userId=3, userName=王五, gender=M, age=22]
+Student [userId=4, userName=小明, gender=M, age=6]
+Student [userId=5, userName=小丽, gender=F, age=9]
+```
+
+附录
+---
+* [DEMO完整源代码](https://github.com/aofeng/JavaDemo/edit/master/src/cn/aofeng/demo/dbutils)
+
+参考资料
+---
+* [commons-dbutils example](http://commons.apache.org/proper/commons-dbutils/examples.html)
diff --git a/Java基础教程/Java源代码/codedemo/dbutils/Student.java b/Java基础教程/Java源代码/codedemo/dbutils/Student.java
new file mode 100644
index 00000000..7e910bd3
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/dbutils/Student.java
@@ -0,0 +1,86 @@
+package cn.aofeng.demo.dbutils;
+
+/**
+ * 表student的POJO对象。
+ * 
+ * @author 聂勇
+ */
+public class Student {
+
+    private Integer userId;
+    
+    private String userName;
+    
+    private String gender;
+    
+    private Integer age;
+
+    public Integer getUserId() {
+        return userId;
+    }
+
+    public void setUserId(Integer userId) {
+        this.userId = userId;
+    }
+
+    public String getUserName() {
+        return userName;
+    }
+
+    public void setUserName(String userName) {
+        this.userName = userName;
+    }
+
+    public String getGender() {
+        return gender;
+    }
+
+    public void setGender(String gender) {
+        this.gender = gender;
+    }
+
+    public Integer getAge() {
+        return age;
+    }
+
+    public void setAge(Integer age) {
+        this.age = age;
+    }
+
+    @Override
+    public int hashCode() {
+        final int prime = 31;
+        int result = 1;
+        result = prime * result + ((age == null) ? 0 : age.hashCode());
+        return result;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) {
+            return true;
+        }
+        if (obj == null) {
+            return false;
+        }
+        if (!(obj instanceof Student)) {
+            return false;
+        }
+        Student other = (Student) obj;
+        if (age == null) {
+            if (other.age != null) {
+                return false;
+            }
+        } else if (!age.equals(other.age)) {
+            return false;
+        }
+        return true;
+    }
+
+    @Override
+    public String toString() {
+        return "Student [userId=" + userId + ", userName=" + userName
+                + ", gender=" + gender + ", age=" + age + "]";
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/easymock/README.md b/Java基础教程/Java源代码/codedemo/easymock/README.md
new file mode 100644
index 00000000..f23550c2
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/easymock/README.md
@@ -0,0 +1,258 @@
+用EasyMock生成模拟对象进行单元测试 ｜ Testing with EasyMock
+===
+当项目达到一定规模时会根据业务或功能进行模块化，这时研发团队在协作时会碰到一个问题：如何让相互依赖的各模块并行开发？常用的办法是：各模块之间有清晰的边界，模块之间的交互通过接口。在设计阶段定义模块的接口，然后各个模块开发时遵循接口的定义进行实现和调用。
+
+OK，并行开发的问题解决了。但不同的模块因其复杂度和工作量不同，进度不一致。当研发同学完成所负责的模块时，但依赖的模块还没有完成开发，不好进行测试。
+这里就讲如何用EasyMock生成Mock Object模拟所依赖模块的接口来完成单元测试。
+
+![EasyMock](http://img1.ph.126.net/wErY4T7Ne-KeyB66As_PLA==/6608670713840748025.gif)
+
+预备
+---
+* easymock-3.2.jar
+* easymockclassextension-3.2.jar
+* cglib-2.2.2.jar
+* objenesis-1.2.jar
+* asm-3.1.jar
+* asm-commons-3.1.jar
+* asm-util-3.1.jar
+* gson-2.2.4.jar   // *用于处理JSON*
+
+注：上面的jar文件均可从[MAVEN仓库](http://mvnrepository.com)下载。
+
+
+使用EasyMock的五部曲
+---
+1、引入EasyMock。
+```java
+import static org.easymock.EasyMock.*;
+```
+2、创建Mock Object。
+```java
+mock = createMock(InterfaceOrClass.class);
+```
+3、设置Mock Object的行为和预期结果。
+```java
+mock.doSomeThing();
+expectLastCall().times(1);   // 至少要调用一次doSomeThing方法
+```
+或者
+```java
+// 模拟抛出异常
+expect(mock.getSomeThing(anyString()))
+    .andThrow(new IOException("单元测试特意抛的异常")); 
+
+// 模拟返回指定的数据
+expect(mock.getSomeThing(anyString()))
+    .andReturn("abcd");  
+```
+4、设置Mock Object变成可用状态。
+```java
+replay(mock);
+```
+5、运行单元测试代码（会调用到Mock Object的方法）。
+```java
+// 如果是校验调用次数就要用到verify方法
+verify(mock);
+```
+
+实践
+---
+### 业务代码
+[源码下载](https://raw.githubusercontent.com/aofeng/JavaDemo/master/src/cn/aofeng/demo/easymock/UserService.java)
+```java
+package cn.aofeng.demo.easymock;
+
+import java.io.IOException;
+import java.lang.reflect.Type;
+import java.util.Map;
+
+import org.apache.log4j.Logger;
+
+import com.google.gson.Gson;
+import com.google.gson.reflect.TypeToken;
+
+import cn.aofeng.demo.jetty.HttpGet;
+
+/**
+ * 用户相关服务。如：获取用户昵称。
+ * 
+ * @author 聂勇
+ */
+public class UserService {
+
+    private static Logger _logger = Logger.getLogger(UserService.class);
+    
+    private HttpGet _httpGet = new HttpGet();
+    
+    /**
+     * 根据用户的账号ID获取昵称。
+     * 
+     * @param accountId 用户的账号ID
+     * @return 如果账号ID有效且请求成功，返回昵称；否则返回默认的昵称"用户xxx"。
+     */
+    public String getNickname(String accountId) {
+        String targetUrl = "http://192.168.56.102:8080/user?method=getNickname&accountId="+accountId;
+        String response = null;
+        try {
+            response = _httpGet.getSomeThing(targetUrl);
+        } catch (IOException e) {
+            _logger.error("获取用户昵称时出错,账号ID:"+accountId, e);
+        }
+        
+        if (null != response) {
+            // 响应数据结构示例：{"nickname":"张三"}
+            Type type = new TypeToken>() {}.getType();
+            Map data = new Gson().fromJson(response, type);
+            if (null != data && data.containsKey("nickname")) {
+                return data.get("nickname");
+            }
+        }
+        
+        return "用户"+accountId;
+    }
+
+    protected void setHttpGet(HttpGet httpGet) {
+        this._httpGet = httpGet;
+    }
+
+}
+```
+
+[源码下载](https://raw.githubusercontent.com/aofeng/JavaDemo/master/src/cn/aofeng/demo/jetty/HttpGet.java)
+```java
+package cn.aofeng.demo.jetty;
+
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.net.HttpURLConnection;
+import java.net.URL;
+
+import org.apache.commons.io.IOUtils;
+
+/**
+ * HTTP GET请求。
+ * 
+ * @author 聂勇
+ */
+public class HttpGet {
+
+    public String getSomeThing(String urlStr) throws IOException {
+        URL url = new URL(urlStr);
+        HttpURLConnection urlConn = (HttpURLConnection) url.openConnection();
+        urlConn.setConnectTimeout(3000);
+        urlConn.setRequestMethod("GET");
+        urlConn.connect();
+        
+        InputStream ins = null;
+        try {
+            if (200 == urlConn.getResponseCode()) {
+                ins = urlConn.getInputStream();
+                ByteArrayOutputStream outs = new ByteArrayOutputStream(1024);
+                IOUtils.copy(ins, outs);
+                return outs.toString("UTF-8");
+            }
+        } catch (IOException e) {
+            throw e;
+        } finally {
+            IOUtils.closeQuietly(ins);
+        }
+        
+        return null;
+    }
+
+}
+```
+
+### 单元测试代码
+[源码下载](https://raw.githubusercontent.com/aofeng/JavaDemo/master/src/cn/aofeng/demo/easymock/UserServiceTest.java)
+```java
+package cn.aofeng.demo.easymock;
+
+import static org.junit.Assert.*;
+
+import java.io.IOException;
+
+import static org.easymock.EasyMock.*;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+
+import cn.aofeng.demo.jetty.HttpGet;
+
+/**
+ * {@link UserService}的单元测试用例。
+ * 
+ * @author 聂勇
+ */
+public class UserServiceTest {
+
+    private HttpGet _mock = createMock(HttpGet.class);
+    
+    @Before
+    public void setUp() throws Exception {
+    }
+    
+    @After
+    public void tearDown() throws Exception {
+        reset(_mock);
+    }
+    
+    
+    /**
+     * 测试用例：获取用户昵称 

+     * 前置条件：
+     * 
+     * 网络请求时发生IO异常
+     * 

+     * 
+     * 测试结果：
+     * 
+     * 返回默认的用户昵称"用户xxx"
+     * 

+     */
+    @Test
+    public void testGetNickname4OccursIOError() throws IOException {
+        // 设置Mock
+        expect(_mock.getSomeThing(anyString()))
+                .andThrow(new IOException("单元测试特意抛的异常"));
+        replay(_mock);
+        
+        UserService us = new UserService();
+        us.setHttpGet(_mock);
+        String nickname = us.getNickname("123456");
+        verify(_mock); // 校验mock
+        assertEquals("用户123456", nickname); // 检查返回值
+    }
+
+    /**
+     * 测试用例：获取用户昵称 

+     * 前置条件：
+     * 
+     * 1、网络请求成功。
+     * 2、响应状态码为200且响应内容符合接口定义（{\"nickname\":\"张三\"}）。
+     * 

+     * 
+     * 测试结果：
+     * 
+     * 返回"张三"
+     * 

+     */
+    @Test
+    public void testGetNickname4Success() throws IOException {
+        // 设置Mock
+        _mock.getSomeThing(anyString());
+        expectLastCall().andReturn("{\"nickname\":\"张三\"}");
+        expectLastCall().times(1);
+        replay(_mock);
+        
+        UserService us = new UserService();
+        us.setHttpGet(_mock);
+        String nickname = us.getNickname("123456");
+        verify(_mock); // 校验方法的调用次数
+        assertEquals("张三", nickname); // 校验返回值
+    }
+
+}
+```
diff --git a/Java基础教程/Java源代码/codedemo/easymock/UserService.java b/Java基础教程/Java源代码/codedemo/easymock/UserService.java
new file mode 100644
index 00000000..ea0af00e
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/easymock/UserService.java
@@ -0,0 +1,56 @@
+package cn.aofeng.demo.easymock;
+
+import java.io.IOException;
+import java.lang.reflect.Type;
+import java.util.Map;
+
+import org.apache.log4j.Logger;
+
+import com.google.gson.Gson;
+import com.google.gson.reflect.TypeToken;
+
+import cn.aofeng.demo.jetty.HttpGet;
+
+/**
+ * 用户相关服务。如：获取用户昵称。
+ * 
+ * @author 聂勇
+ */
+public class UserService {
+
+    private static Logger _logger = Logger.getLogger(UserService.class);
+    
+    private HttpGet _httpGet = new HttpGet();
+    
+    /**
+     * 根据用户的账号ID获取昵称。
+     * 
+     * @param accountId 用户的账号ID
+     * @return 如果账号ID有效且请求成功，返回昵称；否则返回默认的昵称"用户xxx"。
+     */
+    public String getNickname(String accountId) {
+        String targetUrl = "http://192.168.56.102:8080/user?method=getNickname&accountId="+accountId;
+        String response = null;
+        try {
+            response = _httpGet.getSomeThing(targetUrl);
+        } catch (IOException e) {
+            _logger.error("获取用户昵称时出错,账号ID:"+accountId, e);
+        }
+        
+        if (null != response) {
+            // 响应数据结构示例：{"nickname":"张三"}
+            Type type = new TypeToken>() {}.getType();
+            Map data = new Gson().fromJson(response, type);
+            if (null != data && data.containsKey("nickname")) {
+                return data.get("nickname");
+            }
+        }
+        
+        return "用户"+accountId;
+    }
+
+    protected void setHttpGet(HttpGet httpGet) {
+        this._httpGet = httpGet;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/easymock/UserServiceTest.java b/Java基础教程/Java源代码/codedemo/easymock/UserServiceTest.java
new file mode 100644
index 00000000..a0cac709
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/easymock/UserServiceTest.java
@@ -0,0 +1,87 @@
+package cn.aofeng.demo.easymock;
+
+import static org.junit.Assert.*;
+
+import java.io.IOException;
+
+import static org.easymock.EasyMock.*;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+
+import cn.aofeng.demo.jetty.HttpGet;
+
+/**
+ * {@link UserService}的单元测试用例。
+ * 
+ * @author 聂勇
+ */
+public class UserServiceTest {
+
+    private HttpGet _mock = createMock(HttpGet.class);
+    
+    @Before
+    public void setUp() throws Exception {
+    }
+    
+    @After
+    public void tearDown() throws Exception {
+        reset(_mock);
+    }
+    
+    
+    /**
+     * 测试用例：获取用户昵称 

+     * 前置条件：
+     * 
+     * 网络请求时发生IO异常
+     * 

+     * 
+     * 测试结果：
+     * 
+     * 返回默认的用户昵称"用户xxx"
+     * 

+     */
+    @Test
+    public void testGetNickname4OccursIOError() throws IOException {
+        // 设置Mock
+        expect(_mock.getSomeThing(anyString()))
+                .andThrow(new IOException("单元测试特意抛的异常"));
+        replay(_mock);
+        
+        UserService us = new UserService();
+        us.setHttpGet(_mock);
+        String nickname = us.getNickname("123456");
+        verify(_mock); // 校验mock
+        assertEquals("用户123456", nickname); // 检查返回值
+    }
+
+    /**
+     * 测试用例：获取用户昵称 

+     * 前置条件：
+     * 
+     * 1、网络请求成功。
+     * 2、响应状态码为200且响应内容符合接口定义（{\"nickname\":\"张三\"}）。
+     * 

+     * 
+     * 测试结果：
+     * 
+     * 返回"张三"
+     * 

+     */
+    @Test
+    public void testGetNickname4Success() throws IOException {
+        // 设置Mock
+        _mock.getSomeThing(anyString());
+        expectLastCall().andReturn("{\"nickname\":\"张三\"}");
+        expectLastCall().times(1);
+        replay(_mock);
+        
+        UserService us = new UserService();
+        us.setHttpGet(_mock);
+        String nickname = us.getNickname("123456");
+        verify(_mock); // 校验方法的调用次数
+        assertEquals("张三", nickname); // 校验返回值
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/encrypt/AES.java b/Java基础教程/Java源代码/codedemo/encrypt/AES.java
new file mode 100644
index 00000000..253119c8
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/encrypt/AES.java
@@ -0,0 +1,54 @@
+package cn.aofeng.demo.encrypt;
+
+import static cn.aofeng.demo.util.LogUtil.log;
+
+import java.io.UnsupportedEncodingException;
+import java.security.InvalidAlgorithmParameterException;
+import java.security.InvalidKeyException;
+import java.security.NoSuchAlgorithmException;
+
+import javax.crypto.BadPaddingException;
+import javax.crypto.IllegalBlockSizeException;
+import javax.crypto.NoSuchPaddingException;
+import javax.crypto.SecretKey;
+
+import org.apache.commons.codec.binary.Base64;
+
+/**
+ * AES加密与解密。
+ * 
+ * @author 聂勇
+ */
+public class AES extends EncryptAndDecrypt {
+
+    public final String encryptType = "AES/CBC/PKCS5Padding";
+    public final String algorithmParam = "abcdefgh12345678";
+    public final String key = "abcdefgh_1234567";
+
+    public void execute(String data) throws InvalidKeyException,
+            IllegalBlockSizeException, BadPaddingException,
+            UnsupportedEncodingException, NoSuchAlgorithmException,
+            NoSuchPaddingException, InvalidAlgorithmParameterException {
+        SecretKey secretKey = createSecretKey("AES", key);
+        byte[] secretData = encrypt(encryptType, secretKey, data,
+                algorithmParam);
+        log("使用%s加密后的数据：", encryptType);
+        log(Base64.encodeBase64String(secretData));
+
+        String srcStr = decrypt(encryptType, secretKey, secretData,
+                algorithmParam);
+        log("解密后的数据：\n%s", srcStr);
+    }
+
+    public static void main(String[] args) throws UnsupportedEncodingException,
+            InvalidKeyException, IllegalBlockSizeException,
+            BadPaddingException, NoSuchAlgorithmException,
+            NoSuchPaddingException, InvalidAlgorithmParameterException {
+        String data = "炎黄，汉字，english,do it,abcdefghijklmnopqrstuvwxyz,0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ, ~!@#$%^&*()_+=-";
+        log("待加密的数据：\n%s", data);
+
+        AES aes = new AES();
+        aes.execute(data);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/encrypt/Blowfish.java b/Java基础教程/Java源代码/codedemo/encrypt/Blowfish.java
new file mode 100644
index 00000000..c5186ced
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/encrypt/Blowfish.java
@@ -0,0 +1,51 @@
+package cn.aofeng.demo.encrypt;
+
+import static cn.aofeng.demo.util.LogUtil.log;
+
+import java.io.UnsupportedEncodingException;
+import java.security.InvalidAlgorithmParameterException;
+import java.security.InvalidKeyException;
+import java.security.NoSuchAlgorithmException;
+
+import javax.crypto.BadPaddingException;
+import javax.crypto.IllegalBlockSizeException;
+import javax.crypto.NoSuchPaddingException;
+import javax.crypto.SecretKey;
+
+import org.apache.commons.codec.binary.Base64;
+
+/**
+ * Blowfish加密解密。
+ * 
+ * @author 聂勇
+ */
+public class Blowfish extends EncryptAndDecrypt {
+
+    public final String encryptType = "Blowfish";
+    public final String key = "abcdefgh_1234567";
+
+    public void execute(String data) throws InvalidKeyException,
+            IllegalBlockSizeException, BadPaddingException,
+            UnsupportedEncodingException, NoSuchAlgorithmException,
+            NoSuchPaddingException, InvalidAlgorithmParameterException {
+        SecretKey secretKey = createSecretKey(encryptType, key);
+        byte[] secretData = encrypt(encryptType, secretKey, data);
+        log("使用%s加密后的数据：", encryptType);
+        log(Base64.encodeBase64String(secretData));
+
+        String srcStr = decrypt(encryptType, secretKey, secretData);
+        log("解密后的数据：\n%s", srcStr);
+    }
+
+    public static void main(String[] args) throws UnsupportedEncodingException,
+            InvalidKeyException, IllegalBlockSizeException,
+            BadPaddingException, NoSuchAlgorithmException,
+            NoSuchPaddingException, InvalidAlgorithmParameterException {
+        String data = "炎黄，汉字，english,do it,abcdefghijklmnopqrstuvwxyz,0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ, ~!@#$%^&*()_+=-";
+        log("待加密的数据：\n%s", data);
+
+        Blowfish bf = new Blowfish();
+        bf.execute(data);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/encrypt/EncryptAndDecrypt.java b/Java基础教程/Java源代码/codedemo/encrypt/EncryptAndDecrypt.java
new file mode 100644
index 00000000..475523e5
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/encrypt/EncryptAndDecrypt.java
@@ -0,0 +1,125 @@
+package cn.aofeng.demo.encrypt;
+
+import java.io.UnsupportedEncodingException;
+import java.security.InvalidAlgorithmParameterException;
+import java.security.InvalidKeyException;
+import java.security.NoSuchAlgorithmException;
+
+import javax.crypto.BadPaddingException;
+import javax.crypto.Cipher;
+import javax.crypto.IllegalBlockSizeException;
+import javax.crypto.NoSuchPaddingException;
+import javax.crypto.SecretKey;
+import javax.crypto.spec.IvParameterSpec;
+import javax.crypto.spec.SecretKeySpec;
+
+/**
+ * 加密与解密。
+ * 
+ * @author 聂勇
+ */
+public class EncryptAndDecrypt {
+
+    public final static String CHARSET = "utf8";
+
+    /**
+     * 创建安全密钥。
+     * 
+     * @param encryptType
+     *            加密方式，如：AES，Blowfish。详情查看Java Cryptography Architecture Standard Algorithm Name Documentation
+     * @param keyStr
+     *            密钥明文
+     * @return 安全密钥
+     * @throws UnsupportedEncodingException
+     *             不支持指定的字符集编码
+     */
+    public SecretKey createSecretKey(String encryptType, String keyStr)
+            throws UnsupportedEncodingException {
+        byte[] secretKeyData = keyStr.getBytes(CHARSET);
+        SecretKeySpec sks = new SecretKeySpec(secretKeyData, encryptType);
+
+        return sks;
+    }
+
+    /**
+     * 加密数据。
+     * 
+     * @param encryptType 加密方式，如：AES，Blowfish。详情查看Java Cryptography Architecture Standard Algorithm Name Documentation
+     * @param secretKey 密钥
+     * @param srcData 待加密的源数据
+     * @return 加密后的二进制数据（字节数组）
+     * @see #encrypt(String, SecretKey, String, String)
+     */
+    public byte[] encrypt(String encryptType, SecretKey secretKey,
+            String srcData) throws InvalidKeyException,
+            IllegalBlockSizeException, BadPaddingException,
+            UnsupportedEncodingException, NoSuchAlgorithmException,
+            NoSuchPaddingException, InvalidAlgorithmParameterException {
+        return encrypt(encryptType, secretKey, srcData, null);
+    }
+
+    /**
+     * 加密数据。
+     * 
+     * @param encryptType 加密类型，如：AES/CBC/PKCS5Padding
+     * @param secretKey 密钥
+     * @param srcData 待加密的源数据
+     * @param algorithmParam 某些加密算法的附加参数
+     * @return 加密后的二进制数据（字节数组）
+     */
+    public byte[] encrypt(String encryptType, SecretKey secretKey,
+            String srcData, String algorithmParam) throws InvalidKeyException,
+            IllegalBlockSizeException, BadPaddingException,
+            UnsupportedEncodingException, NoSuchAlgorithmException,
+            NoSuchPaddingException, InvalidAlgorithmParameterException {
+        Cipher encrpyt = Cipher.getInstance(encryptType);
+        if (null == algorithmParam) {
+            encrpyt.init(Cipher.ENCRYPT_MODE, secretKey);
+        } else {
+            IvParameterSpec iv = new IvParameterSpec(
+                    algorithmParam.getBytes(CHARSET));
+            encrpyt.init(Cipher.ENCRYPT_MODE, secretKey, iv);
+        }
+        byte[] secretData = encrpyt.doFinal(srcData.getBytes(CHARSET));
+
+        return secretData;
+    }
+
+    /**
+     * 解密数据。
+     * 
+     * @param decryptType 解密方式，如：AES，Blowfish。详情查看Java Cryptography Architecture Standard Algorithm Name Documentation
+     * @param secretKey 密钥
+     * @param secretData 待解密的数据
+     * @return 解密后的数据
+     * @see #decrypt(String, SecretKey, byte[], String)
+     */
+    public String decrypt(String decryptType, SecretKey secretKey,
+            byte[] secretData) throws InvalidKeyException,
+            IllegalBlockSizeException, BadPaddingException,
+            UnsupportedEncodingException, NoSuchAlgorithmException,
+            NoSuchPaddingException, InvalidAlgorithmParameterException {
+        return decrypt(decryptType, secretKey, secretData, null);
+    }
+
+    public String decrypt(String decryptType, SecretKey secretKey,
+            byte[] secretData, String algorithmParam)
+            throws InvalidKeyException, IllegalBlockSizeException,
+            BadPaddingException, UnsupportedEncodingException,
+            NoSuchAlgorithmException, NoSuchPaddingException,
+            InvalidAlgorithmParameterException {
+        Cipher decrypt = Cipher.getInstance(decryptType);
+        if (null == algorithmParam) {
+            decrypt.init(Cipher.DECRYPT_MODE, secretKey);
+        } else {
+            IvParameterSpec iv = new IvParameterSpec(
+                    algorithmParam.getBytes(CHARSET));
+            decrypt.init(Cipher.DECRYPT_MODE, secretKey, iv);
+        }
+        byte[] srcData = decrypt.doFinal(secretData);
+        String srcStr = new String(srcData, CHARSET);
+
+        return srcStr;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/encrypt/HmacSha1.java b/Java基础教程/Java源代码/codedemo/encrypt/HmacSha1.java
new file mode 100644
index 00000000..4a6864e2
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/encrypt/HmacSha1.java
@@ -0,0 +1,53 @@
+package cn.aofeng.demo.encrypt;
+
+import static cn.aofeng.demo.util.LogUtil.log;
+
+import java.io.UnsupportedEncodingException;
+import java.security.InvalidAlgorithmParameterException;
+import java.security.InvalidKeyException;
+import java.security.NoSuchAlgorithmException;
+
+import javax.crypto.BadPaddingException;
+import javax.crypto.IllegalBlockSizeException;
+import javax.crypto.Mac;
+import javax.crypto.NoSuchPaddingException;
+import javax.crypto.SecretKey;
+
+import org.apache.commons.codec.binary.Base64;
+
+/**
+ * HMAC-SHA1签名算法。
+ * 
+ * @author 聂勇
+ */
+public class HmacSha1 {
+
+    public final String encryptType = "HmacSHA1";
+    public final String key = "abcdefgh_1234567";
+    
+    public void execute(String data) throws UnsupportedEncodingException, 
+            NoSuchAlgorithmException, InvalidKeyException {
+        EncryptAndDecrypt ead = new EncryptAndDecrypt();
+        
+        byte[] srcData = data.getBytes(EncryptAndDecrypt.CHARSET);
+        SecretKey secretKey = ead.createSecretKey(encryptType, key);   // 生成密钥对象
+        Mac mac = Mac.getInstance(encryptType);
+        mac.init(secretKey);
+        byte[] result = mac.doFinal(srcData);  
+        
+        log("使用%s签名后的数据：", encryptType);
+        log(Base64.encodeBase64String(result));
+    }
+    
+    public static void main(String[] args) throws InvalidKeyException, 
+            UnsupportedEncodingException, IllegalBlockSizeException, 
+            BadPaddingException, NoSuchAlgorithmException, 
+            NoSuchPaddingException, InvalidAlgorithmParameterException {
+        String data = "炎黄，汉字，english,do it,abcdefghijklmnopqrstuvwxyz,0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ, ~!@#$%^&*()_+=-";
+        log("待签名的数据：\n%s", data);
+
+        HmacSha1 hs = new HmacSha1();
+        hs.execute(data);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/encrypt/PerformanceCompare.java b/Java基础教程/Java源代码/codedemo/encrypt/PerformanceCompare.java
new file mode 100644
index 00000000..8bc697cb
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/encrypt/PerformanceCompare.java
@@ -0,0 +1,70 @@
+package cn.aofeng.demo.encrypt;
+
+import static cn.aofeng.demo.util.LogUtil.log;
+
+import java.io.UnsupportedEncodingException;
+import java.security.InvalidAlgorithmParameterException;
+import java.security.InvalidKeyException;
+import java.security.NoSuchAlgorithmException;
+
+import javax.crypto.BadPaddingException;
+import javax.crypto.IllegalBlockSizeException;
+import javax.crypto.NoSuchPaddingException;
+import javax.crypto.SecretKey;
+
+/**
+ * 加密解密性能比较。
+ * 
+ * @author 聂勇
+ */
+public class PerformanceCompare extends EncryptAndDecrypt {
+
+    public void blowfishPerformence(String data)
+            throws UnsupportedEncodingException, InvalidKeyException,
+            IllegalBlockSizeException, BadPaddingException,
+            NoSuchAlgorithmException, NoSuchPaddingException,
+            InvalidAlgorithmParameterException {
+        Blowfish bf = new Blowfish();
+        SecretKey secretKey = createSecretKey(bf.encryptType, bf.key);
+        long startTime = System.currentTimeMillis();
+        for (int j = 0; j < 100000; j++) {
+            bf.encrypt(bf.encryptType, secretKey, data+j);
+        }
+        long endTime = System.currentTimeMillis();
+        long usedTime = endTime - startTime;
+        log("使用%s进行%d次加密消耗时间%d毫秒", bf.encryptType, 100000, usedTime);
+    }
+
+    public void aesPerformence(String data)
+            throws UnsupportedEncodingException, InvalidKeyException,
+            IllegalBlockSizeException, BadPaddingException,
+            NoSuchAlgorithmException, NoSuchPaddingException,
+            InvalidAlgorithmParameterException {
+        AES aes = new AES();
+        SecretKey secretKey = createSecretKey("AES", aes.key);
+        long startTime = System.currentTimeMillis();
+        for (int j = 0; j < 100000; j++) {
+            aes.encrypt(aes.encryptType, secretKey, data+j,
+                    aes.algorithmParam);
+        }
+        long endTime = System.currentTimeMillis();
+        long usedTime = endTime - startTime;
+        log("使用%s进行%d次加密消耗时间%d毫秒", aes.encryptType, 100000, usedTime);
+    }
+
+    public static void main(String[] args) throws InvalidKeyException,
+            UnsupportedEncodingException, IllegalBlockSizeException,
+            BadPaddingException, NoSuchAlgorithmException,
+            NoSuchPaddingException, InvalidAlgorithmParameterException {
+        String data = "炎黄，汉字，english,do it,abcdefghijklmnopqrstuvwxyz,0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ, ~!@#$%^&*()_+=-";
+        log("待加密的数据：\n%s", data);
+
+        PerformanceCompare pc = new PerformanceCompare();
+        // AES
+        pc.aesPerformence(data);
+
+        // Blowfish
+        pc.blowfishPerformence(data);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/eventdriver_improve/ClientMain.java b/Java基础教程/Java源代码/codedemo/eventdriver_improve/ClientMain.java
new file mode 100644
index 00000000..a3341f2e
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/eventdriver_improve/ClientMain.java
@@ -0,0 +1,38 @@
+package cn.aofeng.demo.eventdriver_improve;
+/**
+ * 事件驱动调用示例
+ * @author 聂勇 aofengblog@163.com
+ */
+public class ClientMain {
+
+    public static void main(String[] args) {
+        EventManagement eventManagement = new EventManagement();
+        eventManagement.addListener("read", new HelloWorldListener());
+        eventManagement.addListener("write", new SimpleListener());
+        
+        EventSource eventSource = new EventSource(eventManagement);
+        eventSource.fire(new Event("read", "this is a read event"));
+        eventSource.fire(new Event("write", "this is a write event"));
+    }
+
+    public static class HelloWorldListener implements EventListener {
+
+        @Override
+        public void execute(Event event) {
+            System.out.println("监听器:"+this +  "接收到事件，事件类型是:" 
+                    + event.getEventType() + ", 事件附带的数据:" + event.getData());
+        }
+        
+    }
+    
+    public static class SimpleListener implements EventListener {
+
+        @Override
+        public void execute(Event event) {
+            System.out.println("监听器:"+this +  "接收到事件，事件类型是:" 
+                    + event.getEventType() + ", 事件附带的数据:" + event.getData());
+        }
+        
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/eventdriver_improve/Event.java b/Java基础教程/Java源代码/codedemo/eventdriver_improve/Event.java
new file mode 100755
index 00000000..09d15724
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/eventdriver_improve/Event.java
@@ -0,0 +1,28 @@
+package cn.aofeng.demo.eventdriver_improve;
+/**
+ * 事件
+ * 
+ * @author aofeng 
+ */
+public class Event {
+
+    // 事件附带的数据
+    private Object data;
+    
+    // 事件类型
+    private String eventType;
+    
+    public Event(String eventType, Object obj){
+        this.eventType = eventType;
+        this.data = obj;
+    }
+
+    public Object getData() {
+        return this.data;
+    }
+    
+    public String getEventType() {
+        return this.eventType;
+    }
+
+}
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/eventdriver_improve/EventListener.java b/Java基础教程/Java源代码/codedemo/eventdriver_improve/EventListener.java
new file mode 100755
index 00000000..7d6e82d1
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/eventdriver_improve/EventListener.java
@@ -0,0 +1,16 @@
+package cn.aofeng.demo.eventdriver_improve;
+/**
+ * 事件监听器(监听一个或多个事件并进行具体的处理)
+ * 
+ * @author aofeng 
+ */
+public interface EventListener {
+
+	/**
+	 * 处理事件
+	 * 
+	 * @param event    事件
+	 */
+	public void execute(Event event);
+
+}
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/eventdriver_improve/EventManagement.java b/Java基础教程/Java源代码/codedemo/eventdriver_improve/EventManagement.java
new file mode 100755
index 00000000..cde8fa35
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/eventdriver_improve/EventManagement.java
@@ -0,0 +1,64 @@
+package cn.aofeng.demo.eventdriver_improve;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 事件管理器。负责
+ * 
+ * @author aofeng 
+ */
+public class EventManagement {
+
+    private Map> map = new HashMap>();
+    
+	public EventManagement(){
+
+	}
+
+	/**
+	 * 向指定事件添加一个监听器
+	 * 
+	 * @param eventType 事件类型
+	 * @param listener 事件监听器
+	 * @return 添加成功返回true；添加失败返回false
+	 */
+	public boolean addListener(String eventType, EventListener listener){
+	    List listeners = map.get(eventType);
+	    if (null == listeners) {
+	        listeners = new ArrayList();
+        }
+	    boolean result = listeners.add(listener);
+	    map.put(eventType, listeners);
+	    
+		return result;
+	}
+
+	/**
+	 * 移除事件的某一个监听器
+	 * 
+	 * @param eventType 事件类型
+     * @param listener 事件监听器
+     * @return 移除成功返回true；移除失败返回false
+	 */
+	public boolean removeListener(String eventType, EventListener listener){
+	    List listeners = map.get(eventType);
+        if (null != listeners) {
+            return listeners.remove(listener);
+        }
+        
+		return false;
+	}
+
+	/**
+	 * 获取指定事件的监听器
+	 * 
+	 * @param eventType 事件类型
+	 * @return 如果指定的事件没有监听器返回null；否则返回监听器列表
+	 */
+	public List getEventListeners(String eventType) {
+	    return map.get(eventType);
+	}
+
+}
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/eventdriver_improve/EventSource.java b/Java基础教程/Java源代码/codedemo/eventdriver_improve/EventSource.java
new file mode 100755
index 00000000..ecd09ebf
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/eventdriver_improve/EventSource.java
@@ -0,0 +1,38 @@
+package cn.aofeng.demo.eventdriver_improve;
+import java.util.List;
+
+/**
+ * 事件源(事件发送者)
+ * 
+ * @author aofeng 
+ */
+public class EventSource {
+
+    // 事件管理器
+    private EventManagement eventManagement;;
+    
+	public EventSource(EventManagement eventManagement){
+	    this.eventManagement = eventManagement;
+	}
+
+	/**
+     * 派发事件
+     * 
+     * @param data 事件
+     */
+    public void fire(Event event) {
+        if (null == event) {
+            return;
+        }
+        
+        List listeners = eventManagement.getEventListeners(event.getEventType());
+        if (null == listeners) {
+            return;
+        }
+        
+        for (EventListener listener : listeners) {
+            listener.execute(event);
+        }
+    }
+
+}
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/eventdriver_normal/ClientMain.java b/Java基础教程/Java源代码/codedemo/eventdriver_normal/ClientMain.java
new file mode 100644
index 00000000..126ddfec
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/eventdriver_normal/ClientMain.java
@@ -0,0 +1,33 @@
+package cn.aofeng.demo.eventdriver_normal;
+/**
+ * 事件驱动调用示例
+ * @author aofeng 
+ */
+public class ClientMain {
+
+    public static void main(String[] args) {
+        EventSource eventSource = new EventSource();
+        eventSource.addListener(new HelloWorldListener());
+        eventSource.addListener(new SimpleListener());
+        eventSource.fire("hello, world!");
+    }
+
+    public static class HelloWorldListener implements EventListener {
+
+        @Override
+        public void execute(Event event) {
+            System.out.println("监听器:"+this +  "接收到事件，事件附带的数据:" + event.getData());
+        }
+        
+    }
+    
+    public static class SimpleListener implements EventListener {
+
+        @Override
+        public void execute(Event event) {
+            System.out.println("监听器:"+this +  "接收到事件，事件附带的数据:" + event.getData());
+        }
+        
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/eventdriver_normal/Event.java b/Java基础教程/Java源代码/codedemo/eventdriver_normal/Event.java
new file mode 100755
index 00000000..4a1f9fc6
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/eventdriver_normal/Event.java
@@ -0,0 +1,17 @@
+package cn.aofeng.demo.eventdriver_normal;
+/**
+ * 事件
+ * @author aofeng 
+ */
+public class Event {
+
+    private Object data;
+    
+	public Event(Object obj){
+	    this.data = obj;
+	}
+
+	public Object getData() {
+	    return data;
+	}
+}
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/eventdriver_normal/EventListener.java b/Java基础教程/Java源代码/codedemo/eventdriver_normal/EventListener.java
new file mode 100755
index 00000000..a1475a21
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/eventdriver_normal/EventListener.java
@@ -0,0 +1,16 @@
+package cn.aofeng.demo.eventdriver_normal;
+/**
+ * 事件监听器(监听一个或多个事件并进行具体的处理)
+ * 
+ * @author aofeng 
+ */
+public interface EventListener {
+
+    /**
+     * 处理事件
+     * 
+     * @param event 事件
+     */
+    public void execute(Event event);
+
+}
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/eventdriver_normal/EventSource.java b/Java基础教程/Java源代码/codedemo/eventdriver_normal/EventSource.java
new file mode 100755
index 00000000..ef87d222
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/eventdriver_normal/EventSource.java
@@ -0,0 +1,47 @@
+package cn.aofeng.demo.eventdriver_normal;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * 事件源(事件发送者)
+ * 
+ * @author aofeng 
+ */
+public class EventSource {
+
+    private List listeners = new ArrayList();
+    
+    public EventSource() {
+
+    }
+
+    /**
+     * 添加事件监听器
+     * 
+     * @param listener 事件监听器
+     */
+    public boolean addListener(EventListener listener) {
+        return listeners.add(listener);
+    }
+
+    /**
+     * 移除事件监听器
+     * 
+     * @param listener 移除事件监听器
+     */
+    public boolean removeListener(EventListener listener) {
+        return listeners.remove(listener);
+    }
+
+    /**
+     * 派发事件
+     * 
+     * @param data 事件
+     */
+    public void fire(Object data) {
+        for (EventListener listener : listeners) {
+            listener.execute(new Event(data));
+        }
+    }
+
+}
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/httpclient/FluentApi.java b/Java基础教程/Java源代码/codedemo/httpclient/FluentApi.java
new file mode 100644
index 00000000..89340d40
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/httpclient/FluentApi.java
@@ -0,0 +1,85 @@
+/**
+ * 创建时间：2016-8-5
+ */
+package cn.aofeng.demo.httpclient;
+
+import java.io.IOException;
+import java.nio.charset.Charset;
+import java.util.ArrayList;
+import java.util.List;
+
+import org.apache.http.NameValuePair;
+import org.apache.http.client.ClientProtocolException;
+import org.apache.http.client.fluent.Request;
+import org.apache.http.client.fluent.Response;
+import org.apache.http.message.BasicNameValuePair;
+import org.apache.log4j.Logger;
+
+import cn.aofeng.demo.httpclient.server.SimpleHttpServer;
+
+/**
+ * 使用Fluent API快速地进行简单的HTTP的请求和响应处理，启动{@link SimpleHttpServer}作为请求的服务端。
+ * 
+ * @author 聂勇
+ */
+public class FluentApi {
+
+    private static Logger _logger = Logger.getLogger(FluentApi.class);
+    
+    private static String _targetHost = "http://127.0.0.1:8888";
+    
+    private static String _charset = "utf-8";
+    
+    /**
+     * HTTP GET请求，关闭Keep-Alive。
+     * 
+     * @param targetUrl 请求的地址
+     * @param charset 将响应流转换成字符串时使用的编码
+     */
+    public static void get(String targetUrl, String charset) {
+        Response response = null;
+        try {
+            response =  Request.Get(targetUrl).setHeader("Connection", "close").execute();
+            String content = response.returnContent().asString(Charset.forName(charset));
+            _logger.info(content);
+        } catch (ClientProtocolException e) {
+            _logger.error("协议问题", e);
+        } catch (IOException e) {
+            _logger.error("连接服务器或读取响应出错", e);
+        }
+    }
+    
+    /**
+     * HTTP POST请求，默认开启Keep-Alive，表单数据使用utf-8编码。
+     * 
+     * @param targetUrl 请求的地址
+     * @param charset 请求表单内容处理和将响应流转换成字符串时使用的编码
+     */
+    public static void post(String targetUrl, String charset) {
+        List form = new ArrayList();
+        form.add(new BasicNameValuePair("hello", "喂"));
+        form.add(new BasicNameValuePair("gogogo", "走走走"));
+        
+        Response response = null;
+        try {
+            response = Request.Post(targetUrl)
+                    .bodyForm(form, Charset.forName(charset))
+                    .execute();
+            String content = response.returnContent().asString(Charset.forName(charset));
+            _logger.info(content);
+        } catch (ClientProtocolException e) {
+            _logger.error("协议问题", e);
+        } catch (IOException e) {
+            _logger.error("连接服务器或读取响应出错", e);
+        }
+    }
+    
+    /**
+     * @param args
+     */
+    public static void main(String[] args) {
+        get(_targetHost+"/get", _charset);
+        post(_targetHost+"/post", _charset);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/httpclient/HttpClientBasic.java b/Java基础教程/Java源代码/codedemo/httpclient/HttpClientBasic.java
new file mode 100644
index 00000000..3be72816
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/httpclient/HttpClientBasic.java
@@ -0,0 +1,110 @@
+/**
+ * 创建时间：2016-2-23
+ */
+package cn.aofeng.demo.httpclient;
+
+import java.io.File;
+import java.io.IOException;
+import java.net.URISyntaxException;
+import java.util.ArrayList;
+import java.util.List;
+
+import org.apache.http.Header;
+import org.apache.http.HttpEntity;
+import org.apache.http.NameValuePair;
+import org.apache.http.StatusLine;
+import org.apache.http.client.ClientProtocolException;
+import org.apache.http.client.entity.UrlEncodedFormEntity;
+import org.apache.http.client.methods.CloseableHttpResponse;
+import org.apache.http.client.methods.HttpGet;
+import org.apache.http.client.methods.HttpPost;
+import org.apache.http.entity.ContentType;
+import org.apache.http.entity.FileEntity;
+import org.apache.http.impl.client.CloseableHttpClient;
+import org.apache.http.impl.client.HttpClients;
+import org.apache.http.message.BasicNameValuePair;
+import org.apache.http.util.EntityUtils;
+import org.apache.log4j.Logger;
+
+/**
+ * HttpClient的基本操作。
+ * 
+ * @author 聂勇
+ */
+public class HttpClientBasic {
+
+    private static Logger _logger = Logger.getLogger(HttpClientBasic.class);
+    
+    private static String _targetHost = "http://127.0.0.1:8888";
+    
+    private static String _charset = "utf-8";
+    
+    public void get() throws URISyntaxException, ClientProtocolException, IOException {
+        CloseableHttpClient client = HttpClients.createDefault();
+        HttpGet get = new HttpGet(_targetHost+"/get");
+        CloseableHttpResponse response = client.execute(get);
+        processResponse(response);
+    }
+    
+    public void post() throws ClientProtocolException, IOException {
+        List params = new ArrayList();
+        params.add(new BasicNameValuePair("chinese", "中文"));
+        params.add(new BasicNameValuePair("english", "英文"));
+        UrlEncodedFormEntity entity = new UrlEncodedFormEntity(params, _charset);
+        
+        CloseableHttpClient client = HttpClients.createDefault();
+        HttpPost post = new HttpPost(_targetHost+"/post");
+        post.addHeader("Cookie", "character=abcdefghijklmnopqrstuvwxyz; sign=abc-123-jkl-098");
+        post.setEntity(entity);
+        CloseableHttpResponse response = client.execute(post);
+        processResponse(response);
+    }
+    
+    public void sendFile(String filePath) throws UnsupportedOperationException, IOException {
+        CloseableHttpClient client = HttpClients.createDefault();
+        HttpPost post = new HttpPost(_targetHost+"/file");
+        File file = new File(filePath);
+        FileEntity entity = new FileEntity(file, ContentType.create(ContentType.TEXT_PLAIN.getMimeType(), _charset));
+        post.setEntity(entity);
+        CloseableHttpResponse response = client.execute(post);
+        processResponse(response);
+    }
+    
+    private void processResponse(CloseableHttpResponse response) 
+            throws UnsupportedOperationException, IOException {
+        try {
+            // 获取响应头
+            Header[] headers = response.getAllHeaders();
+            for (Header header : headers) {
+                _logger.info(header.getName() + ":" + header.getValue());
+            }
+            
+            // 获取状态信息
+            StatusLine sl =response.getStatusLine();
+            _logger.info( String.format("ProtocolVersion:%s, StatusCode:%d, Desc:%s", 
+                    sl.getProtocolVersion().toString(), sl.getStatusCode(), sl.getReasonPhrase()) );
+            
+            // 获取响应内容
+            HttpEntity entity = response.getEntity();
+            _logger.info( String.format("ContentType:%s, Length:%d, Encoding:%s", 
+                    null == entity.getContentType() ? "" : entity.getContentType().getValue(), 
+                    entity.getContentLength(),
+                    null == entity.getContentEncoding() ? "" : entity.getContentEncoding().getValue()) );
+            _logger.info(EntityUtils.toString(entity, _charset));
+//            _logger.info( IOUtils.toString(entity.getContent(), _charset) ); // 大部分情况下效果与上行语句等同，但实现上的编码处理不同
+        } finally {
+            response.close();
+        }
+    }
+    
+    /**
+     * @param args
+     */
+    public static void main(String[] args) throws Exception {
+        HttpClientBasic basic = new HttpClientBasic();
+//        basic.get();
+//        basic.post();
+        basic.sendFile("/devdata/projects/open_source/mine/JavaTutorial/LICENSE");
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/httpclient/README.md b/Java基础教程/Java源代码/codedemo/httpclient/README.md
new file mode 100644
index 00000000..33c669b9
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/httpclient/README.md
@@ -0,0 +1,9 @@
+#HTTP
+##HTTP客户端
+###代码
+* [使用Fluent API发起HTTP请求（Get和Post）](cn/aofeng/demo/httpclient/FluentApi.java)
+* [使用HttpClient发起HTTP请求（Get, Post和上传文件）](cn/aofeng/demo/httpclient/FluentApi.java)
+
+##HTTP服务端
+###代码
+* [使用JDK中的API建立简单的HTTP Server](src/cn/aofeng/demo/httpclient/SimpleHttpServer.java)
diff --git a/Java基础教程/Java源代码/codedemo/httpclient/server/AbstractHandler.java b/Java基础教程/Java源代码/codedemo/httpclient/server/AbstractHandler.java
new file mode 100644
index 00000000..ce439a4c
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/httpclient/server/AbstractHandler.java
@@ -0,0 +1,71 @@
+/**
+ * 创建时间：2016-8-18
+ */
+package cn.aofeng.demo.httpclient.server;
+
+import java.io.IOException;
+import java.io.OutputStream;
+import java.io.UnsupportedEncodingException;
+import java.net.InetSocketAddress;
+import java.net.URI;
+import java.util.List;
+import java.util.Map.Entry;
+import java.util.Set;
+
+import org.apache.commons.io.IOUtils;
+import org.apache.log4j.Logger;
+
+import com.sun.net.httpserver.Headers;
+import com.sun.net.httpserver.HttpExchange;
+import com.sun.net.httpserver.HttpHandler;
+
+/**
+ * @author 聂勇
+ */
+public abstract class AbstractHandler implements HttpHandler {
+
+    private static Logger _logger = Logger.getLogger(AbstractHandler.class);
+    
+    protected String _charset = "utf-8";
+    
+    public AbstractHandler(String charset) {
+        this._charset = charset;
+    }
+    
+    /**
+     * 处理请求头。
+     */
+    public void handleHeader(HttpExchange httpEx) {
+        InetSocketAddress remoteAddress = httpEx.getRemoteAddress();
+        _logger.info("收到来自"+remoteAddress.getAddress().getHostAddress()+":"+remoteAddress.getPort()+"的请求");
+        
+        URI rUri = httpEx.getRequestURI();
+        _logger.info("请求地址:"+rUri.toString());
+        
+        String method = httpEx.getRequestMethod();
+        _logger.info("请求方法:"+method);
+        
+        Headers headers = httpEx.getRequestHeaders();
+        Set>> headerSet = headers.entrySet();
+        _logger.info("请求头:");
+        for (Entry> header : headerSet) {
+            _logger.info(header.getKey()+":"+header.getValue());
+        }
+    }
+    
+    /**
+     * 处理响应。
+     */
+    public void handleResponse(HttpExchange httpEx, String content)
+            throws UnsupportedEncodingException, IOException {
+        String rc = "冒号后面是收到的请求，原样返回:"+content;
+        byte[] temp = rc.getBytes(_charset);
+        Headers outHeaders = httpEx.getResponseHeaders();
+        outHeaders.set("ABC", "123");
+        httpEx.sendResponseHeaders(200, temp.length);
+        OutputStream outs = httpEx.getResponseBody();
+        outs.write(temp);
+        IOUtils.closeQuietly(outs);
+    }
+
+}
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/httpclient/server/BinaryHandler.java b/Java基础教程/Java源代码/codedemo/httpclient/server/BinaryHandler.java
new file mode 100644
index 00000000..d9336ed2
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/httpclient/server/BinaryHandler.java
@@ -0,0 +1,66 @@
+/**
+ * 创建时间：2016-8-18
+ */
+package cn.aofeng.demo.httpclient.server;
+
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+
+import org.apache.commons.io.IOUtils;
+import org.apache.log4j.Logger;
+
+import com.sun.net.httpserver.HttpExchange;
+import com.sun.net.httpserver.HttpHandler;
+
+/**
+ * 二进制处理器。
+ * 
+ * @author 聂勇
+ */
+public class BinaryHandler extends AbstractHandler implements HttpHandler {
+
+    private static Logger _logger = Logger.getLogger(BinaryHandler.class);
+    
+    private String _dir = "/home/nieyong/temp/JavaTutorial";
+    
+    public BinaryHandler(String charset) {
+        super(charset);
+    }
+    
+    @Override
+    public void handle(HttpExchange httpEx) throws IOException {
+        super.handleHeader(httpEx);
+        handleRequest(httpEx);
+        String content = "收到一个二进制的请求";
+        super.handleResponse(httpEx, content);
+    }
+    
+    /**
+     * 处理请求。
+     * @throws IOException 
+     */
+    public String handleRequest(HttpExchange httpEx) throws IOException {
+        OutputStream outs = null;
+        InputStream ins = null;
+        try {
+            File file = new File(_dir, ""+System.currentTimeMillis());
+            if (!file.exists()) {
+                file.createNewFile();
+            }
+            outs = new FileOutputStream(file);
+            ins = httpEx.getRequestBody();
+            IOUtils.copyLarge(ins, outs);
+        } catch (Exception e) {
+            _logger.error("read request or write file occurs error", e);
+        } finally {
+            IOUtils.closeQuietly(ins);
+            IOUtils.closeQuietly(outs);
+        }
+        
+        return null;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/httpclient/server/CharacterHandler.java b/Java基础教程/Java源代码/codedemo/httpclient/server/CharacterHandler.java
new file mode 100644
index 00000000..ac5e444b
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/httpclient/server/CharacterHandler.java
@@ -0,0 +1,50 @@
+/**
+ * 创建时间：2016-8-18
+ */
+package cn.aofeng.demo.httpclient.server;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.UnsupportedEncodingException;
+import java.net.URLDecoder;
+
+import org.apache.commons.io.IOUtils;
+import org.apache.log4j.Logger;
+
+import com.sun.net.httpserver.HttpExchange;
+import com.sun.net.httpserver.HttpHandler;
+
+/**
+ * 字符串处理器。
+ * 
+ * @author 聂勇
+ */
+public class CharacterHandler extends AbstractHandler implements HttpHandler {
+
+    static Logger _logger = Logger .getLogger(CharacterHandler.class);
+
+    public CharacterHandler(String charset) {
+        super(charset);
+    }
+    
+    @Override
+    public void handle(HttpExchange httpEx) throws IOException {
+        super.handleHeader(httpEx);
+        String content = handleRequest(httpEx);
+        super.handleResponse(httpEx, content);
+    }
+    
+    /**
+     * 处理请求。
+     */
+    public String handleRequest(HttpExchange httpEx)
+            throws UnsupportedEncodingException, IOException {
+        InputStream ins = httpEx.getRequestBody();
+        String content = URLDecoder.decode(
+                IOUtils.toString(ins, _charset), _charset);
+        _logger.info("请求内容:"+content);
+        IOUtils.closeQuietly(ins);
+        return content;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/httpclient/server/SimpleHttpServer.java b/Java基础教程/Java源代码/codedemo/httpclient/server/SimpleHttpServer.java
new file mode 100644
index 00000000..d82088e7
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/httpclient/server/SimpleHttpServer.java
@@ -0,0 +1,41 @@
+/**
+ * 创建时间：2016-8-5
+ */
+package cn.aofeng.demo.httpclient.server;
+
+import java.io.IOException;
+import java.net.InetSocketAddress;
+
+import org.apache.log4j.Logger;
+
+import com.sun.net.httpserver.HttpServer;
+
+/**
+ * 简单的HTTP Server。
+ * 
+ * @author 聂勇
+ */
+public class SimpleHttpServer {
+
+    private static Logger _logger = Logger.getLogger(SimpleHttpServer.class);
+    
+    private static String _charset = "utf-8";
+    
+    /**
+     * @param args
+     */
+    public static void main(String[] args) {
+        int port = 8888;
+        try {
+            HttpServer server = HttpServer.create(new InetSocketAddress(port), 128);
+            server.createContext("/get", new CharacterHandler(_charset));
+            server.createContext("/post", new CharacterHandler(_charset));
+            server.createContext("/file", new BinaryHandler(_charset));
+            server.start();
+            _logger.info("http server already started, listen port:"+port);
+        } catch (IOException e) {
+            _logger.error("", e);
+        }
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/io/MultiThreadEchoServer.java b/Java基础教程/Java源代码/codedemo/io/MultiThreadEchoServer.java
new file mode 100644
index 00000000..4bb2ef9d
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/io/MultiThreadEchoServer.java
@@ -0,0 +1,53 @@
+package cn.aofeng.demo.io;
+
+import java.io.IOException;
+import java.net.InetSocketAddress;
+import java.net.ServerSocket;
+import java.net.Socket;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ * 多线程网络echo服务。每接收到一个新连接都新建一个线程处理，连接关闭后线程随之销毁。
+ * 
+ * @author NieYong
+ */
+public class MultiThreadEchoServer {
+
+    private final static Logger logger = Logger.getLogger(MultiThreadEchoServer.class.getName());
+    
+    /**
+     * @param args [0]-监听端口
+     */
+    public static void main(String[] args) {
+        if (args.length != 1) {
+            System.err.println("无效的参数。使用示例：");
+            System.err.println("    java cn.aofeng.demo.io.MultiThreadEchoServer 9090");
+            System.exit(-1);
+        }
+        
+        int port = Integer.parseInt(args[0]);
+        ServerSocket serverSocket = null;
+        try {
+            serverSocket = new ServerSocket();
+            serverSocket.bind(new InetSocketAddress(port));
+            if (logger.isLoggable(Level.INFO)) {
+                logger.info("多线程网络echo服务启动完毕，监听端口：" +port);
+            }
+            while (true) {
+                // 接收新的客户端连接
+                Socket socket = serverSocket.accept();
+                if (logger.isLoggable(Level.INFO)) {
+                    logger.info("收到一个新的连接，客户端IP："+socket.getInetAddress().getHostAddress()+"，客户端Port："+socket.getPort());
+                }
+                
+                // 新建一个线程处理Socket连接
+                Thread thread = new Thread(new Worker(socket));
+                thread.start();
+            }
+        } catch (IOException e) {
+            logger.log(Level.SEVERE, "处理网络连接出错", e);
+        }
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/io/ThreadPoolEchoServer.java b/Java基础教程/Java源代码/codedemo/io/ThreadPoolEchoServer.java
new file mode 100644
index 00000000..e53de75d
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/io/ThreadPoolEchoServer.java
@@ -0,0 +1,55 @@
+package cn.aofeng.demo.io;
+
+import java.io.IOException;
+import java.net.InetSocketAddress;
+import java.net.ServerSocket;
+import java.net.Socket;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ * 线程池网络echo服务。每接收到一个新连接都由线程池中的空闲线程处理，连接关闭后释放线程（不会销毁线程，仍在线程池中）。
+ * 
+ * @author NieYong
+ */
+public class ThreadPoolEchoServer {
+
+    private final static Logger logger = Logger.getLogger(MultiThreadEchoServer.class.getName());
+    
+    /**
+     * @param args [0]-监听端口
+     */
+    public static void main(String[] args) {
+        if (args.length != 1) {
+            System.err.println("无效的参数。使用示例：");
+            System.err.println("    java cn.aofeng.demo.io.ThreadPoolEchoServer 9090");
+            System.exit(-1);
+        }
+        
+        int port = Integer.parseInt(args[0]);
+        ExecutorService threadpool = Executors.newFixedThreadPool(5);
+        ServerSocket serverSocket = null;
+        try {
+            serverSocket = new ServerSocket();
+            serverSocket.bind(new InetSocketAddress(port));
+            if (logger.isLoggable(Level.INFO)) {
+                logger.info("线程池网络echo服务启动完毕，监听端口：" +port);
+            }
+            while (true) {
+                // 接收新的客户端连接
+                Socket socket = serverSocket.accept();
+                if (logger.isLoggable(Level.INFO)) {
+                    logger.info("收到一个新的连接，客户端IP："+socket.getInetAddress().getHostAddress()+"，客户端Port："+socket.getPort());
+                }
+                
+                // 将Socket连接交给线程池处理
+                threadpool.submit(new Worker(socket));
+            }
+        } catch (IOException e) {
+            logger.log(Level.SEVERE, "处理网络连接出错", e);
+        }
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/io/Worker.java b/Java基础教程/Java源代码/codedemo/io/Worker.java
new file mode 100644
index 00000000..45b68dd0
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/io/Worker.java
@@ -0,0 +1,77 @@
+package cn.aofeng.demo.io;
+
+import java.io.BufferedReader;
+import java.io.Closeable;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.io.OutputStream;
+import java.net.Socket;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ * 处理客户端Socket连接的工作线程。
+ * 
+ * @author 聂勇 aofengblog@163.com
+ */
+public class Worker implements Runnable {
+
+    private final static Logger logger = Logger.getLogger(MultiThreadEchoServer.class.getName());
+    
+    // 字符集编码
+    private final static String CHAR_SET = "utf8"; 
+    
+    // 行结束符
+    private final static String CRLF = "\r\n";
+    
+    private Socket socket = null;
+    
+    public Worker(Socket socket) {
+        this.socket = socket;
+    }
+    
+    public void setSocket(Socket socket) {
+        this.socket = socket;
+    }
+    
+    public void close(Closeable c) {
+        if (null != c) {
+            try {
+                c.close();
+            } catch (IOException e) {
+                // ingore
+            }
+        }
+    }
+    
+    @Override
+    public void run() {
+        if (null == socket || socket.isClosed()) {
+            logger.warning("无效的Socket连接：" + socket);
+            return;
+        }
+        
+        String lineEnd = CRLF;
+        try {
+            BufferedReader reader = new BufferedReader(
+                    new InputStreamReader(
+                            socket.getInputStream()));
+            OutputStream outs = socket.getOutputStream(); 
+            String line = null;
+            while ( null != (line = reader.readLine()) ) {
+                // 客户端退出
+                if ("quit".equalsIgnoreCase(line) || "exit".equalsIgnoreCase(line)) {
+                    break;
+                }
+                
+                outs.write(line.getBytes(CHAR_SET));
+                outs.write(lineEnd.getBytes(CHAR_SET));
+            }
+            close(reader);
+            close(outs);
+        } catch (IOException e) {
+            logger.log(Level.SEVERE, "读取网络连接数据出错", e);
+        }
+    }
+    
+}
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/java/lang/instrument/FirstInstrumentation.java b/Java基础教程/Java源代码/codedemo/java/lang/instrument/FirstInstrumentation.java
new file mode 100644
index 00000000..d4319caf
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/lang/instrument/FirstInstrumentation.java
@@ -0,0 +1,25 @@
+package cn.aofeng.demo.java.lang.instrument;
+
+import java.lang.instrument.Instrumentation;
+
+import org.apache.commons.lang.StringUtils;
+
+import cn.aofeng.demo.util.LogUtil;
+
+/**
+ * Instrument入口类。
+ * 
+ * @author 聂勇
+ */
+public class FirstInstrumentation {
+
+    public static void premain(String options, Instrumentation ins) {
+        if (StringUtils.isBlank(options)) {
+            LogUtil.log("instrument without options");
+        } else {
+            LogUtil.log("instrument with options:%s", options);
+        }
+        
+        ins.addTransformer(new FirstTransformer());
+    }
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/lang/instrument/FirstTransformer.java b/Java基础教程/Java源代码/codedemo/java/lang/instrument/FirstTransformer.java
new file mode 100644
index 00000000..48ce6912
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/lang/instrument/FirstTransformer.java
@@ -0,0 +1,26 @@
+/**
+ * 
+ */
+package cn.aofeng.demo.java.lang.instrument;
+
+import java.lang.instrument.ClassFileTransformer;
+import java.lang.instrument.IllegalClassFormatException;
+import java.security.ProtectionDomain;
+
+import cn.aofeng.demo.util.LogUtil;
+
+/**
+ * 只输出问候语，不进行字节码修改的Class转换器。
+ * 
+ * @author 聂勇
+ */
+public class FirstTransformer implements ClassFileTransformer {
+
+    @Override
+    public byte[] transform(ClassLoader loader, String className, Class classBeingRedefined, 
+            ProtectionDomain protectionDomain, byte[] classfileBuffer) throws IllegalClassFormatException {
+        LogUtil.log(">>> %s", className);
+        return null;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/lang/instrument/Hello.java b/Java基础教程/Java源代码/codedemo/java/lang/instrument/Hello.java
new file mode 100644
index 00000000..01fd76f5
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/lang/instrument/Hello.java
@@ -0,0 +1,14 @@
+package cn.aofeng.demo.java.lang.instrument;
+
+/**
+ * Instrumentation启动类。 * 
+ * 
+ * @author 聂勇
+ */
+public class Hello {
+
+    public static void main(String[] args) {
+        // nothing
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/lang/instrument/README.md b/Java基础教程/Java源代码/codedemo/java/lang/instrument/README.md
new file mode 100644
index 00000000..53fe4e51
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/lang/instrument/README.md
@@ -0,0 +1,40 @@
+# 一、Instrumentation入门
+
+* [FirstTransformer.java](FirstTransformer.java) 处理字节码，由类FirstInstrumentation执行
+* [FirstInstrumentation.java](FirstInstrumentation.java) instrumentation入口类，由javaagent载入执行
+* [build.xml](build.xml) Ant脚本，负责编译、打包和运行
+
+在当前目录下执行命令：
+```bash
+ant
+```
+
+输出信息如下：
+>     [java] instrument with options:"Hello, Instrumentation"
+>     [java] >>> java/lang/invoke/MethodHandleImpl
+>     [java] >>> java/lang/invoke/MethodHandleImpl$1
+>     [java] >>> java/lang/invoke/MethodHandleImpl$2
+>     [java] >>> java/util/function/Function
+>     [java] >>> java/lang/invoke/MethodHandleImpl$3
+>     [java] >>> java/lang/invoke/MethodHandleImpl$4
+>     [java] >>> java/lang/ClassValue
+>     [java] >>> java/lang/ClassValue$Entry
+>     [java] >>> java/lang/ClassValue$Identity
+>     [java] >>> java/lang/ClassValue$Version
+>     [java] >>> java/lang/invoke/MemberName$Factory
+>     [java] >>> java/lang/invoke/MethodHandleStatics
+>     [java] >>> java/lang/invoke/MethodHandleStatics$1
+>     [java] >>> sun/misc/PostVMInitHook
+>     [java] >>> sun/usagetracker/UsageTrackerClient
+>     [java] >>> java/util/concurrent/atomic/AtomicBoolean
+>     [java] >>> sun/usagetracker/UsageTrackerClient$1
+>     [java] >>> sun/usagetracker/UsageTrackerClient$4
+>     [java] >>> sun/usagetracker/UsageTrackerClient$3
+>     [java] >>> java/io/FileOutputStream$1
+>     [java] >>> sun/launcher/LauncherHelper
+>     [java] >>> cn/aofeng/demo/java/lang/instrument/Hello
+>     [java] >>> sun/launcher/LauncherHelper$FXHelper
+>     [java] >>> java/lang/Class$MethodArray
+>     [java] >>> java/lang/Void
+>     [java] >>> java/lang/Shutdown
+>     [java] >>> java/lang/Shutdown$Lock
diff --git a/Java基础教程/Java源代码/codedemo/java/lang/instrument/build.xml b/Java基础教程/Java源代码/codedemo/java/lang/instrument/build.xml
new file mode 100644
index 00000000..2abfbb1c
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/lang/instrument/build.xml
@@ -0,0 +1,57 @@
+
+
+
+	
+	
+	
+	
+	
+
+	
+		
+			
+		
+	
+
+	
+		
+		
+		
+			
+				
+				
+			
+		
+		
+		
+		
+	
+
+	
+		
+		
+			
+		
+	
+
+	
+	    
+	        
+	            
+	        
+	    	
+	    	    
+	    	
+	    
+	
+
+	
+	    
+	        
+	        
+	    	
+	    
+	
+
+
diff --git a/Java基础教程/Java源代码/codedemo/java/lang/reflect/ClassAnalyze.java b/Java基础教程/Java源代码/codedemo/java/lang/reflect/ClassAnalyze.java
new file mode 100644
index 00000000..931b7c39
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/lang/reflect/ClassAnalyze.java
@@ -0,0 +1,143 @@
+package cn.aofeng.demo.java.lang.reflect;
+
+import java.lang.annotation.Annotation;
+import java.lang.reflect.AnnotatedElement;
+import java.lang.reflect.Constructor;
+import java.lang.reflect.Field;
+import java.lang.reflect.Member;
+import java.lang.reflect.Method;
+import java.lang.reflect.Modifier;
+
+/**
+ * 通过反射获取类的构造方法、字段、方法和注解等信息。
+ * 
+ * @author 聂勇
+ */
+public class ClassAnalyze {
+
+    final static String PREFIX = "==========";
+    final static String SUFFIX = PREFIX;
+    
+    private static void parseClass(Class claz) {
+        // 注解
+        parseAnnotation(claz);
+        
+        // 类
+        StringBuilder buffer = new StringBuilder(32)
+            .append( Modifier.toString(claz.getModifiers()) )
+            .append(' ')
+            .append(claz.getName());
+        log(buffer.toString());
+    }
+    
+    private static void parseConstructor(Constructor c) {
+        // 注解
+        parseAnnotation(c);
+        
+        // 构造方法
+        StringBuilder buffer = new StringBuilder(32)
+            .append( parseMember(c) )
+            .append('(');
+        
+        // 参数
+        Class[] params = c.getParameterTypes();
+        for (int index = 0; index < params.length; index++) {
+            buffer.append(params[index].getName());
+            if (index!=params.length-1) {
+                buffer.append(", ");
+            }
+        }
+        buffer.append(')');
+        
+        log(buffer.toString());
+    }
+    
+    private static void parseMethod(Method method) {
+        // 注解
+        parseAnnotation(method);
+        
+        // 方法
+        StringBuilder buffer = new StringBuilder(32)
+            .append( parseMember(method) )
+            .append('(');
+        
+        // 参数
+        Class[] params = method.getParameterTypes();
+        for (int index = 0; index < params.length; index++) {
+            buffer.append(params[index].getName());
+            if (index!=params.length-1) {
+                buffer.append(", ");
+            }
+        }
+        buffer.append(')');
+        
+        log(buffer.toString());
+    }
+    
+    private static void parseField(Field field) {
+        // 注解
+        parseAnnotation(field);
+        
+        // 字段
+        StringBuilder buffer = parseMember(field);
+        log(buffer.toString());
+    }
+    
+    /**
+     * 解析方法、字段或构造方法的信息。
+     * @param member 方法、字段或构造方法
+     * @return 修饰符和名称组成的字符串。
+     */
+    private static StringBuilder parseMember(Member member) {
+        StringBuilder buffer = new StringBuilder()
+            .append(Modifier.toString(member.getModifiers()))
+            .append(' ')
+            .append(member.getName());
+        return buffer;
+    }
+    
+    /**
+     * 解析注解信息。
+     */
+    private static void parseAnnotation(AnnotatedElement ae) {
+        Annotation[] ans = ae.getDeclaredAnnotations();
+        for (Annotation annotation : ans) {
+            log(annotation.toString());
+        }
+    }
+    
+    public static void log(String msg, Object... param) {
+        System.out.println( String.format(msg, param) );
+    }
+    
+    public static void main(String[] args) throws ClassNotFoundException {
+        if (args.length != 1) {
+            log("无效的输入参数！");
+            log("示例：");
+            log("java cn.aofeng.demo.java.lang.reflect.ClassAnalyze java.util.HashMap");
+        }
+        Class claz = Class.forName(args[0]);
+        
+        log("%s类%s", PREFIX, SUFFIX);
+        parseClass(claz);
+        
+        log("%s构造方法%s", PREFIX, SUFFIX);
+        Constructor[] cs = claz.getDeclaredConstructors();
+        for (Constructor constructor : cs) {
+            parseConstructor(constructor);
+        }
+        
+        log("%s字段%s", PREFIX, SUFFIX);
+        Field[] fields = claz.getDeclaredFields();
+        for (Field field : fields) {
+            parseField(field);
+        }
+        
+        log("%s方法%s", PREFIX, SUFFIX);
+        Method[] methods = claz.getDeclaredMethods();
+        for (Method method : methods) {
+            parseMethod(method);
+        }
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/lang/reflect/CreateInstance.java b/Java基础教程/Java源代码/codedemo/java/lang/reflect/CreateInstance.java
new file mode 100644
index 00000000..2bf47632
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/lang/reflect/CreateInstance.java
@@ -0,0 +1,36 @@
+package cn.aofeng.demo.java.lang.reflect;
+
+import java.lang.reflect.Constructor;
+import java.lang.reflect.InvocationTargetException;
+
+import cn.aofeng.demo.util.LogUtil;
+
+/**
+ * 通过反射使用构造方法创建对象实例。
+ * 
+ * @author 聂勇
+ */
+public class CreateInstance {
+
+    public static void main(String[] args) throws InstantiationException, IllegalAccessException, 
+            NoSuchMethodException, SecurityException,
+            IllegalArgumentException, InvocationTargetException {
+        Class claz = Man.class;
+        
+        // 调用默认的public构造方法
+        Man man = claz.newInstance();
+        LogUtil.log(man.toString());
+        
+        // 调用带参数的protected构造方法
+        Constructor manC = claz.getDeclaredConstructor(String.class);
+        man = manC.newInstance("aofeng");
+        LogUtil.log(man.toString());
+        
+        // 调用带参数的private构造方法
+        manC = claz.getDeclaredConstructor(String.class, int.class);
+        manC.setAccessible(true);
+        man = manC.newInstance("NieYong", 32);
+        LogUtil.log(man.toString());
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/lang/reflect/InvokeField.java b/Java基础教程/Java源代码/codedemo/java/lang/reflect/InvokeField.java
new file mode 100644
index 00000000..4ec267b3
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/lang/reflect/InvokeField.java
@@ -0,0 +1,37 @@
+package cn.aofeng.demo.java.lang.reflect;
+
+import java.lang.reflect.Field;
+
+import static cn.aofeng.demo.util.LogUtil.log;
+
+/**
+ * 通过反射设置字段。
+ * 
+ * @author 聂勇
+ */
+public class InvokeField {
+
+    public static void main(String[] args) throws NoSuchFieldException,
+            SecurityException, IllegalArgumentException, IllegalAccessException {
+        Man man = new Man();
+        Class claz = man.getClass();
+        
+        log("==========设置public字段的值==========");
+        log("height的值:%d", man.height);
+        Field field = claz.getField("height");
+        field.setInt(man, 175);
+        log("height的值:%d", man.height);
+        
+        log("==========设置private字段的值==========");
+        log("power的值:%d", man.getPower());
+        field = claz.getDeclaredField("power");
+        field.setAccessible(true);
+        field.setInt(man, 100);
+        log("power的值:%d", man.getPower());
+        
+        log("==========获取private字段的值==========");
+        int power = field.getInt(man);
+        log("power的值:%d", power);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/lang/reflect/InvokeMethod.java b/Java基础教程/Java源代码/codedemo/java/lang/reflect/InvokeMethod.java
new file mode 100644
index 00000000..d11d7a9a
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/lang/reflect/InvokeMethod.java
@@ -0,0 +1,84 @@
+package cn.aofeng.demo.java.lang.reflect;
+
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+
+import static cn.aofeng.demo.util.LogUtil.log;
+
+/**
+ * 通过反射调用方法。
+ * 
+ * @author 聂勇
+ */
+public class InvokeMethod {
+
+    /**
+     * 调用父类的方法。
+     * 
+     * @param claz
+     *            类
+     * @param man
+     *            类对应的实例
+     */
+    private static void invokeParentMethod(Class claz, Man man)
+            throws NoSuchMethodException, IllegalAccessException,
+            InvocationTargetException {
+        // 调用父类的public方法
+        Method method = claz.getMethod("setName", String.class);
+        method.invoke(man, "NieYong");
+        log(man.toString());
+
+        method = claz.getMethod("getName");
+        Object result = method.invoke(man);
+        log("name:%s", result);
+
+        // 调用父类的private方法
+        method = claz.getSuperclass().getDeclaredMethod("reset");
+        method.setAccessible(true);
+        result = method.invoke(man);
+        log(man.toString());
+    }
+
+    /**
+     * 调用自身的方法。
+     * 
+     * @param claz
+     *            类
+     * @param man
+     *            类对应的实例
+     */
+    private static void invokeSelfMethod(Class claz, Man man)
+            throws NoSuchMethodException, IllegalAccessException,
+            InvocationTargetException {
+        man.setName("XiaoMing");
+        // 调用自身的private方法
+        Method method = claz.getDeclaredMethod("setPower", int.class);
+        method.setAccessible(true);
+        method.invoke(man, 99);
+        log("power:%d", man.getPower());
+
+        // 调用自身的public方法
+        log("%s is marry:%s", man.getName(), (man.isMarry() ? "Yes" : "No"));
+        method = claz.getDeclaredMethod("setMarry", boolean.class);
+        method.invoke(man, true);
+        log("%s is marry:%s", man.getName(), (man.isMarry() ? "Yes" : "No"));
+
+        // 调用静态方法，可将实例设置为null，因为静态方法属于类
+        Man a = new Man("张三");
+        Man b = new Man("李四");
+        method = claz.getMethod("fight", Man.class, Man.class);
+        method.invoke(null, a, b); //
+    }
+
+    public static void main(String[] args) throws NoSuchMethodException,
+            SecurityException, IllegalAccessException,
+            IllegalArgumentException, InvocationTargetException,
+            InstantiationException {
+        Class claz = Man.class;
+        Man man = claz.newInstance();
+
+        invokeParentMethod(claz, man);
+        invokeSelfMethod(claz, man);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/lang/reflect/Man.java b/Java基础教程/Java源代码/codedemo/java/lang/reflect/Man.java
new file mode 100644
index 00000000..41b4b75b
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/lang/reflect/Man.java
@@ -0,0 +1,63 @@
+package cn.aofeng.demo.java.lang.reflect;
+
+import cn.aofeng.demo.json.gson.Person;
+import cn.aofeng.demo.util.LogUtil;
+
+/**
+ * 男人。
+ * 
+ * @author 聂勇
+ */
+public class Man extends Person {
+
+    private boolean marry;
+    
+    private int power;
+    
+    public int height;
+
+    public Man() {
+        super();
+        LogUtil.log("%s的默认构造方法被调用", Man.class.getName());
+    }
+    
+    protected Man(String name) {
+        super(name, 0);
+        LogUtil.log("%s带name参数的构造方法被调用", Man.class.getName());
+    }
+    
+    @SuppressWarnings("unused")
+    private Man(String name, int age) {
+        super(name, age);
+        LogUtil.log("%s带name和age参数的构造方法被调用", Man.class.getName());
+    }
+    
+    public static void fight(Man a, Man b) {
+        String win = "unkown";
+        if (a.power > b.power) {
+            win = a.getName();
+        } else if (b.power > a.power) {
+            win = a.getName();
+        }
+        
+        LogUtil.log("%s vs %s, fight result:%s", a.getName(), b.getName(), win);
+    }
+    
+    public boolean isMarry() {
+        return marry;
+    }
+
+    public void setMarry(boolean marry) {
+        this.marry = marry;
+    }
+
+    public int getPower() {
+        return power;
+    }
+
+    @SuppressWarnings("unused")
+    private void setPower(int power) {
+        this.power = power;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/lang/serialization/Man.java b/Java基础教程/Java源代码/codedemo/java/lang/serialization/Man.java
new file mode 100644
index 00000000..840867bf
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/lang/serialization/Man.java
@@ -0,0 +1,74 @@
+package cn.aofeng.demo.java.lang.serialization;
+
+import java.io.Externalizable;
+import java.io.IOException;
+import java.io.ObjectInput;
+import java.io.ObjectOutput;
+
+/**
+ * 自定义序列化和反序列化。
+ * 
+ * @author 聂勇
+ */
+public class Man implements Externalizable {
+
+    private String manName;
+    
+    private int manAge;
+    
+    private transient String password;
+
+    public Man() {
+        // nothing
+    }
+    
+    public Man(String name, int age) {
+        this.manName = name;
+        this.manAge = age;
+    }
+    
+    public Man(String name, int age, String password) {
+        this.manName = name;
+        this.manAge = age;
+        this.password = password;
+    }
+    
+    public String getManName() {
+        return manName;
+    }
+
+    public void setManName(String manName) {
+        this.manName = manName;
+    }
+
+    public int getManAge() {
+        return manAge;
+    }
+
+    public void setManAge(int manAge) {
+        this.manAge = manAge;
+    }
+
+    public String getPassword() {
+        return password;
+    }
+
+    public void setPassword(String password) {
+        this.password = password;
+    }
+
+    @Override
+    public void writeExternal(ObjectOutput out) throws IOException {
+        out.writeObject(manName);
+        out.writeInt(manAge);
+        out.writeObject(password);
+    }
+
+    @Override
+    public void readExternal(ObjectInput in) throws IOException, ClassNotFoundException {
+        manName = (String) in.readObject();
+        manAge = in.readInt();
+        password = (String) in.readObject();
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/lang/serialization/People.java b/Java基础教程/Java源代码/codedemo/java/lang/serialization/People.java
new file mode 100644
index 00000000..70fbb130
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/lang/serialization/People.java
@@ -0,0 +1,79 @@
+package cn.aofeng.demo.java.lang.serialization;
+
+import java.io.Serializable;
+
+/**
+ * 默认序列化和
+ * 
+ * @author 聂勇
+ */
+public class People implements Serializable {
+
+    private static final long serialVersionUID = 6235620243018494633L;
+
+    private String name;
+    
+    private int age;
+    
+    private transient String address;
+    
+    private static String sTestNormal;
+    
+    private static transient String sTestTransient;
+
+    public People(String name) {
+        this.name = name;
+    }
+    
+    public People(String name, int age) {
+        this.name = name;
+        this.age = age;
+    }
+    
+    public People(String name, int age, String address) {
+        this.name = name;
+        this.age = age;
+        this.address = address;
+    }
+    
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public int getAge() {
+        return age;
+    }
+
+    public void setAge(int age) {
+        this.age = age;
+    }
+
+    public String getAddress() {
+        return address;
+    }
+
+    public void setAddress(String address) {
+        this.address = address;
+    }
+
+    public String getsTestNormal() {
+        return sTestNormal;
+    }
+
+    public void setsTestNormal(String sTestNormal) {
+        People.sTestNormal = sTestNormal;
+    }
+
+    public String getsTestTransient() {
+        return sTestTransient;
+    }
+
+    public void setsTestTransient(String sTestTransient) {
+        People.sTestTransient = sTestTransient;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/lang/serialization/TransientDemo.java b/Java基础教程/Java源代码/codedemo/java/lang/serialization/TransientDemo.java
new file mode 100644
index 00000000..c6f82f5e
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/lang/serialization/TransientDemo.java
@@ -0,0 +1,126 @@
+package cn.aofeng.demo.java.lang.serialization;
+
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.ObjectInputStream;
+import java.io.ObjectOutputStream;
+
+import org.apache.commons.io.IOUtils;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * 关键字 transient 测试。
+ * 
+ * @author 聂勇
+ */
+public class TransientDemo {
+
+    private static Logger _logger = LoggerFactory.getLogger(TransientDemo.class);
+    
+    private String _tempFileName = "TransientDemo";
+    
+    /**
+     * 将对象序列化并保存到文件。
+     * 
+     * @param obj 待序列化的对象
+     */
+    public void save(Object obj) {
+        ObjectOutputStream outs = null;
+        try {
+            outs = new ObjectOutputStream(
+                    new FileOutputStream( getTempFile(_tempFileName) ));
+            outs.writeObject(obj);
+        } catch (IOException e) {
+            _logger.error("save object to file occurs error", e);
+        } finally {
+            IOUtils.closeQuietly(outs);
+        }
+    }
+    
+    /**
+     * 从文件读取内容并反序列化成对象。
+     * 
+     * @return {@link People}对象。如果读取文件出错 或 对象类型转换失败，返回null。
+     */
+    public  T load() {
+        ObjectInputStream ins = null;
+        try {
+            ins = new ObjectInputStream(
+                    new FileInputStream( getTempFile(_tempFileName)) );
+            return ((T) ins.readObject());
+        } catch (IOException e) {
+            _logger.error("load object from file occurs error", e);
+        } catch (ClassNotFoundException e) {
+            _logger.error("load object from file occurs error", e);
+        } finally {
+            IOUtils.closeQuietly(ins);
+        }
+        
+        return null;
+    }
+    
+    private File getTempFile(String filename) {
+        return new File(getTempDir(), filename);
+    }
+    
+    private String getTempDir() {
+        return System.getProperty("java.io.tmpdir");
+    }
+    
+    private void displayPeople(People people) {
+        if (null == people) {
+            return;
+        }
+        String template = "People[name:%s, age:%d, address:%s, sTestNormal:%s, sTestTransient:%s]";
+        System.out.println( String.format(template, people.getName(), people.getAge(), 
+                people.getAddress(), people.getsTestNormal(), people.getsTestTransient()));
+    }
+    
+    private void displayMan(Man man) {
+        if (null == man) {
+            return;
+        }
+        String template = "Man[manName:%s, manAge:%d, password:%s]";
+        System.out.println( String.format(template, man.getManName(), man.getManAge(), man.getPassword()) );
+    }
+    
+    /**
+     * @param args
+     */
+    public static void main(String[] args) {
+        System.out.println(">>> Serializable测试");
+        TransientDemo demo = new TransientDemo();
+        
+        People people = new People("张三", 30, "中国广州");
+        people.setsTestNormal("normal-first");
+        people.setsTestTransient("transient-first");
+        System.out.println("序列化之前的对象信息：");
+        demo.displayPeople(people);
+        demo.save(people);
+        
+        // 修改静态变量的值
+        people.setsTestNormal("normal-second");
+        people.setsTestTransient("transient-second");
+        
+        People fromLoad = demo.load();
+        System.out.println("反序列化之后的对象信息：");
+        demo.displayPeople(fromLoad);
+        
+        
+        
+        System.out.println("");
+        System.out.println(">>> Externalizable测试");
+        Man man = new Man("李四", 10, "假密码");
+        System.out.println("序列化之前的对象信息：");
+        demo.displayMan(man);
+        demo.save(man);
+        
+        Man manFromLoadMan = demo.load();
+        System.out.println("反序列化之后的对象信息：");
+        demo.displayMan(manFromLoadMan);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/rmi/Gender.java b/Java基础教程/Java源代码/codedemo/java/rmi/Gender.java
new file mode 100644
index 00000000..2ba3e7b1
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/rmi/Gender.java
@@ -0,0 +1,20 @@
+package cn.aofeng.demo.java.rmi;
+
+/**
+ * 性别。
+ * 
+ * @author 聂勇
+ */
+public class Gender {
+
+    /**
+     * 男。
+     */
+    public final static char MALE = 'M';
+    
+    /**
+     * 女。
+     */
+    public final static char FEMALE = 'F';
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/rmi/RmiClient.java b/Java基础教程/Java源代码/codedemo/java/rmi/RmiClient.java
new file mode 100644
index 00000000..96f3c751
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/rmi/RmiClient.java
@@ -0,0 +1,60 @@
+package cn.aofeng.demo.java.rmi;
+
+import java.net.MalformedURLException;
+import java.rmi.Naming;
+import java.rmi.NotBoundException;
+import java.rmi.RemoteException;
+
+import org.apache.commons.lang.StringUtils;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * 
+ * 
+ * @author 聂勇
+ */
+public class RmiClient {
+
+    private static Logger _logger = LoggerFactory.getLogger(RmiClient.class);
+    
+    private static String assembleUrl(String hostUrl, String bindName) {
+        if (StringUtils.isBlank(hostUrl) || StringUtils.isBlank(bindName)) {
+            return null;
+        }
+        
+        String host = hostUrl.endsWith("/") ? hostUrl.substring(0, hostUrl.length()-1) : hostUrl;
+        String name = bindName.startsWith("/") ? bindName.substring(1) : bindName;
+        
+        return host + "/" + name;
+    }
+    
+    /**
+     * @param args 
+     * 
    
+     *   
  • [0]：待连接的RMI主机。如：rmi://192.168.56.102:9999
    • 
+     *   
  • [1]：服务名称。如：UserService
    • 
+     * 

+     */
+    public static void main(String[] args) throws MalformedURLException, RemoteException, NotBoundException {
+        String host = args[0];
+        String serviceName = args[1];
+        String url = assembleUrl(host, serviceName);
+        UserService userService = (UserService) Naming.lookup(url);
+        
+        String userId = "10000";
+        User user = userService.findById(userId);
+        _logger.info("身份证号为{}的用户信息{}", userId, user);
+        userId = "10001";
+        user = userService.findById(userId);
+        _logger.info("身份证号为{}的用户信息{}", userId, user);
+        
+        String userName = "小明";
+        user = userService.findByName(userName);
+        _logger.info("姓名为{}的用户信息{}", userName, user);
+        userName = "张三";
+        user = userService.findByName(userName);
+        _logger.info("姓名为{}的用户信息{}", userName, user);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/rmi/RmiServer.java b/Java基础教程/Java源代码/codedemo/java/rmi/RmiServer.java
new file mode 100644
index 00000000..24f9e9fb
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/rmi/RmiServer.java
@@ -0,0 +1,53 @@
+package cn.aofeng.demo.java.rmi;
+
+import java.rmi.AlreadyBoundException;
+import java.rmi.RemoteException;
+import java.rmi.registry.LocateRegistry;
+import java.rmi.registry.Registry;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * RMI服务端。
+ * 
+ * @author 聂勇
+ */
+public class RmiServer {
+
+    private static Logger _logger = LoggerFactory.getLogger(RmiServer.class);
+    
+    public static Registry createRegistry(int port) {
+        Registry registry = null;
+        try {
+            registry = LocateRegistry.createRegistry(port);
+        } catch (RemoteException e) {
+            _logger.info( String.format("注册端口%s失败", port), e);
+        }
+        
+        return registry;
+    }
+    
+    /**
+     * @param args [0]:绑定端口
+     * @throws RemoteException 
+     */
+    public static void main(String[] args) throws RemoteException {
+        int port = Integer.parseInt(args[0]);
+        UserService userService = new UserServiceImpl();
+        Registry registry = createRegistry(port);
+        if (null == registry) {
+            System.exit(0);
+        }
+        
+        String bindName = "UserService";
+        try {
+            registry.bind(bindName, userService);
+        } catch (AlreadyBoundException e) {
+            _logger.info("服务{}已经绑定过", bindName);
+        }
+        
+        _logger.info("RMI Server started, listen port:{}", port);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/rmi/User.java b/Java基础教程/Java源代码/codedemo/java/rmi/User.java
new file mode 100644
index 00000000..3f54cfae
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/rmi/User.java
@@ -0,0 +1,170 @@
+package cn.aofeng.demo.java.rmi;
+
+import java.io.Serializable;
+
+/**
+ * 用户信息。
+ * 
+ * @author 聂勇
+ */
+public class User implements Serializable {
+
+    private static final long serialVersionUID = 7616705579045104892L;
+
+    /**
+     * 身份证号。
+     */
+    private String id;
+    
+    /**
+     * 姓名。
+     */
+    private String name;
+    
+    /**
+     * 性别：M-男；F-女。
+     */
+    private char gender;
+
+    /**
+     * 出生日期。以毫秒存储。
+     */
+    private long birthday;
+    
+    /**
+     * 国家。
+     */
+    private String country;
+    
+    /**
+     * 省／州。
+     */
+    private String province;
+    
+    /**
+     * 市／区。
+     */
+    private String city;
+    
+    /**
+     * 街道详细地址。
+     */
+    private String address;
+
+    public String getId() {
+        return id;
+    }
+
+    public void setId(String id) {
+        this.id = id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public char getGender() {
+        return gender;
+    }
+
+    public void setGender(char gender) {
+        this.gender = gender;
+    }
+
+    public long getBirthday() {
+        return birthday;
+    }
+
+    public void setBirthday(long birthday) {
+        this.birthday = birthday;
+    }
+
+    public String getCountry() {
+        return country;
+    }
+
+    public void setCountry(String country) {
+        this.country = country;
+    }
+
+    public String getProvince() {
+        return province;
+    }
+
+    public void setProvince(String province) {
+        this.province = province;
+    }
+
+    public String getCity() {
+        return city;
+    }
+
+    public void setCity(String city) {
+        this.city = city;
+    }
+
+    public String getAddress() {
+        return address;
+    }
+
+    public void setAddress(String address) {
+        this.address = address;
+    }
+
+    @Override
+    public int hashCode() {
+        final int prime = 31;
+        int result = 1;
+        result = prime * result + ((country == null) ? 0 : country.hashCode());
+        result = prime * result + ((id == null) ? 0 : id.hashCode());
+        result = prime * result + ((name == null) ? 0 : name.hashCode());
+        return result;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj)
+            return true;
+        if (obj == null)
+            return false;
+        if (getClass() != obj.getClass())
+            return false;
+        User other = (User) obj;
+        if (country == null) {
+            if (other.country != null)
+                return false;
+        } else if (!country.equals(other.country))
+            return false;
+        if (id == null) {
+            if (other.id != null)
+                return false;
+        } else if (!id.equals(other.id))
+            return false;
+        if (name == null) {
+            if (other.name != null)
+                return false;
+        } else if (!name.equals(other.name))
+            return false;
+        return true;
+    }
+
+    @Override
+    public String toString() {
+        StringBuilder buffer = new StringBuilder(256)
+            .append("User [id=").append(id)
+            .append(", name=").append(name)
+            .append(", gender=").append(gender)
+            .append(", birthday=").append(birthday)
+            .append(", country=").append(country)
+            .append(", province=").append(province)
+            .append(", city=").append(city)
+            .append(", address=").append(address)
+            .append("]");
+        return buffer.toString();
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/rmi/UserService.java b/Java基础教程/Java源代码/codedemo/java/rmi/UserService.java
new file mode 100644
index 00000000..24697436
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/rmi/UserService.java
@@ -0,0 +1,19 @@
+package cn.aofeng.demo.java.rmi;
+
+import java.rmi.Remote;
+import java.rmi.RemoteException;
+
+/**
+ * 用户信息服务。
+ * 
+ * @author 聂勇
+ */
+public interface UserService extends Remote {
+
+    public User findByName(String name) throws RemoteException;
+    
+    public User findById(String id) throws RemoteException;
+    
+    public boolean add(User user) throws RemoteException;
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/rmi/UserServiceImpl.java b/Java基础教程/Java源代码/codedemo/java/rmi/UserServiceImpl.java
new file mode 100644
index 00000000..60e44b8f
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/rmi/UserServiceImpl.java
@@ -0,0 +1,70 @@
+package cn.aofeng.demo.java.rmi;
+
+import java.rmi.RemoteException;
+import java.rmi.server.UnicastRemoteObject;
+
+import org.apache.commons.lang.StringUtils;
+
+/**
+ * 用户信息服务。
+ * 
+ * @author 聂勇
+ */
+public class UserServiceImpl extends UnicastRemoteObject implements UserService {
+
+    public UserServiceImpl() throws RemoteException {
+        super();
+    }
+
+    private static final long serialVersionUID = -9134952963637302483L;
+
+    @Override
+    public User findByName(String name) throws RemoteException {
+        if (StringUtils.isBlank(name)) {
+            return null;
+        }
+        
+        if ("小明".equals(name)) {
+            return createUser("10000", "小明", Gender.MALE);
+        }
+        
+        return null;
+    }
+
+    @Override
+    public User findById(String id) throws RemoteException {
+        if (StringUtils.isBlank(id)) {
+            return null;
+        }
+        
+        if ("10000".equals(id)) {
+            return createUser("10000", "小丽", Gender.FEMALE);
+        }
+        
+        return null;
+    }
+
+    @Override
+    public boolean add(User user) throws RemoteException {
+        if (null == user || StringUtils.isBlank(user.getId()) || StringUtils.isBlank(user.getName())) {
+            return false;
+        }
+        
+        return true;
+    }
+
+    private User createUser(String id, String name, char gender) {
+        User user = new User();
+        user.setId(id);
+        user.setName(name);
+        user.setGender(gender);
+        user.setBirthday(System.currentTimeMillis());
+        user.setCountry("中国");
+        user.setProvince("广东");
+        user.setCity("广州");
+        user.setAddress("xxx区xxx街道xxx号");
+        
+        return user;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/util/concurret/ScheduledExecutorServiceDemo.java b/Java基础教程/Java源代码/codedemo/java/util/concurret/ScheduledExecutorServiceDemo.java
new file mode 100644
index 00000000..fdacb077
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/util/concurret/ScheduledExecutorServiceDemo.java
@@ -0,0 +1,78 @@
+package cn.aofeng.demo.java.util.concurret;
+
+import java.util.Date;
+import java.util.concurrent.Executors;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.TimeUnit;
+
+import cn.aofeng.demo.util.DateUtil;
+
+/**
+ * {@link ScheduledExecutorService}的使用示例：

+ * 定时任务1：执行过程中会抛出异常。

+ * 定时任务2：执行过程中不会抛出异常。

+ * 

+ * 目的：检测java.util.concurrent.ScheduledExecutorService在执行定时任务的过程中，任务内抛出异常没有捕捉时在下一次执行时间到来时，是否可以正常执行。

+ * 测试的JDK版本：1.6.xx。

+ * 结果：通过，相比java.util.Timer，完善地解决了定时任务抛异常的问题。
+ * 
+ * @author 聂勇
+ */
+public class ScheduledExecutorServiceDemo {
+
+    public static void main(String[] args) {
+        ScheduledExecutorService timer = Executors.newScheduledThreadPool(2);
+        long delay = computeDelay();
+        timer.schedule(new ThrowExceptionTask(timer), delay, TimeUnit.MILLISECONDS);
+        timer.schedule(new NotThrowExceptionTask(timer), delay, TimeUnit.MILLISECONDS);
+        System.out.println("主线程的功能执行完毕");
+    }
+
+    private static long computeDelay() {
+        Date now = new Date();
+        Date nextMinute = DateUtil.getNextMinute();
+        long delay = nextMinute.getTime() - now.getTime();
+        return delay;
+    }
+
+    static class ThrowExceptionTask implements Runnable {
+
+        private ScheduledExecutorService _timer;
+        
+        public ThrowExceptionTask(ScheduledExecutorService timer) {
+            this._timer = timer;
+        }
+        
+        @Override
+        public void run() {
+            try {
+                System.out.println("任务名:ThrowExceptionTask, 当前时间:"+DateUtil.getCurrentTime());
+                
+                throw new IllegalArgumentException();
+            } finally {
+                _timer.schedule(new ThrowExceptionTask(_timer), computeDelay(), TimeUnit.MILLISECONDS);
+            }
+        }
+        
+    } // end of ThrowExceptionTask
+    
+    static class NotThrowExceptionTask implements Runnable {
+        
+        private ScheduledExecutorService _timer;
+        
+        public NotThrowExceptionTask(ScheduledExecutorService timer) {
+            this._timer = timer;
+        }
+        
+        @Override
+        public void run() {
+            try {
+                System.out.println("任务名:NotThrowExceptionTask, 当前时间:"+DateUtil.getCurrentTime());
+            } finally {
+                _timer.schedule(new NotThrowExceptionTask(_timer), computeDelay(), TimeUnit.MILLISECONDS);
+            }
+        }
+        
+    } // end of NotThrowExceptionTask
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/util/forkjoin/HelloForkJoin.java b/Java基础教程/Java源代码/codedemo/java/util/forkjoin/HelloForkJoin.java
new file mode 100644
index 00000000..a410da18
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/util/forkjoin/HelloForkJoin.java
@@ -0,0 +1,103 @@
+package cn.aofeng.demo.java.util.forkjoin;
+
+import java.util.Arrays;
+import java.util.concurrent.ForkJoinPool;
+import java.util.concurrent.RecursiveTask;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * Fork/Join练习。
+ * 
+ * @author 聂勇
+ */
+public class HelloForkJoin extends RecursiveTask {
+
+    private static final long serialVersionUID = -2386438994963147457L;
+
+    private int[] _intArray;
+    
+    private int _threshold = 10;
+    
+    private long _result = 0;
+    
+    public HelloForkJoin(int[] intArray) {
+        this._intArray = intArray;
+    }
+    
+    @Override
+    protected Long compute() {
+        if (null == _intArray || _intArray.length <= 0) {
+            return 0L;
+        }
+        
+        if (_intArray.length <= _threshold) {   // 如果数组长度小于等于指定的值，执行累加操作
+            for (int item : _intArray) {
+                _result += item;
+            }
+            System.out.println( String.format("线程：%s，累加数组%s中的值，结果：%d", Thread.currentThread(), Arrays.toString(_intArray), _result) );
+        } else {   // 如果数组长度大于指定的值，做任务分解
+            int[] temp = new int[_threshold];
+            System.arraycopy(_intArray, 0, temp, 0, _threshold);
+            HelloForkJoin subTask1 = new HelloForkJoin(temp);
+            subTask1.fork();
+            
+            if (_intArray.length - _threshold > 0) {
+                int remain[] = new int[_intArray.length - _threshold];
+                System.arraycopy(_intArray, _threshold, remain, 0, remain.length);
+                HelloForkJoin task = new HelloForkJoin(remain);
+                task.fork();
+                _result += task.join();
+            }
+            
+            _result += subTask1.join();
+            
+            return _result;
+        }
+        
+        return _result;
+    }
+    
+    public static void main(String[] args) throws InterruptedException {
+        int count = 10000;
+        
+        serialCompute(count);
+        parallelCompute(count);
+    }
+
+    /**
+     * 使用fork/join并行计算数字累加。
+     * 
+     * @param count 数字个数（从1开始）
+     * @throws InterruptedException
+     */
+    private static void parallelCompute(int count)
+            throws InterruptedException {
+        int[] numbers = new int[count];
+        for (int i = 0; i < count; i++) {
+            numbers[i] = i+1;
+        }
+        ForkJoinPool pool = new ForkJoinPool(4);
+        HelloForkJoin task = new HelloForkJoin(numbers);
+        long startTime = System.currentTimeMillis();
+        pool.submit(task);
+        pool.shutdown();
+        pool.awaitTermination(10, TimeUnit.SECONDS);
+        
+        System.out.println( String.format("并行计算结果：%d，耗时：%d毫秒", task._result, System.currentTimeMillis()-startTime) );
+    }
+
+    /**
+     * 使用for循环串行计算数字累加。
+     * 
+     * @param count 数字个数（从1开始） 
+     */
+    private static void serialCompute(int count) {
+        long startTime = System.currentTimeMillis();
+        int sum = 0;
+        for (int i = 0; i < count; i++) {
+            sum += (i+1);
+        }
+        System.out.println( String.format("串行计算结果：%d，耗时：%d毫秒", sum, System.currentTimeMillis()-startTime) );
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/util/future/Future.ucls b/Java基础教程/Java源代码/codedemo/java/util/future/Future.ucls
new file mode 100644
index 00000000..c49836d6
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/util/future/Future.ucls
@@ -0,0 +1,101 @@
+
+  
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+  
+
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/java/util/future/HelloFuture.java b/Java基础教程/Java源代码/codedemo/java/util/future/HelloFuture.java
new file mode 100644
index 00000000..e92baba6
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/util/future/HelloFuture.java
@@ -0,0 +1,106 @@
+package cn.aofeng.demo.java.util.future;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.concurrent.Callable;
+import java.util.concurrent.CancellationException;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+import java.util.concurrent.Future;
+import java.util.concurrent.TimeUnit;
+
+import org.apache.log4j.Logger;
+
+/**
+ * Future、Callable练习。
+ * 
+ * @author 聂勇
+ */
+public class HelloFuture {
+
+    private static Logger _logger = Logger.getLogger(HelloFuture.class);
+
+    /**
+     * @param args
+     * @throws InterruptedException 
+     */
+    public static void main(String[] args) throws InterruptedException {
+        executeSingleTask();
+        executeBatchTask();
+    }
+
+    /**
+     * 执行单个异步任务：

+     * 1、用submit方法向线程池提交一个任务。

+     * 2、获取结果时，指定了超时时间。


+     * 结果：超时后，调用者收到TimeoutException，但实际上任务还在继续执行。
+     * @throws InterruptedException
+     */
+    private static void executeSingleTask() throws InterruptedException {
+        ExecutorService threadpool = Executors.newFixedThreadPool(6);
+        try {
+            Future f = threadpool.submit(createCallable(5 * 1000));
+            Object result = f.get(3, TimeUnit.SECONDS);
+            System.out.println("单个任务的执行结果："+result);
+        } catch (Exception e) {
+            _logger.error("线程执行任务时出错", e);
+        } finally {
+            threadpool.shutdown();
+            threadpool.awaitTermination(10, TimeUnit.SECONDS);
+        }
+    }
+
+    /**
+     * 执行多个异步任务：

+     * 1、用invokeAll方法向线程池提交多个任务，并指定了执行的超时时间。


+     * 结果：超时后，未执行完成的任务被取消，在调用Future的get方法时，取消的任务会抛出CancellationException，执行完成的任务可获得结果。
+     * @throws InterruptedException
+     */
+    private static void executeBatchTask() throws InterruptedException {
+        ExecutorService threadpool = Executors.newFixedThreadPool(6);
+        List> tasks = new ArrayList>();
+        tasks.add(createCallable(2000));
+        tasks.add(createCallable(5000));
+        tasks.add(createCallable(2500));
+        
+        long startTime = System.currentTimeMillis();
+        try {
+            List> fs = threadpool.invokeAll(tasks, 3, TimeUnit.SECONDS);
+            int result = 0;
+            for (Future f : fs) {
+                try{
+                    result += f.get();
+                } catch(CancellationException ce) {
+                    // nothing
+                }
+            }
+            System.out.println("执行三个任务共耗时：" + (System.currentTimeMillis() - startTime) + "毫秒");
+            System.out.println("三个任务的执行结果汇总："+result);
+        } catch (Exception e) {
+            _logger.error("线程执行任务时出错", e);
+        } finally {
+            threadpool.shutdown();
+            threadpool.awaitTermination(10, TimeUnit.SECONDS);
+        }
+    }
+    
+    /**
+     * 创建需要长时间执行的任务模拟对象。
+     * @param sleepTimes 线程休眠时间（单位：毫秒）
+     * @return {@link Callable}对象
+     */
+    private static Callable createCallable(final int sleepTimes) {
+        Callable c = new Callable() {
+
+            @Override
+            public Integer call() throws Exception {
+                Thread.sleep(sleepTimes);
+                System.out.println(Thread.currentThread().getName() + ": I'm working");
+                return 9;
+            }
+        };
+        
+        return c;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/java/util/map/Map接口及其实现类.ucls b/Java基础教程/Java源代码/codedemo/java/util/map/Map接口及其实现类.ucls
new file mode 100644
index 00000000..a9f38aed
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/util/map/Map接口及其实现类.ucls
@@ -0,0 +1,139 @@
+
+  
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+  
+
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/java/util/timer/TimerDemo.java b/Java基础教程/Java源代码/codedemo/java/util/timer/TimerDemo.java
new file mode 100644
index 00000000..7341764d
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/java/util/timer/TimerDemo.java
@@ -0,0 +1,47 @@
+package cn.aofeng.demo.java.util.timer;
+
+import java.util.Timer;
+import java.util.TimerTask;
+
+import cn.aofeng.demo.util.DateUtil;
+
+/**
+ * {@link Timer}的使用示例：

+ * 定时任务1：执行过程中会抛出异常。

+ * 定时任务2：执行过程中不会抛出异常。

+ * 

+ * 目的：检测java.util.Timer在执行定时任务的过程中，任务内抛出异常没有捕捉时在下一次执行时间到来时，是否可以正常执行。

+ * 测试的JDK版本：1.6.xx。

+ * 结果：不通过，定时任务抛出异常时，整个Timer中止，其他定时任务也中止。
+ * 
+ * @author 聂勇
+ */
+public class TimerDemo {
+
+    public static void main(String[] args) {
+        Timer timer = new Timer("aofeng-timer-demo");
+        timer.schedule(new ThrowExceptionTask(), DateUtil.getNextMinute(), 60*1000);
+        timer.schedule(new NotThrowExceptionTask(), DateUtil.getNextMinute(), 60*1000);
+    }
+
+    static class ThrowExceptionTask extends TimerTask {
+
+        @Override
+        public void run() {
+            System.out.println("任务名:ThrowExceptionTask, 当前时间:"+DateUtil.getCurrentTime());
+            
+            throw new IllegalArgumentException();
+        }
+        
+    } // end of ThrowExceptionTask
+    
+    static class NotThrowExceptionTask extends TimerTask {
+        
+        @Override
+        public void run() {
+            System.out.println("任务名:NotThrowExceptionTask, 当前时间:"+DateUtil.getCurrentTime());
+        }
+        
+    } // end of NotThrowExceptionTask
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/jdbc/JDBCUtils.java b/Java基础教程/Java源代码/codedemo/jdbc/JDBCUtils.java
new file mode 100644
index 00000000..57741f56
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/jdbc/JDBCUtils.java
@@ -0,0 +1,64 @@
+package cn.aofeng.demo.jdbc;
+
+import java.sql.Connection;
+import java.sql.ResultSet;
+import java.sql.ResultSetMetaData;
+import java.sql.SQLException;
+import java.sql.Statement;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * JDBC常用方法集。
+ * 
+ * @author 聂勇
+ */
+public class JDBCUtils {
+
+    private static Logger _logger = LoggerFactory.getLogger(JDBCUtils.class);
+    
+    public static void close(ResultSet rs) {
+        if (null != rs) {
+            try {
+                rs.close();
+            } catch (SQLException e) {
+                _logger.error("close resultset occurs error", e);
+            }
+        }
+    }
+    
+    public static void close(Statement stmt) {
+        if (null != stmt) {
+            try {
+                stmt.close();
+            } catch (SQLException e) {
+                _logger.error("close statement occurs error", e);
+            }
+        }
+    }
+    
+    public static void close(Connection conn) {
+        if (null != conn) {
+            try {
+                conn.close();
+            } catch (SQLException e) {
+                _logger.error("close connection occurs error", e);
+            }
+        }
+    }
+
+    public static void showResultSetInfo(ResultSet rs) throws SQLException {
+        ResultSetMetaData rsMeta = rs.getMetaData();
+        int colCount = rsMeta.getColumnCount();
+        _logger.info("total columns:{}", colCount);
+        for (int i = 1; i <= colCount; i++) {
+            _logger.info("column name:{}, label:{}, type:{}, typeName:{}",
+                    rsMeta.getColumnName(i), 
+                    rsMeta.getColumnLabel(i),
+                    rsMeta.getColumnType(i),
+                    rsMeta.getColumnTypeName(i));
+        }
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/jdbc/MetaDataExample.java b/Java基础教程/Java源代码/codedemo/jdbc/MetaDataExample.java
new file mode 100644
index 00000000..f631135a
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/jdbc/MetaDataExample.java
@@ -0,0 +1,82 @@
+package cn.aofeng.demo.jdbc;
+
+import java.sql.Connection;
+import java.sql.DatabaseMetaData;
+import java.sql.DriverManager;
+import java.sql.ResultSet;
+import java.sql.SQLException;
+import java.util.Properties;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import cn.aofeng.demo.tree.PrettyTree;
+import cn.aofeng.demo.tree.PrettyTree.Node;
+
+/**
+ * JDBC元数据使用示例。
+ * 
+ * @author 聂勇
+ */
+public class MetaDataExample {
+
+    private static Logger _logger = LoggerFactory.getLogger(MetaDataExample.class);
+
+    /**
+     * @param args
+     */
+    public static void main(String[] args) {
+        String url = "jdbc:mysql://192.168.56.102:19816/ucgc_sdk?useUnicode=true&characterEncoding=UTF8";
+        Properties info = new Properties();
+        info.put("user", "uzone");
+        info.put("password", "uzone");
+
+        Connection conn = null;
+        try {
+            conn = DriverManager.getConnection(url, info);
+            DatabaseMetaData dbMeta = conn.getMetaData();
+            showCatalogs(dbMeta);
+        } catch (SQLException e) {
+            _logger.error("get connection occurs error", e);
+        } finally {
+            JDBCUtils.close(conn);
+        }
+    }
+
+    private static void showCatalogs(DatabaseMetaData dbMeta) throws SQLException {
+        ResultSet catalogsRs = null;
+        try {
+            catalogsRs = dbMeta.getCatalogs();
+//             JDBCUtils.showResultSetInfo(catalogsRs);
+            while (catalogsRs.next()) {
+                String catalog = catalogsRs.getString("TABLE_CAT");
+                showTables(dbMeta, catalog);
+            }
+        } finally {
+            JDBCUtils.close(catalogsRs);
+        }
+    }
+
+    /**
+     * 采用树状结构输出Catalog和所有归属于它的表的名称。
+     */
+    private static void showTables(DatabaseMetaData dbMeta, String catalog) throws SQLException {
+        ResultSet tablesRs = null;
+        Node root = new Node(catalog);
+        try {
+            tablesRs = dbMeta.getTables(catalog, null, null, null);
+//             JDBCUtils.showResultSetInfo(tablesRs);
+            while (tablesRs.next()) {
+                root.add(new Node(tablesRs.getString("TABLE_NAME")));
+            }
+        } finally {
+            JDBCUtils.close(tablesRs);
+        }
+        
+        StringBuilder buffer = new StringBuilder(256);
+        PrettyTree pt = new PrettyTree();
+        pt.renderRoot(root, buffer);
+        System.out.print(buffer);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/jetty/HttpGet.java b/Java基础教程/Java源代码/codedemo/jetty/HttpGet.java
new file mode 100644
index 00000000..00ad49d0
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/jetty/HttpGet.java
@@ -0,0 +1,42 @@
+package cn.aofeng.demo.jetty;
+
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.net.HttpURLConnection;
+import java.net.URL;
+
+import org.apache.commons.io.IOUtils;
+
+/**
+ * 抓取页面内容。
+ * 
+ * @author 聂勇
+ */
+public class HttpGet {
+
+    public String getSomeThing(String urlStr) throws IOException {
+        URL url = new URL(urlStr);
+        HttpURLConnection urlConn = (HttpURLConnection) url.openConnection();
+        urlConn.setConnectTimeout(3000);
+        urlConn.setRequestMethod("GET");
+        urlConn.connect();
+        
+        InputStream ins = null;
+        try {
+            if (200 == urlConn.getResponseCode()) {
+                ins = urlConn.getInputStream();
+                ByteArrayOutputStream outs = new ByteArrayOutputStream(1024);
+                IOUtils.copy(ins, outs);
+                return outs.toString("UTF-8");
+            }
+        } catch (IOException e) {
+            throw e;
+        } finally {
+            IOUtils.closeQuietly(ins);
+        }
+        
+        return null;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/jetty/HttpGetTest.java b/Java基础教程/Java源代码/codedemo/jetty/HttpGetTest.java
new file mode 100644
index 00000000..94d954d1
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/jetty/HttpGetTest.java
@@ -0,0 +1,55 @@
+package cn.aofeng.demo.jetty;
+
+import static org.junit.Assert.*;
+
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+
+/**
+ * {@link HttpGet}的单元测试用例。
+ * 
+ * @author 聂勇
+ */
+public class HttpGetTest {
+    
+    private HttpServerMock _mock;
+    private HttpGet _httpGet = new HttpGet();
+
+    @Before
+    public void setUp() throws Exception {
+        _mock = new HttpServerMock();
+    }
+
+    @After
+    public void tearDown() throws Exception {
+        if (null != _mock) {
+            _mock.stop();
+        }
+    }
+
+    /**
+     * 用例：响应状态码为200且有响应内容。
+     */
+    @Test
+    public void testGetSomeThing4Success() throws Exception {
+        String response = "Hello, The World!";
+        _mock.start(response, "text/plain");
+        
+        String content = _httpGet.getSomeThing("http://localhost:9191/hello");
+        assertEquals(response, content);
+    }
+    
+    /**
+     * 用例：响应状态码为非200。
+     */
+    @Test
+    public void testGetSomeThing4Fail() throws Exception {
+        String response = "Hello, The World!";
+        _mock.start(response, "text/plain", 500);
+        
+        String content = _httpGet.getSomeThing("http://localhost:9191/hello");
+        assertNull(content);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/jetty/HttpServerMock.java b/Java基础教程/Java源代码/codedemo/jetty/HttpServerMock.java
new file mode 100644
index 00000000..594ba0b1
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/jetty/HttpServerMock.java
@@ -0,0 +1,90 @@
+package cn.aofeng.demo.jetty;
+
+import java.io.IOException;
+
+import javax.servlet.ServletException;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+import org.eclipse.jetty.server.Handler;
+import org.eclipse.jetty.server.Request;
+import org.eclipse.jetty.server.Server;
+import org.eclipse.jetty.server.handler.AbstractHandler;
+
+/**
+ * HTTP服务器MOCK，可用于单元测试时模拟HTTP服务器的响应。
+ * 
+ * @author 聂勇
+ */
+public class HttpServerMock {
+
+    public final static int DEFAULT_PORT = 9191;
+    public final static String DEFAULT_CONTENT_TYPE = "application/json";
+    public final static int DEFAULT_STATUS_CODE=HttpServletResponse.SC_OK;
+    
+    private Server _httpServer;
+    private int _port;
+    
+    public HttpServerMock() {
+        _port = DEFAULT_PORT;
+    }
+    
+    public HttpServerMock(int port) {
+        _port = port;
+    }
+    
+    /**
+     * 启动Jetty服务器。默认的响应status code为"200"，content type为"application/json"。
+     * @param content 响应内容
+     */
+    public void start(String content) throws Exception {
+        start(content, DEFAULT_CONTENT_TYPE, DEFAULT_STATUS_CODE);
+    }
+    
+    /**
+     * 启动Jetty服务器。默认的响应status code为"200"。
+     * @param content 响应内容
+     * @param contentType 响应内容的MIME类型
+     */
+    public void start(String content, String contentType) throws Exception {
+        start(content, contentType, DEFAULT_STATUS_CODE);
+    }
+    
+    /**
+     * 启动Jetty服务器。
+     * @param content 响应内容
+     * @param contentType 响应内容的MIME类型
+     * @param statuCode 响应状态码
+     */
+    public void start(String content, String contentType, 
+            int statuCode) throws Exception {
+        _httpServer = new Server(_port);
+        _httpServer.setHandler(createHandler(content, contentType, statuCode));
+        _httpServer.start();
+    }
+    
+    /**
+     * 停止Jetty服务器。
+     */
+    public void stop() throws Exception {
+        if (null != _httpServer) {
+            _httpServer.stop();
+            _httpServer = null;
+        }
+    }
+    
+    private Handler createHandler(final String content, final String contentType, 
+            final int statusCode) {
+        return new AbstractHandler() {
+            @Override
+            public void handle(String target, Request baseRequest, HttpServletRequest request,
+                    HttpServletResponse response) throws IOException, ServletException {
+                response.setContentType(contentType);
+                response.setStatus(statusCode);
+                baseRequest.setHandled(true);
+                response.getWriter().print(content);
+            }
+        };
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/jetty/README.md b/Java基础教程/Java源代码/codedemo/jetty/README.md
new file mode 100644
index 00000000..242d8d4b
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/jetty/README.md
@@ -0,0 +1,216 @@
+使用Jetty实现Http Server Mock作单元测试
+===
+在研发过程中发现许多模块对外部系统的调用并没有沉淀成专门的客户端，代码中直接调用URL发送请求和获取响应内容，导致做单元测试的时候非常麻烦。
+特别是对已有系统做改造的时候，要先写单元测试用例，保证后续的重构和修改不偏离原来的业务需求。
+
+这样问题就来了：该如何模拟外部系统返回各种正常和异常的响应内容呢？
+办法总是有的，这里就用Jetty实现Http Server Mock，模拟服务端返回各种响应数据。
+
+预备
+---
+* [JUnit 4.11](http://junit.org/)
+* [Jetty 7.6.9](http://www.eclipse.org/jetty/)
+
+业务示例代码
+---
+[源码下载](https://raw.githubusercontent.com/aofeng/JavaDemo/master/src/cn/aofeng/demo/jetty/HttpGet.java)
+```java
+package cn.aofeng.demo.jetty;
+
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.net.HttpURLConnection;
+import java.net.URL;
+
+import org.apache.commons.io.IOUtils;
+
+/**
+ * 抓取页面内容。
+ * 
+ * @author 聂勇
+ */
+public class HttpGet {
+
+    public String getSomeThing(String urlStr) throws IOException {
+        URL url = new URL(urlStr);
+        HttpURLConnection urlConn = (HttpURLConnection) url.openConnection();
+        urlConn.setConnectTimeout(3000);
+        urlConn.setRequestMethod("GET");
+        urlConn.connect();
+        
+        InputStream ins = null;
+        try {
+            if (200 == urlConn.getResponseCode()) {
+                ins = urlConn.getInputStream();
+                ByteArrayOutputStream outs = new ByteArrayOutputStream(1024);
+                IOUtils.copy(ins, outs);
+                return outs.toString("UTF-8");
+            }
+        } catch (IOException e) {
+            throw e;
+        } finally {
+            IOUtils.closeQuietly(ins);
+        }
+        
+        return null;
+    }
+
+}
+```
+用Jetty实现的Http Server Mock
+---
+[源码下载](https://raw.githubusercontent.com/aofeng/JavaDemo/master/src/cn/aofeng/demo/jetty/HttpServerMock.java)
+```java
+package cn.aofeng.demo.jetty;
+
+import java.io.IOException;
+
+import javax.servlet.ServletException;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+import org.eclipse.jetty.server.Handler;
+import org.eclipse.jetty.server.Request;
+import org.eclipse.jetty.server.Server;
+import org.eclipse.jetty.server.handler.AbstractHandler;
+
+/**
+ * HTTP服务器MOCK，可用于单元测试时模拟HTTP服务器的响应。
+ * 
+ * @author 聂勇
+ */
+public class HttpServerMock {
+
+    public final static int DEFAULT_PORT = 9191;
+    public final static String DEFAULT_CONTENT_TYPE = "application/json";
+    public final static int DEFAULT_STATUS_CODE=HttpServletResponse.SC_OK;
+    
+    private Server _httpServer;
+    private int _port;
+    
+    public HttpServerMock() {
+        _port = DEFAULT_PORT;
+    }
+    
+    public HttpServerMock(int port) {
+        _port = port;
+    }
+    
+    /**
+     * 启动Jetty服务器。默认的响应status code为"200"，content type为"application/json"。
+     * @param content 响应内容
+     */
+    public void start(String content) throws Exception {
+        start(content, DEFAULT_CONTENT_TYPE, DEFAULT_STATUS_CODE);
+    }
+    
+    /**
+     * 启动Jetty服务器。默认的响应status code为"200"。
+     * @param content 响应内容
+     * @param contentType 响应内容的MIME类型
+     */
+    public void start(String content, String contentType) throws Exception {
+        start(content, contentType, DEFAULT_STATUS_CODE);
+    }
+    
+    /**
+     * 启动Jetty服务器。
+     * @param content 响应内容
+     * @param contentType 响应内容的MIME类型
+     * @param statuCode 响应状态码
+     */
+    public void start(String content, String contentType, 
+            int statuCode) throws Exception {
+        _httpServer = new Server(_port);
+        _httpServer.setHandler(createHandler(content, contentType, statuCode));
+        _httpServer.start();
+    }
+    
+    /**
+     * 停止Jetty服务器。
+     */
+    public void stop() throws Exception {
+        if (null != _httpServer) {
+            _httpServer.stop();
+            _httpServer = null;
+        }
+    }
+    
+    private Handler createHandler(final String content, final String contentType, 
+            final int statusCode) {
+        return new AbstractHandler() {
+            @Override
+            public void handle(String target, Request baseRequest, HttpServletRequest request,
+                    HttpServletResponse response) throws IOException, ServletException {
+                response.setContentType(contentType);
+                response.setStatus(statusCode);
+                baseRequest.setHandled(true);
+                response.getWriter().print(content);
+            }
+        };
+    }
+
+}
+```
+单元测试代码
+---
+[源码下载](https://raw.githubusercontent.com/aofeng/JavaDemo/master/src/cn/aofeng/demo/jetty/HttpGetTest.java)
+```java
+package cn.aofeng.demo.jetty;
+
+import static org.junit.Assert.*;
+
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+
+/**
+ * {@link HttpGet}的单元测试用例。
+ * 
+ * @author 聂勇
+ */
+public class HttpGetTest {
+    
+    private HttpServerMock _mock;
+    private HttpGet _httpGet = new HttpGet();
+
+    @Before
+    public void setUp() throws Exception {
+        _mock = new HttpServerMock();
+    }
+
+    @After
+    public void tearDown() throws Exception {
+        if (null != _mock) {
+            _mock.stop();
+        }
+    }
+
+    /**
+     * 用例：响应状态码为200且有响应内容。
+     */
+    @Test
+    public void testGetSomeThing4Success() throws Exception {
+        String response = "Hello, The World!";
+        _mock.start(response, "text/plain");
+        
+        String content = _httpGet.getSomeThing("http://localhost:9191/hello");
+        assertEquals(response, content);
+    }
+    
+    /**
+     * 用例：响应状态码为非200。
+     */
+    @Test
+    public void testGetSomeThing4Fail() throws Exception {
+        String response = "Hello, The World!";
+        _mock.start(response, "text/plain", 500);
+        
+        String content = _httpGet.getSomeThing("http://localhost:9191/hello");
+        assertNull(content);
+    }
+
+}
+```
+
diff --git a/Java基础教程/Java源代码/codedemo/json/gson/ArrayDeserialize.java b/Java基础教程/Java源代码/codedemo/json/gson/ArrayDeserialize.java
new file mode 100644
index 00000000..9dd5dd07
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/json/gson/ArrayDeserialize.java
@@ -0,0 +1,45 @@
+package cn.aofeng.demo.json.gson;
+
+import com.google.gson.Gson;
+
+/**
+ * 数组的反序列化。
+ * 
+ * @author 聂勇
+ */
+public class ArrayDeserialize {
+
+    public  T deserialize(String json, Class claz) {
+        Gson gson = new Gson();
+        return gson.fromJson(json, claz);
+    }
+    
+    public static void main(String[] args) {
+        ArrayDeserialize ad = new ArrayDeserialize();
+        
+        // 整型数组
+        String intArrJson = "[9,7,5]";
+        int[] intArr = ad.deserialize(intArrJson, int[].class);
+        System.out.println("---------- 整型数组 ----------");
+        for (int i : intArr) {
+            System.out.println(i);
+        }
+        
+        // 字符串数组
+        String strArrJson = "[\"张三\",\"李四\",\"王五\"]";
+        String[] strArr = ad.deserialize(strArrJson, String[].class);
+        System.out.println("---------- 字符串数组 ----------");
+        for (String str : strArr) {
+            System.out.println(str);
+        }
+        
+        // 对象数组
+        String objArrJson = "[{\"name\":\"小明\",\"age\":10},{\"name\":\"马丽\",\"age\":9}]";
+        Person[] objArr = ad.deserialize(objArrJson, Person[].class);
+        System.out.println("---------- 对象数组 ----------");
+        for (Person person : objArr) {
+            System.out.println(person);
+        }
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/json/gson/ArraySerialize.java b/Java基础教程/Java源代码/codedemo/json/gson/ArraySerialize.java
new file mode 100644
index 00000000..3b9523c2
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/json/gson/ArraySerialize.java
@@ -0,0 +1,41 @@
+package cn.aofeng.demo.json.gson;
+
+import com.google.gson.Gson;
+
+/**
+ * 数组的序列化。
+ * 
+ * @author 聂勇
+ */
+public class ArraySerialize {
+
+    public void serialize(Object[] arr) {
+        Gson gson = new Gson();
+        System.out.println( gson.toJson(arr) );
+    }
+    
+    public static void main(String[] args) {
+        ArraySerialize as = new ArraySerialize();
+        
+        // 整型对象数组
+        Integer[] intArr = new Integer[3];
+        intArr[0] = 9;
+        intArr[1] = 7;
+        intArr[2] = 5;
+        as.serialize(intArr);
+        
+        // 字符串数组
+        String[] names = new String[3];
+        names[0] = "张三";
+        names[1] = "李四";
+        names[2] = "王五";
+        as.serialize(names);
+        
+        // 对象数组
+        Person[] persons = new Person[2];
+        persons[0] = new Person("小明", 10);
+        persons[1] = new Person("马丽", 9);
+        as.serialize(persons);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/json/gson/CollectionDeserialize.java b/Java基础教程/Java源代码/codedemo/json/gson/CollectionDeserialize.java
new file mode 100644
index 00000000..0b5b5fa6
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/json/gson/CollectionDeserialize.java
@@ -0,0 +1,55 @@
+package cn.aofeng.demo.json.gson;
+
+import java.lang.reflect.Type;
+import java.util.List;
+import java.util.Map;
+import java.util.Map.Entry;
+import java.util.Set;
+
+import com.google.gson.Gson;
+import com.google.gson.reflect.TypeToken;
+
+/**
+ * 集合的反序列化。
+ * 
+ * @author 聂勇
+ */
+public class CollectionDeserialize {
+
+    public  T deserialize(String json, Type type) {
+        Gson gson = new Gson();
+        return gson.fromJson(json, type);
+    }
+    
+    public static void main(String[] args) {
+        CollectionDeserialize cd = new CollectionDeserialize();
+        
+        //整型List
+        String intListJson = "[9,8,0]";
+        List intList = cd.deserialize( intListJson, 
+                new TypeToken>(){}.getType() );
+        System.out.println("---------- 整型List ----------");
+        for (Integer obj : intList) {
+            System.out.println(obj);
+        }
+        
+        // 字符串Set
+        String strSetJson = "[\"Best\",\"World\",\"Hello\"]";
+        Set strSet = cd.deserialize( strSetJson, 
+                new TypeToken>(){}.getType() );
+        System.out.println("---------- 字符串Set ----------");
+        for (String str : strSet) {
+            System.out.println(str);
+        }
+        
+        // Map
+        String objMapJson = "{\"xiaomin\":{\"name\":\"小明\",\"age\":21},\"marry\":{\"name\":\"马丽\",\"age\":20}}";
+        Map objMap = cd.deserialize( objMapJson, 
+                new TypeToken>(){}.getType() );
+        System.out.println("---------- Map ----------");
+        for (Entry entry : objMap.entrySet()) {
+            System.out.println(entry);
+        }
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/json/gson/CollectionsSerialize.java b/Java基础教程/Java源代码/codedemo/json/gson/CollectionsSerialize.java
new file mode 100644
index 00000000..6f505372
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/json/gson/CollectionsSerialize.java
@@ -0,0 +1,54 @@
+package cn.aofeng.demo.json.gson;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import com.google.gson.Gson;
+
+/**
+ * 集合的序列化。
+ * 
+ * @author 聂勇
+ */
+public class CollectionsSerialize {
+
+    public void serialize(Collection c) {
+        Gson gson = new Gson();
+        System.out.println( gson.toJson(c) );
+    }
+    
+    public void serialize(Map map) {
+        Gson gson = new Gson();
+        System.out.println( gson.toJson(map) );
+    }
+    
+    public static void main(String[] args) {
+        CollectionsSerialize cs = new CollectionsSerialize();
+        
+        // 整型List
+        List intList = new ArrayList();
+        intList.add(9);
+        intList.add(8);
+        intList.add(0);
+        cs.serialize(intList);
+        
+        // 字符串Set
+        Set strSet = new HashSet();
+        strSet.add("Hello");
+        strSet.add("World");
+        strSet.add("Best");
+        cs.serialize(strSet);
+        
+        // Map
+        Map objMap = new HashMap();
+        objMap.put("marry", new Person("马丽", 20));
+        objMap.put("xiaomin", new Person("小明", 21));
+        cs.serialize(objMap);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/json/gson/CustomDeserialize.java b/Java基础教程/Java源代码/codedemo/json/gson/CustomDeserialize.java
new file mode 100644
index 00000000..8321f52f
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/json/gson/CustomDeserialize.java
@@ -0,0 +1,46 @@
+package cn.aofeng.demo.json.gson;
+
+import java.lang.reflect.Type;
+
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
+import com.google.gson.JsonDeserializationContext;
+import com.google.gson.JsonDeserializer;
+import com.google.gson.JsonElement;
+import com.google.gson.JsonObject;
+import com.google.gson.JsonParseException;
+
+/**
+ * 自定义反序列化。
+ * 
+ * @author 聂勇
+ */
+public class CustomDeserialize {
+
+    public static void main(String[] args) {
+        GsonBuilder builder = new GsonBuilder();
+        builder.registerTypeAdapter(Person.class, new PersonDeserializer());
+        Gson gson = builder.create();
+        
+        String json = "{\"PersonName\":\"aofeng\",\"PersonAge\":32}";
+        Person obj = gson.fromJson(json, Person.class);
+        System.out.println(obj); // 输出结果：Person [name=aofeng, age=32]
+    }
+
+    public static class PersonDeserializer implements JsonDeserializer {
+
+        @Override
+        public Person deserialize(JsonElement jsonEle, Type type,
+                JsonDeserializationContext context)
+                throws JsonParseException {
+            JsonObject jo = jsonEle.getAsJsonObject();
+            String name = jo.get("PersonName").getAsString();
+            int age = jo.get("PersonAge").getAsInt();
+            
+            Person obj = new Person(name, age);
+            return obj;
+        }
+        
+    } // end of PersonDeserializer
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/json/gson/CustomSerialize.java b/Java基础教程/Java源代码/codedemo/json/gson/CustomSerialize.java
new file mode 100644
index 00000000..4b41576d
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/json/gson/CustomSerialize.java
@@ -0,0 +1,42 @@
+package cn.aofeng.demo.json.gson;
+
+import java.lang.reflect.Type;
+
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
+import com.google.gson.JsonElement;
+import com.google.gson.JsonObject;
+import com.google.gson.JsonSerializationContext;
+import com.google.gson.JsonSerializer;
+
+/**
+ * 自定义序列化。
+ * 
+ * @author 聂勇
+ */
+public class CustomSerialize {
+
+    public static void main(String[] args) {
+        GsonBuilder builder = new GsonBuilder();
+        builder.registerTypeAdapter(Person.class, new PersonSerializer());
+        Gson gson = builder.create();
+        
+        Person obj = new Person("aofeng", 32);
+        System.out.println( gson.toJson(obj) ); // 输出结果：{"PersonName":"aofeng","PersonAge":32}
+    }
+
+    public static class PersonSerializer implements JsonSerializer {
+
+        @Override
+        public JsonElement serialize(Person obj, Type type,
+                JsonSerializationContext context) {
+            JsonObject jo = new JsonObject();
+            jo.addProperty("PersonName", obj.getName());
+            jo.addProperty("PersonAge", obj.getAge());
+            
+            return jo;
+        }
+        
+    } // end of PersonSerializer
+    
+}
diff --git a/Java基础教程/Java源代码/codedemo/json/gson/Person.java b/Java基础教程/Java源代码/codedemo/json/gson/Person.java
new file mode 100644
index 00000000..445adc7c
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/json/gson/Person.java
@@ -0,0 +1,50 @@
+package cn.aofeng.demo.json.gson;
+
+/**
+ * 简单的Java对象。
+ * 
+ * @author 聂勇
+ */
+public class Person {
+
+    private String name;
+    
+    private int age;
+
+    public Person() {
+        // nothing
+    }
+    
+    @SuppressWarnings("unused")
+    private void reset() {
+        name = null;
+        age = 0;
+    }
+    
+    public Person(String name, int age) {
+        this.name = name;
+        this.age = age;
+    }
+    
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public int getAge() {
+        return age;
+    }
+
+    public void setAge(int age) {
+        this.age = age;
+    }
+
+    @Override
+    public String toString() {
+        return "Person [name=" + name + ", age=" + age + "]";
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/json/gson/SimpleObjectSerialize.java b/Java基础教程/Java源代码/codedemo/json/gson/SimpleObjectSerialize.java
new file mode 100644
index 00000000..734692dd
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/json/gson/SimpleObjectSerialize.java
@@ -0,0 +1,39 @@
+package cn.aofeng.demo.json.gson;
+
+import com.google.gson.Gson;
+
+/**
+ * Java简单对象的序列化与反序列化。
+ * 
+ * @author 聂勇
+ */
+public class SimpleObjectSerialize {
+
+    /**
+     * 序列化：将Java对象转换成JSON字符串。
+     */
+    public void serialize(Person person) {
+        Gson gson = new Gson();
+        System.out.println( gson.toJson(person) );
+    }
+    
+    /**
+     * 反序列化：将JSON字符串转换成Java对象。
+     */
+    public void deserialize(String json) {
+        Gson gson = new Gson();
+        Person person = gson.fromJson(json, Person.class);
+        System.out.println( person );
+    }
+    
+    public static void main(String[] args) {
+        SimpleObjectSerialize ss = new SimpleObjectSerialize();
+        
+        Person person = new Person("NieYong", 33);
+        ss.serialize(person);
+        
+       String json = " {\"name\":\"AoFeng\",\"age\":32}";
+       ss.deserialize(json);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/misc/GetHostInfo.java b/Java基础教程/Java源代码/codedemo/misc/GetHostInfo.java
new file mode 100644
index 00000000..8c1aadd0
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/misc/GetHostInfo.java
@@ -0,0 +1,63 @@
+package cn.aofeng.demo.misc;
+
+import java.net.InetAddress;
+import java.net.NetworkInterface;
+import java.net.SocketException;
+import java.net.UnknownHostException;
+import java.util.Enumeration;
+import java.util.Map;
+import java.util.Map.Entry;
+import java.util.Properties;
+import java.util.Set;
+
+/**
+ * 获取本机IP和主机名以及Java环境信息。
+ * 
+ * @author 聂勇
+ */
+public class GetHostInfo {
+
+    /**
+     * @param args
+     * @throws UnknownHostException 
+     * @throws SocketException 
+     */
+    public static void main(String[] args) throws UnknownHostException, SocketException {
+        InetAddress address =  InetAddress.getLocalHost();
+        System.out.println("计算机名：" + address.getHostName());
+        Enumeration nis = NetworkInterface.getNetworkInterfaces();
+        while (nis.hasMoreElements()) {
+            StringBuilder buffer = new StringBuilder();
+            NetworkInterface ni = nis.nextElement();
+            buffer.append("网卡：").append(ni.getName());
+            buffer.append("    绑定IP：");
+            Enumeration ias = ni.getInetAddresses();
+            int count  = 0;
+            while (ias.hasMoreElements()) {
+                InetAddress ia = ias.nextElement();
+                if (count > 0) {
+                    buffer.append(", ");
+                }
+                buffer.append(ia.getHostAddress());
+            }
+            System.out.println(buffer.toString());
+        }
+        
+        System.out.println("Java环境信息:");
+        System.out.println("---------------------------------------------------:");
+        Properties pros = System.getProperties();
+        Set> javaEnums = pros.entrySet();
+        for (Entry entry : javaEnums) {
+            System.out.println(entry.getKey() + " : " + entry.getValue());
+        }
+        System.out.println("");
+        System.out.println("系统环境信息:");
+        System.out.println("---------------------------------------------------:");
+        Map envs = System.getenv();
+        Set> envSet = envs.entrySet();
+        for (Entry entry : envSet) {
+            System.out.println(entry.getKey() + " : " + entry.getValue());
+        }
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/mockito/Commodity.java b/Java基础教程/Java源代码/codedemo/mockito/Commodity.java
new file mode 100644
index 00000000..32d52a92
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/mockito/Commodity.java
@@ -0,0 +1,50 @@
+package cn.aofeng.demo.mockito;
+
+/**
+ * 商品信息。
+ * 
+ * @author 聂勇
+ */
+public class Commodity {
+
+    private String id;
+    
+    private String name;
+    
+    private int type;
+
+    public Commodity() {
+        // nothing
+    }
+    
+    public Commodity(String id, String name, int type) {
+        this.id = id;
+        this.name = name;
+        this.type = type;
+    }
+    
+    public String getId() {
+        return id;
+    }
+
+    public void setId(String id) {
+        this.id = id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public int getType() {
+        return type;
+    }
+
+    public void setType(int type) {
+        this.type = type;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/mockito/CommodityDao.java b/Java基础教程/Java源代码/codedemo/mockito/CommodityDao.java
new file mode 100644
index 00000000..b6ad73d3
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/mockito/CommodityDao.java
@@ -0,0 +1,20 @@
+package cn.aofeng.demo.mockito;
+
+import java.util.List;
+
+/**
+ * 商品存储层。
+ * 
+ * @author 聂勇
+ */
+public class CommodityDao {
+
+    public Commodity queryById(String id) {
+        return null;
+    }
+    
+    public List queryByType(int type) {
+        return null;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/mockito/User.java b/Java基础教程/Java源代码/codedemo/mockito/User.java
new file mode 100644
index 00000000..baade9fb
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/mockito/User.java
@@ -0,0 +1,70 @@
+package cn.aofeng.demo.mockito;
+
+/**
+ * 用户信息。
+ * 
+ * @author 聂勇
+ */
+public class User {
+
+    private long id;
+    
+    private String name;
+    
+    private int sex;
+    
+    private int age;
+    
+    private String address;
+
+    public User() {
+        // nothing
+    }
+    
+    public User(long userId, String userName, int age) {
+        this.id = userId;
+        this.name = userName;
+        this.age = age;
+    }
+    
+    public long getId() {
+        return id;
+    }
+
+    public void setId(long id) {
+        this.id = id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public int getSex() {
+        return sex;
+    }
+
+    public void setSex(int sex) {
+        this.sex = sex;
+    }
+
+    public int getAge() {
+        return age;
+    }
+
+    public void setAge(int age) {
+        this.age = age;
+    }
+
+    public String getAddress() {
+        return address;
+    }
+
+    public void setAddress(String address) {
+        this.address = address;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/mockito/UserDao.java b/Java基础教程/Java源代码/codedemo/mockito/UserDao.java
new file mode 100644
index 00000000..a7861670
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/mockito/UserDao.java
@@ -0,0 +1,19 @@
+package cn.aofeng.demo.mockito;
+
+import java.util.List;
+
+/**
+ * 用户信息存储层。
+ * 
+ * @author 聂勇
+ */
+public class UserDao {
+
+    public User queryById(long userId) {
+        return null;
+    }
+    
+    public List queryByName(String userName) {
+        return null;
+    }
+}
diff --git a/Java基础教程/Java源代码/codedemo/mockito/UserService.java b/Java基础教程/Java源代码/codedemo/mockito/UserService.java
new file mode 100644
index 00000000..c6ee66ba
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/mockito/UserService.java
@@ -0,0 +1,54 @@
+package cn.aofeng.demo.mockito;
+
+/**
+ * 用户服务。
+ * 
+ * @author 聂勇
+ */
+public class UserService {
+
+    /** 成人年龄分界线 */
+    private final static int ADULT_AGE = 18;
+    
+    private UserDao _userDao;
+    private CommodityDao _commodityDao;
+    
+    public boolean isAdult(long userId) {
+        User user = _userDao.queryById(userId);
+        if (null == user || user.getAge() < ADULT_AGE) {
+            return false;
+        }
+        
+        return true;
+    }
+    
+    public boolean buy(long userId, String commodityId) {
+        if (! isAdult(userId)) {
+            return false;
+        }
+        
+        Commodity commodity = _commodityDao.queryById(commodityId);
+        if (null == commodity) {
+            return false;
+        }
+        // 省略余下的处理逻辑
+        return true;
+    }
+    
+    public UserDao getUserDao() {
+        return _userDao;
+    }
+    
+    public void setUserDao(UserDao userDao) {
+        this._userDao = userDao;
+    }
+
+    public CommodityDao getCommodityDao() {
+        return _commodityDao;
+    }
+
+    public void setCommodityDao(CommodityDao commodityDao) {
+        this._commodityDao = commodityDao;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/mockito/UserServiceTest.java b/Java基础教程/Java源代码/codedemo/mockito/UserServiceTest.java
new file mode 100644
index 00000000..fd7009e2
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/mockito/UserServiceTest.java
@@ -0,0 +1,66 @@
+package cn.aofeng.demo.mockito;
+
+import static org.junit.Assert.*;
+
+import org.junit.Test;
+import static org.mockito.Mockito.*;
+
+/**
+ * {@link UserService}的单元测试用例。
+ * 
+ * @author 聂勇
+ */
+public class UserServiceTest {
+
+    private UserService _userService = new UserService();
+    
+    @Test
+    public void testIsAdult4UserExist() {
+        long userId = 123;
+        User user = new User(userId, "张三", 19);
+        
+        // 大于18岁的测试用例
+        UserDao daoMock = mock(UserDao.class);
+        when(daoMock.queryById(userId)).thenReturn(user); // 设置行为和对应的返回值
+        _userService.setUserDao(daoMock); // 设置mock
+        assertTrue(_userService.isAdult(userId)); // 校验结果
+        
+        // 等于18岁的测试用例
+        User user2 = new User(userId, "李四", 18);
+        when(daoMock.queryById(userId)).thenReturn(user2);
+        _userService.setUserDao(daoMock);
+        assertTrue(_userService.isAdult(userId));
+        
+        // 小于18岁的测试用例
+        User user3 = new User(userId, "王五", 17);
+        when(daoMock.queryById(userId)).thenReturn(user3);
+        _userService.setUserDao(daoMock);
+        assertFalse(_userService.isAdult(userId));
+    }
+
+    @Test
+    public void testIsAdult4UserNotExist() {
+        // 用户不存在的测试用例
+        long userId = 123;
+        UserDao daoMock = mock(UserDao.class);
+        when(daoMock.queryById(userId)).thenReturn(null); // 设置行为和对应的返回值
+        _userService.setUserDao(daoMock); // 设置mock
+        assertFalse(_userService.isAdult(userId)); // 校验结果
+    }
+
+    @Test
+    public void testBuy() {
+        long userId = 12345;
+        UserDao daoMock = mock(UserDao.class);
+        when(daoMock.queryById(anyLong())).thenReturn(new User(userId, "张三", 19));
+        
+        String commodityId = "S01A10009823";
+        CommodityDao commodityDao = mock(CommodityDao.class);
+        when(commodityDao.queryById(anyString())).thenReturn(new Commodity(commodityId, "xxx手机", 1));
+        
+        _userService.setUserDao(daoMock);
+        _userService.setCommodityDao(commodityDao);
+        assertTrue(_userService.buy(userId, commodityId));
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/mybatis/MyBatisClient.java b/Java基础教程/Java源代码/codedemo/mybatis/MyBatisClient.java
new file mode 100644
index 00000000..6b6f3f1f
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/mybatis/MyBatisClient.java
@@ -0,0 +1,62 @@
+package cn.aofeng.demo.mybatis;
+
+import java.io.IOException;
+import java.io.InputStream;
+
+import org.apache.ibatis.io.Resources;
+import org.apache.ibatis.session.SqlSessionFactory;
+import org.apache.ibatis.session.SqlSessionFactoryBuilder;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import cn.aofeng.demo.mybatis.dao.MonitNotifyHistoryDao;
+import cn.aofeng.demo.mybatis.entity.MonitNotifyHistory;
+
+/**
+ * 
+ * 
+ * @author 聂勇
+ */
+public class MyBatisClient {
+
+    private static Logger _logger = LoggerFactory.getLogger(MyBatisClient.class);
+    
+    public static void main(String[] args) throws IOException {
+        String resource = "mybatis-config.xml";
+        InputStream ins = Resources.getResourceAsStream(resource);
+        SqlSessionFactory ssFactory = new SqlSessionFactoryBuilder().build(ins);
+        MonitNotifyHistoryDao dao = new MonitNotifyHistoryDao(ssFactory);
+        
+        // 插入一条记录
+        long recordId = 999;
+        MonitNotifyHistory record = new MonitNotifyHistory();
+        record.setRecordId(recordId);
+        record.setMonitId(9999);
+        record.setAppId(99);
+        record.setNotifyTarget(1);
+        record.setNotifyType(1);
+        record.setNotifyContent("通知内容测试");
+        record.setStatus(0);
+        record.setCreateTime(1492061400000L);
+        int count = dao.insert(record);
+        _logger.info("insert complete, effects {} rows", count);
+        
+        // 查询记录
+        MonitNotifyHistory entity = dao.selectByPrimaryKey(recordId);
+        _logger.info("query record id {}, result: {}", recordId, entity);
+        
+        // 更新一个字段再执行查询
+        entity.setRetryTimes(99);
+        count = dao.updateByPrimaryKeySelective(entity);
+        _logger.info("update complete, record id:{}, effects {} rows", recordId, count);
+        entity = dao.selectByPrimaryKey(recordId);
+        _logger.info("query record id {}, result: {}", recordId, entity);
+        
+        // 删除记录后再执行查询
+        count = dao.deleteByPrimaryKey(recordId);
+        _logger.info("delete complete, record id {}, effects {} rows", recordId, count);
+        entity = dao.selectByPrimaryKey(recordId);
+        _logger.info("query record id {}, result: {}", recordId, entity);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/mybatis/README.md b/Java基础教程/Java源代码/codedemo/mybatis/README.md
new file mode 100644
index 00000000..e214deb3
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/mybatis/README.md
@@ -0,0 +1,5 @@
+* [MyBatisClien.java](MyBatisClient.java) 入口类。读取配置文件，生成SqlSessionFactory，使用DAO操作表。
+* [mybatis-config.xml](../../../../../conf/mybatis-config.xml)  mybatis配置文件
+* [MonitNotifyHistoryDao](dao/MonitNotifyHistoryDao.java) DAO类
+* [MonitNotifyHisto.java](entity/MonitNotifyHistory.java) 实体类
+* [MonitNotifyHistoryMapper.xml](mapper/MonitNotifyHistoryMapper.xml) SQL模板映射配置文件
diff --git a/Java基础教程/Java源代码/codedemo/mybatis/dao/MonitNotifyHistoryDao.java b/Java基础教程/Java源代码/codedemo/mybatis/dao/MonitNotifyHistoryDao.java
new file mode 100644
index 00000000..d549e879
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/mybatis/dao/MonitNotifyHistoryDao.java
@@ -0,0 +1,79 @@
+package cn.aofeng.demo.mybatis.dao;
+
+import org.apache.ibatis.session.SqlSession;
+import org.apache.ibatis.session.SqlSessionFactory;
+
+import cn.aofeng.demo.mybatis.entity.MonitNotifyHistory;
+
+/**
+ * 监控通知历史CURD。
+ * 
+ * @author 聂勇
+ */
+public class MonitNotifyHistoryDao {
+    
+    private SqlSessionFactory _ssFactory = null;
+    
+    public MonitNotifyHistoryDao(SqlSessionFactory factory) {
+        this._ssFactory = factory;
+    }
+
+    private String assembleStatement(String id) {
+        return "cn.aofeng.demo.mybatis.dao.MonitNotifyHistoryMapper."+id;
+    }
+    
+    private void close(SqlSession session) {
+        if (null != session) {
+            session.close();
+        }
+    }
+    
+    public int deleteByPrimaryKey(Long recordId) {
+        SqlSession session = _ssFactory.openSession(true);
+        int result = 0;
+        try {
+            session.delete(assembleStatement("deleteByPrimaryKey"), recordId);
+        } finally {
+            close(session);
+        }
+        
+        return result;
+    }
+
+    public int insert(MonitNotifyHistory record) {
+        SqlSession session = _ssFactory.openSession(true);
+        int result = 0;
+        try {
+            result = session.insert(assembleStatement("insertSelective"), record);
+        } finally {
+            close(session);
+        }
+        
+        return result;
+    }
+    
+    public MonitNotifyHistory selectByPrimaryKey(Long recordId) {
+        SqlSession session = _ssFactory.openSession();
+        MonitNotifyHistory result = null;
+        try {
+            result = session.selectOne(assembleStatement("selectByPrimaryKey"), recordId);
+        } finally {
+            close(session);
+        }
+        
+        return result;
+    }
+
+    public int updateByPrimaryKeySelective(MonitNotifyHistory record) {
+        SqlSession session = _ssFactory.openSession(true);
+        int result = 0;
+        try {
+            session.update(assembleStatement("updateByPrimaryKeySelective"), record);
+        } finally {
+            close(session);
+        }
+        
+        return result;
+    }
+
+}
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/mybatis/entity/MonitNotifyHistory.java b/Java基础教程/Java源代码/codedemo/mybatis/entity/MonitNotifyHistory.java
new file mode 100644
index 00000000..2bae4f51
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/mybatis/entity/MonitNotifyHistory.java
@@ -0,0 +1,105 @@
+package cn.aofeng.demo.mybatis.entity;
+
+/**
+ * 监控通知历史实体类。 
+ * 
+ * @author 聂勇
+ */
+public class MonitNotifyHistory {
+    private Long recordId;
+
+    private Integer monitId;
+
+    private Integer appId;
+
+    private Integer notifyType;
+
+    private Integer notifyTarget;
+
+    private String notifyContent;
+
+    private Integer status;
+
+    private Integer retryTimes;
+
+    private Long createTime;
+
+    public Long getRecordId() {
+        return recordId;
+    }
+
+    public void setRecordId(Long recordId) {
+        this.recordId = recordId;
+    }
+
+    public Integer getMonitId() {
+        return monitId;
+    }
+
+    public void setMonitId(Integer monitId) {
+        this.monitId = monitId;
+    }
+
+    public Integer getAppId() {
+        return appId;
+    }
+
+    public void setAppId(Integer appId) {
+        this.appId = appId;
+    }
+
+    public Integer getNotifyType() {
+        return notifyType;
+    }
+
+    public void setNotifyType(Integer notifyType) {
+        this.notifyType = notifyType;
+    }
+
+    public Integer getNotifyTarget() {
+        return notifyTarget;
+    }
+
+    public void setNotifyTarget(Integer notifyTarget) {
+        this.notifyTarget = notifyTarget;
+    }
+
+    public String getNotifyContent() {
+        return notifyContent;
+    }
+
+    public void setNotifyContent(String notifyContent) {
+        this.notifyContent = notifyContent;
+    }
+
+    public Integer getStatus() {
+        return status;
+    }
+
+    public void setStatus(Integer status) {
+        this.status = status;
+    }
+
+    public Integer getRetryTimes() {
+        return retryTimes;
+    }
+
+    public void setRetryTimes(Integer retryTimes) {
+        this.retryTimes = retryTimes;
+    }
+
+    public Long getCreateTime() {
+        return createTime;
+    }
+
+    public void setCreateTime(Long createTime) {
+        this.createTime = createTime;
+    }
+
+    @Override
+    public String toString() {
+        return "MonitNotifyHistory [recordId=" + recordId + ", monitId=" + monitId + ", appId=" + appId + ", notifyType=" + notifyType + ", notifyTarget="
+                + notifyTarget + ", notifyContent=" + notifyContent + ", status=" + status + ", retryTimes=" + retryTimes + ", createTime=" + createTime + "]";
+    }
+
+}
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/mybatis/mapper/MonitNotifyHistoryMapper.xml b/Java基础教程/Java源代码/codedemo/mybatis/mapper/MonitNotifyHistoryMapper.xml
new file mode 100644
index 00000000..e6ac6884
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/mybatis/mapper/MonitNotifyHistoryMapper.xml
@@ -0,0 +1,139 @@
+
+
+
+  
+    
+    
+    
+    
+    
+    
+    
+    
+    
+  
+
+  
+  
+    delete from monit_notify_history
+    where record_id = #{recordId,jdbcType=BIGINT}
+  
+  
+    insert into monit_notify_history (record_id, monit_id, app_id, 
+      notify_type, notify_target, notify_content, 
+      status, retry_times, create_time
+      )
+    values (#{recordId,jdbcType=BIGINT}, #{monitId,jdbcType=INTEGER}, #{appId,jdbcType=TINYINT}, 
+      #{notifyType,jdbcType=TINYINT}, #{notifyTarget,jdbcType=INTEGER}, #{notifyContent,jdbcType=VARCHAR}, 
+      #{status,jdbcType=TINYINT}, #{retryTimes,jdbcType=TINYINT}, #{createTime,jdbcType=BIGINT}
+      )
+  
+  
+    insert into monit_notify_history
+    
+      
+        record_id,
+      
+      
+        monit_id,
+      
+      
+        app_id,
+      
+      
+        notify_type,
+      
+      
+        notify_target,
+      
+      
+        notify_content,
+      
+      
+        status,
+      
+      
+        retry_times,
+      
+      
+        create_time,
+      
+    
+    
+      
+        #{recordId,jdbcType=BIGINT},
+      
+      
+        #{monitId,jdbcType=INTEGER},
+      
+      
+        #{appId,jdbcType=TINYINT},
+      
+      
+        #{notifyType,jdbcType=TINYINT},
+      
+      
+        #{notifyTarget,jdbcType=INTEGER},
+      
+      
+        #{notifyContent,jdbcType=VARCHAR},
+      
+      
+        #{status,jdbcType=TINYINT},
+      
+      
+        #{retryTimes,jdbcType=TINYINT},
+      
+      
+        #{createTime,jdbcType=BIGINT},
+      
+    
+  
+  
+    update monit_notify_history
+    
+      
+        monit_id = #{monitId,jdbcType=INTEGER},
+      
+      
+        app_id = #{appId,jdbcType=TINYINT},
+      
+      
+        notify_type = #{notifyType,jdbcType=TINYINT},
+      
+      
+        notify_target = #{notifyTarget,jdbcType=INTEGER},
+      
+      
+        notify_content = #{notifyContent,jdbcType=VARCHAR},
+      
+      
+        status = #{status,jdbcType=TINYINT},
+      
+      
+        retry_times = #{retryTimes,jdbcType=TINYINT},
+      
+      
+        create_time = #{createTime,jdbcType=BIGINT},
+      
+    
+    where record_id = #{recordId,jdbcType=BIGINT}
+  
+  
+    update monit_notify_history
+    set monit_id = #{monitId,jdbcType=INTEGER},
+      app_id = #{appId,jdbcType=TINYINT},
+      notify_type = #{notifyType,jdbcType=TINYINT},
+      notify_target = #{notifyTarget,jdbcType=INTEGER},
+      notify_content = #{notifyContent,jdbcType=VARCHAR},
+      status = #{status,jdbcType=TINYINT},
+      retry_times = #{retryTimes,jdbcType=TINYINT},
+      create_time = #{createTime,jdbcType=BIGINT}
+    where record_id = #{recordId,jdbcType=BIGINT}
+  
+
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/netty40x/echo/EchoClient.java b/Java基础教程/Java源代码/codedemo/netty40x/echo/EchoClient.java
new file mode 100644
index 00000000..734887e1
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/netty40x/echo/EchoClient.java
@@ -0,0 +1,55 @@
+package cn.aofeng.demo.netty40x.echo;
+
+import io.netty.bootstrap.Bootstrap;
+import io.netty.channel.ChannelFuture;
+import io.netty.channel.ChannelOption;
+import io.netty.channel.EventLoopGroup;
+import io.netty.channel.nio.NioEventLoopGroup;
+import io.netty.channel.socket.nio.NioSocketChannel;
+
+import org.apache.commons.lang.math.NumberUtils;
+import org.apache.log4j.Logger;
+
+/**
+ * Echo客户端。
+ * 
+ * @author 聂勇
+ */
+public class EchoClient {
+
+    private static Logger _logger = Logger.getLogger(EchoClient.class);
+    
+    public void start(String host, int port) {
+        EventLoopGroup worker = new NioEventLoopGroup(1);
+        Bootstrap bootstrap = new Bootstrap();
+        try {
+            bootstrap.group(worker)
+                .channel(NioSocketChannel.class)
+                .option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 1000)
+                .handler(new EchoClientHandler())
+                .remoteAddress(host, port);
+            ChannelFuture cf = bootstrap.connect().sync();
+            cf.channel().closeFuture().sync();
+        } catch (Exception e) {
+            _logger.error("occurs error", e);
+        } finally {
+            worker.shutdownGracefully();
+        }
+    }
+    
+    /**
+     * @param args
+     */
+    public static void main(String[] args) {
+        if (args.length != 2) {
+            _logger.error("Invalid arguments。Usage：java cn.aofeng.demo.netty40x.echo.EchoClient 192.168.56.102 8080");
+            System.exit(-1);
+        }
+        
+        String host = args[0];
+        int port = NumberUtils.toInt(args[1], 8080);
+        EchoClient client = new EchoClient();
+        client.start(host, port);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/netty40x/echo/EchoClientHandler.java b/Java基础教程/Java源代码/codedemo/netty40x/echo/EchoClientHandler.java
new file mode 100644
index 00000000..f2700c41
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/netty40x/echo/EchoClientHandler.java
@@ -0,0 +1,49 @@
+package cn.aofeng.demo.netty40x.echo;
+
+import java.nio.charset.Charset;
+import java.text.DateFormat;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+
+import org.apache.log4j.Logger;
+
+import io.netty.buffer.ByteBuf;
+import io.netty.buffer.Unpooled;
+import io.netty.channel.ChannelHandlerContext;
+import io.netty.channel.ChannelInboundHandlerAdapter;
+import io.netty.util.CharsetUtil;
+
+/**
+ * 发送数据给服务端，并接收服务端的数据。
+ * 
+ * @author 聂勇
+ */
+public class EchoClientHandler extends ChannelInboundHandlerAdapter {
+
+    private static Logger _logger = Logger.getLogger(EchoClientHandler.class);
+    
+    private final Charset _utf8 = CharsetUtil.UTF_8;
+    
+    public void channelActive(ChannelHandlerContext ctx) {
+        DateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss.SSSZ");
+        String currTimeStr = format.format(new Date());
+        String data = String.format("Hello, current time is %s", currTimeStr);
+        ctx.writeAndFlush( Unpooled.copiedBuffer(data, _utf8) );
+        _logger.info( String.format("Client send data:%s", data) );
+    }
+    
+    public void channelRead(ChannelHandlerContext ctx, Object msg) {
+        ByteBuf inData = (ByteBuf) msg;
+        _logger.info( String.format("Client receive data:%s",  inData.toString(_utf8)) );
+    }
+    
+    public void channelReadComplete(ChannelHandlerContext ctx) {
+        ctx.close();
+    }
+    
+    public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) {
+        _logger.error("occurs error", cause);
+        ctx.close();
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/netty40x/echo/EchoServer.java b/Java基础教程/Java源代码/codedemo/netty40x/echo/EchoServer.java
new file mode 100644
index 00000000..dec241aa
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/netty40x/echo/EchoServer.java
@@ -0,0 +1,58 @@
+package cn.aofeng.demo.netty40x.echo;
+
+import io.netty.bootstrap.ServerBootstrap;
+import io.netty.channel.ChannelFuture;
+import io.netty.channel.ChannelOption;
+import io.netty.channel.EventLoopGroup;
+import io.netty.channel.nio.NioEventLoopGroup;
+import io.netty.channel.socket.nio.NioServerSocketChannel;
+
+import org.apache.commons.lang.math.NumberUtils;
+import org.apache.log4j.Logger;
+
+/**
+ * Echo服务端：将客户端发送的请求原样返回。
+ * 
+ * @author 聂勇
+ */
+public class EchoServer {
+
+    private static Logger _logger = Logger.getLogger(EchoServer.class);
+    
+    public void start(int port) {
+        EventLoopGroup boss = new NioEventLoopGroup(1);
+        EventLoopGroup worker = new NioEventLoopGroup(10);
+        ServerBootstrap bootstrap = new ServerBootstrap();
+        try {
+            bootstrap.group(boss, worker)
+                .channel(NioServerSocketChannel.class)
+                .option(ChannelOption.SO_BACKLOG, 128)
+                .childHandler(new EchoServerHandler())
+                .localAddress(port);
+            ChannelFuture bindFuture = bootstrap.bind().sync();
+            ChannelFuture closeFuture = bindFuture.channel().closeFuture().sync();
+            _logger.info( String.format("%s started and listen on %s", this.getClass().getSimpleName(), closeFuture ) );
+        } catch(Exception ex) {
+            _logger.info( String.format("%s start failed", this.getClass().getSimpleName()), ex);
+        } finally {
+            boss.shutdownGracefully();
+            worker.shutdownGracefully();
+        }
+        
+    }
+    
+    /**
+     * @param args
+     */
+    public static void main(String[] args) {
+        if (args.length != 1) {
+            _logger.error("Invalid arguments。Usage：java cn.aofeng.demo.netty40x.echo.EchoServer 8080");
+            System.exit(-1);
+        }
+        
+        int port = NumberUtils.toInt(args[0], 8080);
+        EchoServer server = new EchoServer();
+        server.start(port);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/netty40x/echo/EchoServerHandler.java b/Java基础教程/Java源代码/codedemo/netty40x/echo/EchoServerHandler.java
new file mode 100644
index 00000000..4b0f5968
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/netty40x/echo/EchoServerHandler.java
@@ -0,0 +1,38 @@
+package cn.aofeng.demo.netty40x.echo;
+
+import java.nio.charset.Charset;
+
+import org.apache.log4j.Logger;
+
+import io.netty.buffer.ByteBuf;
+import io.netty.channel.ChannelHandlerContext;
+import io.netty.channel.ChannelInboundHandlerAdapter;
+import io.netty.channel.ChannelHandler.Sharable;
+
+/**
+ * 将接收到的数据原样返回给发送方。
+ * 
+ * @author 聂勇
+ */
+@Sharable
+public class EchoServerHandler extends ChannelInboundHandlerAdapter {
+
+    private static Logger _logger = Logger.getLogger(EchoServerHandler.class);
+    
+    public void channelRead(ChannelHandlerContext ctx, Object msg) {
+        ByteBuf inData = (ByteBuf) msg;
+        String str = inData.toString(Charset.forName("UTF-8"));
+        _logger.info( String.format("Server receive data:%s", str) );
+        ctx.write(inData);
+    }
+
+    public void channelReadComplete(ChannelHandlerContext ctx) {
+        ctx.flush().close();
+    }
+
+    public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) {
+        _logger.error("occurs error", cause);
+        ctx.close();
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/nio/BufferIO.java b/Java基础教程/Java源代码/codedemo/nio/BufferIO.java
new file mode 100644
index 00000000..29c1c8da
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/nio/BufferIO.java
@@ -0,0 +1,61 @@
+package cn.aofeng.demo.nio;
+
+import java.io.Closeable;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileNotFoundException;
+import java.io.IOException;
+import java.nio.ByteBuffer;
+import java.nio.channels.FileChannel;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ * IO-缓冲区操作。
+ * 
+ * @author 聂勇 aofengblog@163.com
+ */
+public class BufferIO {
+
+    private static Logger logger = Logger.getLogger("bufferio");
+    
+    // 缓冲区大小
+    private final static int BUFFER_SIZE = 4096;
+    
+    public static void close(Closeable c) {
+        if (null != c) {
+            try {
+                c.close();
+            } catch (IOException e) {
+                // ingore
+            }
+        }
+    }
+    
+    /**
+     * @param args [0]：读取文件的完整路径
+     */
+    public static void main(String[] args) {
+        String filename = args[0];
+        File file = new File(filename);
+        FileChannel channel = null;
+        try {
+            channel = new FileInputStream(file).getChannel();
+            ByteBuffer buffer = ByteBuffer.allocate(BUFFER_SIZE);
+            long startTime = System.currentTimeMillis();
+            while (channel.read(buffer) > 0) {
+                buffer.flip();
+                buffer.clear();
+            }
+            long endTime = System.currentTimeMillis();
+            logger.info("缓冲区读取文件耗时：" + (endTime-startTime)+"毫秒");
+        } catch (FileNotFoundException e) {
+            logger.log(Level.SEVERE, "找不到文件："+filename, e);
+        } catch (IOException e) {
+            logger.log(Level.SEVERE, "读取文件出错", e);
+        } finally{
+            close(channel);
+        }
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/nio/MemoryMapper.java b/Java基础教程/Java源代码/codedemo/nio/MemoryMapper.java
new file mode 100644
index 00000000..f3de00a9
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/nio/MemoryMapper.java
@@ -0,0 +1,73 @@
+package cn.aofeng.demo.nio;
+
+import java.io.Closeable;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileNotFoundException;
+import java.io.IOException;
+import java.nio.MappedByteBuffer;
+import java.nio.channels.FileChannel;
+import java.nio.channels.FileChannel.MapMode;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ * IO-内存映射。
+ * 
+ * @author 聂勇 aofengblog@163.com
+ */
+public class MemoryMapper {
+
+    private static Logger logger = Logger.getLogger("bufferio");
+    
+    // 缓冲区大小
+    private final static int BUFFER_SIZE = 4096;
+    
+    public static void close(Closeable c) {
+        if (null != c) {
+            try {
+                c.close();
+            } catch (IOException e) {
+                // ingore
+            }
+        }
+    }
+    
+    /**
+     * @param args [0]：读取文件的完整路径
+     */
+    public static void main(String[] args) {
+        String filename = args[0];
+        File file = new File(filename);
+        FileChannel channel = null;
+        try {
+            channel = new FileInputStream(file).getChannel();
+             MappedByteBuffer buffer = channel.map(MapMode.READ_ONLY, 0, channel.size());
+             long startTime = System.currentTimeMillis();
+             long total = 0;
+             long len = file.length();
+             byte[] bs = new byte[BUFFER_SIZE];
+             for (int index = 0; index < len; index+=BUFFER_SIZE) {
+                 int readSize = BUFFER_SIZE;
+                 if (len-index < BUFFER_SIZE) {
+                    readSize = (int) len-index;
+                    buffer.get(new byte[readSize]);
+                 } else {
+                    buffer.get(bs);
+                 }
+                 
+                 total += readSize;
+             }
+             long endTime = System.currentTimeMillis();
+             logger.info("内存映射读取文件耗时：" + (endTime-startTime)+"毫秒，文件长度："+total+"字节");
+        } catch (FileNotFoundException e) {
+            logger.log(Level.SEVERE, "找不到文件："+filename, e);
+        } catch (IOException e) {
+            logger.log(Level.SEVERE, "读取文件出错", e);
+        } finally{
+            close(channel);
+        }
+        
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/nio/NioEchoServer.java b/Java基础教程/Java源代码/codedemo/nio/NioEchoServer.java
new file mode 100644
index 00000000..95e21915
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/nio/NioEchoServer.java
@@ -0,0 +1,296 @@
+package cn.aofeng.demo.nio;
+
+import java.io.IOException;
+import java.io.UnsupportedEncodingException;
+import java.net.InetSocketAddress;
+import java.net.ServerSocket;
+import java.nio.ByteBuffer;
+import java.nio.channels.ClosedChannelException;
+import java.nio.channels.SelectionKey;
+import java.nio.channels.Selector;
+import java.nio.channels.ServerSocketChannel;
+import java.nio.channels.SocketChannel;
+import java.util.Arrays;
+import java.util.Iterator;
+import java.util.Set;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ * 用NIO实现的Echo Server。
+ * @author 聂勇 aofengblog@163.com
+ */
+public class NioEchoServer {
+    
+    private final static Logger logger = Logger.getLogger(NioEchoServer.class.getName());
+    
+    // 换行符
+    public final static char CR = '\r';
+    
+    // 回车符
+    public final static char LF = '\n';
+    
+    /**
+     * @return 当前系统的行结束符
+     */
+    private static String getLineEnd() {
+        return System.getProperty("line.separator");
+    }
+    
+    /**
+     * 重置缓冲区状态标志位：position设置为0，limit设置为capacity的值，所有mark无效。
+     * 注：缓冲区原来的内容还在，并没有清除。
+     * 
+     * @param buffer 字节缓冲区
+     */
+    private static void clear(ByteBuffer buffer) {
+        if (null != buffer) {
+            buffer.clear();
+        }
+    }
+    
+    /**
+     * 将字节缓冲区的每一个字节转换成ASCII字符。
+     * @param buffer 字节缓冲区
+     * @return 转换后的字节数组字符串
+     */
+    private static String toDisplayChar(ByteBuffer buffer) {
+        if (null == buffer) {
+            return "null";
+        }
+        
+        return Arrays.toString(buffer.array());
+    }
+    
+    /**
+     * 将字节缓冲区用utf8编码，转换成字符串。
+     * 
+     * @param buffer　字节缓冲区
+     * @return utf8编码转换的字符串
+     * @throws UnsupportedEncodingException
+     */
+    private static String convert2String(ByteBuffer buffer) throws UnsupportedEncodingException {
+        return new String(buffer.array(), "utf8");
+    }
+    
+    /**
+     * 去掉尾末的行结束符（\r\n），并转换成字符串。
+     * 
+     * @param buffer 字节缓冲区
+     * @return 返回去掉行结束符后的字符串。
+     * @throws UnsupportedEncodingException
+     * @see #convert2String(ByteBuffer)
+     */
+    private static String getLineContent(ByteBuffer buffer) throws UnsupportedEncodingException {
+        if (null == buffer) {
+            return null;
+        }
+        
+        byte[] result = new byte[buffer.limit()-2];
+        System.arraycopy(buffer.array(), 0, result, 0, result.length);
+        return convert2String(ByteBuffer.wrap(result));
+    }
+    
+    /**
+     * 顺序合并两个{@link ByteBuffer}的内容，且不改变{@link ByteBuffer}原来的标志位。即：
+     * 
+     * 合并后的ByteBuffer = first + second
+     * 

+     * @param first 第一个待合并的{@link ByteBuffer}，合并后其内容在前面
+     * @param second 第二个待合并的{@link ByteBuffer}，合并后其内容在后面
+     * @return 合并后的内容。如果两个{@link ByteBuffer}都为null，返回null。
+     */
+    private static ByteBuffer merge(ByteBuffer first, ByteBuffer second) {
+        if (null == first && null == second) {
+            return null;
+        }
+        
+        int oneSize = null != first ? first.limit() : 0;
+        int twoSize = null != second ? second.limit() : 0;
+        ByteBuffer result = ByteBuffer.allocate(oneSize+twoSize);
+        if (null != first) {
+            result.put(Arrays.copyOfRange(first.array(), 0, oneSize));
+        }
+        if (null != second) {
+            result.put(Arrays.copyOfRange(second.array(), 0, twoSize));
+        }
+        result.rewind();
+        
+        return result;
+    }
+    
+    /**
+     * 从字节缓冲区中获取"一行"，即获取包括行结束符及其前面的内容。
+     * 
+     * @param buffer 输入缓冲区
+     * @return 有遇到行结束符，返回包括行结束符在内的字节缓冲区；否则返回null。
+     */
+    private static ByteBuffer getLine(ByteBuffer buffer) {
+        int index = 0;
+        boolean findCR = false;
+        int len = buffer.limit();
+        while(index < len) {
+            index ++;
+            
+            byte temp = buffer.get();
+            if (CR == temp) {
+                findCR = true;
+            }
+            if (LF == temp && findCR && index > 0) { // 找到了行结束符
+                byte[] copy = new byte[index];
+                System.arraycopy(buffer.array(), 0, copy, 0, index);
+                buffer.rewind(); // 位置复原
+                return ByteBuffer.wrap(copy);
+            }
+        }
+        buffer.rewind(); // 位置复原
+        
+        return null;
+    }
+    
+    private static void readData(Selector selector, SelectionKey selectionKey) throws IOException {
+        SocketChannel socketChannel = (SocketChannel) selectionKey.channel();
+        
+        // 获取上次已经读取的数据
+        ByteBuffer oldBuffer = (ByteBuffer) selectionKey.attachment();
+        if (logger.isLoggable(Level.FINE)) {
+            logger.fine("上一次读取的数据："+oldBuffer+getLineEnd()+toDisplayChar(oldBuffer));
+        }
+        
+        // 读新的数据
+        int readNum = 0;
+        ByteBuffer newBuffer = ByteBuffer.allocate(1024);
+        if ( (readNum = socketChannel.read(newBuffer)) <= 0 ) {
+            return;
+        }
+        if (logger.isLoggable(Level.FINE)) {
+            logger.fine("这次读取的数据："+newBuffer+getLineEnd()+toDisplayChar(newBuffer));
+        }
+        
+        newBuffer.flip();
+        ByteBuffer lineRemain = getLine(newBuffer);
+        if (logger.isLoggable(Level.FINE)) {
+            logger.fine("解析的行数据剩余部分："+lineRemain+getLineEnd()+toDisplayChar(lineRemain));
+        }
+        if (null != lineRemain) { // 获取到行结束符
+            ByteBuffer completeLine = merge(oldBuffer, lineRemain);
+            if (logger.isLoggable(Level.FINE)) {
+                logger.fine("准备输出的数据："+completeLine+getLineEnd()+toDisplayChar(completeLine));
+            }
+            while (completeLine.hasRemaining()) { // 有可能一次没有写完，需多次写
+                socketChannel.write(completeLine);
+            }
+            
+            // 清除数据
+            selectionKey.attach(null);
+            clear(oldBuffer);
+            clear(lineRemain);
+            
+            // 判断是否退出
+            String lineStr = getLineContent(completeLine);
+            if (logger.isLoggable(Level.FINE)) {
+                logger.fine("判断是否退出的行数据："+lineStr);
+            }
+            if ("exit".equalsIgnoreCase(lineStr) || "quit".equalsIgnoreCase(lineStr)) {
+                socketChannel.close();
+            }
+            
+            // FIXME 行结束符后面是否还有数据？ 此部分代码尚未测试
+            if (lineRemain.limit()+2 < newBuffer.limit()) {
+                byte[] temp = new byte[newBuffer.limit() - lineRemain.limit()];
+                newBuffer.get(temp, lineRemain.limit(), temp.length);
+                
+                selectionKey.attach(temp);
+            }
+        } else { // 没有读到一个完整的行，继续读并且带上已经读取的部分数据
+            ByteBuffer temp = merge(oldBuffer, newBuffer);
+            socketChannel.register(selector, SelectionKey.OP_READ, temp); 
+            
+            if (logger.isLoggable(Level.FINE)) {
+                logger.fine("暂存到SelectionKey的数据："+temp+getLineEnd()+toDisplayChar(temp));
+            }
+        }
+    }
+
+    /**
+     * 接受新的Socket连接。
+     * 
+     * @param selector 选择器
+     * @param selectionKey 
+     * @return
+     * @throws IOException
+     * @throws ClosedChannelException
+     */
+    private static SocketChannel acceptNew(Selector selector,
+            SelectionKey selectionKey) throws IOException,
+            ClosedChannelException {
+        ServerSocketChannel server = (ServerSocketChannel) selectionKey.channel();
+        SocketChannel socketChannel = server.accept();
+        if (null != socketChannel) {
+            if (logger.isLoggable(Level.INFO)) {
+                logger.info("收到一个新的连接，客户端IP："+socketChannel.socket().getInetAddress().getHostAddress()+"，客户端Port："+socketChannel.socket().getPort());
+            }
+            socketChannel.configureBlocking(false);
+            socketChannel.register(selector, SelectionKey.OP_READ);
+        }
+        
+        return socketChannel;
+    }
+    
+    /**
+     * 启动服务器。
+     * 
+     * @param port 服务监听的端口
+     * @param selectTimeout {@link Selector}检查通道就绪状态的超时时间（单位：毫秒）
+     */
+    private static void startServer(int port, int selectTimeout) {
+        ServerSocketChannel serverChannel = null;
+        try {
+            serverChannel = ServerSocketChannel.open();
+            serverChannel.configureBlocking(false);
+            ServerSocket serverSocket = serverChannel.socket();
+            serverSocket.bind(new InetSocketAddress(port));
+            if (logger.isLoggable(Level.INFO)) {
+                logger.info("NIO echo网络服务启动完毕，监听端口：" +port);
+            }
+            
+            Selector selector = Selector.open();
+            serverChannel.register(selector, SelectionKey.OP_ACCEPT);
+            
+            while (true) {
+                int selectNum = selector.select(selectTimeout);
+                if (0 == selectNum) {
+                    continue;
+                }
+                
+                Set selectionKeys = selector.selectedKeys();
+                Iterator it = selectionKeys.iterator();
+                while (it.hasNext()) {
+                    SelectionKey selectionKey = (SelectionKey) it.next();
+                    
+                    // 接受新的Socket连接
+                    if (selectionKey.isAcceptable()) {
+                        acceptNew(selector, selectionKey);
+                    }
+                    
+                    // 读取并处理Socket的数据
+                    if (selectionKey.isReadable()) {
+                        readData(selector, selectionKey);
+                    }
+                    
+                    it.remove();
+                } // end of while iterator
+            }
+        } catch (IOException e) {
+            logger.log(Level.SEVERE, "处理网络连接出错", e);
+        }
+    }
+    
+    public static void main(String[] args) {
+        int port = 9090;
+        int selectTimeout = 1000;
+        
+        startServer(port, selectTimeout);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/proxy/AccountService.java b/Java基础教程/Java源代码/codedemo/proxy/AccountService.java
new file mode 100644
index 00000000..83c8f217
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/proxy/AccountService.java
@@ -0,0 +1,27 @@
+package cn.aofeng.demo.proxy;
+
+/**
+ * 账号服务接口定义。
+ * 
+ * @author 聂勇
+ */
+public interface AccountService {
+
+    /**
+     * 注册。
+     * 
+     * @param username 账号名
+     * @return 具体含义查看{@link Result}的说明。
+     */
+    Result register(String username);
+    
+    /**
+     * 登录。
+     * 
+     * @param username 账号名
+     * @param password 密码
+     * @return 具体含义查看{@link Result}的说明。
+     */
+    Result login(String username, String password);
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/proxy/AccountServiceClient.java b/Java基础教程/Java源代码/codedemo/proxy/AccountServiceClient.java
new file mode 100644
index 00000000..946409ac
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/proxy/AccountServiceClient.java
@@ -0,0 +1,28 @@
+package cn.aofeng.demo.proxy;
+
+/**
+ * 代理调用示例。
+ * 
+ * @author 聂勇
+ */
+public class AccountServiceClient {
+
+    public static void main(String[] args) {
+        AccountService as = new AccountServiceImpl();
+        
+        // 静态代理
+        AccountService staticProxy = new AccountServiceStaticProxy(as);
+        staticProxy.register(null);
+        staticProxy.register("A0001");
+        staticProxy.login(null, null);
+        staticProxy.login("A0001", "PWD0001");
+        
+        // 动态代理
+        AccountService dynamicProxy = AccountServiceDynamicProxy.newInstance(as);
+        dynamicProxy.register(null);
+        dynamicProxy.register("A0001");
+        dynamicProxy.login(null, null);
+        dynamicProxy.login("A0001", "PWD0001");
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/proxy/AccountServiceDynamicProxy.java b/Java基础教程/Java源代码/codedemo/proxy/AccountServiceDynamicProxy.java
new file mode 100644
index 00000000..562543c4
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/proxy/AccountServiceDynamicProxy.java
@@ -0,0 +1,42 @@
+package cn.aofeng.demo.proxy;
+
+import java.lang.reflect.InvocationHandler;
+import java.lang.reflect.Method;
+import java.lang.reflect.Proxy;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * 账号服务动态代理。
+ * 
+ * @author 聂勇
+ */
+public class AccountServiceDynamicProxy implements InvocationHandler {
+
+    private final static Logger _LOGGER = LoggerFactory.getLogger(AccountServiceDynamicProxy.class);
+    
+    private AccountService _accountService;
+    
+    public AccountServiceDynamicProxy(AccountService accountService) {
+        this._accountService = accountService;
+    }
+    
+    @Override
+    public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
+        _LOGGER.debug("execute method {}, arguments: {}", method.getName(), args);
+        Object result = method.invoke(_accountService, args);
+        _LOGGER.debug("execute method {}, result:{}", method.getName(), result);
+        
+        return result;
+    }
+    
+    public static AccountService newInstance(AccountService accountService) {
+        ClassLoader loader = accountService.getClass().getClassLoader();
+        Class[] interfaces = accountService.getClass().getInterfaces();
+        
+        return (AccountService) Proxy.newProxyInstance(loader, 
+                interfaces, 
+                new AccountServiceDynamicProxy(accountService));
+    }
+}
diff --git a/Java基础教程/Java源代码/codedemo/proxy/AccountServiceImpl.java b/Java基础教程/Java源代码/codedemo/proxy/AccountServiceImpl.java
new file mode 100644
index 00000000..f527efc7
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/proxy/AccountServiceImpl.java
@@ -0,0 +1,53 @@
+package cn.aofeng.demo.proxy;
+
+import java.util.Random;
+
+import wiremock.org.apache.commons.lang.StringUtils;
+
+/**
+ * 
+ * 
+ * @author 聂勇
+ */
+public class AccountServiceImpl implements AccountService {
+
+    private final static Random NUM = new Random(System.currentTimeMillis());
+    
+    @Override
+    public Result register(String username) {
+        if (StringUtils.isBlank(username)) {
+            return createResult(4000001, "注册失败");
+        }
+        
+        User user = new User();
+        user.setUid(NUM.nextInt());
+        user.setNickname("用户"+user.getUid());
+        return createResult(2000001, "注册成功", user);
+    }
+
+    @Override
+    public Result login(String username, String password) {
+        if (StringUtils.isBlank(username) || StringUtils.isBlank(password)) {
+            return createResult(4000001, "登录失败");
+        }
+        
+        User user = new User();
+        user.setUid(NUM.nextInt());
+        user.setNickname("用户"+user.getUid());
+        return createResult(2000001, "登录成功", user);
+    }
+
+    private Result createResult(int code, String msg) {
+        Result result = new Result(code, msg);
+                
+        return result;
+    }
+
+    private Result createResult(int code, String msg, User user) {
+        Result result = new Result(code, msg);
+        result.setData(user);
+                
+        return result;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/proxy/AccountServiceStaticProxy.java b/Java基础教程/Java源代码/codedemo/proxy/AccountServiceStaticProxy.java
new file mode 100644
index 00000000..9705868b
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/proxy/AccountServiceStaticProxy.java
@@ -0,0 +1,39 @@
+package cn.aofeng.demo.proxy;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * {@link AccountServiceImpl}的代理类，增加了输出入参和响应的日志。
+ * 
+ * @author 聂勇
+ */
+public class AccountServiceStaticProxy implements AccountService {
+
+    private AccountService _delegate;
+    
+    private final static Logger _LOGGER = LoggerFactory.getLogger(AccountServiceStaticProxy.class);
+    
+    public AccountServiceStaticProxy(AccountService accountService) {
+        this._delegate = accountService;
+    }
+    
+    @Override
+    public Result register(String username) {
+        _LOGGER.debug("execute method register, arguments: username={}", username);
+        Result result = _delegate.register(username);
+        _LOGGER.debug("execute method register, result:{}", result);
+        
+        return result;
+    }
+
+    @Override
+    public Result login(String username, String password) {
+        _LOGGER.debug("execute method login, arguments: username={}, password={}", username, password);
+        Result result = _delegate.login(username, password);      
+        _LOGGER.debug("execute method login, result:{}", result);
+        
+        return result;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/proxy/Result.java b/Java基础教程/Java源代码/codedemo/proxy/Result.java
new file mode 100644
index 00000000..66ee0384
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/proxy/Result.java
@@ -0,0 +1,65 @@
+package cn.aofeng.demo.proxy;
+
+/**
+ * 账号服务操作结果。
+ * 
+ * @author 聂勇
+ */
+public class Result {
+
+    /**
+     * 200xxxx 表示成功。

+     * 400xxxx 表示参数错误。

+     * 500xxxx 表示服务内部错误。
+     */
+    private int code;
+    
+    /**
+     * code对应的描述信息。
+     */
+    private String msg;
+    
+    /**
+     * 只有code为200xxxx时才有值，其他情况下为null。
+     */
+    private User data;
+
+    public Result() {
+        // nothing
+    }
+    
+    public Result(int code, String msg) {
+        this.code = code;
+        this.msg = msg;
+    }
+    
+    public int getCode() {
+        return code;
+    }
+
+    public void setCode(int code) {
+        this.code = code;
+    }
+
+    public String getMsg() {
+        return msg;
+    }
+
+    public void setMsg(String msg) {
+        this.msg = msg;
+    }
+
+    public User getData() {
+        return data;
+    }
+
+    public void setData(User data) {
+        this.data = data;
+    }
+
+    @Override
+    public String toString() {
+        return "Result [code=" + code + ", msg=" + msg + ", data=" + data + "]";
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/proxy/User.java b/Java基础教程/Java源代码/codedemo/proxy/User.java
new file mode 100644
index 00000000..a9cbd692
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/proxy/User.java
@@ -0,0 +1,38 @@
+/**
+ * 
+ */
+package cn.aofeng.demo.proxy;
+
+/**
+ * 用户信息。
+ * 
+ * @author 聂勇
+ */
+public class User {
+
+    private long uid;
+    
+    private String nickname;
+
+    public long getUid() {
+        return uid;
+    }
+
+    public void setUid(long uid) {
+        this.uid = uid;
+    }
+
+    public String getNickname() {
+        return nickname;
+    }
+
+    public void setNickname(String nickname) {
+        this.nickname = nickname;
+    }
+
+    @Override
+    public String toString() {
+        return "User [uid=" + uid + ", nickname=" + nickname + "]";
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/reactor/Acceptor.java b/Java基础教程/Java源代码/codedemo/reactor/Acceptor.java
new file mode 100644
index 00000000..b1104ec9
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/reactor/Acceptor.java
@@ -0,0 +1,48 @@
+package cn.aofeng.demo.reactor;
+
+import java.io.IOException;
+import java.nio.channels.SelectionKey;
+import java.nio.channels.Selector;
+import java.nio.channels.ServerSocketChannel;
+import java.nio.channels.SocketChannel;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ * 负责处理新连入的客户端Socket连接。
+ * 
+ * @author NieYong 
+ */
+public class Acceptor {
+
+    private final static Logger _logger = Logger.getLogger(Acceptor.class.getName());
+    
+    protected Selector _selector;
+    
+    protected ServerSocketChannel _serverChannel;
+    
+    public Acceptor(Selector selector, ServerSocketChannel serverChannel) {
+        this._selector = selector;
+        this._serverChannel = serverChannel;
+    }
+    
+    /**
+     * 接收一个新连入的客户端Socket连接，交给{@link Reader}处理：{@link Reader}向{@link Selector}注册并关注READ事件。
+     * 
+     * @throws IOException
+     */
+    public void accept() throws IOException {
+        SocketChannel clientChannel = _serverChannel.accept();
+        if (null != clientChannel) {
+            if (_logger.isLoggable(Level.INFO)) {
+                _logger.info("收到一个新的连接，客户端IP："+clientChannel.socket().getInetAddress().getHostAddress()
+                        +"，客户端Port："+clientChannel.socket().getPort());
+            }
+            clientChannel.configureBlocking(false);
+            Reader reader = new Reader(_selector, clientChannel);
+            reader.setDecoder(new LineDecoder());
+            clientChannel.register(_selector, SelectionKey.OP_READ, reader);
+        }
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/reactor/Constant.java b/Java基础教程/Java源代码/codedemo/reactor/Constant.java
new file mode 100644
index 00000000..da5df983
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/reactor/Constant.java
@@ -0,0 +1,25 @@
+package cn.aofeng.demo.reactor;
+
+/**
+ * 常量定义。
+ * 
+ * @author NieYong 
+ */
+public class Constant {
+
+    /**
+     * UTF-8字符集。
+     */
+    public final static String CHARSET_UTF8 = "UTF-8"; 
+    
+    /**
+     * 换行符。
+     */
+    public final static char CR = '\r';
+    
+    /**
+     * 回车符。
+     */
+    public final static char LF = '\n';
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/reactor/Decoder.java b/Java基础教程/Java源代码/codedemo/reactor/Decoder.java
new file mode 100644
index 00000000..c1977b26
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/reactor/Decoder.java
@@ -0,0 +1,20 @@
+package cn.aofeng.demo.reactor;
+
+import java.nio.ByteBuffer;
+
+/**
+ * 请求数据解析器接口定义。
+ * 
+ * @author NieYong 
+ */
+public interface Decoder {
+
+    /**
+     * 解析请求数据，不影响源数据的状态和内容。
+     * 
+     * @param source {@link Reader}读取到的源数据字节数组
+     * @return 如果解析到符合要求的数据，则返回解析到的数据；否则返回null。
+     */
+    public Object decode(ByteBuffer source);
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/reactor/Encoder.java b/Java基础教程/Java源代码/codedemo/reactor/Encoder.java
new file mode 100644
index 00000000..ed5b626f
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/reactor/Encoder.java
@@ -0,0 +1,20 @@
+package cn.aofeng.demo.reactor;
+
+import java.nio.ByteBuffer;
+
+/**
+ * 响应数据封装接口定义。
+ * 
+ * @author NieYong 
+ */
+public interface Encoder {
+
+    /**
+     * 将源数据转换成{@link ByteBuffer}。
+     * 
+     * @param source 源数据
+     * @return {@link ByteBuffer}对象。
+     */
+    public ByteBuffer encode(Object source);
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/reactor/LineDecoder.java b/Java基础教程/Java源代码/codedemo/reactor/LineDecoder.java
new file mode 100644
index 00000000..fb043eb2
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/reactor/LineDecoder.java
@@ -0,0 +1,50 @@
+package cn.aofeng.demo.reactor;
+
+import java.io.UnsupportedEncodingException;
+import java.nio.ByteBuffer;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ * 行数据解析器。
+ * 
+ * @author NieYong 
+ */
+public class LineDecoder implements Decoder {
+
+    private final static Logger _logger = Logger.getLogger(LineDecoder.class.getName());
+    
+    /**
+     * 从字节缓冲区中获取"一行"。
+     * 
+     * @param buffer 输入缓冲区
+     * @return 有遇到行结束符，返回不包括行结束符的字符串；否则返回null。
+     */
+    @Override
+    public String decode(ByteBuffer source) {
+        int index = 0;
+        boolean findCR = false;
+        int len = source.limit();
+        byte[] bytes = source.array();
+        while(index < len) {
+            index ++;
+            
+            byte temp = bytes[index-1];
+            if (Constant.CR == temp) {
+                findCR = true;
+            }
+            if (Constant.LF == temp && findCR) { // 找到了行结束符
+                byte[] copy = new byte[index];
+                System.arraycopy(bytes, 0, copy, 0, index);
+                try {
+                    return new String(copy, Constant.CHARSET_UTF8);
+                } catch (UnsupportedEncodingException e) {
+                    _logger.log(Level.SEVERE, "将解析完成的请求数据转换成字符串出错", e);
+                }
+            }
+        }
+        
+        return null;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/reactor/LineEncoder.java b/Java基础教程/Java源代码/codedemo/reactor/LineEncoder.java
new file mode 100644
index 00000000..c6819164
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/reactor/LineEncoder.java
@@ -0,0 +1,31 @@
+package cn.aofeng.demo.reactor;
+
+import java.io.UnsupportedEncodingException;
+import java.nio.ByteBuffer;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ * 将字符串转换成{@link ByteBuffer}并加上行结束符。
+ * 
+ * @author NieYong 
+ */
+public class LineEncoder implements Encoder {
+
+    private final static Logger logger = Logger.getLogger(LineEncoder.class.getName());
+    
+    @Override
+    public ByteBuffer encode(Object source) {
+        String line = (String) source;
+        try {
+            ByteBuffer buffer = ByteBuffer.wrap(line.getBytes(Constant.CHARSET_UTF8));
+            
+            return buffer;
+        } catch (UnsupportedEncodingException e) {
+            logger.log(Level.SEVERE, "将响应数据转换成ByteBuffer出错", e);
+        }
+        
+        return null;
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/reactor/ProcessService.java b/Java基础教程/Java源代码/codedemo/reactor/ProcessService.java
new file mode 100644
index 00000000..07178f11
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/reactor/ProcessService.java
@@ -0,0 +1,46 @@
+package cn.aofeng.demo.reactor;
+
+import java.io.IOException;
+import java.nio.channels.SocketChannel;
+
+/**
+ * 业务逻辑处理。
+ * 
+ * @author NieYong 
+ */
+public class ProcessService {
+
+    private SocketChannel _clientChannel;
+    
+    private String _line;
+    
+    public ProcessService(SocketChannel clientChannel, String line) {
+        this._clientChannel = clientChannel;
+        this._line = line;
+    }
+    
+    public String execute() {
+        // 判断客户端是否发送了退出指令
+        String content = _line.substring(0, _line.length()-2);
+        if (isCloseClient(content)) {
+            try {
+                _clientChannel.close();
+            } catch (IOException e) {
+                // nothing
+            }
+        }
+        
+        return _line;
+    }
+    
+    /**
+     * 客户端是否发送了退出指令（"quit" | "exit"）。
+     * 
+     * @param str 收到的客户端数据
+     * @return 返回true表示收到了退出指令；否则返回false。
+     */
+    private boolean isCloseClient(String str) {
+        return "exit".equalsIgnoreCase(str) || "quit".equalsIgnoreCase(str);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/reactor/Reactor.java b/Java基础教程/Java源代码/codedemo/reactor/Reactor.java
new file mode 100644
index 00000000..700d8da0
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/reactor/Reactor.java
@@ -0,0 +1,113 @@
+package cn.aofeng.demo.reactor;
+
+import java.io.IOException;
+import java.net.InetSocketAddress;
+import java.net.ServerSocket;
+import java.nio.channels.SelectionKey;
+import java.nio.channels.Selector;
+import java.nio.channels.ServerSocketChannel;
+import java.util.Iterator;
+import java.util.Set;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ * 负责Echo Server启动和停止 ，ACCEPT和READ事件的分派。
+ * 
+ * @author NieYong 
+ */
+public class Reactor {
+    
+    private final static Logger logger = Logger.getLogger(Reactor.class.getName());
+    
+    // 监听端口
+    private int _port;
+    
+    // {@link Selector}检查通道就绪状态的超时时间（单位：毫秒）
+    private int _selectTimeout = 3000;
+    
+    // 服务运行状态
+    private volatile boolean _isRun = true;
+    
+    /**
+     * @param port 服务监听端口。
+     */
+    public Reactor(int port) {
+        this._port = port;
+    }
+    
+    public void setSelectTimeout(int selectTimeout) {
+        this._selectTimeout = selectTimeout;
+    }
+    
+    /**
+     * 启动服务。
+     */
+    public void start() {
+        ServerSocketChannel serverChannel = null;
+        try {
+            serverChannel = ServerSocketChannel.open();
+            serverChannel.configureBlocking(false);
+            ServerSocket serverSocket = serverChannel.socket();
+            serverSocket.bind(new InetSocketAddress(_port));
+            _isRun = true;
+            if (logger.isLoggable(Level.INFO)) {
+                logger.info("NIO echo网络服务启动完毕，监听端口：" +_port);
+            }
+            
+            Selector selector = Selector.open();
+            serverChannel.register(selector, SelectionKey.OP_ACCEPT, new Acceptor(selector, serverChannel));
+            
+            while (_isRun) {
+                int selectNum = selector.select(_selectTimeout);
+                if (0 == selectNum) {
+                    continue;
+                }
+                
+                Set selectionKeys = selector.selectedKeys();
+                Iterator it = selectionKeys.iterator();
+                while (it.hasNext()) {
+                    SelectionKey selectionKey = (SelectionKey) it.next();
+                    
+                    // 接受新的Socket连接
+                    if (selectionKey.isValid() && selectionKey.isAcceptable()) {
+                         Acceptor acceptor = (Acceptor) selectionKey.attachment();
+                         acceptor.accept();
+                    }
+                    
+                    // 读取并处理Socket的数据
+                    if (selectionKey.isValid() && selectionKey.isReadable()) {
+                        Reader reader = (Reader) selectionKey.attachment();
+                        reader.read();
+                    }
+                    
+                    // 移除已经处理过的Key
+                    it.remove();
+                } // end of while iterator
+            }
+        } catch (IOException e) {
+            logger.log(Level.SEVERE, "处理网络连接出错", e);
+        }
+    }
+    
+    /**
+     * 停止服务。
+     */
+    public void stop() {
+        _isRun = false;
+    }
+    
+    public static void main(String[] args) {
+        if (1 != args.length) {
+            logger.severe("无效参数。使用示例：\n    java cn.aofeng.demo.reactor.Reactor 9090");
+            System.exit(-1);
+        }
+        int port = Integer.parseInt(args[0]);
+        int selectTimeout = 1000;
+        
+        Reactor reactor = new Reactor(port);
+        reactor.setSelectTimeout(selectTimeout);
+        reactor.start();
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/reactor/Reader.java b/Java基础教程/Java源代码/codedemo/reactor/Reader.java
new file mode 100644
index 00000000..a163b53d
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/reactor/Reader.java
@@ -0,0 +1,94 @@
+package cn.aofeng.demo.reactor;
+
+import java.io.IOException;
+import java.nio.ByteBuffer;
+import java.nio.channels.Selector;
+import java.nio.channels.SocketChannel;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ * 负责读取客户端的请求数据并解析。
+ * 
+ * @author NieYong 
+ */
+public class Reader {
+
+    private final static Logger _logger = Logger.getLogger(Reader.class.getName());
+    
+    private SocketChannel _clientChannel;
+    
+    private Decoder _decoder;
+    
+    private final static int BUFFER_SIZE = 512;
+    
+    private ByteBuffer _buffer = ByteBuffer.allocate(BUFFER_SIZE);
+    
+    public Reader(Selector selector, SocketChannel clientChannel) {
+        this._clientChannel = clientChannel;
+    }
+    
+    public void setDecoder(Decoder decoder) {
+        this._decoder = decoder;
+    }
+    
+    public void read() throws IOException {
+        int readCount = _clientChannel.read(_buffer);
+        if (-1 == readCount) {
+            _clientChannel.close();
+        }
+        
+        _buffer.flip();
+        int oldLimit = _buffer.limit();
+        String line = null;
+        while( (line = (String) _decoder.decode(_buffer)) != null ) { // 处理一次多行发送过来的情况
+            if (_logger.isLoggable(Level.FINE)) {
+                _logger.fine("收到的数据："+line);
+            }
+            
+            // 处理业务逻辑
+            ProcessService service= new ProcessService(_clientChannel, line);
+            String result = service.execute();
+            
+            // 发送响应
+            Writer writer = new Writer(_clientChannel, result);
+            writer.setEncoder(new LineEncoder());
+            writer.write();
+            
+            // 重建临时数据缓冲区
+            rebuildBuffer(line.length());
+        }
+        
+        // 缓冲区数据还没有符合一个decode数据的条件，重置数据缓冲区的状态方便append数据
+        if (oldLimit  == _buffer.limit()) {
+            resetBuffer();
+        }
+    }
+    
+    private void resetBuffer() {
+        _buffer.position(_buffer.limit());
+        _buffer.limit(_buffer.capacity());
+    }
+
+    /**
+     * 重建临时数据缓冲区。
+     * 
+     * @param lineSize 收到的一行数据（不包括行结束符）的长度 
+     */
+    private void rebuildBuffer(int lineSize) {
+        if (_buffer.limit() == lineSize) {
+            // 数据刚好是一行
+            _buffer = ByteBuffer.allocate(BUFFER_SIZE);
+        } else if (_buffer.limit() > lineSize) {
+            // 数据多于一行
+            byte[] temp = new byte[_buffer.limit() - lineSize];
+            System.arraycopy(_buffer.array(), lineSize, temp, 0, temp.length);
+            _buffer = ByteBuffer.allocate(BUFFER_SIZE);
+            _buffer.put(temp);
+            _buffer.flip();
+        } else {
+            // nothing
+        }
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/reactor/Writer.java b/Java基础教程/Java源代码/codedemo/reactor/Writer.java
new file mode 100644
index 00000000..e6299fb8
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/reactor/Writer.java
@@ -0,0 +1,41 @@
+package cn.aofeng.demo.reactor;
+
+import java.io.IOException;
+import java.nio.ByteBuffer;
+import java.nio.channels.SocketChannel;
+
+/**
+ * 负责向客户端发送响应数据。
+ * 
+ * @author NieYong 
+ */
+public class Writer {
+
+    private SocketChannel _clientChannel;
+    
+    private Object _data;
+    
+    private Encoder _encoder;
+    
+    public Writer(SocketChannel clientChannel, Object data) {
+        this._clientChannel = clientChannel;
+        this._data = data;
+    }
+    
+    public void setEncoder(Encoder encoder) {
+        this._encoder = encoder;
+    }
+    
+    public void write() throws IOException {
+        if (null == _data || !_clientChannel.isOpen()) {
+            return;
+        }
+        
+        ByteBuffer buffer = _encoder.encode(_data);
+        if (null == buffer) {
+            return;
+        }
+        _clientChannel.write(buffer);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/redis/JedisDemo.java b/Java基础教程/Java源代码/codedemo/redis/JedisDemo.java
new file mode 100644
index 00000000..46395dfe
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/redis/JedisDemo.java
@@ -0,0 +1,133 @@
+package cn.aofeng.demo.redis;
+
+import java.util.ArrayList;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+
+import redis.clients.jedis.HostAndPort;
+import redis.clients.jedis.Jedis;
+import redis.clients.jedis.JedisCluster;
+import redis.clients.jedis.JedisPool;
+import redis.clients.jedis.JedisPoolConfig;
+import redis.clients.jedis.JedisShardInfo;
+import redis.clients.jedis.ShardedJedis;
+import redis.clients.jedis.ShardedJedisPool;
+import sun.security.krb5.internal.HostAddress;
+
+/**
+ * Redis客户端Jedis使用示例。
+ * 
+ * @author 聂勇
+ */
+public class JedisDemo {
+
+    /**
+     * @param args
+     */
+    public static void main(String[] args) {
+        single();
+        pool();
+        shardPool();
+    }
+
+    /**
+     * 单机单连接方式。
+     */
+    private static void single() {
+        Jedis client = new Jedis("192.168.56.102", 6379);
+        String result = client.set("key-string", "Hello, Redis!");
+        System.out.println( String.format("set指令执行结果:%s", result) );
+        String value = client.get("key-string");
+        System.out.println( String.format("get指令执行结果:%s", value) );
+    }
+
+    /**
+     * 集群方式（尚未实现）。
+     */
+    private static void cluster() {
+        // 生成集群节点列表
+        Set clusterNodes = new HashSet();
+        clusterNodes.add(new HostAndPort("127.0.0.1", 6379));
+        clusterNodes.add(new HostAndPort("192168.56.102", 6379));
+        
+        // 执行指令
+        JedisCluster client = new JedisCluster(clusterNodes);
+        String result = client.set("key-string", "Hello, Redis!");
+        System.out.println( String.format("set指令执行结果:%s", result) );
+        String value = client.get("key-string");
+        System.out.println( String.format("get指令执行结果:%s", value) );
+    }
+    
+    /**
+     * 单机连接池方式。
+     */
+    private static void pool() {
+        // 在应用初始化的时候生成连接池
+        JedisPoolConfig config = new JedisPoolConfig();
+        config.setMaxIdle(10);
+        config.setMaxTotal(30);
+        config.setMaxWaitMillis(3*1000);
+        JedisPool pool = new JedisPool(config, "192.168.56.102", 6379);
+        
+        // 在业务操作时，从连接池获取连接
+        Jedis client = pool.getResource();
+        try {
+            // 执行指令
+            String result = client.set("key-string", "Hello, Redis!");
+            System.out.println( String.format("set指令执行结果:%s", result) );
+            String value = client.get("key-string");
+            System.out.println( String.format("get指令执行结果:%s", value) );
+        } catch (Exception e) {
+            // TODO: handle exception
+        } finally {
+            // 业务操作完成，将连接返回给连接池
+            if (null != client) {
+                pool.returnResource(client);
+            }
+        } // end of try block
+        
+        // 应用关闭时，释放连接池资源
+        pool.destroy();
+    }
+
+    /**
+     * 多机分布式＋连接池。
+     */
+    private static void shardPool() {
+        // 生成多机连接信息列表
+        List shards = new ArrayList();
+        shards.add( new JedisShardInfo("127.0.0.1", 6379) );
+        shards.add( new JedisShardInfo("192.168.56.102", 6379) );
+        
+        // 生成连接池配置信息
+        JedisPoolConfig config = new JedisPoolConfig();
+        config.setMaxIdle(10);
+        config.setMaxTotal(30);
+        config.setMaxWaitMillis(3*1000);
+        
+        // 在应用初始化的时候生成连接池
+        ShardedJedisPool pool = new ShardedJedisPool(config, shards);
+        
+        // 在业务操作时，从连接池获取连接
+        ShardedJedis client = pool.getResource();
+        try {
+            // 执行指令
+            String result = client.set("key-string", "Hello, Redis!");
+            System.out.println( String.format("set指令执行结果:%s", result) );
+            String value = client.get("key-string");
+            System.out.println( String.format("get指令执行结果:%s", value) );
+        } catch (Exception e) {
+            // TODO: handle exception
+        } finally {
+            // 业务操作完成，将连接返回给连接池
+            if (null != client) {
+                pool.returnResource(client);
+            }
+        } // end of try block
+        
+        // 应用关闭时，释放连接池资源
+        pool.destroy();
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/script/MultiScriptEngineCompare.java b/Java基础教程/Java源代码/codedemo/script/MultiScriptEngineCompare.java
new file mode 100644
index 00000000..5e1d61e8
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/script/MultiScriptEngineCompare.java
@@ -0,0 +1,250 @@
+package cn.aofeng.demo.script;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Map;
+
+import javax.script.Bindings;
+import javax.script.Compilable;
+import javax.script.CompiledScript;
+import javax.script.ScriptEngine;
+import javax.script.ScriptEngineManager;
+import javax.script.ScriptException;
+
+/**
+ * 多个脚本引擎执行JavaScript的性能比较。
+ * 
+ * @author 聂勇
+ */
+public class MultiScriptEngineCompare {
+
+    public final static String PARSE = "parse";
+    public final static String COMPILE = "compile";
+    
+    /**
+     * 获取指定的脚本引擎执行指定的脚本（解释执行）。
+     * 
+     * @param scriptEngineName 脚本引擎名称
+     * @param script 脚本
+     * @param count 脚本的执行次数
+     * @param vars 绑定到脚本的变量集合
+     * @throws ScriptException 执行脚本出错
+     */
+    public ExecuteResult parse(String scriptEngineName, String script, int count, 
+            Map vars) throws ScriptException {
+        ScriptEngine scriptEngine = getScriptEngine(scriptEngineName);
+        long startTime = System.currentTimeMillis();
+        for (int i = 0; i < count; i++) {
+            runSingleScript(script, vars, scriptEngine);
+        }
+        long usedTime = System.currentTimeMillis() - startTime;
+        
+        ExecuteResult result = new ExecuteResult();
+        result.setEngine(scriptEngine.getFactory().getEngineName());
+        result.setScript(script);
+        result.setBindParam(vars.toString());
+        result.setExecuteCount(count);
+        result.setExecuteType(PARSE);
+        result.setUsedTime(usedTime);
+        
+        return result;
+    }
+    
+    private void runSingleScript(String script, Map vars, 
+            ScriptEngine scriptEngine) throws ScriptException {
+        if (null == vars || vars.isEmpty()) {
+            scriptEngine.eval(script);
+        } else {
+            Bindings binds = createBinding(scriptEngine, vars);
+            scriptEngine.eval(script, binds);
+        }
+    }
+    
+    public ExecuteResult compile(String scriptEngineName, String script, int count, 
+            Map vars) throws ScriptException {
+        ScriptEngine scriptEngine = getScriptEngine(scriptEngineName);
+        Compilable compileEngine = (Compilable) scriptEngine;
+        CompiledScript compileScript = compileEngine.compile(script);
+        long startTime = System.currentTimeMillis();
+        for (int i = 0; i < count; i++) {
+            runSingleScript(compileScript, vars, scriptEngine);
+        }
+        long usedTime = System.currentTimeMillis() - startTime;
+        
+        ExecuteResult result = new ExecuteResult();
+        result.setEngine(scriptEngine.getFactory().getEngineName());
+        result.setScript(script);
+        result.setBindParam(vars.toString());
+        result.setExecuteCount(count);
+        result.setExecuteType(COMPILE);
+        result.setUsedTime(usedTime);
+        
+        return result;
+    }
+    
+    private void runSingleScript(CompiledScript compileScript, Map vars, 
+            ScriptEngine scriptEngine) throws ScriptException {
+        if (null == vars || vars.isEmpty()) {
+            compileScript.eval();
+        } else {
+            Bindings binds = createBinding(scriptEngine, vars);
+            compileScript.eval(binds);
+        }
+    }
+    
+    protected void log(String msg) {
+        System.out.println(msg);
+    }
+    
+    protected void log(String msg, Object... args) {
+        log( String.format(msg, args) );
+    }
+    
+    /**
+     * 根据名称获取脚本引擎。
+     *  
+     * @param name 脚本引擎名称
+     * @return 实现了{@link ScriptEngine}的脚本引擎。如果没有对应的脚本引擎，返回null。
+     */
+    public ScriptEngine getScriptEngine(String name) {
+        ScriptEngineManager sem = new ScriptEngineManager();
+        return sem.getEngineByName(name);
+    }
+    
+    private Bindings createBinding(ScriptEngine scriptEngine, Map vars) {
+        Bindings binds = scriptEngine.createBindings();
+        if (null != vars && !vars.isEmpty()) {
+            binds.putAll(vars);
+        }
+        
+        return binds;
+    }
+    
+    /**
+     * @param args 执行次数
+     * @throws ScriptException 
+     */
+    @SuppressWarnings({ "rawtypes", "unchecked" })
+    public static void main(String[] args) throws ScriptException {
+        if ( args.length != 2) {
+            System.err.println("参数错误。\n语法格式：\n    java cn.aofeng.demo.script.MultiScriptEngineCompare 脚本执行次数 脚本执行方式（parse|compile）\n使用示例：\n    java cn.aofeng.demo.script.MultiScriptEngineCompare 100000 parse");
+            System.exit(-1);
+        }
+        int count = Integer.parseInt(args[0]);
+        String executeType = args[1];
+        
+        String[] scriptEngineList = {"JavaScript", "JEXL"};
+        
+        String script1 = "var c = a + b;" +
+                "var d = a * b;" +
+                "var e = a / b;" +
+                "var f = a % b;" +
+                "var g = a - b;" +
+                "var result = ((a * 5) > b || b * 10 >= 100) && (a * b > 99);";
+        Map vars1 = new HashMap(2);
+        vars1.put("a", 20);
+        vars1.put("b", 9);
+        
+        String script2 = "var result = src.indexOf(b);";
+        Map vars2 = new HashMap(2);
+        vars2.put("src", "compare performance javascript and jexl");
+        vars2.put("b", "script");
+        
+        String[] scriptList = {script1, script2};
+        Map[] varsList = {vars1, vars2};
+        
+        MultiScriptEngineCompare msec = new MultiScriptEngineCompare();
+        List resultList = new ArrayList();
+        for (int i = 0; i < scriptEngineList.length; i++) {
+            for (int j = 0; j < scriptList.length; j++) {
+                if (PARSE.equalsIgnoreCase(executeType)) {
+                    resultList.add( msec.parse(scriptEngineList[i], scriptList[j], count, varsList[j]) );
+                } else if (COMPILE.equalsIgnoreCase(executeType)) {
+                    resultList.add( msec.compile(scriptEngineList[i], scriptList[j], count, varsList[j]) );
+                } else {
+                    msec.log("错误的执行方式：%s", executeType);
+                }
+            }
+        }
+        
+        List arrayList = new ArrayList();
+        arrayList.add(new String[]{"脚本引擎", "脚本", "脚本绑定参数", "脚本执行次数", "脚本执行类型", "消耗时间（毫秒）", "JDK版本"});
+        for (Iterator iterator = resultList.iterator(); iterator.hasNext();) {
+            ExecuteResult er = (ExecuteResult) iterator.next();
+            arrayList.add(new String[]{er.getEngine(), 
+                    er.getScript(), 
+                    er.getBindParam(), 
+                    String.valueOf(er.getExecuteCount()), 
+                    er.getExecuteType(), 
+                    String.valueOf(er.getUsedTime()), 
+                    er.getJdkVersion()});
+        }
+        
+        String[][] table = new String[arrayList.size()][7];
+        arrayList.toArray(table);
+        
+        PrettyTable prettyTable = new PrettyTable(System.out);
+        prettyTable.print(table);
+    }
+
+    static class ExecuteResult {
+        
+        private String engine;
+        private String script;
+        private String bindParam;
+        private int executeCount;
+        private String executeType;
+        private long usedTime;
+        private String jdkVersion;
+        
+        public ExecuteResult() {
+            this.jdkVersion = System.getProperty("java.version");
+        }
+        
+        public String getEngine() {
+            return engine;
+        }
+        public void setEngine(String engine) {
+            this.engine = engine;
+        }
+        public String getScript() {
+            return script;
+        }
+        public void setScript(String script) {
+            this.script = script;
+        }
+        public String getBindParam() {
+            return bindParam;
+        }
+        public void setBindParam(String bindParam) {
+            this.bindParam = bindParam;
+        }
+        public int getExecuteCount() {
+            return executeCount;
+        }
+        public void setExecuteCount(int executeCount) {
+            this.executeCount = executeCount;
+        }
+        public String getExecuteType() {
+            return executeType;
+        }
+        public void setExecuteType(String executeType) {
+            this.executeType = executeType;
+        }
+        public long getUsedTime() {
+            return usedTime;
+        }
+        public void setUsedTime(long usedTime) {
+            this.usedTime = usedTime;
+        }
+        public String getJdkVersion() {
+            return jdkVersion;
+        }
+        public void setJdkVersion(String jdkVersion) {
+            this.jdkVersion = jdkVersion;
+        }
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/script/PrettyTable.java b/Java基础教程/Java源代码/codedemo/script/PrettyTable.java
new file mode 100644
index 00000000..b45b60cf
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/script/PrettyTable.java
@@ -0,0 +1,125 @@
+package cn.aofeng.demo.script;
+
+import java.io.PrintStream;
+import static java.lang.String.format;
+
+/**
+ * 此代码来自于网络。使用示例：
+ * 
+ * PrettyTable printer = new PrettyTable(out);
+ * printer.print(new String[][] {
+ *      new String[] {"FIRST NAME", "LAST NAME", "DATE OF BIRTH", "NOTES"},
+ *      new String[] {"Joe", "Smith", "November 2, 1972"},
+ *      null,
+ *      new String[] {"John", "Doe", "April 29, 1970", "Big Brother"},
+ *      new String[] {"Jack", null, null, "(yes, no last name)"}
+ * });
+

+ */
+public final class PrettyTable {
+
+    private static final char BORDER_KNOT = '+';
+    private static final char HORIZONTAL_BORDER = '-';
+    private static final char VERTICAL_BORDER = '|';
+
+    private static final String DEFAULT_AS_NULL = "(NULL)";
+
+    private final PrintStream out;
+    private final String asNull;
+
+    public PrettyTable(PrintStream out) {
+        this(out, DEFAULT_AS_NULL);
+    }
+
+    public PrettyTable(PrintStream out, String asNull) {
+        if ( out == null ) {
+            throw new IllegalArgumentException("No print stream provided");
+        }
+        if ( asNull == null ) {
+            throw new IllegalArgumentException("No NULL-value placeholder provided");
+        }
+        this.out = out;
+        this.asNull = asNull;
+    }
+
+    public void print(String[][] table) {
+        if ( table == null ) {
+            throw new IllegalArgumentException("No tabular data provided");
+        }
+        if ( table.length == 0 ) {
+            return;
+        }
+        final int[] widths = new int[getMaxColumns(table)];
+        adjustColumnWidths(table, widths);
+        printPreparedTable(table, widths, getHorizontalBorder(widths));
+    }
+
+    private void printPreparedTable(String[][] table, int widths[], String horizontalBorder) {
+        final int lineLength = horizontalBorder.length();
+        out.println(horizontalBorder);
+        for ( final String[] row : table ) {
+            if ( row != null ) {
+                out.println(getRow(row, widths, lineLength));
+                out.println(horizontalBorder);
+            }
+        }
+    }
+
+    private String getRow(String[] row, int[] widths, int lineLength) {
+        final StringBuilder builder = new StringBuilder(lineLength).append(VERTICAL_BORDER);
+        final int maxWidths = widths.length;
+        for ( int i = 0; i < maxWidths; i++ ) {
+            builder.append(padRight(getCellValue(safeGet(row, i, null)), widths[i])).append(VERTICAL_BORDER);
+        }
+        return builder.toString();
+    }
+
+    private String getHorizontalBorder(int[] widths) {
+        final StringBuilder builder = new StringBuilder(256);
+        builder.append(BORDER_KNOT);
+        for ( final int w : widths ) {
+            for ( int i = 0; i < w; i++ ) {
+                builder.append(HORIZONTAL_BORDER);
+            }
+            builder.append(BORDER_KNOT);
+        }
+        return builder.toString();
+    }
+
+    private int getMaxColumns(String[][] rows) {
+        int max = 0;
+        for ( final String[] row : rows ) {
+            if ( row != null && row.length > max ) {
+                max = row.length;
+            }
+        }
+        return max;
+    }
+
+    private void adjustColumnWidths(String[][] rows, int[] widths) {
+        for ( final String[] row : rows ) {
+            if ( row != null ) {
+                for ( int c = 0; c < widths.length; c++ ) {
+                    final String cv = getCellValue(safeGet(row, c, asNull));
+                    final int l = cv.length();
+                    if ( widths[c] < l ) {
+                        widths[c] = l;
+                    }
+                }
+            }
+        }
+    }
+
+    private static String padRight(String s, int n) {
+        return format("%1$-" + n + "s", s);
+    }
+
+    private static String safeGet(String[] array, int index, String defaultValue) {
+        return index < array.length ? array[index] : defaultValue;
+    }
+
+    private String getCellValue(Object value) {
+        return value == null ? asNull : value.toString();
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/script/ScriptRunPerformence.java b/Java基础教程/Java源代码/codedemo/script/ScriptRunPerformence.java
new file mode 100644
index 00000000..6deb86ad
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/script/ScriptRunPerformence.java
@@ -0,0 +1,112 @@
+package cn.aofeng.demo.script;
+
+import java.util.HashMap;
+import java.util.Map;
+
+import javax.script.Bindings;
+import javax.script.Compilable;
+import javax.script.CompiledScript;
+import javax.script.ScriptEngine;
+import javax.script.ScriptEngineManager;
+import javax.script.ScriptException;
+
+/**
+ * 脚本语言运行性能测试：
+ * 
+ * 1、每次运行脚本都解释的执行性能。
+ * 2、编译脚本后再运行的性能。
+ * 

+ * 
+ * @author 聂勇 
+ */
+public class ScriptRunPerformence {
+
+    private final static int COUNT = 100000;
+    
+    /**
+     * 每次解释脚本并运行COUNT次。
+     * 
+     * @param script 脚本表达式
+     * @param vars 用于替换script中变量的Key=>Value集合
+     * @throws ScriptException 如果解释或运行脚本出错
+     */
+    public void parse(String script, Map vars) throws ScriptException {
+        ScriptEngine scriptEngine = getScriptEngine("javascript");
+        long startTime = System.currentTimeMillis();
+        for (int i = 0; i < COUNT; i++) {
+            Bindings binds = createBinding(vars, scriptEngine);
+            scriptEngine.eval(script, binds);
+        }
+        long usedTime = System.currentTimeMillis() - startTime;
+        System.out.println( String.format("每次都解释脚本执行%d次消耗%d毫秒", COUNT, usedTime) );
+    }
+    
+    /**
+     * 编译脚本后运行COUNT次。
+     * 
+     * @param script 脚本表达式
+     * @param vars 用于替换script中变量的Key=>Value集合
+     * @throws ScriptException 如果编译或运行脚本出错
+     */
+    public void compile(String script, Map vars) throws ScriptException {
+        ScriptEngine scriptEngine = getScriptEngine("javascript");
+        Compilable compileEngine = (Compilable) scriptEngine;
+        CompiledScript compileScript = compileEngine.compile(script);
+        long startTime = System.currentTimeMillis();
+        for (int i = 0; i < COUNT; i++) {
+            Bindings binds = createBinding(vars, scriptEngine);
+            compileScript.eval(binds);
+        }
+        long usedTime = System.currentTimeMillis() - startTime;
+        System.out.println( String.format("编译脚本后执行%d次消耗%d毫秒", COUNT, usedTime) );
+    }
+    
+    private ScriptEngine getScriptEngine(String name) {
+        ScriptEngineManager sem = new ScriptEngineManager();
+        return sem.getEngineByName(name);
+    }
+    
+    private Bindings createBinding(Map vars,
+            ScriptEngine scriptEngine) {
+        Bindings binds = scriptEngine.createBindings();
+        if (null != vars && !vars.isEmpty()) {
+            binds.putAll(vars);
+        }
+        
+        return binds;
+    }
+    
+    public static void main(String[] args) throws ScriptException {
+        if ( args.length != 1) {
+            System.err.println("参数错误。使用示例：\n    java cn.aofeng.demo.script.ScriptRunPerformence [parse|compile]");
+            System.exit(-1);
+        }
+        String runType = args[0];
+        if ( !"parse".equals(runType) && !"compile".equals(runType) ) {
+            System.err.println("参数错误。使用示例：\n    java cn.aofeng.demo.script.ScriptRunPerformence [parse|compile]");
+            System.exit(-1);
+        }
+        
+        String script = "function run(a, b) {" +
+        		"var c = a + b;" +
+        		"var d = a * b;" +
+        		"var e = a / b;" +
+        		"var f = a % b;" +
+        		"var g = a - b;" +
+        		"var  express = ((a * 5) > b || b * 10 >= 100) && (a * b > 99);" +
+        		"}" +
+        		"" +
+        		"run(x, y);";
+        Map vars = new HashMap(2);
+        vars.put("x", 20);
+        vars.put("y", 9);
+        
+        ScriptRunPerformence srp = new ScriptRunPerformence();
+        if ("parse".equals(runType)) {
+            srp.parse(script, vars);
+        } else {
+            srp.compile(script, vars);
+        }
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/script/SupportScriptEngine.java b/Java基础教程/Java源代码/codedemo/script/SupportScriptEngine.java
new file mode 100644
index 00000000..a2b042b1
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/script/SupportScriptEngine.java
@@ -0,0 +1,36 @@
+package cn.aofeng.demo.script;
+
+import java.util.List;
+
+import javax.script.ScriptEngineFactory;
+import javax.script.ScriptEngineManager;
+
+/**
+ * 支持的脚本引擎列表。 
+ * 
+ * @author 聂勇
+ */
+public class SupportScriptEngine {
+    
+    public void listScriptEngine() {
+        ScriptEngineManager sem = new ScriptEngineManager();
+        List sefList = sem.getEngineFactories();
+        for (ScriptEngineFactory factory : sefList) {
+            printScriptEngineInfo(factory);
+        }
+    }
+    
+    private void printScriptEngineInfo(ScriptEngineFactory factory) {
+        System.out.println("ScriptEngineName:" + factory.getEngineName() 
+                + ", Names:" + factory.getNames() 
+                + ", ScriptEngineVersion:" + factory.getEngineVersion()
+                + ", LanguageName:" + factory.getLanguageName()
+                + ", LanguageVersion:" + factory.getLanguageVersion() );
+    }
+    
+    public static void main(String[] args) {
+        SupportScriptEngine msep = new SupportScriptEngine();
+        msep.listScriptEngine();
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/slf4j/HelloSlf4j.java b/Java基础教程/Java源代码/codedemo/slf4j/HelloSlf4j.java
new file mode 100644
index 00000000..dce7ffdc
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/slf4j/HelloSlf4j.java
@@ -0,0 +1,31 @@
+package cn.aofeng.demo.slf4j;
+
+import java.io.IOException;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * slf4j使用示例。
+ * 
+ * @author 聂勇
+ */
+public class HelloSlf4j {
+
+    private static Logger _logger = LoggerFactory.getLogger(HelloSlf4j.class);
+
+    public static void main(String[] args) {
+        // 直接输出字符串
+        _logger.info("Hello, slf4j logger.");
+        
+        // 输出格式字符串（携带多个填充参数）
+        _logger.info("{} + {} = {}", 1, 2, (1+2));
+        
+        // 输出错误信息和异常堆栈
+        _logger.error("错误信息", new IOException("测试抛出IO异常信息"));
+        
+        // 输出错误信息（携带多个填充参数）和异常堆栈
+        _logger.error("两个参数。agrs1:{};agrs2:{}的info级别日志", "args1", "args2", new IOException("测试抛出IO异常信息"));
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/thread/DaemonThreadDemo.java b/Java基础教程/Java源代码/codedemo/thread/DaemonThreadDemo.java
new file mode 100644
index 00000000..541d1334
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/thread/DaemonThreadDemo.java
@@ -0,0 +1,45 @@
+/**
+ * 公司：阿里游戏
+ * 创建时间：2018年11月2日下午5:56:43
+ */
+package cn.aofeng.demo.thread;
+
+import java.util.Date;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * 守护线程DEMO。
+ * 
+ * @author 聂勇
+ */
+public class DaemonThreadDemo extends Thread {
+
+    private static Logger logger = LoggerFactory.getLogger(DaemonThreadDemo.class);
+    
+    @Override
+    public void run() {
+        while (true) {
+            System.out.println("守护线程运行, 时间:" + new Date());
+            try {
+                Thread.sleep(1000);
+            } catch (InterruptedException e) {
+                logger.error("守护线程运行出错", e);
+            }
+        }
+    }
+    
+    public static void main(String[] args) {
+        DaemonThreadDemo thread = new DaemonThreadDemo();
+        thread.setDaemon(true);
+        thread.start();
+        
+        try {
+            Thread.sleep(5000);
+        } catch (InterruptedException e) {
+            logger.error("主线程运行出错", e);
+        }
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/tree/PrettyTree.java b/Java基础教程/Java源代码/codedemo/tree/PrettyTree.java
new file mode 100644
index 00000000..76aa3335
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/tree/PrettyTree.java
@@ -0,0 +1,118 @@
+package cn.aofeng.demo.tree;
+
+import java.util.LinkedList;
+import java.util.List;
+
+/**
+ * 输出类似目录树的结构。
+ * 
+ * @author 聂勇
+ */
+public class PrettyTree {
+
+    private final static String NODE_INDENT_PREFIX = "|  ";
+    private final static String NODE_PARENT_PREFIX = "├── ";
+    private final static String NODE_LEAF_PREFIX = "└── ";
+    private final static String LINE_SEPARATOR = System.getProperty("line.separator", "\n");
+
+    public void renderRoot(Node root, StringBuilder buffer) {
+        renderParentNode(root, 0, buffer);
+    }
+    
+    private void renderParentNode(Node node, int indent, StringBuilder buffer) {
+        addIndent(indent, buffer);
+        buffer.append(NODE_PARENT_PREFIX)
+            .append(node.getName())
+            .append(LINE_SEPARATOR);
+        List childList = node.getChild();
+        if (null == childList) {
+            return;
+        }
+        for (Node child : childList) {
+            if (child.isLeaf()) {
+                renderLeafNode(child, indent+1, buffer);
+            } else {
+                renderParentNode(child, indent+1, buffer);
+            }
+        }
+    }
+
+    private void renderLeafNode(Node node, int indent, StringBuilder buffer) {
+        addIndent(indent, buffer);
+        buffer.append(NODE_LEAF_PREFIX)
+            .append(node.getName())
+            .append(LINE_SEPARATOR);
+    }
+
+    private void addIndent(int indent, StringBuilder buffer) {
+        for (int i = 0; i < indent; i++) {
+            buffer.append(NODE_INDENT_PREFIX);
+        }
+    }
+
+    public static class Node {
+
+        /** 节点名称。 */
+        private String name;
+
+        /** 子节点列表 */
+        private List child = new LinkedList();
+
+        public Node(String name) {
+            this.name = name;
+        }
+
+        public Node(String name, List child) {
+            this.name = name;
+            this.child = child;
+        }
+
+        /**
+         * 判断当前节点是否为叶子节点。
+         * 
+         * @return 如果是叶子节点返回true；否则返回false。
+         */
+        public boolean isLeaf() {
+            if (null == child || child.isEmpty()) {
+                return true;
+            }
+
+            return false;
+        }
+        
+        /**
+         * 批量添加子节点。
+         * 
+         * @param child 子节点列表。
+         */
+        public void addAll(List nodeList) {
+            this.child.addAll(nodeList);
+        }
+        
+        /**
+         * 添加单个子节点。
+         * 
+         * @param node 子节点。
+         */
+        public void add(Node node) {
+            this.child.add(node);
+        }
+
+        public String getName() {
+            return name;
+        }
+
+        public void setName(String name) {
+            this.name = name;
+        }
+
+        public List getChild() {
+            return child;
+        }
+
+        public void setChild(List child) {
+            this.child = child;
+        }
+    } // end of Node
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/tree/PrettyTreeTest.java b/Java基础教程/Java源代码/codedemo/tree/PrettyTreeTest.java
new file mode 100644
index 00000000..6a030752
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/tree/PrettyTreeTest.java
@@ -0,0 +1,41 @@
+package cn.aofeng.demo.tree;
+
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+
+import cn.aofeng.demo.tree.PrettyTree.Node;
+
+public class PrettyTreeTest {
+
+    @Before
+    public void setUp() throws Exception {
+    }
+
+    @After
+    public void tearDown() throws Exception {
+    }
+
+    @Test
+    public void testPrintRoot() {
+        Node p11 = new Node("p1-1");
+        Node p12 = new Node("p1-2");
+        Node p1 = new Node("p1");
+        p1.add(p11);
+        p1.add(p12);
+        
+        Node p21 = new Node("p21");
+        Node p2 = new Node("p2");
+        p12.add(p21);
+        
+        Node root = new Node("Root");
+        root.add(p1);
+        root.add(p2);
+        
+        StringBuilder buffer = new StringBuilder(256);
+        PrettyTree pt = new PrettyTree();
+        pt.renderRoot(root, buffer);
+        System.out.print(buffer.toString());
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/util/DateUtil.java b/Java基础教程/Java源代码/codedemo/util/DateUtil.java
new file mode 100644
index 00000000..473d5376
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/util/DateUtil.java
@@ -0,0 +1,32 @@
+package cn.aofeng.demo.util;
+
+import java.text.DateFormat;
+import java.text.SimpleDateFormat;
+import java.util.Calendar;
+import java.util.Date;
+
+/**
+ * @author 聂勇
+ */
+public class DateUtil {
+
+    /**
+     * @return 返回当前时间的字符串（格式："yyyy-MM-dd HH:mm:ss"）
+     */
+    public static String getCurrentTime() {
+        DateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
+        return dateFormat.format(new Date());
+    }
+
+    /**
+     * @return 下一分钟秒数为0的时间
+     */
+    public static Date getNextMinute() {
+        Calendar cal = Calendar.getInstance();
+        cal.add(Calendar.MINUTE, 1);
+        cal.set(Calendar.SECOND, 0);
+        
+        return cal.getTime();
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/util/LogUtil.java b/Java基础教程/Java源代码/codedemo/util/LogUtil.java
new file mode 100644
index 00000000..44558c91
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/util/LogUtil.java
@@ -0,0 +1,18 @@
+package cn.aofeng.demo.util;
+
+/**
+ * 日志工具类。
+ * 
+ * @author 聂勇
+ */
+public class LogUtil {
+
+    public static void log(String msg) {
+        System.out.println(msg);
+    }
+    
+    public static void log(String msg, Object... param) {
+        log( String.format(msg, param) );
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/wiremock/HttpGetTest.java b/Java基础教程/Java源代码/codedemo/wiremock/HttpGetTest.java
new file mode 100644
index 00000000..1629597c
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/wiremock/HttpGetTest.java
@@ -0,0 +1,66 @@
+package cn.aofeng.demo.wiremock;
+
+import static org.junit.Assert.*;
+
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Rule;
+import org.junit.Test;
+
+import static com.github.tomakehurst.wiremock.client.WireMock.*;
+import com.github.tomakehurst.wiremock.junit.WireMockRule;
+
+import cn.aofeng.demo.jetty.HttpGet;
+
+/**
+ * {@link HttpGet}的单元测试用例。
+ * 
+ * @author 聂勇
+ */
+public class HttpGetTest {
+
+    private HttpGet _httpGet = new HttpGet();
+    
+    @Rule
+    public WireMockRule _wireMockRule = new WireMockRule(9191);
+    
+    @Before
+    public void setUp() throws Exception {
+    }
+
+    @After
+    public void tearDown() throws Exception {
+    }
+
+    /**
+     * 用例：响应状态码为200且有响应内容。
+     */
+    @Test
+    public void testGetSomeThing4Success() throws Exception {
+        // 设置Mock
+        String response = "Hello, The World!";
+        stubFor(get(urlEqualTo("/hello"))
+                .willReturn(aResponse()
+                        .withStatus(200)
+                        .withBody(response)));
+        
+        String content = _httpGet.getSomeThing("http://localhost:9191/hello");
+        assertEquals(response, content);
+    }
+    
+    /**
+     * 用例：响应状态码为非200。
+     */
+    @Test
+    public void testGetSomeThing4Fail() throws Exception {
+        // 设置Mock
+        stubFor(get(urlEqualTo("/hello"))
+                .willReturn(aResponse()
+                        .withStatus(500)
+                        .withBody("Hello, The World!")));
+        
+        String content = _httpGet.getSomeThing("http://localhost:9191/hello");
+        assertNull(content);
+    }
+
+}
diff --git a/Java基础教程/Java源代码/codedemo/wiremock/README.md b/Java基础教程/Java源代码/codedemo/wiremock/README.md
new file mode 100644
index 00000000..e429c9e1
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/wiremock/README.md
@@ -0,0 +1,131 @@
+使用WireMock实现Http Server Mock作单元测试
+===
+前一篇文章"[使用jetty实现Http Server Mock作单元测试](http://aofengblog.com/2014/05/06/WireMock-%E5%AE%9E%E7%8E%B0Http-Server-Mock%E7%94%A8%E4%BA%8E%E5%8D%95%E5%85%83%E6%B5%8B%E8%AF%95/)"
+讲了用Jetty实现Http Server Mock来模拟依赖的外部HTTP服务系统，但如果需要更多的功能，如：区分GET和POST；匹配请求的URL；匹配Http Header；匹配请求内容等等。
+实际研发的过程中这些功能都有可能会用到，如果还是用Jetty来实现，需要自己不停地动手去添砖加瓦，虽然有成就感，但在快速迭代的节奏下不一定有足够的时间去做这些。
+这时我们需要一个现成的类库来满足我们这些需求，WireMock和MockServer都可以做到，这里只讲WireMock。
+
+预备
+---
+* [JUnit 4.11](http://junit.org/)
+* [wiremock 1.46](http://wiremock.org/)
+
+业务示例代码
+---
+[源码下载](https://raw.githubusercontent.com/aofeng/JavaDemo/master/src/cn/aofeng/demo/jetty/HttpGet.java)
+```java
+package cn.aofeng.demo.jetty;
+
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.net.HttpURLConnection;
+import java.net.URL;
+
+import org.apache.commons.io.IOUtils;
+
+/**
+ * 抓取页面内容。
+ * 
+ * @author 聂勇
+ */
+public class HttpGet {
+
+    public String getSomeThing(String urlStr) throws IOException {
+        URL url = new URL(urlStr);
+        HttpURLConnection urlConn = (HttpURLConnection) url.openConnection();
+        urlConn.setConnectTimeout(3000);
+        urlConn.setRequestMethod("GET");
+        urlConn.connect();
+        
+        InputStream ins = null;
+        try {
+            if (200 == urlConn.getResponseCode()) {
+                ins = urlConn.getInputStream();
+                ByteArrayOutputStream outs = new ByteArrayOutputStream(1024);
+                IOUtils.copy(ins, outs);
+                return outs.toString("UTF-8");
+            }
+        } catch (IOException e) {
+            throw e;
+        } finally {
+            IOUtils.closeQuietly(ins);
+        }
+        
+        return null;
+    }
+
+}
+```
+
+单元测试代码
+---
+[源码下载](https://raw.githubusercontent.com/aofeng/JavaDemo/master/src/cn/aofeng/demo/wiremock/HttpGetTest.java)
+```java
+package cn.aofeng.demo.wiremock;
+
+import static org.junit.Assert.*;
+
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Rule;
+import org.junit.Test;
+
+import static com.github.tomakehurst.wiremock.client.WireMock.*;
+import com.github.tomakehurst.wiremock.junit.WireMockRule;
+
+import cn.aofeng.demo.jetty.HttpGet;
+
+/**
+ * {@link HttpGet}的单元测试用例。
+ * 
+ * @author 聂勇
+ */
+public class HttpGetTest {
+
+    private HttpGet _httpGet = new HttpGet();
+    
+    @Rule
+    public WireMockRule _wireMockRule = new WireMockRule(9191);
+    
+    @Before
+    public void setUp() throws Exception {
+    }
+
+    @After
+    public void tearDown() throws Exception {
+    }
+
+    /**
+     * 用例：响应状态码为200且有响应内容。
+     */
+    @Test
+    public void testGetSomeThing4Success() throws Exception {
+        // 设置Mock
+        String response = "Hello, The World!";
+        stubFor(get(urlEqualTo("/hello"))
+                .willReturn(aResponse()
+                        .withStatus(200)
+                        .withBody(response)));
+        
+        String content = _httpGet.getSomeThing("http://localhost:9191/hello");
+        assertEquals(response, content);
+    }
+    
+    /**
+     * 用例：响应状态码为非200。
+     */
+    @Test
+    public void testGetSomeThing4Fail() throws Exception {
+        // 设置Mock
+        stubFor(get(urlEqualTo("/hello"))
+                .willReturn(aResponse()
+                        .withStatus(500)
+                        .withBody("Hello, The World!")));
+        
+        String content = _httpGet.getSomeThing("http://localhost:9191/hello");
+        assertNull(content);
+    }
+
+}
+```
\ No newline at end of file
diff --git a/Java基础教程/Java源代码/codedemo/xml/BookStore.xml b/Java基础教程/Java源代码/codedemo/xml/BookStore.xml
new file mode 100644
index 00000000..9c956ade
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/xml/BookStore.xml
@@ -0,0 +1,33 @@
+
+
+
+	
+    
+        Java并发编程实战
+        Brian Goetz /  Tim Peierls / Joshua Bloch / Joseph Bowbeer / David Holmes / Doug Lea 
+        2012
+        69
+    
+    
+    
+    
+        Java Concurrency in Practice
+        Brian Goetz /  Tim Peierls / Joshua Bloch / Joseph Bowbeer / David Holmes / Doug Lea 
+        2006
+        59.99
+    
+    
+    
+        德文书
+        德国 
+        2014
+        50
+    
+    
+    
+        没有lang属性
+        试试 
+        2016
+    
+
+
diff --git a/Java基础教程/Java源代码/codedemo/xml/XPathDemo.java b/Java基础教程/Java源代码/codedemo/xml/XPathDemo.java
new file mode 100644
index 00000000..39d07301
--- /dev/null
+++ b/Java基础教程/Java源代码/codedemo/xml/XPathDemo.java
@@ -0,0 +1,34 @@
+package cn.aofeng.demo.xml;
+
+import javax.xml.xpath.XPath;
+import javax.xml.xpath.XPathConstants;
+import javax.xml.xpath.XPathExpressionException;
+import javax.xml.xpath.XPathFactory;
+
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+import org.xml.sax.InputSource;
+
+/**
+ * XPath语法实践。
+ * 
+ * @author 聂勇
+ */
+public class XPathDemo {
+
+    public static void main(String[] args) throws XPathExpressionException {
+        InputSource ins = new InputSource(XPathDemo.class.getResourceAsStream("/cn/aofeng/demo/xml/BookStore.xml"));
+        XPathFactory factory = XPathFactory.newInstance();
+        XPath xpath = factory.newXPath();
+        NodeList result = (NodeList) xpath.evaluate("//title[@lang='de']", ins, XPathConstants.NODESET);
+        for (int i = 0; i < result.getLength(); i++) {
+            Node node = result.item(i);
+            StringBuilder buffer = new StringBuilder()
+                .append("NodeName=").append(node.getNodeName()).append(", ")
+                .append("NodeValue=").append(node.getNodeValue()).append(", ")
+                .append("Text=").append(node.getTextContent());
+            System.out.println(buffer.toString());
+        }
+    }
+
+}
diff --git a/Java基础教程/Java标准库/41 Rest接口.md b/Java基础教程/Java网站开发/41 Rest接口.md
similarity index 100%
rename from Java基础教程/Java标准库/41 Rest接口.md
rename to Java基础教程/Java网站开发/41 Rest接口.md
diff --git a/Java基础教程/Java语言基础/04 Java数组.md b/Java基础教程/Java语言基础/04 Java数组.md
index 298725ee..e6dd5168 100644
--- a/Java基础教程/Java语言基础/04 Java数组.md	
+++ b/Java基础教程/Java语言基础/04 Java数组.md	
@@ -7,7 +7,9 @@
     - [数组参数](#数组参数)
     - [数组返回值](#数组返回值)
     - [多维数组](#多维数组)
-    - [Arrays类](#arrays类)
+  - [2 Arrays类](#2-arrays类)
+    - [方法概述](#方法概述)
+    - [具体方法](#具体方法)
 # Java 数组
 ## 1 概述
 
@@ -120,7 +122,9 @@ s[1][2] = new String("!");
 ```
 
 
-### Arrays类
+## 2 Arrays类
+
+### 方法概述
 
 * 给数组赋值：通过 fill 方法。
 * 对数组排序：通过 sort 方法,按升序。
@@ -128,6 +132,8 @@ s[1][2] = new String("!");
 * 查找数组元素：通过 binarySearch 方法能对排序好的数组进行二分查找法操作。
 
 
+### 具体方法
+
 * public static int binarySearch(Object[] a, Object key)
 用二分查找算法在给定数组中搜索给定值的对象(Byte,Int,double等)。数组在调用前必须排序好的。如果查找值包含在数组中，则返回搜索键的索引；否则返回 (-(插入点) - 1)。
 * public static boolean equals(long[] a, long[] a2)
diff --git a/Java基础教程/Java语言基础/05 面向对象的类与对象.md b/Java基础教程/Java语言基础/05 面向对象的类与对象.md
index c7278ccc..8c9c52e4 100644
--- a/Java基础教程/Java语言基础/05 面向对象的类与对象.md	
+++ b/Java基础教程/Java语言基础/05 面向对象的类与对象.md	
@@ -6,6 +6,7 @@
   - [2 成员变量Field](#2-成员变量field)
     - [变量类型](#变量类型)
     - [成员变量](#成员变量)
+    - [初始化顺序](#初始化顺序)
   - [3 成员方法Method](#3-成员方法method)
   - [4 构造方法Constructor](#4-构造方法constructor)
     - [构造方法](#构造方法)
@@ -19,7 +20,6 @@
     - [final](#final)
     - [this](#this)
     - [super](#super)
-    - [static](#static)
     - [instanceof](#instanceof)
 # 类与对象
 ## 1 基本内容
@@ -131,6 +131,26 @@ public class Book{
 
 成员变量可以设置初始值，也可以不设置，如果不设置初始值，则会有默认值。
 
+### 初始化顺序
+
+Java类中各元素的初始化顺序 初始化的原则是：
+
+先初始化静态部分，再初始化动态部分；（先静再动）
+先初始化父类部分，后初始化子类部分；（先父再子）
+先初始化变量，次初始化代码块，再初始化构造器；（先变量，次代码块，再构造器）
+所以依照这个规则可以得出总体顺序是：
+```
+1.父类的静态成员变量（第一次加载类时）：父静成
+2.父类的静态代码块（第一次加载类时）：父静块
+3.子类的静态成员变量（第一次加载类时）：子静成
+4.子类的静态代码块（第一次加载类时）：子静块
+5.父类的普通成员变量：父成
+6.父类的动态代码块：父块
+7.父类的构造器方法：父构
+8.子类的普通成员变量：子成
+9.子类的动态代码块：子块
+10.子类的构造器方法：子构
+```
 
 ## 3 成员方法Method
 
@@ -336,9 +356,7 @@ public class SuperExtendExample extends SuperExample {
 }
 ```
 
-### static
 
-static方法和static变量和类加载器同时加载到内存中，存储在静态方法区。
 
 ### instanceof
 
diff --git a/Java基础教程/Java语言基础/10 Java泛型.md b/Java基础教程/Java语言基础/10 Java泛型.md
index 2cc029a5..4c5907da 100644
--- a/Java基础教程/Java语言基础/10 Java泛型.md	
+++ b/Java基础教程/Java语言基础/10 Java泛型.md	
@@ -12,12 +12,13 @@
     - [泛型接口](#泛型接口)
     - [泛型方法](#泛型方法)
   - [4 泛型通配符](#4-泛型通配符)
-  - [5 泛型中的KTVE](#5-泛型中的ktve)
+  - [5 泛型中的 KTVE](#5-泛型中的-ktve)
   - [6 泛型的实现原理](#6-泛型的实现原理)
 
-
 # 泛型机制
+
 > [Java 泛型详解](https://blog.csdn.net/ChenRui_yz/article/details/122935621)
+
 ## 1 泛型概述
 
 ### 基本概念
@@ -28,7 +29,8 @@ Java 泛型（generics）是 JDK 5 中引入的一个新特性, 泛型提供了
 
 ![](image/2022-07-11-22-24-04.png)
 
-与C#中的泛型相比，Java的泛型可以算是“伪泛型”了。在C#中，不论是在程序源码中、在编译后的中间语言，还是在运行期泛型都是真实存在的。Java则不同，Java的泛型只在源代码存在，只供编辑器检查使用，编译后的字节码文件已擦除了泛型类型，同时在必要的地方插入了强制转型的代码。
+与 C#中的泛型相比，Java 的泛型可以算是“伪泛型”了。在 C#中，不论是在程序源码中、在编译后的中间语言，还是在运行期泛型都是真实存在的。Java 则不同，Java 的泛型只在源代码存在，只供编辑器检查使用，编译后的字节码文件已擦除了泛型类型，同时在必要的地方插入了强制转型的代码。
+
 ### 泛型的基本用法
 
 ```java
@@ -41,15 +43,18 @@ public class Box {
 ```
 
 ## 2 优势
+
 1. 安全性？
 2. 消除转换？
 3. 提升性能？
 4. 重用行。不同类型不需要重载。泛型本质上也是一种编译时多态。
 
 ### 安全性
+
 在没有泛型之前，从集合中读取到的每一个对象都必须进行类型转换，如果不小心插入了错误的类型对象，在运行时的转换处理就会出错。
 
-* 没有泛型的情况下使用集合：
+- 没有泛型的情况下使用集合：
+
 ```java
 public static void noGeneric() {
 ArrayList names = new ArrayList();
@@ -57,7 +62,9 @@ names.add("mikechen的互联网架构");
 names.add(123); //编译正常
 }
 ```
-* 有泛型的情况下使用集合：
+
+- 有泛型的情况下使用集合：
+
 ```java
 public static void useGeneric() {
 ArrayList names = new ArrayList<>();
@@ -65,20 +72,23 @@ names.add("mikechen的互联网架构");
 names.add(123); //编译不通过
 }
 ```
+
 相当于告诉编译器每个集合接收的对象类型是什么，编译器在编译期就会做类型检查，告知是否插入了错误类型的对象，使得程序更加安全，增强了程序的健壮性。
 
-
 ### 消除强制转换
+
 泛型的一个附带好处是，消除源代码中的许多强制类型转换，这使得代码更加可读，并且减少了出错机会。
 
+- 以下没有泛型的代码段需要强制转换：
 
-* 以下没有泛型的代码段需要强制转换：
 ```java
 List list = new ArrayList();
 list.add("hello");
 String s = (String) list.get(0);
 ```
-* 当重写为使用泛型时，代码不需要强制转换：
+
+- 当重写为使用泛型时，代码不需要强制转换：
+
 ```java
 List list = new ArrayList();
 list.add("hello");
@@ -90,48 +100,56 @@ String s = list.get(0); // no cast
 
 ### 避免了不必要的装箱、拆箱操作，提高程序的性能
 
-在非泛型编程中，将简单类型作为Object传递时会引起Boxing（装箱）和Unboxing（拆箱）操作，这两个过程都是具有很大开销的。引入泛型后，就不必进行Boxing和Unboxing操作了，所以运行效率相对较高，特别在对集合操作非常频繁的系统中，这个特点带来的性能提升更加明显。
+在非泛型编程中，将简单类型作为 Object 传递时会引起 Boxing（装箱）和 Unboxing（拆箱）操作，这两个过程都是具有很大开销的。引入泛型后，就不必进行 Boxing 和 Unboxing 操作了，所以运行效率相对较高，特别在对集合操作非常频繁的系统中，这个特点带来的性能提升更加明显。
+
+- 泛型变量固定了类型，使用的时候就已经知道是值类型还是引用类型，避免了不必要的装箱、拆箱操作。
 
-* 泛型变量固定了类型，使用的时候就已经知道是值类型还是引用类型，避免了不必要的装箱、拆箱操作。
 ```java
 object a=1;//由于是object类型，会自动进行装箱操作。
- 
+
 int b=(int)a;//强制转换，拆箱操作。这样一去一来，当次数多了以后会影响程序的运行效率。
 ```
-* 使用泛型之后
+
+- 使用泛型之后
+
 ```java
 public static T GetValue(T a)
- 
+
 {
 　　return a;
 }
- 
+
 public static void Main()
- 
+
 {
 　　int b=GetValue(1);//使用这个方法的时候已经指定了类型是int，所以不会有装箱和拆箱的操作。
 }
 ```
 
 ### 提高了代码的重用行
-> 省略
+
+- 显而易见，能够通过泛型代替部分重载，大大提升了可用性。
 
 ## 3 泛型的使用
 
+都是通过尖括号定义的
+
 ### 泛型类
-* 定义泛型类，在类名后添加一对尖括号，并在尖括号中填写类型参数，参数可以有多个，多个参数使用逗号分隔：
+
+- 定义泛型类，在类名后添加一对尖括号，并在尖括号中填写类型参数，参数可以有多个，多个参数使用逗号分隔：
+
 ```java
 public class 类名 <泛型类型1,...> {}
 public class GenericClass {}
 ```
 
-* 实例代码
+- 实例代码
 
 ```java
 public class GenericClass {
     private T value;
- 
- 
+
+
     public GenericClass(T value) {
         this.value = value;
     }
@@ -143,26 +161,132 @@ public class GenericClass {
     }
 }
 ```
-### 泛型接口
+
+- **在创建对象的时候确定泛型**
+
+例如，`ArrayList list = new ArrayList();`
+
+此时，变量 E 的值就是 String 类型,那么我们的类型就可以理解为：
 
 ```java
-public interface GenericInterface {
-void show(T value);
-}
+class ArrayList{
+     public boolean add(String e){ }
 
-public class StringShowImpl implements GenericInterface {
-@Override
-public void show(String value) {
-System.out.println(value);
-}}
- 
-public class NumberShowImpl implements GenericInterface {
-@Override
-public void show(Integer value) {
-System.out.println(value);
-}}
+     public String get(int index){  }
+     ...
+}
 ```
 
+- 实例
+
+举例自定义泛型类
+
+```java
+public class MyGenericClass {
+	//没有MVP类型，在这里代表 未知的一种数据类型 未来传递什么就是什么类型
+	private MVP mvp;
+
+    public void setMVP(MVP mvp) {
+        this.mvp = mvp;
+    }
+
+    public MVP getMVP() {
+        return mvp;
+    }
+}
+```
+
+使用:
+
+```java
+public class GenericClassDemo {
+  	public static void main(String[] args) {
+         // 创建一个泛型为String的类
+         MyGenericClass my = new MyGenericClass();
+         // 调用setMVP
+         my.setMVP("大胡子哈登");
+         // 调用getMVP
+         String mvp = my.getMVP();
+         System.out.println(mvp);
+         //创建一个泛型为Integer的类
+         MyGenericClass my2 = new MyGenericClass();
+         my2.setMVP(123);
+         Integer mvp2 = my2.getMVP();
+    }
+}
+```
+
+### 泛型接口
+
+定义格式：
+
+```
+修饰符 interface接口名<代表泛型的变量> {  }
+```
+
+例如，
+
+```java
+public interface MyGenericInterface{
+	public abstract void add(E e);
+
+	public abstract E getE();
+}
+```
+
+使用格式：
+
+**1、定义类时确定泛型的类型**
+
+例如
+
+```java
+public class MyImp1 implements MyGenericInterface {
+	@Override
+    public void add(String e) {
+        // 省略...
+    }
+
+	@Override
+	public String getE() {
+		return null;
+	}
+}
+```
+
+此时，泛型 E 的值就是 String 类型。
+
+**2、始终不确定泛型的类型，直到创建对象时，确定泛型的类型**
+
+例如
+
+```java
+public class MyImp2 implements MyGenericInterface {
+	@Override
+	public void add(E e) {
+       	 // 省略...
+	}
+
+	@Override
+	public E getE() {
+		return null;
+	}
+}
+```
+
+确定泛型：
+
+```java
+/*
+ * 使用
+ */
+public class GenericInterface {
+    public static void main(String[] args) {
+        MyImp2  my = new MyImp2();
+        my.add("aa");
+    }
+}
+```
 
 ### 泛型方法
 
@@ -187,40 +311,57 @@ return t;
 }
 ```
 
+- 使用格式：**调用方法时，确定泛型的类型**
+
+```java
+public class GenericMethodDemo {
+    public static void main(String[] args) {
+        // 创建对象
+        MyGenericMethod mm = new MyGenericMethod();
+        // 演示看方法提示
+        mm.show("aaa");
+        mm.show(123);
+        mm.show(12.45);
+    }
+}
+```
+
 ## 4 泛型通配符
 
-Java泛型的通配符是用于解决泛型之间引用传递问题的特殊语法。泛型与继承之间的关系
+Java 泛型的通配符是用于解决泛型之间引用传递问题的特殊语法。泛型与继承之间的关系
+
 1. 无边界通配符
    1. 无边界的通配符的主要作用就是让泛型能够接受未知类型的数据.
 2. 固定上边界的通配符
    1. 使用固定上边界的通配符的泛型, 就能够接受指定类及其子类类型的数据。
-   2. 要声明使用该类通配符, 采用的形式, 这里的E就是该泛型的上边界。
-   3. 注意: 这里虽然用的是extends关键字, 却不仅限于继承了父类E的子类, 也可以代指显现了接口E的类
+   2. 要声明使用该类通配符, 采用的形式, 这里的 E 就是该泛型的上边界。
+   3. 注意: 这里虽然用的是 extends 关键字, 却不仅限于继承了父类 E 的子类, 也可以代指显现了接口 E 的类
 3. 固定下边界的通配符
    1. 使用固定下边界的通配符的泛型, 就能够接受指定类及其父类类型的数据.。
-   2. 要声明使用该类通配符, 采用的形式, 这里的E就是该泛型的下边界.。
+   2. 要声明使用该类通配符, 采用的形式, 这里的 E 就是该泛型的下边界.。
    3. 注意: 你可以为一个泛型指定上边界或下边界, 但是不能同时指定上下边界。
+
 ```java
 //表示类型参数可以是任何类型
 public class Apple{}
- 
+
 //表示类型参数必须是A或者是A的子类
 public class Apple{}
- 
+
 //表示类型参数必须是A或者是A的超类型
 public class Apple{}
 ```
 
-## 5 泛型中的KTVE
+## 5 泛型中的 KTVE
 
 泛型中的规范
-* T：任意类型 type
-* E：集合中元素的类型 element
-* K：key-value形式 key
-* V： key-value形式 value
-* N： Number（数值类型）
-* ？： 表示不确定的java类型
 
+- T：任意类型 type
+- E：集合中元素的类型 element
+- K：key-value 形式 key
+- V： key-value 形式 value
+- N： Number（数值类型）
+- ？： 表示不确定的 java 类型
 
 ## 6 泛型的实现原理
 
@@ -228,4 +369,4 @@ public class Apple{}
 
 实际上编译器会正常的将使用泛型的地方编译并进行类型擦除，然后返回实例。但是除此之外的是，如果构建泛型实例时使用了泛型语法，那么编译器将标记该实例并关注该实例后续所有方法的调用，每次调用前都进行安全检查，非指定类型的方法都不能调用成功。
 
-实际上编译器不仅关注一个泛型方法的调用，它还会为某些返回值为限定的泛型类型的方法进行强制类型转换，由于类型擦除，返回值为泛型类型的方法都会擦除成 Object 类型，当这些方法被调用后，编译器会额外插入一行 checkcast 指令用于强制类型转换，这一个过程就叫做『泛型翻译』。
\ No newline at end of file
+实际上编译器不仅关注一个泛型方法的调用，它还会为某些返回值为限定的泛型类型的方法进行强制类型转换，由于类型擦除，返回值为泛型类型的方法都会擦除成 Object 类型，当这些方法被调用后，编译器会额外插入一行 checkcast 指令用于强制类型转换，这一个过程就叫做『泛型翻译』。
diff --git a/Java基础教程/Java语言基础/18 ClassLoader机制.md b/Java基础教程/Java语言基础/18 ClassLoader机制.md
deleted file mode 100644
index e69de29b..00000000
diff --git a/Java基础教程/Java语言基础/19 staic关键字.md b/Java基础教程/Java语言基础/19 staic关键字.md
new file mode 100644
index 00000000..d05efd93
--- /dev/null
+++ b/Java基础教程/Java语言基础/19 staic关键字.md	
@@ -0,0 +1,274 @@
+# static
+
+## 1 静态变量
+
+- 静态变量：又称为类变量，也就是说这个变量属于类的，类所有的实例都共享静态变量，可以直接通过类名来访问它。静态变量在内存中只存在一份。
+- 实例变量：每创建一个实例就会产生一个实例变量，它与该实例同生共死。
+- static变量也称作静态变量，静态变量和非静态变量的区别是：静态变量被所有的对象所共享，在内存中只有一个副本，它当且仅当在类初次加载时会被初始化。而非静态变量是对象所拥有的，在创建对象的时候被初始化，存在多个副本，各个对象拥有的副本互不影响。static成员变量的初始化顺序按照定义的顺序进行初始化。所以我们一般在这两种情况下使用静态变量：对象之间共享数据、访问方便。
+
+
+```java
+public class A {
+
+    private int x;         // 实例变量
+    private static int y;  // 静态变量
+
+    public static void main(String[] args) {
+        // int x = A.x;  // Non-static field 'x' cannot be referenced from a static context
+        A a = new A();
+        int x = a.x;
+        int y = A.y;
+    }
+}
+```
+
+## 2 静态方法
+
+静态方法在类加载的时候就存在了，它不依赖于任何实例。所以静态方法必须有实现，也就是说它不能是抽象方法。
+
+
+```java
+public abstract class A {
+    public static void func1(){
+    }
+    // public abstract static void func2();  // Illegal combination of modifiers: 'abstract' and 'static'
+}
+```
+
+只能访问所属类的静态字段和静态方法，方法中不能有 this 和 super 关键字，因为这两个关键字与具体对象关联。
+
+```java
+public class A {
+
+    private static int x;
+    private int y;
+
+    public static void func1(){
+        int a = x;
+        // int b = y;  // Non-static field 'y' cannot be referenced from a static context
+        // int b = this.y;     // 'A.this' cannot be referenced from a static context
+    }
+}
+```
+
+## 3 静态语句块
+
+静态语句块在类初始化时运行一次。
+
+```java
+public class A {
+    static {
+        System.out.println("123");
+    }
+
+    public static void main(String[] args) {
+        A a1 = new A();
+        A a2 = new A();
+    }
+}
+```
+
+```html
+123
+```
+
+## 4 静态内部类
+
+非静态内部类依赖于外部类的实例，也就是说需要先创建外部类实例，才能用这个实例去创建非静态内部类。而静态内部类不需要。
+
+```java
+public class OuterClass {
+
+    class InnerClass {
+    }
+
+    static class StaticInnerClass {
+    }
+
+    public static void main(String[] args) {
+        // InnerClass innerClass = new InnerClass(); // 'OuterClass.this' cannot be referenced from a static context
+        OuterClass outerClass = new OuterClass();
+        InnerClass innerClass = outerClass.new InnerClass();
+        StaticInnerClass staticInnerClass = new StaticInnerClass();
+    }
+}
+```
+
+静态内部类不能访问外部类的非静态的变量和方法。
+
+　　内部类一般情况下使用不是特别多，如果需要在外部类里面定义一个内部类，通常是基于外部类和内部类有很强关联的前提下才去这么使用。
+
+  　　在说静态内部类的使用场景之前，我们先来看一下静态内部类和非静态内部类的区别：
+
+  　　**非静态内部类对象持有外部类对象的引用（编译器会隐式地将外部类对象的引用作为内部类的构造器参数）；而静态内部类对象不会持有外部类对象的引用**
+
+  　　由于非静态内部类的实例创建需要有外部类对象的引用，所以非静态内部类对象的创建必须依托于外部类的实例；而静态内部类的实例创建只需依托外部类；
+
+  　　并且由于非静态内部类对象持有了外部类对象的引用，因此非静态内部类可以访问外部类的非静态成员；而静态内部类只能访问外部类的静态成员；
+
+   
+
+  　　两者的根本性区别其实也决定了用static去修饰内部类的真正意图：
+
+  - 内部类需要脱离外部类对象来创建实例
+  - 避免内部类使用过程中出现内存溢出
+
+  　　
+
+  第一种是目前静态内部类使用比较多的场景，比如JDK集合中的Entry、builder设计模式。
+
+　　HashMap Entry：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200518164800.png)
+
+　　builder设计模式：
+
+```java
+public class Person {
+    private String name;
+    private int age;
+ 
+    private Person(Builder builder) {
+        this.name = builder.name;
+        this.age = builder.age;
+    }
+ 
+    public static class Builder {
+ 
+        private String name;
+        private int age;
+ 
+        public Builder() {
+        }
+ 
+        public Builder name(String name) {
+            this.name = name;
+            return this;
+        }
+        public Builder age(int age) {
+            this.age=age;
+            return this;
+        }
+ 
+        public Person build() {
+            return new Person(this);
+        }
+    }
+ 
+    public String getName() {
+        return name;
+    }
+ 
+    public void setName(String name) {
+        this.name = name;
+    }
+ 
+    public int getAge() {
+        return age;
+    }
+ 
+    public void setAge(int age) {
+        this.age = age;
+    }
+}
+ 
+// 在需要创建Person对象的时候
+Person person = new Person.Builder().name("张三").age(17).build();
+```
+
+第二种情况一般出现在多线程场景下，非静态内部类可能会引发内存溢出的问题，比如下面的例子：
+
+```java
+public class Task {
+ 
+    public void onCreate() {
+        // 匿名内部类, 会持有Task实例的引用
+        new Thread() {
+            public void run() {
+                //...耗时操作
+            };
+        }.start();   
+    }
+}
+```
+
+　上面这段代码中的：
+
+```java
+new Thread() {
+  public void run() {
+  //...耗时操作
+  };
+}.start();
+```
+
+　　声明并创建了一个匿名内部类对象，该对象持有外部类Task实例的引用，如果在在run方法中做的是耗时操作，将会导致外部类Task的实例迟迟不能被回收，如果Task对象创建过多，会引发内存溢出。
+
+​	优化方式：
+
+```java
+public class Task {
+ 
+    public void onCreate() {
+        SubTask subTask = new SubTask();
+        subTask.start();
+    }
+     
+    static class SubTask extends Thread {
+        @Override
+        public void run() {
+            //...耗时操作   
+        }
+         
+    }
+}
+```
+
+## 5 静态导包
+
+在使用静态变量和方法时不用再指明 ClassName，从而简化代码，但可读性大大降低。
+
+```java
+import static com.xxx.ClassName.*
+```
+
+## 6 初始化顺序
+
+静态变量和静态语句块优先于实例变量和普通语句块，静态变量和静态语句块的初始化顺序取决于它们在代码中的顺序。
+
+```java
+public static String staticField = "静态变量";
+```
+
+```java
+static {
+    System.out.println("静态语句块");
+}
+```
+
+```java
+public String field = "实例变量";
+```
+
+```java
+{
+    System.out.println("普通语句块");
+}
+```
+
+最后才是构造函数的初始化。
+
+```java
+public InitialOrderTest() {
+    System.out.println("构造函数");
+}
+```
+
+存在继承的情况下，初始化顺序为：
+
+- 父类（静态变量、静态语句块）
+- 子类（静态变量、静态语句块）
+- 父类（实例变量、普通语句块）
+- 父类（构造函数）
+- 子类（实例变量、普通语句块）
+- 子类（构造函数）
\ No newline at end of file
diff --git a/Java基础教程/Java语言基础/20 final关键字.md b/Java基础教程/Java语言基础/20 final关键字.md
new file mode 100644
index 00000000..38c40483
--- /dev/null
+++ b/Java基础教程/Java语言基础/20 final关键字.md	
@@ -0,0 +1,27 @@
+
+# final
+
+## 1. 数据 
+
+声明数据为常量，可以是编译时常量，也可以是在运行时被初始化后不能被改变的常量。
+
+- 对于基本类型，final 使数值不变；
+- 对于引用类型，final 使引用不变，也就不能引用其它对象，但是被引用的对象本身是可以修改的。
+- 如果引用时类的成员变量，则必须当场赋值，否则编译会报错。
+```java
+final int x = 1;
+// x = 2;  // cannot assign value to final variable 'x'
+final A y = new A();
+y.a = 1;
+```
+
+## 2. 方法
+
+声明方法不能被子类重写。当使用final修饰方法时，这个方法将成为最终方法，无法被子类重写。但是，该方法仍然可以被继承。
+
+private 方法隐式地被指定为 final，如果在子类中定义的方法和基类中的一个 private 方法签名相同，此时子类的方法不是重写基类方法，而是在子类中定义了一个新的方法。
+
+## 3. 类
+
+声明类不允许被继承。
+
diff --git a/Java基础教程/Java语言基础/21 Java类加载机制.md b/Java基础教程/Java语言基础/21 Java类加载机制.md
new file mode 100644
index 00000000..c8fd4860
--- /dev/null
+++ b/Java基础教程/Java语言基础/21 Java类加载机制.md	
@@ -0,0 +1,89 @@
+# Java类加载机制
+> https://blog.csdn.net/qq_29167297/article/details/124800850
+## 0 JVM简介
+### JVM空间
+JVM内存共分为虚拟机栈、堆、方法区、程序计数器、本地方法栈五个部分。
+
+![](image/2022-12-04-13-14-56.png)
+
+### ClassLoader
+
+![](image/2022-12-04-13-15-46.png)
+## 1 加载
+加载阶段是将class文件从磁盘或者jar等读到JVM内存中，并为其创建一个Class对象。任何一个类被使用时候系统都会为其创建一个Class对象的。加载的同时将加载的这些数据转换成方法区中运行时数据(运行时候数据区：静态变量、静态代码块、常量池等)，作为方法区数据的访问入口。
+
+加载是类加载的第一个过程，在这个阶段，将完成以下三件事情：
+
+1. 通过一个类的全限定名获取该类的二进制流。
+2. 将该二进制流中的静态存储结构转化为方法去运行时数据结构。
+3. 在内存中生成该类的Class对象，作为该类的数据访问入口。
+
+
+事实上，这三条限定都不是很严格，比如第一条，并没有明确指出通过全限定名从哪里得到二进制流，由此就有很多不同的实现：
+* 在ZIP包中读取（JAR,EAR,WAR）
+* 从网络中获取（APPLET）
+* 运行时计算生成，这种场景使用的最多的就是动态代理技术，在java.lang.reflect.Proxy中，就是用了ProxyGenerator.generateProxyClass来为特定接口申城$Proxy的代理类的二进制流
+* 由其它文件生成（jsp）
+* 从数据库中读取，有些中间件服务器（SAP NETWEAVER)
+
+加载阶段完成后，虚拟机外部的二进制流就按照虚拟机所需的格式存储在方法区中，方法区中的数据存储格式由虚拟机实现自行定义。然后在JAVA堆中实例化一个java.lang.Class类对象（比如我们new A()对象，在加载过程中，会在堆区生成一个代表A类的java.lang.Class类的对象，而new所产生的对象，是依靠A类的java.lang.class对象为模板产生的新的对象到堆区），这个对象将作为程序访问方法区中的这些类型数据的外部接口。加载阶段与连接阶段的部分内容是交叉进行的，加载阶段尚未完成，连接阶段可能已经开始。
+
+## 2 验证
+
+验证目的是为了确保Class文件的字节流中的信息不会危害到虚拟机，在该阶段主要完成以下四种验证：
+
+1. 文件格式验证：验证字节流是否符合Class文件的规范，如主次版本号是否在当前虚拟机范围内，常量池中的常量是否有不被支持的类型。
+2. 元数据验证：对字节码描述的信息进行语义分析，如这个类中是否有父类，是否集成了不被继承的类等。
+3. 字节码验证：是整个验证过程中最复杂的一个阶段，通过验证数据流和控制流的分析，确定程序语义是否正确，主要针对方法体的验证。如：方法中的类型转换是否正确，跳转指令是否正确等。
+4. 符号引用验证：这个动作在后面的解析过程中发生，主要是为了确保解析动作能正确执行。
+
+## 3 准备
+
+准备阶段是为类的静态变量分配内存并将其初始化为默认值，这些内存都将在方法区中进行分配。准备阶段不分配类中的实例变量的内存，实例变量将会在对象实例化时随着对象一起分配在Java堆中。如果该变量被final修饰，将在编译时生成ConstantValue，这样在准备阶段将直接设置成该初值。
+```java
+public static int value=123;//在准备阶段value初始值为0，初始化阶段才变为123。
+```
+
+### 4 解析
+
+该阶段主要完成符号引用到直接引用的转换动作。解析动作并不一定在初始化动作完成之前，也有可能在初始化之后。
+
+* 解析阶段是虚拟机将常量池内的符号引用替换为直接引用的过程。其实就是将堆内存空间里的静态变量符号修改为已经申请了空间的静态变量地址的过程
+  * 符号引用：（Symbolic References）符号引用以一组符号来描述所引用的目标，可以是任何形式的字面量，引用的目标并不一定已经加载到内存中，与虚拟机内存布局无关。
+  * 直接引用：（Direct References）直接引用可以是直接指向目标的指针，相对偏移量，或是一个能间接定位到目标的句柄。与虚拟机内存布局相关。
+
+
+
+### 5 初始化
+
+初始化时类加载的最后一步，前面的类加载过程，除了在加载阶段用户应用程序可以通过自定义类加载器参与之外，其余动作完全由虚拟机主导和控制。到了初始化阶段，才真正开始执行类中定义的Java程序代码。
+
+初始化阶段是执行类构造器()方法的过程
+
+1. ()方法是由编译器自动收集类中的所有类变量的赋值动作和静态语句块中的语句合并而成。编译器收集的顺序和语句在源文件中出现的顺序一致，静态语句块中只能访问到定义在它之前的变量，定义在它之后的变量，只能赋值，不能访问
+2. ()方法与类的构造函数()不同，不需要显式的调用父类构造器，虚拟机会保证父类的()在子类的之前完成。因此，虚拟机执行的第一个()方法肯定是java.lang.Object.
+3. 由于父类()方法先执行，也就意味着父类中定义的静态语句要优先于子类的变量赋值操作。
+4. ()方法并不是必须的，如果一个类没有静态语句块也没有对变量赋值操作，就不会生成
+5. 接口中不能使用静态语句块，但仍有变量初始化赋值的操作，因此也会生成()方法，但与类不同的是，接口的()方法不需要执行父接口的()方法。只有当父几口中定义的变量被使用时，父接口才初始化，另外，接口的实现类在初始化时一样不会执行接口的()方法。
+6. 虚拟机会保证一个类的()方法在多线程环境中正确的加锁同步，如果多个线程同时去初始化一个类，那么只会有一个线程去执行这个类的()方法，其他线程都会阻塞，直到该方法执行完，如果在一个类的()方法中有耗时很长的操作，可能会造成多个进程阻塞，在实际应用中，这种阻塞往往很隐蔽。
+
+### 触发初始化
+
+虚拟机规范严格规定了有且只有四种情况必须对类进行初始化（加载，验证，准备自动在之前开始）
+
+1. 遇到new,getstatic,putstatic,invokestatic这4条字节码指令时，如果类没有进行初始化，则先初始化。这4个字节码常见的出现场景是：使用new关键字实例化对象的时候，读取或设置静态字段（被final修饰，已在编译期把结果放入常量池的静态字段除外）的时候，以及调用一个类的静态方法的时候。
+2. 反射调用时
+3. 初始化一个类时，如果其父类还未初始化，则先出发父类初始化。
+4. 当虚拟机启动时，用户需要指定一个要执行的主类，虚拟机会先初始化这个主类
+
+
+这4种情况称为对类的主动引用，其他情况称为被动引用。一下四种情况不会触发初始化
+
+1. 对于访问静态字段，只有直接定义这个字段的类才被初始化，因此通过子类来引用父类中定义的静态字段，只会触发父类的初始化而不会触发子类的初始化。但是对于HOTSPOT,会触发子类的加载。
+2. 通过数组定义引用类，不会触发此类的初始化。
+3. 常量在编译阶段会存入调用类的常量池，本质上没有直接引用到定义常量的类，因此不会触发定义常量的类的初始化。
+4. 接口的加载和类加载过程稍有不同，接口不能有static代码段，但接口中还是会生成()类构造器，用于初始化接口中所定义的成员变量。 一个接口在初始化时，并不要求其父类也初始化了。
+
+###  补充说明
+* 只有当某个类初始化之后，才会调用类的静态代码块。
+* 初始化过程一方面是唯一的，另一方面是线程安全的。所以通过静态语句块的单例模式非常合理。
\ No newline at end of file
diff --git a/Java基础教程/Java语言基础/22 Java包机制.md b/Java基础教程/Java语言基础/22 Java包机制.md
new file mode 100644
index 00000000..66d592f5
--- /dev/null
+++ b/Java基础教程/Java语言基础/22 Java包机制.md	
@@ -0,0 +1,43 @@
+## 包
+包我们每天建的项目就是在一个目录下，我们每次都会建立一个包，这个包在磁盘下其实就是一个目录。**包是用来分门别类的管理技术，不同的技术类放在不同的包下**，方便管理和维护。
+
+**包名的命名规范**：
+
+```
+路径名.路径名.xxx.xxx
+// 例如：com.github.krislinzhao
+```
+
+- 包名一般是公司域名的倒写。例如：黑马是www.github.com,包名就可以定义成com.github.技术名称。
+- 包名必须用''."连接。
+- 包名的每个路径名必须是一个合法的标识符，而且不能是Java的关键字。
+
+## 2 权限修饰符
+
+在Java中提供了四种访问权限，使用不同的访问权限修饰符修饰时，被修饰的内容会有不同的访问权限，我们之前已经学习过了public 和 private，接下来我们研究一下protected和缺省（default默认）修饰符的作用。
+
+- public：公共的，所有地方都可以访问。
+- protected：当前类 ，当前包，当前类的子类可以访问。
+- 缺省（没有修饰符）：当前类 ，当前包可以访问。
+- private：私有的，当前类可以访问。
+  `public > protected > 缺省 > private`
+
+## 3 不同权限的访问能力
+
+
+|                  | public | protected | 缺省（空的） | private |
+| ---------------- | ------ | --------- | ------------ | ------- |
+| 同一类中         | √      | √         | √            | √       |
+| 同一包中的类     | √      | √         | √            |         |
+| 不同包的子类     | √      | √         |              |         |
+| 不同包中的无关类 | √      |           |              |         |
+
+可见，public具有最大权限。private则是最小权限。
+
+编写代码时，如果没有特殊的考虑，建议这样使用权限：
+
+- 成员变量使用`private` ，隐藏细节。
+- 构造方法使用` public` ，方便创建对象。
+- 成员方法使用`public` ，方便调用方法。
+
+> 小贴士：不加权限修饰符，就是default权限
\ No newline at end of file
diff --git a/Java基础教程/Java语言基础/image/2022-12-04-13-14-56.png b/Java基础教程/Java语言基础/image/2022-12-04-13-14-56.png
new file mode 100644
index 0000000000000000000000000000000000000000..672eb1d8542ddc302e6c8564e31f1c14f6a24855
GIT binary patch
literal 105399
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
vy3YH3>Xy?hZlmdrRWvZZ8kft2%2Dzg|F6MEtU
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	q{@5Dwp
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
Zy2;ee(E=Pro>vNkrq`yKdON?c$ca
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
z
zCssL5^+U<#iHUKyRl>9Tyxv$MI6XBrF)x|Tea|Y?z?u4^K!Kl8#k)JcCOhh>Z|eC%%M`sefy^Qq4};2
z-kIlW7NAfuTk7nc`o7??UFm{cbKV=b9!YHWID
zO4Gz3BoNF=*}1*o7+7%(SjIDFf>#^et2Vei;dkD7@1`5J7V;IVg=0e)plHYpXp+oz
zVYuLEznlu3-AE)Z&&ulwA2%Wc5aXg!Gwpxl@Y)Sq%$m(!?>_bnV6Y29Npj835*hvyLK+Xm
z20_{*zSzvPTpX#y2@MwFR~ooGRiT}4=Y@e4$ADoH4SWS_R<}R8bJqrAhu!QER
z+njDEB6hh*Unn^q5+l^%bQEMBltK#8004kK72YqT@=Qul`iKwt%3f*=W8FXhj;tc8_WI@pa
z&|9sUs#b?SnaVx=%nR3Dv#+PSn=n`ee3y-1^}569;Hc4THm6yf!ax=2P$2|5Y1!Jc2FW!#x6h~_qX
zsjffzgD2z3)qAeHfuny3z9CzDYBe?>>AFo$Uy;>T5rzcVGgDnvvrhT5u-i_Vxbv}t
zfe$?fPCw$C{8N#I`Kg5(@|AytzJmL5V|O@`$pnGw#>d7~l-~I{KJ@7Nz%^h6F<^yz
zxCcTWj#xOtHu9BnAlbF=?w|YVGY6h}{vER;VbKGXx=D6~a)hS*HaqM>F^G2mw+e2*
zIMq!naqI8N(~?3GDgJrNR44yAt=<3N+k7ch4L6zjgauIF+&STTUI&LrluR#B&`x%0h)fer@F8UxLVDz?8_W!bog
zz7Yi-!8p%mLAbAO@9F7DrP7>Ch1ElirZ?)@
zTDkX%Eq8lA`-4XxI&yUMu3L8ZBtqhpP_1%SCQBd^8i@=H#5rTp7?pGRA@^rBRF^OD
zQvFVCVjfn^dGy@$z&AAB_M}plRn@Qp@_oH3MVR?>H(u))UAR{71{n#@7qtE
zn+^t6CI*;v#+1e6#6(l3K*2<7el#3TXT%>(rDli%jfNtt!&a;8!ZRV9XYzz=c+AUD&D2nPRN;d6DQ6y-l6jM4dNG5hat8A*}0uZ1oH{j-X13tt0
zt}Ii$kW_NtOd^F#ff7HG8!43s#OGW&R~sIlJaVM({dbRN3fj)=_Fc2*`bxc?&E-@E
zbYHio5d}I&W}2_tt(wKES!p1x6zEl93WhWN0g2!mmv!I+pPUTCgAfcPC&4lA@y?a*
zUUV(-YEha6FF?WK>m15iT*x`RSq#jXK(aX3l2xC&sAVl=LDgqc*Mcldw&=7km#pa2
zB`=v}aYd&tWN~`lEG~ILA&V1`YeAZYB}E8xbVIPzWjuGF_&_6k2iS#&wu9l
z@!c;x_tcMm@|N9pnAb8&8-#r$T%!C3&mjn$a8*VwJ8fVbGBm}HU;QVGLo3S{Oewg}%6A%X{~
ze-;K_lcLFjgo|TkBHt{#g@Xb!zG%EvEuu^Xf#S6^mAtaGMDhTn*pDT-z{#%?iUlSG
zwWT5f@JzNc*s{2`ZM$~Mj-BCnl*RNyCPQ;5L0O({Gcz+HRuh{;*RegbFswUV!ZC4t
z6BkW9-~@|jd;zn>)F6GMj@NaA;3_V!1DLc1wQ3*^kn7YhDC}Gv46JAjFtgb*V6B_0
z)vC?wsyMWgCUgT9tC?-FSTdK%j*X2n!JTeex>2SMjq14;EY3=7Wjg3tApE!}pPUQ0$=(%ol6x3O^@KdYJiVsn#SjL@~p^OrT
z+d`>C)Ks;-u3>V!9FW-Am6
z!qpoM-LAusNDSkw)oa*(?N%E+Pqqxo(vHRMvKLF$YK<`LHIf2nsZ_!6jvk5pOVt1k
zQ&#w7A#L@=Y7Mc2UNg_TyQWcaF&yRJs_dvnuz(WvUGXmkMG_R3qY-?aNWglPm~
zK4EtD+8t!Y1-iRCiA{^xSiV3MQbLxK)zx`_{ut;mVE7`UAha4?(p-jj!b04h?hR`!
z=A_MP@p}WsT)8MwS8Fz#)$8%*@;Gmmv7Rz8y^j?OVR*1L_@C46pr~@C!bIbf-Q@x>*d*Cu_E>X*6LX&r1U1p8fQY%mxM&eKB0wlD
zTppI~GU}ARQ&oU>qpH>m5xLHxa#h^CMx8|=?Yadg)ZT{f9DzBDs@qA0In3<^;T8s5
zXM&Jc^XCBEYSfuzZ$r_(X;v-6x%sa3Mh1?0wZt$HTA)^{6ziM=OtXx$`J>PwhANTg
z6%ef!$xvlhV`gKz6w72uO$g|kE)lOFS;+c`?A_hnnQUrobkt%N2T4`Z*#OW<
zdzKjJFkl9m5LK}Qi#}&%eCpO(u~uQ{Dyre+*kHM!JhE)CD);#0OtDx*wY6C_x7$52
zGXS5HjHU+6IGu(G=CHfc3m&&;hLFd?dt_#@)jgfh=JPo|Q4kC?TP*S&ArzkHaJp(m
zm@f*qtjxNc&Rn^Wonoh~Sic<(XQ@^lpHW{Mb)d3nj#N62y3EYhImp&hoJ!?I?H10a
zYbMwD^@2m;rkT_n!3{>vk_bcyrqU|lww5wiga5GfE8usnkw
zN^UaaOs-n3`$IvqW;YgpMJX4WrGC$J#w+3?RG%gilfJQWR@t7HSZ#y;u_7D@~G%v`}U%$8sj(JXl0
zpV?G(XS%(?r2+c1cW`{F&2y
zqXc@m6UJrnKqA+oUKYgtw1c7
zQDFO*H!ZX^6StjxWmKyy&4Ja#L^Hkd=~Qh{xHC{>6r+}F1ijMJNeBi4L
zC?rxN(bBc?_7ngJiYY@9Nf$IPMcTOM1;!#)dVqz)8%l`Dl?twtfQN$!CbL)~iqpo#
z__zX?#W6f6nxa9gtj^yHjDZdV2BECD*2H;-p$jLG@vFNXk*Z0@kZLa3oEBGAE4jTc
zOvm*?&2Hu}A2a$ZDrKRBFmhvT=*~S#{dcC+H6^e4;50lU1alU
zBNr-Wqrq60dES8Md2l2y7V;Kxc)(2UVCf~B$zl3MICVN)ur6^PhO3!)bUJiwe4oJF{=+fx$LbKPdO(+ro}UBWJ1
zuIj34pT}E*Z|6!j3{#pJ8G@w6Vg>M+*R+DR&z(pVePwbFfS)f$qDt~;u-0I`G<*j<71TuM$+Ki%vrl~jWNBJrba>-v+n1K;Rh>hf`1gYA11Pmpj
zsnTY1%g~i(N%j_el9ET`4=;_z3d2&BNwp-Fs#G%aa%)u7EV$Wbl~R?jP$11#7kQ1M
zq#`lIG#`1%zBIu~8*Fk5{)8{9vW2iKc$$@qEfmLtX2Fsgt|6!JwMtMotB#HXRcU6$WBni}*Q6))zsufazdZP-HS_MvCw!W&OcqJ67Su&_na0(bI
zGb~hfOEa%PAcI^kX{i(iAPs9(BTSua+jkIf!|v6sRkH&*+-%eJ?w+0*HUm#iL8-8(
zg(KaiGM!N4um=U1QCjEs0%M@VfMtZj*<{QzhSg2IX0ox^>+lwR`_>P!8A5X7e&t&=And
zLBUiJA|+%{%x`c87Q*-oIbtKSM4T4~HL3>)Yz0{R4Ps6vaKxhkW)^Qzc3LSwp>+bd
zjUx<&C<=AM7!MYV7Em5+#*7~r=?o^VSb@qbpvsaw`>)8xR{=v7-3124k=Ou7MdVOW
zDM$5|DuayyctoHv6aQDt2U3@E(-Rp-2(EyDGXMe*2Yx1JBufqW9MD~0oHBSX2qCG$7im~zp+-Owk`FKljM#5L
zjntr4cx0(w*cP=j#0-S+OBYa)6%QdPTZ(2hv#qVts@JHRU&@h+Wwe8Pum`tOOGku1
zB_gtV&sq_4S2^k%8KjrtB;swPIz?P2jfzwuKwYIwg>c%XEIkBsg8`}zk)D)6Qj>
zx|>(na7c!Whx$SWHr&@)4&zQWM0$^dO{7jxrz}+zRjbh~!6d)9agdk}7grRs3|&O#
zN~Kg2#5DQ_`}Xd=7D;+^cogfJ-R@vFaE3rwC9-$8uXM)pUD_AF_{HTb{nD1q94M3^
zJ*T-Kmyk61rzV2T1q*DW&djsgb#ZXAn#;0+TB0cS&bT~oRy}dN5;i5;t%r#L%M=f3
z4V}`1UsFaN<$~u?9>!(Ks}7=vAt^&NvyHE8&avh3s}l0pKp#a-6m?e7S?(ohl&l$x
zuY_`ya^~`IUucgB*349a=fUJCi?47&xG$z=+5ruMM*emU*$CQ2(m~l)YoKpIq+ge-NzZ(
zWT|2>hxG%eQX9J|DhF{2UeyY#!4Tb$A
z7H(^*`TZWU^H^(u)Uw;{3`av$#3QuZ>2}1EF}k8ca8whK!tC)xtX#t*u8e0Hs|{UU
z32w^xA=Im^C-AjOJIV!sq}7Q;3>I80(s7JfQ=&VLQIWy{17KpYh*j5kM5iM`G#aM%
zVu`(BG`SWE`rRI9v6#o+0sRhz1A(BAbr1{qiAxi;`O@8
zPEk^kspfJ!!l3{W&&Ws{K~5qW2WCJ8NSoan!!f==D_F0oYq}+ojNyG)QID+VB;#?K
zLwa$kqZNs`RkswtwrXQC8N+d&N18x_csxS+(ifs9SHrO|5}rJw-qkA6Sjg*RWh6~v
zwkiaIexHw#F9;#tyFciocM2s|N%&d?>`*v}C9761o9b1U%Mp!+3{=B`d5p&*B^INq
z&=Cf<&Zwx=%eYZ8VC;4)LkJ5?r3z)h&rur1jkJ*!8O=mu7-W&20)ggQED>WO6hOZ0
ztEf>g-v|6=X$YmfN$dY(Fp`+w67mKbdS|eked4iw{oAmj7JZ7^^yDPR+PQaA*+Tf-aFvBoSFi&LdYW8ufdX|pgY-x8DwB^fX+pVip63KAs|5+g5mO&)rz6Pp)#UmqmhUwaCsdV8p7+IAwwfz
zzx_k_G?Zv#2+|u4(!DG*=-gGKGF*#AM)-cQfHUin$$cVJjF431j-SEgLT>w7u0|MINkzrvj
z^?FxV7o%usco?ArjSSr4ayUpEVf2l9Jdt3?4bqB=932pk#XR)X;2@GHc_YyXkdF)x
z=ap9=tT+;jj*gDtra&75fj~SF9~~K$M_C#1CgO2mPNh>wr4E;qy674X$3@?zjf6Cx
zNzF`7Owx}ohjbhw>Ewj;6p;7QigFp8&;+JjPj5G4XJ}*uFnCNRlXMV6s9HrLF?V%$
zBZLAcU@#8Z_QUKR8XTZ=nXu7Flyi9p2Kwn%N(1%YfNywkNV=v`4+VmWSZru$Sg1k0
z;q&`w_29^e&>0T&_4yGc$HylC6@)PHu`N$bjN^(?uhbw5y}hf_>D2hxIP$OAVO!nZ
zo1LB+?jOXwg9WX-r#D|p504Jx_Ch^t)^0!o0EUxY3?#SH=5g6hmZ0f)X__>3ql2dh@~@)>PI84pflxR?KgzBIlbIa~Fe*yM$B?eUJ_LV7
z5~5LT)bq0Op}Tt=#x*g?H0hDWHER)}C!
zEDjF~yJfJiTD1yP3=9up3?n@yGpG6o`k9i<(?n~4K}VQ1$PjEt?CbAmfPws2Sfo9`
zrWI5TGxi4jgCj$DEJHdFi=vUpQ2#(7hfZIoy|HL)guYOcI)YJmSNG`H=*&!tc}idK
z2+R|cljsX>JN&hqNRu=Zr~sRu0y*QOW1yP7`Q6>CFrW>M_FE{2+!#Ods50`3l*|*}^ItQuypURXG)j|PssNQ%eG*39tXdV0HI0fSozx;X
za#4(`hnGM_U1BEU0d_f?ww1-{Zs%)#l>AZ-d=#Jnm3ygJRo$vfeV0`23y8!vFVBhx
z@=RhefGRAAXHBczcAg7%BU&}`4OLSse?$nNaCp9;RXMr$LL3{7f&PBLf=qXHcadPA
zub*Fb55q6v889lE$x1E64%0o4qKjB87$o6FeW)fC4v^LY!2r7NAk;9Ax19y<3pIoV
zLL8C3;7o}`Vq|0_pUDz*6JrTV=h*ldx}a{wInEi6$6?H=scAsN4Ibi{O=qSiCXwsV
zeWCamS|E-#q!`W0BjycMb^wEo!HR%kMEDkpi=OOGvKk5zN5G=5lF2Tly}|x|I*hzD
z3bQ=w7i^w2lvpH=wg7_4;BS}$0cjN6m&G7D-R}z~;xQ}-Y(v1?(CzhgbtPd_Q!^<%
zAMtu*R7_1y;gQ6$HmF10&!p1Rlanm90yuqvU?gk|ssJ17>c-ea&jJ|oCV3fs{X>Hw
zgw6Lf3IV9Uua6lHdKm*O9nnT60c;PjJsxj=-wE~_>WsH&6b!?CQRwMqMwCAo7#bYL
zQa7-D(^Jc%x8}+C@a)&mmG*b1!NX*M-
z1`;VYW+YZMw?0udS)`&Slm^4&6?u*HM!np(s-K0E#KIKkC6>olM)_joQrRJQJWBLB
zxtdiA9*jcd<(!;6pziadoKr*|k%Y3;D_+m4U~Ze`OWq4}HQSBri2;kirdYlBT#4WS
z1FqW|;Y5U0v610XLjh2m}H3`%QNTd
z5P)R@EwFsn000a>NklUfk!Zn#zFlHLnH#ER_
z~iM1Sq3Zf4yyNRwOQqsf}+}DibCsG1Oq>N8aRO?m7Taq;b
z#f&Km2>Dtpuo8_0h)LV@bG$GUwNuJ`40IUqe0(&YP@5RWJhTWqBawT!j*&pvujpBe
zGdB|~{=l0B-&&8Yzl-vm^uxTA^HR-wP{|g*Y3DxKr@8N2_pQIJ%=4b-Jt!=R^nz}$
zF0dpvo;!>qGa2H?wxg0za%8S_w^Og_IRjgT$j^vhWs-#UQLg
z@f&8;VvaW-68u1&!_TF=TWO6mz>Dh*Y9fSkVr&ApKlm0DA4Lso
zD35TRo}ONoX<=gmr%mha?yfZIECHhQKun>P3{^>>Mr*SSh4yhKGi;X>o+a9WNPA^bZaY;s!~GMFD)=#wW*TCZ~W?bl+qg
z4IaG_??@ak02`KuHq3zGLWW4EGssC`Ug^GFvLrt;#_&VQq)~_qv_kfy3)o#y3E*Tr
z((AB&e*5}l;R7KRLjvPX*`={and8woPH+AF1GpK`HDOtk578Ht&v;`A9^IF(gc1ND
zEZ38rH3B?HctlQOfq#5#G?UIU{Mh@@mFS+Fp2FJ9NM>IJLkK4W_%W>zKZEXW!U0W;
zjnfx)yK~Lz)tOulsT7TzfO#Mv2uDT+gMqLGhigb(=UO%lbQti-P^)OTd{j4W);llx
ze8w~Hlgc?yOxcvjzGsz2Y2#2FsJ0aYF!p5+8q6->5
zH9d`X%L$B;XmoU(sP|I{B{nNo$2i7L0E2lz;vL^&xXW9aFGL0b~Vikl}4#WO=NEwMfv?fi^X>Qcpv-M;no3P5Yl}7h%jT-
z3b=1*pl>iQ+vgg7j|VZLe{cxS1jY~={DBbaK9m|b5ewjIG-@W5rYJP3Xe2&HqtJcD
zAzzP1P`_ZulW;ZcnUQF0YHEhnZfrd8fOwqfhUmUyj8mGKOm+j|(C{F*McGAH!y^Gz
z&lq?(4+FrlqbHPOftfXR&15}x{jh&Yl7``}6%L`Uco)0cKdP
z4h6%514FFABdj=dXFP_}-;kmEvU4IDi;qoAFy3edyYHj1#MHDn7SJ;czeF^VPG#{5
z#2A3v0b*z>l>rGdJuIxFM+xl5cmw&kl+z=C*SVGt1Iu6yTs~mWvSh^PbMt~;vYvBd
zJWH0;dAW=jfGE$U7%*UwCK{~aH_}rRP$l(qXN)rl9C@`Ma%f
zlnmG;rWx=9%92*#+N4-Du%P3ju8Hwe;3hn<4G7t%hLAwjD5>BP1YtO(a+*jDqTka*
zRyt{trU|!DmteqRVI7n-1|&u+fRJPWMjL?y)tH`AP(4QGXBrPjBzupR`DCBST1VjmyUzOAz@GjC9p^ge3w0TcU4hxQ(6yAqu?;pE~AcJ{gTdm6S;AJcv`IoGBt)Uwx(BI2#&p
zl94phQ^g{~gGauCF?tP1s0$nc0BtdvPYE)j=nG=POQ(ytLq_rX=0SE|IQXS5saf?S
zzqA6>86{AfF;*#xmpmF@d8Bp$F$^5Pa=0v)74ehucT#(-!A(0*vQP-2v8A;A<$QEKHv+}y-V
zSzwTb@TS|jszvJIMl>kV1tl~R7bIFBq%83OF!EBh>=U6(;fO+qsg=6Kk_<%`fRsO-
zKq-s*k^n2TJkTg<4lBa)3v8rU^@uhD*;OUMR>*;OIP6x^K+1Vf(G)<{{KdIlAw-xB
z=pq@7Qm9bCDC>??tzZ*c&+01`015dOCr}8Xa4Cw$@?Sf#DD)y18GKZE^^>z*RI?ST
zQ3@E?3S|N$fYBxV0uRmOCE2K&dx4o&srVthPqmhwc5>tv4Ot&gHIypXP!j8!KIWBPneO*2i?DH_5sFE$bz2}hKtj5GQTj6aP^q^q8Zb;@#h
z={6zYcauD_y*6-(#+7&lN`to!FllBp*vxXua2vv!_$tk|vNc{S1Um>3DaS5PZeUiJ
zQu{`E%Alsf*-8wxDKwIZn<{GEbk;7B?+
zczkgW;{Fik`2)T$%kQ4&5BT@BdXWEg1#)HNANvU$cs^MEniWj*CNDu31#rgIM@y?j$%H1a=0{pr4bd_b`%>_2MVaxC?$X%+DuStg5
yVW#o{-tdVgjUGVK)w>*3FXutI;LqqUR^SC$Ipu0ug9+{c00009^)DsaI
zkr7cDwX#BGq(q@1FdzT`0HDQw3CRHf05t;u0Mda2ep3jiWS{{6pe#%U1!cqp1@UC;
ztc^@93;_Usg(fP4smPC@WU0r+#7qOi#~`>N3c1B12!tz?_(jG5BZx=*ef_e4EVt%3{CEwllu$0P-=SRVEnW
zZvYrZJ`&sO^-I~4lS|Dn@&S+d0q_d2cWZ#4WMM(n4&?u_wf2SyAbYQjjjZv7^;IPq
zOdE3pz(>NDF`0a0hi?T6P_-?V?+O5i>=th7iU5)YR#S-t3Vx#oGO4gj0V1WmTlgbA
zfQ_X;`G-uNUCZom0H#ZRZpQ57pRPg(y^UVs_1ppHs8%S4ruFxc9oyffNZrL*%!?
z%oOdlf@Nk&?SQL|?
zQ3@w>j6#2~LUzpfi^6Z&e)81_0JI9>L53=?Sj0+&%D)JlG2~k$iF+qeVqceCKk#K`
z4$Iwi!9%c7c>T`fONoJ^2hkhzkdqT<257{tyxhZXNk;Bo*5clE|j6+S&
zi9nClp?X+z>(~bzq#uv!|@Q00pDX1|KY(&To
zGY*muFFpdm%5-~Dvu!;)=A8%^gi!pQ9u)QC6oCbsF&G%l5W4WFGnqbhU3
zrxQ3BFEhMvZKrp-xHoykjli5fnLSbZN7W?dICM4oDnL%~oVneCWoIMZrx^DrtZ>pS
z`|uxqTifx93UY@Ud+R6fs_aRmDOp9!F6ZQN=yI}!bkQSz+F(E82@lyLbz0flngMd2
z7s<4>tU!
z0lLPAybSc{?=}q_f)CeCkR?mQ0F33W-G*&ydZ`gJpYc^UglmFt%zDOB~PokRph1g@#j^v6lNi7v`{K%v}CM=vt(j^ZN7;KV#xWYQtg1mFb11W;NsQ(OJ8
z+M=2Tb>$*fgvwUG@PdjxXC
zM+9bsbYDbpP0-IEYHTIW^U-S9*S-g!2as3cSNDgiGj9eRi~uwP%yNce)@JJv%vH=N
z<_x3ek?REAC7X?%&OX<^@SrPPuOV>eTGlYeG}HQt<6PP3no!%6ntm7mo1c3$h(TgG
zVo4)v@p&Yfg%0xG^06msbNYp}DQ>?}7=u+uxkk=e7#Sd0_o9LyPv~@a{
z-aA1CddCR*^eTkIg_{aW3=l?*6pDgP|El`$&emRpv`SD>mdsq;3?H0>-S
zEzd8n*A=XQE=x63)OQ$(*5B2RHLjUBui!K|H=(X3uW8%yVRK;#!C+#qiol7uM8icF
zW7*Edo(|iMJD1yf9QWIVIjC(bT-}@H9}LgOmWgDczbve5un)Pm-EGKn1^}Jj&4M!M(gmr*XOn8t=v-T
za`G1K&yUPBN6zx2Is=I^+_S%6(`6%uK+O
zOSLPT@0rh3OAir=f!IKDs#UL8&(_KV+Ha$`*uNg#5Soecwx+VXyj*jjpFJ2EmX7R9
zl7+*|?xplH67e9ES}aWrF|IV8hX{ZYMuOOq9f2>QIU&M&y@-)LPwa_xLUihd`Rb6i#i?Qc$
z)W~M)Ms|Eg9jh`mEA>;gif9Hk5Bq?@=sme50+`sJe9zLUc}MxS0{B^M1|b&N#h4;U
z?^D`Q%LCpK+{3q{i5q@)!Akc%n${E
ztf+4^o9)2b1ZuOb^NuG$1=``y!bjnm;SyoIw0qQ?Uw6gX65f~ESvBpBfkR=El%bRZ
zl-A`CDvAwi?v6dDL*}`Q^A(1b)M{^58~ct&;_KopRYm2=Ro1kTRF=y+ExHFmQ--~@
zX9xTT?vxP}NlG5e!&@$f^4o>06NBmDtlp~xt9It*%ZshzXQOeJ{gy9lSys}kUWcev
z+NI8Dmt>nahD9#M?ur@lrFG53Z5FxJ1#+Nsr
zmv5~U+VdR2WIu6ed-v=KYzRMv2YWexeaMuFnr{$KNkAue(6Tm0T5-A&Z;#%T^(aeg
z?`gEzaKE~(MfPJhSxGgoc!hhPy;({yb_eH;mWpi}?%>4{
z!1pU4@o2#J@CP6DIa1fnxe>r4e@zxx%O5hY9Ynw%r>7i5r6glEjHzs
zao@auyzs{0DQ|U%e77GOhALu4l9B)v-(zq9;2)p>K;NSu0N<_24}^b?e|(S0{!I@y
z1pxjV0|3DDef{oaasdBD0cy?x`qvnc?ysA-;he4C5J*!66$cf`-yHhZmNdEs)_R6C
zE|xZb0RXsMIKGFLh7P)TE|wNn_8czU1b-tqzQ=!&X$kQDhB%mW6R1ea;0apW8RD_f
z(9zHl@Ic_<;c?j+7;(r6iTsoO`yV%fiGza;2Q96$vonn|BaOA4F)ckiJ3B2M11$ps
z^*4gr-qp%M*M-{3p70++{v}7q&|crp)W*To+6wP4xw?ARjt<-e1b->|zu!OR>0oN~
zZ%tPA|1|5{K-$0V(9+Y;(f*(8Z&t3qs2p;J_SP1Te~DMLGIii#;QAZw`v;e_
zovGpXeE(wOq5mh#f71RJFKBIPV`pe@|DX8(r2Q{m#>Cpe`rFrbrut%54u*E$%>UH(
zuL=IYBmOCii}o*f{fGPhu{M8GzZZuGf{XV57McelsaSj(0DuobOo(5><;S__&kUr2
z6|X5AtTrq_oOQc%z}#(LI881DVF&y}L|8kFT>3Vg&^D56J+534eI}At^L8g@3X&J^
z88VDSO@1cXzEV6K;LzGJ;_VS=$n&1buM)R5b2GQg)U2$timi9I?|t2-+gVAITUM!C
z+tA*F8#FoxC#UnpW{2gP6UPA|VK+D(U;^YL0W=F_3N$P7hiN=qQ&{aVp4#ki
z4~E932w_mUMb-A8cNpGoZ|73435lT70|k#DfnC6qoD6YgAP{7#7P1JbsC!O;*8ygL
z_Z>{u@>@MH&J5INy7}J!o{fLcaRyIk&&*etz=$vQA1u(a&q5ZmOtXFvFXwl(cdM(b
zHA!3^%hSY?lGg8UTMCo}6qWbe;QyGQPaU|&%RzE{6lauy2%>YNQ_|o+?9PFkUZEWT
zgXUtgKAOzz2n#1eyj)T-hKZnr$I=Bx`yt{3Z-eziO^T#urXO3`2ZZ4-XT|J+`v8;~
zLULc4TB**>%-9b100F?&?B^2nq?2oDXkg(qo2&!njtDjg#WU(ozq!J#Egh0(O3E?Bw2+#a7x3m;y$pn&b=Tpq1k%!P+tP+52M*$*l
za|+eJ$0s0+&_c2!p`pemVw;UgvDq8{51BLILVe(bEOfT`CwTnUM&+;fCv%ts;o)J|
za*)KLM;&hK$^IE}(mW?biXy^~7i&$nb46>;=f`VBun4e8V^gOTqJNvL^AF3vFTN3c
z+jUc&K3U%}!%=LV-Qy4XaC!06%WCGQH^7q{0lA-7erG~twfcVYc)=+yA?j^8dgEI)
zfM@Gr@P9)7@}ds#EUs^jzPQ-P6wg;~O96>zVHT%PMh
znjkE@!TK`&?^s7*_R0SaPZ02OE31|EmpS?Z;*B=vyu;(E^A~tSb#vv)*DG1kC|(yI
zm&xe=h|0f%JH`|Ie5LNFqTmXPduODo72?Jf;Y?ld&&PwUw-)GrK_Bcwx{D{Ke&U(s3@F`wzE{W|90JXg0cc~
zyWJljA5X8L1&}p0G^~8u3(%6Z1#5`SzyowRu?9DP&PUl6=JV@r8IBQtg&)mY>dQ2
zp#`)+z9C4SIQZP^s%>#xXZfCy4TLX9({FnrBt%0|9RvKI_;h!L17zMq!tn@ky@7Qw
z-;-BeDu7`!IRMR4-~`Z53f*=WPI4?JocPgT6F|u*>y*!_5&{H%y_pJxXOs-i5_*0r
zZ3X>zU7^9}gS3fK7=*oJ2PB02XTA7m@(iB4qVmJSq>8lGW?I|
zAw+s<5+fbK(S9unu*^C~p?sjmf9?s;gZb3p3}#{jj)%
zMdw9R#dQKkOYcK+*#x8Ta?-g6bcrZrh3$Z$tw{d)$cFa)PFVt)(~#lxY%A@$JV#^q
zqrr_gi`Lr`d2l4u!{~E)2Nl~VM6jo`jS4tDWPBO;qEkE3C#&yOJUALUaPGySbL
z*Zf)5#IrWzl|#A6V)Mxc2QW{jcz4w0PVl3F`_ZK|67
zC^4Hic7MDuGZ(!uZ@l=t9?QhFTzSc+Zo6@Hdoborr8|H2{kXlo9p;!D66w7<);T#D1*G{c
z+V$(sl5KzqA-m=y>?i`4;U=atm4VEJEr$|_&`po#$?>vYv&;9)RsfHVI5YNVy>TL7
z!-ES)lb<7`zmHXnTSgdgVE}w$goG8MVXY}vj|JT4>(+#~`Ug6Ol7fni7Kh7dj9|C*
zz0+;HCkIC85ZL2sDC~X&`gBvf!|`U+7gZ^{>Yx&Y2G#mMsiMBn{ORKt>EyFdHups{;%Fg!?A}N;m{+(f}@3{
zuMTG{mh;=Sy1^`s9<44HMO7B-VMoMPJT(a3TKE`;|n#{Ey%)dJB^67)e3>zKtK!CZeGO7u%o*EmrZk@(PE8Mq>?><8Fx}R5K
zYNt8mXY#WGL5^_f-&1@)F1258PO;s~J{wLe;|FmxsGRg?jb+F%e8JzU3wnRgwoZ;a
z*6a64nfHlD*_~KaW*sImV`F0nV{!2{c4tXo^(L
zhH6Y^bKLhnP%daU+38LCt%{Dl@OiH_obF7|wpq(?%dJh&h{KVb>O)ux4r`$W!n5>0
z{Rv74339{GK!)?IO5r`12_W{NRHJ?D>ixy?YFhKK(e2G7)2@yCCfztAYJEe~&40HG
zES>HxOt?Q?Vt?;i#mBpDM=7qCc5?|5>&=%gdwYBR!JdojT9KRshM_3{CA{AIB)?u2
zV$#2;Im1-#)?-NW@D>fD(U)pkdOqaS5_61cjS@Ngi-szdjpK8a%!*^9WeN
zpneje2LX5OA1zw?PAX@zWvSW;9kU5~fa{pP6brslueCqSEq**_uvJ%Kz=&ZZ>DDid
z0DCN7x*1;xoVWqwHd2yAV|x$t7h(2{C6_(swT3pXpfYc$gIhH{VOK;f#mEqCU
z+_%+UbbF_W(QFUb
zzGz*l>+tJLqHt&nT~D#WIQ6$>*x8pWU#Ei=@vs*gMe4qgPcJ43#(hzs1sS7=O)VlL
zlz=@@M5AI|Wu@!{Dh$6~vw0D&n&EJ2-diiXKgFVvsP3lN3xQj?n!L=Fth9vW
z+2rx|0UVZTn`HyDC4ivTn$+kkG(|NUBS2+YHTb
z^1(cot+*bJXMcF^ME2l{;9&q)i-V-2yW4CnP6D}%1HB;_%vRg9&b9JZu2kopG_Q}x
z+u2KU$QJqrb8-&iZ>rSmsZ-+M@EV`nG%w$fT7LHhI$ye;VK-kPv=v_vT|+_%8(og8
zX8D}t_o^L^OPtylJ&WTYd!qT&LFFn*_%^pYK(<$}4%Y5_t+evYWOTsuWInK%S@+#)
z47?}0ZL-&752QQi8^|0t$v;wje1x|eGgX&+l*0K)
z&m@vYfPuW&eB1saGsl~Jb!V|$!r(Jr${Ki>rjZ-**1XHg`FQbVa>SF5#T)Q6`a`f4
zjEX}4!(!}n^2=%?5|hmKK!IG6)e7qmC`+fZ1!9oH>M(!FZ1CBHBrqM>_36#jqoc+0
z3WU6aeUUIO;CWwC`eAZ}QqlTM6f`ILMp^}fykVu7cQixL4=<_i`ppkLWzl43gRaeb
zh?ENKRLKhtBbl$ICGXDju?oR5H)p+Ikji)P+5=A4Gd_{X(Lns4{WhW907eS@`x
zH5pKnN!F%;fJ4wcY{_jwYgrV)Bv9wDcW+lwA9TVExf$pDf2{J+{<62Ua%$I2{=j4?
zD04t0vAwXxx>Ag2^qKvSF5kP6s5_}#&?EU^te^J3n%D)P)yT~PQvgf
zyg5)hc%Jd};EbH?+K_Esd@ZUtP{P@+_(xj&WTaU}K$qLH+UV!hXQu7&=Yu|CAp}R-`Aj-)Vn~QaEEd!ATu_h6x7;odKKV+iUH>tKJ
zF3_jJvSa{nC?En2bd4$g<3=3Ngo;5G9O=*ee{|XLI=Rm112iS7V=a
zY9Q{`wvZ%~A$G|QX`GFfn^tZ5hmcw`(m?6u16`Je1dI$Oqy2D(voV$_R)gyaV*q@s
zZkg+1R|!v#aeKJjTPBYesHC~s-#9p+Nyl}>E
zEWUO8BC&3^rYL<|$Yl!Xt&BV67rOV#cUX!lUM=+L<38Bpr^Ico~w$5fO4rlYX-V*vweQ~%*74j2j
zfe8t3D(7csMe!`|CbQ;Bf5i>!DwEEZVMZ;F!p|0B>XPiLBRSl=Hs>>!L!fA3V{k{+RAyoJ4m+uOMyi!{E
zUZ`{>h`LvP(u6o6F*1#Bm6}v&`h@Kq&QQCZwt6MDhmXh*jaatT*V#{%zEaO+YuvG-
zj+$*RCuG-LEGM4++Mkw!X1ymlz{oeW)mE5r&Q2&B2`&`^Re}MLIYw9*Zd(L6}Dh<<1`SFw49_M4Y{VpaW{&U&J
z_qU7pCt!N8$Z?onF7u5s3$kQaRRZB&DPUgN=j^HG$(O6lcoo#%Zcvwo?5@1ggkSO|
z!pKmDj1iZcy1^@F2MkN7>nb)PH>*U^%aXT|Y8AsCUM#vdD+P|lLmangC9#c)pTEI8A;lQf&G(N#W7ZBMDfDpdS4ZL{iNaWOK%Ar;IgNb3Zlz||0
zsA!VTO7mWNnh+1%?-2V)J6ClSTXYfeU&ZLv!V|=)A}IV()SX(+wYo9f+H7h`NB-&H
z`H!p=p$&Znq!GAkdz8^(+3$7vYp}na8$Fiw-=#72vpMSDUtn6E08NV)yyE&%S|o50
zOheK^u}Uk2?xnkGvzd4TJ$cvJ&(xAN*u?7s0uyHs;;?8xq7nO*{wy1GlGZDRLm76J
zFKKWTkY;I;2=)A_Uuc8KHm0n0h%3a&x^c_^=qcD{k&S|d824ChS+C
z6NKXel4xg0n9$t$kS=?uLA!p#We#4NpsIj|+s9RMOZeq&zTigbxr{9FS(jVrnzX%(
zx3y!~>Y>PtUqL|QAA_<`q58mMVV8SERx>cuu2hMYC-2cpU7C=j!P3-emLmHZ86GI6
zjk=OyAO#L_R?6RTRVGoz`m{@q3%RleUyvsS=Vh|zf4N6Z@Z}EFW^YG0prJ>HlL=o3
zIh_U)$>c|4^?Z#Sfoh3`4*IAVATc|Y;RPG#O?|Q$O5S8f7Gsq{R46^xb;$ZhcIf@m
zYzIWt%gR7u?u^IcAuM`;xH`?K&}Sx0=4KjqOmKmQ5x8fR>Q~%Jv4#44^FCOfe*%P}
zL|PFd_$5~S8_q#D3&5)bI9?%T3RkkY)m@?0w!vW>}w9DMl(7NhnnHzuz3rXq&
z!n~VA_?lYt(m--~xyp6&llL(k^ewlR%L>MCF8M(mQlQK5+0l
zEGwp2G1HRT_@u61SNr;2tgz040r5MtcgGQ3+VZbwa#vM_@{il1F_e1A~Dz#ka+(lt+~+47(t$x=IS-&V(B1PK)RI
zm8Jx+O(}HrPg;1pGw7nT0%AF{(UZ@gY(2w3RW{;ra3Lj#@%jGxdZ-(Y!5I-dtRKVX
zR3+7{dAh_}n0S4pwA{oMO%@6H)k-8c&}6-N@JxLmQ;RcsRL3j8D;uGOsp$z`)p;T=~fmvIq-n+MP4nHXP-^A5y
zxgs;ov!TnBA=ru{f)m}A%B@gH4GC@C6J;!#ttT^^$)!tLE^ZMZQ*YUwlkn%ZjDM06
zP|{C^6hq@b>A?0!#%$})!c{MZM!t@Dk&pyf``~8Nz0J==R*8#*Kd|>?kw;{?9{$ve
z+;hsU%bD*Lm12Vrggo2~9~SVkO%jCX3Qs!{$N|?wja6mP?HO8zH+iXRv74bPmr!R{
zqC&@Us2U+Q-rL1Y09qrRxaINgeeTOEzKzTd)jU>55spo)Bl7WC6H=9(a0rJB5~uu7
z=qalt$o0!QM%BJwpBt{Pe@$P^BYjm=Z8xoOYe8A8c6aqcb4^~i{47sPwSvbU#|pK6
zRyp5A7mb8p>!-Hqqw_cUTwTRH+%+5csCu;|&_CMuV$(sB>`F&VckE#`&F$KdGh_#J
zd^S?+F1qDx4@&iNOgUhMMfJE!TWuAM)St{e>G)z$m*+ZJGmfsAbT
zwCDJ84{l_*ynfd(GcM1fY$YlG`Wn6OsZ}SI|HdAkCPK4*J#3DozSz{hf5wsR;f=qN
zd}(eUr~f-aw}JZX00~BhQi5Rlq+TMcSV9-!fy=s`%z8!MOpC5XVy~iuOZ4eh1Du7+
zEMj#$k09aYqoqJpJ5@`|R*Z!g1(zF;8k350VHC^pnJj~OlVY<<&h`tZ=AU^{eQZm*4QX`8K8ppCD5=WsZMu@<4}
z=m2yv2d3}C#~?@}O#_K!1DIK2DtTlRTqZN_J6t+`^%`bT_!IE&81rtezH$4{I*Cr+
z)!#$JJ0K8*yv~J}th5=z)R5k?Jg>A|yfuW>i1ZL?ym7G3=2#?*wvfizjVLXql^|A1
zNr#S-SmvF4I)oRV{iWaaMSrs30jeTj2XkSyrAE){#Ij(5ut=w7MP*}M?>CsS)jMhp
zdiANh=cmXL
zowOkhDOjHm^|NjHe2yzBtq{?byO-yXvv`ihCrW`(m{-|ukBoJu2*+bn^hTgtXX&#W-#vJ_%!&U16ffVXcY|ow8}aCRI7JtEvCRNbisJ4my0SK7
z!Kd?gmDyQ7BppS4j~Rx3Kd`}tp(-og`*jO946*#>NxTss2=*>yUeeoK=#YC*@_uh!
z)Hv>E%{_b>hr6A1j*Rj~nRm0)QLG~j(xMI8_kw6XqN4du&b+2)n(WkZ8KiBc6EUcObSp_dYi?$^C+
zoGnDsJN3@VjKgE1KA@%g!Tz`LGS~_26te=g4mzBN?etY!J5B33X;q>MT=|D|jx|a6
zk6Kjnv@f58%;DAej7<)^8mf~`U}$ns+P`oBV>#(v9XW|zWr>vnqf_M`Kjr9$+;Zk~D0;Jodsu6NB|9gDkmQMnMVQdK~1V;bc;>UK7aa
zrsj^^LZpB#p(`=&I#|^dfhYPxeZluZNDeec)!b-Cr?v26&_Kf}KqNr#iYqzZ$>@u?
z8kgq3nii!GuWJl<-)D}J(5S7sfF|*A`qKIiDSfu#fPIOTCtXBHcRl)8C%1(FNtkMI)#
zBc}_8LX04Z)B-r&Fl`P%H)S0O!bb|=wGGJH_#ZgCc+CLl^#xv;){=imbrL(O36mu?^{RXe^MoX(zFn&BoO?aCS!AS%pwcp5y168
zPFhgTLT4FzTfeJSW>(PG_7vo?QY5Lf
zn1R6H@tXrMe81yHZ%^9}{kc=w8jY|l;Axe4rNM97-v;PY093KpE?v|q>wg>-Ht-KgtVI8$(dvLHQ
zKUV!V|6r?em?QEYnl$p*A)JV8sIpBeVa~c%uQSqc^gLc9^$ZSk80>hMzLhZG!Z_=^
zKMDNlea$VM(z`hwcWKT3K%ZexpAn8%YW*_Z%lm%5tCG3hIK#fOdG`LTVN@5+{&
z-^P;G2^Y)Jcm|gl++7slTUod(7{C~ubAHB|X+(xcH>@r&?kQPdVC~!>8MUe>Z{+wr
z6&!jL8vGj(Mu!nvr~7E~iDrwM=Sho5SZkiIXv~@QOHX`mjJ9Fhx~xkox&I-|U2uv}
z`?-($r+H!^V69FD>3TpCG;SLA88$ag*UeN$cwl{8{3NB|DdX*8Xz=5>Fr>;hWg(b{
zP6yFIl9dFLd6;2o5CKc-ifw7m_Adl@6?OHmVz@3nQ$(kuT!)_I*MzO=A$LI{R+gQ7
zA*jP$P#ddQZ-s?+ZY{md{q24$VX^ZqEO_cdn+fH;6;H0<$e%cpg9dBK^V6Uq>zDCu
z({_wP%?p{%#?UOFUC7NXx_0J}ZE>X#X=J0$L8J4vvM!teU`6oXb-ZYU_Fxr+c1(2x
z-MA$AN9wyifz}SW_X+Z0>n%T`VbJZFlY13spC~+8kz(V1Ta^p$fVO}Rk4xhTn)Bs5
zhYTjAzjlC1Z7Z-W#if)GGvfxqB@?ftxvILmto2m>W`TE1RRvrShuIQaln=kRSX9)Ax|p>=cK}I0&Uc0bG}Bh?wuq}_mCih!n;h%~
z40mr3b`ofL3zsso*vEGDnhQA$VDnMpa)s40a<#1Ycn7$ucePaTcnXu-UEMwo6r;gZ
zNcP)pqtTEMi$V(Efb)OZC$d<$#k|4-kAgiNlZgbsMP>ecY=BiNOC5Qebj)qPAwIdu
zd(oVxZLJo#(C36s6P>EsEj_x%iP&>b&tB`%>2@3!%cuW>xw%hN-9H%Ja}Ou|vU$yI
zNQwaWH2T~nAzo<+G4u0>uY$6~b|>4-*|$JiaA`ASFZ_wE*`X&sQD=7rctH*SrKid8
z{%htQ+5SpRucN^I6EbpeY-®$9Rg3Qn0YxS;_xuX4^4(=|5Sggs%v%oHm!!pD+r
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

literal 0
HcmV?d00001

diff --git a/Java基础教程/Java集合类/01 Java数据结构.md b/Java基础教程/Java集合类/01 Java数据结构.md
new file mode 100644
index 00000000..7f056f60
--- /dev/null
+++ b/Java基础教程/Java集合类/01 Java数据结构.md	
@@ -0,0 +1,267 @@
+
+# 数据结构
+
+## 1 线性数据结构
+数据存储的常用结构有：栈、队列、数组、链表和红黑树。我们分别来了解一下：
+
+### 栈
+
+- **栈**：**stack**,又称堆栈，它是运算受限的线性表，其限制是仅允许在标的一端进行插入和删除操作，不允许在其他任何位置进行添加、查找、删除等操作。
+
+简单的说：采用该结构的集合，对元素的存取有如下的特点
+
+- 先进后出（即，存进去的元素，要在后它后面的元素依次取出后，才能取出该元素）。例如，子弹压进弹夹，先压进去的子弹在下面，后压进去的子弹在上面，当开枪时，先弹出上面的子弹，然后才能弹出下面的子弹。
+
+- 栈的入口、出口的都是栈的顶端位置。
+
+  ![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613144909.png)
+
+这里两个名词需要注意：
+
+- **压栈**：就是存元素。即，把元素存储到栈的顶端位置，栈中已有元素依次向栈底方向移动一个位置。
+- **弹栈**：就是取元素。即，把栈的顶端位置元素取出，栈中已有元素依次向栈顶方向移动一个位置。
+
+### 队列
+
+- **队列**：**queue**,简称队，它同堆栈一样，也是一种运算受限的线性表，其限制是仅允许在表的一端进行插入，而在表的另一端进行删除。
+
+简单的说，采用该结构的集合，对元素的存取有如下的特点：
+
+- 先进先出（即，存进去的元素，要在后它前面的元素依次取出后，才能取出该元素）。例如，小火车过山洞，车头先进去，车尾后进去；车头先出来，车尾后出来。
+- 队列的入口、出口各占一侧。例如，下图中的左侧为入口，右侧为出口。
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613145012.bmp)
+
+### 数组
+
+- **数组**:**Array**,是有序的元素序列，数组是在内存中开辟一段连续的空间，并在此空间存放元素。就像是一排出租屋，有100个房间，从001到100每个房间都有固定编号，通过编号就可以快速找到租房子的人。
+
+简单的说,采用该结构的集合，对元素的存取有如下的特点：
+
+- 查找元素快：通过索引，可以快速访问指定位置的元素
+
+  ![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613144058.png)
+
+- 增删元素慢
+
+- **指定索引位置增加元素**：需要创建一个新数组，将指定新元素存储在指定索引位置，再把原数组元素根据索引，复制到新数组对应索引的位置。
+
+  ![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613144218.png)
+
+- **指定索引位置删除元素：**需要创建一个新数组，把原数组元素根据索引，复制到新数组对应索引的位置，原数组中指定索引位置元素不复制到新数组中。如下图
+
+  ![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613144337.png)
+
+### 链表
+
+- **链表**:**linked list**,由一系列结点node（链表中每一个元素称为结点）组成，结点可以在运行时动态生成。每个结点包括两个部分：一个是存储数据元素的数据域，另一个是存储下一个结点地址的指针域。我们常说的链表结构有单向链表与双向链表，那么这里给大家介绍的是**单向链表**。
+
+  ![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613144444.png)
+
+简单的说，采用该结构的集合，对元素的存取有如下的特点：
+
+- 多个结点之间，通过地址进行连接。例如，多个人手拉手，每个人使用自己的右手拉住下个人的左手，依次类推，这样多个人就连在一起了。
+
+  ![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613145131.png)
+
+- 查找元素慢：想查找某个元素，需要通过连接的节点，依次向后查找指定元素
+
+- 增删元素快：
+
+    * 增加元素：只需要修改连接下个元素的地址即可。
+
+      ![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613145412.png)
+
+    * 删除元素：只需要修改连接下个元素的地址即可。
+
+      ![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613145458.bmp)
+
+
+## 2 树型数据结构
+
+树具有的特点：
+
+1. 每一个节点有零个或者多个子节点
+
+2. 没有父节点的节点称之为根节点，**一个树最多有一个根节点。**
+
+3. 每一个非根节点有且只有一个父节点
+
+   ![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613145927.png) 
+
+| 名词     | 含义                                                         |
+| -------- | ------------------------------------------------------------ |
+| 节点     | 指树中的一个元素                                             |
+| 节点的度 | 节点拥有的子树的个数，二叉树的度不大于2                      |
+| 叶子节点 | 度为0的节点，也称之为终端结点                                |
+| 高度     | 叶子结点的高度为1，叶子结点的父节点高度为2，以此类推，根节点的高度最高 |
+| 层       | 根节点在第一层，以此类推                                     |
+| 父节点   | 若一个节点含有子节点，则这个节点称之为其子节点的父节点       |
+| 子节点   | 子节点是父节点的下一层节点                                   |
+| 兄弟节点 | 拥有共同父节点的节点互称为兄弟节点                           |
+
+### 二叉树
+
+如果树中的每个节点的子节点的个数不超过2，那么该树就是一个二叉树。
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613150057.png)
+
+### 二叉查找树/二叉排序树
+
+二叉查找树的特点：
+
+1. 左子树上所有的节点的值均小于等于他的根节点的值
+2. 右子树上所有的节点值均大于或者等于他的根节点的值
+3. 每一个子节点最多有两个子树
+
+案例演示(20,18,23,22,17,24,19)数据的存储过程；
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613150149.png)
+
+**增删改查的性能都很高！！！**
+
+遍历获取元素的时候可以按照"左中右"的顺序进行遍历；
+
+注意：二叉查找树存在的问题：会出现"瘸子"的现象，影响查询效率。
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613150220.png)
+
+### 平衡二叉树
+
+（基于查找二叉树，但是让树不要太高，尽量让树的元素均衡分布。这样综合性能就高了）
+
+#### 概述
+
+为了避免出现"瘸子"的现象，减少树的高度，提高我们的搜素效率，又存在一种树的结构："平衡二叉树"
+
+规则：**它的左右两个子树的高度差的绝对值不超过1，并且左右两个子树都是一棵平衡二叉树**
+
+如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613150348.png)
+
+如下图所示，左图是一棵平衡二叉树，根节点10，左右两子树的高度差是1，而右图，虽然根节点左右两子树高度差是0，但是右子树15的左右子树高度差为2，不符合定义，
+
+所以右图不是一棵平衡二叉树。
+
+#### 旋转
+
+在构建一棵平衡二叉树的过程中，当有新的节点要插入时，检查是否因插入后而破坏了树的平衡，如果是，则需要做旋转去改变树的结构。
+
+左旋：
+
+**左旋就是将节点的右支往左拉，右子节点变成父节点，并把晋升之后多余的左子节点出让给降级节点的右子节点；**
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613150534.png)
+
+右旋：
+
+**将节点的左支往右拉，左子节点变成了父节点，并把晋升之后多余的右子节点出让给降级节点的左子节点**
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613150600.png)
+
+举个例子，像上图是否平衡二叉树的图里面，左图在没插入前"19"节点前，该树还是平衡二叉树，但是在插入"19"后，导致了"15"的左右子树失去了"平衡"，
+
+所以此时可以将"15"节点进行左旋，让"15"自身把节点出让给"17"作为"17"的左树，使得"17"节点左右子树平衡，而"15"节点没有子树，左右也平衡了。如下图，
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613150700.png) 
+
+由于在构建平衡二叉树的时候，当有**新节点插入**时，都会判断插入后时候平衡，这说明了插入新节点前，都是平衡的，也即高度差绝对值不会超过1。当新节点插入后，
+
+有可能会有导致树不平衡，这时候就需要进行调整，而可能出现的情况就有4种，分别称作**左左，左右，右左，右右**。
+
+##### 左左
+
+左左即为在原来平衡的二叉树上，在节点的左子树的左子树下，有新节点插入，导致节点的左右子树的高度差为2，如下即为"10"节点的左子树"7"的左子树"4"，插入了节点"5"或"3"导致失衡。
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613150825.png) 
+
+
+
+左左调整其实比较简单，只需要对节点进行右旋即可，如下图，对节点"10"进行右旋，
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613150922.png) 
+
+
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613151000.png) 
+
+
+
+##### 左右
+
+左右即为在原来平衡的二叉树上，在节点的左子树的右子树下，有新节点插入，导致节点的左右子树的高度差为2，如上即为"11"节点的左子树"7"的右子树"9"，
+
+插入了节点"10"或"8"导致失衡。
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613151051.png) 
+
+左右的调整就不能像左左一样，进行一次旋转就完成调整。我们不妨先试着让左右像左左一样对"11"节点进行右旋，结果图如下，右图的二叉树依然不平衡，而右图就是接下来要
+
+讲的右左，即左右跟右左互为镜像，左左跟右右也互为镜像。
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613151113.png) 
+
+
+
+左右这种情况，进行一次旋转是不能满足我们的条件的，正确的调整方式是，将左右进行第一次旋转，将左右先调整成左左，然后再对左左进行调整，从而使得二叉树平衡。
+
+即先对上图的节点"7"进行左旋，使得二叉树变成了左左，之后再对"11"节点进行右旋，此时二叉树就调整完成，如下图:
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613151248.png) 
+
+
+
+##### 右左
+
+右左即为在原来平衡的二叉树上，在节点的右子树的左子树下，有新节点插入，导致节点的左右子树的高度差为2，如上即为"11"节点的右子树"15"的左子树"13"，
+
+插入了节点"12"或"14"导致失衡。
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613151443.png) 
+
+
+
+前面也说了，右左跟左右其实互为镜像，所以调整过程就反过来，先对节点"15"进行右旋，使得二叉树变成右右，之后再对"11"节点进行左旋，此时二叉树就调整完成，如下图:
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613151525.png) 
+
+
+
+##### 右右
+
+右右即为在原来平衡的二叉树上，在节点的右子树的右子树下，有新节点插入，导致节点的左右子树的高度差为2，如下即为"11"节点的右子树"13"，的左子树"15"，插入了节点
+
+"14"或"19"导致失衡。
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613151608.png) 
+
+
+
+右右只需对节点进行一次左旋即可调整平衡，如下图，对"11"节点进行左旋。
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613151638.png) 
+
+
+
+### 红黑树
+
+就是平衡的二叉查找树！！
+
+红黑树是一种自平衡的二叉查找树，是计算机科学中用到的一种数据结构，它是在1972年由Rudolf Bayer发明的，当时被称之为平衡二叉B树，后来，在1978年被Leoj.Guibas和Robert Sedgewick修改为如今的"红黑树"。它是一种特殊的二叉查找树，红黑树的每一个节点上都有存储位表示节点的颜色，可以是红或者黑；
+
+红黑树不是高度平衡的，它的平衡是通过"红黑树的特性"进行实现的；
+
+红黑树的特性：
+
+1. 每一个节点或是红色的，或者是黑色的。
+2. 根节点必须是黑色
+3. 每个叶节点(Nil)是黑色的；（如果一个节点没有子节点或者父节点，则该节点相应的指针属性值为Nil，这些Nil视为叶节点）
+4. 如果某一个节点是红色，那么它的子节点必须是黑色(不能出现两个红色节点相连的情况)
+5. 对每一个节点，从该节点到其所有后代叶节点的简单路径上，均包含相同数目的黑色节点；
+
+如下图所示就是一个
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613151901.png) 
+
+在进行元素插入的时候，和之前一样； 每一次插入完毕以后，使用黑色规则进行校验，如果不满足红黑规则，就需要通过变色，左旋和右旋来调整树，使其满足红黑规则；
\ No newline at end of file
diff --git a/Java基础教程/Java集合类/02 JavaCollection.md b/Java基础教程/Java集合类/02 JavaCollection.md
new file mode 100644
index 00000000..1483cde1
--- /dev/null
+++ b/Java基础教程/Java集合类/02 JavaCollection.md	
@@ -0,0 +1,64 @@
+## 准备知识
+数据结构分为
+
+* 线性数据结构
+* 树型数据结构
+* 图型数据结构
+
+
+C++中的容器分为（都是线性的）
+* 顺序容器
+  * array 数组
+  * vector向量
+  * list 链表
+* 关联容器
+  * map 映射
+  * set 集合
+* 容器适配器
+  * stack 栈
+  * queue 队列
+
+
+Java中的容器分为（都是线性的）
+* 集合collection
+  * List
+  * Queue
+  * Set
+  * Map
+
+![](image/2022-11-08-10-51-54.png)
+
+![](image/2022-11-08-10-54-19.png)
+
+![](image/2022-12-04-22-53-11.png)
+## 体系
+
++   [Java 集合 - `List`](2.md)
+    +   [`ArrayList`](3.md)
+    +   [链表](47.md)
+    +   [`Vector`](81.md)
++   [Java 集合 - `Set`](102.md)
+    +   [`HashSet`](103.md)
+    +   [`LinkedHashSet`](111.md)
+    +   [`TreeSet`](114.md)
++   [Java 集合 - `Map`](117.md)
+    +   [`HashMap`](118.md)
+    +   [`TreeMap`](142.md)
+    +   [`LinkedHashMap`](148.md)
++   [Java 集合 - `Iterator`/`ListIterator`](152.md)
++   [`Comparable`和`Comparator`接口](155.md)
++   [集合面试问题](158.md)
+
+
+## 集合框架总览
+
+
+1. 集合框架提供了两个遍历接口：`Iterator`和`ListIterator`，其中后者是前者的`优化版`，支持在任意一个位置进行**前后双向遍历**。注意图中的`Collection`应当继承的是`Iterable`而不是`Iterator`，后面会解释`Iterable`和`Iterator`的区别
+2. 整个集合框架分为两个门派（类型）：`Collection`和`Map`，前者是一个容器，存储一系列的**对象**；后者是键值对``，存储一系列的**键值对**
+3. 在集合框架体系下，衍生出四种具体的集合类型：`Map`、`Set`、`List`、`Queue`
+4. `Map`存储``键值对，查找元素时通过`key`查找`value`
+5. `Set`内部存储一系列**不可重复**的对象，且是一个**无序**集合，对象排列顺序不一
+6. `List`内部存储一系列**可重复**的对象，是一个**有序**集合，对象按插入顺序排列
+7. `Queue`是一个**队列**容器，其特性与`List`相同，但只能从`队头`和`队尾`操作元素
+8. JDK 为集合的各种操作提供了两个工具类`Collections`和`Arrays`，之后会讲解工具类的常用方法
+9. 四种抽象集合类型内部也会衍生出许多具有不同特性的集合类，**不同场景下择优使用，没有最佳的集合**
\ No newline at end of file
diff --git a/Java基础教程/Java集合类/03 List-ArrayList.md b/Java基础教程/Java集合类/03 List-ArrayList.md
new file mode 100644
index 00000000..452c55cb
--- /dev/null
+++ b/Java基础教程/Java集合类/03 List-ArrayList.md	
@@ -0,0 +1,616 @@
+# List 接口
+
+## 1 概述
+
+### 简介
+List 接口和 Set 接口齐头并进，是我们日常开发中接触的很多的一种集合类型了。整个 List 集合的组成部分如下图
+
+![](image/2022-12-04-22-09-27.png)
+
+`List` 接口直接继承 Collection 接口，它定义为可以存储**重复**元素的集合，并且元素按照插入顺序**有序排列**，且可以通过**索引**访问指定位置的元素。常见的实现有：ArrayList、LinkedList、Vector和Stack
+
+### AbstractList  和 AbstractSequentialList
+
+AbstractList 抽象类实现了 List 接口，其内部实现了所有的 List 都需具备的功能，子类可以专注于实现自己具体的操作逻辑。
+
+```java
+// 查找元素 o 第一次出现的索引位置
+public int indexOf(Object o)
+// 查找元素 o 最后一次出现的索引位置
+public int lastIndexOf(Object o)
+//···
+```
+
+AbstractSequentialList 抽象类继承了 AbstractList，在原基础上限制了访问元素的顺序**只能够按照顺序访问**，而**不支持随机访问**，如果需要满足随机访问的特性，则继承 AbstractList。子类 LinkedList 使用链表实现，所以仅能支持**顺序访问**，顾继承了 `AbstractSequentialList`而不是 AbstractList。
+
+
+
+
+
+## 2 ArrayList
+
+### 概述
+ArrayList 以**数组**作为存储结构，它是**线程不安全**的集合；具有**查询快、在数组中间或头部增删慢**的特点，所以它除了线程不安全这一点，其余可以替代`Vector`，而且线程安全的 ArrayList 可以使用 `CopyOnWriteArrayList`代替 Vector。
+
+![](image/2022-12-04-22-17-09.png)
+
+关于 ArrayList 有几个重要的点需要注意的：
+
+- 具备**随机访问**特点，**访问元素的效率**较高，ArrayList 在**频繁插入、删除**集合元素的场景下效率较`低`。
+
+- 底层数据结构：ArrayList 底层使用数组作为存储结构，具备**查找快、增删慢**的特点
+
+- 线程安全性：ArrayList 是**线程不安全**的集合
+
+- ArrayList **首次扩容**后的长度为 `10`，调用 `add()` 时需要计算容器的最小容量。可以看到如果数组`elementData`为空数组，会将最小容量设置为`10`，之后会将数组长度完成首次扩容到 10。
+
+另外一篇文章
+* Ordered – arraylist中的元素保留其排序，默认情况下是其添加到列表的顺序。
+* Index based –可以使用索引位置随机访问元素。 索引以'0'开头。
+* Dynamic resizing –当需要添加的元素数量超过当前大小时，ArrayList会动态增长。
+* Non synchronized –默认情况下，ArrayList不同步。 程序员需要适当地使用synchronized关键字，或者仅使用Vector类。
+* Duplicates allowed -我们可以在arraylist中添加重复元素。 不能成组放置。
+
+```Java
+// new ArrayList 时的默认空数组
+private static final Object[] DEFAULTCAPACITY_EMPTY_ELEMENTDATA = {};
+// 默认容量
+private static final int DEFAULT_CAPACITY = 10;
+// 计算该容器应该满足的最小容量
+private static int calculateCapacity(Object[] elementData, int minCapacity) {
+    if (elementData == DEFAULTCAPACITY_EMPTY_ELEMENTDATA) {
+        return Math.max(DEFAULT_CAPACITY, minCapacity);
+    }
+    return minCapacity;
+}
+```
+
+- 集合从**第二次扩容**开始，数组长度将扩容为原来的 `1.5` 倍，即：`newLength = oldLength * 1.5`
+
+![](image/2022-12-04-22-20-35.png)
+
+### 构造函数
+
+* 没有逐个元素初始化的方法，使用Arrays.asList能够添加对象初始化。
+```java
+//Empty arraylist
+List names = new ArrayList<>(); 
+ 
+//Arraylist initialized with another collection
+List numbers = new ArrayList<>(Arrays.asList(1,2,3,4,5)); 
+```
+
+
+### 常用方法
+
+* add()添加单个元素
+```java
+public boolean add(E e) {
+    ensureCapacityInternal(size + 1);  // Increments modCount!!
+    elementData[size++] = e;
+    return true;
+}
+```
+* addAll()方法将给定集合的所有元素添加到arraylist中。 始终使用泛型来确保您仅在给定列表中添加某种类型的元素。
+
+```java
+import java.util.ArrayList;
+ 
+public class ArrayListExample 
+{
+    public static void main(String[] args) 
+    {
+        ArrayList list1 = new ArrayList<>();    //list 1
+         
+        list1.add("A");
+        list1.add("B");
+        list1.add("C");
+        list1.add("D");
+         
+        ArrayList list2 = new ArrayList<>();    //list 2
+         
+        list2.add("E");
+         
+        list1.addAll(list2);
+         
+        System.out.println(list1);      //combined list
+    }
+}
+```
+* clear()方法将arraylist clear
+
+```java
+import java.util.ArrayList;
+ 
+public class ArrayListExample 
+{
+    public static void main(String[] args) 
+    {
+        ArrayList arrayList = new ArrayList<>(); 
+         
+        arrayList.add("A");
+        arrayList.add("B");
+        arrayList.add("C");
+        arrayList.add("D");
+         
+        System.out.println(arrayList);   
+         
+        arrayList.clear();
+         
+        System.out.println(arrayList);   
+    }
+}
+```
+
+* clone()方法创建arraylist的浅表副本 。
+```java
+import java.util.ArrayList;
+ 
+public class ArrayListExample 
+{
+    @SuppressWarnings("unchecked")
+    public static void main(String[] args) 
+    {
+        ArrayList arrayListObject = new ArrayList<>(); 
+         
+        arrayListObject.add("A");
+        arrayListObject.add("B");
+        arrayListObject.add("C");
+        arrayListObject.add("D");
+         
+        System.out.println(arrayListObject);   
+         
+        ArrayList arrayListClone =  (ArrayList) arrayListObject.clone();
+         
+        System.out.println(arrayListClone);   
+    }
+}
+```
+* clone深拷贝。创建集合的深层副本非常容易。 我们需要创建一个新的collection实例，并将给定collection中的所有元素一一复制到克隆的collection中。 请注意，我们将在克隆集合中复制元素的克隆。
+```java
+ArrayList employeeList = new ArrayList<>(); 
+ArrayList employeeListClone = new ArrayList<>();
+ 
+Iterator iterator = employeeList.iterator();
+ 
+while(iterator.hasNext())
+{
+    //Add the object clones
+    employeeListClone.add((Employee) iterator.next().clone());  
+}
+```
+* cantains()数组列表中存储了几个字母。 我们将尝试找出列表中是否包含字母“ A”和“ Z”。
+```java
+public class ArrayListExample 
+{
+    public static void main(String[] args) 
+    {
+        ArrayList list = new ArrayList<>(2);
+         
+        list.add("A");
+        list.add("B");
+        list.add("C");
+        list.add("D");
+         
+        System.out.println( list.contains("A") );       //true
+         
+        System.out.println( list.contains("Z") );       //false
+    }
+}
+```
+
+* indexOf()判断是否存在.返回此列表中指定元素的首次出现的索引。 如果列表不包含元素，它将返回'-1' 。
+
+```java
+public class ArrayListExample 
+{
+    public static void main(String[] args) 
+    {
+        ArrayList list = new ArrayList<>(2);
+         
+        list.add("A");
+        list.add("B");
+        list.add("C");
+        list.add("D");
+         
+        System.out.println( list.indexOf("A") > 0 );       //true
+         
+        System.out.println( list.indexOf("Z") > 0);       //false
+    }
+}
+```
+* lastIndexOf()返回此列表中最后一次出现的指定元素的索引。 如果列表不包含元素，它将返回'-1' 。
+
+```java
+public int lastIndexOf(Object object) {
+    if (o == null) {
+        for (int i = size-1; i >= 0; i--)
+            if (elementData[i]==null)
+                return i;
+    } else {
+        for (int i = size-1; i >= 0; i--)
+            if (o.equals(elementData[i]))
+                return i;
+    }
+    return -1;
+}
+
+```
+* get(int index)方法返回列表中指定位置'index'处的元素。
+```java
+import java.util.ArrayList;
+import java.util.Arrays;
+ 
+public class ArrayListExample 
+{
+    public static void main(String[] args) 
+    {
+        ArrayList list = new ArrayList<>(Arrays.asList("alex", "brian", "charles", "dough"));
+         
+        String firstName = list.get(0);         //alex
+        String secondName = list.get(1);        //brian
+         
+        System.out.println(firstName);
+        System.out.println(secondName);
+    }
+}
+```
+
+* boolean remove(Object o) –从列表中删除第一次出现的指定元素。 true从列表中删除了任何元素，则返回true ，否则返回false 。对象remove（int index）引发IndexOutOfBoundsException-移除此列表中指定位置的元素。 将所有后续元素向左移动。 返回从列表中移除的元素。 如果参数索引无效，则引发异常。
+
+```java
+import java.util.ArrayList;
+import java.util.Arrays;
+ 
+public class ArrayListExample 
+{
+    public static void main(String[] args) throws CloneNotSupportedException 
+    {
+        ArrayList alphabets = new ArrayList<>(Arrays.asList("A", "B", "C", "D"));
+         
+        System.out.println(alphabets);
+         
+        alphabets.remove("C");          //Element is present
+         
+        System.out.println(alphabets);
+         
+        alphabets.remove("Z");          //Element is NOT present
+         
+        System.out.println(alphabets);
+    }
+}
+```
+* removeAll()方法遍历arraylist的所有元素。 对于每个元素，它将元素传递给参数集合的contains()方法。如果在参数集合中找到element，它将重新排列索引。 如果未找到element，则将其保留在后备数组中。
+
+```java
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+ 
+public class ArrayListExample 
+{
+    public static void main(String[] args) throws CloneNotSupportedException 
+    {
+        ArrayList alphabets = new ArrayList<>(Arrays.asList("A", "B", "A", "D", "A"));
+         
+        System.out.println(alphabets);
+         
+        alphabets.removeAll(Collections.singleton("A"));
+         
+        System.out.println(alphabets);
+    }
+}
+```
+
+* removeIf()方法采用Predicate类型的单个参数。 谓词接口是一种功能接口，表示一个参数的条件（布尔值函数）。 它检查给定参数是否满足条件。
+
+```java
+import java.util.ArrayList;
+import java.util.Arrays;
+ 
+public class ArrayListExample 
+{
+    public static void main(String[] args) throws CloneNotSupportedException 
+    {
+        ArrayList numbers = new ArrayList<>(Arrays.asList(1,2,3,4,5,6,7,8,9,10));
+ 
+        numbers.removeIf( number -> number%2 == 0 );
+         
+        System.out.println(numbers);
+    }
+}
+
+```
+
+* retainAll()方法来保留列表中存在于指定参数集合中的所有元素。
+
+```java
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+ 
+public class ArrayListExample 
+{
+    public static void main(String[] args) throws CloneNotSupportedException 
+    {
+        ArrayList alphabets = new ArrayList<>(Arrays.asList("A", "B", "A", "D", "A"));
+         
+        System.out.println(alphabets);
+         
+        alphabets.retainAll(Collections.singleton("A"));
+         
+        System.out.println(alphabets);
+    }
+}
+```
+
+* sort()方法使用Arrays.sort()方法对列表中的元素进行比较和排序。sort()方法接受Comparator实现类的实例，该实例必须能够比较arraylist中包含的元素
+
+```java
+import java.util.Comparator;
+ 
+public class NameSorter implements Comparator 
+{
+    @Override
+    public int compare(Employee o1, Employee o2) {
+        return o1.getName().compareToIgnoreCase(o1.getName());
+    }
+}
+
+
+import java.time.LocalDate;
+import java.time.Month;
+import java.util.ArrayList;
+ 
+public class ArrayListExample 
+{
+    public static void main(String[] args) throws CloneNotSupportedException 
+    {
+        ArrayList employees = new ArrayList<>();
+         
+        employees.add(new Employee(1l, "Alex", LocalDate.of(2018, Month.APRIL, 21)));
+        employees.add(new Employee(4l, "Brian", LocalDate.of(2018, Month.APRIL, 22)));
+        employees.add(new Employee(3l, "David", LocalDate.of(2018, Month.APRIL, 25)));
+        employees.add(new Employee(5l, "Charles", LocalDate.of(2018, Month.APRIL, 23)));
+        employees.add(new Employee(2l, "Edwin", LocalDate.of(2018, Month.APRIL, 24)));
+                
+        employees.sort(new NameSorter());
+        System.out.println(employees);
+    }
+}
+
+```
+
+* toArray()将arraylist转换为对象数组并遍历数组内容
+
+```java
+import java.util.ArrayList;
+import java.util.Arrays;
+ 
+public class ArrayListExample 
+{
+    public static void main(String[] args) 
+    {
+        ArrayList list = new ArrayList<>(2);
+         
+        list.add("A");
+        list.add("B");
+        list.add("C");
+        list.add("D");
+         
+        //Convert to object array
+        Object[] array = list.toArray();
+         
+        System.out.println( Arrays.toString(array) );
+ 
+        //Iterate and convert to desired type
+        for(Object o : array) {
+            String s = (String) o;
+             
+            System.out.println(s);
+        }
+    }
+}
+// 可以控制转换完成的结果。
+import java.util.ArrayList;
+import java.util.Arrays;
+ 
+public class ArrayListExample 
+{
+    public static void main(String[] args) 
+    {
+        ArrayList list = new ArrayList<>(2);
+         
+        list.add("A");
+        list.add("B");
+        list.add("C");
+        list.add("D");
+         
+        //Convert to string array
+        String[] array = list.toArray(new String[list.size()]);
+         
+        System.out.println(Arrays.toString(array));
+    }
+}
+```
+
+* sublist获取子列表
+
+```java
+import java.util.ArrayList;
+import java.util.Arrays;
+ 
+public class ArrayListExample 
+{
+    public static void main(String[] args) 
+    {
+        ArrayList list = new ArrayList<>(Arrays.asList(0,1,2,3,4,5,6,7,8,9));
+         
+        ArrayList sublist = new ArrayList( list.subList(2, 6) );
+         
+        System.out.println(sublist);
+    }
+}
+```
+
+
+### 遍历方法
+五种loop ArrayList 
+
+* Java程序使用standard for loop遍历对象的数组列表。(能够控制遍历计数，方便进行排序等算法操作)
+
+```java
+ArrayList namesList = new ArrayList(Arrays.asList( "alex", "brian", "charles") );
+         
+for(int i = 0; i < namesList.size(); i++)
+{
+    System.out.println(namesList.get(i));
+}
+```
+* 使用foreach loop遍历对象的数组列表。（最方便的遍历。）
+
+```java
+ArrayList namesList = new ArrayList(Arrays.asList( "alex", "brian", "charles") );
+         
+for(String name : namesList)
+{
+    System.out.println(name);
+}
+```
+* 使用列表迭代器对象迭代对象的数组列表。(能够在遍历的时候删除。)
+```java
+ArrayList namesList = new ArrayList(Arrays.asList( "alex", "brian", "charles") );
+         
+ListIterator listItr = namesList.listIterator();
+ 
+while(listItr.hasNext())
+{
+    System.out.println(listItr.next());
+}
+```
+
+* while循环。（可能在某些算法中比较方便，除非你想让循环体控制遍历计数）
+
+```java
+ArrayList namesList = new ArrayList(Arrays.asList( "alex", "brian", "charles") );
+ 
+int index = 0;          
+while (namesList.size() > index) 
+{
+   System.out.println(namesList.get(index++));
+}
+```
+* 使用Java 8流API遍历对象的数组列表。 使用stream.foreach()方法从arraylist对象创建元素流，并stream.foreach()获取元素。
+```java
+Iterate arraylist with stream api
+ArrayList namesList = new ArrayList(Arrays.asList( "alex", "brian", "charles") );
+namesList.forEach(name -> System.out.println(name));
+```
+
+* listIterator()方法获得的列表迭代器来迭代arraylist。ListIterator支持在迭代列表时添加和删除列表中的元素。
+  * listIterator.add(Element e) –将该元素立即插入将由next()返回的元素之前或将要返回的previous()方法的元素之后。
+  * listIterator.remove() –从列表中删除next()或previous()方法返回的最后一个元素。
+
+```java
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.ListIterator;
+ 
+public class ArrayListExample 
+{
+    public static void main(String[] args) throws CloneNotSupportedException 
+    {
+        ArrayList alphabets = new ArrayList<>(Arrays.asList("A", "B", "C", "D"));
+         
+        ListIterator listItr = alphabets.listIterator();
+         
+        System.out.println("===========Forward=========");
+         
+        while(listItr.hasNext()) {
+            System.out.println(listItr.next());
+        }
+         
+        System.out.println("===========Backward=========");
+         
+        while(listItr.hasPrevious()) {
+            System.out.println(listItr.previous());
+        }
+    }
+}
+```
+
+## 3 LinkedList
+
+LinkedList 底层采用`双向链表`数据结构存储元素，由于链表的内存地址`非连续`，所以它不具备随机访问的特点，但由于它利用指针连接各个元素，所以插入、删除元素只需要`操作指针`，不需要`移动元素`，故具有**增删快、查询慢**的特点。它也是一个非线程安全的集合。
+
+![image.png](https://cdn.nlark.com/yuque/0/2020/png/1694029/1595393003456-d37281f4-8332-46b4-9d81-e1f0c24dc060.png)
+
+由于以双向链表作为数据结构，它是**线程不安全**的集合；存储的每个节点称为一个`Node`，下图可以看到 Node 中保存了`next`和`prev`指针，`item`是该节点的值。在插入和删除时，时间复杂度都保持为 `O(1)`
+
+![image.png](https://cdn.nlark.com/yuque/0/2020/png/1694029/1595725358023-1f64f780-9dd0-47ff-a84c-d4101d16c1e1.png)
+
+关于 LinkedList，除了它是以链表实现的集合外，还有一些特殊的特性需要注意的。
+
+- 优势：LinkedList 底层没有`扩容机制`，使用`双向链表`存储元素，所以插入和删除元素效率较高，适用于频繁操作元素的场景
+- 劣势：LinkedList 不具备`随机访问`的特点，查找某个元素只能从 `head` 或 `tail` 指针一个一个比较，所以**查找中间的元素时效率很低**
+- 查找优化：LinkedList 查找某个下标 `index` 的元素时**做了优化**，若 `index > (size / 2)`，则从 `head` 往后查找，否则从 `tail` 开始往前查找，代码如下所示：
+
+```Java
+LinkedList.Node node(int index) {
+    LinkedList.Node x;
+    int i;
+    if (index < this.size >> 1) { // 查找的下标处于链表前半部分则从头找
+        x = this.first;
+        for(i = 0; i < index; ++i) { x = x.next; }
+        return x;
+    } else { // 查找的下标处于数组的后半部分则从尾开始找
+        x = this.last;
+        for(i = this.size - 1; i > index; --i) { x = x.prev; }
+        return x;
+    }
+}
+```
+
+- 双端队列：使用双端链表实现，并且实现了 `Deque` 接口，使得 LinkedList 可以用作**双端队列**。下图可以看到 Node 是集合中的元素，提供了前驱指针和后继指针，还提供了一系列操作`头结点`和`尾结点`的方法，具有双端队列的特性。
+
+![image.png](https://cdn.nlark.com/yuque/0/2020/png/1694029/1595693779116-a8156f03-36fa-4557-892e-ea5103b06136.png)
+
+LinkedList 集合最让人树枝的是它的链表结构，但是我们同时也要注意它是一个双端队列型的集合。
+
+```java
+Deque deque = new LinkedList<>();
+```
+
+### Vector
+
+![image.png](https://cdn.nlark.com/yuque/0/2020/png/1694029/1595375364068-c2c49168-a2f4-4a06-97c0-eb3446d60a68.png)
+
+`Vector` 在现在已经是一种过时的集合了，包括继承它的 `Stack` 集合也如此，它们被淘汰的原因都是因为**性能**低下。
+
+> JDK 1.0 时代，ArrayList 还没诞生，大家都是使用 Vector 集合，但由于 Vector 的**每个操作**都被 **synchronized** 关键字修饰，即使在线程安全的情况下，仍然**进行无意义的加锁与释放锁**，造成额外的性能开销，做了无用功。
+
+```java
+public synchronized boolean add(E e);
+public synchronized E get(int index);
+```
+
+在 JDK 1.2 时，Collection 家族出现了，它提供了大量**高性能、适用於不同场合**的集合，而 Vector 也是其中一员，但由于 Vector 在每个方法上都加了锁，由于需要兼容许多老的项目，很难在此基础上优化`Vector`了，所以渐渐地也就被历史淘汰了。
+
+现在，在**线程安全**的情况下，不需要选用 Vector 集合，取而代之的是 **ArrayList** 集合；在并发环境下，出现了 `CopyOnWriteArrayList`，Vector 完全被弃用了。
+
+### Stack
+
+![img](https://cdn.nlark.com/yuque/0/2020/png/1694029/1596126551356-dc1af780-2fe9-4d04-8351-e70637ecdab5.png)
+
+`Stack`是一种`后入先出（LIFO）`型的集合容器，如图中所示，`大雄`是最后一个进入容器的，top指针指向大雄，那么弹出元素时，大雄也是第一个被弹出去的。
+
+Stack 继承了 Vector 类，提供了栈顶的压入元素操作（push）和弹出元素操作（pop），以及查看栈顶元素的方法（peek）等等，但由于继承了 Vector，正所谓跟错老大没福报，Stack 也渐渐被淘汰了。
+
+取而代之的是后起之秀 `Deque`接口，其实现有 `ArrayDeque`，该数据结构更加完善、可靠性更好，依靠队列也可以实现`LIFO`的栈操作，所以优先选择 ArrayDeque 实现栈。
+
+```java
+Deque stack = new ArrayDeque();
+```
+
+ArrayDeque 的数据结构是：`数组`，并提供**头尾指针下标**对数组元素进行操作。本文也会讲到哦，客官请继续往下看，莫着急！:smile:
+	
\ No newline at end of file
diff --git a/Java基础教程/Java容器/12 JavaQueue.md b/Java基础教程/Java集合类/12 JavaQueue.md
similarity index 100%
rename from Java基础教程/Java容器/12 JavaQueue.md
rename to Java基础教程/Java集合类/12 JavaQueue.md
diff --git a/Java基础教程/Java容器/13 JavaSet.md b/Java基础教程/Java集合类/13 JavaSet.md
similarity index 100%
rename from Java基础教程/Java容器/13 JavaSet.md
rename to Java基础教程/Java集合类/13 JavaSet.md
diff --git a/Java基础教程/Java容器/14 JavaMap.md b/Java基础教程/Java集合类/14 JavaMap.md
similarity index 100%
rename from Java基础教程/Java容器/14 JavaMap.md
rename to Java基础教程/Java集合类/14 JavaMap.md
diff --git a/Java基础教程/Java容器/15 Java容器底层结构.md b/Java基础教程/Java集合类/15 Java容器底层结构.md
similarity index 100%
rename from Java基础教程/Java容器/15 Java容器底层结构.md
rename to Java基础教程/Java集合类/15 Java容器底层结构.md
diff --git a/Java基础教程/Java标准库/image/2022-11-08-10-51-54.png b/Java基础教程/Java集合类/image/2022-11-08-10-51-54.png
similarity index 100%
rename from Java基础教程/Java标准库/image/2022-11-08-10-51-54.png
rename to Java基础教程/Java集合类/image/2022-11-08-10-51-54.png
diff --git a/Java基础教程/Java标准库/image/2022-11-08-10-54-19.png b/Java基础教程/Java集合类/image/2022-11-08-10-54-19.png
similarity index 100%
rename from Java基础教程/Java标准库/image/2022-11-08-10-54-19.png
rename to Java基础教程/Java集合类/image/2022-11-08-10-54-19.png
diff --git a/Java基础教程/Java集合类/image/2022-12-04-22-09-27.png b/Java基础教程/Java集合类/image/2022-12-04-22-09-27.png
new file mode 100644
index 0000000000000000000000000000000000000000..d5497efa3c38e5f5696efbd0b6d5e356497db52d
GIT binary patch
literal 33420
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
F{|9$GDqjEq

literal 0
HcmV?d00001

diff --git a/Java基础教程/Java集合类/image/2022-12-04-22-17-09.png b/Java基础教程/Java集合类/image/2022-12-04-22-17-09.png
new file mode 100644
index 0000000000000000000000000000000000000000..9782dbd024bb5b595329a1f3771dace0b1ce0e0f
GIT binary patch
literal 43974
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
D4Ww~R

literal 0
HcmV?d00001

diff --git a/Java基础教程/Java集合类/image/2022-12-04-22-53-11.png b/Java基础教程/Java集合类/image/2022-12-04-22-53-11.png
new file mode 100644
index 0000000000000000000000000000000000000000..dddf86799c1888a5fce8abd4b21d7ab709d428c7
GIT binary patch
literal 289910
zcmeEtW0WOLv+i!&w#{kVw!5co+qSJ~+qP|Mrfu8y^zHXM-@!U--T(K;t+i`a?5HO)
zvobO=DkAodP>>UcgT{si003~35+X_f0PxiJsS64G&0)YB0s{bGtu2Iw6(og)2^Ade
zOf9TU004=IU+NGV%H!xcT8Z)TbHGUP$et)7o(af8Q7YwuG4Y_tQqfR?!@B5b+MVJ4
za5`X$&UF5?)P@XEhSyPGXeK(el#vse@%}aM6VFHQGudA`ocFnoW>?)H{-zA-#N&d^
zfHAaV$^C)Aw0$L|^rBLK$Y>zI8({y=7+KBQnzRcf=yQAh9S5NJppJ*8{e}BgD;vfT
ze+v*G7s#4Py>%qA1qambNEUej5YarNEIg3GavpDw56S-Xz*?-Zyp75vd5He
zdy$|ysC{J$1=8YSe}EZIdMhfi3}GX3k2ma-sIV2n1Yev8;*|5qA@!0CIRHCo#3vF=
z&c=t1lwU+SngqQXY6TO^H9=p`qL2sEoCjqeI6&-$wd<#X8LI6O#tE>|J2GPQ5ORp5
zb3bVl%0;W+K1kgK?j<`pM3PddnZ#wnI1ZqCI)!f=0&40
zjP1onsE!2Hf+qOG1p=Xr8GmG9N;M6_Irwd0#04)4P|~+yT=Axj
zvU?3E3*qb{?Q-R3+j}*b2RwvP77B15AgC@9f4*z(EXB{`Aq;#HavP6ewGr75ZRQc6
z;{$j*h3T}=S_`PB2-?0<`rYJ(O~hTv3l9tq1R5^mm{~7aH^MYfoB#IkO=!%AolWCo
zzy9Wb?>xIVAh<0gYXRl<&+d;kI<6zH!e^{E(g1Nq;x6bDt~?*_JHviJXGfH0J3#sz
z+}=r2RZ%+9-rqR=_{o_<}MhtfNn`uk5vG2S0_wU~lyN+;q04__=dhciE%n`J=Y~S<4swz)Ai(dI48V0bp
zwD~}`DL}>_tS;oW4S=u%11t!M31TP!ECH0H{~**hQ>>4j26hxAqyVcH=#mF(4Zbdb
zwgU1L{6=!O)mhDb!lDB0(=0?}Rdp
z2_cd>P-o(d2su%hInfixCe&&Xw?dZ_hX-I!JR5Pn0$$9%g&*Lip`3=gm^e}WO7*ZZ
zk<f{zDqc{MQ@m2#
zs;I2Ytn{jkQ^hEsRc27#F7;LW%zqQFfM3j+D3QyXD4#6nE}vdlUub2)p3Xp*kS;#_
zoiblxL1B(y-i_@HM*$ZLu4hyu)-IMkf)=BmVJu4{n{q@t4LprJ4U&<{(%Ceoxuj`L
zSF?m$?N~ji$=>YQbh=j9WYpx;oN96Xhp+TgJFLj48l_-x`Dan1>~Zjn5tmqNUgIgx
zo6wu<8WXiZ^
zQXzSEiLA+Ryio~5nx_mpbJ))bp79GdW+oW+q)Z!DE7o)7)*tdLdip)fA3b2h
z1CzvqhSj1`qOHZ{Cdr4ilh~8oYQ{7SH2I63mCR}cRW?;g)figKTKuiQTX$DbR~A+_
z8jDxKSLB+jo4QTKo9-JXTh`6pR`HwNS~1pA*Yz9)@OW@V;BoNQ#1O^Y;}GM@a2@6o
z&c+<4+^QVBPloIxoi%q7~>3P++f87mwXa4@_u
za-`cQS=BSF%FeZy!Izh9;cbCiWo=tGPOlWNqBgZQdfnYUC3r1)xp?V#=Xq#&>^x6B
zhdt@;xz1&8;O}zIHxE94j}B7In)S}=^~Cn9_H=sZ#-~=iu{m
z`l^4t2j>N&LAjyWpd3cfNoGi*BvvHxkwQ?^%GnaIJ8oP!U?{;Vi%`Lp7cCSm;Fa_4
z3y;*|Z2#!@5!wyLL9rp1%XPO++%3wI6eqWmJCfsz7n6{dTmSWxjx$(&@KogVhvrYG
zhxL}{mb5RSA6>8V4uuAtd&+KVJ=eZRiQZAhl$?QooyZEAVbp|3ZR0>Ao0-p8?D$st
zW^PheBfB~sJKb}ghIkeoALp>~!~>NLGK6G)kx#|!f{SuzG14DACJ{EprT9`9zcYpj
zn?wF_f}{82)Z=G4=?qu>jwk2ahbZO?GurIiD#E6n)btmbt*Mlsrj19lo*bF1Ugx;R
za&K8F?dVPz)0b%&Y_*nrCcaM}+ZY@S8r?ga0|y~7QPCLFS`RO!b-9+%tkA_F>=^I#
zTV0@f#F~FP7F5bw{@LeDrg@x1;pt
zeY@-V4gDs8YC)PIs^Qge3kawygwISDT$W+Z*Kw4v*WlwgH~yTgyPvR^Zo9Ijv;HFZ
z&E2p^d3aJ#_&Ew4`^X}l(HU!o@3+C!es~q(Kv9#8>(%h6GF0AJDlDJNG05d~QMJ8V
z;>33hpZm=N9y5f~YAe^a>Ko;E{(70UUVDA8ecH)=jlZk=+o$@S3?Uj{<*&i>=$32T6A3~P
zfvz{|*U6R9)_$tIu{@s}t*4Zi=H1l8&qt@!W7+Kd>{PvIzu&h?cMY|bH}aSKG`g!j
zTrcW7dKjIfE^b{ZJy(8>7uEgi+1DFe%@0FQJnp&gJ=emDwSsnw;y8^bhoj#b>ed8CH@zJ>zn?E%|J}}FNm`hFR_NK0->;-qX{7!JtI9MF&{J`
zAt8^Wu_>35h}gfyzrXPkn>#z(b1^Wuxw+B1G1J>Qnlb#~4StqlLY*g`F+oKkXVA+POIM5)=Q^(SIHPF-~U-)Bowiq&f9U34+;8RZLGv*Dm!kQgQ_7^~0004iq==x3JJ3ZpL>Inl^K)-0
zPj{}aV`5U0E+nD^q)xo<5c~>K=Sq#E>eZ)S_gmz$qsME7pig4g{JWW9L_O(1IvaGCZy3EL~
z{Yl46hh}vHJt{PPYLs-mRPn$rV~90@<9b7Zh`t}FZkg*Z4BGc)?!>1@5=l&|C=mf-
zMpno^MsrI1xXKD_=#Uk7P+)VBPH)S%_-e@AN6!Et;QkC7Oz>aB7OR
z%fI2O^6{$3tdRrup@9xXdsn;SmGIQ#$CG|R;=V${A|O0JJjhH$7=V1Tx6`nfKnEDs
zL)s070#yQbmzI{KikZd_R^-T&E-x>g&6MGE`ARFSR%aZ-`(PHYU|_MtAMz4O_c?IO
z?vmqtKpFMz6NQC^DZ3;{2U={pTPNc_@BPYW5P5)}LKX}R4S|nQ;Zd`cTbw{c!)ylk
zZ~Hh&7rn}Brs`MYNU=tbTz;96A#t1`)=l5FNbQ?o>qT_aO+PAoQAK$6M+XQ)>;EwA
zW7EfEOBx*O7pf9#*Cr<{X>G-TfL1ZG1dFf6Q-_pDbkNqZ^=Lp2Ai)T5=CZ+I92ptm
z;^Nw{ZLJ25(~gLf8xMb*GHo1#4;wV>AF2A;=z6{7bKU){>wPY~;64X8Y$YZDoe1nYHbZVv93d116y6~9%d@RNf7l;G&
z3b_iyRT&_+bDT&forj_K_9u1gvBs_cGEE=26%z~V^z1A#rN|HWe!m?|k}3AMl3`Yd
z*dCO~KYwe(LGps_zdi#iW5JM-?GNrA=5fH_dZ6PiTBoNzC2=WbhE#eWDZ?BL!+
zk4G@y0M=Oo(}9@!*&c1y!Nu#R16^CsaqD0*cz1wb>*Ds*Gi&RlF(9mig+u~{6?U_n
zW<1WyOX=Ho0==%WvpTG)Nk>iS1zt3F)v#`$UsV36VH7k?LId
z{|IA{$H0~C27#5WP2kt~H?$%IBq*#vc9hKl!!=CSrqO8FYw7d%@d~oKzM{&gn<76snlq(UY+Xuj2FOpZC@1<}EOXn|D{62O;D--}47d$$
z*IT^?0Xuyl^qBnmY?wmk=(psuS)4Bn740z^_!%CPU)tKuSoD{C4RsYC;Y$f(B{>vvfaSsxC8z?2pCceyPd)^!4kz
z|CrDHD`NYj!Lp$J_Z%WHDnDyIy7gKU)REwmEhLa74z>Qf2%GJO1Uju(31t#@c)YoV
z1!r34LH#H`w|;Na?C5NK%tQHu(6UNn#BZQ;Wr>SYUXNf)&;aD%+ZneW6iNE_gG2~?
z_nnXX+3WA){5(_Uz@^UBxLstYOiVzNDfVoVBIMgvbwL$&;{i(=zzQiO}@#_V)3tlYM;vt1^I#J%NU3%$sXCNQkw
zF0ZGHeB99ffbF-X))n`?2nvo55`x#Ux5xAE{jZkqVNUph2?5==(Pq6Rwfn-P2z(TD
z0DSW9aI&`JtU}AK+vR8~-5x{B8oP+;U=Tb&7t!bsxk08dA$rR}8vO+_=E$}0Gj|uo
zlx;|@y%??`!Q`%E0wk{2KmOxFN7+LRIe<#IZz=FZk(kn`9`llk8>FLeO|8sadx81z
zogb)`o~ji@8@ltpG?U1#}Rwc
z*n#>BL`O6+eoBTfwkV2ZMNZ?t9*^
zNa%s20Zlud+n@ArXv~0)ELK}c8Ke_0ZTzOGfE&O=>!ol$D;wWqxx9gjz~R1m-*dp*
z=w_chBmgV`B)^e}AdP^sR1cTtg*?aO2rDB5*B<)d)ifs7Oo-~+jlv8G_fee0I*tKV
z_cO*La^2~DJ?gCpNjUuQd2`l)IfgXKV}e=K;7}Gh?EC#&QByyas|o6QSKGRCSg)27
zv0Nv0Q+J4^>&*r}FO1elf_hdOi@Vx;_eH~A;z9p&Q%%jPX8_90@p+O;2|kM$RbMiHX0h$hm!
z^q=cKcl@(R?D639$<+|e5f8x627&q8?j~sT?lYDJ)CkGuP^*xfA99|%%r-k*iuQvu
z5UB&Sf8kVhLd#r2OQ#pl~{Z_iPN72|H7QOTL-xa+qo!Ukr#xtHi9R>F_yLkb3D;P}J|
zSl>j>T5-XG;6<#pP&nM6%s}GeCO3XYs&@giMneUpy5JHdBVs!2$FLWKLiLFZ7p(md
z?Spc?+JNHpC+^eK{XA25BGl=FlH)u?O*BGY1j-joFrpw-xlhXdAf*SF05k!BfhhVa
zfbIzmlMC}moQDEG2V;Q)Fb$~vW%QZSdA-?3%(G=HJP_&f-jYR@2BHPDokH2Ff1r7rN(g@k49RfC)Vp~gPl}d&L
z_ok%uO=i#di?jU#t{8Koxiz^Z9)R=oqY6yFUkDtGOzb75oWg;NxOzYEP_vcr-FL00>-3|nonZcvyXSpaou%4cM=Yo*>4F9;{LK5wp{fyNHC-iGUHGn`bQS3kmE&R
z9G}#+J^TvP-TaZ?*R!9|mOqgqge?%fN{|d85tBgZ4qOw6QC@H(3Fxm9__jW4j$l(x
zl7sqLq!Q7|e>S+Je>~6+kDrH<|1$e%h%!}5Fl?mWag3gukXoNhD@G`p?~If}P1keb
zOz+>v+JBwTTV9HN3t<8~JN_O!ZUU&T2C(ije=oQH#xNuoJaXcSN^gMh!AGN*YpXC&
zXVI5Q!VrAyKzz%31~S%B=C$V&B7$L$$_Sl|_%C=jXu%04ed5F-gBKj6c
z0QGf)Y!(@AZeu`ffGT(mjGLgHO@Ff+6f51&)#e~NO2J8{UXTL+Oc1o#Gf|-4Lpr+v
zbi}>@vEyz6PoS{Aq`*JJ2mUcYdQg9n0_haGIhamj3-vL}ysZI48iWWcfYD%^sT~1y
z(7_!+ZfB`XOr957EGBKQ%VrJbj?PX8B>^Nva4w0&0gL3>6UOpgg*oED|u@MUBL|&5qqYmI#G8`Xr6NAMJQy3W2+!|I
zgO3f`WUaZB7lx33ON$XJWvkx9rJT)U93!o@k&XcA03#7GBh&?18)I6E5Fu&g2S)G9
zaGdW0$p9NvyFP|bv;oLAbXeZb?>*8*_vg-So2X!(2k8UQfULUU+>Zka8Gb=n>PGvE
zKgH7H+TRPFFdS5m=nS~Ve?PRGtSQdp=#MnRu(1$l38Wz_VjKu31F#BbO_n9T*+bfq
z9AZ8pAjLBOsRg{ixwg5qdLjyKV-nY4g5w07f!u7PK0@lh7sgu`1r-c8vo>P$CtG<4gkGV(NTFC>A?1K>F|hKCEl|!xa6tXjFb8b7
z;)+UYmTB1%5Zn{Lkurz==L(pU6ZZ!>cc9Z8Ekxp7Rxp+;XV{?7MGb`&{segGh+?8K
zF0@+1j2_AND~FyDu{7y-DD4LitSrh@2bY)sdzw;n26Qtz(79-*n!mbnR
z!!Mhv9g;5SvQaWzE@Gtx{TSMHg@Wjbr(vv5>LK?l=9U0YK-Z9kTqcwX%GF1}wOW_U
z1A7o{d;pFS@LRuvrIty=$0cKHeX;5pkjIr9gM75uc0IK3p>>@^grAAxszc9w`}P+d
zM!Zy|KJAwEhm}7*$$WF1CeuV`1bxB(Ok5pW08DsU*z1X!zg;e;^U($9p0{&|A;Bp|y!W6+2Q34Mr&VW~ur^J5ik
z@dc`!gSBHvy<^`V+JHIH*k0%0PKmgWqlnvU+CE!bR|@NIsn2-d>=%_`LyyP~hY%oS
zA_z7+Qb=^U;X8;6@~A}X=;?Rz9Z|AGTM
zLZ5E~#Q%~aacm*gEpleyR7br3!L}D1a_-c3}OAwhiUV+lg=|90r5lGDR-4
zSUpq8vEDyU_47@m*!A?oA()4@?r)B
zbOnV(7gFF+DqwSG)QW25dZj#b#a+~b1q1x9xpizjUx0uD=n9BbhU1w4Dx-c~%RXZs
zwgU87Ub{sYsCLU*2~})?gG#5Y_(|-@??V=$M%NR{@7k^`WYte=1}O3RKAk*xXIVG4
z;e6S%IaEO+RHcBDl{{=+1m9x4a3n*8*y5q5qq=D#wo3g>Fm$11MAVtU6pMa(Guii~
zbw}ZUf@eZtN7r#6gM<*|fI=LghaVY7+3=Qa=EVI>h>rT;>C)&Ew-^P(c
zshIESuz_M?;E9}9HjBBlrTS!r-_Ij-lmPhKko}gmb8a2{0rg-vP-WmeAkyIZ$!Txt
z+Fa=*9~^x<5O9Q>iVJm2w$2(drB
z5s`i%6n3!W-8lUUcnu0MY^;Pw97%o~+S6j?*_NiR~ZBZ8zRyS
z4ihJx-hu`5tYd`ue-7x^Vu>bAMp<5vaY-a7l9M=36L6)c~g+XeHMl|jAKy!
z(v8`pLckC5B7nrOQ($&n1ivPB+?|t>#_xXOuu=NClj_Tj2e{%!M1;0Bl?^pc)!2buQ
zCpW_s{!b*;0vCU}5Q-2QYyLrSSp$vCFtxs7)i%z$OTG$DX9weRA)m?-A~XfUF6I5J
zk!;wGTkPR-$7DshN|hdtR>2kO-YlK+yk<1N+uBN_nub?}YI00u+NIhU
z=xEUM(viNp(bDFxC8PG2KyEu*x=5rO(Mds?^(wZU17$vioquBS>^L%h@o=ui34Xavy%`JAsMSD$`UUSG{t|yH|zkIee+^R>*AYM!V
z%);P&Rg#;a
z8klPgW0}5-wt!-a~qb_|2=
z^n>02z3Q#NFb1pnC+fY>B&3-@nyiomG#S~MM?RNGKDnh}We;Ynm_L?rIJCNGveFXc
zJ>we@Zj*T&scbTiTgapt?=2S1hjCl*8j+)DesS>ZD&|uix+i_Or&L>4!3joAdclQa
zHnBPyt1#%sl78}}VgR6`MHA^)BxLAl@QM{uppqyfpaE)kIrs{_L{9~a6l_l3A13JF9x!ddZCH&uHXt0K36n^Ml^pp
zcm^cdX0u>`Ubc)%(SURwevrZD*59(U4&S^pgfi+)JD>S!Wd_D5V{R7<%PNb;H@~eK
z|J>vp5zb?3#AoQnX3SLR+~dK4whGMjqPeBLk=n(eEhOxIB0^L5#Mgjw>9WGAAf9@8
zEqSMWJlgyYX1YWCfEWn?gekV^$))+0>=n?j%!~%oqghRLqlo93$27H9P$vqSRFHvW
zm|@SNWmKyaI0+N>+4B=AluA41{g7e8!!UC|HoKt=Eo7q2#Qj}Vv{9@oEEZ*{y1($J
z1-fagYPwnHoMG
zK}M#Hcb|;PN(psyqVwoV=aTt?5XpTLG+W_)M-L$2uvFtY#U5I&PEq>w=deHTOB)W;
zd$k`snHW=N*}36p3_TxS@-}ZfBDA}6#Aew(lk?|#s?1UCfxhF#ej2?`ZyMeM#oRMo
z_w4fgk7|V_=rGOF^q=D$F6^-sBe-(=RgHd63mNL_aMkhmx{j-HOE#Wb*2JeQ@82So
z^0hvx7N$}md&L;r?FNs2BSwm0ZhIGvzKw6U&jP>=iwnc4Uyhp{Zli`j!i2fcFV@v+
zdqxMb`f?g)tIedR{nf!u
z(02Z|`?nkB=$Ve|mHV7skDW=y*}Yp``|qbJf;KZ3%hEjWdy~obYTIkc?-Sir_3n>`
z+^w%ZoI(Cu2PpygrkupZ0?#@*)&D4qi=@
z^xamApLTdyvES9qEZ4W{Otx+ct}I7x;Z&WsUUlA^-GusT-uX^Bt*1fROnyYX?K4*}
z`p%tLRRnKyQjc0yzwrv$Oxs9u^`Dp8HwP8(+lyt}4r>kT>^9zd&dw{Bu6nMkwQAKJ
zuB2QW^YcDy7QHJ?rybw*UCLgg#fs&)=xEo+2YT+y(OK&c1y}vK>l;1S@i=w9hk(CB
zjoHi{DGZ;hOOMymS2(v2KBanZjioJql^WS-))8rrJOuTF&$%R+XHETFud@S_nM#9e
zC8y{Zhpg4fSh3E@=dS^>aUZz|e&(NeZra^;giDKyF8yHqKilull*$)YS3UM3wspJT
zY=VM<-cuP~pE4-6c{!SDtu$W(Vf>Jk|2X3l^n0cz2Zp}w@#@z#
z-LHvkyiJPiht=lFZBCYjUcX+51hZ49ZC~@l%1-pDjrWrd8r}EOPIVumg+16-*W0q%
zpT>b+L2f#18tw+>8`N;tRlw~ZSU|%EbjPA}PXT`K_R8g0QpMU4k={)?I_lF~o%iYQ
za{R{|yJk82SZh2+Z%*sW%;YM}xaN14EA^IJAE$#PD4X+Mt+qZTjg7MEivk>7`{|eW
zM|9X&IXg)0Mw2PAHLj}6WxX!vOJGh%Vi1u!%$_;xPoPHXwJu&lbe*mIJXZY=D`WQ3
z&l}yDg*w?b6*LuLpFx?0yiW4iSOlkM**zwcDKj&!s;Ywti0k)9(^yzo>3o~?*G&_H
z29@4ddkOhd4_Mh+E&PABHmf29lOQHnkYgL4ed(rlM^g@nHOaGGMLLZoqF^wBth$H}N$F^q`-)7l?HB*xR5EcOWUSy
z=X=R0)1gOE$6`;wiEqxeVc=@`{jx4sa9Gl8qc|rv`DN9JOF!s*(Qu}I{PPiy``mPx
zdbxXnA>~iS9_zVfw{GR~xosTGmJBNc))e
zaPgtexHT(^bE~P*sp)3iW9I=|E3DT{+sXTW`;)0&qX~3Mlt`aYUyCuz)|O2}zS~#kNSKFUrYjeBV)Jlgqb#>HY&FTS0%oN%SCPrTTS>MBqQl(v<>7s>JYKL8USWt`xB;I!v-v
zjRI+|%#h(@EPc$|t$VWyA|6sJ$w6(2Q9ab}Rb+H{H+oJ@TCK})eSzp@!&^h?I7B%`
z{KgObzp;5V$TOto6w9kvySq4Xqmjd&R#tNu(5w^p+1a~d9t9dKnp(m=;WXL!;yE*}
zn8Ez4IfdI6P8m-Z5=~9n4aTn>ysKUzRxL!hp*I!-wfbnOlfV7_Bfo^F!`IGwa@05d
zT5nVqYZRD$n|@z{^rI`5g{P!9Hj*gn39Q!rVDD59&JbEv!H$zUuWHeD-ndp?vSTru
zM$I>6&8$krbZN|RB!R;9KWC5p>608KBa}>)i#HWx?9Eqi5Oi{mvP;gJRPhVzvWc1J
z>b{-bn)Y!Tc{je3Cm_4+D0BWN0lxAkbBo=|D!U#>W>>R=U%U3x^z%}o;^Jbn&!@z;
zb!j7&hV)_8-Ot7|5|WD9Mjzp>T6s4%)M%n&;@y~2%UN;fX8!Fulk?Q$3SYc_}x
zRQdJBOmQysNc~DL@3vrq;_`N8UZ$*N(Soh}*f==8X3sMEftb1Y!d*uxECg;~^zof)
zogX)b?6lakNw5nvx5Ace2~nVD1NCmc_YraY&VN_Ngzt|-=EsfwdO2Q=$#U62barny
zsZynb2RxY+*Lydpg!)UIdFs7#IXub}XVd@AT-|0H(VG!s-cl$9bwW^KtOlA}+F@>$sLyTVikyH4$Ft9s1{PP2*ROC8wYiktKlzZKVr~<
znrM81P*so|HEdAZN*#@4bg*@@MIduN7Nu$7-D-aBGE}H)C*h7hh3o4bw_O`X%rUz&
z5fG7YO?cwWkjC8N8MV#e4TP}7@v=80!G$=t34X5V8#U^*UTMJHN)9GSw2y
zjmFJp@5gxX7by%tO44qpTx8`u%gioo7ZrCM?ef%u@f7W`&e~{5Ib=FiB>=NA8lc-7
ze)z{>_ujH&IaS)2l478ry-|2bx!idCTGct19b;DOFn&6{nixr%LMB)JL|2|(cfrMA
zA*43-PK3+grR@6g7Vt@c%4W?MT9(lLBURCm%x!RSQ(NUh&YJmw&euW}~
z9kd{@Wg
zhvnjXiZ);;mfra~Auy#2wLa21*P3j+0lPWRaR;<3#VrIN-YL~0hOJ@lX
zDOTa+QFd4o`N}wpKD2E$Tu>^h;QC}DaQ6d
z-c0NUNO3U{x35u(=&%l+!f{WC0<-<9qlPY-#Bet6m{ga)rm|vfVhb=wQl#YmBnmro
z_WV5k3pJ9qeLPYxuHV4C<5re2e=d0~i41mqzjJdRp*?&WbyBf@>T>voQeoi9+i_-v
z_F6H2O)~T6bkWg^$+G$C_D<^1Xv%^pwSXpLJ86@>D1$Y1+amo?3XASU(OKvIz2O~P
zrP2CV*hWFtlF*fykGiX#3@c3y;IJuaKG1jApp{w7M_#}!l*hEkGGqve=NJn8c^EQu
z$J0a4l@9Tt%;RFTT@lH)9=Lqd{FkBZK3njg^_Zptl4!I_%HwThhKFLFJ4}^ytt-`24_++9vB^s?W)Op>$!h7
zAKK|2HI$OW6P#1Xp*z-B7toPV49(S1?HcAW40#qtMpavB7VuHWUrz9KPtRigwbZSO
zBbu%hh46H@@F-kIcYrhr^SGvriBBKSrn76Lm^$t3Lj8U0=6){6I9HuLa1n3LXmat_
zEoVR-LRofbGR)VGLbg^Cr(>=w7wPflu}m;`bmCvxM-07a_-*AcyLg|J{KT(io+bQ4
zFH*(!fomk?^2Q~WgLl<=b~aH*f&=s3Ia_%=uo@|5-e~FAkCXK@tcU7xARP=aKrc8#
zFMM~k>tsKufq)ERC@-8H{>9D;7g$P>@MxOpBW}3VYt##WXZ4n&$EC8E(Q&Dn
z>-@>5K6LCx#-kJVs(Pb8Q`eG*WSxjHZ#s#?ycPNBq*`cnxI{Kxp+viUMk2geH>(`O
zG%U>kkIoBo%q6na7j$a-$nhZ*b5c{M_&ajZqNm47q~<3F&(eiRy96jLDC7mvfq(~}
z%qX;=K&Pe?&s_8G-$=UsU4kVpr1$$c4db#2`Z|>=+4ymtr8F%@L+472o1EQOD?P!>
zL85b=dLG_(f6nj9hFD}_id)b&I$9ZZo!Yqey$W>^3?y9K+|0eb(lO&Mg6+M$e+NXb
zm!1OEI*A?M%=~B-mn@3B^7nGD+qtul>z(B7HqkeOXOLvFkj0L=V*aFG+`YYCz7{-O
zO|{fpV|j45UL!V5EZ;2=E!e2?Jc?{cIyIeAx0V6*%Q5zkEj}X~uNxWHqYYyxAIy-5
zmQ+LewOehL)o@ZDMo&vh0Mltzk!j%tnuexQt4n2Ye7V5;A_{$YVv7MEA(VhbT4fP1
z^r_G5idKk%uRREs&-Al)2nrDj6?sO%#974d$&7}xbv?o?BadgK`pjWOY$S+Cyk(&lbCJc$uR$i|rOz|DFuIspumgBx@@uI(zQSyBHz#1g;Uzn`JnS^k_
zu4WodaOKxU&uZ`c;}m+>dWQA{rUZPHT6B%5L2xk6QCcM$v*uxx&1;_L@jGc`;Xy_Wd>wNMyy$j>A1s1*eDv|
zj4)OUFh;KZi2KERG#UlGUZ%s4kt)kpEefV4jVdI;vptAnO-c=e%QiJ!dO_0p`$t*D
zJjn?iP-Y}u&10$;Z|)dJghR`|F;(Z1%QIcY=LpA|3;L4>Ee8zp2_W{QKBE1Zh(A+N
zwI1f5HMpb8-%1ns1p|q=Xg+LQ2A9eEM&vg>5vn3m8
z^HapEPuXsRq#`vSwm1V78#~S!7w0kYk@73b5f;^CxPxJAQ^<#eHgZE&7r%D^w?dUO
z;qY48bPqCYcmniF&QUa6J!sn=~*Z{G`r6jP*}9`2G7Y
z^XPE_JNyx_ArE!Zht1Vpt0
zf=-PK$YA18(wMAPeC*!YFMgAFIW=a5CsEylg|R;k)Z5;MO5~x<3ic$95d&8&7u50v
z7@dM1%G$MKZG_4ZNG2LiG2#Fi7;N#c!`JkvGm-Z9pi)Z>AO%=35b5d_E*KL$7U4}3
z?_Hg=3*KmtxX9!PGH!HwGM2hIt*n+Q(mzLRco>whHU?Pny;S#bJ}d*;l<;{M9MsPj
zqfh5BO;sD5;+w$2BBc-Vk!%%>{o@%%%HrZ+^iYuamk@`wqrZxhDK=KLrheFnzVPn8
zxJzPojF!J`$el6f7HbaJRqqAM4OOv#8b9Qjwkv!K`nf?kIal*AY2>8eiy%s|YPltc
zp!6hRm@2tXV0-Ht&`bB*V{Nz{JeDQhP5#vE-PdJ8Nv0z=7HwQ7NxzAe8jf7_yN#bD
ziPHpi&p}D(KPSRTVe|2=2N#~hm_l<5Rh+*)k9aGL(`M#b*j||0R8@&6C!t;lhQX)`
zfVd=Qh*IKG@Ce;e6oe&6-c+weRRRw+OYG;UAU3}_Sk_85jtq|#>PS=7%r2K%Qjo%A
z&cbijp2Uc3*Q^dL7cIBiU?}$9JhxPmy?&AC$vXD6s76gIQsPwj&MTEFv9zD^!ZVAz
z>yiFY+hFmfC>kZLpT5T$!DbH>rN#CG+TgyrLw!mMMMY)$}Wm##|LF
zy&4x8{w|uRo$V8Nmscw}6if|OH?!;Zeu7&Um3
za)~K6ucAGTOsa+5%J{C1X@SXmq2ob8rl1Sh(0FCyp~Xynb$Km)e3>Rxw}w(idoQNc
zB!zi{>JDu88aiRTBDvgiorRb7Cb(#?U23!NjcZeO9xrEXt_9Y^Tci(rww)uN2-dXO
zFuVm`hqQ7N=?c@#RYl}IMD8dzWB&M(1;&#~(H16DiR93+qh^^y;9#^qHvG<<_vFv|
zy0E7z)o}XJ!ChJoBwK%WAyF#&9I6DoMQgaxVah>CBl5^kKUF~$O0x-{W0ZXKVwEX0
zho=Q6y7`Q#5M$~eXLlZVuioTI-~VSgbQ8$^`s_nCnc;DLvzwZ9?AkD)e#Tj+I6H59TAuD!-al%R7?}H;-Hn;uy94f0%(P~+
z`ICcSY6CS%sLEp#A<)dxmAJOHU19(pFm*0X}GM3-WJ1<@00uA
z7l$_{!$MsbBO|**!J5x8?sV*|RtCstNLW6Rz|W6VM1mC(O2i{m6^W$q_XV_y>FStm
zlw8q~qRY`#sMJ+m)d-N_aqISEk~Lo_tdR+>hPONC_9?nEpjIo9*}=?~@!ViK&>A+9
z8FyEgVie;$QcAIw>L2Tx+npPYds>^u$BP=~=TO`DXgW4t42GH_eKXSIDb?Z5jE=c|
zzFO62nn}6>1Jj5qNJxMSvSMkP=h4FpWMsxt&Fv0faC*@QxtdS%dfK)|cSiy(LANiR
zOy70aT>)mQxLjUxEYxbe{1N28KlXC}pN#+y9Lvg?-EJrw(wXfM0yDEoO*6H==6b$}
z>ctMstDF7!u%E3^2P;(6*{rHAqwEh%TUg2%Zf}#XrHNT16VV#MXS&0eij^XfX(Xf=
z+?OHXvrw!mnp-iuG^H~WN9X&S7DUqVcyvfKbwsjp)8T3_6{}8NE00yHY2gWnMW*hm
z`$F>$1AAr0hdv!VU^>i{BxWd1mnrtm=Pnjjnb_{3O)!b|@-CQ?w-~Fq^r!b!u7;
zKOS~sud_Lwc18CNyMtxk7`aiLZUrV0#Qt5bRVT8gSU%DmPHZ30DtS*NEV9{&U1Q81
zceJ+}vAF7VG@|AXNgfr8Mb%r$Vios~jus1*&cNc!g*n4AYxCx5IY=z8B`>Gej2ldr
zmZQWX8ZXUqv;=-0UP}hvsj=8ZcXtmnoMz9xAs)*_M+6bbSRbt5NPJz^lqmi*;w8B-
z`1x8oL^+yGXRBkoM$S5WWX8gC_6!sity6P!M#rnF?vGCt!_B_rcm|_KA(Qt`bBbnf
z9)jsGN1uuZPYN{8@fLD|kDujMElGQf^=B{c?kY&0e!#c8aXaDKT
zzh#-Bg*LZyUa?+Erqf^k@|T}@;t8I}miydt6PB&?GIBWr5r950=`GT-;`Dp`zQ9C0
z?RI;0r}MdorHKyIgsTU*cg9j88%$#Nc2&)HcKEX!_%AkKAy>-cwI~?vnF&
z-gcYO-Vt)T{Ho@T5p>)+E1eO&Gv{UVA~JiXFBp2&YjzC|mc8EDD^@%^v2(XSEM_f@
z2yb(#95Bs@$KR4nmx=YUGLl#EN&7MrMRVJ}>aHEFvu1?bdc|HzyevT*V|Lb%6e({TE9Ih4&Z{-@ZPrF8jjg>3+eD!M?hAS~i)f8EK&G-=R6=ykR
zIDCzX7EQjU6MLOrMP$a9)7Uzju&RO>8-xh(s(9$~SkXw;nv<}+O4Sz#wsdqZj+~nr
z8m>P-{H^n{S%u|Cvc^K=nQ^=giobWhz;rklQ|)YNt(I$qK5Slhi(3mVp4Vp-oDOF|
ztGd;ilTY4g2J!VC)o?#Q)tHdCfM}lH5ehf+G|b0}b7n6+=bY_sPb+a5rLw8&x-$}S
z68>Y>aK$ACDm)r}Gl-EZcD&4;d?rhRdhZM`HgLY7!_cg7D=5aIk-fY6`}ehV`iDk`vST}3evwU%Hg||E+lyGRy`6q;5~a@TBU7cgQHb&J
zXa;}oQbyzw)#&uRiOt&&iu`{`GtA^8ua{?NOvHzi@qPWFP`e(Ccd6(e2SAs+XzLB0oAfPHIG4Fts{%4xi=JFk;)*
z#S4iXDYXc!4sj1*=B<0J)3N^iqR#hOtY;$;8^P|LP)p0smCvO1O<+FERMzEk)#*Jm
zY5I;k?pU#61*3ZI+_?;CNt%!FVSV_-gJCpO=?i)w|CG??%$kD}oR@h=h;$bE?YCc*
zNMwAZEmA6E-8{rKJear+zt>wg{Dqv$<(T%+gJSI(!IUUb5972Li>jq;^Y4Bo9(j-t
z0(dGlFVm}0@6BEC@`{Vly`ab2sTGKr+qhTofj=Uf8T@=9%lg!a(7K^R%OyhC$;XWKOM<*8<}kPje;&Sua>ad&#Zg9NacKus1%vTSP}n1N#c$
zph&0G*48mV`Lc(xv6eCy#zPrI1DU?Nu1TV}9p23%snDRWNoXr%C{
ziR6$qt%{zZ_1t%j+=SNIS*AJDn(tB@o2aJJbLO^$0}*$_2LKqzG7ZOl4}y(V&;rRnVjYb
z_3n-e(X}L-Yf6{H8`cy=%My2UXUEbxBg1@a&F5MOgSWn|sdS0)eHJY^BuQ*(3B(GL
z$;%2a4YqhYXS9jb1W{b&f<-bKOM_lm41+!ETddqoa@h}o!%H&I&5@8Ro8;PNI=aJ6
z*phX=?tnRrNMpkag2$(2@~)5h>G=sH
zJy+;mc;2>W#@_h)*zywwK6MjQO!&OiDLV&R7M&LR<=xqZi!*&EpS$K6*R}6T&N=zH
z3tkibKfkKvwKG;+xR;58XJ0;?HBRxmmal#|ee=JUE;=WB^`!&5x0u1M3wEw8oPT=u
zmQU^e(r3i>Cz3lKPkAE?@$-o)rfc3KGmIVL^Be1usuYM%!U9vtC&z~N%-#zV002M$
zNklrNtB$GX_1dfXc``q{cxANM+5@Q?_fZd
zQmsv%LTCu29nE?@_@)0PUUT`$UT;s>
z)1{fA?iT&7+ou^tQl}V;PB`^F*X=&*v<>gN4!)ds`dYR=yc2E_4$N*2EZ{?}+nRb-1Z+ivjtT(QxZ8VqSJJQ?U+>=|5`hOxl9Le|jL0;Iyqr<19|
zzF~wN+_7{0(;sI@J^ZJu7oD(T!$a#Ic&L8stqbpa;G`>GDZcit;lYveoRiLht&mW0
z&8D;W4vv2K#=Y---~9FKKm4}qy1sD>ndRFbdF-QT`JdnR3b#9mX=LRe#L`p6gR5SC
z_3O3!R>t$?jswr`2n^$)6SbYm$;vHONmtwq`pSS%QHu2|!y~Ly6J7
zhFQpGlaWYErKDC$d^62^;|*)CzD7Ls(CKf#F7orAM|W(TSh%PU6UeUTh8%wK=ZghP
zPkHvS;{ErEn?BLYg|zbe^3G;q#&=M&(+c)~3nU*l6}RI;D#hp;AK0;*olXLP01(cV-doq-T1ow1m&g>2iJ4hI+Q+`YGd
zfLx1^7m*&=r)!>nyJ_T;H!XYg$@kpwp_$*fRV1=5)zgD&`Qa~Ocl_bPf4Nb=XBA;r
zu26HwrcGnP2${zJ2l7yts0?y8@yC79(b3xNy{r%$vvfg29W>OZ6#&}60VTnmEtmZf
zILsu&bUO8BQRMp#)AkJhV03i6tu0s{V>T*NryGI&mWLQx=&|ww;rVV{CY;5A7Poi0
z6{{8q8*X2TVO=bbkB#k{yKv$E`Jr$Gdlm28lh1v_A6AKg&l~Gs$A=hRd)1O!X;aWU
zc;{{N&s{O2oZNHXvITrW!ds8&<=tVIIALD4m|JaX#Rnc07rkPs;i#N<;Z?u9O$6Jj
zh2nGcymaZ(V1x_-Bc;-)%f;6>Clr+zNS?+4L8dJ$-9cl3S}yHCwWR9d&RQ<_hd*4K
zjF)v0aymVv*x$5y6OZ7}e)h8%mT$cAMxMynnaL}_hSTZ%+Sk6ur{w?hKmU_Dl-PET
zsVXNT@BQz8e=3#w%x6Bs>n0H)biu;**T4St@$qr`B}%|9WPPxHnL9wT`H6`Mq_rEd
zr9D{vqqkglx|wA(yX(w1y%Ew|@&+QcbXDZbfsW_nxU2z5#vO*L5ETt0g`pAc-!7WlJ54n-krgv$
z&)KnSE&jcM-HE=wh5!3j5eO_Z_0ZYpUwY4dq`~N|W(%915GzgyB!<^tdC7tYSDv6$
zw$_W!wuQvNbNA2bcGS|tYMxXAPFK;h^+|Ev)hmqL;CZL4c<@dpsqUT_d`!=akGlazwm`G3=a=~@rz$P(#j`CI~$OG
zFG|U;gD^Xy>MzZaUJ=_i)P-^oKk;9|~-8
zX#otZeE~cLHk+Pzf;7MmiDvT&xB0Y4uNLvOBDW#5
zdu8Oj4l#J&Ib#oBa*|i1H(WgQ#Hkzap1!zA^tnWzE_zk5#4qAcuE;#Scm+WlPtO~B
zO4N3Sx8Lcz`HkYk=ZW{9DV8Xr|E?3wy*Df&4bkSALk|b4TQ6Sd6q(IScilTX@$ef?
zKzTg7AoWz|=}hh0aAopQVQv+br<=@8ot1T>x(*5b=9A6l>VUacGd2j*DhZfRwwh}r
z*$4f@_s%d!KWi37K6v%}H7kv%!{hPYfB*esV`Jb0uspd~6O+MubaWJ~*x-$j_vxV%in
zM7mbI`?)`zVD6e>KH@Q-@R}PvxhF(*ldvxLQx0obuC}gwX0wubR@?ocFvoh#{&~Zz
zny%;-+kfjdcP$-$AZYG9aqr5epMG3aH=JqqUwjf@{oOci;J&WPhW9QY{(Vc|z~fB|
zpsCN?Tv+`HN|GB+tUPzx0#z*ci_3cjB@1*h^w25BGgmIrMPe31WZM#KfUDm(asO3}>aj;=l%H8@Ykw
zV0x{3MW-0Odxg2HBleUitO?XNO)ISTSJyerr!@0%xA|x@cVBITC_N+00at;+|A;96
zQRE)cikmMqWB09p^x>sTxJ7u*YEW>-0~DF@fIY(=8}=B(GiZ+}dxJ4^M3o~O{vFob
zcgWAizJ2?+C2b+uB|?^4gAM!cIH3G{_wJ>Fz1W^mwjtuI4_N=0EKgkG>}L?85vePj$UwJu?sS4~_7YFxQLRW5QVPPygxc
zvzkO~{Yj7is&l?3_T2x0g#oeY4;_2&J!_d?j6FOn@#M_m`xkuSI`Qt8iA&~)lOrOr
z>5bVPZ|`-A_{LYn)}5PPzjTRP)sSbiRz;-UYH@38e*5cd
zL*F%v3A1F@t7ffUt?~3Q({-a{@>k24wOrjO|4oJXkN(K5$HM4kVT0x-hp}}fj>zTk
zS~5s$;cyuvV>^VJYM&7bG;3sAGn5Po32l$Jz}gd;8VjBu1JcbAXP_$tgks;hZb
zZ{#F!mDzB5%K75x{Dsr7#_ia3<)5CoVAVrc{NbKgl*^jm+ndjcLeArIbWe_kUC7s|X7()~*%HO+;ncfYT4pDbIs7xpbarOnY~AS~t4eetp*lT$lb-Y#
zx{EwoxTRgZ?-8tt<=IM3>PXe~tid-bc#e~7M$gp|*hwr=u4`Vq&~w6!fBh%l*s^n-
zE20%k`G5cSeYq9Q`mJN7Ip*wzRyn-i2Fky*_KL*
z*SvbxSH664CM_l=jB>$4#+UIiBa?Ox43>MRGiSRkK1v*2gs8x}={`hZsAf&Ys)#ZH
zNQO2smWapGT6eFo@;X~5O4<+3jz4RbJ73Idykv5}HGY$;|A)X~M`R>E(lxCEWAvgO&vse=}eE&E+!9&5`j5#s{h6`3MPF6cY|7
z8IlrLUWL1QwWb!=t$X-=@4KtLvu*p%?R)~0#GQ#$x?|?-C!ZEePG0c3w_f|>pWUCz
ziCAph>CrK4WefT7*hIFNxa<|;(Z_f0*tzkM$5y`OIzGUiH~C-*dBD=64!6c9f9k?0
zmPtKFY8XT!A(z1{Eh{mimGP6cmGm=PthAmocX$7mS<}Bj%JY%v&Ys!R`UiHs?1FR2
zD1h+*j0Xk=P|rM)cyr?BXPbvLwpJc?_5+R^W~$1eFZL4?X9w-0`_Tl*fO&&$er20-
z1mKx#KTHoOk6oC}qMZb0WP1aiG*xmQQSAi7%r;Wmrp>zGqI(=J_xQ+&67oCd_GS2J
z30It(!y?m3NE2IijmO
zqBttcmW!YMd_yK(eBhzqUv(8uY9rL|nmM3B-5iP=2vT6>%CoO8s21sz^b?U%p2
z{WG80wrlI^-Z|6GzmTM~^&LBR=S#&aU-|UjJwt9Uv+;O*>BVxTS~tQGF&N!dG1FJP
zg1Od%x?4$P2hY1u>>Z5voUpLDMPy4ORKqEfB}_GF@}0qOXQYg8ub40x&m`<;?l|Pb
zN>gK@l?sREv7p$)~kj^4FefpPbMx~>tgByqF
zNh|K|P}Ve5HEM?0Jk6COX&u?baYa;6bm&*&Ex<1>FlTeqc4{qZ0%IjBxdpFJ^pHRaPuv
zw#5toyQfbOa_R|Wbx)i}@Oc+(bb0f=eV*&z8ALa{`~9O|xn<(K3p-odb=8qsax!_u
zGp3TM@F3AJt`tZ;4&7+n9+nH6#ok6v{+Oth+_fv%(z3n(ef-oly|-950{*67|K@fA
zBZ$U8JdOCJx&d}fVdzJk4{>qJ07oCICwr{
z3g%%7=U@Ycaj<@=Pa`m)ZQHidjy;cn2kXJ=AKm4`OsA98QtJ12pYQT2ZGCO!^jK#1
z4n8N%vjPSzv=ZMdu|C(tpXGBc1;Z{<;FpZyYGv0c=gqqQJ>s`_i4|ww^U41&I%}Tz
zbdYD&?wii_MZIYT28dPOkE^_)SjP+~MRv3I1%o#yQJ7h=QVHjgjj97;d!3%XP3
z1j_hLZ+a7Cfh
z_O9ycs_JffrCFODMU=$_QU7loM@GjDol)GCCpzNz{`{Yg%s39C;`s2XD2sxu!y+Rn
zqKF{-(ha@WzU02=&Aj*izmd^hH1tAuleKh__fviQX56?D=f*v8;uq(fIDt+M7zDwL
z{d7Q-8F-NJ6W9&eTyW4w=okBeNg|H
z=z0lf5l>Dsw8IoWwzn*0&BVmR5C3(0d#sd8nR2rTJf;umY@r~l=^Fc+Xq75nLiVYZ
zt0_NWnuBk9`x@$c-}}1$`!|mS!g>6!O_3NHdFqm{if>;2(5a{WqP_jNFVBUaHGp(9!)21!YCGQU{
zUV=Wp4xZ$!gFlpDO7V$vcyr5Q)th!d1K896x_jaQU8@K8|2U&^BA;#x;%}cGe)>n{
z;`iG^lb#AXs4AOKa#y;yQ=8?i2cnSio3V_@*_9EnTaoSCGVQI4Z4P@TpROAD*7k5Z
zpXljbGBK7O9E`78d2Ar)9p3(ES9jEbk}YVDZ-2I;i|(Ff!&_2*cYCyR(e~$`sZ`7D
ztzDs*md?Hqih4)K%P32?ZQsN)!p_Kw@bdor@NbH_+Rzqp+_9^2l?^qM1qX;xTvPM;
zjPN0vShH21?a8P!`1@3Wu51`=Z5=7CIPOg0JuRJiqo;L!)#aSZ$9n_qny~-+*S`i>
zbai#9A)le0w`BZQ8dpR!KfwfuDjKjM>Bv56p(sjLvnVB15uK<~R3ZYG3w5Z>d(y*X
z4phV}jckZfq_8SsU-=tF|6G;hWdla>+_U$6AZB~oRnl9QhOyk$4a{<$??nO3gaw9l
zh=OLT+1xJE@313Ji`$1Q0WVvPbQPvN{&0_3u4W2sHl3~7GPq6ZRcAgy?E02yxRZV0
zr?T4yPV2L_c{XiG_V)IrvO8KA74>S~A6q-JVZ3|E>SAVcXl%oZHA~`S*M#b=hF{Ehp)bM8YR9V~__KE__1_=qu
zRL}1!yHD_SeIeL#wrM%+1W^`(QJI1B-h1yQB-i4_i(y@59|6L`Gipo)p2FMnDxF>c
zq@Z^|Ft8qmhe9|Uvbk1R0VXFKy@n35ulJ%5`Vpv|qQE68GtIKE{PV3H8bXg=t1!~X
zr&8fSo5$_20NxUERLf??ZgYd=VnIBGCxm$RiU0op+M~}K<;nJ-30PE#-vzC)JKKbf^JWotdLfA2U>4LyDd0y-Qft=}pITUZ*Rh
zrLD@dUVG72bQwAUBqYADfER|}W_jwt@a2wCtTknq)>>IF<+F=c_EnO@)oQY%H|%xf
zd`rTG$#K0r6%N{am$YQ2c9il%;czvVOH>N+r~fjw{79P@PvCsACF*t9N`{`a%w+Ge
zORK5vUSBy8XGi#o%WjWPPA%#n6jGZUtJAF9
z0}#GU0hMBwLJ)IwMde?nM4N&FuRfi^RZ&d2s24d%y$DSb6(b^L01DKOY^6Fif!niQ
z(xI6_36V;Egeg*$!uOTGQS{GEIhr#aPh)LxmL3a;sZeK(J@F>Sr1K3Eb%Z1Pib;^c
zhm-0nDMm~^U&xmUXcY>}s9eG*OpK&zm4sPKdVHlc{)5CO3}Ij~TDoKCZuR0+z+bl8
z%gL?jP{{OZHJ4VwiN_ZzXA@R#axxYcTQ+R&TI>n?v-xz!GRqY`>+|LGvWP{z?ub?^
zC8H5jXG_U;|CZ;r+8svs@|IF&Fcdbt-qO@iGM&&nJHvKEZ;eKc3Xy37x%jBZ#TZcQ
z9|&8u0*n21B8U>bR`RtJh4`4rJt(At*TycgXb`h(ZsHUyGPf#5Al5RO@^r3vPcrH9
zL1?)GFR?Zoh1S}&Yr)NoxUd#1p+;^%28da4yJD^RlaB5Ii43GrBw@$IG6HUftGNXz
z=S85IgN{Qs)pz!!pH4v@1xEC^J@b?KuxOuyqtnTT5H`2RhwcmP$p+QP
zX_S2Yu-i0;#s*Wu$dB3e!Opgt-5PQ`lWdNOEdiE0kUv&AIi$MSUM-p)HYF~K#V4#T
zPfhrJ*2G|
zfnvmiER>Mu@`B`9Ih0^m=UJ)n5G$EkO$O{jm^PnRDl!(gF5bH7%!wWM^>iLV>~5jO
zac*E5Z&_X$w3|?`_MDxCKxhsSe=J6FyQ=w`Gu$HdTA`5khdpd;*1p)O6C0%{d;#f|
zgGVzDvM-OX1$%Ohy<0;pKFqS+wg|W-$9e*R$+2W4WXqMTmX-eEV8QDSjE?3zJ6sN@
zCplvJ173HBF}XR}-m)Y)H4*EoilC=7Twpn0q}N+bmYl3vM1x^t;E{o!VINzS-Jv}B
zQrhN;SgzjJpZmurMknL(K%mnL)eOkI0RoG6W1Plo9W5(Tm_sQ8kW+jsHPR!SnEW*)
zT}er5RC6qF48|JNzlc%FKjDNESiE=6IpjgZKLR%SLNVM
zDL2irZ(Z$L`s|k3W|y;7BCAnjWvY
z+WRIpZ0}g=sN@Xd{2;qCY22ShE#n)VD0cTSJp-OD8XX*6G$75s6I(?`H%SIAZ;_y{
zn3r>OH-_tyWHX!H@OgbGcq^r%FT|p$N-k{#yZu((4bSpQvVCwWwsj+f-lF8q5YEn0hIy#gB01n4c0*5Fr;sU)F!z$zV
zyh;Zg0IVSlkj(}3s}2JHpL*)4ti5DDK=i9DY2EijJU9
zFO+jRlWu}HXt7Xw;~Vvd{v6ROg>tdl+U7}(m!tij)aEkQb2+j|rNe<8(uz-Z!js#^
zQ|@r1+A
zvQ@-n+Q^msffh4YYY*7jn$qR;`T4*Z-O86S0@^Fm!B-?}KvZ}>Kg{MjOaWchf?*Qo
z7O5Wc>v^js?8rY?U}CCgtL?#ngTNNLE9mwc#i~A>X>X6#@|74nK$P7gi@RsQ=WrVn
zy3-q$&KKC_@bz>#&AO*CVW%BVchKt%xLi}CLr-k|4yunZ(?AofgmQ*K+(b*k6o(6@
zeQHowvWc_2%?3jzvgD?ODjN*JzHQi(+P_7uC|NQ4Kz4TIMVEja+G8082
zaDn7i{K^G)IWtNjY8g(rOHqs{9HeuNFoj^AMI4iYc%>pPNGFeCBYu*BGI=k~Ng;2IP!5K=St2u3T#2iwr(xyiL6_T+A26XM$74fOtb<*3+1PbU?{8)
z7ufn0Y9UN+@8pSA6F{Yyo^yB|QJqd#akDfp*wI78n&f!iR&|eLHdb?0husOg@&!3#
zL{qHG_hO*snu8CjE?^sYX1=BKc@!tZa&!=Q4_<}6d87Bg|NS5T_{Zr801>jm|J+iD
zfo{S(lE|ykmw5_KhI=UihYZEl^a3*Q`d}9>0Q8(;e(q8r<*0NPc&l=z)A>nJsu1$i
zHON2T+HJq|$oLf=ViVP+o&4@LspF|j9=lwUSF8U1{_}m_AiJG848I8Xm6I&+bg;FP
z@O7Jcx>pN7Im;9gEyB$1PEmBT<*AhaeimNq4o}o9u|u-n4Hhqoay%6d$0}0>k!_0c
zB0KLmF!Hf=Cef8j1np(23c`1~ZO(w*eedlyJyi_2LLNF)*}>*NqUek=|0@y97GShT
zy}Ezz^cZfuJSqjFRIG)g;fbm79fe!m?J+d*b?G1j=GOm|dIX?>te8QB0p}c!$IOBZ
zxj4>Ib^0uLgr$BRZT?7Wpi)SeK;z
zB2-e)5e{WW;%xMeVuA%unZY7cD{si}3Wrj|87C2~5C?7>8}Xsc!@JlW@+5|If7tB{
zc$3@4ikU)SpwlQCfr!)P^Sd>hwA8rmsgbzTRrL`=D-uYLq%=I4UCcBc>5;t6Wpjo7
zjtKR#RMjT`JX&g`j4P-wEL>4vVstyZ>d4L
zG9nYXK)+3&Cy_xHAxl8$haY|z!J(Y(uejn0B6snVJa2i+TadqGKX#~N>RAA_V@R5asBnzBcREKbY_POWHDM3(kY*uH{5Uo
zGKgnUwzCWp#XFK6q0BALq=Pf&qRr}c${tWk#Yddz#xNl;QK;4&nk$!;JE5}Gm}BJ;
z!%t=LdPgOo>vF$ohNQ7)ilGqm_@Fo1niZa
zN6;Z?u9nvP$fz^iW^3urjEVeE#n#nh!Z@tC0;B38KV?RH!)8SqFHF>6OZqE$gN?3j
zP6wdUHV0K??I6XS!-tO$SVWW_4T{)0RO%hqii4Nv47n(o;
z_#gIzpJ8u4HYutFwR9;6Do)nku6MsMZux4-@EzyJO3$$3~Fa#)o|9bLIRUcdC-cen_T6!6E;fliKR
zt+63bXPegD;qWhWPH;xFWT}s+mpgcM%T4OM+r^P$D
zaY&978XK8-GNa?}Ru5_jzf9jOhYx)D9QMRu1+%a(#9maM)M(u4aYx(Q0^v|{I1z}k
z`8FYTz2nd31WUs;b`y;5tzP@y>2YczUu3T8#gIzuM4v}!&WY_WI6QUj=1zp6%bALe
z)eGnb5&lh(p*Z5j^9+LwTHnf53d6!*@h@#DRi@$-8N(`hR`tq#O9%}c&$KS>$mA!5
zRxPFT(ZvXJ;IXYZl?x8El+k%;)mnNoyf|pqm^ai4Q~B^fq?DB^>nb9+$A^m@F_N=W
zR!hGlp8-oc%gJ)fVw>gy}vf
z+(pBh(nO(d>wd9)XYGpl5Cgm#tr_p>Z(s;&M?NAbfA_oJ9eJdTs)Tgo?(xSTkI+Oj
ze9=W0oqzuMq_Ah~*S_{Oo3;)ZB
zEM6FafyEXc#qlIg5`iP4l^sLqd$XyyKviamK&zuNmcjj*P=k|G#q!uTcS|sfE2^H(
z7cxCdF)Z5h@k%XIj`eA^9JZBwuAJ#v0m{kbQ$w}FP-K~A7SqC*C>2wkGQCz#Wkn$!
zSZ=EoD@^2bMS;aqxN-&oLGwF0mbqBnonba!7z!QNQo}vb{?|+|OMh{{mg2TFnA)er{D7}h#%!DqHueP>yjg2O0()Q&61BG5?LZpZC
zxx7)$icr}=Nmz=9mJ=sy5`Yiu!l>m^UKlA+9`mdSh+>>*fWn<_UjclP=1QxW4KH_~
zy)GqnSeJB}zm_*j<(4%qg_JHzIjfY5E^W<@$3-P=<`S{~Rx=wf#?z=4JC}J&c|)L|
zEGG9>Z+h?a)Y3w;hr8PoL&>sk4i1e0@H_gK)r}&6DfK7aGwRoJZS3Lx9cP06nf1xA
z*(#~zj#vvCt$1JH#O>SG#)qD1ZR^TyAM;10r8$`vEq#6I;R%1hnagEkovvzDN0))>
zF)|P?j$|-z6JjOQ=`wO`8N4&SG@S9WCp$Z)c6!K9IoX^U>-Xokmwoa-w7a|H4$Sw_?h@r`!5sG
ziSQy1>Rco#$bgX>aDaH_78ruDADn@7V`}yM^UouBnY|$#nS=o#RDPr+V?TnDm5NAG
zN>geE;0R?R5XZ*GSTaM&Tmvb{!v&CnO4$S)X-l!B@F3!tDca39-`v;N_qx};j;B8R
z+0Q}-1mF^@-UZm9R2ooDy()1w&p0GlI$QKUuzJylpL;x59zjBPu?piC;?WIHoPdWHj
zi!9RPlNjFMF?S?dno1LbHF5+d;=+!{ic8k@m4-(Rp<@rh!!{GIgu@yOuk7HMLeUou
z6F0X~s@QP6h=ogu6v}FN-WT=d6GfEMvdoxPiq}knUpRy}CQU8WEB{(VH7w^DbIiP^DgTT6|D_~b@L5Byh22a4Z;0(fcDO^q-QWzjna-fq_{0vs6ckmQHVOlhW
zFh3Xc0?sU`L8V829wa9{f_k}Dh8PN@cVBx^?SLJn=*zIK={h
z8vEiiQ5t$JIa9YZ^cOO&wv2wk@*~U@=JxGl1ARw0YWPTu*h6EhA}2lZ@EN7_UqYTd
zyeFskY@35DMMUBEjD4dlyshlR&Wkhq6RuWAEy-dZoYjQ41!D*1ImyhfHd_t%eU;uS
z^d#Xi>iJt7wUj|eU^TeABUT*2hu4N9TyRk&JCbHqGPk^~kxG(~0jm6#S~6LWQ@ZbZ
z_oRmic+oziSQ$=_Em?i)M7($PQP(B(#N?O}?GE!2@@1I4ihzSfSjt;M`isxt)Ln6-
zI>T4f$4q?gMwK~(%>jutcci5YM>fLEZ`k@R%MtX3J=w{EJJ@3P1&f9~*xEI;B@t>_
zTCDnmE$w3yx+CPwqY&#BBSRTqmnhgppi4|9bhfKz9a3p=bG0
zJzX1_$Zs6^5|4ReJ;aH`EGYFeb8#?EBk7osAw!v{ff5jQh*tmv9Eq(2gn?v4AR!an#|NWzv~_H7G+WcX-5u`M){()gE9k@#OpC_GhDWkS
z$=lslPp`Pbb_R8=U5t&4X3d&+u{1r8jHO&HmIr`QOO9+WcA-?Lj(P|Du)6LMTX$5#
z9UZBnErS*|5c0LQ4v%DXhpXz;+%43V%Id=3xyTo5AKFoLg(6h~6~z3*gS9MPAd7t7
z7T3^_aE0tutcx*ie1{;vtBW0k?BjzHK;Yx)kJ{PunvGZNor_(uu5E+D&BiF3N}h<^
zJ_u3S(rp`K0$#o~kxkaemD&F?4Xcs&fYlWPgOwTSfBW0t(jz#~Qmk6F3cqX>R!c1y
z0UyviR0fCuG;^j95Cc39hjRuiCLTL$HN1%Zhf(Rt$y?_)Ke+aKM|nj1}B8AJq#<33<-CO%iHCHb;kw`Ehd8-Xb~|qV!2vfo<;Ta9hMgLvse_C9)W?Q
z9&cv=mL3~2w5SK>*8;vR&nA7H9a0DA)3(2m4lU`_2!9d|j1HyghTg74_3{&1tg}j#
zkFaCUdMRhG^x%<{j~B-#N=y1z4-F=^4<-_|2XPi`?`*5D%z`%nNKT0`h-8O{I2sM~
z8qMRSEikh!LO`?{j=5U9QE(P?|5F<#EUn$)?y+2pvUz{59A-D*MSUlv3c+HneIn)V
zT5=3_iA>oy5*J;4-Kl~*UlU_#(cag?GT3a%H9DnrEg8rZBE_m}B1!tvWImKD#YPjv
zdtH;tM@rSsiIk^n$!dqMJ(toFd2iRU(-S%GBah^JSHI5E22$CUd?7kM5$x<;mCeOU
zdU!GsYVTc}%0;pz|L9b(yLU|{A1hW{CX%7fzT@JBP^KIijcc9#M<eyqAEr$!$!U6Pwj7Cd9J6DG
zwe8t*y3~E*X>Td$1LJ_P$dQ?BtIe})WJ0v{uPGa`Y^fdS)wS--lI4$2RffhY-ABD{
zG8N4gJBNlv*SgbKO%%2xb4MoQi5&M4P9CMLBV
z!?wjoy?H7b&K28t3_5z&zOG!QeCN=JZSj$(O(r9`l85Pf=bDo%dMG*W9UIm<*PR$o
zg!2Xewn43Z&H73;QW*D-4LkdfI(aJT@%URydaF0OBwG#+joC*h@rCU6_$FgP1&}~o)9ft?ue-2d(<&zEX4Ql_-|NKv!KN|STb5WE%
zo=DmsH&F)MKUcKW+I`o_mgi+Yy}tzWmI6M*1hhOp%LHIcu3|ya{Z2B
z@<;P}`_iLNOib7(CoH?Gx9`YfrbhHk!52?E7aeo*@TfjDWtPlX*U_)rF;Y!eV&m!1
zp7o~7!M)PM$YNNro|WsfIe{80iaB3+Cx<5S)~ee@@FL;QVUq|0n~B_V;w8{)F22M(
ztaE0~CHUa#b}=@bTDB-E>>D1s^Mfnp<{6X(ygJ9@#mH<>rEw!-JNTmefH@!N4GK%x@=3v2GdJ=+R7DbuIBQY*0!ML
zcIjo?2<0qeR}_@ea=AR^Yc5xIsN!21jdNFuO9&7!yl2at}!7P-kV
z|K9h$7i}$Pd?p@v;DI0i_{ZcS<;*kB{Mg4n_R)`ilnuTq5W$L|#Jls{bI<+Km%fBq
znkvYND;zEz7`ET|#y4VuK`2ucmSzMx0`&6BFXwv2iWTUhue|a~Rt)~}kAK9&l+wrm
z!IVikfEZ-7f;<&
zGGd649L*;D;i$)oRx2gLO!h)Z*qtJ!+GR@1Q*8)n7t3-}$L3d^Bu
zC1SmMtF|rWO2(-A{hs!!ZVyL16UnDp^B)VX$YzSeV;g&ybee{i%c5bncP(mX`$z(k
zvbKp3`{hcmQXw3o+wYa`y2P_KYE0OOA|=fMwW`e@a97QgPQ^OOewT;*WwRXc`$Kq>
zRLVtz0C<5QTL?qHvuH)#F}>{1RZDr-geS;0K2BS?>e6d&FM)4a3bS&>@!w7rH9~zb
zL7UBw(%8BH6ZKZw36)?oIt4J77Ulo}fRCw>boiX!!Ke>=!_t^DVE9d&Heu!iVG#55
z=%bIuse%obS*S&3a06BkoGmcB;AzA@t|W5MM{x5z
z<_Rj`^tdWUDOV^tan+TvFdW5PMYD&?|_&v{y$
zy1liauU>V^Cq-=q5QA|IpDpH>%-b9_f}Bgey=)P=`@{_P7Z{8$tIja(^f42kyJ2O@
zZgEHl(`63&#(oa=<;xpvS!bCwtHn>#+-g}@S;;HU=;!*!*3>^+)~`-pDy+hdR_bS#
zb>mvJP}T#+=q;A{$CJsEzr{*kZ&|-t(}L~o0c+$Y%XsLNCBjPIV@=&|8TYS?k^dfR
z;y*3xnp2huD|?p}zumHKU)#Y_fFD}c^;Y4A#Zm+OQ>%PsmrWc^xM<^EYvdZs`0eR^
z8ofUkh2`*-h{x}~
z=-6&N-LAE&+`4{12GP3KD#PU0E~VZCh2LRWclNN#+qzfw5$oQi#5tb2p`Lz6FDhH(
zeyeZ|-R%hC>Q4NM%-rfD-MrT--eg&KuOfZ)2CMuROMkdq(k~0N5?8OMBb0Bj^cyYn
zQHFk(NU4Pb*g4ix=Ve--c3kUMoBNkL!{zgmxRS%3kN$>cTHTEAzNs0YSt0p_<5?Kxf
zBIN&5b{y+wt4OD~b1(H$&R*%sUuVUyID-+&x}x5xA87Rv1Oa&}`$dKKwOHg|<)<9v
zcz4bO@0!U&ip#@o7gmYi=_H46s0a7|cs<;zEL%Fmu=RtTH6FPA5ND8sX+H-u40wlt
z1)x9BApAnCDhZM6&O+0WkZF2-rmjrHplErhyZ9inOd0r0Idu;;B6?Ajjd-0|k3Yns
zqmgaTJ^uKU@BXXLf9=vw{Lf3jR*!qZ5LdSO{k39N^F`P(Q|i4qq(zOt>3X3>t$yB(
zo}CJ0MFWzaRa+5BJVG
ziPpb9;W1P?4@%B-%XEUeNJsfP&+B-sIan{n9#c$6K4zWA+g{VW<4Y%56q
zYCh{^lLnqC791@9vhR%s^FkHQuwQP1es3%;#!w|NcA-HUN
z0rk|A&uo15NxhVuoSeeH_?TncJ39N8EnSHch}Ad$`+tA;iYqSr+mC!ix_$1p#leeB
zJI#lR$)$*`^EP6i;wmNK_L?}=`dsz1ub52!^y(k~(^oIQ@WOXr_Rs%J+&dWsk7$R|
zYm^74kKK(JySni7&HY`_ALt#7FOWhv2dWS~(l0xfDiWtI1b)5yt3gS6!tP$%{t7>o
zd%F+2(`pPZ4yCNwdS+%p#%#UCUg`l&GV|t>fcv;W|HU7}2U{vjX)q7*2>D@VI@&?C0^=xlE;<4toom%`D1p!;
zEC!}zT*1gd$59cMr~CUs)iVDxAC4eHO@`)w+a5H9bO!hsc7)OC2~R%x=uTFdsf{uVQ{_!9G5s^wuE3tAIHhGie1=s>GD)v+G
z1YiO;6bwDL+;R&BCWiLuw`H(b>`mtaVc?8{>&aKY`c(kI^zyWW?O&=F&|i?-l#kp-
z!eg1j{T6?+tFF50saZ*;t^fc)07*naRHvR|0UaO%GMZgx`diG0iv_F6P)w}WsT1x7
z^*D^k3>7*4@BjYqOd=UqxJx#$2>iNGk?(w9viU#*ZvV(fT=oDESk~2|1BERh4@)_6
z6DN|RjyeiwJ#YpC|4fq&%PI2>7YI$fXjx$SgCG0=Kf&*O=Q~PJV&%ba5vdCCGfhvk
z{ALThVhbpyRh}qtFJ7)d4Yo$2D=Ez!e2YX?syMhBO$L1m?-pFhm6x}I^#=PQFNHkK6$EXL8R!AtO
zUmy<{0C@ze;1L$izy@rZ#oUXCkb4%=z!W6}(Vaj8^q_2GYKS8tYBpwy_{rjO2$w=0
z+>1<6Vx@ruG>dAsz#+7N8sl+sWq}N1IqJ91eeQFQJo1Pd?Ud13X&NXTJi&4^++ct7
zqaQK$)Ag_tk_Ux^n*JR)0hF(l(;yX|qB|hivAkgP#9YE6WV#HUg?_DQTd49}$pLkq
zMi^WicuUTH&V>p0Xh+41APKbM#JFS?C5fEj_=g^Ph-=u9v*N|31g9w$_JP@$b+-TV
zFaN^SN=YIVynKBGB?yE0(A8I8&B6f?1|o8I-R}%F3!I72R6-fS&EiI8hghtk4e`w;
zFU-=A9SUKPbB4%h7TaurgK7cgKn)IGnQT53ju8C%*T2sCTOuDY!NN8S51>d;
z%Nm(iu?i7q2yT&+W2R|_cI)0DJv-{)C>p5(J1#2#W3sGjkd`u8wYZPl-
z!>MpQjLxzGdV*4{F{e}zWDY+=v+9{{0X{u5A=VZVB8k;>Fa!EqWm*PU5Ht+WP&~-U
zh8YD8Iaqb>!O{=N;Gh;*5uRMRawSwzFI3?#0_!3@@nz#0*E#UeAx!=bmZWC>W(&Mx
z3*d(Vmokc@P5^3Pt@!Crf67uU;_RUdM3B;(FpGTUD__CIp6!>F$xr!vvH%1%11JQT
zaivE
zP4p+oIGcOh=%1$Q*V%@{=>zSK;rU{p@F83zUBd
zST=KJSvV{Ba3o@_7Pdb;m)V(xu0*E;D8t4az-1+J4;Epl*W_8q<5~JRdPi)FU<-ON
z6q12-x;6n=nItq3`KxD)29~gp2Uj`+j{0yO3kP6v;DrLh*ycgsG$Oo6w?V~62Ww!P
zHjA3W7GM^|TuLcXVE|lx`M%6`)R`2;BYXPtEx-j}Q*`J2D_8%ltC6&z_u
z>*3)6g%qfO4og~)?W$xv_o0w$OyMjuQLodGN}Gi=qy-i%$N=rqPhd(FD28iN=nQ~g
z)>8qu!QF5zu$TUzc(fr6+AL(wTY!&?K;+YdFz`_0yEB(Ubdq?%1sAZk2s<%ul>|G7
z8JKlpl~Dc=3Tra(D|Nz*z6j(&7$O@njp_QFbI!p-9ttt-Q7?Dd1RUKjYG>rTLLM_p
zPqXmXW(&aT4BNarY(^hJB*K#%bPf2Eba)RyjGlnIDA+(D{3LiC@vjJE2Pj8`k{_RX
zwkBX37dAX%pIf}0=ya&-8r7<5wHGwdH2@q~Uf94E(G5w|PCAeXQ4e|CRg^cX>Sj5w
zvIQ2bPX+?|8{hZ_s*6v2;uG`=r9gv0;Y*qfa|t$hrn8JIa3@`h^Q&yi=Hv6B1(29X
z8FW_=gRJ2|4)WdkiPHls?$GXnLjL1F{sU7Qfw_pV$=+8V_`nAk;CYsu2u-!{WJX_y
zx>zWSs}SKaP+$-#4gwJ6oRRyA2K?G?y6Gl1h(TE6LNufFGz))iwg7yntc1#P2md1p
z6)VDcEN-G%_{s7RmXK`RxKZt4q}qy{^e@JBr&rA9@6@F209$~s%uuZc>FG!CZ(#S=cfIRf
z$VAmY$wL%EG*~Qw18b6qS{PZ$<6JX0YLsxCrr~85@F&E;b?92~p2I8xjG$7|IWrMN
zUgM&_eED+p91uCv^t_C`=Fiti3n)J14D<8KjMH=kP%onw^D)FDSOLci?91$2&+-l6
zJA*p6n8m@p4Ed^|&?Qg^f|Pk3*OW#$P9o|yif<_#!l;^QA<&1}0#coL1k}!?f)p}<
z+EHH8*?~m-T##Q-i7$1YMi^Yo=a*fWUxF5A%{0B@xZ{pP&j!OWsDLoQ!mvI+;m*~o
zR}*C%Z5x@nJD)#NlePnI0X`)_0aXM5f;kNXIqs8)yi-m&g~=A^0m(=nWZ$3u^e3<;
zMqE`mPjNwh@*pb@yv9Sz35-CXW7q~v5Dr-xM4$l~idaY0%v_B`q$jrLS)k|8-lF-`
z;obr;Jg=aX0gU2Y11#txUhcR1DlmRrv^Z1!W)!YVn~)>C(Wen?=3K7Fe(#u?*Q;#G=Hv6B1sJ@Qh{Q&Q=t1fMD4B|(Cs1=W
zH~|R=&_s^~>_An3qbQ=26zEsdwo%is{WJ*lfFy_ucjlRA!k-WTVW1x*wc=H%MVNl^
zi(do@A3Lc#rcC
z13y3nKo8CUaNtzLQ|OPmtMKu()IDVKrXQqO^egn52Of9;l_W$$Imm`8sEc01o&aQ~
z>eEj@9pOLyVDn(}h?o}_mG
z;wcCL3vz=YeSqm)3(#c{H0iS!#dH2K;rIidkBxu^ds=P8dRtVh^-WTFd|=NrmJq2
zKMO6ur({wEj#OV+$r?l+DN5cEf)KHY;)=nWoJuAtJ29e)TgWD6Z%9K92!@}PwBj1%
z!Ff*70l`p$#79;t@&H2+!&@L{NhAY5)xlfC=W~)yTTw5A5F-#|(5+}LzQyk3?IN>b
z|69T?v4cVpHnCF;E3rjQ*nns?o4kk4pA>_BZWB&X4GC+(?lrxamX!^(w*v_4mh-4;
zzU&Nm%u?0vb!OrTU(8E8IyKk$#5l@{f4ThI__1An`Q;Z~^r?C&yNcTh;AnhWeIDt*
z;eU8f4Ms}NL-s68686@_vyry@use+~=J}wukU<7e8rX}Zt|N4TuqFlAJ{!EytYd~-
zKuwsK%`mEQ26K?Y$7Mw*n@Y3MF8kr3^<~n7rIslUatB2PKN%FKN#j9MxJ%b%yyVO<
zNslED=Q&AdQm9t3Dmo#FS5vb|#&sxHFRLbVjP4BWbCRy05A-NV2jD<^#7{MwoNnO;
zUszI;!ML{zUdZC>lLkPB0v4RjI^d9_qs?*(!(Sg48%)UjEl$4o-VRN~$7L)|e^`Rl
z(ZR7ryGSW0w^tzDQez~
z{flM#s4EC#{PB-}{F~qWCJ2L{YF9i25V4IBuMEr}2@J_R2v;zElfoIn#2F<4cPWrF
z)y`Eq?icVXdS(oK5Chp@2-Gl);@}S?DS(3uMImp2R%TApapR{|X-U9nz_3n4QckNMY$g_R(U|)Z4y$$PdPHHb`^qshaR-HeG>ZkCY
z5(WH(HYNGz50S5NO6uIR5ZeGSi{_j&Vj8rIC?sG;6JacvPtC_gvZzTvV1hC4pZ@8e
z*d&R4#R#^>YceV`>F0ux57C1v74$$1AC}>80#B2VwjK0L>_a
z*(6}VCcP
zTu0}n*C6L%KXq2~gaa?6nR7;4V8NP8Xf>p;nq8p-XYjxWkeEww;fywDv+&tz0n`s_
z?!vsEk4uOxj3Y$z_7}5n^<9w(*_un(oi0dqC%2$
z%_DP?P6RnZj8nTZKq!)MttSo=o2Zel{7$$)qyjSVGMSTf@H%aXaEAsQY>DU$k)+Hh
zj+Y?A0zQ~KEg%*;C#FewchVkpoWUepUDtn_ny6?cL&#N{uaU!)AZss&RyT9R^YPX|
zE4Q!w@s*(Ma;|js_kVK2(d)gzKsK4Ar?~xIt5(6kM#y%qH|1`&5;R5(=<~{Af{>@b
z&}(=pz&A{Yw5R*SmV0T1!#@duz)Pqz?>K$T=QmrhAcNLd@=ocQ`39u$ZDv#m&gU<^
zz-U9bFuo#F02$0?Ko}|@%3uESm(xx=jh9va7F+-|m~dk~!FQ4^r;$WF!cffs$%C*5
zB1yS5Og9lW3%F%Y(otgoeeffJ22hkD3_O8h0`hPwf`NH!uBQ{{Bpn?gLlX4Rm`5CO
z1S%ycgmRYMPB&x2FJ2BZWCb?ql%e$bpp6%=Si&JJ_q+lb
zbaPMzJ%WxbK~jBr?E=c@;I7_br3%uN|%psWcp=F#VQ)ub@iqO`!llSo0#
zq*tw4H9hDeca(}kF#uI@!D!7Htv;h8=jr;DB1HXUTt{Hx;sD#sRXQL80Ho-FV6YSt
zlM855*n(TU`}9`B)Q6C@#Z8|qrl
zSVGBGG>dj
z4xk=B1_B!KhbEje{&7UqXXhTw+XwJ;Gs}E$0SsYm_K2qiLBR>A1-YO}hCMzy_>yrN
ziNl%cH7PIy;~%CI3?*;^{J_W!7U4i1kpWQ!Mj->hg`$-5V@}fHPpAd!pk?9A%nW!0
z4>Nc(SL2$o913}TuGNS>SLu*}S_r=uNX5IhK8>95aO}Hz9oF%L#1=c(ta5=Jr4BOc
zw*=M_uT5{2iVTvKC1t^%dD*?apLhTI&h^Ki_>&v1qBX3du(8UdzT}r?BGjj8
z39z?b6?O-PX1;CxpePPnuYQnRPnbtIgHB3!Rzt6vOTdb#)0!Y-=Qo=N|1DT^3CyP?
zHI3YilQ9oC?G;E+LIHU}K6O?XT&wSh1mRj?1;PZq|NZZ0`ofvb6nK`;O@6QfL+@T|
zVtxbQpakR**W{UH9Q%1{_HWVPsN8X(rD|Fg#Sgd*
zYLz?74ABF^Fl_c*spw*}P|aB=v(bibvs)n_fuT%8R6&SUvs$g`epfxXNY!-PBhpV4
z?x+f*YC8P&@e?NvX6%f|hi|$<5>oFV%%Wx2Y*INmnfx*S6uPkAO7$M
z#~yq9x4!kw{#66HscbM7!tNolnN#4_q7#0^E~+&Yeigru5^I%OS@uVp>2><+_7|I7
z*a`pXb$I|BJD2v%&^JEFVs{4_%{Unc*?6;*eIYMlWu8haGUrpXLuOit@0nKT&eC^V
zaMdtSO~2FhEQFDj{YUW4L^-b(eQ+iiJn({z7FnmNc3UMs+6yIarVDx5#k850%
zUJrgMe)xuUCRG_L#TNGYU3TGii3(G4!z46{<*u03nlI>QKxK+vtFR}yDC9wbnfSm5UnUAjxQ<@KBm}Q4#fJx9O!J8uYyk%g|7NiGxhtAcL_rFq9JxiFK6zDnk+;e#&E}#%R1m8luLL0L~!-3R-G^h2T
zN)dL}S!W^c!SOTNo@g@MZt0~9qcGf|i2yMW$}*iO#)4k6;xcvNwu?eqREv&~PxFE%
z-C9|cbfac>+A@V)p;qt(15TgQ=5mw)8;5OrDxcA9x<3@KSkPk^WwV6Eqhyv!)e7+9
zuKRxd%bS03(&?wX<-9lduUvY}@kg67UWlRFYN2lefns5*m&gnq)0e8GOA2<+JnbAD-6qc3{o&dEUjKNRU
zsTEt!Xw`FGxRRObJmVh*vi_+yXKJBM1nz!b*1zt8jsh@m194WB<
zGrz~H<{$pyAHMXZFQM2V5ul*lGx@mmG%y6`ea)m5KPaTa$j!5;xNw==SN^$b3fw`M
zkfHbmQ7L@}bmH{zvc{P!@}}#B9tgutm6R=8wyvtcALw_UNgdO
z6PZ+|Jr;IYqFR<(exH9=R4%sBMPpGb+d@XEmJ9k=lMF1eS862;3YAL9;~`LN`S48-
z2MEX}-zZnaTbVuCgFaS{)Jk{Wc{gT}9Xp0DzW58D`Q+!wV@OIE(R<%-g;R|h0d<;k{pL){e4($=bSOEX&W8)gm`Ci=*v|o;r9h+}XVe&sC4^~G#`wlo)GVzb
zEigUU({tqP*lw442~9&@Fz){T_rHJJ+uruM&wUPr0bH0i`~xolkxXLfb>Id*^uCB8
zC%zpxqH`t>Pa%~Qd+h6xIZ2n%3(9411_*=K;bkF%HklJ*_ERbCNwb6ez!pR^qw&@E
z+Rr1e{+0|XUbPuT=H$X*SRR{*`Iux^Ha+uaHYfM_Q^Fb-rOl$SL3p~<6)
zZo9+CTZM#?oAhax-)VVkC7;7Mtkcc>lta%ttYXCD=xL7x-S(&d{JTpo`q&pf_Q5ay
z{f8$uKlk~+|FA=p9HQ(jXSGt6x9)C>cpZkloSxji!EKbCqTB#NdET-5@((!2QStQPT
zYv8DLYf5F~GZ+7*R-bw^>nHuqZ(Vxyx^=~J`AZkyWgO1wU;dJ$A6*9T)!8miJQ=?X
z@#jZ!6JtWXmsB^H;)5UVf6KY&-uv6%{^0u?JwD;{h(=r$zy9^#luM#k2ko@#+s|9^*YCdI!N)g#@t=Qa+UJp;fO!Jb
z22_&Bc{q>*Q2=MYA}<}L85Dj}XZqUoF`r*&!Ga7m3uGW^#>tq^{I@%8^qlE~v7c-1
zUU9`04?p}cZk~O8ef-4U!H|ZnM1cd&YG70Ff}ixd-OHT523~N@U5aJejYv|qGgZ!X
zwmH90BR71D=tNb(0ZCjdNHpiy2-
z)`Y7dDx+=w6CQo!Vw*ML5J|lfN8!B;PoO6Y}xY(8#TLn9;o
zOO{lDM2Bs9M_ZfI?e@4_xk90s&xazBP#};@r-OdK%i}2(3aLznyIz18Ja4n1xSJRm
zVMBM1&!-W51x+s)v0Qa{LYPE|S5_+JtF=lv?6-tDGCb<@1sryd-xuv@@7=z2EF5Yr
zmuqLg?e^yqJ4~ym@n7~(OQbJ1<7Dhh=pAaKHuyOya}TXZ_23~terS~*_)`$ZxI*iL
z$~iMQHREI)c>8Y@p+Zc$-P1#2kwNH6QGQjtqia7b{=El)HSZMuA-T+(aAo|o%Z+%9jm
ziZ8iKc(^3g}mW%3fA&g^0>8IPL~}IVY>#B#!Sq{kiz40
zgDTYHhP!a67p&of)&9|%{Uo*w$j|DELe~M^D*S8$yPH?#@sU5
z?zK<*2I6VK5T&dD=oLT`*a#37fCePR``-7yd+)t>^XAQsG7~UtW4KjNM%iw`EA!9{
z0aZ-SlvV&W2H+T&MYC}1-i&j8P5+wxI2m{>66->95N{1le#s`vZm&(0(p`c6#~wY!
z<9Oa}Ry3>PASMQfjN2vER~&?P;MXgj$!~WD%t9(x6#k&lf|^xwgVo~^7{6@+#HD2yq)LSi2I-}Y2q=>M-3X4g>XV?6CIpqrA
zbD+pwF3Y5bolUXphP~bzAXgK2T1z-h0;jSInoT(HsI?rLBWe^2nPMr{ZB8GgI9I$m6d`y
zED|@)C6yCKx?t6;Xec6_J`*>Sitzh{Sz+BOWnk_wT_{mlIZ}U5CDv8#yGVRd6SjMs
z0CQZHp|Q^2v{R6D
zFN&poxPW^bSVcpM;@i=r474Z8@Dor$x4GoKS$$m{UgZH}TaGp4BQ+($)%gL(~8dqE@#b;g-S
zGlh$>+pLe>Qk6kA*l_w!q5wnwL=3C5x=o{b
z?jxG+-bY6G?oljz%nc$gBT$3A!uyj4Ji#S
zr5tFR9<$-znf0bTB)XZ7vAbE{DQtO0a-wbT8pj=V`v`b~
zKpm(9+;Rt4pn>IL+tT_bv0QVD4E1zu91@zSJaWt@RF*uel=>d1(hkD5r<%Q%HBlir
z!NXpAxkjkYNk`0^lMAt_w7#6iV^~@Vyh4~$>IAw-l(J|1?-!F4+Momlj`q?n_CTN*
zPZ7op9L^qnxpW$F`j7v3%3iY0X%d10NuqR3var%d
zr6x*=RK8Sl2i%iW!rR?DK0&~8UFr(lhIDdpNK_#e6>NZRxlO`b$$?*8D+>uG2nS%K
zZZ=_%cUxx2GGeCDW*IG}5wVPjX~Zm})ihe`XRc#rt=+1%*YiYkdDaOFx5r*HY_($A
z>BU+Cg3zU{CgX+{LRwgrvRu52YpG9JXLjNY2voRY`Yc=N#UC#kQ1;S#N_pmSqAZC|
z)!5d!qp$D6k9}+}Ip;d587E_|zrZWhzhE6d5kpFEfgDt(Vp71oO=ZR_aKsGX23~C2
zwynRvpL#IoV-Uf+^MfD!Aof%>AH`#XYgABZ;ISGsYEnYIe0_DMYUbR^b~fMmfvMQ`
zW}J+DGNBBMQs)GWq)hIDzLQIIw=e(ZNNeMw#R
zbfy}Oglx{RbdPY`5{aR5RYZuhQw#YQ_a(PH72!@zIB>>H3AXcaXy_^!;Zx4nw!|?
z-j+}`Gn&ceTRUa#skn$OKBll^%-_PUEmOI?fwKsXDjE|jjBGDePbg1Q^_G%^-45`E
z#At*o#4*EWnf59_B_J{!qT;iRiY;2h+oNcTg3%HVzWJ(apa1wj-D--C-O8BbOQw-v
z&1Rg8IsOd$tzPliezP2&H<@5DP%%W!w^8KqY|e&JjZgq#ptNA90AZk7c<+1P%gz@d
zjN##7z8W4ISO-7=_<<^QRHN!vns!QqG0>?ts@TSsL;I*zwTRAXE6F_MVWp7*2r3ka
zMhe_EJH8_VKY;E+%N-^>QN)?i_9x*WDBt0%&bJw7blosnpFYdc{j9RBFi`+oUU
zEQ*4GkeEBia&|6d2si9E$Ul2^*I(Jx@}@ImI^(96Fr9hR
zrG9cfWjZM~GCxP{C%Z
zS6+GLC6`=s>7|!4j`sBQ@YSY=f3>`#fz5=Jqzdp2!U%i=B`gqaVEGLx3fg#aoKY|~
za{_6Q51EW5W-T?8u3|7?IOcstB
z4&886>L~yV9bjQNz#MG0QupqZssgF7Kuv(I!KmW_c}>c6xrZDzu_D^KI_|mqiJNW`qr(|tI;5_`ABH5hGczooX?bx9!D>_g!x6Qv
zJE{9=yx5*RvLA#&J{s2Pl)+i-BA+bLcWCx`==h0{|Hwx^!u$aPE8NHhs_PeDvw1ZS
zT42F~3?^7=xWXq04>ep1H*Vahq~Sbh_JvOZ0|3?#&Kz`mb-{vF22pgIyg%aLnP;A1
z-}ZCPIY%{zny(`@xL{-j9jcUuG#1Rjq7{@S;2UP)91s984Jo{Vh4A7`)8Ss_P6UO}
zNn!)5XjD;rUsO%#oVY-TK_sqO0Btl5T%qh}w2XWg>ECnE@08CQk|*o)5FLX=O}cGW
zbTgN;sx|)|cZuUq5I_D2NMdodhWiKp6EQqZZ6YWq$%fl*`RtAm-WXMAu~ofcZ`mjm
z$e>wsYLcF>%!{`ClWSq=gLx9M$K}$+@+#mWF+>N
z+lQKs7ivBCY{Im+;E>_aI`6$t{MYSbXebc~E+&8&nv7h|`S0JUJoq3^7_Fs}6$nzU
z)8&a4if)Iq1%eaFirp2ncP<$kDFZlAuvnH;+D7X35(zN&bPIi16B5h|7G&!u2Vg@+
z->(nhFUvH)ekxaPL_M?0`9;}lo0fl;|`vtW#!QHxbE2a<(
z0jM$l{O3R4b=O@CoWu)f5are^P^h%}RD`%}#>r?%gU>~r42ey_27E*>u}*xxGJ~_*
zeaR)K9_$+h0uDIPC>B8&KseSL0bjhHKuhncM9SDUC@%T(JGX3;$zgF$?I+wS#A7kikg{()j1(I=JHYFy;wf05F
z`u)8aWzK$!xa*!wp`^8UtO7~gcKh(jr%J%!W3@A$MvmatO>v8*rm_B^F&5gkwyip0
z>-Nd1&0|ZJ4`?0zg)*<`!Ua|8C3ZVr@?*DjE^FyD<@vjvdQM5YP>~$>A6$!|rq<69^EFHiSt#x-(|#
zRl~O7u@@eFeB-LMVlt6<*Z&Y#UisT}+FWzYX&z526Z&K-_x``r-+BI+O|&fPTH>&`
z{oijrcFAYNn%>`kMK6b{*4{q5I?CpBpwuj4OgR#H=(59nSJbuoZQ{%&dY_jvO-?c5^5@)|*
zB0fS0^Drih*T3ngn{E?@yjCei9JY>YuMy{+_g8?7WF|hDn3{-}zVcOZ#_PA8`nty+
zel(FTJIA(6eduHQefOtNK4t4^>z>Y+2>ijq+B(kQF+df6u)@9-WKwuG<770dx4gE?
zS+F33ajO|8V-9&6iH+9<1fWI7#}fs{*x1;~C!hSg-~H~PhaOV?F{m-fhB0f_%ofc!
z8I58Iv{Q$5oD2gEhQUU%!tHfCT`s&jP_dKNv1s6m?^|E{UvKC;qW7$`-+c8oqPKVT
z^UrOqRLx3NT>h_HfA;g%?|i58;)|b6X9~GO@#?F^yZ^fVSHJw|M?d=3&wMuC)4lqi
zzx8oo!9Dl9bIHo}ELg=*a?CN^pZJH~u8t!<^~vWy@rf0;-S&=)zp(zI&uttT$#gGX
z@xAXp_JI$tdgS2`eEwqXqEE(g0r}}q-jyk`F88?Bj^08MPgBv-7Q*pj`%rRn!pLM@
z$+YkWqLEe+Y;pGVx4-9t{6|0P_|1K1eEPGtuY6sETKcQDa3Ujq_XqL2Kc4i>%f;0{
zCzKaXk0|G(Im1BnrhD5QhwK21`X2
zFJAoSH^2FY8*aci0yPGvQ@{tGX?B#b%(+>w(TtPPs4q=>f;0HIhiRM)Lg&<*vm`esKe)?TaCraWeMRGR^dZY=H#}GL(q~MLo`F
zXml~dUv$w$_!1su`!us3Vhf;d1z7MEz!Ug#KKbO6*IaYWm%sdF_9)?7;Dn0~qqnzL
z`D1c@h}9hMV}KsMK0Kh@PO;QL)hw)rIA8*IX1wgO%ck8Y(Z&J7PzXWo!Im@A`LQ+7
zxqupcVm_;?j-NAKFXiJttSq5;X2|Le$txBo3>SNt;<;5S!+tKe3l~=Czw*lAsf4)j
z@3)-u)<3-Uyc?f>N_^|`tjq0BW)cj_{R6%D6}9v%9ooTWsIF2u{e?@qRvjt+?xT+^
zUvuS#t$!)iCMS|xSuk?UsVjyjpL6@G{-}6*!;@}bA<*R-oqYb*JO1*XxBthdK64dS
zPmFDT_<{RTNR-OSqMoRlsfv+^wrOKiTLy>4RBHRciY}MWQ8PqQkDvdp*ni!@yBk0M
zxj66q*SozMwJcfj|FicVaFSfrz5ng%uFg43&b!*6RX_pdEF>c=z<`7SS?C!fz{c3v
z7&lrce0pg$NRzzA$GPX^nPFtP*+Pbi?AH}CA^na;VoySn=SJ=L>oX?GT{q#bMV
z)BW_;*4(bXb>q3`p71*Z3z=5Oq5tSdkAC&5H=cghcMDZDcEoY{s)j9WC^isF4x1fs
z-vHpDZW}ku2IP=VRCCx7xM+qP|c)0^G|9tML#
zW!NE5m*A4XJsUrol&-wE3Pfn~IgMnCc!cp1W
zf@#&ccY2I)+?`CR>%VhTIIIST#wtcJ-lOjM`HrCx{k^}x6-Y2XKe^?KNKD;z-=n%W
z=5VV@lZYoeij|o;Y9!dB_{$0wIwk&>>1CXZ|FVl-e&FDG;2>t(!4-6%r^Ld@A`qf{
zWO6ghZL1?OKe8Rr_+j_k?qg)ym^S#G<9PL7TssmadF7Ahw0wR6%?SiOjb?RWac0BD
zwOskh!Ib<$pRwZ)h^v_9pw-|L?rpnt5Z_W;qCcAiJkmN`!Sp*&&;4rWV-SPCD7X~t
z2cx5-oDm7cj0}TgD4Yj-{J_8fq7K*&L<_$}W73^2b}w;k6=);7U-oowd-+D@l|8lg
zU?S}|bCflond=`Jn4I0^^62rDU>W8L`R<&wK_LkQVZTiPluW@;;!nF+`Ido`#Clo&
z*8Yi|)1BDMcKh~|@-X$3(*Daiyw6N?`E;jOD^!cVpx5bk%`VMQPwrPN$LRD^e4v5kHxlBK)Sho+^cx>ov`vJSjreH?N6zx7H4dzd~hWlQrQo68YwCiP~
z6z`1@wzJx-INh{&-zR^0j`Xu#fjt#luHIg9Ap^8rPx{uX*UI5A@<^*v6~AZ&K-Dr%
z20!cu?SP<2%|#u;@JZn-d@!((#|UDBi>3$sO*OZm9(+h$atSX<2Yl^K8wMVG@TS2*
z{mS1~xBg_;?DXThQ(gNvv+-zTZg$IA=cq_DFuQ&GyRY1N+b#cLHfqj}wQH*yA6eTl
z3c5@6CWmSzc-fo;Fw>k%JEkI$*!ErOyz_>SJMQS)@3;wc&Zc2jGL;L?SG%WnTJ6To
zH{bu}H>q$aRjcKw&(rta&%UR_`cu#)W^S#Q^3y0W$`ra+2QtpNy-1kTCmkzOKFB1b+!xlI}
zd2HeXx)_)oG@Fi=E|HGZWb(S5%mX-+V!pn(ln+Ki#Ca81(!(jejFWLVjmFA#VP36b
zlDz>~8HfXDG<+MZ6=HLb=>x~a?|%2Y7hZVb0J1<$zaRX;AAIg}pM!@0%mcpL3E)0-RVf>`Hc-#Nqd>MxK$@L$`bPG=wKx
zE;nORZ<&Uzs1g2yJzNB2@>^jhWS{JQgu`H~lveEj@dY%%Bpg1sKjzOB0IzWSgX-3w
zs{i%&s7q~iwQ^polnhR%VsjUs8GrO1<#R0#Ce_&|s|(KB`foSaF8&R7CbQHRANu5n
z+~57X*7>L3@ad0~zW>c+HB-neJ$BkD>VmVMDi@4cjAp28Ht+LB!_mN1A6HktYx>el
z@6P5`AjIAtDrKCX`oxK!{?zn2XFu@Gzf+(27%v)VGzzDjs@{HC9zldxTk^D2eW4Ro
zeV1Qyl2=m~U${Z<%(NSu`(kQodtI;ge);q2st-PM+AII*)RUCgp{95IeBD^k?N9@~
z>b0-AK;5PanaW51Gj-`UVzDTo(BUlHEPz@CNK;*R
z=)sodZkohkW0~5tY{ljJQfI!5lkrlIz{>A`;W$4cZ)5@gQiUkgQXuu^K`{K~Q~|dv
zlU=AF5V)o|ZbMMopuONmCe(r3mgo}?D#5?NmfI9oUcw^Td(|9TE}x6X;^j&?M5I2Y
z{61eMU(mh4;jJEPB`XlJ=W4s4nak^uYEe;F6B23fgSNXm6&GwjC-Dy~JDB4^HTdv*
zsLMTcH4*R`i29il?|%2Ye{82?jyZ;vk3yG<&|ZX@>O@dnNd!eOmY^p*;o5F&$%>PO|S0txSVy9ZHz-MqoP_(h_WVkdI@%-ZAIC4
zm7~fw1{{Jz1vL}CfiPHL2-Y3Y`HmCZ=#B^sc#})BFs75eP_{$)AuLGUW_bkr2nx<@
z=)gohAG+*w>FHuV90+%7U#t`(L7W(6UhSWp9cG&B$4Z0Mg6HBf){&2l?uQP6^Jxnf
zlzdAa-5lOKb{sE>sU^FzrA(W-YO?rvhS|%cbV&G6oo@-t1(NmtueOi6vb0ws8>5i-
z20UN-#D#DE&AeaV>@_7`nax?y6gMmsoIQNw{%?1=^-`e~j_Q_a&d+xShjkT+?06(I
zafCv=6^-gZbkEN=hKG6`;hyaeKe2Y*`fZ!HOiYaB@=Kf}VzH33zi0l5ZN15jwVD--
zM3&}fd-{_3TqZWyt2)iashwUQfrb6)%t9g&YqkuZ&r>KEUT?p0z*PIv>7_(0+B92U
zuRCAJ7IOJ;G#rn{c27_Cq*AouiO05`eCjc|xdqH#urt6q2m1pwef-!@s1i+k;NGWS
z`MR^s>1oUnSab*rK?4i-PUNc%=J{D?KX~8WuV?|*;j&uwa=_C8Lkn!Bye(Ek1TQsv-E
zjYT=YxER);d!>u$pRO^}OI4*+eebikU8wHfw5l(Ck%bGPS-k{4uERyNZWcLn*wt|e
zqij!P{)c!80fB;OE~i8i0{*t`akez41ROfJWK$;DTIAIA+^cLON%(Llz(kdlT@?059H9A;?Yj939N_Hte_Q99^hL}pwK%2dQud?gBEa+IJDy?#{
zIEkPZ!Mc;w6-b~2Iq9U6KJ}?jVdIHfgk?_^5Owg_#*G_aNOfeq_G}!GNQ4Vc!B&)w
zp0AJ`X=pbH-~ij|ahp+jWWVHT;k>6l_P(pVO<`v(LTS2@2g|gvoL~$UWo8lqLWZQ`
zkXgcq;fmU$Q;V_LkCv)myOTRxAZsTRz(
zyct3Ka;BHaqu%oRy{DdhhNJWEj4!<}6NN9ivhNE1
zMcXdW{`IpighiL`X}2`5I~r-$$}PWMUURh9EE!I|Xt#8)J04ZF%3?rwtUY?PvM_VR
zX~$G{Y)idjLwj<&*(^94?slu$YVD$?wTi>zYn01#2v+m+yO449ZW^9_d>XRTbK>~!
zyLUySf}4pNrPYLm^<2>5*2tut7y!gHK>qSx4U7rRa%pux_lWX!Q;x5rgP598H6@NQNs
z6A60SEh91zY7{bbw!_gBo>Mxpn_3WCVKVG_Bw5mL#C3J(WC27PkV9f367&Y6nYp6(
zpb7JG@vHwI&4wsPglhLu`Ah(4Gh*3CK
zn?n#H>EvW7Cm3Negw%BD$-y)M0=|5H-S=sfBKV}?`_7f<;+VbX^Yz}OPtJQQ5zT#n
z|HA%eeY?|bRdo@ak)yB(9$A+T$Q*|SdI1_J2V;<Ooy43&R8~nnmwTi#mv17*(
zM;w7dgoS<6O*cLL^wVHb@FxrhS4bheHmnAI9NfcdJg@b?SCYZhFbNDH>I*sY(r0$J
z(r+T>CDT?1Aj=52oBeWV-#?M*QO!I~0ZO5qX{dVH^7UwxWx8N8^7f=i*!!!^Qpncr
zRhQqy?SM_
z<-<6`7H3#xrSaw!CoOdpVW8bw+mOQEP^E6ReV@%j*$gg~fU{zQp}F?cQbTwsCZzo*
zRqXED+>nE$heDX8wtQs8S0fuCm{(MOzOWzUkHVOB#jWb6*dY!
zismqhEtl@n4Aw{_q-d|vSWKJT&djUPA*F}iV2_ups#L(hlb^X3cbUCIs+3jXvC#Bm
z<>6slLEBXRkeZ%U!y7cSXknd-uZ+j1%7)M7CW3tHcYinYjq8XY->R02$wZiA9C9Ey
zI(eg1XE|9a$oa>i)ug+--`J8281PE29894?>$tsx^+wdF_uq8e(iK`s%f7*Rt$M1aK!44g>v2m&4$(
zu2aClx6_2twci7#+vv5B&1ona|(G0Ow
zL3F`Xb6S`|yYvnM^KKDTi>k^#E%lTS71lMSJ398Hm2xP}-rx`PYR=_evt6lC(hqL<
zd(~=7_oE=%zmmTs2R4A$knA?tq92#YTbMPP$%nqR_81_u-dpsHd9
zWyf@eM}wKC%e{pC3HTTj-m5&W!9GUP!P|RBoi0$uL%!aDepq9_Q~S$5cLdyez@-mv
z+Ego*?P*{OP-XVo5e5s(F|_fD
zEB`hhKN-(a7g_J!=MH5>{@cnzIDvlT?QefO48&Ky@)cAhNH1|M
z=~e)P4AjY8T`5+dSb9FM^>6PS(vOfkHkR(RpcmQ3U6?v@CZj{etWWxuZ`nlMoWn$a
zwqLT{9X-0Mfe0HKU8@mJo;iVqg$xSJ3EP-GH#o)bVG!)SnD;?f+4;JI*ZtPMm)FQa
z86gMnm!rSK@^mNsp4T(7&u?%;KHuczWTGFoW=|!%H!Ir4N@ZmK?M^INR`Nl!Lrdr!
zwi6h4yPDEb%rv%b&i-O}!5{Dz_JUjfId7B_>>77(Xf!qpvRm(;$aFee)vE6GdfYyv
zR>p8ZU=^hM4nDCCx?F|)WV!y*W8F`;7Q#2#Rpk*v1gPoRVoz@b)kCFNjf6d_Wej;k
zk3Mv4!1=fj^Adi#x4sn6VT)d2U$l_DF-t-HtW=1GBBD-;_B&gZydIOaYL>G@V=*_@dsM|GMN%oaP
zAbd0V4y=xB<2mMfJE+9i$m&=PM@;WD&1N&$GLymRE57}`$FKOzO_nB;^Ds$>OR+S^
zLk&6)sUcyU@!x~j@{;sGmwtAydkr$Uc}XgBkS~Q?uV!M6Q@l{O<+sRk?~;H$Io&Vd
z6`1!}_F>Mvya1Me@yq_B3?%0(@fa*%0u!(r{T&ON0K~XLemQ!yAiTe<$QSutfR&Ho
z2_Jdg-j;T$93Mnf6)NiCM^^eP@aBn!WdSo=akp$h`7Bqyyqg)XU
zNk-FXTG;P2${zgTy{1vE`6EP1&7<`2r2K4Xg}G`p=8E@vVN)8#YJ08>W8sN~Tlta)
zdoWl-hgHbc6C+Xhj_S-(Kny(^O~Y^}Vot`^D;1Bwc5R0u=K#HOEP3h*b5%Y
zg;G!~*!feAP|z@&F3T1o*3Keu7J8tgSGCsyi=LZbc7?;RE%;X&OO`B5KH_=<2UiE!
zQ0Ja|?rnG69_{O~NzQ*!@-KhyfxdMp4@QJ84!3)2B$Q6tfifHuKv~#!tMICK2~LKb
z2jwLCE1S@RKJmm8C!c&W%bR<=OS)j1^f@`4GiX_t(dPPm7r#g-#G?|j)evPO&LB?wLF}%lSE)bCMWpkLon~QFAaLDvqvHum#jDkt
zQ!|2~QkKiZv4IDFaZ=Fvw6_I+kLU$@Vt1G{r_1j@tLoj`NTf1bKz4w|r0l1tm^5fm
z$CYpu=Mc|KD_bg1-`UYM3j2TP1tfqypGg}&`XVC^?`6&q#
zjfeez~F~Lp)*AT^Zax$?hQLDf1Sa44Li1J(Ek9BgudT*IJdD5sYY+s@_0489e&v
zQ*L|O*kw6J_LT9`|Bq(2OKPY}m%YH#1Z(vFsZ0h$m6mp|G<=s(DqzzVfH(YvbY3_BZAm=3-0JB398EkB{!!GLs6AQV3!qyiOM**KL$zz1S!G&^`MufBE!nDXRV#{30ID`o!^3NjNJu#mvRyDARo!xR=P+01vsH1bn$Fzzw3p}hKKV#30-Zq86Ytbr
zE>n+aN$Tn8cvgJg#SWqB?dB5u!TfX@jtCwIr(){I!my{7h%xM4+^#c|)AsNr$auFE
z&1_cMh=MZDsc=Vl615HnBvghvg=Rfz4nsyc2`iVta|g_mV#fq!bi4ck%zmtw0tg_T%-nOTcGdc}tr|Ifc
za5(XFs)a&u*ca+mU}TVQf{)2NeX5c(BSTs!r3wwzKy9L96rnm^t=6%E{b5{`(&<{b
zmrge|>=u|YU~1yd>eGvL)36Xb0BU0SqrOV5qJ@L-$aE*p4|>3l8!;d*wNBeLI?!xZ
zg9%^T*(qWz=IRtm#X43SK9?^Nsx+IeM!oICrp9uG{0hHdpBv65U9KgE^?JQhY8n27
z&l7c!-)z>?rK%p*ExbyKId9l)bX1^E@8q-js`6oQs;esW)v2nyC#s`M%+-{EjD{Sb
zW!&VqoiQ&=1yCnsB9yAYHF-N#uuaQGaM)D_KE`9Z!wzTAYB1AVL-tS
z(<=TyS*=xmd-j5Dq`}(#Oj&?V9(9*q*76Mlaum!6^l`WR}8Ox
zbb7n0N@?OhOUW=jIP1yE!H4ls0H7q_gOms~4IEiuo4q~kq42_~ZAE*k#|#dp
ziLTPDBvL}Vu5<}=UL0bYaA>LpltZ&J6X?a1wV{?WD$%EkRTYT~8&b|HpF?>y!d18<
zqpAq}f;hTZaG7YtkmF~wI*Sf}4Bpge^hS@|x%2J-b|fsruH2tx&)K<~SOVQ8Dg55LP(Mx`EemJtW{9
zo~u9jhWETHk)8i}uQw5mB+B`;WtskPsMaWiLe81_$w)XHiNy-JT-&n3#Db~U!OoeP
zo!vhlNz%;RY$Ozp#^U*Gp-mjsV5C-W?0r5OkL0sCJ3oM>VKC$;&R;YX?UoOF1g=Td
zXoLg7>DjqxC>)8$K*2CO{W7(2l
zr(J>Y-0WmH>WIaI)YEF~A^%{#W=3M6UAs0%lDdftup?Z~dqRQrr=R!Jt(BK?GM4A{
zOY+~Zq9kLLnGAaGbi>bo
zenB#s*t&JwYhU}&gAZPu&1MD%hmJbx#pW;NioJsqn~whWy+6OGHyPQwb?a+h`|y1a
zynQaKtvmYH!m(qw&r}D7HX^Ob7jmg+v|g)uFzXT?=Wt0VIJztaS`UN}h#yE)4ypu6
z<$BLO_Yj2yC{J8fF~V3~CPVgd4w!5?!Z08`w-p4y2`t|CAKyxbjf*e(+q-VRq*^Pd
z`Ug%v^;_Tk#;J**3x~ZEPrUiY8;@VNZha<`KK=CDo_z96*=%lbVtnoJH*dP>gz@o-
zX0vhJasT$j<~K~`rYQeaXWW0+&t4l3X|;0c+%s=~_~GBIwTx=BdFreF{lUlocyQuP
zyLQ(GM~*^P4*$Tx7Kao$YuikQ<;dA5Lu~$ooCFICX0*?xTvOlq+jqV3^~Y>l`^Cu}
zmrw58#m`>#s-Hjl=<9dx+!c#O&pr39?K=;Uzx}eMr8LiM-1viAZ#~W9@kXPOV~+XJ
z{?CWv{ij`U%k6i6a>Fsdt=c0CyQ<0lfGcR0nu|U+lL~~GI3^*&T?pR;%UfB@&-cWD
zg+$u1n4Y_{l-_#&X+M7W{&S2n@*CIL=idFZyUxMvpis}Bao)X;JamqcHl3D!?zy+$
zamRVADXePFKKrK+Kl~fm*}!XZf8Twt`K!PB@fBB`@|xG&_voW<1eJ@JH7vawZ+zvt
zb?fjgJpJ@ro_zAn?8GbNKk>Fw33pA`ndg1~!AJgf;OJjloUTTC$J#EpjgcnCzDz!w
z$w1LHMd|?jK26lrP^}p?p!g~H{4sP6)>P^6^p540;hF$I1DLLgM(PGvy(yH5~HpyS|%Wy~6$n3&*CAhvG3_12Gm^rJwA
zcfVa_CPTcF*v*#@#bV%D)zrLFGliW$Y1N-LN}H?Yne`hc2w`Pu?$O~PpJim1<`aX1
zwOkHbLnQ+P1G7&*GkDadM}GFy(MR{VJf6k5Ic&seSFPRf_63zA5OR+!P0uIdPTU7V
zzW8D~ABcu4SdhhIJ7*oQJpC%ACaP_h*O_3mhURw60LOAc%xCx<1(*zxS2Y8*j5`Vi
z?r@;r`P472Nrq&^*KU>)8iw;h}_hd>Le++k3L@h8GQ6w2+hKydqS?y?O
zaFCzmtoAmS+I9O+zIyzoSb1@4*bAr&iU{2kh|SE;MiQZ#W%xqQ?9x(?JLc}-3K>Yx
z&a!FIrR;FobQ)5Q(94@jSr`b|FpF9uvGxAP)@>N$+x`0g>A~UQ{qtv@-VsfV)!VVA
zIasXq9C`kgcncQ_onWj7TOKq%NL=V}{6K*(?}B#WGwSebHKXMAA|PxbL8>e^@4oXN
zul$`4q~dBQrZzt%{OA|{;^enpart#$|JEn}^r2Wp_4cY~o{?2{%{3Ri?eZ(Wb=}`x
zb=6(SJ@?DM?qeUjBOH5n{_8Hk{POGM`CFg+yySoLy02dKiJ##K($}M&-Yin5FaE`;
zm;Kh;zxj>pKK`+Xki$y;Ga}gf;x%VncKPMJ_tT$#sMSy(|MY6W}bNOYzd)?Qs|LDhVmU`RN
zDV0=z@SY3)*JU5M{(HB)^M8NJ0%q{ANlZef;>$Q0hs}VjP?6P@WXR!D>ojXqrNTqW
z{_^6MA9=K?+}smG$)G!u-2KpGDo)THpYHb+O4(>ncy@Yj@Q8`o2X`iunh588KCCpn
z$z*;y9osNA`|#vG`I*^t^2jw?9^H{jfY9THnaCFl$wYE`W?}fqbz2_XO1@Kf`8?ig
zy@m)Bz4hSuV0rhf7;{-FG(K!DEHF)h>-7)xm#61nWPYX92#VQ&UrfKwHhKOBfEA3_g;C$>4xEqtuQu|7&mhVc({8?p%6`9Xv3e
zD(y-m6faE|gSyC9Tz!4zUDL}0I^3V#F`r2KMeJ{y>B&s$s4(J0#MZ3DgwpM2n~u)A2xO&P^<&(LTkT@1$J)kd{u))(`+
zqmDmf>B((91ARs&gE$3iL`FZ8X$>B~rn+-yAeqd~rlV267LOMuXQ*ssbf`8r2j{e>
z|0laPm7(DSbhA-*MXcG8yfBziJk00;Wkkb)Z)4
zHxw&Mo^R9&d3ya>`M`1oo7uEG8UMr|ec*5Y=0-reb}u|*qjbThwy^r7e6T+4QpEXQ
z>e;M6t3G?)%QVIVrVPjYi#m-YezXN%G^WVO9$nhqL1E
zLsKSlmUiB9l8^qno>iVY*25S?TX{_jj2PLrx7TS2|9ZG2=oNl#fBxrxPK97KAXXel
zp<497;ZnszT920{8T)o8?sNIYV!YR_oZGV7f4De(p6ls7p)4iaXPh{vcp9ow-?u*H_7+^>nIuv^<#&t&ktjO{L@g5uR_%&7gY7WhPb^5){Yyl2HV{6Q3+Z71D3UT~tHOx{CLi}R$&1${c
z#PHKQYbmh^!JI98=rXbAz&jtY!cjqtsxO3
zO^h=*yizsdki6$T??F*Q=u}oUyv4}K2#0K*2fn2R)!RqVYhQV$2nvQX7*Mf@H8Urc`-A;_-30KR02}L$n7Vx%
z2f=X4p%QvE*EBNjL_CI>f@3hiz?Byar(b#EvB_L9kUYC@{hxN~>m1$@OM*yc*a@{SDD=8wgzqo;q`KlJ%`m4li_`z_XT$5tNGgK31|PMT3VyRYnxT&j;l;{
zE*SO-9GoTA8Q5>KeP~VuimpmAiVx=0&R>kIZT@a{-Orch4`jaWM
zVYr5SR4ubOpY0v$Q`t>SJf9B@B^4@xLK7nmH+vy&C?20#$h*LE
z(4FO(oZbK7J^kNaF(3C=;97mX;iWl*7w75Ym#Ws73LF7;1b*lC7KzUc9w>y-gUPV7
zz5Gvq`6(WLMajMH!DpSPACpFziYOi
zX`pMBd?^?UoAv$k%eZnhYaKf-ikg|69~kV@+>TPN6pn|RwI=?e%*2_=Sy>2@Uk=AZ
zZTwsWbH$pUoa`SM5LeY)4p-H7&CXZK&hN+Er;^VG6XD4n+u!<@%g#Ul{Lg>kuOEKs
z-lLB@Aw9p4>KkmWPr5nkxlj;dZ_0q#r@7-|DT5EdO?!JLB-RZ(+BZ^Z=
ztq_cWRLpLTnY`O2F<5QvmBWe2fa`^;fVX%VCxg*BJd^X2pZw(N)eIvo&GNc*y;GQ6
zJ9haeK62vX^n-%~9&m4oNact+o6qEolIiXZxTAs6bj9neVeaMW@hxmk7iucf?{z0U
zbF+q5uVW|bP3@cSbJg%O&|`u8=7n0R6X^B(BHqGu)en|=OS$~6!tP?VXoma4!I-C0
zu4+~T>`l$*SlnG|v`l|Q^YjNRnPR=slHK7&=QnEY0L~PeySSreVJ#k1!9=pK&@Pn&
z(Xlf;`e-4CJ3urV^Am^}o(2arM7ttpJ!}&43D^i6NvKg*2mf(9-EhMV>({U6Tf`f1
z7<|j}?(!L{Sa;4N&*~c-IqXzHLoxg4&#+na>aF%-DbX)B`0V|`n7^FIyRQ)%4m-4F
zF4ruj%fT2sRHv|5@sB5_C+qQk=iHXe(1{7Wm1+&bskRGCs%N+#!HI}O{8f~tVr=$QQGdu
zANu-WpBW(9Mn`5B^G(y+Ji`{#Q@s#V2vu-!YZgHKSH&sUAM+iy98
zD?DGQRsBg{t?up}y-*n`<%-iq4s;)0>}1)#*=fMZkov-8C`VZ;+(u2OB4AcJW_Lbz
zLw}+?zk5e~9RH_$HPZ@Ac$9ABX3F(K*5Ah*#;vBZn6naV6pZ6x)2>uk$jA5r(-E`W2u)0E
ze{wpx>0G7vPH$U`B>IG-pl?N(gK;fdGkYe`01<5fZA!pJXU#AH0)z2lDV3{vk0;cs
z#T{67#(PYcH(PZF!l6R3?DlJf$Llz)Xex$O1iz0UMvkR|E8yBMKa?-!oqnfb!o*k+
zL{Pd_suzRNK(3s1Nq(JjA_*9&4*B6|q)@22y#5B{2{*Q63^&wrr2z+nHK)rLY~X3C
zIU}&Zy1QJhhhj0@bZ@`=?(4tzPv8BgAAJ7vU%*V}obxY?#1lDrJ^(5QBr}qXV31xa
zTfvwwNBKU#(Zu}H)h)kdm%r!veey%OQr;Dyo;7K2GE6y=nE|_QKz=$|i@HsAH->J?n@L
z&P{)9X>qzQ6;zFSV|UvD%U*7{6DqJNW-Vq_F%tnL5=-%jGFTNoYWOIBZlPl2YM}@u
zQul>4vs}WpjQs3U#VC|R0NH7}Kj>1$N-XN`S>I>O6;zIs8s(r}_I64}bRwA;!5F^S
zOqZN7aO*m4f`$a+!2U;KxWy~0YLvvLo{-1N5e{&Wh(tk4_F0v-_(qq2{Nf(TQ<
z6hH%9759{wpM$I;6bkx0u}}!CQ@AVmU>z$Qw!6%)a@}Z@%~5dw1{NP0TaaGh78R4{;Ui
z3OtzNt5JvNl*t>qA9CewIPv>Apo1n*uH^9QfL((x73DzF*;uNEV*Uzj0Cqg>PAn#}
z42Fqu3xQvs&-M)9nc5y0cI79tY~KEufH6agRUy-upO0)%J}fHAO$TAP{Z71DOY>9f
zKzkOv2G^RkgF;;eLz6%};`U%0WKbcUX^T^eY=hiUniz$;jz8)ZxrI!b?blLz(2J!X
z1e$RVCsZ)PJZb<7qlbLBUvehK`UMenBrGxAJwA^8NFKE8T#XkcCSpcYRV$5dIXv$G
zuAOp{4wgWpTpI3A$USSSr|=!?eO?Q)Lg6HWM|ad%^8
zZf1KiH5}<%-%~DD3Ck5pxLG(>rP;FdaNOw&E6}bOqDaz-RIgnxwD8x6`B`WzH~1hG
zRi&b8E$!?bV8MWkI
zJX0_fs2B|x^Pk`U-~|_59F8QeeBb-N@%3+d{k|#@n%yp^+u`v$DW_D!6EbNl!i9p
zw^DCZv9G|x39D733A0D=HY*Tv!F&_jwkhZWj(D&q5$&U&bLBd5f2e@%w$1nmb1fen
zx4R$MKN&ZBypTa6gz8Sd)x7$=zIVR!J$R8N;t7m_xxpRSuH`Dc-EJLAa?b~j@HwBZ
zevQ6*IX$}vR@WwjPKVT)<$}wr6}SGQ({a6JJm6=cBcKyNew)~F6;wePAQMC9fY<2M
zfjR_5B4FWw-j|u&o$QM>tdgl2wMHk^qtKcsdsI8?Yg8?t7v;9Elx_rrVXZe(pWW^Y
zxj{2x_Xqcvvm>AcTGTPK#TXhQAfdZ$3SdLaEVZpxAkkkXvQ9EqPA?+#kHqzk5h9{@
zwQM?^hJQp^*(I&vZdRM_@swIfL$iD%J!+}bHY?8FdNU1CJSm^e#@5c4^R
z-Ci$L%nbx5Znc_6@Ein=%ks2ElHUX;gCLbIcdOOZje;w*`v~tzPuxGOwG5CQGzZcb
zyM^}7$zUV(cYu!R40OzvQ8SRl&`6{L$gY8IbS9J4nG7Ze?o=W_osGoU;+$;)a5XF!
z>Itv2T9GLeP6^l}LhDm#f7MB`+y`Pzo
zug>7^TFJ88^-yWzh~qD67){)I*+;7eQMF>K8Ojc1p*D3!orPN4@}9csn0x1e%+Wk@V#fVez&;87&dJ$^>9sqsdy2NHJgl6}
zJu&d`pG0_JZxI$ywitfP)$VNmgW2avnMenHwFm1zFVFt%f96VoHU~$osM7LP>H%}6
zsxG`$dpr3}1h7Gpbuua&F)q8toUjfYkA@Pe(
z_KaH|R!WmrFSkW_i*8TYZ{c2&u=Tc;R`<`u#mivf7rlf^S7+z$=g@l$csU<#zmIIcCFs4G~Rl8xrcfj9scEeHL
z?}j2{KB1BmDm$ZQch~(#odA(j5syoEXz@^f`xY0rZg2|yG1wZ!gGRHe4a63A8$-te
z_G^Jk$ntV}ye_Tn^{DLBoYihxrD7-?5wsA0qzmZu
z)1UtIgCG1L`VspVFUbWm$9i6dP?gRkNi+)gzx>;|j(_>Q9jOu-fLJ1SX|SN7h^+uq+5swJwXSNixqAYt*m~yS
zw>evQ5V2d@LJtTL^nnj;VlIVzi;DntMG7S&6bb2rG3pI5$Hss_73IlHU;sl!wYW7K
zOAtU^t21NjLdzt2htnO1;3cC9G_%1e$_Ug1
zXrQe&tPIUjmDYXtUpO=zFYKD}`U7*@>v|}hI%3GEw(Bi1a8ap|bVlXp7L8h^mTg2f
z^yzq(b~=ec50)RnSjaR=m29@vM4pd*6|(985lm2;)Y5sY+DIOGtcljauvjLslv2a7XuJV9w+4DTF^xm^SF8j~!_1XE$b&!{KU(MBiDcgX@
zjpk9rpE#N^b6I8h(0=o}Z$!h9HRBTjpa1w*99OSZe)G+j0Dxh(8axvY1#Ia6#hPuv
zy#N#KHsRo}!jnC_hW~kQlO!sHwXA)$ZPkcQ)L+`N
zLh5oDa^8^X_j1~=2bgfHo6zpZqv7^qZgl*zncb)7m$tfft-f^@{G|O80Ld;3RjJ;t
zS1?i18g&4G+%AK|Yqea8j;!f%I=5~u4pda4S4EuO`lAoHyzNeY0U4>kx((?m(p;uO
ztDFbo3#c2yCbt(C-~d#~%w|;ofC6NxRm%CGp)QpmA0{Y`rd2S6aEFWGNa0$<>A>SE
zfWs8&Q42fGzR{|G2pc-0gSP<11B(5GPgilJ!Mk0~;~2RCM(phJs{595=>7)7V|;v^SA%sy
z>Z&s_v%u2xEpK@XmHFD&zD6cS7-M5&1Z|-(
zNUD6H5CSET+u5ng$b5C5YF5AnIn$uZ8XhdshPWD=lTt-2Ur8GHknn63(dNd=q|>*85&gW
zoCLEC+MWjX(O)kKXmJcfrti
z-L*dVxzGLCpZytOeV_wOY3Kk?;u6enyVA|Ws=+qrArqK07@I2099#qwtvlOjBywAa
z!->z1NOFY3z`L-DIHWuASL3QQqhT&oYP);^Y;S!EOnryX>25iIQWy3>(u=s#3ZzLC
zMQf!TVVh_#clJ$}>5?pYi!3=i+y49I%bp%sVLROO)uH*H{Su%HV7<3(`BvKm$WE0@
z76uk8mJS|a)Sq-VJwXB#`H_P$XgGrqI<4S$Cce9!$pfl?l>v$YJII|)u
zuYy%g%w`<5VhA2w+`Q0clr4Vc`BG?Hg9LYg>xRT|}z49(J
zJn&nhC1%G{YGin%T&b5z<$wRlEnVUQN$OG}zGWlXd(WS%lmJSC!+-)3;f(E&w;;^G
z2xHBfHCSDI^{Zb6NrDGvW@aFEUD~%wHF;shLa&ELN1?^l>FH*(ljxU_QQ2J8LHG(6
zroOJBY;Ik
zOD$}!#@4Q@70dOqaDmuR077Y^5D=aC0Ta7Ou~r=F9TE!*zaLc;t^szKRzz7ar1lRf
zKn{IAzptlnVEy#gOh-j=rf4Btn22jWJOWHlNF_J*VzZIW8^x+IzgX=*b`0GghPJ3u
zT)LNuUBW8BYXiR!3p)vMF2*3#myn?ym5c?GBfUN<(8kn*C>wsuY)?;@1TqBnFdjqo
zvSQ7DwK7@4Eb4CR1_ex|Qup6~{{s&^0H6gci>V7&@!=1Dn08@W%`^PTJwJg0@NM_7
zaagrl_EC{s$Q6ka@#z>=*k=rYm+G5Za2|gg)k}afWh~&f8gK*1{5GsG`X5L0
zFE09U;E4VJY7DIal|X90i;VQ)=hk65;o^wiTZR2T#LKCirZYe20Ig39q-u33y@bi=m%sewzxa#4
zfC(c(P`baNm!L8${C*X(o_XdOoK(lh$JuG%Gp@h>dMq%YdSCqF7g44FZv}`dFc^nt
zAb<-l_{rUOZil!)oe={S)78epLhqm(hzMmZZGLELr3RyF2im6V+UlwMwuO&glb+jN
zZRd_WB}$OqU>K+ak3;9w6ZMCNW)?~ooBaAdct;WMZ{Oke5X4uUXeJV;Ak9WWE=1=*
zsnupI)gZXOJ70_#Q
zpgyXBwb72tU7Ew7A>#50tJ^;@u(W*=9YU#M)=F>#-dHN;_c-g-R*OJDWpnf9&1<8_
zC3<3P|KiL^l&=GeoiJ5SX9^3`*b})gz4Vc}>6|kdYPZZ*zU=oYU;ogK`yU$}AARbn
zys=}x2j1B~AXbPl7A_F^9qk3fHxU9rp|#X$8kl$}vnmXF4c0tw8xX)n)l@NU3>`UO
z?wmrJ1fzy#hij!E!O%s!-)NWx;`k_UL>0EzG`G%9K|c@pUWt|fncr%Q@eVYGhc=%U
zb)^xkZk8BikR^8X(MNZA4xniG7A}9&rcIy!{O5T!0!1F9?OmS!u-hd8P79SOiYKHUt7?04Xs70XZ)vN}WY8Sp&@IcKNTBjB
zmkH}p_Y*&G#nkZ>m$Vzcr--3u;)DTpV^)hPrGDDjWU1`yA3kMqPTO>JuhNHhJTaHt
zc(U0F6pD_kt|H!ozgqI82F5Gsh`mE^c)itb4Oc6%_q+!c_R!px!cxXxE@P+<)05iz
zFmzu0JG>rmt>!Q7E-!7(q-UE@d*8qj9V<1nv(|1$t3~fczg|$DwK(W4;ne9IpPJUV
zFXWnjVk@~)gX3oy1$Qj2jJdi$2dGsx
zWFu#%+{=f-VbDwe4f{G8;*A?OLdcMrgR%wm#hrKFdG*y-Bg;jkK^?IAgb4B&)#JKi
zqh7+yfBeT2&UpQaxX2T*$_4CpL`R+h?ZaiG*=l|1OWY0B@~-$WF(d(WaBe#L+!KZ#
zB)mx==`aeYS~}@Pf5#fr-2IgX-l3s4T)NxoPwcv5p;A(9OY0dPD`O!E^{}j+OLs=1
z;mKXQu)aJHp8>!#qt;TbH6v@>Fq^sDz4yKi_ai(x?RnhoD%ccC^tC&o`|jQL?%#dz
z;@3TW%9#)T)!$^Qb){{<_zxaQ|q}z!0X))ocl=
zgF6s_7lnI|B>aG}ZZAC2tecez7RMrbK@+p`&~%W-8GXrU-%!fREdBJ>a}xLHlJwK1@(8~4ymCEgM3Eia)GXWoe&pr2i>|-Beagq2F
zu7V{7PtUiHKKdx)jqby=5{(J>T^{8yYP1OQgj0r*U9J@yEr!n>K5jW*Nh}}4ReMad
zIpKGRS0|6J(g&gSAOG>6Qkhbb;7~+_1CB)0(9}=f_+qaJYs8Y3$OCqx;3R0KtqGE%
z?T>T>$`od^;L(uxa@wZ{R-MVfE8QQBn)&=h|LcKF!RXiN(HFNKVAE>*UC#Bl-NwKU
z%Ap67PZQNhuWI$(v-#J(o?}&WUE4ZxVJ<$qSzB}D8<)1XT)~k*bmFOJu=Cp(h-_$@
z;Vi+HJpF}=a&3BJu8`QWP323@MBk>q!86^yBfX(fJvJT%QL!@^7=0xmpP`{++OAll
ze?w~Y*jls4%16_=NH}q{e*6Vf3kK4_M<1S#^&OMyKf2ZF8yP>%rG~Cs!
zr`b%n@t2MJFzC!>2mrw{TOqMki#cnv`Oi1paK#l@U{iU@>8JnZn=kEJV?dAC%pfbA
zK@n{1r8O%QbcnK0H_Xq^Ga^trOgq=EUHk2Ce;crHXrDbyIyX={9^)Lw^$@-GkQF1x
z#HA&AwPz#&BTy)?mt%?mC$5msisRd`JI`Eo7
z@A2!7{_Rq3sA(or{YT8F!7HKw9~zb5P@m;+Rr5trLwIz!z~byI1ZCuxVw-~Vh7~RT
zfO*sdB-frf1i5j
zv6DW1b@=nwsC#aDux|Rjp|SK-BeC(E-LsY_IFK#+m20S4k7f!)x9`c90z0OfwW3=O
zt58A}p2=8cf6w4hFxp>!I&G<;1}m$RtXJ9qeAVmWVDCmPtcvrfLt7Gj&Euh;&3Sk$
zBABCY`IS#BXP5@o4r`g!O+RCeLC%?Ho+Gxyvuq};=c
z99|uPWP*>x!m&kqT^mxWXq$an9nI=s6GzlRKBz4{SYPAaDx31EeJqFhFE{=lYSV02
z-B|r&uy3}3LljG4Ui#v$_y)4bFiN61?GBLyfZteVEtYvEn~AZli*1>Xuo|nrr5;{W
z;vj0X>OI0HYSwD5L}JU9@33-^;}V6i_W)!B;-2VR$HEFGhBSg`
z><$j@oT;39;m>}2+cTHGZP!u9{P2Otw#;YJdN687k?38_H@@_>$NuB4!p_-wez)_d
zPhIl&5<}Nk~w#9iBQo@!=4nzm)LywVGEaVVoLdy_ffMWwD;A4+H21Vo5l#eL}
zRYJVM4cdAh17-XWzV}cSg_AAv6*wV;W3>znfh#o9kNGG5pKfm)q65}jFp`>^n)dl4
zK5w#ZhL1h^$4+M|97^7C`|KHK-Tlh-|KCLy|M-zdw&jY(Z@lRN4rr&Iu`Lks*Rusc
z2>iit6+qZDgVTtNj1~!YkF{Hi$gT%$0U`vWZFK#CaiL=nVHrDOEVt(;@>>o=@EZEm
zZnf#C6LCRUvu4w&r=4;4J!->=$Inb=+wJ7#mp^&J2~VDL?gL9{E0OI!FUSH8A;h9Nj%{ea`3Puu6gM3
z`9J+c=HfThKlIUE+n&rSZw!P9Z1s@GOmAI;rE|ev;0oJnQH|$R`d9D|77n8?U5(vV
zrNaF!x7-4X9jgqkj`fa4vI}`fxBuSn{oX(P!#{}i5Bs&vWOQX1-Jc&mtrvqw*+$_r
zI01?+B#B8a^V8fBh%_
z_w);YLw)f}Q=@B7tTz4FhE5!%zI{WFH_`g=r_?7toBEHRz5e&#Km2FcsOW(Iu7}5w
zr`-SWW%ZipYu7#g&iARi9yt2-Z%}{rmpdEniYHjBw$z$+>c{`?D=ya7ZPaV|od+`f
zy#4ksUU>G|-~H})mzLzDd;IaopLOOLE<$mX%WM*m9yl;)iY@=gt^~DpgFi`}gt)?j
zK$y6BzWMwF3&d_Y6ax3aJ*r<`fqUw;*IxVeuYdjGi!bi-I%M({L=bcLuCSM%ba&0?
z``$zOJRN`;H=Y-GiLw1KhcxZfQ*Wh1=(uzTu7s)Yhr(D(Gss
zRHeA-k0+Qzi+=xx`X7Cy@1BQVdCvLaZ(jfZvv(fwdKBgUpSSn^zNfdG^a=rzKzx1a*~|h-roD}|2w-$L^#}=XaeN_
z&wfre^UluB&d$y}^UPCz&v+>d%AF|ZK?jkj*>H0W#`#!28MIyggpEIhGT|!l24^gh
zU_vpkAAR)EE3dp#XES*GHU+D!
zR%3OK#mhu_%*uThh#>NuN$c(;%vUoYax%YEk@=Y%XAaJJ6odyNA6ZWz+yIkIweY6+
znKw0svRP;Y!(7_g(+E}^5}ZlzUp{h?l5`ya>yFmGvL4C7s3Mh@`dK=mChbBId%#^C
zK3?4e2c5})uho|;NU+@M;f{*s8#oyg9mIwhOAp}g-#jUtS232a`x?B8McuM<3ve2}
zquc$>&YDGB@ZniCV{!J8Q=CEJ3b`!~XFMhDd-&;_{wS{d@$8namW^9qwz@=PTldN}
z>x@mMDt`Om&tbBqE}XGDXUybTxoi%FN?6c2?#iu-DiJ=G=0)zXOdS@vopoI=spxk$_D^185>i9jjsxjSJ(#tFT&YnGuTiA
z!W0pYg5Q;Ly$oTf?N@%SSa;cF$O0S>kz?AiIRSc(T7ZA46TYAj@SCA9;|VG2ttxfx
zYfVfa-csN34Q|XqM*K9?Qt43*CnM9@)T!ZQtO$UUkyhAoVuPScTqEePR6RnB%W6~E
zcFfVo-M@ZA=g2@G61SG7fYs`bB`e3BG`4QznbCOpq$N*1_C#Y_a})LuZ(FkZk;hw#
zIqSR5=soRJv2v~W%}otQES|b{#r6x%9$)(Smz&$o)8~EX@#W1^CeNJO`UHrL#H5fE
zzb2MF`F@8zaO&HB@t1o#n>!39OJVKm@r|o2OCPFk-ztrTpI$pVp6oqyNq+6~7XyMY
zfBw%Nd18v&>2fPGjz0SK$DX!@gP~(*4X;}HHiKhTv6NFv!s8}%WYuV>8dc5+;3dcy
z=um~)tZ?|t$-=Cg@4V;R*Zn93?y)dG@bH6Yo^iTv!NLB9tus3t$SX?)`~*3$We^(H
zDTt1g+Lu8!b?OP@aBe!QM3k_i!N2qQ`_6A`8Ym}AU2Q&)uySK50#c+iIU;v>oS~y;#MixeK|y&^
zHN{G0W33cu2rfM0h=*2fXv-H8*|hTupN(zX0-GX!{NqSN`y`9Md*RWyZCpCZ<4V^p
za3p!4mYYDXR7Zt5m4P#ev%{JmtW+%XB3(ZcfhCxI
zf|KDhSAnq;KyPVduOd|=Fj|OxQKb_+*P2Ne9EGZ*v9IsB4|KMUWQUR-JW!2hwMINv
z^Qor|KKxjlLxwAKTkYW;!^tmwW5u_xY3S&ja_kY$KJd`lPT#1(Ts>jo#;2YjuWn3|^JWU$iG!R#a<4^mjI{Xo*m&qLy1!g4T|
zbynlN^UlMIp9$>H{vG~Hn(o3nb{^+M6)bo6c8-Z`lY4?y^jSS%iCAvh5uRNcRPgSvD3
zmPy^6(tx#EjK@a8&3K>bU&L4~l!s%fj*hALpO3^7;ZP%k)FKT;58@}&ckKF^A+-0<
zd-bh(KIm55a)D%Q?Z(OY6;lSB46F%XNAj$c2}r;;D4K0)3c0P3Y&0Lw*MbdgLC;t&
zRqWl->vagP!!y)7T*(B0BL`$@@}wEnV(-_#a`6qf-1wJ2jU!z+YX0$N(_QT?flV*3
zbYav{v94aemT|aa>t$o{7gVJh_RY>`P0`^LTxv&4_u$ZT;RgHlKNLqzum1Z7&NyN5
zS&L4(EFI5;0ufU^pN*#tzA}DWZcC_?E{~7x3I&D3<^+V4QDt>D5ru-egYv~>!Nw4-
zR`N`*I_A#($j08j&wb@9(~n&6p^tnF2!?B}xn{|dCD2hA3wjCZ0=GbA*wUem
zVFZ`-d`)GJ9)17vp;p`uUBhRD8gSEJuwcQ}S6_|uDuP)qQJ|}v5
zaeHm9y4hC3hZ0i+lQgLdc-!x~>-hd1`Frnq{F`5k-uQ=({=S{`vZpy%85^?t9qnx{
zqrE*hutV-jl!DVkNJ_JUxdUKdufI{D19Qf@#L3`ECW({L-W;x!iV&zh=D^4>Fwu~n
z_vfF#@sTG^PNkA9Ee)6b*QvMN^kls%zW^J)#~;7YpjJI@TQ(D`lrz0MH@CHmWFlIZ
zu()ZXq3Cb+*jrSQ$R&1G{1Kv*YB(8VNuxg?d1%HTGtMDJ@vlDcF3A^sJ|{SvQg96A
zEEGKe`OCef(s;z&_;Xv%IY;#L3{IV9z43;Zh-%>ti`E8_jAq(#wj~6N-Jj15xL`lb
zBI0lIIsL$%UH*k>jg8Hn?K4J3HfEDAn>-#odWHtKd76y*ERugBwiJ9p6o2Brd*(ST
z{#vTr>#@GP=@z%6)HNxfq>^ZDyu@VQi<5CcK%rm#@^9#G=9(^zfJ;C}dH?k2o1kkAR#N~>@G(wxy1}kR8&7<4D+L)+u`+O@j9{a!s3`Y>T7a{{P4e?
zZ!j4{3}(~TdMsu|kX$SSzc1>}&Y5hPcJVd_tBBw{plp*0S5@tt$pqf_d_(ti>KWqg
z45n(h4Nd-bjd_CAwOK@^v!kU{9kTgG<`SPksg
zVqg2}`&U0LUVdRbJrG9&zGKU>S>0hZFT&2|Bc>hwWenz5J?gVM9=~_h1?S#qsh1ml
zE&vCUL*q@}#^IjC<~8D-XPmlV?yM^={{rJu&DT8^=&|VN=o%h)@ysRSiHDwRTX5FO
z<*Uy;9T}Rn2vi1oxHPDX1tTN{b9o#NrN#9G$GUaDl`~3+6&-jFromuUfSV
z`2@s>m7Wy_(!;(7p#szg2>~RAWuUjW7dl0nGfIv9&F6{SNIfVQFf~Oai>er<08fMt
zauwrf6&Y4bABKFAbNX;;85LuNuf{)zx&-!Ex&6uz)etOZv)7r#?0V2
zQcQxTmGbV!2qqBVb1k-1PRd88jSn~tsvAkomd%5a;N-K;*!tu{n;l~If;mfudWpMU
z_qok8rityV*BFqiCevdh`LUiYEE874G+;V?RJGSHi`iaE_#Z&oC8hz@L4Saz|0I2kTybS#k^90eKlf(teiSQRM(
z2FQ(_fyCyQx+Zm8_t8n_|!@s8BDc0IMUbmhu`)flF4Q^Rmwg8
z^%>E>eMdGPU$yF<4}Iu2Q#xC^X12w)C;wl?$zVD&xtQQgy`4LE@)JVA8Lomk2$u{S
z3OpAD;6h;fAq#8<0LNo|p;~3ilRx2DdlNIgE=Md`Y;9=TzI|hmFs&l)wX|i1o|zVz
zA6v+rM~M0Z$t^!FjNQCs_FSXm>FmG_qIUnh#<>S1
ze|pm~pZd5c_WnAbyzSU&^M&mxQF}lX?&`435s6#-R$ram@{{TQIih&?=!WmBM}4h@1a>_GxE5c*otx5y<3yA9(hA*NMsP-C_H@la9apfk&qivHhHPYdd&93!?AwVzQVH@PKgS_sFmU-_^X&@U7v
z*k0g^v3&V*a;S=$VQ!GeLf3S;F54*%()(5a{zx<$uG>7L
zl&g#mh;z=~>2t8T64(FKa{Q8`#tOENd}tX?DL4K~INR9%5N9ix8XED3L?Yi3TyVQE
zp3u8uP=_tF6J9H5tAysGi`zDJPT#tLtG_$6>RHj)B$h5cb$DPGhHKYdJMiqY
z;%i?K|MtE~z|)lzqcysOW|{!eu;nU8x@Z2XQkWC3)&qWq`!hX-aC%Xc%UE4MZC3ODzakjia
z`=$8&<>GI51>5J$dGOE69=Kb)^r9d*%hILYa9YHmHM{JIp;T~+fAfyutW)k3wIieB
zBaznTI=Y=hSzW@UW40oe&<8vTxK-UhTwes3fXqZat)H2C6eA6v!A^ro3IomUuPpQC
zrX~26L5z$Q10I9lRjU?vTFfZKHl|`*Gs&K?*Jw3W>XmFBTpAOx3Z=b5p`7xvQ_~!3
z*pQHbzHx@2>0(;C>g=XVMWz<%S26i8N7fni^aB`gb|(uEwSaHkrWikB`N?
zJ~wF$ty0O%zUP}QPNK>*HnbWI<$4W3nE@~0(2x|1hY-%uxUso&(NPP&)0f?riyGXa
zDPyC_ND~n&4&o=%$Bcev2<<)I+=1~wKmFAM{eLd~%B!z@+gIlQL)uU)6ccWzy*8Sj
z*538fh9i~Adbi0k)+@bOU&~}v4fcZBrZ;s78j9_-|lNKCZi=~
z)Z=tiOO||E`j44gI(M#E+cl|WXsoaO$nehfvF_;(k!h(E0`-bhHN~B?bEBL39QJmz
zEoio+OOev7)Q36>m&938)Dh9S9S*L!t2K!|Yr)GG`kEyF@;-kplah
zf9tKcqVC1A{fl4xB9-i=dOVJ_{zM2IhxDP)%-s*jbN9EM6P3^4W|_%lU2dkX=-oLm
zxwBm^^QBd#*!K&WrBz5dG0G!SHBbg9if$w_Rzvf)Rl7Rd+kkupRx6PlGg?cL4o_@+
z08lY_HoFy*-R74!4b7ZB!&Fai+qJ8C`f(KTK5`?pk*2iCEc`MI=l%>
zzH0LZ+6MYZTN_(z#f;NTJV2rXs>!OQqFNfeySF_50v4TitGQe(Kq52gn71)3Durxx
z*kn|lF04WDgvC0wlC2-%j$C7JJqMc%DaKU@wS~l(0@5DnA8azf(6U&I`8wlU7*_YL
z{ZMPeE|ITVoZelVGn0;=D%8N{RWCHQwNdO+sdQ4Ssk%PcWIU-Rz@Chn;+=b}C
z%1ERp?CF;tyP>nmR3bdD7X?|&)8Mbf#;tC``2sPHXHCKF_2#o#S3^TF79+3_Udp_h
zq-OteKE4F-E7;D0`qMUhcCvS8ps9sWSMX*?Y{TIO&cW99vEH4eF{PzP_a`3@5^FLQ
zZwPy^OAfS#V|~$J*jcSRGI@KXec_HB^+3bI;H-CutY27KkPgE8>(ToT(kFZ6vb&eV
zAaRf$cR;E=$V>)7#Of80hmq@+2k*`%e(bhxCSsJd-qQXwcWV5t$*QC9t{IHu#d<@l
zBRX1a4vJ#b;<7i54h=L-?noyGu&D6_OrzuVmKKqX3XdmLjO87E%h+hPajv-@lOacf
zL0k=8g;MIcFIWh#ol2^-E*Gt}lSqJrj?!fFr
zs&z2~X)ftP4#<-<2Ghh3`V;ucOlC)5JeqB2Y#tjLZfR_Z4fTbmv_-cKL^>iv
zqfr}JAJPp0bGnMAdXVD;l@MX!IoqAKYAIhTDNc_O4-TVak$2{AbK_HN5qpvN?>5Xa
ziR;$HN>BS3XnbXm3oQ~2+L$NE8mciOz?YYgZU2hjzDddF&@EcSzWA=R+3GZ5I~NQR
zb*fZ0R4_78Fbu*8tIV#{Pzl?7-b8dKG0)5@;NOl)x#)1&bJ>i`?X!g23WI|Vs}fJ7
z!yVrAXwGS$V!($|+@HCv{o%(Z;
zn?c~uI-z1Trwl3kkpc|_FLav>hB
zH{l_4gKH$0Og$(7^O}jtC4O=hI&eVRb3iJQCi+zwMV*D+ti)^{ETDS&*8C~p8ZD>~<8E_~(3_Jo^k8~(yIPcCcR*?206|ppglw>rUReg;C2xWXc6N&&3
zhtGe_Vs=xh-C-;jO2iPB^VeoAv(dCz@EvnFti?jbVv=Y;R(lPkU~p*(=|il7BK>bM
z*06=P5n`rfVg0J$87?L3OauhdHb+BGU!ke}M3?_qWBa+H%%<62s2Us|_>6=2$qq9a
zuO7(^N?@`80(3jaW842|t39X|UjTfY@n>Oy<6Ed0F<1ajfyqFM3_KiUQIRq^$%shH
zO58l8A{)w1_+hA|gf@~?lmD@wmm~*cIvE&3(jN(yBEgPiO2Rp7hotL(Z0yOAVrE%^
zc95VEvT|9IFJcoqNLkXm{yj$hb%SrroYxpc+#hcPFh$)GdwU
ziNfYA)Mxq{-{)vKBbyF7eBdN9!Q}J<<`YFfckTPZe1LdS9!jJ$u<##b!kRFhm^^HW
zI0Ilz0yEDu&peX?NG4H>=;fhYx(S_Wix)cl!2kqNh;}mIrvu6B}0B(`rOD`$j2~X
zWnIa{aL(X~r*oJAJSbk{@fKY;3Q378K
zcfC3ZWCyEt%bsBXje>6wptEFZlaD%X$3VQOxa|0JI!!f#kF&p_O|oJM-~n1dxlqZP
zEk3hA2O~_-$iPdJ-3!;f;4xKjH3G1QZwy-^nG6nX#K1d}A%~)D5Tl!6!)TUxK6_u_
zRbxXdE#HMhp7FIX*$uq|9dAFqZ)Zj&%$XwuvS^|za%RzFlyOpI?Es@l%Qe^n#Y*RZ
zQsXoYm>t`u1m1T49b(4Z=JfUvA2KXTD^8$?ApA6gM$=~EY7z}uN*1W6ZkK06NuH56
z!c_BN2n;1}rQPxdIT^KzG=Ce)GmT}GEZG5k8^s~visa0a91pCtp`aSQmNd50wiBlx
z@yrr)=Y?zcmTT(YPF2eexbC;xVrR>?Ds?UVEQm0nFY)><{h(x9DQOQ0vlW
zYV|Y2X76z@o^_z=)P~G~s_eD(K!YGJk{c*{J(gm=3?~RJwM^BhF6A|EA1$ICKNJ(9
zQ>AW^XtdH%2)eIDz{7xm#k$ILWG^f8`I93T3WUHwl4d!awQ&ih)(i7<_a7{ZcKhFd
z%4JCZ12l$&hRUeb$y3;17>qfD+j@DEsG3E|tn&2wozK&@EdS-HuPy8tad0t^Az
z5{nisde^(&wRY`VHd0VD%5bB;_VXliU?X(+aBgIzl7?yE5{~xfw7y;g79;H55}klsmEFW
z%6#$qy?386wYxjrn_$}n2_rC=#baQ5L}58d^gqUo95#G7IdT|OGH#?o6uvqi)T~zE
zFktnJhMa{sd@A8IB*oK~NQ2Q#mr8_BgV8=zTxGP`lc@q%@%NWbCXxe|Lr<=r1{UBl
z9->9;PO?}dhkbT74uue;tTNEe~pp4sq)FzLwiX`XDA
zmgX%=ds+x9p&6qXai~DdYC(qSk;}ifrpV#WJTaCT
zg>v4Ca#7@xv0^UEO7A904x^G!Yh=
zYYh5Cw&-dQ#Y{dOPhy7;48KIe1>(ZvBytti<4$FE@lQs+EtE^OIzn^R;u4`ID;PQX
zu`$_5Nob(bc;V7Ee()GtufOc>R>-Eo45?P2c7roIhDWx|oOvxGLuLazzrkn{{`>Ip
zsvgh=#H;cS=uhG*vEbB_>F)M#HUwMjMk`v0`d01B$uGuNgjZmw@kd$)qGA7ai2kuN
zL;4~VF!Z%IV-bS9)-5K5(3xR|@c2L<)V8g`0n=M4lo~_+{iT~M>aYkb;qV0LZdu)7
zBUsMKgw^0GY1Vtxz+eCR*YT2tf%x0s{sw2D3p|cJ_E>VxJ@;JLh^h3xBPsdRQ%@l#fz`lE<)Vu&;_9qfvk(Py
zBa8?J^OWHrC<8U1c!tHnK^GQ;M)HV#KeY9jh|=sY>K3&Iiy%7|p(m(qMI}CxbXbk{
zmJl)s^jz%1!J(kcz7HM-8xuhO$u(8qPHC+Jj3ZHZ01|2;uxdag^GZ4&@jAiwfhT!Q
z`z3v{8*D@`L6ST^1nC3n(3(jV%X!+Y?t6RowTaY!t==56&idf8!I$S0*`wYo~$kj(Xcp;j(M|7y?9X`JqJrD?ZATrGE98kp`
zPd$?v@9)>8o)a}kAuUL__4G#TReU#ER!gFlq?t1
zu`FbX&8@sPV^;B>|Kk|`}oP6@h`c)_b(go5NUwrYmzx{1QZ9rxG
z$AA3C^y$;d{NWFOc*PZ0kO>@+ZVo~w3q(^co+{p{3GoqnQDhh&ON{mu2Hi8G(VkBM7`k)mXQb@`}qDsN`SqLD@q=}`-jRFC(-39YKW$pCLtZn&KRWgEd0~3y?D7a=HkbOOkDd%|_Mi7%FI8G>r!%-r;e3
z{5G=#X(yUEql%?8S}HS;%@Xe}pJG-Q>|O?#cF4vcQ{+$MFk}lQ>pj82hRJH?Uk!|5
zHh2y~M2K8bW0EE){r`2=K{otEmc_QSP%(P?Dm(5@4&U488xfXRIhMA;XK=6>Gjt$o
z@QnJ`d?ochvE?4+u$K
z{YBv?*hw(Sb$bYuBZw{#KOiSyjYnX>QrFeh^^>3c#@y?um8SSxDeOj
zv?$w%HDYxOGfY>NRrYo0!fT%j5n+=IU8~5DBElM%%41fynlqa$IQ_wj*_5kHUvm2L
zjXiM@4q|_5gw|oHfao6k0QTG5g>jxKUqM4rwK|Qy{;h@17OU`Wncg_};k$et_Ob~j
z%E38kLQE9{QO5`0TYNd1hJ&v=(C`eDMA;!G;iSd8&_LB(LBXR+i%Q8fWXDiFZ1Hqu
z=Qo^u+fD7$XE<|1TiqzfWw%iros+^FVk9MXO!US+cjtb;r9mK43AKwcq7B%NKJutF
zr8HNtT99OR=R8#9^)ogp#Y;d|Pnp*H6j!&I{>u2cs
z-s7!2A(*lU@!%UV+A4K6n0af2D0$UXu2?HpY^@#z*li=$?`Ev$D<-UQFe#VxO@3EN
zSFp7_1kdarE%}-y%N9{FSL=Y!@h9muE(&{=HQumRl%W)MVGg~MQJX9(gThl{NK0QMZ*1y4YEy#@-vf4~#K
zlEVkU<1>6QztBYvuq>pZi9CqA^pTBDLvbgYA^2=QMSC#)nqSo_B&RL1i>e7xyBFftOwtDKET
zC>)l-eqF9j!#~w`7q4v_ECKg3YF}q?pRE9T<36?Y8``s@n^r;Ig!L+t8uH
zqBaKnLA%jp&!qFYSUj7rB1$osUEb!&jjb(&rUJDOye7LfAkFCa46WU>T22*x@V)k(
zcIU8t49=M|FfcG>%FoGy7`k1Sg0w(6e7w2`_K1mIoqu3{ORM{0+!ZX>GTW!Le`5V}
zZ>yI~s>88!N20MA?X9%$lphENS>r}DHkGZVv{Z+AJmk)GQ@L)c!0^J)>f^Si7Ai`*
zS}!y<5<;z(7#j#S1R7dfWdEun&B}DY%8JIv>Eok0l2t7cd{BkxXzG`~f9lR>*;G;1>Pyuqk>bG)2xL&CeD&
zhh8~55>{5~fnU)pf#JY11Gxz19pwD!Pk+L1mZ!th@I+mqqu0ETX9WCmNJx>XX5PZa
z9F2vcNC=O-NR(3rgRdw9CWxWYghJ48v$YICVvDn{BS$Wx(u@tmP~^ALl8kSsm;n!0
zvPoN*{f^CQwiTi;Iol)6-F(%!V!-JJ$0C}AlmJ5qZkFclZi^cn419$$F|;dmw=0R%
zziPvH1zW~_ZO?v=`HIm}$a;zZmJX)v%^t7YN$4Dh!LLmyY~uD3&)xma3tEH4dTGF9
z9v6Yy=*xpmK}^_8b*HUFR7^_g{a`Tdwr`a^Baze(Qv2b+%5g%~&M=zWL5j#kGv0``
zDbfaIkgq`B!r@5UPyW*c?AnX%SrK->)Zzc$$R5DT7>Hnp-Hc6!8yN3we>SDtWU!Nb
z&7qq7L4T#D)GIX=*CfSh?w)#q?OM
zR`&Q2jQL8bdhd(9lNU^Ni{Zh30;gHbCYP$FOjaXC6}mtL5s1cBOR0Kzz)Mb;TAHeSKtF`b@I^jyGs90Hpi@*+<38Bn~F+;b#fQ^7T
zfGt4xfhdABLI^m3&wcK5ciwsDyWjopU;gr!x?Ke#3VuHJ*kc4sBZd=P3pK!bz)8Tk
zkOPVrIq(M@n2Qp80ZUJ;N4IU;hFs*6pZp|G;Vx`TufP6!P`{9iAj7!!+G`P|zyMK(
zg9I-Kh#`-o{Jy`eED2@N=nM-DQVqGU7A*6TKxAPwwH42Mrwx}1)$VloBfed|{a!~z
z+TQNt0q>#^G1Q{ggLO7f^%1_9LGhaE4u{hfO=fEu)#7Xk&pNu0tl9%1;_JbLNa2$-
zS>PF(MXw8t1hYLJ7tvFokzV`sy
zOQx_+XQbme5SXejHdMro#L}Sc*7UVE%`LIMj)ZS_RW2UsuzEYHiyh3=*;rsp^xe`b-1gP+6xc8`Y7=
zy3nsxSF4Ff)%t3gude1#8N0t78%omY$2lJY`NU0LS4;~IbjF#QBZtvW?@DeiPC|zelWukW1tyXzkWRe1E4&~
zM-xF%B@*z|oDoj&bx0s@;9l4c@?kh|ZDl^-PJ&$pSCLhafFa=apa1;l)J7(P3K$po
z45-P^e)coU^EmQ>BwxIEG0rA;-+ebf;b6$ew3Eq(wdvDOKh2AfzjWzR3`-eiNHzZW
z$3K#z=aZo3315~>-cf%FWhlvkTMD;EW5e`WRZYfAqhol^@&w*5TW@uVmzMtYr(Ztj
z6Q@soTUQX16SX|3rZ==9^zQ+f`-dOguH}tJUa(YI5!L)=nO}Yp^1}9b6)c9)vDkEb(?8O*X_dxx>|oSJ$}wy?57=4YQ+Ncrf4w6i>T
z*KAPWipyH9Vrcyh)4??=JtNDMm&>&NcIs*fB$G&0A5e>r%xNQHh?>o)nKCV^B+5~C
zk4jBz8yc`$f!5a9tku*!KqnROJfn`?t0o>_)W*B7
zsSG}#)?b)LKk!8QA^rFySQ}&dgt4lL-Rj&byFv=)4gK6Y{TCV^md?Tvk*m_TBekNGv;NYWj`G^+$>p=gmL5A7V4KbM_GOJE0uAiM)
zZ5>-?P&b`;Zkw17=HbePu@y9|z5juZ_!CE|n~te%Xv;h&O6x57XT!q}I@Qfx)wQAY
z(-!r`p!&R3eZf>;W8m$o>qT{)s6Fqitqzr+Hz%Go=Qd7LM?R<4wlk;rs1WvwBFWvs
zI~Xk-5OWR^JV>YWl48D9kH1?2zKZ$yUw`sOl+n+xR~Xe9J9@x>?69BJs@0{W`?pG5
zHjIpIZZrv?BMKYj9~&Hm&(h)tO#^5xW`N&7)+C?k?4*G~P(`hff2-#koRT%i)Eagc
zOFEcf+7EAw6Du@DD*oj=kqw-kNff0BP#RHBAWwn-vCPx4eSLixG>|~=0C|FY(0`J1
z-+lM7m!6>8#e&XN3U3zWUOtAKIFLs@nVvykABk~h@149-*
zV{ayE4hmySp^HyYi@=mnVMj*?W%j}$1L%t%3QRpuL@5K$0sld5=uHr8@RNG5`M@%R
zyO%9$7xu5hFmSvJG3K~EbQD~c;<->&piHYU(d!VZB|n)_u=<`
zXy()fANlm>AGm$#apz2$5!6gTL&(vk
z6vtwYhIYA8Vk45<<@6E@6xTRoet6V{EsK=dx-xN#jo^2DD2A~#NJD~=l^T;8E_RwQ
zgL`XnqGuA?*XOp!1~ZXHcwfgR-L#~0XOmGp_rbvAjE%m{@1uOVT5%D~G8({cf$RHe@%+glGs!k?_kKU!FOyTPQ^=HS)=n
ztFcA;3ZleJW=x)dbZj+<)cBykg%}WW)D{y-2d*i4{>Z4mx#?fcXWEZ!F*oxphJ!nm
zv^qQ?4dGU^1*h?{{m3@*iUHL*4g)5Orkr}!;5meTGS`@8Ob6x#b6jWZNgpDwU`(Zn
zb>PCF4mwdu5n4SeD);nnyfI`Oc&*{5ROi(yiqiCNr;R@L=y^8Ru*J@PsgR16-gDmI
z9e-IBd82jytAj`HID^@aW*c&X9Ko
zdyl$dykp_~El<1{3^XBo_4z{itQv{T*uFJ>;Rl~xx3et~&7X2~^3(qrvALqBzOA!k
zsyUa+{pF@H;!@psvsknKy#CS0fcvx=W_p{Zytv|_X)}XWb*HzzGr!YPEGV8pu~be2
zBHFcJzB05K=l0hceio~7_l()wp6`9n_ooI?F(-s6rBnulr%5m*8md$mw?439LAb8YtA_13?>`;3*8MBg$Nu5<>4(@n@K>$^o1V|11^E}
zn@m^){VMiK&^72CmFQ`nvVHq@NFFu76ChNe0K5eSIKwXJ1{p94sA=G!VRw*lz*vyr
z%t8I6kwZW_b@qiDb?S-bDUIQA`b$yrwFhXvNO+OkZoBQXmwo=I1t)fQ&s((k
zl#4I<#BF!}#T#~C`;-6fAKkuXV8f>Vi;r6O002M$NklTF%IIhHfEo~v0PR+nniAn}YooQa
zoafrZ4XJ94=hlp7Uu*lno-YgzbK`uGXRnG#C*t#m3Pp)q3jZbzGGv?e0|pE34tOpJ
zJbL(e6MJAkaWX_G+z=fdYi$)j{_$P)x@~kcWwV1B6ngNXQ+{
zU3BgfTeoLByBGCrO&>XL{mK>nZ$BftXkicf(8b3+8yf{8u)R`j`R}X7&wrPA=YnM@4i~yg92vR(}RVgfyw=jb3gEhKQU;m)rw73Jh$F1PC0Ec
zT>J2Np<~8^Z95aEpS@!7Q8!<5>G-X8Y%$s$J2q}#e8T4KJ93MT@B8?rsrE@ntb6PQ
ziODh1aTq6KqF$LeZ{ihh;iH{;%frdt+l!D={%`UZdU97fska4saz3
ziWrY(Og?*^5Pc5&P&8(D`-~UCiejq?AMWRrdeut_t0n)nl-zhK7$W5M!_%z)*YG|Mo)sX$zy?|^%N^I%2iV7*7{
z!6E?{LYf;{(K+B4xXNNrC44S;7RLd>!N#tNp%1@manQ$EOjy#u3M1!Lq
z>ip?Xf7;a0eC>CxTlVDg(V>wSpL_B4+itn?>i;_H>?1;r*5UDfjLaW<@Na*(UrWBvTEIt>j~lkxH<{
z8p^C-1~HUmD~;PKaY@awWQrkLMfVF{S$x3bB(jo(s^ll@9F}Qv{l*?m|EO53nat&C
z5jZY<+5d8;r%J;knsHdLSCJ5NE~Zp(SfJZ8qCnW;@8owiRpE
z_70AG`I}b|srT-OAL;2GpoQQ0?)N9pnsdtA&IF-@x9A%i=PvRyC4jz=Xn>xJcDW%o
zR`T$LH6fIgnCOc%>#@!W$<5Q!!k-3HA6c~4C#g4gSH2iyVRrm
z?3mABC_0u%(^`V}P;w}qp#30zqbVOH9NoX1Ph8AwoFK5iYTXNWGZM|aJd!WfBz&}a
z&mk>xwRh9IeNXn`|KIo?*e{$67{g>VHo3d=Ti@z>C0}ussENgytHxCi+Hzs
zgUxO2^RK)rdh{Z3-=o3LereJJ4~`Ooq`h-C!*J{N^X@t~b!aYy+7d
z;M+n)O(oTrUK(WC2{%W4sQHYJ;r{q#UlhN(VdgD=I^(Nf?fO4I6s1~q^6VLQhxqMp
z2k*YW-nrT9#zQ3HsKbl^(qVY5X;?
zsl4&V8!x-;GJe7_z;-a$SK=
zC210MPI%CM8bjMq04-g*^t97X16TAL-}uJDqmCg^Ei#~LJ&U@NuA_D6f}0!Kl8OAe
z=l05Q`Wa
z0oSU+A9AA3vpCUr)I))$RJmd?dXO;r11@-OdciPeFf*hX*bHL^vrEbx#F4Y-K*P$Vs@-H>`OL}_
zk2}$AcmMlE|4w>zaP;USj;76b-|^Q{u5|H7KW;Z$o5D@>Aa1+7NWkp@r(d?hX{^+9
zC=-AJ8c!gC(4xiiRH8`8%bc(bl9v3^TCQ9KKGkZlguD%DfYRaj-Hn-iJrHQg7GW7(
zrAjr@7|iA>HYuC}9K=U|IxTVnHig3U9%%!%Ghsn;xrGa_)hW+}&GEP$yLR@@JErq*
ze_Qm6pLI{_5>GxQuDC`lTk%9sPw%#Ev32Xjhd(>d-{`3uoPWGc!j|KJ%Dj5dh5y#r
z);zXrC+TFem@5?7c0TvK*syv-OI!DXg^O;zP0Tv(G@HEv_T{|yb(>tdU*B*k5%&zn
z@aRaEU}o{`(1jlmcir7%wYJ}JN9pWyfcvjyieg|a8flsI#51S(8-u~7hS^7+1Q9GM
zrM`h(>Ad*j2$_d{qGa6&QLm1_|+icZ*C6}+d9TST^CamHA
zpUl@K`Uj*7wAwM)HQ=^sH=)3`G`CGboLed3AuTTwj5Jp)OD(KH6o8EbQeGi6D)tMt
zO0HmMvk#0)GKZBho3FQiK7w~mt8J@QECqInxH~EiVzd%r7$-n|JEn0M^hwP`?&~9d
zGJ^GeKM6Vt=!*}3_`_%rK-NNI!bYF*jUgwR2o`k)I_ozJJiG$s5gX{A57h?CJc~C~
zVO^mMA<&E^aa&PK4XDy6cWKuAX6U?Zc7v4K&n6TEh7
zC10_j%}@nbIY);^*yKwO4D2M}H3;5TmZ*i&6AccGAg##fC9pB(3eploA5U|^G$v6-axB>_`-B#j&*
zaosiF`P`+St{2On{?AX`^qb!%$D)(lJ85%bEb+|JCs!|j_PT4nXM~H%mHkdP<@}G?cU4zDF7y=%DxtuQ-@&M5Q^It=U#0?Uc
z0wWWMyHY}NO{1_CRfstW(5h@LkE<1AYt=G1p#Yu{VC4YhmylKN!6_+}(a9*4dWJ49
z5@AI@^uFaR?UtB82bW&$e(2%#?C;|Wv}YW9te?*I|p?oda^d(frx@mr^K7%erI+l(CI
z{TDrcU9QeK(pDb##}66x0?N4qTz}0{y`Ghv61uE&$pR@gR!QPd56{M0qRyU#`>df
zPY}79B-Wbf4QwgNVW2-spAA0}0FFNV8b9|u)+a85DxmC
z_Iv+w+x6Fd@42U+tmm`b$QyMv;ex`xt(M39Q{+;GeoTo8Z)PFn8i2|0P;x_vwWzj2
zLv*n;!Aw;(*o`)j{;T=A)o9A4>09A;T2qOP*Xc%LCZHztxr2dub3c)ZqVZUAZk2ABgTQCd*5_t4v~cRHMq47@4x4D(YBC87ACGs<6}M&if)VPToN83l(*Id++L4T5Q<#k!36AtXebg
zFMm6F%JdG>x+!Cn2A={Omf
zNJ*TG!^dlS;GoY~r^CqtmrvypC^`JDLb~Yk%eAJMS0X+~v50rENT=ehZLKQfPN~+Q
zp+SE&$F@=_B;yTjEi!%|{s4zYz6wrlDB#LvrL|o?Sqir`N+)p5bw=kiG%d;QmFj=k
znZYi=8E_C=7jrnXZ~IfZqdEk42w)_9lz7H`&LBm~TKmVXY4!A79hfL*{m0s#Ze
z0W5{CssIs-YGES~fv_ARrGQ<)6l1Seg{uf8sF|ziP^gUr)uOB+O`Q~gjo{E(3fKsk
z1K0@iX%b~ky-q#-sxuFwJg>v!NOOR?ao)S%oyijF1|tt^y{z~g
zZm&}$qPgGv`j6mMeB+x}RkFqUo=q>_?eKOo{$90=JCDI+u)7?!LXMvnr`=?;$jFTB
zZ!l?aJ7v07vDvMzkhfCIny@c-nMU<%y>gag!reLLyl1|
zM%*Y;*&gxLnGq@HHB|o`}xl{zwiCvj_0ONZ(Y1tJo#9~VR1jd
z>dE(9fZ#CK)!EATM{EiZbT%6WdeH8~udp_A#?<${SG=_8nPM)n^zjW}`|6tBz8CYw
z@x>>In{SqJ5`O)g+wr)HMh9&sys?DGSBWS3FS$hg<*x!=Ng(JnS)eem0=4MasM8^i
zU)*%;qN5*s^e*^plM-wSO;2UTJ@@{xwWa%}-;G^*sYs;(--E%HZ^KJbj6W@UFrsO;
zdj`7$l_ePJH6o#yO=_{M0e;BxhmXJaz`=E4-TNE~Zvw4A+^Ua1KAOZ`k=H?5(suLm
zm%gp%Q<7%EJQUA}*JR6gFGa6-W$k5|rLTNhIsv7-!{ubvM=Ze-%i_xN%sNfau$EtP
z$t9~+t-9fc8^FIpn}A+}OxbIP?4ff)yoH{CAL8I`;4t>eIWRAU*TEKq04Vu%=E-GG
z6$%+A3SeQ1#!?$!-1LPneEykbPngUGD_DJIyaDA{k^O@DNitgdIdUYru{6t7SdX=V
z%3zfvmXD~9Lh9BE$R}uqV1%609)ybydILGO!9v!`kVasjjdt0P-5+a$k&G)N-aWBc
zq^Sub8n55K_2ri*O_{=1ui)%Wq!_d5l8=4-m%sisLJ~-$)n;Sw`1>1g{PxvX_iWo{
zcM|i}LB3Rt$@UW|LVq6PPYxbU6Q{Lbwpq4HDG?dQQDTdYp*~mTQLV;61qz{I@E-7S*V$3u6$sv76
zyp)_KpnXeoGBfgLf(M!%10C*J&n=tbvuv?5&KN}cKw)Dg&7@7Gs=HqG?(B)(dw=o1
z`=x7nbE{amKz#A@3zPjyjfiIUUA*`
z#g^VP`**y2#u@#qSI+}9Z&y$6Cod`9amO@+Igbn22`B7$e)XxDOltY^bvNH6cI^-!
z`hd9YcJa*0CGmLj?9H1z(7_lYemV;O-Z)
zRg1|z*Bd$A&~$-NyAcs$h7DPG#n3(QUsWfY`dP9$dyWJDqytyu8^mNBxCZ~fRuh8+
zVE{`7>;>4s0X&?uRmyQA^~V;c?_Ia^f*tEtJ6*PhhF~H(=yoXNLH7(
zgG<+f)aPp@*Nh`KKbLstd;7O%faq!wX5Y|wyeZP8Z9nurIPhnkz0l9}z~1A)Kk2~L
zc$mpJaDDkt)ubD5ax0UERRn_x(ilJDUh&Oue)FRr{U|>Hu0XHBC3GK@`KO-qR=Ejf
z4OD~H@GekWR?WRF!wXmEFhDN<>tFv$?D#9MyppJIM00)l<(Ea2fy
zF6qc@?|ILA=ti83bdA{F4m_NA>-PZP{Sam{h*E}IelG8IwU#pqa5nYy`ozecfMQxI
zYwRK^nG6goRG{@;gp8;Ya)2-rr9Af9?4evPX;hxe<>3<=8zslU!q4QD##=UO6
z${qm+7N88`u}moBiN~{{>61h(hSVdQOyVl%c3VNWk#}k_3Q*0a$78;5kWEH>JQbQf
zd1&p9)@c#cC#l|H9?C7g_J(-xI68Wo5eRvP`Y>pdaOEy%0JbBSEqgsd$=NqHE||OS
zsi&HpEnJ39);2=)OLo7v!k4ZLW4*t>pF#7;BafVa
z{`oNYEIHUxaEWa_^Xg4(>H&E)FG4-M2y3U#VL)@i0b@7AlF23ZDA<|uvfug6cbH4Z
z9COTfzx!Rd3Ua>nt#7eeAvOwZ3d{tDKD#K!0nOrkKpOc5R6@)3jU5anzQkvqc_t<@
zuo1e*ic4pmbrxk1-sq!ZFNZ;~>#n;FLD&8F->*x*-hkE~e#GG((0d?T%mnc3Py|+C
zRitbFAhC%uY0T-s$;CMuCngduQFj^YE|X$%cx}P30fbrNPYcYUt9h?Ov^I%yu4pxs
z?WTGuTZ@fkOR<hKkI?HU=%mNQ9gko**I8mfhKY&@S$
zl}&1?I39E1OP5cUQ>l>0P~N_yHDV|XM&p}@{T{I1@G=w0?c*W8@Hm7Acd6n
zk5w6A#w+*zZ$?WGz%zBhDck@HB-?SMn(zt)i$|o1Xq3fu*|KF%KKUd(2d@nO!6PrY
z-~u=>qPyL4%PoXqqi0xs^@FR29DAX6BJGDOBK`Z{{~itlPJ*7{C!ZL3275bxBF*~2
z4}L(VUJ~ycI4#&L5`?Y!@|VAS%{ABPwH-bm?twR;2UuJE4u1io{VGo5d5aUAjO@aN
zUu7_3rl6blXwAT@9MjFB^xx`DC@~f54Ac!~q6*??hFhB=TnJ=A!7qz|M}#9LyOR)^
zLdglI19K#s5t|RECzq137?g@=o)pBC6XPQTOibBearhdVJt4mxqi<80*vr@>yKG$Y
zw$!-A*Cuiz^??D~t%`b(H~Wxnty^um(
zZB!6>4z7z%px8la-{DFRP7g3j`D%P+eE=|A$1ODk^jx0#~K&Bt*?DaTrM;hrp)@
z1euC7?{x-k*-Y7P13Q_jj70eZv&I#Ym=%~Lm$QXTRwa^EAZQg<2Z0P^#ENp2`iuXU
zy)%K+qbT!#b@zMU$GmeVnH+?Ka0e6>L0CNSSY`hlt_pI9=L(*H$0DvS9=mveq9WeM
zuAt(2tg?!Wa*2e?BtY&==AL)n`|R$w-}nEmx5AhWnLr=|nK=D<)9IP8v$E;d^cmCzC9vLx2@Dg|`3tZSLtOd*g
z!hr8Sd5H&h4#i4o5!D1wpk(lcFMI)Y1ono$gCUw=`*jKt4i{=;1sR4k4fXp$9*}}`
zcrBEXGsZ55DvbiUm@5YihD|X(H%{V}JrOlWexr)(F+
z?P#b#6I5TXx#k-7S>{S(=j(YeP@tvvbPbp_i6p9}ru36h&J{+sgkx^URdX=3g2PIH
zf%0a#!FbKnkgvfn%0Nu^}-9W^^C~Ov~NE-xCTP(knEV$7f*Y
z#ec5OE;o@*g8l-V#)Xp5UEaR_)Z&h4B4FB1y<9Qz)nB(7bzn%uzhFUtU717&wpyZQ
znN@66!-AN9I6vp2f)|GFvSjUyyA{4d?dHF$C7`qmQhQcLcW&e*lF#tC?>!aX}z4n!TW99XL2zRzK8_sgr<7=p9XBB0ghKmYk-
zjyVSPMi?hT8d^;o6~_fwuuP}bFkO&`@=pr83yY;SaR^l1nZjg}pQGvU_q6?4a%X5$CTDWC}>*
zOq|wh23}^`R>clJ)WWU!_^9m-df={r{I&o>-gE%`?32_Rh8K$x9bS)tIUZ|?$cG^-
zPO*f~g+E+2PcVno0$!(D$!;#|E|KgG6{gBwkC7P~LFgF>2cqGS6xr1a2v4vlgVVFw
zh`zTQAGfxHPmD@siZSAig~zw==ugW`-IshPO4wD3EiIqBM8ViXqpupa2
z>C&YD2-20#BShdS{$$orocN$jhXN1;of~$5I`TkGyCG#NTX%cRx$JF9d3HG0u2VSD25v=Cf9bj_=
z^8xt8^uZ%^nzBM)=i#m97O
z%8MYwX%gqMVij8+V)r(@UO%Dr80jn+6f)+TFU8`D{=Zu~#-9NXp(QQ+**Zi+G~6|_
z#x*t@oam!0#}RZ6f4-4Wgphtc3kGig!=Ik_yraO}43o{9H~01TKw;Kv?eeA4
zw0y5wlkaV5vOadZJ~ED=MCy3kdAvU8Ug*sh%Nw}>kkxF4efj{th7ETfZ`5urT(9Bk
z)9dIBZ&cI$(TS}-IKYtq&({0)N4fJL
zV}DR_mon54B7ttIMiJLsz#Ehd1GY*Y7%gtIzw(u@uZzwv@
z^~-q4C5qMJ1#jJ!{;rI!*>nb$zJ)*nKmYlM4?Ftkp5)nEwtO|v*X?97{rwk>Wq;6q
zuW`~zA6PqhbNjuip2VBRGEaPOM^6X!`SIiV-@SJ5XT^~nkz_}I;tj*OZ|6tXd0g5l
zFZ{QAxBsXyG~r6c7xtWc-$Nhi>^r7z_W0u`V2848dvRcCL~h~YyLQ$N#U0dHv5aZP
zF>CL9rUlP~jAu&0-JVzA0E9t5fD`PB6~NT|3DiK*@Aa>LJwCHxvG55>nC>V%r4GjA
zZY9sHKaut;$pp)EOhstmm%j8R0;|6EwXgl*4}VBoly6g{9neHI7WRn*2r8*ZV4q5i
zaZsislR%e~_5!dJ;2;GB9a;?xg$QgRVb+Uw4jG^iDIg4j#^DPU$01~!Cd=IF7=Pon
zWpvMJkb#43VYX^^z!xy;4WbbZ_H`SX^dresT%dqybV%(5Ur=NxMF2OpVD*BGEgkwLZL3zc3Mq3N}%vd7%lYSDVFl2!&BAP
z0Q5O1(`h4Lnbx6lL1O_H?1lg`paVqUE(bu3yBtae#-Hofts@xkz4zV=#dsE&!m}##
z{CQ4LfR8?xL58jAX0v8j%upceMf0)IYTDLl)T>R64R>@c5e-~cxa#SeuiGyTF?4fk
zc&G#2EV;fHrO7nm-qm$xcqG~X#PnuvcsNeTRH@d`tfn&o89`89*E2a^GH&Gxo;VII
zKnWlNsl0W{3tu>}c=49aoB#OdKaXzR(z|p?yZq+P@+A)7y%Rg%D_ohOY_hMvou^ew
zQ=cUIsDPNv$VjrSLxy^1yPl*|XFW4Kn(Xfs8j%t;bIkT82IOW4Fg04(?6L(SY^UWnN2_#h%{KODr-z`p>V+3RM{xPM7c$_
zX)y-x=1+A{$TO|VbNajj6I6j^H+&IJ3Hwy~7Agb@@Pb500kc$y3UZN$L*JR7@#4DE
zy-R&|=64aM*%N8DtV(4(8tJeL1TOU0L`r6>)0-9EhA@1EOg$R!1dvo4PO+HoOm-?G
zlzr7DPzh-*s{
z;Ux?YmaRaLU0*%jX{I^!u6O6wHKv$2?!;LqQ8{QbDy~Q`Q1+yaixw>cLJ{E%-NuV9
zx(Fu9UDC-$@G~x8uGmnpS%81fgEbv}3xEP*Ext8vq`iFK4}9PQ2q*Xxp@l*lJ{^~o$C~EVUXH#5v3Qs$eJx(WV!v`x~My%WrH%}
zZVXvnG12gdKup(t%!V?wZXgn|8x3C&|5rvR8bjNeizlYz__LvV>zdCKNmU$|D;TqN
zuP@pm{E?P7Y6*9wa{*_Q4AIVTN6**4ck@|qxB#*5g>QY=4}SDh$8nWw&5o{q%c6e%
zM#~cjci1@O3?zi+4@FWgFBQP&XS+Uj%ZHhY;R(f(xEGaMFhUDNqISda1*7=s3PqD{
zpTD6at!Vfn;d;wLjWy;<>k@~IBIlI|2k&h-zyAL~Ec
zl8mMd#fR9bN!J9>w0G$U<_s3Y@ft!W&6L6?=@JDg6Frs#d+Iq1eUR<59EUL=s8EV~
z=y-nelbxf;^m@GcLOvG7CAoC0NB8E;Y_MB;sZ#RX1Y?WEg4Jr>AMm#8<0YPw*W=F@vax8QTEi?ZSgMvhfuP+qeYz-?OUY1A
ztt0|IQLDCG-n?7Z#i^Q>-X2qI}_@cUqNM<){hnfV`S+NXtp0yY5hk|DpWN4aM
zsSJfeanVTPVU~zA0uS_Zvrb?|O^iNEq^+i@H-mm8V$!KS+|u7d4%Oa?hkURc12--*
zU5begob-kxBWo~7s8y+4LV&?SoC^{=Cmus`bGqBl2N
zx=RZXkEe~rnwFij8)ncKmZ6CpaE1hM+-n*561BA!5t#Rb4k?XQl6klz4Uyla&EXi>
za7TC~Yil3^&BqRtFri5GfAW)`z(Gj|C6FJ{jsg%oK7Z^h1t2W*CQm{C>#n=*z3+W5
zV}Y4kO*i{m+I;@!iUM;QWI!~ja3EKSI+F~}xaFbY+M>OS~92Pp{prG603?gKO^o_1uznBGiXg$ZQ(!(j^yy2<=vDI8o=|k@gOW^wGt#
z4hFZ|D`ckqb<9POu^-saUdYEc2obUm{hxeISO}}=oCXW*T1EIeM5a*EeATEotm`qR
z&XSc+#u9jH$>y_$?uyEQ;99v_GV4|n2a!U{=JAMfpro^o#2lQq<9DCg-!IiXWet5^
zf5Wlc((KmvzW@E9;T^b~ipKDmzhCMflak6dO2a8lwOm5kI}tOyZrsu#u#{MA=NOUQ
zpFysK9DDghPxaO`!ce0Z*#nDgkOT;Wb%65ViOL0JAp{9g$dzp>r7NVUVw5A^M-kzv
zzH&a_E)-xI1;a7LFj7Dmz%@Prw4DbTyAWyqa@Hxp4BqCk5?~l|l3~vIzf44X{MNq9
zP}{t^sfyk091Qqa&mi@T1SGIdM8aRc;j0&%e;#V#3T?mn&FB8dfBfK_bI#(=nGpun
zm2hE(LxF?8o)tVY{@M_!M#|A{H_N%dHe4p}^5+cY|BWU;{Yh$9NHr7jaK=(9XIXZK
zjEMX^?Jq=FJ1%VG8XnPbRoMg6tZ=|BJg{ui8z!M~qyt*V;_UUg4a}DCgkn1fR659s
z8scZhaA_{XBR#hWy;Lp){2^BOTefV=%2EvSaQ;28s4Im&>C-meipeu@_5!7iBp7A-JNwM?K
zKFbtf+MK)FCC@Ugc6}Z5kFv3%!y^-ABlXZj55?~eK4XwuFfTDQFid;!!3Wu1R4bxg
zA3tcWcV)Y*F{Y0Lxq%9`&0Y;%fpDiM6u~|j0MV+N)oiw{EF?Y4dJW;joEdlWUKv$~
zRrk>5acKvwgDm9DfG=cdUPNx&w~hcp4ybf$RVi9p1Idi9oU3HgMbXg1!8jWf|NYC~
zp8Ud>;5e=@Rg8v{xT75!q+R=={)5}L8N%_q^q`FOC#n^vZldF4#KMU^eZu|xaX|^l
zY*<5sFj!UK+mr#1W-Fqa(@#I0FdXa(fiT!2f%$P)Eh&Hn
z$J`3Sz`6KGKJpQG6~~i5IiF*m0&|}N%puGww1WiA;o{YY2b^8W_M1LddRMxe~Sqo**-K6$`|KRm~1OqI_A-QVkF8
zVwpn$ZHlC5jAE>G=bd-5q&v7R-{3MdND`O!e)8dQNc7;@7~FTGUtf6|pa??WH@
z&~5FfttD$#!ahV5U<_MWkBC-D7y%i0SMo$QPU=#y;Vc1w2(3o^
zU=bu-F5pBL^{Uhom3j|^w=0VPfh`Wa^m4VB&qn$eQnwBF-GA9-A9%$pUU}A8|F2{5
zQqi!A6X{5QuP9dq4(+Aum}gx7dR_!62f0tOUe$@#6A0myrq+}?vsmSL|!!6ar8M04^}p5#S@N``XvOcKG3kzxc&3<{Cyw&t?M!RKf14()VOW
zV1hu50qo#e{ycDc{~W3bxD7J$37A+RK7ntrS^{UN>2(e@*%A8X2rrHhXeZ_c)^R~^p|R>rx0ybk
zlz`7+hFJy~I_5%z{B<@y^6S}FBX6IvghA*$3s8-rkS6D
zNeV0`z$F)6960T?m)&*O9Y6R%CYO`MVGKgsi!M5_(%<&B$SYs@>f3Jn?RD3ssUBMa
zFj=a4=9&7%7r*VtKfdWpU&^57i0BRoUaReg`a>Lm!}%AVa@9w_lIl7XoR-a%ynZJT
za5n)LfQ+U`InI}}mb5NuV5+lUG?J7~0KO~G@nnkp%x6BsVE)A~egS$=gPZ|R*H@5&
z6r>$&ks{tl(-UDPa|BOu9IS(Xw#TrdEpM5eoCLsa+qMno^h~T=&-Sb5%ioU_;5#CY
zVj#dC=0V0&CoJS*i30V&+4urLGYMrc2*|vo<{vc?z4M*#B=M_X{VEgAQ!jiD<%9y%
zR-LC21{Vi%6J{M`OjRe6fq+NUCkOwK9{X9)J?S@Erdf2ME9q%AP}8WnbZe2{ozMkF
z(RsJmHatzI(K4+X+6E|oV${U7+vRn+^#dn86pUa?O${+xLj4nCYmeJkt`vRVfMwT7
zM_I$~3!?s+h<9-2?lZ4{(G1(ZV^TdQrIN=AEhVKF^e(+wHS<`6O9_Vqq>!dxGJU^-
z3S
zV>%VULz8ej7#~}U^rlzSDmptRcubQ9*5J_g=ED4W7YbBGU)p}&SHHF9+UtK~mx69j
z%x>awPn4<|A3zQ-bWLnYq-T9VhNdIQXrcnsl4`fR9}4L!9Kfu{1wsg=mCc}KeSm5O
zoD4aHg2?~{ium})KmPsie;;cR7849?dc5lNyO%D6@{mEvpb(X3!-fqgg!7^&W}Z)Z
zQVJ-8RcOvf!Ic@G13$`m|KzKwohj0B{)P;hnU~exJe{AEq|ZqP#=<Ln3i79aJ(=wzF~SAoaYd?TpqVkIX>MIBEBBxz%^!QDfFr_9
zD|h>C>j1q#Lcgrsq$hHiq+MNluki=MEmU3}Kk#WIWrdh`tG$!Q(|7xy$&Stnm*SYd
z1-yW1!KH}yi5m<)9+-oiurB12k390ol~-PQ!37tPABp|q#fw#UpMHG$LMeVy8p9qf
z4K`U2draS*zt~p_@I`opX_SdoeWO!PJynHiW%32dL1!|6Kh$U4*YfA{&r{$)rT~)?
z2TuQRzz={>y&ZVLyu_h4XIUdLm0fhvMcC3GtRUk+{zfy^ZFWHhuF@Rh)Dgo;PozhQ
zTIUUF9uy%1Eg?PE!`j+-qKOmu7EbPM`KN;d<9_h#FjIr)bh=w3!VlXP!h?7MgoeU}
zA;%&%VkC~TnaWeFfhP~g{v`!ues)$
zx4!kQV2cYcyijF^j2N%(eYuSE5((!AKlnj7pTaSyXeeemr@z8;QhBCPa2wMopMx*O
zccB{Ro_j7DpiH>XnREp{xXTw*lB(yVs`D?Mr@(%v0Pq5%Dkdm4O8)Yfzg%_IRlI`9
zgcN2WIzRIg(+i!SF+$>gufTkPPn!aJ=0H!oxF;;B-=A|>X~<(b>
zK^Pn3dFLyi@E?V6u+?(YO*io_R^G5lUh#yC^9fIh0w~gw53+;&pr`s1r=R#hgQ^OA
z0Oq($p7}}kDbaL3)7+r|lL>vBxJayan5Ni%rS8l~fDCM`&_ibpLns4~w}KjTr)39!
zO=o06`={wJLE@fCY+)OI(Lk?L)T90J`bbgQdUD8kJH*0qHFTFF47}b;$M;lf{_*H
zw1A9iLz)Q}56Ya`ndWOMoT1L@BksMx`MdKJm_rmm!pfc?T4F4002W9rs5~BSK^8_YYXU~^vSrIK0|Q<#h5-}EE#PplH^dw8Fqj)1T0&S093p#l`>a5Kmh6e1>@n
z9Ox97Hc4fpgiRB*152d=9|$>=Y4?&POPFC8BdmXBnwJjrb{>rNn`KFcXjW`nMsXL$
z2QR-uHyXB6tYyoA{&pxoTx`kpHUbO{MKwnRoR-hg-15hTU;{;yKjD_w@=tEHeS7Up
zF-WvT#1@f;=B5ye(pm`Q;j&D}IM|T+WqQl2wUtR>xb32Rjdp1b&9HUD(tNfESR&-K
zB8^teX@$rmt3=p#%7II_+%4%h)7LK3+j3&UiBTrbuUgHBXoh4ups9sNEUId>tBqGN
zYR)ykru0X~ElPG$PBZ1S0`2s+*ruiFLqODBlruGAy#xfFIS~FBn6S27L=IHJ3?;l!;-WouTm>uu4WI!flK?|(-@g5f
zGtRi{uDjq>7^5rObVfBR19CFX5ley?$Pd&`fK+D6
zKUdPF7ZOQWBA}WYvN`$(+O-6~rmJX;_L)AdqkyZU%DnSi?6=0TQ3Cy$Nf8cHD4z^?
zL6|5K0Tv1Z9v~nCDz&Mhq-%1yf!-Crc4SL+sT1?CEwtQk^qDW{V5I=vn~8|N&Ag}>@jA6mUEno-oJf#N)$YA0+Sm`hq+cn!DL-)hYv`}eG|MC}pVAgA33P0@9Y&H~o
zf}aQAyNyD=;&%1bDxqr4_Qt}QoQz-MiHh;8<%tAcUatlZHRQI-*p%&w1}w)aRqGAS
z$y9Vb&{eKi4HsxeFX!rZ-EqZQ4Xdi_jY`G#1e>*T8Fd5Av<)Q@1P0ka$DF8TD6v|Yf&yoaP_jQbJf_6S|(j~
z_4U+>y5@vnHaNX?oLb8<%eA_<
zGPcpObjxfO9mB?fm*ooRa4x>U$scO6Bwn*abn
z07*naRP9%Zt?F2MFyWQKY_(>iSwRqFIDUhQup^;aLboM)(Ojk_Lxgj{pTHBGky!92
zj7o_j6i|R^VO)Ox`RAj4ftzrc7Jz`&GeCheJ)6(S2N!
zJ`ZPt8*xn^ey$Ey-m1wA3UDFgi1X8^3_?d5!U$E*a>3}HsT|&joKiJhp?|LFh%@D<
zs9j4YGq0N|^Ip=CG4L!06N0(`1gHw^(|2dWQNj!^lvEGlC5YCbP6
z-6z`4cIMdz8B#5gcZ9<|Kl#u5nErqYBB|HX!UcQk@62U|UDp46U-tCVOZWY0TdUa-
z@OMp(6kq!~QL6@qwp)vqB}zHFRAicrj*r(p3l`unzygpM$teDpR9
z>W$kYJ6?KPy5%HF6{~JBg?hZH#Yj`eHfB4z1HnYXb^?)bN6ivL+gl!AG89;O7VFfEh+Wrx{+KA3o!!x<)vQ;lc1fiA
z;tZ$X{l47HmW^OkcZpiVuD42lpI2`p!)WVa$Z4B@$YA7p5gY)3V4g*^Fg>Y}L)ni|
z8cP8J3o(EXJM6H>9(xSI17n!!fIN&|hBRl6eeH-8$WzQFya;%~^}*pMLor1JYVF87
ztv014y^G~y$s|l&lL-zT&1hVzHb*<+`Ai1VMItd)R|Khm;9jqvZ;{DJ)!JvC9*-vp
zZ(Xljl!-SrK3}O+;fv>T1yVXYyZQ9oZLj&HuG}oA<2>Gr(g^YiV7$*4F?26rwO%uU
zJ(5;!^2v@$2W=w^se?6}2fPigM$e}w(-qmmr+d>IVMWi$0iIBUOQ|kWD?ks`+t~DT9Rt3^81^Ew8(C#m{~^`gf;@
z&ws)E&bJmBM&7Qw8}-3t$BUAlOm1XHJleN?+pusVsl=+x`l-(N5#_vcOf=$X{?Re9
zWozigCmcJn?P0x<62(BEE52?0rbx6Wk?4Qq7Y`k>{4}#FMz(KRa^y>41rx)jKTKHE
zW6LF@HhGUIo!Sw-e{{J1zISE5`>ogelWWT5;Sas9eDQ_ak;g7F-mQ=3JYg|3(OP`WGP^!DF)Ugeiv4}7o2~ljj!nfvHWnW6ySpO(
zxL2<=8{y4cN<*U}89l08TzB6+;o|sav?o)c#6x$FEL-Xh#r(clc-wGk@gWP$e52m1
zdHtbG(Mk^V)+(comV+EeLl)x=Y~L>0bd)_wO%opXjNh@*Xfm-fJ200q+o}l{F$P1O
z`M0~fn*|C{Ft7nzv0?=UDpN5on25Y2yPvkxW_*`YeX;dq*-gHa;EWPUoka>ou6eOZF>P&n0^6DoRGM_T1DIh!0Y#!*UA(3N_k={}0ULLo|
z4hdgRs8w!ermUX+Rk^|9?YE0hUVX+R>qI2BMAJi63>OTs?t!t@tM0n=Jww|DGXuw;
z=<-H>_xts)IDO)nW7eK`-kOb@a$QS~IQ119N|rePt-rhP!Qof_{attbdF?UJyVt7P
z-f+j?pY`WsU-;8EU9|P?`!>g)@@aRU{>uCB`qSN&s`ONjy|E`#7{Wk-qou&
zJ^0Wt`$F%2?_;cgk3ad^U}(`X$KK06kuXBpitDP+h}XVh`&<6$(W#Qww{&HC%31xQ
zhyUk~8;^hShEraa{`F5EW+CQ{1VSs8XYz!1m-ga_hMa0Om#cd{!teH5t-Y9%>TF>$
zJ21#$`K)G`XefY%#W%k3jjOM|8VvEOSG|fkj_E*_3_ECh<>F6nkqsQ9CK`43DV}+w
zQqDR^{bb8^9(Bgn>}fH5{`*WABb=pJE4lirH90!_w%|imk$%+X9|WSmtwbsL{k3pu>E~
zxKnIp1lr3d;6pHz@F7%fpW+vs&ohaUU=zXsJ|RN#QxNm*T3&d@!NYkulN{FM<@TX?bWO;*F13MR66&-!{Uu^
zU)sN7^Iz`2!|f~eEz5lA8>!&RV9Rj+^JekZcSWxM#*1EghWD#Cw$?tDPM6V@5M?tG
zP8^yp33oVb`1-HA-aPN3fp2~P1us8c``j1S60xOJoc!SB4}S9MxaO`|FY@dYnJWti7kU0Qww^o`t*)BzD2+8#-mO?UHto3iaRFEU~-wIi96Sbb=zO|
zt?wN2(JNt7y6|cv4{vgNQ&o0f+Q+njf#vBmK6qkxM0n2B0KX>>p7O}RJc|kyn%KA9
zcH0}@_(nD62L=X+EyUng2Z_vp)2~ny^b-r;OA5S}gDL*t^phdgiai32U5@sWyj(9=
zttywWSkg+FDWMk&BahayImTF5Dv24Dj>|OmP{Kh{%Gt_(NzaUBUv}E5n%x}QvfZvU
z+y=TKVrq2CEY-Q_NW?h%bTo@aDB$DntfuRRX6JMD;*?Xh0aXE?z!#tNrP79CZ9*~l
z+dmC`47pX(c9^r5e)LRl(RJyBbbgo|9a62Q*R5Lz)Obz~xH~)>c1y5wL<
z*UGSRK)S%Qs$Gm$RqRaVC}l}DF5&mQcY4N{DL*x&K#GNEyn+|;ItrO7|4iu+oDz5)
z1(Jt9@r4h*d8XfW{`t8>ff>c@`>6>`!!6UUd36`A9GG#4Xw%W>D~#kcmtW{1t65%i
zzc}$Fk;gV{eaR_@u3fjGshhb{kxqT-`(8J;_R*!w54q#+HUIoczu~oxeZKh1TJg(Y
z{Ob9~yn5}nmuJ$yoycruoW)Xpw-#Umf5W-Y+qm)1%MV|&e$%3c-Lqq)ddSMd7cTk3
zM1J$=WaF{T;(dpu46pgCUn4RJPVCrNsf(?H53V})IE*kn!Q9%7n^qkjE0!~8U5;m)
z{(L$ZUi{Oai3{JhIvnbFUi8JE_{{IFxMFoVZ+b(*ALtqz%f~y#(AZG_qGiAR?ZX$m
zxo`Q(W4luee|Xc6Jbv91Fg9%w%U7)O`JHck$L9%{QMaeNN8ESkuNN&!dHiDGK+i*K
zAN}?3#0NiodS_=xytnJhPyf$*-k%tos2M(S`9}{K8`+^7NwdDmAM#FRhGU8DO3lcY
z^Zoq-fv*-Bi1|gmMeN#200m5@?mZo9Ho@Zs7LP|Bc_dkI{(s9Yw;;p7z5m$QnA)jD
z&`JhoK;|H378V>FWM+=01P&&MJrzG=8URJz!%xO#mtDr6tfeT2!e@MDuH2AQt{OOP
zNrp6|5FuZ{6j;*`>IG$9mw^mJFGnMm2sfP42oj-6p%6@^to$UDWR?$ib?uk*WVbBm
zf;YY5n_v6a&wuS}g|V?{Pfx0sk7d=f~_Gdio*7U;U
zkf)jQMZywBpmzkdc8ba9rjQTyDCFkP#`m7KbySR;RWp4Lq_d~3zPp`}Fw-9jt6G~dKXP43CK!X1gw*w*w^X7a`x*IK5y{{c}b
zi~ha=vxe^IWForEYvf`J7mV%5^$Z*(S{nxzE#I+uBRo2rZY)_eke(dsUa~N|eWbr9
zA#5XGvXU`G(0z=MjzkjO4nzvs>@c>O=tvODJ)6O+x3>174IV@MYZvAOF)xXyy6u<|M}1HlDWtCPM43u)~&bR%KWhR
z^7mK>iIhVnnNO4qiEE%0L{Rma>8bhjgNXvO4Knn)RrTRoTxgeFc15XpwPg!CpN}r+
zuIKX=vpP0eJoY&8wQsy;WHjq`CI01;zxdzZZ+OYchm^|%oUG(?KH`hAy;3);OP4Ml
z8!umR`H@$Da@p^G_2BvEKelG=5*Fw<3a#huMV%{LO)>J=j$}s^rg+umqoN6Q
z_OSDz%d>afG0>5S6fz@~LcS}RoXU*g@!YKByHioGOJpX8R;)bSB_0m>+ynhR#mu_j
z{QBk5NTO0IFIX8a7H*rENW*&a*&0SL>C9Bmf>gekWunEflx<=(HAe@Bbhiszm{=$n
zkNHN2H?_+zbtU^8{Hhyftz2{kq>gMf?1L4hhsMM4RCm|%bI(0VM}5zXKGolN`7|b%P=a}G7$YKe_nud9bNrY*aDS){E0#cL$8C)pY
z2Ko0`{!EF?cZgeo6lj?#0SSdO*Y9gNGnN0Gq|;&A2m|UM!`SH$O>#`FS!+s5Lbryi
z65&+qhDe|J|K9$E&%g4_*ZuchcfNtzvV45UJAQM+4X+{_Ol9@zZ``?`((k$FT(2><
zY@l((^3(6Q!!elUyap1@0A`rRA9
z`G#eOo$QM)@esDn8>vAb9PCLC8Pb7G`@^+uY1uoPq0_eW?4OfbzEc)G92N_218~#-
z`3n2z1^ZYEuV%PW4JyF6V7Sp4VEK%)eJTmO&QM~Jz(Fhz&OA=ZikCmJC|<#~1swp?
zrPMMWdgvh>_|7yQ)tsOTU%YrR1@a&Wh7z7w_+C9B(|V$KA+~MG6+~`PHjRI}H2>CjiBK$d
z#-+`on5XABuDza_pgZedoK!4J>}%KVNzM
zZ*CL6zjJZ#g3e3dbnoAt)N|C)D_(cj|2~*LYs;S=c*B`ne*Cl3I{MR(KCi
z+}a%uMP79L#+!e1{J_%0$3AxJMd!Z&qk%i`Tyy8W6PI2VPIh!({!g2pe|+jCryP6U
z#kb!4U(t9Xbc4*RTQ+nqdG}$h
zde50>-uBx&VtCL9H(qi4@jtwOUC1)ap5)T}pcpk1KmN^*EC1zxg=Ym2X}nNL#Pxh7
z>#{-#VhAyZ^K;wHhM6tY!;zTR<3hm`0mh++9(w)t*Rza(+dT`+9@!5FhFNKPPj|zH
z4b)+7PcG8$mhA6xCC){gW8%KnF%V%?^Oa)2)#GUy9-zCmesI%`&H4lEbh(7|2>!Ql
zIKpo=67Il2t{gr7#a}C!j}>dafWOyjw7j@*YoQm~kfMvW&Md@(gp$|qL>{w6A!aH#
zI$aUo2CIWjsy}Dzea}|8)9nJ#bB$m_VV6C=pC+@?ASc<>8L&ml9y60jfl!Q`Jg7=m
zubV0VOzHdj-kHkTOFEww$hB+JNTIfSd1UV1QteV_Xghrz$Ss<6Nk-dersj<%ZocW>
zH@@KzHfY_kL}u$$BI(cPNCsPIwcyH+4!!?fKRxjz@s3MH
z>ac-_Zh62g2v4h0E0mfwv7jrQpWOWR3%jrW#69<~5rjqk;`NKVyYy1A{H}K%bJ_bJ
z{P$~az2RE{WEGFD-~6gqiMPG=)~{S&DHp|p{=V$g$fy2g)s-Jz|A9+KDgW)4X#GbH
zJn*vzY9(Qn@~wteF^7&=j@B%}DMW3{7ESMsMnX5;G;!spJ@{H`>7Ga=m@SPY!ZD=4
z<0JWqKU}XC6MZ4v6m)cirZTyIIPbhITQ+_A)1M~J8IE!2ogfT6dlL3yR{Nzw7_1#x
zN}_JYOAiJ=8ST|C@{FAa7ZPr8z%g+@5cFwASvrezoxBG^Qx$SeZUpSPgMOu_O*@2wm1We12r3wS`g(;mbu=JP-bf(pdVka
zYT4q(ct}_b?wIWce
zPY9fNHtL;^Zk$?n=#ecwXEoQxRxT9dzU=mr+ZPRlJ!NZ{rDq6ZKLg9dy4`RGjO9aH
zC&Ljfmhe}yX}gh*#-)owz1clBS`P-|(auP%Jc!IN5gpLu5vRBXZ9bv*+J&-vQEKwx
zhqYEHp6qq4JYwjc-+066&IQXV!(C?09g13|`Uc^hN-j)|JZyBtR(MmLrSbKy;84S=
z1@)z4BZWY~AMf%PD%rQsoOCo~KHog?=Ej`G3vGJcb{nrOCyW-WadexOzeiR$*)Cnpw{eABiDUbN!`E8H
z$=RkJadrE+M|$b@T=v^e^^f7^m|N5jdU&BA6#gb_m|JzOy8jV#^-JF^#3~^cH$*&N
zv7^BN=Cd+X5yX*>^RdlotF^ElI4{X~TD_bF0}ELtZ{T`fk})l$nU`cdtqwI?56wEr
zz=KN=d(DQ{<8wWD-{Fbq#@wLQwJ6lUKX=eCT){$S3WL>XNT8hnQ%C*D=R*0{c*P=gW`(wuSSzJ%B0R8UqQ3Bm7u+sEhO?+dlvK{rG&x7v%u_;VIaWdy(rl&UAmN)qWuo$
zU|O85zWl6|ix@*j-;kWL{iEl&n~qkoL>1|BNQ)0|C@$)Ci}0hXx>o=CmSC^HxcFqhepVe>1-g9I8*}*3w+7|GNdE+Hpl>H$O;p#hwzBATJ>pW
z%;1{eE}7=U^V=n}+UsVia5}RbHSP2CUdaJIsm}Ix3860B7`7QE4l|@ZB)f)^J_I50
zdndNn;z=vw^+h92C2PY|WBs0qVJn(yjIRIF!lMtXuKR7N3NnZ_C-R~=VO51GCQ}2!
z9S?0;c+?^hG%GvA!e#wC9vxo#nv=?R{V{|SKaBFpRuxm5)^&9E#Jhr{gPZ%7#1UV|
z;&x^GreH^Br_Yy}DkhgFqqRah-RM6iHnlO|(bFxeNOa3s2$Zr`cI{*|ED|YEFXTMl
zqRZpB!vSn=&8bP#DMz~fwTW7yZ<%NfEqPID@}ZH=W*y&)eaUK1pU7v%Vkt4O((8=l
z=ySX7oybi&=w+eJx@5rLYUZO$ll74u9dThz<(*32YlPgo%NKTufPA%8pGtOjniYf^
z!X3=%O{0N%N<)NbL?vrBQqq_d=L0f+2v+P;UJoyi2ct4dnh>*=@xFY(JWNNq9xLngp^xuIku-etK~|=?fe`il6J!ZJ;`O$j!@_2e%rte6fDAj!-R70eLQ#)@~^I2lQg_Agc
z6wR!Nb&2Xo4U5+DqXqV2d=b$qOT{
zWw=})o9bWM(HyUadl$Fz+k|D{cOtf60JiGUtD>IE|0x$shH*w9T7}wRC7fECo*3%t
z7u5{={Zfok%8M{NCa&71ts`BFh$rFc99T56X|QjZ=E4I7qU$dA=o&K^5WYo=^vqN$
zX_m*T*j9ymdqiu@B;;9T5)SFbeVE_y2diKmrz%j@^n1#oo~WodCPphAiLqeZMNrJ{
zRUM)*6;24JP-pKZ;>TW3H0r`JwP<3Qi1>u{aAkW->ThI3AlY9Y8jp3ksyQnV>#AfY
zLR~~?H}rB7e;!^KgH%?u>~h71N#PUPi3aPXy6yJ5&OSTAR81gR1M#z*
zwIvg~>Z*VF+Lyn1!JE$i*-vi@cY3EL#yYwdvR{jDD0VFnV8Hb`5GU+KrF=hj)b^_n
zIzJhbK`KbGi@~8Z&1_nj6q~xs@pbkgX9ANpqLDy@%>k>>+zGe#BXtkdqKN#fCl~fE
zDrZ}vV9gWhL1QHnBK)jq`*KrpUXTVM$-v8q(Z(6jbN-m8z&r&GS_;fA$k19Yv+e|p
z5G%XOFZ*C2f30cytb8%rmuO_O0#6tdmDoU^C`}3+bi4Fmx1Uh!1cJBCx;K+Xud$hN
z0v#P5_V
zOUKlfT@>Dw=rWwDQ_mJWE?;Ly5Oq-kyH`L4*?f9Zq>!MvL>ysDRS-x-ZWRO)gu}9j
z#tdI8NW3aj5JuJAD26&xt;(1mJTzGdh25=+U8_5|qKO_kWIdRaI4Fe(p+5l(y_zZY`*6srwVS~+
z5|_8n>Z1MEGdL+SP{3blC~MdTQnH=uXjl4i>DS|lbM*f3s0
z?nFS3cW0T{rJY7u
z$k&fKh)^E{z?QJHsI9u{HDQ}*(U*iV=?Q4qKaPQoT`Gt`UqlZE%p74@L_imILAYDGR<|+RZ5Hvt#Yn6~`=VCf2?u*~1@9NG
z|2|tsh0F%ss9bl=zy9!B-&@eR@TULx;gLtJWMKKizLv{tqYvtJH&kpY3TVe7!5iNkSp=P`@_O6q{=E
zDs}l3&$5onkD5BSnZi?i_DQlSJ}HHcbl3K4WaXv7vJJ=8v(u*H
zBihBMv}Nn$Y%3RSveE5NMnSd4WUjou!N)?)d`hBZTS)odRAowYd&aT_Thsl~6c6Jv
zrTs%`+E%|N0eG;Lk?9PSr}~ox#$vWE#&Yr%Q{{r@cA1PVjSXggPWxxucnOieeJh`0
zRa2SWX{PLxa-z>SMX6@Xb#a^LIJFiFJL0@JReTT32yXU?&IeWI*##MVlSAtYKEnV%A06riGm>V9FKY>JW9(txBz2&_lwrAj%|HsnlFa
zPn|so(o3cu6rP1qfJmiG$-Zp1T&-6NReG~75^=}SnL~xkr^SQ1SJ#4mSE{2bXL0l~
zZM;~Z94W)77ab!Yyt15nrDVI~9+UUh&04|HQU2h)fDPW8@X(DKHS*gse}9zuuTrkL
zNmuzx)t%|Ws1ya|?AY4yAKvGVyK;q^-6}PVx`4yRT;U}VZE5dB9tlp_x4hFE)3U=E
zAaP__q%v8o6sjoSXA43L`T~b^H=U+0?rzq~ECG6s>lS`?`ls;5p2^pmM)W&Bc(`7e
z$`{fn9DUebf4Kc0&wPVbMd6M>n+yU5Er3D}33Yz1dh2d}GC&&#gP#ogSbMPoc>${q
zVeja7iqAMM!k2j6t)e*zTNVwcf#E9Pmdz454a1lTCKj$D6iBOF)fc|#q-NDIZILV6fxe#cu|gmg_4s|A
z3p)!Xr%}~uHnD&%y(FIt*H0~djo
zH#gkui1+zI3lM!-+0v$UQ(h1#i!=;o$|ATZMrW$m&>QLsczZ#x)p1cE$c873Nfba~
zm)-?}rrDC`WD4VE!yIk?woZ0ql1^+y1jnRS7qgS5Ubq
zl>g+pP4D)Z6dqOS?VHc}Ne;30k9w->oz>o1Guo(r^Z~G`S2~K7DF?@~6JMzh0yw5&
zL3ceFcF;9rDoS>+iHM~#6msIh2>qic9t|3znk&)20HlV~q8DP=j4gotHHk;L&p(Q)
zX7WM9(}O4&8FVP3H(Nf?dlRd!7W>5QAKE}WulMN{xRYj)Ab+y9bZ&kC4?-K(5zfUT
zqExNYr#%`f?XnAm*n^)xouxmwXa(
zNHnAVhu2S4y;|bq
z8i8J~d!T2$F2+iB)esND9+nar(#HoOJh{Celgc+KlF-Gs}MJS{kx~UY#@5{r+&}oyE3#+2di=G2KmPHz-71^~L4Qg#ItaH(w2Ay9
zYk{G~s_0xGYPqe_ZDzp4)z#G04Qhhil=&K5U&vnp0Cm
z|G|xYv7;w((n)ofzLJPqxoqTyub8KvTs&^|$iIJf$JU{-hP!ge(Y{)%?&RDJ&i;NG4GZYh_9q<)Me^uL
zJ;?z?ro#dz93~Ci0lx48}Ik9?Rd26a^uUD^pv&@H7%p*jBF}+9W?F&2)nV8YSbI0e39T42NDK8Q2N>I`pJO!m1;H|Y*g#(
z2Nu5K?mNz^6gTvA_+mlN==RBcx}s}=MT-U^vB=2ej#7CFI}x*DXR~=MAaH<9>^|ZG
z}S8b9h81DBv~EAMLGsih~jX$xNO9h|FZQ}pKltHKN7Le8t~uVS4yMzYzJcS*QudQ!!S3TDnPfxi$
z&At;}a%AZC`|m#?oqNdV^#}1ckG*tteXdyS?~T-Jh*MnQ<;!bZx7v;HOHLVn;Gs8e
z-So)EKK9_Dhl)$zeJVolFMa6_Ur_wx>;2t*U72*c*^pkIEVGhK#=YS{d8&EJ31he3
zx}u>y77C%C1g8lIlQ4&D%4Og%G)~#=!?`W&uNtw2cu~&@?-1gM?4%Yp|7Zu=X(^*`8k^H(%M`;!Fck_+}9DDdD+~E1F2sv_F3PLJmk)^t-~%
zJ(v5GQm5O+T){Qdi-Pide3%cqpWKS8btyBB?DRB7?shd@_&)Aipp{_Z20ne{-Z2QX
z%+9YakYi!JAL5J{c~6HNN$rE;gp03H_7IG_A_rd_uO-Dyz$0=zVasov)n!X>)*WUs+;|OkxGeegEIdoK7Q8u
z=U@1PAAIkcYkru{$P^BIXuan>uYTt{|LMzLzV1_>`PClEnW_AzmChUc`^4~wd^H1%
zo$r^uv~%m$Nmf#fz-`+kCZ=8IUwrX(pZnZrKl=+v6vru7d$D)z7cYG6YhQcqwbx$r
zx!dqZT4asH+^mZae(?17e&7QaTyXKv{%5P@h>AU4%h`UGxwtVGqL8aZ;z22RZqHwU
z3=*L#vw3@L?9<4S)qduOw4U{NfJcO6Q+_g}E^I(Lb$#ZAKUXE}4P>~mdd`(~Cl&~!
zw;);@hJJs^f}Y`KZR?&u1_mj%%jcUMug7EVCSFSd9b>~&uQ{WpBM|TWPocY=66J8`f{84{A+7a}3R`cG|PQ4qhdi7_+@4uq-%io+92}S?zr9Zjt563l|
zd9P1rG4`@kANlS#kHBr((8%U1E?<|Pl70A^&n=60XveSKgqs$0pYOPLf#`OP+_SBx
zGa#IZ0vWQcijTHA1nMAx$kO5Qr6;}Yf40{K%}U4>ij8N}sYGOtAVa$TREO-k5?&x(
zZ+Bz`|E{=J^%Kxl(Qq7pLJydF58&%^+1uTMRdyU3!1
zMgTbK#yFD*LtaRbA%~tk+UK31qFoP}W#`}R4A0;Mr-8=+o}NXJ!H(GD2VY7_h-fb#
zsaQSc*ywj}dfmbWt@4;|mQ9yl>gkCST@rET_~=+X5o6)ORMxqmyOf!<@ka1hM4^br
zZW$7zHWz*TC42uL@_SvLNFq5oJj}$xN(@!7o}M0dx}nTppKX5;{-j?u5taS*#*66W;G@5L5;y%ugvPi?QYt2Q+uKwQ8#8|KsbAwjXVPhV@zGxZBkFO@-CoB4C-k%2<
zyAux4CldqeY%o#jixcKp&9qF@6HTI?$$F^ClF;vx>l3;cjv@l?R*C*$G%VZ2tj4TB
zSE=G9!z(eWjtT7lXYV`!)0Rl)z0wTQ#BF%yz2neDGqM-Q4
zMp0f-gcqa$kVP&+g3s^UU0Z009yRCBS4eH~Z|&Gf)40
zpI?1jI=YRFseFm}VDf(5sO5@k$a~_^-=wn_E?9Ke-FG&`8lBOAxl$oUhpV~1eBLSl
zjZJ3=YgLIOKnE`8^;cZ^i=UtW)AP<9)7IWM(7)vM#XWt!ugsm-6Ym}0In#PLp`_@(T+UaMU`Q4+wd7wWQ?pr<3
z+%b*tvjc;fj)^U@^{gdKZmpQREOU||evBZ4$-utK;=uqoSYKFcSPYSnz8{^;w@c#j+zSCfOJ!Cqq)ES{6^+4S`y*jEY(zUyDTA
z@;Uw27j>Z(J#LbiF|BdNR$DDy`s&yTt<0O#&zSp_gT##KJI{T-@7d>9pL)iY?PJDm
zHTAyV{%XdQt%6f`pEa}bxBq$a%oV-=y!)T4zdUQ|*3-BD&$It{>E+@%=WaPXkh|vc
z&aWJ@GhzHL|KIx`eOlad$KK72O=q9;H(yZfw2PQJIp%hTR6W+#GP$RF=&yf$=%nxL
zjSOzt(ysd-Tz%#_&EqFe+G^}m^H+a;*}PkDSJT?;*YfZ$01c9pA*rgYo&3l>oK0ET
zZA_ecf^GZ}m3Wi0Zi~TGCLF;R-Fi70JmZjKou}U*y%KH678@bd@=_jV?$+405;pL>
zmKbkxP6p$FnKxPti7iGNVN?-PrdXyr@=9LIO1$xinfQKBYwPuqfeciV!GN-_0gMt4
z$m&ZO5b8-m33F
zezNKM#L?{8SM1cISgUrbG%N{k0rXD9MmqDG?`joWCXiL$ND!|WP!
zjKL~HWHy@qUVlxll&mJ2&bmj}eY)a6s#B~@+IRmaUhBo?ksRz=*;y^2lc&XEZYfHV
zRrs)u%@Jh4<@+!XI+tPSsOdJfP#Ny)UOHi1yTco1gn5E3*?2C1M+>K@A<7n2cfe7t
zRqP>8YB(7R289!M%$1sb=e&d_T;drDjmMi4^q0svCd8hn0GQGdAuX#*+C6Diq3htPWIPRG4;r^TM
zy7j^PA0SkU#|M*HRPu#hoaeaYfPe7Jvb;DP(@zvuA>K?<`Uf3!XtTfTCI&mV|%
z5J5g+bE#+j_y;e%_}_m%a$iGZM0zd5M|;PVLb~V;ggb)%T&k8UWgD8p=Hg|I?~zIM
zVRr3%5r2Tw{Lni`5rjrT6te&T_WxuEB6~wRhQlg_=kex@PXO$MN4;ecU(3hT5j=wfjlu
z{^as+f4941{FoPB7T-NJWb^f$cGkq(A6y=cf&*Uo-WgMGyJhjs*NcS<1xv6GdMLu9Xm6Nn@)C(5%wo$6t9?)wV0kkw
zGT0Imqd@93Y^De5CW_oFa+v!d8q%x@=ThG55L-=Z&!yK8>9yKFua@nj5u!K}L`_(C
zhisVasV>zKup{}ZI5=^bz|>@?OTGyA+t)#D<{j^LlK2)L9zE*uvdT0C3of5avWtmE
z#ZFJ|wXDM`rR*6Hz{r=;-`?e~Nxsaj8c)J1G4!fZwMp@io*F`9DU;DF9yZLlfeNY~
zzZ~Lb=f6vqpT(a(T#y0U)pT1pprRII=-TA*L@_Wj*<3KxfTm0U$J&UsvsI5DcU1PA
zmi0K?rHU4g(QTyXAxLP);j0p-*f^D1Z~E|X63H{I^e5Ru
z-Fxr7A9?%<^ie$6;F_BQ40HUUSbulQ9}M}!s$U69PKI^J{U0`kYbV%f`bYbh-PNbh
zPsY16A)pGW2KGx8qhz2d77T7xck6-|Ti@vsuSADAT+^cYX(2E$*%s5bY#kf^_ICna
zPw0+2Z$0hwMgMvFE9p!efuOEbI@c_Z1$N|tN;TgpoMFu(@!4!ahHNp}Wl}&Q
zYe_eLV3R92;Nw5TPAu`x_8Nrb{;{4T!CLd3gf
z>zjRwlGBI?iKdgu8@hIZPEspU<9CkLR>v`ViniLyiL$HSQ%GrE>D(V(C@U+hKEuyd@Ox_ytxH7
zcD}y(=?(bikYiE!R2*Tt4Czi-1ije5Vb^by-N#Qp%TJ5$M28Kohuwv09f#N4`!ePn
zPA4gL2mFxrqz8gwbj=(NB@~WkviX=R>~wkVyzB0*ww{SG-ti}V`<$Pgd+&V@9Cg%J
z8=D&6C7*Z7e`C`rB5(2e{hWiLkX7af9(-_z9d^3pcbER?M?b2oL#T|O4BhQPLBXK3
z@~c+Us(NQv_jT9ZFn_@UQu+smnw#rqZoBPpFO~j-QqKAgqavAVo_x0G^LZ2TR3zkuv%Ke*pL_7hX?BM%k*OW~?OlI=`NQe_
z@?0^8w|j@f=5dB~O~w^dMXZ4Pi)vP{)Y%=H!~oS*c`}TYwVJr^fidA=YpvvWdGo2#
zb4t-G9kf*4nZ8Um<*}ifS8ea_={xqD4?q0qu7zq>tiAo{Z^Zun@3_6zp3l^9P5Z)&
zUrwho#i9}pyX~%cHj}};1rXfO(2&n}8yd<$eyNDLz5}=~m6r`qi|v5kS||234%Ly@
zN^ZFjtmnWdSH40FMHh+~JUegBD}VdH8$&*tk(FHX=5a%!=pLBW(gc)Ytzyj~myr!T
zEOr_?k8sfdb7;EYwr+f^<2Pqtwt+dk%WY_5IE-4QT&UVAxZ*Y7lfcfl;Vanxg`K{*
z-+p@+%evELDufEuT5^?2+3mEb>$~LoN&bl*u{3?x_NKYWu+*R*LR3nB0037@Wn&Qr
zYFQ*%->6O=8-7tNM~E#2>tanl*dp|tw1tjrQ6FD06sw0F;jAQ3Hj^4NCSBj4Mv#Tz
ze>|@G1b!0O+sW5eVev}sol-)$+uiy=!3JUBHcBdm$(EAx2IntVR|-wh0IDTjQBli4
z1w{@)%(Atz;_%viZn&`wy#D|IKmbWZK~z=T6s!-U_&EZOH|PzYiJLxLkU?`>TvAKp
z8Xzx+g-QIlp!;Os%a3lu6N{xkrQq^mBT8kLrja6>$zht|a)!vv=}_;u{kGr!_P3RC
z+2e7YaQtysUv=ftM}0MskUS4->-5q0?Gukb+Sb-KroHvF(@w2cb(gsltYW>bDlF(>
zlwE~5@PPd;x#Xf5)2Ci|;l(%Jc;no;bGhG3&=sExFJ%Z@ByYfHD#}T(7-l78Bg(`4
zYN9Z?x8gTB`T1|%W#00Up5Edo118g_!cWG#wIPhRn(9pDh68BQYns&d#~y;wK4M)m
z`m8AumJ1geMyz^vgFdb4ZJ>K-YhF+(EoHf8mrV6Mdd+K9liBv=z&jw6=&sKG`e#JVkG{>U+F4f5C
zL^=hdHO!Ea%E~@9R}(Ha^pMDrHLsWo1|?=LAg8T`y{68)^V-uJ2aF8yQ}Ma8MC>nB6cv(BO6Y#wVzzWgS)R;)^r
z(WPikmy*wB0>+NxVT`b8>HejcTon1?8Oa5&uG(^n_}{Cy
zi)`y$`ONd>GQMaN$?U=%4&BZ9|^!Zm`|H8?~H+}E;{#<4-91*|zxxKD_>jlrx
zIrQMkzx?IWTW^2p>~q9Z&xpmZ-ZEiQ+n@iu`>Cfqebt|(8`fR-5P!cdQq}(pGylAE
z)hn;aKl1R)?QP<>7rC42gW1Hu%&o-fr!W2eAB0#UW=zGehrgDG^I+D?+AVM?7h)Xh
zi-zX5g$vScxDg%olaa`!LjbS!97q5|mi$9iY`|!(jG4NaFjjndpC*SAx1q}q!2oB_
zV5XuWT6++H4L{()KwYq`;ewoH2qC<-)?_(9_(9n)-Got8M4_B=x|})9J@?hjocW@V
zNkD4@>~e7GT6Jq>{P1ch;#j+Z5B}n{dc8tSW^yBna!90e
z-WbshavJfiGm_KLFir?Rks^wz6zm@tx5T!ZlQOigrBJ5-lp~zyw+u$w>jL17bKh|x5O)=Hh&F{_EYnLGl=f3$zrkm_F
zlP-b}S#Ie!2^7u#f6Kk^_*G}KsH%}rh&zh8oYUdBclPW(cHf1sL^rP#i(|))JLagP
z&im<4?|bmULN@Ef<@m>O4D}C;A3x!a+y1u4?t3m>vZ$q{#pm-AwnTc0Gelx2e$olw
z*?pH?cim~{3opFzMTe$x6Pi{YdFt0oP<8n%h`z&nh*E){otolDshp@;KVIwb1;N+&F$?sUK_4f?ZnOL
z>0gw2x;TDHkix>@)22+Fc>Yf+m;Sbi
zn914vz^bLor)<5|FMk2q(Au|i3wx@tEMBW5eeQaRYex^cD4XBe+QoZ&BasfNf2Syk
z!9jmRQ^?QsTpuTcP{LKi>0oc5>y=_S=x{j=(8wVNb)4|+-5qL=-8QT$dDHPCtPVHJ
zNLAe!>j3yfb{w6d@`0;%)lx?0D~Y28|3H6LWb_0R@&@pio`sv?t{Y6Mx83#PvK4)Z
z$)v&!S^=z2Y^Q3{8NAd*l*H+ccKblD|HvO^J-4w+OL@V_A=hvgAGv|2il(PZ__dj0+a9K148MGs@dCeL})F^h=yuqa1iLMIfbWF0!tIoja-;mTm23YC%o
zO0Ls#?wTJw`SL|tlGr#)^2Yb7-274NH*F_ITk13XchgL^cWOYn=P*G7qtm=LZzNG3
zbR2ItA%*M};Dt;zPx4}e4!Ym&)XKWUB`s7n0-O7MH{NvTv0pzaoh*mKC`QyOC2{7D
zem-^T)RoJ7$4}@m)j~EX?@fDC6QLr7qSzJkVo^6s&h9
zdWUd@p07FAG*4NIt?
z)q!L@7I_DJiLSo%b^xc@P1dFSutqeY%Aj89G}JCb?Nbb*!^oEsbC?wae_k6kq?MXl
zt5l@Yw2#<}0ICWG)vBU0@7~rg8=ass;Yylf520;lR8^OEjN654wLZecR7%NeMc0U<
z;1Vdxu(gqq?Kk_eKe7qLzJkV*)R#Y)&Es=hmud=C8On$D)lEx3x%fcSGpRx_D%?$?
zGAy#gA`o;<-M(?CQ!+L6Y|S5PNM^bwZZ|pJy%ch-0#PJf*`NdFkC2$3XU_d1t
z-!$85ONAD;6aCGOC=3x1WyVbxVr)3I>#V>V`le6weII&r7;Q!$6SS`4!^0CN
zjoV|^tShg)((1_#%6UWHzLED-bpxL5+2{Q5@WYSTWw+h&QS0)kfuQHlS6s8lo_jv<
z(8K@y=RH3={})Feee9yeOX5SB*7n9i9wx6E3i~P=<~BvlQp_sAF~;`Ks*MFBnDdNs
z&a|Mpl9||U^p20=FL=Uw>v`v$XYC`U$^zZ<={;cBguJ2dfo|E&rc3oKp@v6DqS;$-
z^qDCkuIhyPV*s@dYlb35C+$C-lz<$LrA^sP@Dj<
zqIXSZu)M{tvAS(qyfL+}v*M2hGyQ`;mp|h37t%u>+{(m6z?U~_1Hn4aK<}_KLePnF
z+ZY>=-P2@a=*nTX?qUrHmK!^??48S(uV`&;?JPe~j>p}8Kc$RCuryfz;WBMo@z>{a
zF<@kbEc|9TY+AsL&*o~_RSmlZpO8!VT}HrFjks!I(l`9$sRo^fll^ERBT6ZkQShl1
zk5a7j=^y+P@m0Z2c2~}66SS&btJ4}ykt1XzShVWyT{=|XIMuGi
zJf60mHQBmoN9Sv+JYILo5-pnS0Gdm#ukU__ljMrLwlJ3)$l09HYSmNIy#~(qEB10h
ze|<^L;|=DERU&}{uzf^%yY0HVO`(=2n8E{lE9ZBDZ*YuN@Qc)
z(jq2JkdJ+StZe~npsfA6i7$W=QX^NAJti6QFiCjK#R)?+NfGH#1iX^lAz_I5c19r`
zW$~sq;9N5_kI$aXq&z;aqS_yw{YZO9Q(H%)*Y7aJF~UV)Q$;`X?9`rM@sf=p3hoas>DUZhj8qS=>eh~GC8i{)XDag
zUq2a##hM0KP#gfqXV_0h)+93P^a^A~kqT?2ybN|qAXZ3`ioUa=xUfWR6~z?0rHVJ`
z^4bH1Owyx^a7Yx>MGwlEP%K^4M{PKpK|wzf6l%<0=*=aDMcWvp36ZWveNI=dp;725
z9E#feSC^VP*kU>A!Zl2o0?myglfZ9*$CeOXiDW{Lw1vG&N~DdTpA~cs)FM`26NTji
z-B>>n63AH{%s17G__Ehx?XBqnJ=89$gD?)IJbIlfamgr@%E)%Rt*xy-lgUH|`dz^Z
z{D7Yf^g!|UyPiYARHY)lFqU9AR9$LGuSjo9Ue!~{l|fx*>{dy_keHZybv9_2)VbT>
zLk+5KyUh*Pz5;_p;yF+qSQqv34bI~oZ$u{pnHT-%B+wm#1OkGUvmio9snbpPmx@;g
zjFx()CcMm7Y8i(;y7`*0np9RUGqO5#INL{s-jHrFWi8RFvz2QGp@~6O1QL^a3aZni
zWr|u-vOS^^n`j)r@X_Vx{Zw?Xd72L3!!Vk(h3Fd+*Z)nMIwe|7B(XALBuVSI_c|Mf
zOE0+ZzD*2t^&WI^y+hRDwnVQK@X_XG3z{#P<+vll3=|A}qIL-aLvL{r&$w_>cql-G3j-dEU>@
z4TS^KXKXnzIPk6GzWMBPPtV+LnjTzt3)a=E0P{6USxtmbwLHk+t@-9O7lzIn*KUC~aIEZKEi$ubHY%oKi`f8RK
zn#6G}lrjX{V}k09QCTppzmiYE=Xb;=jTu9zBIw{ZHU(xy`-guM&(7l+$r_qy1d%4-F?M;DHs?B<8B4!%l<(=OFr
ziC07gI^aQAhfqeQq5F;8#AbKcIO8Bn#@ATqVE#})C$`}NAo!7X>(`fs<4|IgDiUw-*O
z8e{I9V=lb7`Cs?7j2}CB&8nfl*_&F~v~z&w*D
z`MBXnz=t#0FVG&AP=`#RzA^x-xksihR&UDbZW?gQr2r==W{=V|QbuHolQ!or{xHh^
z;erfv=>g*VY=+xrI8^iFz^jGfQVlmBBv^{>kN}y=S-r?#bG6#Av(&m`7F%Zq_1|v3
z<*2V6UBfIkdM^CUMd$wHJajVRgF~pYLktSJJQwL?it~oO?!C(f
z+k~ABzWTW!Ti(T2GS8&b)Gr#2AdNS4{lNVXIOL#%ONHXa7hZJuR}RCuIQLXFtsz#=
zZ9IGON#9+$e8r&$9}*uLy5sM+cduDPIyJ%vyIx@vTp}bU2EllRK?Z7S&`P~$B0<1c
zrycN3S3~%$F&Rvl_hF2kcg^!HelqY+fS-(aePT2C5t=CMc|*-(55>&EZ#=AhO|8~g
zk|YSI0@i!PmvKpsj#e`D00?sc-!7pApjA~-Nwe$ql+waO
ztQyURwE}ve-k4W<5}@m(L+u7>13z^RpTg8jSGhq7O-z-AHS#Twcom8#+P
z`oaO{IOR}b6hmO^3NAunEZc3mQ%XoxbWIWeSbCtS1Tr*ekgUM`K)01dfWY#q$6G56
zdV+d2R}qNR10CH1IpHnVP0wQH8bwZqX{(r2l^5vINfi~FyJ__rMQz-3O^-K+
zx7a{*Fa^_Yl5o~3uKH57eqh+CHjM8XDmz`1nI$u}6L;RbO!c4=6DyR0|N7U$eZTBP
zXz2-u4OeA2n~2npQEX$X`j}iPShF_{rX8w(Y|Yl#GgMWb_4%@`syM1BTp-zpks|rr
z)DLI7#CkI~g%VB4NkJW@=U9TXGN0jGG4}zQU=q0;aL4DzdRpMa1sRY_oL-nP0{dw`
z66l#1)>nC!Bvl@gbz%0?#&wmdLcNBaPWRwoe94k!?d=`A?z%gPIF|7HgZzY33XjLf
z25Z}Gw+{xxXl!5<$|f7lFN_@^#OrC550FHxRQL_Zq^&#<6Cf-gg^058c%1hR4h|wp
zxa5*cZn)uwfB*a6{Deg-dZ{RpVBu+%2ai5@lfxM(78ywTxpR*__IUj9$KeFjsycwl
z=kaT083zfU10;N8jQngDQUt{A9pd!|qfv?rCMY
zC+C2Y*EB^V`li%itcuJ~TAGt6#=M1#{IN#6*DVnthED~};dkP64S`3g3^FwAQJ-U6
z8(M+TpK!Z>a1}hcn$u&G_m|Q*kTCCu4X1Ly>a7*>2@GWm*_zGo!pkRKpek4=x$T8)
zMW*MlbHKH3aU|ViE9A4aVxf@J6u%qdY~ZE8lqXaW*t%BA7V-rp;6Pe!82G@?%5?I<
zF&6n#W`qk>rBXo2g7i|Ym@MQoiqBo5_y}IGa`M^;OJNiXxq@MqlLxdyvF!0hJ%NVh
zE4o%0e`l$dh{U0m({jz`fV(c;;V8skWtz*ic|_zVTUAbcO>x0z$2`H~*2{fyEN?JQ
ztd{K2=CPtK2#vPmmD{d|o7yUwLIxqf*O5)tJawSCLUt%?k2=|RCVM1N7a^Z(^5kI5
zTUpf&J3-(zeOQyc1b?Vppa3;JlMGDjFse5DxUqw)iUIr#CljhSTGnjIqUcEob^MmO
zrK`QI;pk*9J9h1TVG4&C
zDsa@%BHWx2hU`DdoT=6jUzxpW(q9z0=}TEP7&ZtFr12XchOH#hm~hkLqf-S^%y^I*
zlqFzUN$+Mf&?6on+MvqP`JLzfbohpw)*Sr}3`Jbtz}VvtyZywI*PM5L>aoZBn`i9s
z)a-e=lJoQ*bndeI@;_ZMv~2#Wj>$8Nnp<^=-M-ZD$bUpd(c;L>Ly`L)7KeT9JFM)f
zLb5Ch3zjDLJ7n&*J3M*BkuN^=+^Trm-aKX3t+!fm#Z}9H^rO;`&+Y6T0Gy&zA!Rgj
z9hFRUSwj@rFS#idAJ{NfjZ9pC=;w~;0g`JIYbb)i(9
zot+>Rpa!`CjQ;YMzZ`MI5eFZ9Fi?Y=sU4Y+C)eD}UeKy9DOLm>p5g}Uo=sA(_mK&$
z3dUONCxaq^qTWY7pPWY|L>9QNG^GP9GLi$wq9m79p-up$J*AbQ>*2zJ5
z6$O`@PNNJ&|G3iMp`7`O>!p`hO`5tRd;gwS7YcTrGodYxid^H4`*hKD~Z455xDwHE4qlRK`SRI8b
z_O~fd<3tp8CvFiF$*z)~NDrhi_9<6W!Ld=pD5n74VACE@s%I{YzKn*?Yx^|E=j^;@P!evi9h^VeE&z{g?W3P_lt&$E+%HR
zBekZ?j3sjCrI${bHbvZh7d-h8E5Rj|Ng{J#~Ii8=bsO@SWAZ2))P9t_WA=}
zNZzjrVxXy3R^T20(6PrJd&()N9Dn@rzxvg$00h#^ue%$r2KN9*puXT9m>Foy!3zO@
zbaZs^Q-6OybQ)^C+itr7T)y0&~QdN+>vO_-LAW0s|H11!WAC3Wmk{B;I+(p?|*G!CS8f-
zMMJh4Ua_W}t3^v{qvCD;xYE~KPQ^W5Q<|sF*c+@RG*9a`JA*HBi5x-|bE_xOn7QK6
zdc=@0+YqihePiw!&Gp@~MAOlxDr*=$rh8vs_LFndOIHo#(|V{8ALPi0yaya&*nEw}
z#IV2FQNmw$THr^riuOfDa6_(7S1mmBxoI~?!MyXwbc1qXj3R5#|KyI%j<&qQ};s#?g#wx1eoz?+j;GgyObqJ%_v
zr@A$LBC)1CygZ3-ccbR4X%c!0S3vQg80JJoiEuy;jdc;lXLP4akHfg)W6nSLIdr__
zXGjsbUQ^vt*yT$OqVVf!YnqI$b!%Hx)785AaktzirfoIdQ0)gEwExxDh%pn!FIlnj
ziT@C*VZ7=L?7GLED^{Vs)L?gea%GXp0*6TM2QkmlNAEax?3O2-wC|mF(N|IlgB~+?4kjd$r5$0g
zZKBoVGn$RH#n_B153R*rHx&S9Abq&~_S=8|``>T9_14YJ&Cu-UpMU=3lTY4en{9U8
zbywiU*s){b96*U>l*ot-A^@L*!?JzYB&`4)UA%ZP;tyT{p@owHXaHm!cGzJLKm0JI
z!a5v0#IIJdmn>N_ZrnID@Oe8>!xFDp)uEgK6dnhEz>@${oORY&M;>`(dwcuRrAy(9
z?7Z{NNPNg}ExfR*U?B|Z#aDi^5U#bjIo@
z)BxjJ!R0Lq&-iNfwM0LH6?cCk)6!7q@-_Jb?rf^BB6{n_Moaww4wtKS!peEij^C+m
z)x7Sp6ZfufderWzUpQysgo$m=V5Ly%8_tWzpB9T=7dy}L+v6o)$X`<&@w9Q>4Px;C
zDgx_3=Hbirq2|a;lbe^7#Mn9^J4(xusiG?
z%p}b@H#+Yu!H}GOreNVCo`)ar>!`crWQ=w*XhX`6m_#bt!No!iH!TefExk#9HeGe<
z8sKdD&bxFjUepk-tBZ-LTigJX8qN@d<<kt>^Zm^6v;#u=1FoWr7ekEKq>ra@ju?S+W0LUPPbZ9oq6nC|9VeP4@II3@G!WCHJU&3TGNC%811u~rnXohf9OOVnNbl90Ig?d`Tlqg#(V
z{MEjP#L$4KZ)|t%x2F7%80=@2omO|iYm5H6{~)W+W2WZ_bh+W;SDCU_Rd}rZ5kVGi83!1Eq<}C
zMKpH=bH&Uy+ll|qS-#JKGtz~U*Bg8Cp(WF&i={&VhN;P};Yf6>quE&~l~%kIpD=NP
z*EyIP$O|U=uldffPpkFCsD}>rw6~z`stbFYityaqAQ^N`I>~s64)5(U|
zI9+5zZH2)#eTZ9cyLHyKdrV)x;J-e<*XIcp^HMdfp}tkbHM_09wLW=*m^?9Z_#rzSbM(UtUY@_@7Be!ryD=haZSByF;ZW!`bc4vp>Zp0%{`TMo|c02pB=hxv)4ZXnKMS
ztZRyj_i=vZSr7)ri^XE#3F=7jcMd?tsi&UGJ*bh+m@$Kj&>Eb
zse6@DL;bmKQS;avzQ7*t)s_7Mla2reugaQST%_~Dw-xI5uMZ6W;a9)RRKz{^CwsCO
zuiD>!e`h9+FDFOi7kKrY<%5#f@7o#!)Q>BD{pHjuL*<3EPB~RYCkXQ@hX*wUJ=PR8
z!yihbV;(f0Nod#Z5l!4Ce_|s*gDS?fEvJd>;%eEC!YrJd#Y?)ko>Uj{D5}r3Ady(I
zGTt$M*Oy+s((Nmq_mlYQWg;99haN7@zG$CRSLfA#ne+IgV)+WuGDiITH)5Nu#-{sS
zu_kfjEstFK2WfhG#Z~rDOVu51MNjuzCmjFtU;TCOg9F8Ku~rFQd#yP4XZzl8*Tao<
zUoLb#|ID2KT=%cy3v(sQ|FVnqUAFbtb!@-$mQS2|YW$i%uGoGX@xybS;XsFi+mdP?
z8(Otw63NvzZ{Ft%Ru#<)
zVOiG<?
z)n<@e3tm9yU>m?%fF$!1q@DYr!rOJ4z93W%=7s{n{lS~NW=9>9W%P*e&Ji-K|@3?hZhdECMoq#t+Oafcs%`2YUz
z{~mJ4A;@T`H93$u)!_hSe24?*y|SiNsRgyO{A5rz+8pit@h|DY#-b3tsI>3hBU^0FWNXx_KJ+f&i2ci$sUIi+QfJ+@o0=;ng{H0@#nEIE?7aw|HOE{1!q?a4GRJJA1;JoY-@x7DgrV?{c|AFZ0WFQVtm^P74
zoVlI-YezoO)FAG>YerQYkjho2pk$=9R+$+hqosehdVc=fJGa1Q4>I5ZK)0Z&oFQy$
zx9^sIgO$iNEdas*QgA=lY^<$2t*_ALcWxqPi46@+2qdf#kP6HXp0$Xj#YExPhK2@m
zKuYrDlTTt#vCA&IAkm;afCB^{6aZwv4Lk+8<;+*kfCej(vjsb>Y_07+*VK#GabfW`
zxBx={FDMe3bHP(6YH;uqnxPn>?7sW%yxn>)H}Gn5uuNfjX6W0$gdofhdlYp
z0jA-N*7XNGzr{}mx#1^+HvE9ue*BNK^ze}c#S*czZt?{l63%=m9lqmjiX2WJK#1Mx
zmxM)*IN=CM<31rn&&U*RQSl&yeUPKto9ut_wU-`$;jwFPx$fmx=E9U>Tjh#4!DFd%
zD(VX(F9tDUp-K)`KGwCB^T(CGo_e`(-4bOm88x<-HXMU$hKSWia9&}KDp_CIT%)^u
zxaU%#L3&O!iIKdPjbvfvSj>^`?yjrbQi#sypFbhh^TOD1o_Mj(ZXdJr)-Mz*gAD=k
z;KP%1DZk63@4n|wx^14#r4>?%#y0WLqrEL1j_F%ZzwbWL-<#=Zc44dXos*}Rw8~C9
z@1xqTS45-N>#XYWVx@503Ca`y>8Y=u^ys5qhaV$Kw*PpdqM*;M52kMZ`#5K8Tz_);
z%pJz*j^|v#A-m0%H^h&A_GM3C$xcn7v(8VS`TZ%{VBF#JIK9zyzLHF`FE=YXa*`cx
z9t@bzpn#w5#t(|*?MVI~s+1-=_Y*12s6O&|JE9Qb%#^EXhr9aR^YyAa#BJ4qdD~8J
zxa|f%+Br7+fNo3LDh|C;8q?&u`T9w=npb)nwWW1i4v)Dny-+9g*L|$7waiN|1cZ_h
z`YV2K<4Z405YCk-P3`qX?_Rs1d+ewgoI1V>T3xn%N9t&qMd6K-|4Bhr-Ms?0vr~e0G*H(
zJPFQ_XXrYQK*dqSLzV%}{?niS^wXdI^rVwcBHc>l!eX(!J@ZYQ0)}|>(MJ)ToO$M%
zsDJ<_s4r!+AP&FsIy6r?!&I=eLqJQ^#ljZc%wetaAG~0oBC@68yvTwVp9Vh}EI2fc
zTq~`m$D$vYL4((+~rz1g_X;F?i`eHDrZ|L20=9dy|K
zIEp;+)Z;I^;?kRMyqS0(b*?(dvD2rPb*ZXsij2)CKhY=r8A;EN)?pzFuBD(rItisk
zr1kF`H89)E{3@}4pZyjWbZ6Jvlt6>FGOf
zU%Kq|xl0#ItY@P0$S;4@{`-sPpL9~E)75#;-P>=y)efD@`oPs*kJ8xOvh0<9T&xx|
zXkuxRFdOCK_S??*=C|e_cTDh}d&JGRV0D|$6@)KX(<-Uqc>nD;uX=rjSTtYKn_MAZ
z#sJwZ+yQ!+P#h(|U$L0S5gUJmqinZF;iXn8qfM}`NM8yI-dfFdtNbawrdz6*c8MEDGJ0kq)_WCxRL^Tn8GJ3x2ny&8EU51$v_i6P)3A4Nq7Zsd=rKdllT_
z+obCO2}I16wSf$IoNUz+A}fNb0B~q=Grh=bs){QZs7qu9-ENQcm_jt-zIan(s7jn-
z(_ocSQ3hE6G6EaPl9=|lpVGehXsWf&g#Tz>_))!uWtmr@a>%X-QVO+$d|HHdqly5$
z;C>JW00Mph0uH{C8)6GCAmq6Af}H?$#~%i3-2M08j}iuSo!0?75E;NcfQhnEFMS_3
z!<>MdGJE!H3{QCD_SDvPJHBl0t8Bv*0+9YqFAZr%GE4C
z-SoF>Pdeo|E>8a5@&CH_4o&3k@VP{Zd$`~%y;r?0hfiP%dr6Cs%Cnq*W?PwU#)8jh
z)cKxVcAz`f$GmNn`f?jg4MJurc+LP#hHL)qRK&Q}iRFUQ5D}>%FmmX^3o1yZ_MJ85|E@cO
zAV|^3_BO3mdUqIh4fR1hBLQ~K)XHTy5EWIBgep#_T{_zR{8-xpa$dkXH64YT78@q&
zlw-rD6ck&IkpePMzzQZ@7<~>0X9VQsW3hi&Z%ahN5(@rkadDIrigaEF(@bIlkO3n|
zdOS0)<=iXT}`)DdDQ5f}h1=O$@{;&rCAJB3##5u>TS+g#<
z-~#XjEECeZR{;GbI7Ra03p|tP6@^iD};DsZaP%BXm*n`|+wEjV&bu12;Z$
z%S72(D&efsh82lI%(aiD%G_M>)0;jtd`;8q!wru=`GnW)o3-nn?2S6d8KJUU=m@-h8mp<606D2+61%r
z<*$-6R5M&o+hF&wm%syfs&;DS(x5{r_?-@=T*g_r-6#iL!KJT>FKiv&f1fXX_xPKO
zSrPWe+8W2~y4@WwKL4cG>A)o;af<_f!{;Rso0vGJH4<`<8|zIZMSDxQluy#EiO%^`
zCbWO^>*61`i&IY$00pg3LUYsO06BPHeOXMOHtwMP54ie@Yly*79F{R^@azA;eUC?j
z?f3kvf4}{Nmyk7t|As)q2Q=_j3IL@J=9#+73pqGGs|OZXl7lrut!WwAHj<#zDyDmW
zQxk#~GW}q^(Ms_Dr1`7qV?(wlBZ;r_HXPy0k9Exhj4wXSJhGJ>2n!`}&1dviuFXy`
zDw(^lxR=pf8So_gvj%w@q7Fb}wa
z*FjJ%l8@#iKxd;~`aW*9+>pac0p*|%F?Q@&)IvcI*t6hQ6mOxp5T$rlJ77agy=V%JKX!#gH=hADq^sE@UPc5|G%FV
zjy`<$FV8oA_5X;|5?`_S*^U+w@9Q4wS)o-Hd)%VGXO33v4f%y?q+WdHi6ai#31!m#
z_8Swd_v%`vToPl);_Auyi=T_Du3oj>_Lns_R|7%hjO=|ixEDi1#V^fz^_eHdA%}q9
z&5(GILnppZutjG_PG!s*$y$Ae5Be9j&svvO7Ri=fPOJ$N3UDFgPDp-(WJ0VxM2)t-CqN#?){I0R$Hi~-hImK5L;00+d?I&ai_
z-^b0o2sFbPeF)IQ^5x4>A>`tP7hXV7;|pK-0*V^=KShXR`2n+DL1`^!4+sD(^*-La
z-bdEriBFTC43pfImO%A5#y*Tgp
z7yh1n1AyRS_0R(j{m!?(vwB(A*a>6cKGl$u=%RwNZeo&t;*XIfnHG^D`>3|8IgKEJ
zhxHq0bBIYogZ_%V!6}_|$(FMApi*1{C_yi_oHIflQIRj5d=iu(=L#xX(n#ipad-B_
z?5QY3Eq!I~e*4VWZsx#+f1I4}FMavTH6n1~IJfL8J^SpW#E>5F6F{WPCq4a@o;r+;^{NYwnDO7{wj+AO7d8+WGSrygGa83QKGG-tX3y|;)phUd(NFwCYe^>EsU-1CVje!Q&hC#&@}y+<;|P
z#c3bj!p)TJT^`viev&vt(oc&(vLuMzGkvDmFU1`qP75j<}r<{dseo$j)~USF=SGyWHjV9
z_gG{Bpf+j09B$-JP0LTxQ>=BLm6OxB1dpIJSKtEpMCb(Km6ejc(B0XCY%fe
zC@?eNYH)^*77M7p<9>=Lm!3kU>JNH!R+EbE(~1jUhtqxIUvKPOxsqUUvAWpx*Ih^SSAYmI
z62iLDq%lAz19t%%VDeZ
zq|q0$I|_EfiVqtqkpPM!8WY9&^YFCl>R(hSi^f*+H%jp(*pImU&TOg@7$*`dh2NKO
zdR^tbaQQ^o=^9)%Hyn;QTr&2$;uPU}p=AgJ-{*GQJl=|Ld~;&uyl@2Vz-mLYZ{YQL
z6Wg(AiTAu#ZJjO};iqJmPMH)kioLlN=`qd1t@OcM$@gK+T5>?{u%^udEp){}oHU1O
zXfhfywU9QtSm+i_nSjapHz&_0vF|phOx9>-;>$71tVEp_us|o$gUq_3(ISj~2CJ^9
zWy4Fi(@XLhg;kNUjg}>gHk&bqJDN<)V!yc#qZ}>QbweR;S<0N|jix^t_9S>B=gy)q
zu;XKbHOmLFdSzKK2bGyQFW}`)`4-7Rq%g>6a5%(|7XQyODaHnf{h}Uh8H3Zr+pF3rr(95E@KZ(g
z>m?bL%F7sIT*zwJWZTfR6;UqfE;li_lMc-3wN*AJ9!(_3fZKp9BFJ#Fx?=QTlvv}Hos
zRIkr2@Mejh6HqM+NX3~)87VdE`qNWdTb3K?LGnYdx(?JzzJ#jg}IHYGH+06!Y`7aL6f
zI0C)%pal3M2XCaBz(b5{845fHl)~7=1!mG}o~m9~R_I!}bjvmE^#*PhTE0+ngxs~-8mZ>bp}CaWSVXwO-Y04WQS%8%spt|$!Dh7ETroNN
zt3{i=23dUhg$IBB^Pk)8jywN;@r;=mKdn@1x_BjvgVREOKs+!7`ho07Zsre9p~r|e<`6fGG;{*SyHBsu)Y%&Kb4ZSXRlbF8pw9Wzjdd?ae+m?>FVj)^j7<
zck>JUu(gMo{!V#g?Qr!qf7xsAFKJjZ*c1;l1l&_asW5;rYrg~bzvZ@D_t|e>66+fq
z;FBSPTbuDG{z8uDH!5zm2PuynS2^xCi4dxb>
zn>20R$EDQIBuv;TK#PjN5Q3=L%ehS1Qz!tm&3!$rK7)-599rBkNJt}P1d?QK_6O6)
z>f=#Y6f~U%P2X+Sg_!oU5CO%c2NB#@n55eTK6HH!@!MHJgJ^qD6v^PeTW9(h>S0gAAn#0z@N16l)VE#F`@_J#0=tHvFnM{uJkK
zdvE{JocT9jlS?Kf-f&e
zV$VJHnDgS2o38Cof@B;L)s%9)H#%#diF4-6`Rlc{Ln`B=6VW#79#@Y;s&gCnvxbpOyZ+=Mf8VphA7TL5o`@BHwn9$N?
z-T%B>^z=$}!X)ARwIjv%PCIhK*!e!Uc;UHu2kiUB;kc~Ag%?kS4e{D5i|@U^GCUx+
zEacDm;)}L+dK|C4I{)4W%yiz(;w;1^7j5lvuaiD{|1W>BMRRNW{CTgWU$1^~!cGLm
zhDE_t{LLlXIX$*lUwi5P`^6A=%nC22h~Hk?=5|J2eNn&v{)Gc{7BwTNw;?Y2-BkD-
z^IutU|GgC=i;Wx#<=oosQRgps<^KD0nQkrvl;`&s&v1M7SLQFo)#E_FOlMq?8A6G3
z&OPb&d#^>wvQQN1q7iXRn?##rJjey}BRreqU(b^ZWF4@e8e?<*VozLx0g&onHjv)fiVJL5~Ie7lCmqqijoKT!>_hnCa`68
zIN5=$gXBhYm!hQ_VFJr&P^o1Z=(t?2x+{QEIA`lQEK$^Yet3r@Cu_~y54mHmN}E+6
zA~uztnp<%M>tMxkD;szwo4KK?Ho&-&gqGXoip!tP^N{+y<_?GAOHPAaeyl2CS(D6k
z3tLGqr)*)DAT*DknT4bS5fsvAlbf~qo!Ot@kOOvyRZZ3s#v{Ye(Y>m>zNLc|BwxsS
zyg^e7rxKy!n{D5Icq8)tN4T&QA=j!yuD6I-sZ~S)B?zOGiF!MpeB{`$FVWf%)~bd6
zp)NbdVoIJ+9s%bTu}~{^j*0jHYXnY$btO@$rv1KPG}59K1M#7JRnyJ%R7Fes{lRFs
zRV(>ZgK@hyLMS%x6Tu-XCDC%0~lS`5bEmb3g$g_KHGNYPyXbnW0O`K&L<V<6_lbC;3M3^%tl
z)N0!BaMDc2LQIN_O3A^NCfeLUEP^`+mq$v46xEi?hFxTHPrM1j?dY^yWE(W;qqBa7nU|Qjjt8P$4U3Ba3grqnr$|FCcCP&C0f&*!|@#V
zyAiOnVyV@1w!gV0Hd-DJ07d8?Rn>CY6)i1cycxuYO1QYD>)|Bva<{{lE)0~EgyNcZ
z!2b6x?$L@$vREmHob`(2hafTs;hAhM03R{D6F7`p__YjW;onm4L
zQ!?~{J{sNOkGd5k`(5sL5kUbSa4+`D^G~?^54WEB9dYK#J9(58h)iT|<<$^L~8JxxXXKy#po(TMd&UlYtcUtjqc`3-|s`)RavN
z8rBRLu33m!m)2^#za>x7S)jO++pIG!W-V)PxzqYehE~ozXyr`G|7Y(!;OwgE#D8Az
zb>7UImYF1zLP7~$iU^A+B8nn{uB?h+UmNy}yZ`U+-kAUa76MF)oAbFjxpUsR=brmJ<@YgzTom>_1T_dIN7W%t8PG(?7YP$mdqWh0-y5HQ%k#_0U?#E%YzVXL_4mGG@sdHK
zQ5h*^*G*4PEjuisw<`^!rlDk!D^E>(f55z#y99p$hoyzJs&rC-8+(B<;y)>V>t0&=e
z+GbWP2^7maYnc-I51o)5U1P2#?h@kcL
zQpt%jDH>LzJGBa=UMIV3g@|-sZ#C5nK(l4H+3d~kpvUVE*DB+sa>MCW0X3y(rfm9n
zPskI9rAoDYsXFX-L4(XRvhcsX$xtxhi%WmXImEpITcMF-iOuz=G*+tAT^?J&p3?FH
zoUVx9@9V3Sc9cs+r`uV~)%q6o>=@r>wEfvhz*fyojra5on5*^qucN(gfe?BZU33wT
zL18erEolg>3mnK&i0#sgUi2dP91t1YLl^G#3l4?{n9Iy$ycO6@vO$)Uxkb0_zCy)S
zccAEGcUh-r#1qKkiMNS3R7CrGrgTw90)o91dB9$4*jt(t&SHg7KXTw^$viPHRP%e3
zJh{%}ON1fv#1{CKb=@NN3{PQzVorpV({`rF(m||
zDJm-EvZZRJx35oTfhjs8#C)}q5BR7rU^$d_LtvgaFKiEVED&0Dm-EUiJ~laWwZ}FZ
z^43=@byRZca$P|Jb|%^qr#aKos%b~9*{D_^Js=ZfT`HDzsC=th%G(;HdZh)ITgsDM
zK9#RkODRLk;5M;VQGO2;b3D)+3>53_$|P!ql{^8nmFf*dONKL6?-=Y-uoT80_G+$b
zO-HT~>*|PghE%ach-W)TMLo-zN80an#5w{h+pd>0_F5+CZ=^D{hD{~8qJY8oqha=I}nzZKZhy{~gl~4P_h${@`H3IFbiYR}f;9r2skab(Cc-z?CpA^J5vZ$
zY5}LW49`Lq>F&$qWb6gY^6C1qzsunZGElpF!H8K25(>@hxTssnZlh<>t2R6+J>en?
zBGMGO9&|ZGt&M;bAH}g=271i-*A{0w7Gb@#%-qJlD7XcdZ87Djcq4Y!u%rB9F
z9fZ#puNG!(mBP=izUHjcjGiS6Yf~H1k_vP>1C^#$Q;jL*ZjRV&K{pD6ey86Z@mKSD
zRcX^G5Vg=D0-Gqe7h{h=8BA`NyCZO#xua!lC*UOy_R
z4x^aw>_vgPRUNCf+O<$j$kgIYGrZUnpgysuX9!q;(kbDWP|EOhd+b^}B?q&1HBJ;^
zwjt%*x^r}B!2r`w=BG?pnX;@;bGklpK%U_*p`(RTHXjyiQekFrq%fy;8-fhwl4-xM
z(x{X$z!J*}wBf>7V{l@|f(E0EARGmhuKSX(_}Yz`6bfm+ctAMv1w_lu+D_f)R~@KM
zqB!S|1}YUjj|xMzHihksRgRXeKTy{6Y*Q7p)w-1XS#Dkr$4q;r(#+M3TF&NiRW-Of
z2-6FQ%l(i5m<6E*F+A?_DHL)=jTal=O0Au*t9-68BbqcF5xWp>5qAjbP8JqqwlOW`
zagGO+6G^>NY3D1dP|}z-eydzG{{1f6A!uo(MIde{McN061R^pRGR8NM7tVXDVGR6;(KrMRq1M%9E0=W6iV|i4l2nZ8S)1E|$NuwjQJ`cEc{y=ikaG0qYuCbks^_emFWf-TV8g61G1yAft2O@+w@YVttC
zCw?_eKb#VH3`x`MUT5ui2TRWJ2;2kr25Liy471;oVZWCtLT?~<=C4>dTCGV07CE$d
z*m@47CqQ6+i42Y!GnryfBB4UI&wt_0*Q|c2(k8Phqi>PFK3esL2{I`PQ%Zx&*;IN#
zr44S~VdVk?Vl==Z1RPq&imZZm1H;~+?q;n7bKUPR^2_hd_EKn
z4lNpx)0agK%TDv0`DtuYCKFQLXC~RnWY2Bn3Z4!JMpRgRMEt&5p%N!_lfzc4NOU+<
zF#;fbm`b^{-e|gsw$Q4!izU%;;OLKCaa+L3oE4%B6_P?2_&=ww4>Hkyre(TU-a2M<)Tn5CSaYfUXxcjoF?y-0n;PUKhvA;d~4
zXSTAt97RHf*J*}xhB^g@+cdgi_&Po1nUXi`T)Je%=dQSd@6F_zar}Do?iWZ#ZVkw@
z%#phx9Ds)41|9}n4U|-tFJEqn%rPh7sLiiXAy6AQum>AI%a#wOYU0lZEoG*#tbeh2
zbcZ-8Z{MjluOEj>wq`kB-o~m`81=Hxb3Hjx$T}eL2ySA^EMc>zp`MzUVEXJ;f0aZUofGKSXNGJ9{$9Q-4&A|)b@
zu&2;>VFP7Pn%kBS_;K8q9h_gFz*!0>!qsNo&mwfFOt#n^clY#k*HS4Ts}mw2(}p*o
z(3gQ#kTv|vz0UDE1}2z7s{Vd$`zZ4ho|~PxhO%pb67Z-|CpbAK_GkgR!%nx|K0I6)
z9Q1{)JSiM;S#8wMK^_I>J`S
z)q_Dt1^0TelYEYH1}zpON}Mk390)LP3prGMQu8k9aCob#SW_X9ZU7o^h#R9)6aZm+
z2LgH?;s|9xhdmssPv^a1zdPtcOUK^PUD`es>W|v-LL!Vyh!7|Y?02~(;F0bG4)ouy
zdGKXm8I;070hhHf6LpoF?QEg&AHVqC2S0UYN3VxD1yQn>WALm8>wm1c`(%t*1Y!c(
z0*(cg1nL*$mWl>9mNw{LCxs#KX^SExvFsf-uiG)1oj&2jlfU=zUf#zrQmfMVFSX!c_c36B*?pWKVt{I|YePHowC<;tSIdojJ1@jcxpk
zEQ}(Rb-GYaaX7GqKVT9=k1N7VHbWo?)|$)ds&hPLgBLCKJrlZwkWg$~<|aG)E7MMr
z`JWSQFDJqLR5%bL_qcJ_bSUi!f%&yAL05}2vfHNl+B1XkMYsL#)b7A!B{kO7n{1?J
z@Q&$I2x)%pa+Rv;>bH+=YljK7=U~)r7(B32&^AYfUvJ>)FHxIFW0&t)
zkkE27c=zd85FzaL@JMapix-vF59c$+g2kvHxLQ*M2dDL9k2XF@7-v67uA#e=o!WFt
zi1)VQ$P({@6<}0yRV-#Z2I2&v#v(q^eat^!Re#^t{-B%zO?M)psOhG5n;?4}!q8tI
z_z}|^T7ju*9S-&!nWy}lN6<3hb5L?%<_om}DIp#LgmQ9a7I+eWx%1S{@Fuq{1FqIH
z6~qD}69qzGaOz0cNx}^hFMK{#m=KqU-VWFH4f?0Ik6!99mCGLpsRI&50h@(=_s+GjiL#nvl6IZ#k7K?bW?+7Q71RM$XbXBG%;U#!to<@Q2
zr{b9hf6UOxh~B$H4!!0HVw_;F)kktTG=e9g%I$u(6g*|)qpx68wW`}x-hfFjLKfTw
zqNZ7GJIh&wEFGO}6V9E}g>W~j7WC1z;HX~C+USkpj!Q4L^V`S65fxb2pV=}-`^D*0
zI2lLVhm(`1FOc3blUOkra1|UCR4WPdEGr8(+L>p*R4hx7A3I#Qm4w`}_DT-(%v(^K
z1E1&|?nPnV+>@U5Xqt;xUSh6uYc}t0!SR9jFU1hUXuDzjxav(;z}GZt^onGz44#uY
z%0j`_9-NE-F1t_(aJVMN^`TP_FAVR93?)=H?N3BTw$Jo*N2=qypzD+$hl&UuS|9)r
zH;emnTdef<51HNWOk0kK+?Cx2tmkP~j&tR!E!p_!@OdWTsj(|Pj+O;i1e3(`t
z+k495_GETod1tesx%vh?Gh-610LP}$P^)OdgxHS)BEn}hA>w3XVDz<&-NWIyK9&;E
z51t6?&87=vV}eBbcPQ;^2%tXUbJ#o$9cwSn5fUND>vUo8Y-kPelXOQG2rGp!7Ghw+
zs0st?Ny!z6P8G88SQp%>pZ@B<&bi>iaA)s(Kk~_M{huFw_q*TKWaTRqy0CSF1I}Aq
zVjuB*6Rt1_lmS_U8Me$KE_MJKwy9{u^pF7u4Q6W7ZMSu@ABk6fi@WxG-#qWnL%RSa
z9JJsX4z774i;yIXYgk+AZ$bwADk^)K@Y!Qt~k~-!DF#kG~
zJqCgK9e&`Bv)x9shEM8n6qb0w<*j!led(#RLKl%UK)L4eJBwA@wg3**Sa>)wH;Bc$`u%}8Y)P5izCasipgx%Xq3H=^76Hyeg(+Ha
zDEyUU3FmW#@s1I6+8{ANGbrqAOWVEfj-?Co<>pjYV?i7RW6{9^-0TS9TOxwfB&<9)Z%21;B~yS`Q>nHPKVc^7BiME#5$H(7V$tfjKq?S)+oCb8sv08&
z)iA#b7iw~hv$rx@WriErN&Xhb@h!-WHMt@zRv#byJ|!wDHij@
zJd(qQT{kZYj$^`Fh5FRwxPes2<}iaq+flutF_;{3u053Y4+Lb7#_$x`Cm}z~gkaGQ
zmyN}a88wmy;z%Gd<$yxy%#w1T5(RONm;601W^_7}BQMpeU%cY;pSj|56Emsz{{8!}
z`_&CzcK{rSMpn=t(U?{4fD0vayXW~|Vqgnz5;2ZbTzyyefTDbOF?yVe=3GoPpfiF1AM+@YVRp0l3auX%U8GZgR|^;RL54u%oU3TrHyfW2gX*B&{R$Rg*LFETIrI;kh$OJ+WD
zD0?Od%=3(wKo1^gi}S4eJ(u-pl}r?&l~EP#KRp-20cer4g>SXGt+`(xn}EQG
z)^m7248QMv{Nx$kKHj+?kxRo_=csDqyn`((*sfM<;l{O+EjgT>BO9jC@Eus3RE~&V
zQxP~2=@uS54Gp@$)5N$EgR(NJ&v*$}9SdXlDlbmt!qGSew1(Z))4yu{hBPveaCD)e
z67PIh3Ev&bUh!GShA=T%k0hKYpH`1|MS?v&>B;nxV+ZO@!|e;er%$dp!tIM}d}z$(
z2z7K0`nwm~?S8#s|Bq|7DNW*Z(`_tcWE2FyGi4!)bv!9EK}CciGj%V9fXeV5aULa}
z#LX!VMb1*D4V$x7&rSdA+J7%q@=mWyMZ!LOd7_in_S>6Yd&_U*hJg_8dxTMTv`R*D
zFw$uF@+p-q1PNaDhBwYUv_9WIcvydbY~sO{c|3Gx72Ag_D-`t2|Vg5BP(4zy#?$H8#L;S_6tc3Dn)!TxA4?&)0;
z^#!8&QWNj1@nj^{--+OsN)j~A^;
ze8^w;wOS@d5o1o|oYwQdTFts%h;KQi|1VItRLhsC
zZ+=5{#E(o(*Nv99kkfY!b29f03>>Z^Jsb$IGjQ1bHY30l4E4r)m*A|kg=&H;`L_3_
zYweD5Gj#9m6E<&Wi2ybjmiQC4K(`9^IfK2p6x`VwVuc1lV{x!=L=j-Ti~zwMMZtm2wc4j2Lf3N`xqp+@wp`
z_C)-Mzz30mzuv$rnLXLH-9a`@ruM?Wr?GDLpyc6JN|{atW+U5+S0zp|N{*Ow4M
zOv@V##9}>z9i0PiXQ)&)Dixb6Ht@;|>*l{Y;)x|*Z)|k5P|G%b{{Hh`g%U}!x0fh0(RaT6kry5B`RPxV
zZ+PUyuYc3OVukwLXLhlNVTIc_m>eA~&y1(h2;DWBuT~t1!6PrexSHr&zT?qREL+VZ
zl{jHExAnPIZ>Z83wmu@zF`6iEuunn)BB+7cGQUe;@5c9kVQmxq%t)=(te|LR=+%~9
zBKDp;;2_YTJ7jZ(oUWkDfkF_}y4MS}>oiG{C+4Y{2~M1idih&l|JwWB{SIzABVo=m
zU-`n9zWn(s!SbEaFm_cTpBNN*9X6kf_3?Z!4<@&8Gwkr-?I;eyx|1Axcno9gHJd|>
zu(+6FNGbJJi?Cs`_78@HHU{0q01ACiw2#q5hM2&V8nSNo(luPS6F-sgkX*Wk6J-c^
zn_LaMc@fSKXJzQXK+r)l9uPSjrxOqHOac@t&?CV+F-l`No#h@9Vb7eABN#nVu6*S7
zmdD<9*$Eyg=5tS_OLvIKc&fR*_w4$oYUSz5WXKxWwj=!x{PCu{E;ujIDC7uREjSWo
z4V1(kk+H4F{nhur^X_wB{V&CI-0w~LqA>y_^>>fk+mT`_pV_`?(Ga$L>1d?W?o4D-
zwOpzgir75?f)52Ii|&z}8Y_C19`T|D4p+`-+PonSyA@a$HAkaDJjYfj;*SOVO`E&a
zY6XpeH_*Fe(L$qP#6tanNbkBeQ`ka2vM%FvxRT+1P_xI;UCe9``aH-bx8FP5kqGxK
zI&5P5&RE}JjdYnvC^{(V%ht036X}1giQtV_zF%}*J
z$qbp!|Bx4!t^m43Ap7Tl-Ylk_oFrg`=t4FCN^z4Y$25Br1vGJh|M;>(qqwjG$n>7tDB<8R)^sK?>o*M|}oX`)38NE+z
z5LlS#Mk_mES2fYOG6Du&7D;8R?Z^+Zdlye|Z
z7$-cZ>gWv$IyY4NQZhqx!cV70M?SH;2Wi
z=WgU1Kv-6K{C^
zU*PUt{Dw90NLV$UwVEO%Ea#JSzTpanhlV)+dR}zYCSRaGH<7yG_rq^`OZxDm*1!4E
z@jGw5JKEjxH!t6evdGKM-ZVWu;`X*Wq7e-vTt3-pw3}^CHh75$!w(iiH`#^E|1Aw=
zfy{HClx7?3Y1XvI2DqG>92`_zw{G?LJp+s6=T-@waQM++S&T{8v&|(z4o_2JvS6DN
zuT}Nm{(AG~jkr{@BQ$ZeIfz^_Y{^z@j<*to385seGe)@!KY@`tf~#|FP@?Ywx?`zKw6X
zbo}U(H@@yITYrB2uGA!v-<{Jl&2N2s>Wr6eegEGNPfpY}Zrb*SH*KGsQ5RnLU^v``
zW?X-t`llcKODl>d;-FExJ=}jZWg0~|v_}+It`ifWOzwm|8t&fb1jPE$*
zjJr@WeZ{Lr9d5_;*eLL1C$|7??r`P|HAgS~B%Gxq11J0t)!T|&J>
z9Jh$HK#aAeYeY~n7q=PQL{?wJWyk3Z#LvNz0Mz8T^t|s1eP)Eb4h7z5cjW(ei4v?HF#iYZ5LM$qJ7*msJ
z)OIm55hV4LmqldkCN-!-GKZF}X6}NTd<>W-23(Kms0g?L1nM}hWh)D2d=xN?`q)(`_B$$W+u9(+aAmOa1*EaZPO#KK_T(izv*_nCn8ZcHZ`3Y@kU*-WVBc*&x7F)`^pl#Fn0=7EFQ#6>fXmjqlW8
zVqj!gEgo2opU+AWj}|_(!OiwfeFSrU!s-xRCY)dtRj_L?muV4N?7Cm57oRwojJnT1
z@0fqTPL*tqY`f_1PfQfmf8131$&E|j_F?tae;Tei5=FcInQy3zE>Wx3Uvj~ld%pCK
zIQY}oKd=Oz(v81b5DAu|Aq^!DA|?ITjs4M1{mRc(F2CIWr`r$v@JH2ES3wAMR;%Hk
z{(ShNzjOcLj-%f3?w)tPH?{KU!T)!S9}A(I|8QoZoU(iL@BGsVx8K`(>Df12`K8-_
z{kuPmd?7nNw(BGV8|IN)0+k)vwMptHQ>esjSDqoopaSp@a
z1dP6*92%`7qXjIzhHDRqp=zW2gR8z*Pfrp~%ZuRnP}-jmXcM(W4w3l55Zf;(3FWif
zBOx!+G0Qkq>>t7067`1*o;_0<<VzxRWyK6Lp~hnI|#Sfjf$f$o;y!xkzhlRa{<`|QEY+N-UBvuF|X
zevYsZ3ILHcmqiUc+gya*cp_?$izOz+goO|=P=xkD0oowQf?3XPW?qkDp&Sg;$n2x6
ziTO+%OR5S#POTXFVxTOZlx2}J&K-`Zt|sdFxT`L><+pLEKR3zw+%
z>$glyRng{yrg+2Osl~^vDplNT)~KFE%iO-u!o}*^Ush7N!ilFGb;V~F4y`!3lqrRM
zsw3){8qb!}dLpD=@zQ}-T^k=ByY{EaV^<~JcK`XWd^@wp>k1T#l?@wlG!?Tu-9yV3
zuUj80S2CM6uj%Pl0}I3H%=Yo|&GfT(+2Ht8Zu@B79}Gm}U27lQg$K_COHR%gv_;F*
z^}kV@wq};EJmn`pJKYuZO{JzF6NtFs^*O}{cdil&`#$o~6Y&QX3zg@8KuW6xO=-7QX1i8hL+3lTd5J~7^LHJPavr9-
z`W|4d!Ggt8HrwZBUF?3fBVfTVbQ?)LabMs_{8_MuZwc`<>4ySlphl>@ie?_0TY
zWw}~;@WBUzVS??%c>w`hEq3?w&LM?Rc)}894hhJafkHxln@ZM?ojawbT#uFPb4b4c
zFXZc3GNNJj*tuUmnL<&rW_;LTBo{HH7=OzCV~yIunDd$D?(q~kpY!}LvkhQJOBR(Z
zqBQGz48o>J-1?LJAWZYClL0{RJ83|Rp&%~d#JtsNMKt=G^`*zGEKZfL{keAkYIRuu
z)qvUFT8l=`KmQ>8i)&xQ37eU`>hMz^y?5Kuhrdj(4R5@E6jyyW{^`Bvp7ga#E-rh#
z>wo@}lc#s&k{wHH#ouS9nu`|<#eGZAD)rb2*%}~j$b%28d-##UA8(%Cx^_J{7pn`m
z%{Mw+TfVGc*9!f89a}eV9vpOr9m&-6#Pq~yvNPH$x$*9x<6EAF-<&#3A=*1T14g~p+n0FV1)Fw_
zsS{4Tl_9`mX}PAZ{^8UQ{`ts|w;c;UnoBi%hk6Q`JgU`Q@kKMmkzZbO&Ur8U{eS+)
zIu4h={N+ijPCjd5^Md>j7#SVivF@I`?|Ni1t^RmhhC^yc
zsIyug=D^q8>+pC=g-k=wH}my|$J?lBDjdV}_&DyFPk7Ps+4S@)U;CoTUDGEX6ZqOc
z^qq3rt+)JMcNoc@gnIX7lOrQIJ|6+5P9xD3i`kkR9=c_1Flvtm(EpMB?#aLwtHOF6
z?lxyJL^GnB*KX@g9akn#u6(HEpo0L4ir@bBw=ci^a>xkmAV^RWSY2`iN0Z>qZ+&*upn^D~}j8&Cf@
z2L*_X8p3}7uRu`0my4KKtbF)uoyqvr_{7LV8>YsGcWhPntv>Fi8+$ixJNMqZPQCS(
zzuC1-jcg+vd>Nc%(_I~*B>IhYJbQYg3l=Q9_r{xVy741-{_%_}Kcz0d=-ze%bIKh0
z;@$B9d()kr$TH0_rYPs?jgtO@Zx<>#b?M(FZ@cxY2rvq%Qdg`GWQo?Ht?kRqG`c&2
z#T;&ba2JCBr_*UmsAd3*_G-a3He4^HZ9z}pt{tg}KcO{LJeoM>sFR&G-&elycX!_Q
zo>Na$U;EOSqvfgO8i*h-o57vMJ9rtZQLz;^_X2bN%5a!}BSG|bckJ9T`tbTqn25r)f@6g94&WuhZ@_tE9{G|x%+`@{_WlC*L?OfA7Av=
zH~l5OeZuDmq1wA>(aK^@vo*b_VRE+9%I$%k#b5p6BN2b#w3B={{OZ&SU@%;5Vnrb|
za)c&^XZm{=1ze$_1>tD03wP~>RHb`p1p?g@kG>ztZf+v4)!NC9UN0dn+G=pwQFLZz
zO8v|CSKj%@lm2qYyVl?TL3B4;RToa{dpZV(mL7-u4p9|+sub!COpg&-g)Ps5fk5OC
zrgg(k1xLXVnWTKPe9BU)Cl+z^dr#BxbVUYfA+JVaZfdVWg|K$Kk|U+
zG+WA^xDF;1`z~x+3r$KctXrIdc)1r5?E!P)+X&p<;wWO~bPV5Y`>T7X%W<;f#3O{7
z$*>U60bKzwa7HF*ZrP@uDZ95Y-sZS@2gF=>cAc1CBEzC^<;>u4U3S^&SVIK@K10`F
zW(*#+X!Skng7Yyu%M7hpFthFcNU&MX4!`mhYW>>#db=WU1>XOjKX(oE{rQi-yYPH9
zFf=s1bLV%zweIHM{wLNGy+o00VZs7K;#Rgi-X0N&C8i)*ZwQ$kr$KV%3RZ}kk
z9_AC0tz8%$UAU;@o_p2#7ZA#AXUixLk3QPd6Li?C=e}J1@CSc!+gb!n|LiA!RL$oy
zQ{yKcuZXG^^4fp&e`bDp&DGW7RIWl}@d*#c2`mcAh4?!*%)sA<(N!|9_5pQex!*^%SJL}=G&9=<27lupJb>zt1d3$x>
zytCA8H*G6T#Rt2Niv*+p`lH{x|2=AC{hCHK^_o|z-eiZvXx{R>>)&zd_XxWQL!GGc
zwNmkcKi}bTJ-uRG8)u6s7&;&_yH{`%{Q!2yRu=>9|Lxj;ZX0h$U2f(M1KZ{a@?UEv)OStYpA
zJk_A$UI>!Be>YiakKh{jM;&g$h$eVCG(^^pM9?DqV+~*e_x9YYNj@i_eP_I2toqWXaUUHK9@|Vxf?OK~j&3x{&gCF|9FwP!B
zVfDT5`r7TO)J*Q83)NfxE_>5&z2Pt+v(>`oT^rZ^<%o06yZnQ{zU-1+)#9#CT|RW@
z>g_#AcY12m+uyO`bDz3l^P|F2zu~vZrdEZg|JIAu`#-Sxs;i8}y*-(tI_I3*P&bPN
z33ec+rq}*-6t{gx9MyZ@n(P1J3&Bg?I&sCPe?a*+|IszEWBtnGmma<{bHdTTTyy`z
znl`RAbiaQPXPRwd%KJiEOZNr6MyYMXGtGP^oIm)y9iRHt>Id&Ty;j@UEEc0^mk4pe
zhgu}Y?0lvdYzgpY%Ejyh52*LP7jn4~Te8sDJgn7I1X{c7vLoL4?hPIN;!)tOZymhw
z^=pYnGD0fM002M$Nkl`RR=6i_M}8``qpPRu>t9i~-a7NeFWvZ#cjGTa>GjF3-sowkF8I^!yFT@?
zhnRfV{>Q4tCwA3GM$UM#I{Rh6`O{s8`#WOqd(XnRUv|e;SKV7dQ{ArK@;3F(cO6zK
zH|)*Ad)|Hg8!x(ZW=1XOQlJ0)s+KNp
z39AF6iA9SRF%1sn&pAN*23Y~-lYF*=f(}`tvZGkI(Jbfq&9V|BeK)ZfO$2(te2|bq
zCeEJC=_!4k`<{K?NCO~M4R=>Q
zTd984H!ghL>&ATcb$EUYh5afVE^eD@wQ%PUat1lzR&BvVW2WedCUV&dCJ%p$qV4GLraKq+sceimpAJtB-44IEJK&4klF6}$ZV$$)a1orX!%#l=B@0T=KDwc@
zVr4&uR$48nmlhhfYV@e|4}SqjPF}EF8flRK%wBr_$NZ
zp1Rh~&P=sX*(89DH@>i$a%YQ$uH(B4JGQAdMy+A&QzJ1)P1~XqF09cJi4jy|Sh@64
zzGd?txAMdXM(dfDJFqYr2L458kl;*q5Jxy&d1TMq`Tnd6v&?ZV4z!s@xUtb^o
zqhRvE(jZJ4k`#CtkRS^dEch!RGElu@7R^(Dw5J&wHWD@*;ajk9*xpUGT%xYxP#m@f
zo`|Jf)|832snCXXxEnz}O{4p=*zNG(I*C|09+yXN=}a37jQg?=yWa&EVNmcV|AZ`q
z4{lN%azB@Zs1QwmwteUfq&pnVB=`=$Gy1#JT=fI-|9K}e@N4Zu@3Bx#Mgu#xy(B$;
z$Kdkb?D`4LkZ2{Uc+d2vNw)gnKzw{nwr?m&stQHveTZ#z`*3_Rsx7(H{fzQ^SP$S8S&VM
z3{@@ao8mo+5GQDdc>RuQr3IFU%85nYjjBdCRvZe#=4Y$Ql?u@~{w+{N#2>aIBnSKm
zkI$<+as+5g_Abm$7I91E^|z){xdF663SOtzJvNf>Uj+T`OqZ4)dGaHZMy}elyPZL;
z(D1{{VUo-%k%8Ov+=FMHdfX4byX3H;LeN=Mc_c(lC;SLI4%r3g%6zqm3?zPT_xQNh
zw;+fQq+&Yj4@RBQ_{`SrT|+(Nn#+0K_(7FaiQ5`MXaA&vDie*lsZsm)5^Qk&kf(|2q
zhvR6XjZUt|(O)W7>aAQS!D1`^Hj3@`nm-y)L`H#jdlHeMLjF>wO4Ql1epo2<+2GKH
z_<*jrTRyk%5Rq{p?o4~xCnyP?Al61Akzfm+o}NDP$Rjsx+Ju@X6b3)B9a9IS!VR>D
z6~}xpUvgko-ycNAEEZ(3nVX3ma;&|@M3eZw6BIa$BZba~3bAS)D4;W`3Ovi|h?I4`
zwSS3>IiRp#K|o+OXnANfcc}m+CyGRPE5Hc%5RowlIuoBY*}_{my>p_!
z_uqe5uyT3P$du}(Hijf-f+a5~LGEQvnxS>Tg`&QPv8R-nu@{AOmLyCg!J2Zl@JOkolv}QWc_u5Ojb||*8mM5ZlUKf*SQ=ON`c~tf#p5iqS;-*PL(+m{u
zD9Eqo?^1=9P3t)ZS8z4dJSJ*%*RCNrqk<5cR5N>Px7&)^(aVop3z3nlAUcT}<+hhF
z=krWtv@4o3l!BA-@Y=I%&HFs9V$dCF6)O%eUNy|=J4a;52bo_d-^Kjpo}&rD2c)!R
zw~KYHd=J02P+mas*@U(^I`WNDPHqCtrkjodq?RPnUgB2=#%wZP(w_OtY-@ByFuEC0
z$@GHN2HH*Klqk}w8I$K7rm(z)eJS!t#<6BNG+A!5El9=LSz(Q}741wqD5n7Ck!c*v
zUwd*g5aH;}7N*46%EDj#qUS@O{*|}46BY+b-G_(_6RZb!2I=s>jWe`=hzyh@S^cO8
z$hl>1CsFN8I@Q$~XBis}LLD}31kNV5f-k0YHhOFCJ|HF-XGLW5bfrAL^~Go*0K|zt9DZ&cC|`^j1Vy(<+9i~Ho`T7V%u1CQx3n%Zfm)r
zj3}3(1q(?pO}s3>S#L3MByXH!3{uKW0AUw$Mz}llQT${OC^-Utume^q-!S)5Zf1c9GM4X=0{LJ-O5cTEBAgh1S{3E%7#&llLy47U
z8<0n=F|zo37L8#+0}4Z`&(#zPf!6^j!TU|ojFlS_zc5&{pq-^tO#0otC&~yv;Wf#u
zYvsE;CS@j3$p5o1649zfteOw(ndMWh=upI-E1(Z}-F5eV^6L`W**XyHS@qE0hahkW
z0#6MAbGfq&^+=sCZdpky?v)f9C`7
zR%Lo)z#s60L-fjt1xz(7p>koT@B6;l8}`~1)+M2MO@W^j@xF;>&2g)2;=x&&6ey_u
zcth5w9-0HUbiRoUyr6->nlLlU73?hB)oKgPA%X?X;RX{)FuJ=Fvsccl=8+kfXC(1p
zLyn*w>|@>wa|xtE9pfdR!|E}jxZD7h1yE4kpjx}Zd}4>rs_Wg_BK$Lz5nPeQ6vB0Uj?fz%Y#b>^98
zns{~p`^ji4{0`010Mfm=v(;+_@dqU*U--jUZ+#n!Z0n3(E#`Z|GFgbbY_0rJ5NI3+^$8{Wrni6}J$1C>IN{ZroW#W?
zG1Lx@C~JDkCj9bQX2u+yVQ!VrZPfPPQ}az^KrEnjRdKnz1O|aOg_I=R6-bX(5|C>$
z^GuF{U=oW-KoMjF)6<-g78xP;B*+M6E%z|xO=KfwOa`zZC0J7MAPC07Uf48BWpDS=
z%E(M0i0LOI
z-NHH5vt$FZO<1^o_NXE>1hkh)(g`=jbTcZ<19O&J6o&i?9cJQxscaDfW<%6MInyjK
zA%+5`*&rK}$s7_G@T)~G%syw52#>$F03~lRhn_!Y`5Y$9WkhzDn6p9#h>;R9@ySX2
zWH9R%xNLRvXOrLfSD^j(cM{~4h
zvQxtmUjS_woF+fzA!ojN_)P8M(Gjs4W=9+av0z7H!v2hNHgMB3J^I4`Zfm=oZEvmC
z5J9}dhVKvbIc~af1g8;ZM>gm|FSFLf*}I7e3;W4Ac=zO<>$Z5)q?G31$Z>!+
z5tZO1!{c_fZGKf~I_%y`x!g4BzPy4%W**aJsO(TG2J3=^YBb0R;XL?BHw7Z%ewr#m
zg(%{3m}|@8a7cX`pzzEAv9;y)3KXIA}09-X&@QX76U
zesRq;E0>9%42Li5FO-J1~BZI@4jC1mq&-bh8HPUwvJn0%ud75~|Mia2EB#4Z(SN{($n6VLUYp#r$^ZKgm?f
zux{lqfNaT4_)@-lmXI>(4D(Ow%o1}z066d`z%+p&FcCscE&(7-$?s-;K*#7jQS37N
zeyKQH)2#m3y)}|jXua$4qhN_?Oxi{IY1MgRJ7%es9rBa$IA9#QJp_U04guLXWyj;1
zb<8E}7l-|ZO3!R|+c)?1X#N2&(b1+y#uEwIXxXF>kbJ>Fv{|e>1C`8J0a>fts}f;n
zU2C@W(!TGZs9M-sVNc5y^5}-4Is8qn*3-4j)ZeR_B!z5fg5m(6^l#qr^>d#VPygh+
zciL#Roo**Y#x1wp^19cCi^WkaMS&bV3{L%K&YYFAGFmv?!88)g!ks|YVxgP)?7gKG
zG50}K6YK*e&=9QVK<5HgP5D)8V4X;;z4pU*+Cir=#?xCxpk^q9nWM=5&nr9f>?_Vz
zBSiG-4u7*s{LYB8lyMS>VL$XxwTct66*p`eh6lb-x!{hvlSHF8_0?vPo$PG_WGb5I
zhTDTG%{!6dBD^N3*U&%v#Xr39;!7sRDu*9-)V7BoC5{p3NQewTXltMz3gUr>VYf9*
z4MY>iSa{A-EwscX7BOL=E146}2ap#i1jGb~fl#S{sxTAZ>1egXC0qNwpS=GkKXul$
zz!9gc+V#lBh`-C^*yrmAlIN1Iq4h;8W7&uNEqP3{1>7pwo(y3XjOdk`JFn#(Oho
zcuZI(B(o25j~Yg4y3jqSh(@w(=!C>TtynPhqUMC(W-%mYE6!Q5n|}%~4t3sh;vHkFJCp#r4)px8v5WTFNOSZyFIl=4L=#PUw`PoCqclR
z)r>E*kuw{Ui%agK1(z9WcF
zg$7$HI_k8|ir}ucWXA^&M(yulmIMj&GO#`2DZE?iHs-I=!kV
zWVYs1|L2?M8`|Ap_~;qEAr-N!h)u2|7pf~iEbV{cqo+%`!~Dr^mA~W(?|rO4ryAOw
z(ob48Un>1ss6O}MGmP>bSAFvxpuS2u-!@t;qdhS;j!LMZ<0I5)wi}wkr4xj`-IQx@
zQ@f>`Pf61}OFLZL^NOvT9`d_Xz@@JE=*tY_fzN;Vr7^z6yy#>vj@bX<{LIMpKl#C>
z{Arc*`ILYEAI{H?{O7;@;1XbhW3vb@)y?|f|MCUY|F?g7JM|wck5K=$nbBWSe|I}`
z?O!PEU-ecQJM)Tr)xs`y*&7!d`n^|t=*8W^C%#wOzwzJx>78MlidtQ=`txOJ$9nG*
z`u`Pq?@z4v(n+VhMZU`_=e_jPyyp62_TT(2zKBAmS#Mlj@$q+OXQqksp32PZE&N}o
z`m7z);#hjSbL6rwRO2sHJ6hYQ8Aio0ss=7b^ctO&OQ*cqG+In)jSny{Zn!9EHCpZZ
zzQ5XZOe@og-8pD*-*@8~-w1rnO9xi7mjybFJyNy^8M}79X`n_{ByY7FPdAzb-{B`q
zW6_#OR>@P=e?jIOTTR1gY3AN#pmNqOYq)AQ_$2w3gi_fDj<4UZ4D)K-uj&s(nhy?f
z8IN`k|4tcOi2r5Z%h~?FR9$AjCIO*IAN^s7`t8>8@W97yOr^XPru);t?}jl
zY%?}=HXn)_Tl(^MI?H$YjYoPaciSp=;p{hQJP1%kk
z((YE3+f?f=oBkK+@aU~dTf4A!-?ANi!sd8$v!n8$t8mw%{GV1Bn~s~gg%{C?((iKB
z?&z)GcjB&FS61#j+Sqi|#2=KgQ~K7vPZ`4<!RJ(aVXfwZ&+balx#$jHYb$v$Lh8GsqGZi)0NqBm3Mi_&$4T
zem#Cda53XiuHojj@KA3xQ{@mMgyg;(jaKeEL1e)EQ
z@E`n@uYBbj-}nY4v`k<|ZiIvK0=@U?+Tkq^J@nA3Rjc?SLOy~#KqM9rcK7WCzrp>s
z6~G!$SPD%RoSBQ(tGVH&);;~9SMyqqPUXbJ#K%7NF=Doze){PM%P7Hz2LPGZ_deZs
zaTc-$fw)Z@Oc7&%nTnVoX@z2
z#f1^LsVB|paCegPmV|NQbjz8J`q9mleou35R?8_=4Kec6X+e3uC-3uLDL
znQ$r0BeZoowa%4*w%K#n>~$L#0Ja!;oe&Kl`8
zu(0fI0wA)fI%~SEsVQPGyZueo>9Xy(|8T#01VK0_?z-LEvL))ov`4=}Rd^$&uK7Ra9_xG(@p4+?`6V{#{qB%Q?TN*Gd
zTn?YND_k#3=jy8G@V?_0jNkN|Ba#bjmBy}IAy3psy|DC~UtQC?K)w6jeQoZu77JCGaF)C5w;6$j1p)!98QTJMrfMo6K20
zpS`m%3SNGR7r=X12}Bm)1_!|G?`*7C6M^#p7WYsXdt1)r<3Y;?saPyp(C00zJ+SPZ
zciwr~WtZ_f?jbKod)xlr*5^xk9TWyR$o}!Dos#)Wz!_UCJ{kF@3~)qZu*Kbmcr(Tk4I)X0fyXu-(TSk5*$ck6xMvmqa2rmz+twzC?>@~@A+oiw
zW9RL&Iik0H+=plUYRjREVTY>^6J9rO0G$XD<=Raiz>ODitqF3A5II;U6O+Xca>cx_
zp0E4-YSTl?9|%p3WGALo&)^Zsl}AsF8Ks(|G*ylzJJT~N-mA)!X>ZUrFci&f-%@W?
zB8RQ0)HuvLU;R4Do#|aW79G3zKW|hvpRIT0vd>-FSi3HdECWgm!K#Z*Py8}Fg3%SF
zT)ZQ`5*N?gAIw$@ZUPi^_Y<>HBqH5C&S;lw%PsdiJu015!$E`OTn{wOTK?_q0QD|bHso9dv({ns;)Dfc3fQe{K;Ip
z@cs{G8ZG4xRMW+snS5sXYmP3b%454!^ss;^U7#0Ot1Wu@((=T{QZqlD%|J06tYiDE
z`#tYOhSd|SlQ}+u-iTTR76jE1Vt{?08_RYGqzJV^<-IMpj;FK(fx=rrW+X^^N^ZL8
zri~jn{`ki~2DO}f?ztem=g|J%_9vN4LYIKOEM(6ct?#nnFn>9pPqayZNvL<;0v@FV
zPykp8!K|QI(7e?F*dFs;&gZXLvu4AF4WIeUX9!FMwFkXL59j;6PuD&)7LeIJ7Lc2a
z>~4O>{Ef>&-LmLN37sKPuFOl+akxYjEm7zoEVz&;&t0aO4+nY?9q;p8G?l~!&Ri~@
zDECiKp6J8WM
z)^sS;>kNh}H8phV1+`KzpHr2JR;@a9;%OO?haS|I9k#Ty^Dw)kr&0F^k@z5(2}JtyXxy*S*mD*SLNVNm>JfQ6hy+G7Bd5c
zx_b5Mw=w2Q!OVc#Kv-k_v{&u(_+HhAxQRxid=WiCI=~Gtru7J`hGQ
z1WdRGAiSNNd%gmG200WM)YyEN^Wh)-;0NFGmbXCbeD<@S{lq6e0gnOlYrfz6bnP<)
zkh%N{fyJz2zHx6sY5oS~U~d^@X+uFyE|aTI4$oF}Y`H_P4TB)a3+N084s3tGlwt}b
zcyym%BGHlVK9-{!yzjg5KfjUrVA|7R?1|~V1tlQXLc7`IZHT0aa#Z}}f=4cFjCtQW
z=5Ln5QHVtPp!C+=zPgHCm%abZZ%rM(bi+@6wwkRfvE+n$yKCD><2A3n<3*=$eA6Xc
z)A^vyHjs!99kY1jkN;)(GoMy3I$_jlTa_B^JmKiOu$Vh~)mEFaxGR3AT7Pp!I^aLm<2|C)PF(T1)J$f&Rv+W-BX_ND>xsUB6X>8izq|SBb2h!?wDC8*VdrmuJ2~<|Bb8bBtN$vz|MJuk$K3ahca=tWMW-iK
zji}zby7{JiPJ8kC({Tp{PN2g+;_d}U1;P08JGw2{obc*-x>?184$3j
zF2=>;qRs2L9Mp}Qsu&^#HZO1<=2Ye-Hs@$Th`0pXZXrc%Y~Aj*4G((~ym~)f;^#)p
zk<45)8}?gIo(2LyOaSO<8zP1h>jKL=phXWoey)HUfv%Z9zW5-!H=G+E-MM6m8d|!{
zAB=tVD_f5}PTg_W@mscwt;YDy$(kO#;ifG=`nNN0{`0Aqe`3iOzp{1n_K8qOKS~(r
z*Zsp+kNotf)x~dq$m1Qn=4XG0iQfGWygHd&R4lugbCpW_p4F$t66*i{+sknH)sgHx
z>!s@2Yu9Ac{@>p`eC!D-kqj0p;|mt6*S_|_m%ntw-<K{Qgg`xT50+|3)~uCz>4i#=nrW&xL&A;!l41`19YgB@)SUEH(6aX3NN3
zcc1*xkCCr`jqKb}-#wj!DdFH_PwbEsvSQ_0qeZ~!SWdj^tJM#@|AYq~
zy5J-KANkyuNh-VEV+UF``TmdVzxwTl&wWMww|{>IIBb#4>Hc?j!DTfwGc#ECfg8Ye
zaDwe4m<`r?h&K|61g@h5-3AxLMV#-~b#PYf%fUHtoF6_Q#Vxno(%aj+bm>yukjZ2q
z#`x$*KYGzc7hyBKU-j>Af51oa2tWpS7|t}p?Q35{mlm|$y^RZR7n%mV
zz`USK0D?FNapqCi0iTW|r9uiJC{GA>)ikCm6>Grn(02;N)|^^r_zs5@OjED{A;&>4
zzSkg9B0!&UH!$0>=RL`+FT+GZ-j@2Vkz?9ALM1+;PWeKl@oAN(fQ#EzA!uzx;A=-vik0
z9{ULkQ~1t6egmKr^a>K1`SX{ake7Q01UX>dKytu0Xgxp}pepJETLp_n0a-wNTmhl*
zaY3)&aKjDneCInc!6tu;R(BzfER%E;Otf
zHY5C5L{_M>WJV6jJg>mhHJYfnjD7jVPrc;=a>iNYJ?}gB^fPYj>`oLbrFbm+&HsCx
zEGGW(YuEqXr+574kGjgGshEldQ!f@qRh30IIJV{S4GX}C)F7Z=ww!$Jt2g)dlJ1^Z
zNRrA0l8hs_8M)-5|9;Dx`L%1^_x#1FXPj|A5}~bMf6Daqb@h6+r>Cnpod;fdHIxMh
z84FEB@HQ+fI6|Hgpaifzh%wGN=N#}+urV-rfDgzLF1+xJ4vrLm-#Jx54$dzy0m-^!fLH|94Ouw_&~lfN~HJ
z*pWx`gEk_D=in$+ZYl8OM7%2}kK|QG}CY$mqmOS2rB{sniJ6
z^o1FKY!G?`2xHOW490%q$-CFBC)Mf%)`54wo80irr@Q*>|Nkf30S@|lqQy$?_2-f8
zTOT>?lym;||6c#Q-;kSb=!HO|QOnB`Cq@!T($J_^B0wAY$!wMk@7$G4gljY9)hi*f
zU>(~^M9E_h-MQw3rRB=5mN9wp#pJ7>BOmx6_BL*CFl=&>MNZs}zR
zzC$WMHC-}va?Y6>5}EK-|8N`LnW62^^bSP-^nxdT@B>GY8<$>u^t*rcWIU=8nStSj
zs_3FB)5yp5W{ld++lEH68OVmk3*JC}`V(^Hhe;yBHp*4lK*yBG#AL@ef!5go}L&nj{@A<>&tTFe6i?324))oVs`=f@bEA~KmF4`
z{S)@|c(Z{pFkRqtS6+GLb=O^Y+ikaj{{esCLBI>}IWReV+HkO9#`fb$MYH`|TuHw7Tl
zM+R!7Wx`&NGCddm*vN@P1y_!zVK>guF#OnqBWyhOn;~ELYXU#+cT2DM0p5?^fv^n7
zsKdZ76ar2NUF_B&z&kH87SCW6Bv%4|L`;z=V35b~v1~T&t91S60zBcHgi_Rozr$+;
zFEY42e8pJD9KZ6JEu&b6A-sOarTt(1htWTK`}R+Lirjb|*}3ihl}E+?&qt!4{ao!s
z@A+*!On&m?r8RiKH8gPcN+ItGb=&m-Bg%ydgeX7#Wb)^ikQmSlq^>G9r
zOTc1)Ko1{qA?ag9XOpk3SA-<6BtafXJ8~e1#c70M;w6xFUdem<43M!U}@k7BLQqfEVMmu1+n(xEea%pIL9l5A7FssU)b^i
zdEf9p>|exBHr}W?*)>ZVg@+{xfmjE(KDlH0ioRVtC(?;^yujG(E=1^R)`{5?T`Qc;
z#`tKZH8Yc&AOmaH6Ed!8Eu8oFt;NJX{`kEoo<3MBmL_)TYtA^sDQrTXhGLoTUcF*?
z>s{fH!dTg;y7YBt-Ttc^*M~cvhOnVk>D;w_dg)3o-WzV@sZem-u
zdquNkj}BGV9Cya9r?v`mGuAQFXf)HIb9U{R?&_6e9q>3VTQh~J39o-0!c~tLdSiOh
z>FZnTx!m;B&TJ1T&NIr2(I>X_4@QWh3_m%cC{lJ!qBu64%AVY;n7hWGUVq|omFc==
zNOmiJ@g={yXUhd+Pd!j6nd??9vzucAUpulRe(w48ec?NL*j@oX2uv#iwFoRs5rgZ3
z3od}lAAJUNz|Rj>8enfY|G)=6044`^2y0OMI0NQ~8iJqeVLQgdxnlvRL=S=C0>#G{
zzxc(=F1rk33{V&sL1d5@1^2+06%Y_014|wdMgabB9aDq#@o*mItF~{LDNLekA(AEu
z$pqW7(&XrSE_oe7A5!BCKRFhp{D>q?BPse;iiZSc1bd~x$_w^guy_X8=t~?0=5+WJ
z*sDNe0#Oib7)K|l6An&F4bpP!43TNpz}dc189&vW&=MSHzgT4dFjhRq7q&lQ!Ll-A
z7IIrxEKTPohgTePtT}EQtx7!AtX8dv7!?Nx2p=AL;E%BAY#C(Wr0%Jw9*8DLzC;Gs
zcjR{6neEJW_u2L8_DGl=7-Zf2J+-O^m(gfQFlL&mFdK<>wMv;EeDn4HPk`VsFjKg@gu7FtaUxh)0OcZJWHCDLjUo{mNsvU
z#@HpNts;f-(#W<%f|$(*LP>b5lnYb0ht-S%i&M3vHArRG?TN6_x1@_SM>z`9kMOeS
zK?ddr>mb+_7!}|G1Q<}4fY0Fy*cb}F4dxKWo?veP888cd*Sp>oTnyOT{5?nbY%jp@
zAVUK6AdrAr45*DbU=Ka?5WGl0e<)BeBWM$H3jjgT9}*6HwSD_`c(>v@xECJ5Nt^x)
zFf#|HN@Pivcp0_<2!({C#VDd%+p(qc;C-LuxCx%k3q-@_n}aMG@w|~kn})*z+VIUk
z58{z!I1^h%_#q&)I49t|tEX=a`&L*O!Updk_TNO^oFis%GxuBRKZy@}OwRoQLn
zb|OhFkvW;y>a|ErZsw=YJ!99OUO+zfe^$Fzf#*cCVJb4)YSy3-(I)E
zh3zOnNxVPVLSwmcWN~E~YB+ynmqiaUz^K5_Fi8PifUF*dhbNqHLNIN?{x~r61fN^6
zV#Tq?9(&bQS6zJZ#jx0b*FzxE058PjNA^rF(C7jf0fZ6ADqz=n`st^yTel9);j4iD
z5FKF(pc)t)9E3sc_rL%BZ+zn$m^Iu0c=0OKl`PO)9Pn!4OUc5(4vY?g2_b2M0ft)-
zcZbsvlo+%g%LW=mtm8_(NMgqyL&mmQ
zC0&4(2ji9tdK|w0Ekjl#)p9i&!n+MmCdzeydSJ8L8lRCfEVfOt45pLQ%PoZ`Yfj*i
zOt&#(Dyo=`tJTSA&vGAnFkO6NJT;IeW(`?v8AL3n!172giymZPD-8AqW)^@9m;!9r
zumRg^FgDB^^pv;(qAl#O0}~BI%lO16J^_S*Z=qWO$iO|gAz+qA@>DO(*btus)Pr3G
zv$bmnBS{@)6x&MjYkL0a1j5d{mfRP~Z2E78r;xEAT99OWS`vxEA6s?;Utj^HW
z&@*f_WS)p32a62Gal=u$nA_gd5jI*m`ZY?>6`Y_0^XL9I^a@IFk#>(_BlK|gVsPSr
zn!iHFG7kuz{c6wLV!i@A1qlTtey%Z<4kfk@jX8WBc8Ge@ks^qXfyXiMxj-7h5a%mD
zJWkLlN~c*`VUvKJ`Ro-;XVYC}do791m)LSb4kJpkHPfuBvZA*drqN6!Q~8{i89dXd
zGdhA48l1hYC9+-Yl)|xzP*T=fMrooDPejD9GCV$sMZ0sUnwy@&G7epnZ6LmLLN{A5
zovmx8O2W0Kmg-$!Y>bIQ#4$Q8&ypAk;Vzn$XlKvTiOFYr29mkl_IN^_DOVz)4$F+{
ztvWKIO_qz9`0`@46%8e38m1~E%gIc3MW|jM_0*2aQ-Wm=M&sdz$CSs5@#GRQ6dE2Y
zBoiIkW$~HZxYy9KOS_8`d99)M9d&wbXuDOTln|7trkkOdnyZvkVq~VC538v>^26zF
zM>;F;?AXL~S0~cK&2(nh7=mVc$Z3px?j_dYY)>}b&X(J2(lLyHiR
zEPBIFa54mDfb;@f3eh}|KKf{IG8D`bL>FLh!A2P-0?3aV*xBJaQg#LLB(ReX0LtO<
z6JC71Xw(1Y%~>GAIm`_|v9!@}lvv^z4(I}rUmT->s5DtV@#Mxc!|Z0+ZE_xxm{4$l
zFg3`{s##uYpttl?DI|y-sqh(&lpJh1i6nTA*0NktfF(z_T|+j+3ZE97s>K2EyTC84
zMztC470fBi@vwoEU9LqT3mC60BM3Jj3ydRKS*q7GmXj4Z#0p-qkcY!;A|+O;CV);X
z6PlT9CgZSwR2V0$H|vtnf)V8`Q=Eqp7!tOf$d(x=TAl(HI5);tMVq^7p+u}aUX4VN
z!rX&WpACz(2{Rg_F)S?0YnddP+3?VuZH1>p5$KPLc%odIKKxkTb(9wYat3Xu0uQ0KA8>%0uPH1ed
zJr%5Yc#9wr#9M@OfORZoxU#2vsYWs|pTceP%OI}o@#Yt~h`~}MTGK3poa>hl6e($F@ojo`=bHg3=~swYPyg}DZWD*kvlRwk
z;U;{GKb*|fNxy-tf!;dzH-Gc|J@|@FlwVtL(Z89}+P_Ypojb)jM!H*vf-mU}vtZP3
z2RG2$f~WkG=RJk5g3i;Y=I^9e>4Uh2*mfWq+Ba+s@4R0DoZ2*_`V
ziG*2bqDk=NStf*Y*ekFWeyGH?B4Id;AUcvz%uS?vJCFmmp0A?TNJ6&i&5jPXl6OqI
z5f)jIQ+z&%L~f`n;P|tw0)i2`2M0j%fPZ+AW9r*#2pMP;sxdqnQdzfBE0VZu3DhDP
zJe-I;E2eosB%@{1xMa1u1AAqO=0^#D1+9yUS!hGx7PR=Bfy!X~SX(R+93oL8S@2<)
zdV=qh8m-2uN>Bg+j9hou=O&P9;D*KGZ{#n{Q(+ab%80s`wiv?
zBmn__AhZbdBSBE@0F(gE1C#)T;LgDPWU{%((+
z0Ot6)UTYOAn&xLloA4fshiP@ik!mW7ZJq10ztwbjsM
z(eVtE%1(N)*_2!z5Xua;ptCq;ejIy+Kuo13_QT-Z5Mv-wJcoF@&_Rpk36jVVtzs$EW66VAL?9x7Yyd%^DW7Ht
zbu?h@bduU=(7H4ofP`{y1PZGWTrba%L?0_cbitU2%E%yvrth^eH!6rzD6eM`FVcZz
zUvQu`abafC%%sysxh{n{t$|NorZXYh8mToK2n~Wp84kmNm_gGWKqI8{hUf;tggpit
z2Y+`Npo+O>X5mpVe4hsXDTc5Jx1#fd+WQF>Qb39z&vp=e2p@qqaNPSt?QixfQk_U3;>1TEr*5@=YSC?@R1><+hs#VH7X4rgd1uuLONJiY+1J5Sg)|TVxC~SbI!x)IDj?wmiFK-0
zU2}9~M4|YjUa-QlQkyObP=jP8reSC;I3H5^u&?BxT7RfXsJ0&B43_96qV({jXqTs8
z?N5~6p5nF%MCqpLkB+DelZ`1?4HLbfArKb~1fNy&2PE>*0Ai0*cp$k%HywLCS0vrX
zEz3PpNC`xZu_Drd627hzSEmVRA&)V%CWrVNY9z#!%2l^nBqG;@eh7Bw&m;Wq%{>oz
zpo2#!#-KtAtgG-c3uMNS4P$}DM`%x;N3KQu3;+N?07*naRG;?8eW3uj(!SibDDGMG
zAOrXy2wxpQW;iUM1f+-61tc8MnBXKx?+(!g5D9Xa0bAgpMpU`N0zE5Vlj>vVf8>^0o8jruGE#0>}IK=RZ1kDV1=;Msu*xVK_W`nd@{X*
z?6z&;sNEPc5Y>QV1z2o@L=>h_I|s_BJl2F!BVrjr0I!cD@*7F4>T##*t*OV}K24rb?Q!b>!jvs*`)85o>JHQp6_GV#03(4kE7YiVX|=`uRbmehZR}@hzn;A7*tYU4GUNU7m@apidoDk3)54l7)~koUAOhL
zH?1SBiAJ>yy9?XlVp3+u)7u6HJ1v)o->D#QBV$G~9Wr!wXjgg7@eD*Ss2pH|Hi1Sc
zCfbdsQhyP8X|~K7p5lfh5NE*F9!n_HC0KQ_q6TOK7uz6XZu(!n|L*paSe!%vdcbQ9
zgaM&NpvQug0#E}lH$FmwhhgC!y#0{i;nfGuD3{B)f?q;lodi%4NI@1S0S82w5B;zgwrPl8Hg7uE3r>~n(W*>&WC%TbMRQnbXc8+_6i}VYo%oT
z<%h5ph&1X#|0-mIh)mA_97v9*c&_NUQO^xKUI>gF#uPRYN4A^Mtl~M!n=bU4c`vr?
z)N{|9oXMGlk9V(GRc&y@PJG}mk&ntWZO&n+gQ)|6L2xd@Eii~lDurZ8PM8)f#7VAX
zn|kA_uam}9-LYg{<5Jzd*`EHXvHDeCB{$tPEy=z4a$W4~?C9)p?D+40H}$>mkX_G|
zlmrIDp_85`JD!R?i{s7y(Q^{Qbq|)FKpN=1|2OaPcv#KbEAI@}0W7&#U{P=a2NTp8
z=uof-x6A%g;FZtF;Zwt+mt+7w2iO89(173w%?OTo(E~9?@UG(`KH@qi8(I>a;5y_P
zIKlDonU4eB6G$upzff%u-V{A7l|=p
zXbOPhCLeoj3h6V>`;!haR5HpH$BSrM^v6FUIhdCwC8KHZTnr8`w&N-YIT?;2Wk$=e
zu!BcFPzr2_)ohgDr&2C!A$Z-&umpKlv~eW8Ggw!#mcj@lSX!aN4nEE=!bj3z+hf@;
z3M_h%v0tNo72XVl0e2fPQ80K6A3Pol0ZxE67L*!6&`&fMtTMqy2LdOozYE&#{#K6e
z0gvJ-Afx~!0bzh*LI3x+wpaW8*tNT1XbIp}GHd@x12!qFr({>G%8yPWa!t=b&*aoI
z#ItyzLkY(i$DZ0bg`8oo6SExwu_&fQe}#LO9#zqPQ?A>b5^Z?`f<0@58U1i(8*eop>}UOzYU+%kY?Kmo^1nMHE={>XKK{T)o_(f{#L40|5he>R_l~^9W6b
zD+^kHCmKN$CrGts^$o1VQy=}<*xTPeb>*L5KQug(?d-2METk5D_j?|`=#oOE;VQ7R
z;$u&4+Nnn1Ps+qnNsmJ`Ypzf-;9X*SV!l8gy1#MhMcRAcMb3YH`FH
z0If(^r}@{i*Zns+?+tHWZxK-)T~61kqJ{Hg}ey}Qmv8i|FCDv#_HexP2>JYBN?^B^Pa93jfWrF
z0%_Zl!ITt=$a3h)Pd@z5|9s5MjPb<7LytZ&BPYq)<5qt7qxUUaPJZ|wr+)1p?k`uU
zrNz<5Y^c?L^4jwrj6{i6r;e;kI!OcBvp8YJF(+O0@!!1r-Lbd4`E7UKwejPh+;s2V
zYn9OW7rwaVTi;r!(>;8Dhtyh1OoOhlwHZp?P
z9!eAe&dIKk{PHC$Cr34eFzxH_N4SoO$y}y0^5^d>{qk3u>(<(q$`FHFa(0@X%fNkWBy5HAfwD+8Jkm?_bHPqxzoQv~APl
z&$d~`co$(ptZz#PdxTOSC-uRhrv7V=)2?g?nfU!>qkF)V=_i6g{dtM-E+;g
z=bZVv(;8Oo^!(Q^-yH7bD#mEdB!B;O6He?0lcb#;#K{K4PQLn%L_(;5~QnTKE
z`3F!xOgcI`2bB={+?UR>STUMT+;I;ws-&t2LE36g?U-ID!nf;fQ{Zr=KwFY=xX#Q0
z>Q`XZ2!sKsv2EKnY}T=BhmIiFwI85H_D~I439bTOK>Gj*3T!Ip?LhbNz@fVYdl3|X
zj35FmAQ3tbymIJzw1``VH3rp^AlfF)=>Y>uh%|gF90bv7*;_X~BZy>pbfmv`$>cT_
z=97@LMZ$?fk?0z+Y_jv2ZT(9lcsZA?SV~A?!`d5QV}bmea0%f%Qp&{G#2D$ycJJD@
z*>%i;USu+9tX|Pu%#%!tv)!Cy+pR`~^|}zNGo4U7d%~lWtleOkx{7G)un0`KLy$#WB+NksGfjN2lyqn<~Tu_
zk3R;#-vu29+({r9fUQGdRtb<1G&g^;psnwF<-XX$2}B_CG(pezy@vLkd!T?H0^FBm
zAiOu?N4Stxz*l_vnpG|9X1JD5PEQRkf1~aGZ!8f_WHKHz^q%)!dfZcYeeLUy{?j*)
z&ty~OS`m()zy9rUz5N?zMypb&cK`4H_tdjjq+{D<*n1E}(DEk7iRVZ5LPGdj)y(h0Jlsp8lD?y{FbJjc>eT>B_zj{AK2f_x9fY
zhsV!-{q>Izb=GQ?u3o~)W~zg)H*zrM7#pr9yCfQrv^89;jdgXC>;CILMBC{f?46m}
zMKh2%j%y45_QT3i>&P44)bXL^D=&V>Jrlr942)Ze5{YixH6*arm8(gyQta-JXH;|a
z@sV^k(l-3u!wb{CbmUT?tu8slb4&L-!5@vD9HenVCMSdp!XL6nTFCjl+aETC*c#GJ
z_C6kA7|}9yz>69LwuH(~2WdL(XaDeVme=E6RAtjTJ(J$HkbjYIq*1GbZKaYa7!!<*
zjE2<^4GTFxFAI5s7ST{}3|hqe`l-C|4$wcE+?4(Wxt@cp-@$Ko?zV+~f58%27tuB$
zoIq1F8!C;n4TXr|aVBC`n-uNo*RY6309M~7eic4hwzY9M55x%%qVUP
zDPg=4qodEn5;VBy@YWshbj@V>GtWAAG-A&@A%(i
z)^$$ooO;9S$hANGWkgYb`r{$=BbgFHVG9J51W^$QVqa8i`Ic3nVY|WtqFRHht5;|K
z?2-$AbnQJ`wN+6AV1LAH
zjY=M|>xDIa-50)|{O)>k>060sPK#WlGestbM+8pZxRIQG=87}UJmr_y-vhUrl}r1V
z^mmPol5hR1e4~BVS@SZ_+Nl0DK`FbT#kLGR#oI~DM
zM;3og`p4+_3hAAE5i}xxP_*%qM_>peRiA_xJ81N}ofDH_rliL4UDv3YO|!emlu2&|F6+yC=#L*v+z(m!On1{LUSw4h@g
zYBm`bX|Zq*5@9XWA9#8MJdfjDL}2hpPqy3C4D^#u%0m7DBqIDITAV-PgxWCBw&!01
zya_G(Rvk>~
zpRkIcZ-^1j)MT}W^zUb#k~{T8a^@N2xD%?UpFQcYY9vl7)uBw9C<19#^pLF9o4XWb
z9+9Gkj+c{|?$ex@`{ZA<|9rJ33vx6Zd;ecZU--fU7rbTTzx}xK*M9>-#bq}A;lDZ&
zW*KjL^OL8a$blw$YtnMY&;e*eSkg=QtnG1X%H^Y^RIj?M@OPgkKfN}8{Lwco8z3;$
za1hMAEdR&%y8rRZ-m1ZW`SKTs|K;kWmJb`HSVSSs+PK#UC-}4km}%eJp^k?f(&2^V
zigVc;mt_R|(fZJl!oudm2q!bWMo(&{vx$IwFn=x{uOK2|$dJ(z9Wv!ddt|&=&zX
za{;G!!QPv8#cc}gMgc#>?rxv={WK6MAGU&JbPSSk_%woNL1-U%Rp5Nz2Y3+f^w}8Q
zyV8XQyqE4{=+Xl8;KvA@U0^7m#T|5agYW~$$h3c>04XqVP(upu`94fGJO%<%zgJmrr0Fe~fg1*vR>)huR6kT98JI
zL_RFekpiwp>s^QfK8ht>WL_SmjvKxPoU0~Bopl%y^j2yz8}P6va8dx|~qE>gP-$=%3QumDxm3iWcm5Q`Yv50^ZGdIN&rZnpRg-
z!FG&^iRnxx8cl>BdvtQch77DtWuC8qVg^>{`0h3)_HvDDPv~IE0
zat*P@MutYadU~l0=5-sNeB#`vw{A|QLLFW4>FHsB=4eDJj_3QLe&AApv;@)+h(VTY
zST{V=f`pPoQdozrxx{2?TDd4BN1#3uxy}AYUNFJ)ziX^=I1g62z5T9n9Triz6SoCN
zj0;y@P;2|bVNC%{H2N1DF{kt8aPD*)WE|4j!R8fAmcBLtSN2&5E?^_Id%ye}f-4@l
za$rff`wcI8zT0A?dIuC_AR`3UMC{8LBCsw*yZ&z5?+gL}J_|CafPD^R%nx?B3_?)&AcHeX7QV)XSS;oH)v
z*@=__aA4XxUOYiUs@Pb0hN>469kE8aY68(QB$16bN)?1tiAG5%8mX4*Ho|iuO{>dg
zQXL#p8E{IqT#2n%bzJXVci+_^NSvr}jrvTnXvR|{mgKCmBecTA5{SSVg4qz72D4$q
zF&lFl-8eu(&Z3F9O|P_(1#xGrZgHx(za3K%FD>!eRs&3%3V4LMQn^
z4+~5MOUm=u=<^p9+yhR6n;?;f)Bu_Y%2#mLz8zr%0riCozJ-l1k0r~;zhM0PT*Kb(
zL|s(IPpb|39I!iFqMZ%I8Ue)uF-CCi51B5cw9v;X`wS3<-zOieLuP|Kp0k)ExOE|p
zU>*+ZaEQ@3cf<)5RxfbbW4i&&@)k>X_8G6K5|;Ecj_B_1dFBI#P1*?wO>
zks#>|OXRdQnQzsnB9ZXSSOcM9%1`8A$sxFPtF9Y0h*HQvH$hHWqvS{cgqTxLp@71L
zhz|5rX*2#L)00`!VyLj&Pyp}XrrR!U3M^_0v_Zz9oIa1G3I!U4nJz9^NBt$+hZDPZ
zi!R~dg;ak}*LsRGXxY~zgLRFf6C_i>>V^|OQ2y_G4STzjT3-+mOCbe7{%VMG+A}JN
z0hU3>>Ck4uMzCDcfzko_vI-ww1mlIx8=jp@XzAZUuV8ygwJHl%&;nH84iOy=VV3C8
z<&b%!xnK>>R=nqSVM^%>gy_2fB}hQnfQ*!|l$ieW&r+4*vjr^3^#c_i1o)cALXpR@
z99|#=ePOr~%UTQvqf4-N8Z4Ed^LR_4PvJ;9&XNZ8)l4H^cnem%MC?{W&|Wl%Ww^pX
zMB9pJStQ-fkfxW+idMlSr54hx3cU$;yv)J#$s$PfK?jG|hL=S6WPr~buC;ACoQ*p9
z8aJ6UDnv?o`czZN3X)(s8X*%6Bpy-w1yZz>1Vic`5D45!!yFNNRC`KevvOQ(SvAA~
zC*7+;=6I9TOHdl%22yiijUxkmRLII@qS>H^t~jaYO$bY%zKaS3Hc^9JO#P|+k}M=F
zP!)Ppn`gTEMWp31%8iaplq568(D1#t3T!AU>a3wP1thaaF2+I?$>F6q2xm~x#K?I6
z{U3yXpai9J?oV-W#L5757-j3cjGkfz+I*^rU}K-uq!E=(kX#Ec_+`qAyQiAW8uGq3;oFcLReJ
z`WDgo#oPj3@bEOD=KvFw`-;3?CHNyyA}~bkj5dZer3a=P)IyU?)T4bgFsN5V_%pnf
zj1ZMt(>9A5rpnX{N>HiNfR_;Q3b@3aGDx9?+XyRAYfnMuB8o9%NHHWq6{s&ZVq7ph
z7nSrpQIkArArUJiA2Rx5*GO%OhzQ!E8D@)ElPxYT0AXkqjD~9gm$>kDA#zU$H-{2X
zV-N-i6E@cHl9@ZFfB*2%0ys9&SdIS9^!ym2;;S6kiO|H!yFnibcfA$
zHz$xL&O?HDqhdJ|RajahNGL&6QLaV!8q^{#t9u-*K7GYp0K+jpR6>7LbD~Q6OQDzA
zrA>jwOM!)7q!ur24o1)6?+FP7_DoyMz1|R7KU(P`n9-kSz9-Id04fNwa
zAHk=gDuEUNMtU`uH(~7N%S86QhCSbj^&Yve;NTeahIWZ^Xew6+HbU?Bv_fKwhV3tX
z@u*OSR{Sisn7!X08)dZMve*bxG5tanY#`B71fYbiZEys2!BZEiy}5e#*e(m(3!iA1
zF#l!nu@{)J|4sywAxc$BpZQ-dE(BDZtNOtGODO~Sg)4ZxFl)jK`%?;psFNy`BovqV
zZz@Pe=i4JrL2J}VoVAn;RRnmtUa66YS3`Ocuhc|#ypA*~)5qn%v!O|0YQG=BP++HC-5Fu*NG}kcTaLs3u*3^ukDiXXw(KcdxWn$V`PLen-
z6;o0gkz}h_L_-Q3Q+b8&RH9}R376e+9nDr7Bq>_>X{ia;nXXAH5j!GCNlq%wnQ79I
zwul;!h6QstFLuY!e{-Z7U6LWFPLvdDS^?D?OtLFUYLLW85!E7zc;T61SEC`od&`1v
z2#F33)P{zm=?vB5Fs@Xqwv46-4=ZSZGy}RAn54T*gDOm*Iq|Ca^}w7303`Ue0FwEy
zKYpPw#KCv%(x$-TrojACwYZ0|NPACnJrEfRT%U_#K><6ZP{Utb==uWgf;(n8F=ank
zC-DhO8NQ{<`@S84OHfU)1I7^#VjT-A-p3mD+?MZii%tk0Lsv%J6!aP0#)yJv=p}sg
z7fzf|sXG-L_z1(lh;#oI@OHS9AhaXK2zyv`kJ^etH-yUR9Sc(^9&%yA&qEIo9HCC)
z{9XIPG&o!99^1uW;loVHMe~Zmz1W{%pFX~33Y4Mp1I!tv=Nw5Fw4Xucv^jKxPM-z)
z9{&ZB94~BBu4?&6gw7m_;gQ5LBoQ$hnudPLs+35CYK2l%QA$-knT}})EpNFk6ZRP?
ztz4EFKma#pY8LAjCQDt%uaYMwienS0C0*LgOmix)sw|SrP*4h2Y)NR8OQDzy_a7-8
z*NSD)A=*qW+7Z^8I#VktnM`$JDwaqHK4Letx;9lxWTf(RJse}h5m=qdmGO!iVMJ9e
zRvR7NVY{U@YmOWusUFsIS#!D~b;QLEl{6t^0R&NDPhn42noSa0+eu)Z+R}}pF7>C#
z3_^cMh0$WyhGb)W+OS9}lVA+X(Mw!ZB)pxU&I=rg#3QmAu^j{>HJdGJG>Tn?g&-Mz
z{1ZSp`u7zF_5vFhr9)gCh!CnOSlKn?Qg)SJPu-L$HSd8Ip^#+;RJ~wMWxDQ
zDjo&|F`IQ$cf!d|SOO3pdh7*+!iWdP0^>pBuUR6@0-**MWOzo*D(Kjn)Zm53owJ1T=N3=x
zjXrJflHK2eSIK$XyW~|e(Fbgpbls(L4EXDl2kzZ?-<`J+v*FrJ)-|xF55(hWY;N75
zDisJ(>8iEQ1urFB{IM5=M+u(1`X9c8d|*L-)P1gFuQxKRCi7*(s&QQ0bR^S~66v1f
zPCDg`*PJ7W)a4Q!5NrXvcAWTYEUF5YaJnhRVCdpYt2Y?ZNWogrn*ewcWkhF!+2a%e
zUF2TK#AhE4syLuW7Kt&?InxqV7H|(+bap-4=>ytgFqS>G+n9PZ+>4k@
z8WNYXT->VLK^)SN(V5=<4%#1|j6TtzshG2XNHU^E0Kzy=w_(9)
zSpBTSdbR+@jDT$D5>l;FyB4lNEsADK!19CFH8}cXz_$Uuq&BVeJ%354JO`@jPhl1w
z`#hM=44?#s+W*8k^QZ)LI|z(@Pj*
zV7rZB2IHN*(f@~HpYA1@YT3%=&ECjzUa60ddPwqPR)`o4oK2qnodnZO`;S4kOPd0V
zmI7@_#-W@#M7+e-4~vN2B;UB|i{JXj7hoV3#66IxM~J_U`W+0`8Ej`EYlRej-wQ%J
zqrl({oE~W~;kk#%0dS?GJFHh+sKf>Jz>g0KWga;iNHj@4_VG{u?PtCS|I478KoQv0
zVcn;zJzaaLCjugyLq-v-o(!TvuoY3vBx1xss%}D5hNwJ^Sl!TRtPIHE=h_KcJHSW8
zMX*4bIH^?#Cm?JF2}KZU`T)1$)9E>NzOY?bAT*kkDzFDe$n9K_43CW_yZgYMAo0T9
z*rnTM)I`H(`0k^0TIX=vE1u35R6r&A)D{DbQ))I{H9}!cZPGjQ)K$}C+hMnY$)fF3
zq(HkB94Rl|TY2HDi<>Dppqjx~dh|Pk7Iv>^Zynj=b@YLvm>22)b05Qvcr(%5bIS8R
z?)DwsA0T(UOn-eXhv*RdV2?qRLR|w9VAO&~(E(cgs_{L3IJ;HwoYS@><2mGbb$n<`
zGF~0?d;mvD4d4j2GOFac&I}fy)ho$ar}e~C%V^~x6USOZxBGsJbOE9&1{pHdeeVK7
z6C$o3!hIrRSvs9Y&Uc70kjmtM1p7mx3YKfZDF8XIwN~Vo+j2WcNI5^{3wUQGE`GPE
zkp+}Mz!UzmjCFYyVNeD`qiAaz){$?2>#q{3&e~Iht=E
zOn388Hc?5@0v89-DlCSVB_83{Ao0;jG|l|-S9h;C3Z5PC_()JS8A8j$ZiYtn@J)SS
zUkuiWzG3d4e|+9`R0%_1f3yDlJ74(hi(h$O&1fB0Q1kvA0pmD?%0R#OsX&SYb80%w
zJ&tq_bs&l-XeE=HN}w=|PCz@i>q)_;K`|(}flMT*%I^Y*6a4h|iZk}mLi=|`Q9nkQLAaDv
z?`r|J0G`k^4KbS$QP?!oNV$$s&HMWNOWlX`+$j=^t@Ytas8z1+knDufGT&;
zVOr=~N&RmF^@zVY3-*8X2*VCW-?{}}lKHTtNn(XFbwv60JU1>!>h6RCufGK=qAEh@
z9S`eT?TJVzglN|F!e&b^19>c1o3!FRx2u)Mt2QrY3n_rPQiv6&3Qs@^y!E6*YgCu6>A>TVXj1napN6Q=hq(Be`(mVh=}P;aHU$n>
z3baASp`018*k}l%Z*1pUTD?#!5=)0c#)R1{a7=;mn$$7_io;e+5iR6==SRn5+zs>zNM18#%9`OE6>KpL+J#B38zhj!jtBF{-M_s$vU3LWaHv
zJ`nSJS)ahvqZPyS3ss`~=RU%~B`l^o7VEAK==-M>p&^QzAVO@7L}hRvn6j~NKOo}t
zJqhFig&K7dkCM6pe@QNkL>BsVe~+S-^5EhJzg1D
z{6c3sC;<|g`-Fc3`A6`~0XRa-INug(pX1vB_kO9PkBRXJ>e#3MFkXy@J~i8OUzRif
zqSG&f4$wMjwXlpuJe(2{c%V$G7}Z^1I2tjP0&lu`pnkbQWvG}+V({4qiHBvj<{1{vmlX64c`dQ>%xY`>{n02_9LGAE~6uMUUfrlr*d*kf9VKt?1a>;`h7kY!(l4vGmvqiXJvIM?DuFaOQEw|Y;%xOe;0?+ox
z|A(^4paduWaUKUi+yxQH{`PWqkhLbN*~!Zjj963wA1LY_=n4z51SZ17=DjS}p7
z>0TB>YJdzoEHROUWLb6EBBC@R5*Oki(RF_}7WHE1xXq^tj##7VGL5Y*Oay|ip&Pz=
z2hFtsLA@^@Kr}Suk+p0Drgj_P@k%%=dDRNdHbD#O0R`v)W+^}ec=&bFZ~gj%e`)M<
zj6$U&Wf5Y*-{{k)_R@3Da-apWkd8~C?aFdED?9ZH@MIhYum&kNiuB1!izF1t3w(|f
zObZ&N)W>nbi^qrJ9eTsE5YJN~jTT-bgY{H+T*GDtgm9=7%CQMW!7k0m3-=OaGN1Pw
zg5d}{I_tn0NV6zRfhNp<&nP~k);V-UFQ?FH-L1@Gm$|y>H)t9ksT9p`_a%;~09F}3
z4&JTWy`LhxF{+(4O!oCAbFBbQpe?ium)+fucB@sBr4YlTN2Caj0FVU`T+=I9uAVkzhb
zHU=;XZo|;vSKvLq*^3W0W*O`ADnCFUDfjn?9D6=R5
zRhrt*@A*p{0R_+i6iKu9Q)*FoKx@De#=}(Yvip$}I2uS4uYN}?=4U#@6HtudSL(kc
ze#qAVWKeiUOK|j0+lMv<79j=NAmdO@8cjvPw6G+>X9V%7u*^6_^4DvG1Y&tGCq!{Z
z&;c0LX_Vo%YC71T5@8(OkrSPbsVNEhA!|l7nM7i2T`x3qG&De%=Oi^og9_PAy1k@Z
zbsqVqI1z}TR`I
zR$&Zy!{1I<6Al#n<7^8zm8uu(pxx0*n%UH%(HO!sx5_ov
zt%@*CiE+H))OMC5NTXp`vE_Z*L|KlATu4%A>T%0J9t{@CCAWp#;u1(rrzD)pJNnB9ed}F%Ob@ZvV5rmYcPZ^dgAu|OHCAzPLk_L9b
zG#s1d(Y!V&K#mXxP|XPV7ML03XP}PH-oOYKy7*1d5um9#J%~RbI%~752PO`@_IU;U
zM0xI!j_?qIwDVfW>TN9ZH~XV9mgd-QwakC&nx
z^vXZd&dm1EgBWA3PmT4E9PBp+QP-
zvzQ#}NkAD5_RYK)N3>>GgMxQ+P{zBQ!gHJ~n>wr?qUC%=QWEJX(1}FMC{k9MEeld?
zNG8-U_V-Yo%rFs;h-PKRi8h-ik~=^wuOW|uXW6dmFLz8#M{EjYY=disIf;Bvbgw1I
zb*)qncZp`+f#p84ja}@>;Q^
za&oKTL}DzHNV$auX&7plZ)hc?_kv~yVggkPvuvlOR|LLAtx61jY{>3g?m=b&6IW)e
zjC>Rjh(Oi?7Ya@$)gmBOrL>b0Dx{Li)cv7Y2oa{S<%hi{ojw|<FktB9O@pVW+8yB!CAvWQb;_ww;g~>4edM
z0sHtko}Amez4TZQ${i3f4D^goAb4|#WxGO|rPEWDi4j=2a9XWKjV!`RNJp52oEy!1
zykqJW0#UWXAi=j7K{N`aNQ1kk?KvhdkX8vOLFmmUiIZ03B?=!>5(;u@=}=i9LIkEJ
zM8Z*IC+~sOr=y#MI;3bkC3JKH0U~UK4jUDKyji20gEIVfBW((_DbS|CVMc*A$T*}E
z5`@Bpp&ac+05TwQfT$c%2?!!W`jT-3p%e{EdGL{8!$Ry~3!(}lmQ9vC{YcKUDul@~
zN>vCWG;!7AOju?_JMB=H!-T2S9T);eA3`VTTL#&~al5uU9us1vcq}nkDR79?MAf
zghNWg-5Wypb(5W?YTMkwbemAC@a5h+gijAQd=
zEuXibjsQua;IX_~wbEz|8B7(LcHjxZ%dQt5c>-|^&LXW-%RAG8kc?%K8;k(4l_tmp
zU{(cCP;ni3Xp2$Fr&^PW4aXoUTmnX65l;eDw@aG>Z3?t0@G7N1TU~OD-TJFt
zzrMkE;t9BJl1nZk7rmoD-b-^?Td>Cvk3!BeMkto6+v72|p@lEI+`4zi>09o&wmLf`(*)_Wh?idO#YVsh!bV%_Tpnze1Qw9HH0
zvSPyBwb^Xcn$_;kr5}C&wrhTJ+2rUZHRSg6t#VtIAJ>G+P}-$Ufi?x&6nGU
zT(N?
zmriP6uqWN!-#~PXIV-h8OUIyfm$7QC;kzE{d;FQ>zx%@kEF*5YZS`ZjF1Y8xlOwSu
z`59@=Yu;$P*^bNxfm>azbP2+m=^P9(dPMk)KrJQrHj43Q9!-|EcMm<8%ML6rO}Ur7
zZ{paq$OF61{q0>HP!j#*4eI4srIaX@#m@c>J%h)#jL<`mkf|LdH59Mb
zbrS9<7Ii;G`{6*Fb|2alXj7m~fkQxnHpn;xM1Ovhz!`zh1(j$}KYfTc5GjEckKyEy
zAgYOEH;f27vTGIPm}aTd<3gpn3`+|^?Nj2JXGVtJaN+%@pL_o$@4Ee$H$3EWy^h=a
z!yinZaMDw2*WdK9k3YEav8{Sb%yh1RH^d+RIDE?KBj=xg$9)eztm!&@B{n@p&N%DL
zlTJBV38|m?>=ifumJ~~xs6;9?>l1(T%Qu{V<6nLBDNcw^OxE7@=Z_dRIcD%CIV_Y)
z6-kQD_T2C6;c(zM&T_Pw((sz~%Sx~;VZ`b2?S`Wji_XOtm#_NkTh2abbEU?NPgvjj
z_SDhGJ@U!VR5xuJk8~^-LfMBN-u|i2?YQiHJ3sN6heOHUie~99k96MWo_}n$ShYCm
zFF&&WmRkwOr6r+z+mn-j^^wOexNy^_KePFn&AW=Z`k7~Mk|lECMK_0|QMfLe#nEIM
zx)L8d9uA~w_n}RJHU-)gIOr5;gN%bt^5-=ez>E2de(WH8g1Q8WKuJ11JwC1~(P{;$
zB1oeqyXJ|-{LzG6AC9kvS%xjaT4U_Pe^>wJwdA+=4qo{;-QW8WnJLLrQ`sL~L$17X
z=`DAj^ubS%4}YT2J&>5n6<~falP5Raq+b2)=m$Ugbf(W_q~bZRCExk>T{ryK#x0u*
zH7);}TaIQJB^vGdhpX=V(pBgE@!r>7@-Fg^Umst#eEl!}^E|jp-2X_jR3A?Eq!^e-
z&Wd5?2XIJF5GBlsGj=i-&eTd!H4%~P^jL!xOwWx#4YJ`Ra{aGWNo9Zdqn#i6aC+kt
zr@s5Wk!yddkLSimW+wi4FZtldx^92u=(k)>zWJ}a3{Qx6s{^aZSFd{f?mHc=adf_z
z`PGeQz+9$M6>hk(`spup{_5BLANWw_+8>YdqHxDO%Qc();m%_nuMvw&nl-|yd72Qb
zT^61K&1Mrhdf@Vmg48@XA~!vbNJMu;mib`@X*mr8CfRUf->V;!uEXk^7Eu)8d4?k*
z!W=;QpepnssIXG0-~_D%eGA%cA78Z;Xxn5QW>Zh2CDN$dkuH+kL_%CK9*xzi<&LiP
zEEziWv~M8}QanQHaE(O5G>PmS9$9^S>^HY0H$7E4{xv7ao?83#fAk-<_VN23Ubc$d
z^T4i?&xRBv{JWcbt5qW$jw}Cq&-9u1owt|UOLEf-X#`X(2!aT!vbME>
zeOGr~L|F^=%Kq$a#fGk{*jQBDzko`W&}(|nO>Qr5@6+f1Ju^2UzzrsPZ*r5o=kwmV
z^UgbS=A7ruoacLxELPB?M|(Hl614+Lz6sma2;ph6ZbWMzeQEa~12L$Bt&5J(t(La3sx--?t
z@PGf$=J#H)ddIGZ&pm(Dhd;XM%Ks2XCdR+@-3vZ?)oq`-=7~b-iMDp~y>Bct3^fo;
z-*CgOH@*c>ED}~DH{bG?t3GVNGY4@s1j*3!N<%lIaZ)bSaMP*qtaFG?r(jc%{|~*&
z<#K^Q07-^5O~Vf01-R)c*jpH7X<88Jn-O@gTt?rKS{eK3FSz@({RK4u!b+tQ7{4sj
zl)lku6tKX*aN0|b=^*kvBe@_h0rBIohl0&C4-b0|Q0AEGX`X!QQJ@JjPVku0Fo;ue
z6u=_U7|am>(?Bf0bed>Pkd_|O7%D5Fw492J4ekdwzx&=-vBG#Tl+RXowzMr;F>iN3
z>8h8^%tU=)Xa3@A{@1J%M7-Ga#P8>?Onm0+OTYa29j|%i)<}qa`@4KN%r5GU>J5^N
z$IFGPs~Ir=cRYdHWmpj_39Qt07g@eYfrHThI-=*E3e!nvRpnTrQL#EYCzD
zZ6jlYpZn?yEW4U5?0fkB@>|}z{hm8t6^MmRW5Y{dvL8K1f-7iAT3R}DnF*wAQKB7u
zeOL&<A-mK)Lra%*9ocQ5`
z1%~&cQ*1%wi90-kJJNX5h*S-?5Sz}vF-cbyXm3La0#iE
zOf@XYGzA%1ch+-i2gY9Zl7X9V?v+?x3M&8n)=PhP<4qzj;-d!1owr|Jts{v>iQx*F
ziIJc%9|0`wk~*<>J7#mYQJtA7YK8^@WJ5sl&UR9*k)TX-qC`Uy7vMC;E#xK@fz*ck
z6R{vuM~+u=^B-QFD`dJ>t_J}fQjtV9D3cp+cws!UKsWOZcO!B1k)iQ_`RDw%|7&=`
zqPE40+IYwPu22~p8?W?lM!568+<5^4mo^%vsjqgaKj3OldUW-R280Fa)R{(8m|F9C^f=znm@?S0WyXB7Fgf|An~O|*o=@URRJ6?w#xYA7a0
z5jN@r@4kH1qLttK`Y+29q%yAAW%iAi4m_}7vm6-Goy`cjVbyaT9jWXj2`Oy>F3PhS
z5}zK}yj3eZZ+;E=?avPI{PRY4tKa?RO=%=nwawi4KwmGSayYIQ*|u@?lONwUIX>bgI?A|J*hkH<$rv34!fuw+odQis#)*6aXrd9Ckn%9Q2A4-#DP$=P
zM3Ly6A(>)6W5reJv3rV0(3)-u7smG}GK(Bq@g*H1Qz+&(8hY+u|Akz9(N7JHT>YWw
zKz}hPxN0QzrB9E1=5yq;pZQBTNx3?u=1Frx8
zKmbWZK~&Y!$@|{B?js+3Z2jWv0CFzAhn{V}3U>gz5&egfb)zM-PT{
zwDFTUOLWFBe@p70UcWV$B@l0HxN~K3=m}LcKXhg6zrMBWkAK>=d|xKHAwqzV)q+?yh*PRO#v>
z@4NEh?}P}{<*DwD^1$R%26wK|=@e`SBpJXNSlMF-_6M0v#+TI}Nqum#lK{X1atQEs
z=t0mIaCCGW;))~n*Ow~*1OS0S(u0#B%$PwUgyB(z6vG$vZkERVVA`H?uZsMXxM*DrbOc}i()AcV9T0txbD&z)Nz
z-_$|Eqwc`Q%l@VHvbR~4f)k1_J@?#QF}0@G8r{jn*RIi`9U(?!^tus?iQ6|_|NB3N
zbaT5JvMaUf?RSM;D?6Df#zLvDe`h(uZ@_YFcxXrG+C=}RP4n0F?SFjRXTP9!cCRiM
z3!-2Wt5U2Ce)Za=`QedxmtNetFSU#z6V#Ao&J??~JwU8R3X#zn^@IOWl*2@3!U*5#
z)bc;Rj%YQjHO0Gz5(~|P-3rN2t+j2%=)l0Hty@+u>-p8q=O5Uy
zv3DiO^yi3F3uDd)#Ce(n(VQXHsnify003KHnT}3PPELZuL60yrG&EB-2Xl>9;N`#y
zDCjj9Jj4=Ent-+Y2C&a;EwBanJx+uC1HX=qjrnF7GesXD4F9I6A5ahbKK;?cXEvsJ
zUIx2>(MQLWWY
z(vs#KZ6Fe}YT0tMmDC5_05w#H)D^+JC6-hUnrJ}bgXHZD4P6RJ4P)Uu%~gJo-O@DH
zG_@%HQ5_Ld-Q!G%Az%bcE5jBa7XBJAi-lN+9z5z|O!U{WNORoEnHR6n$3`5!=DJYQ
zn@i4FQ5@b1oWU~He6HHoo+{=ilaZ9J)k&^~6ljIro7#Iik!QUy)Gw=UV|*wA$&XXb
zjt=y#>Z}(ASWzDzDKB3s(f$F>$@eZx7f1FX!yL&M
zA-zVF_oFYAAV^u`CHbC;152rc1C%gy*AXc-SOb6*vCuvGqIz6+x)(4}kO0n;ShA%18eai3!MTV2|RPb{=B(PwO>g7{2rZ1Oe2*8||MtQ}lr&
z3Gf6|RKR)ucJJQ3>({S;S~HqoPeTecLB@$3bceC)PK9Fyi9udf8);V=zU&~0I9xGJ
z1bu?#1&`d{Vlb8t=}vxIq7@9K7(-ZbEDuVw&
z^t>t}&jwgFY!mc^LhPCbRA5&%90CeJam>2s(N+ydIKsdT#5-#0G%wix{jiX1OEAQk
zROlQ|4t5CL59~{z10uHf
zu(1d=h9t8zqYCN*%j8((SJ7#X6&6WbD8rJK
z0Wib`aF7j4c0F$@EQNrLB27%v*(x?FqcCHMMmeNsZ!|^}+yxpN8Y&HR$NtfR03NLd
zI-{vuS^=P+^hXFM7$QJ1fu(g#whhFeFif4)
ztHpY~0^@R;f)wxvndu3vS&^IGs}HgX%7Q8DpSlBOoBkJ`H~=p}q_d|O!T(UaF?FJM
z{n2h{WcI^J7Q
z^g6L>GMKHSDUOa<-7-To%066`xB)055a@%yi5>r
zJP;HO$|n6n!4i1n!LNWa$WjVf07Wifs~oxmtYs6BI{_Zt5f!R
z`V@d80818Iopu|EY*GBBy&PBIEKLB@$3FlZ8>
zJ>ZemT_#~Q6yV_cp>k}{bwmput8@ix6XYx*23$=Xx|&5!QSg_;yirbM^U)rQW`q}s
zt0Z(MEWj#*vElRTQUL}SAuTY)06UzLi-2vSHvkp5)Z0>~3E=@)DqWzvIMrjLQ@oU3
zkHz~m!UOutsabepAzC~@25VCb7Ov(~#KRfVl&Aw}VuuVFqzKd=YJkmIW-&!8j&foT6dxaOsd@swiTu~VKd%?>sx
z(4@f0N`b>>|C6-~Cv&?Q*ePl@LS@*9Q&_}`o|AZ(c?P7`V(|c7+?!a(Q#R{z@Q|P!
z2suj_3OnXRfmMJb@HPui&7{jkSs~1cB|#7c4i2xt7d{6BtMrQhjYb>uL=!&zV06z6
zLZ`NkjEUttb+_SYW)^D5ftcSo_mJJAZ~b^GZ=n}KGB;wnszpN7riMx^rU*DC=Aj3v
z%`U}Zrw{z{AED;9Nr5H>PBscOLB@$4F-PK|`*4vwf6wM>zR
zv!akG8@U>}=Ye80@mL|3r{)c?Wq^lKJ{6$Cl?1-MnTMpV=ai8
zQE$+T4(%Lk4M#d3jl@bCvI?+4n{0uKL{VUi5oHlV-N;5w>|_p)kx9oPm=;o3Y;1gXo8FrIgSWRg^VPkN&+GI-19GvM-z@!
zj09bQ)3cKkEW%?rL5D~XVjvo(3vWiacj6!okbpRt&e3d9r*3MQiR{48f#2Np+jXng
z{>!`GjeVB7jviGF&vF-*X~=xVGHSdK;)HOiYB9We*4Zzj?9k_k9#Fs+7k-#vhg5+=
zO$z`ouuS(&OX!KN(ts#~#^=Ji9r7IyN#R_2IZpTZsE<)j?Jc5TI0a%=;jwIS;c^4%
zHB*K`NkR>De3H@!7NmjG5$I=dbRVB)X;Pp`fhGm!A_ZueyuYno{)K<@<$v2vkNzq&
z46)}BY#4FqkUa=NC~*Y)M_k2eUc2g*FTeDr|NGtctvkxqQY4IAtH)5!^ml{^!!QXV
zY{OQQ2L2?5jsT?y_(^RxX`5+l@hij_h**W5K*TTEgs0vU2SEn<4ycQx^pM|QuctId
zsOO!6xTrV>xZ{-HvOp6cLZwXLT*L~9p;E3RQmYSscsN8+AX65^_WT@sEF8vwBSfpyux`u$BlQi@c8vP@B)};FVjm6x9=wp%dVZ
zG>oP%xj;99Ff}m|3gW3CgG10Mtk=EX0#kr*;vATIGOn*S`McYCGE^YIPZ=YP6x=~F
zJeF_mjMsG%kUTL4=yec*xx8Vq02v?_BGCh6H06bS4XV(updkd-m%)%
zSAXmyANeRmId6Ewo4)<+?_7KBwaPJN?mDc(r|p&smL$=q$k6K?Pl8C8#xlGBeF#)M
z^jxZK@vxJpok4<|GB0l8h5N
zEDSP&+L}=Vk!6~$G}%0Plv#=t*w2-
zh7G;Fy~D%9&wJkUwrtrFkH`Q1o&zSJawvAtG*31GSO89lLc?OyEwvr-T8_vU2!H`2
z6q9CJqrRyeVvkWn49<&S>KX|8N&5w>6AM{TkTsSuSb_}m5zh8Az0!J5^#XrgO3#W;
zBm`ZfvI>ZGV8G&v0GId%>e8ozm=uE1XGK8Nv!=QPglI}KPV~Fclw=%-5ok&>jsuZT
zsaqg(H~J$Jg)$FsT}ty*cm?VOj`C>Hp!SqqYUeUE-P1pwFNxTuY#I@{rl7MucX6niObK;8dZ&=^}`pv*YC;
z{}&oZr4(KpeIbRvkHb_fPUBV4bgcA5e1I@0)PQW`Xtr?K_{vwl@((Y&xT~wnsO!3A
zzWZJO{F9&j5H|Buq<($BW1z%mZ47mZ3i=9vJd>X^-%*`A4XI
z0n{j7uW%i@hMz=A1iyGt!*_y3T~A4-dhnD}^FQMjOZ8AJ7*cuN(O?fO!KMcCE&r*Y
zmY-hn;Fm`&1nHXXa`2|!bBdc`;GX4{p6$?~OP=M#nf{4d8l!EVgOW?L`*75n2Shsb
zRL%4qX?=7ZFjeo===gmXH-t9C%?I=`c_kINcuH
zpK6x(o>1FKS`JQU2hVx(D$3Sb!!$&Jvg&HNA}NT7CBV89wijwh-L+$9TSq(2DV5<@
z5(xwY1N#qDYSsDk=3BPKF|20jl0c0PG1*MD#Ba}E+tT;hpLcK_olwwJzf<^u&aKdp
z(6-Y;d*M$yUXPx9;VIwp{Bm)EKPjPFuV$Q2uR>jvGN-{75hxRNq2rnQ6UX7~Ba)`uB
z%7$UuI_m}^D(AQbjyg!ofb14q23xjCm~#U`gQw10Xx?9i7xWxRRgnkapt$w0E>sHz
zHJ!!*t6b*8VgHvPuhwcXV?Ict!_Gg#E|uC&TmQ7@yBu5RS&Pv*Ql={v2hvld_|XxD
zhh-9_s_ig!fs?{m2sMxcN>@~YqR`oVBBpKU3?6K%OJ)jMjhdr?%5{{Scp?
z`t2#_d+!Vo20X{WhvBaaE|2|sy^ig5Kf3PRbI(n+q%}>0F)5DNj{T}vz3O{E`2Ht8
z@d?W-SaQg+j0<^w%3AZ8^&jbo2P`Q2Ih^Y}$$)6vC`vd~Jl2SBPq~DiPf^8F&h)2(
z!)fAIdune%F2CaxJse_Sl*>O!LXTQhuXH>LMukF8I$lo#okO?A&Y^})?SrE{{c$}W
z?WE5i?(1(6;|>KT(rDbF_RU5sz;_Q;OK;_|Y8=46PYueLF{B3xau7Nnyk@5VGghsb
zXE{X>B?v15GBW>A;Uct>0x}a&0@2Z-<4IRE3d<-@E&)7iY){mIR)J+tyG3^}$sFvC
zcapzRTiX2{UQvl*mr5nig_X)mj^%lPLJ&Y{n)(mB)swpn!!f`U1lbj9aQuhiJnrSN
z8c1$BBm`(hLZ}P*tFidf>sqat3q*m0j<)_M@6_D;J1EeUWc(e(n@g7>DgXe4@0gB#
zMNu-DOe&RHy?XVBKJ=kCzVVI4Vlf(xI*tPu_D3Fh29H%*i#}XOGj(>ToAOk!#)-VcK)>BiK
zSt|z-vxh2hm#KS!6o+7i_cr-r43CWX?rD@}rA-WS8!=T6BE$_F*12Rh
z=r1f{!rU9aYgMfEEe8?nDdIQ=mB!(a|EWCy{j=FpC=?Q5w(e&XAf&aeXJqt%|7<+<
z^do)4S_MGtNWV^V+*hjdtVR_yrb?eaAx{{7BEtt`K_WC@%_i7E#1$qa54h#Js!MIf
zPS(qJuaNu?4ok8E`NGn7IA+
z+h6jMmq364*nt!Lcx9&mDVklFISL@n?!n3qaZm)G#Z*4^1O3?tBG~Z)xl){Q{0jvc
z9($rFhcZqY40X0a2D*79hB!qnKcvmUr8z8`d6%745tM5-Xifs&hN27ZT1CK%h@vKg
z#4gje`tDz@!ZC14qMl0@?5&?1fwovB>4k++@zCDDTiS
z^w;V?Mi~PK*ESf)qe(2n|Jjt-xE*jDOIqSV;H!y3EgB0tR7Zm7Lk;NC2oE6AEXS1s
zN3ShAuFY!R>~Ej|a03c31h#(MJ(zr6a>*shWYX7_K*Hfe5NzM_mbYAU%{2fSK05KE
zqf%8%votAihys|tsWl~C{i0Cj4Ti+nupIQ*>mlahtwnOyL;Gk5)B$iMJGj!H@s_!qgVcH^!^_kc
zn&*{>tYED6Y?)ZN3_kSA0HHyO^131cp-cS>hY0if90%;!o*f*Ny
zgc04Qp)Fm!h_{X{cp#x^6Q-$u+C#vzbdW({*nYYQzYmKObPZM=?4IqJg)37LIf=Z2
zH0qASS(?NPKwiEkXxjRk2WN!>O?AnvkoEXi3VZ;&3fwoJ&-*bjV3X0(((@6SyM?i
zODAzJ_&MYmJ_83&#l(#*OjfbQoDXFI*v)a>f>+|!*qW{>F_IvN4WkZIWR6CWovoG}
z1Q570?LO|0$Z1~RJu*z;53oTHk#3Q5m?J@&erR?I_$dN;)0VhWt>y$m)JnHJ>b~H)
zi^qrdKuLgi+s9l!G6Mgnv3ET~2n;Sx{wrHt?w|9Fgap)^#Is02b^%kP`^gx|7Cb-v
zqpA7OIj9-?&!~UeBN$r5-lv8b-XjR2;+X`YA((CLTD;+b9pQFr#$K;D!5|uk!w_mf
z@Np7PaZPo}?7TY7T91MPkY4y_0VO~z0nl*s%{Rks^~^KR#8;SH;8&Pj_;L;yVf6I$
zoPGA$*I$4A``-6HAP*eze>#d=HBUKRC;*N^d6LIhXrDa>g>|F1)a0>)ncL%B02!FL
zSxov=HBK)9qww_W$8C$&KpO$BgOIX3EDnflVr7ly&1Or0u3Rt34ec`RH!c1SRgr*u
zdqkrPeE3a30)$^@SzA)i>qbM3wOVe`a(RK_LNRM-XwSnBy+L7zc?)6wFi@H&fdO|0
zC~5$h0UlEG-oL&DaZLvy1gT#=g8o0bRYb)mwqAz^hhl1Gpna089WVAV*2HS_Q~}4C5W|cn6L{PyxRZKwuyV
zm|sBP5ex<)w0Pw!UwOj~HvnY#(hK|q6mn8@w%N$zL;)~GuTbWQ4}d7OdpP8Ri5*DX
zsedNm2!8Ol-W32Q_=a%Cip-b=CYl&wD;`N>On%?NJ;v)=7JAg3?
zIG~%LIAazICj^qU>No%w%~hnA1j%I-HW(n1Feq@lB?xw0ME28>71?GmY7T<^0UA;;
zgz{InP`v;tOxJ~anIuxARwtxNVk(I;q*9!$HMYemhnZUcc=veL4dfN5e7gFly$tdg
zgSvbJIRW$VuB+G#2Y*(_cF<*X9N5k>tZ+C2f>?&2Mw5_aOj}j+;OtSLsVRFr6%YZ%PDdFGydf`oYX4oN0Su}Hf}<779sld0LaW23;+SC$@wq--@BqPcI1`35H|U_GfA4I5uCyEM%oa{_YBn20)S
zIZ`kJnE_sb*6udlaPWk~2J+Z?d`xFkl>rzj7%Yqk04}ft4o2xC1|T&wdBm(ps_+r7
z>UBkev_1fgM&&)TT&TPR?ZUmN9VOMIGDPQ?Dr_?mte$EX&_sX7)B-ILCzr=b5Ch54
z0I4^K8i3fv2Ew2M0hee7KogBdK`kSwxM-T@W7?<^vkq%hA|w@3(nvH&ay5!jDRDe|
zjl;KrAgPscJH)u9jdcl{K}=ZuxPi3jWDS_G<34hPAvKq%GR#P)xv8(E^E(2Nfz%9)
z2?rW<7F~uKg{oh?#-i2JLZfNxY#y9h3Q%EIvz!7HfN5tW5`iiN_M1Q(=n+5zwthBO
z9K=5IqNUSmAPnD^6-O2>TnIN;Ad*_G2DAYzf=Y0_S(+4}6rgepk6B@grq&ftP8XG$
z6;b(AOaTuX8<=cEv`3KyR7Phx3*6|q7t@hsnL52_Fm-e!e5ynV!aiv>TLON|5x9&}
z>48h&nMK#g9#dlt+pcO=fyknyh(yd;MqGl&1zbC(UDwY{E9n}Yst-)UX;6p|EQQ%>0TWbufCMu0SjwvJ%}jzk$Is#M1t3UW>d%tn^V
zz?4MP4OrENqqan$VKNH^0j9>>boWK?e1zc*GjI}&aL`TKSyTj}3r^r*8(Mcc_zpv|
zBs?wR-^|dxSLRR%z=Y|8ql6Vt8%Ds@IYy*OAb+^x#Lm5o4=_UBQ3s#1HJ%ZREo7&m}&vqxO659M7Me-api>&Ft178z1Pa%1JECNkC56H$hIcTm6g@gr4?`aV96W66
zSe7C%h`K=n;>18T-Xaw%wSekb?0DTi9AID{G7DKHuT<41?OJP>zNz*cj|0vBe?Q<&fUauGRG*
z7ZfBSN%GF^x%u-Ftk3ahi$Ij;Lf{1342L#Ma%^gN0jBQSafcOL8^#(zVj;H(;1Ki>
zWwDjb3{+X21ma|Jv<}6H8mB6c(P7fJUhRLhnr`)cToo#=K}d1ifS441JG9Qjw?F`y
zd{GUO$xNO@q|NrIdtjnsI&f?ARTWP=p9jtnV6Z|Oqgpsl$~vi9q`jLXwvy{ddn$n#
z+B2c)XparVW;qD)^^`l}?u^5Ura~;0*Z{leXW3)v@RcJt4$uH3F*!MjP#G}4K!J59pa$k*zzaWM
z2816t6A})TLzWp$Nygz+ZSGSFP}@e7DfKp{Y0TAzsmr2e*2dPac`mH#8YSvL3eH1)
zBPowPN|(qPI}AJi{qKkS+Gmg$V^KWShdJK
z0bsR__;!X#7u2wj&D0SK3+cuq3fb8&Z6@N;FiJ5k6F=NCnX^Ad~^W_xt;_Ej8GXh|<}q?H*QD
zw$MKTcmb&r0)Tpgo~LhZNLy^u)lPCbqNF1FKnbR?ZUr&5v}lN0>xMd78r6yJPFZVc
zXb)5&PrD;JhsVrE4RqA;GxdH#HYf{y_aqo}>(kmN2!?|ezanq9xj7CLXo8I6K;+|b
z3*YJjcY<97AO$>Eu@8g+JON;VeTX!!y6P(5Nfkm1e1*#^fCz*cI3LGhE{B8gZap5&
zZQkQ#p#Wt_Xe+hrJiPE=J4CbW92U4g`_Vrw>Wg)>21WhzFm>ipIX)hIx{sZ}*
z?iCyp9U3aV=?y<6wY!MAh7f8qJ1fP*Hx7+DRr5G-fEs{!1L*R3ho&Gk9AY5W1u%%i
zSHNw{VuIVYy970Xz3J
zXix0`<`79ycHTO?WL?}W78@B7>p=WXfzxp^TJUsLN29JuLBNnuBI0hpb*ygzWIfUH
z$ONQ8;dDgTO56WDv21-DFhMdAJkXGo>1;9}I^rr0TVbsl0G-2E5loeaI&+YwgaQwW
zHfZ;26o9aB*_E0A`R~I2v;r76DXk={?YZ)pUCH0@Kll9#T9QGvSS3
zToD>mod49>`)_QIVF5GPvLwSmN|q?X$QLtEe+VLn+0P}`#N@=6zWkq9=Tz&ZNR(=b
zOO=u&^DOTM6iGMhGE%hig5w8M`WstuG?z`YjPoc&kNZoFC$oKmZggpKG}SiGnRyD}
z$)phz>C@|tj<+tP&#Ra0mzP~di9jRX-Nn{Qj}{q$H3vg-o?{wQL*_l%-up1sw!_EX
zA62>-^-iN_cq{=G(o4L%OkGCL!Ah2{PH7Dug7N;--(mNFEiYQJKq!~3AnRvPCZk(6
z#}o8q-&W!&i&wukTtnCNv<6!IHn{M;pmqnIy`=xc!Jqsyr%pq~)QJQYa7>c3VOfcg
zR+fc@JA#^19#1CwH>K00lH|J288OQVv|z^KiiyDF(o6Db1+M
zDxGe;_+(ra{iV*FI2pualzNr<#7C>YxtR>?8}3=yD_Lq|nEB#0TI2t7y^eeaztUXYRrzdhO-OTCl{bzFf{lP{x-@Y_Ss%~kd9tw5Q-tsxm_tm>A
zwGm-uF~~^r;EsXrzOGMRO|H8xCWTdw%|XWmp^sjze)?nf4S%qP_m(>sw8114OCrw+
z)f+YRi~=2~g6N|{1#NBxt%B7j?I4|aJ-Z+^f-@*sJ}A?nhnnTMQGh;w%`#II
z07rxmRk1S3BG3)P+VwhK28OLM2&+f!%$x6a5hOpdq>m~!KMXC^+d%;F&*Cc3}H
zP6+N{ED}DOg-RCNXfpKaFMOh5R+WHQ(TX@B5?8Sm6%JddYf%GsW~4Dks>EhYlhHK-
z=Y8E|%)zliATWG9`7uxzoxZ5o8OVe=1o9Vk=2ofhm*lwdjByKbv9poBYTjUC(HKb&^Q6w^}RPscQror@$I->~c&;cSR6R^-U
z8${-bRw2klZb8q|V0caBG#YbT;t7Iv3KoJ#agr(*#t60&8)+0EE?^PUoY(0klB~JV>PIr#nOlzBDDfqOMM$;36UKT)QM
zNT5h6RUQ^8j%_%Othga?Qmd@;b=DXRi2a;cX~2TAvB;TCgB6SsLYeT0_v^w;L4}gR
z;b3;^2{LV!hq41o3h%YTn?`LbSfZ<>Xpcub&)hSHbgd1cofM5pHxw14XY8LKS)-I#
z9I-;CrCKAk@fzl_SR}7$mgJhEov-T#tGJR}bB(f1q?TYA^PHVR3X#lkmV}cPJ;q9F
z);)iBU97X+dXcRf!AjAsG7(jmc#CVK7c+yIp?#wyy5Plo_U{e$M)-)-sMO_1&%gw!
z>*YWSb`^n!6(hk!RX0d7oy}@4a<2$B2@$vxKl|zb$MFgTrU5xRdv|=6nz5pRHV3f_z)D~S
z-qGICFdF4bIh*sun;<421)Vm$5B>TK`Zf<7UkU&K;-U5LNmFCck6&;Q4{#7)y#NeZ
ziBuT3hKb%8%gYFj<;qaW>-m~ie1B8U|BYkYoiB7JRHE
z*9!yzw3rwR{81dXVG`Ink9A90aiScJwSs#C*ub4bNytW}fjCQ2Aj)&FNMsDtktNmC
zt(J7OQZ^A8jEHQdOoRZ%0r0Gay-0DG;v~rUj7&Z
z8yj)tV3)T`mZNyozg=SV1JHXP%$Cc=!GXhbuJWe`$&fButT6ZSgRk%kV
zGUKgr1Q`z}`t}{D7D}N~B{W%dyB92n|LWLYUXAwDt9GWSNotE`sv4%Lu1@r0Bx3~P
z^QtwsZg9DQ@#N}dj2g<05C>Qj5X9@n6fNl&hO=aJmL7rsD(xZ$0uPwzD^3nRz4UOi
z93KiaLB>qd8Is$*gOkAYKoP1cdD(#^jtMJD3#0@vo1z~JCf`Y7riclHE7ma)f=`^i
zk19pVMXYQ@nM=T`oOcmSK(S}}rbq0KCB=d%5zcdUOumpV3-yW-3nh{Xn3-Yn^`1sd
z0}u#7=tIRq-e)F+}QpCkWsV+f{3ux(Iuwh
z#gTr()>;?0upNsIY}Ptfw2F!3$hLkq;4*=R;Ti|-o78FnQXxu+;5pSyzEmOV{0^<&
z-nRB4Vpc`?c~*#4Cb4via8h-UxH;1I+(mRPZIM(f^=!ow8|I3F%m8sYRAxz~BXoT+
zcZw^7_>^eQXN`F=8RDFIF=cg3UaK%mg2K{V0U6_$tUv40>}c}kFCAF3eAn{Dn{K-`
zV_U0s*m!b9JDcQ2_EU99v&?Y{G(pD9
z4iMYb-GfyPR^~v})k4G7Acuw8lEunh1XJ})-+2}mPYRueV7bjgoI8sj*yq(tHEe?-
ztnL-)oH3tcr8uiMJ!0hu#aBX{9E&wAS2wYG3@NJKu(Uc2sxwulKnA=4sic=`pqk}m
zp#Z~Rfa%CEA(ymZ3AD>DMK~j(KNlIvPygXTG9N0JZ%2(I(ISW=F8kkSR;t?)VcfR&b
zQmwoBVhNl^cMO*kU-1gWcj}rPtHoP50E@{S$(HT5wF?AQ%@^!aLD}=z(9mE$+7TMg
z*7QbWX!F>sUrYAy9EVUM5LZ}5uxa>@(zm}^yZerMxx~d=`G#rh7AFVD?|(G%u6K^^
zzi-I#JjE&k5?Ze2DKD%JN0ce+)IVh-y
zqH=sRqX=?T4I(zit6%xx+SMD^uDR`nFZlUOFZwvzK0G{{9UObtJNI4l`Nj9#{f}S%
zQt#KkWsYYI_?G_hcJlrY_WWhTd#?DvS?{}Qa`-^*ITu`-*U4m|_TXa|eD6o<=f9{A
zjb|Ua^E%XX&pm6?sgB1V*!jlS@A=Y~mi+wsSG?(;7Ju^NBbLFyL>(fRA6@s8U;pam
z?|u*eqaRPybYtSpyB-}iDt5=J
z*r93TWO+qS!*(`7#!L>nZ|_#q;X&uZr(9NaMunYJ(WneNx()w2Xn8H&vb2)hsM3J^
z$ce1EmWCttENu&!VrQqPp@g!=GrE>}2ZGSqyW_Le>}qwSpC)!Apu%*-w5pW={96Pb
z)~6T-%oiXar6Hb5YNh5y9hk}SY1TE%6mZ#&`EAS3Ab;6Vm6R4mjd%9;-1h+Knn&)w
z7n18}t-%Ec1U^BfurcY{dPRnooty0
z#Yts2H#|{|w=NB;%i_tEUC&ultX4W#w;dQMcg;U1mOxafmR*nUboqdsh}uG$yc^
z|LFL`NF#F5tJmbT-5rZ0Hbj!$x+CmHe=EjjhZ|nAzWe@%&h734e9XN4ipxM7QO$~>
zQQ)yJeED6a#-`qd;a}Z|lq;!fO#sO)C#c)X4ZkJj8i}WS&%fxRoBlwe$)0@K4ke>v
zdfx8G3lMeA9eOrfGA#vWSwT4MJx}F>j%GC&*qyb(?wV9ei4TrkWAm3eL;;K(!(I9+=|dmXFSuAU
zIXmDwf4G%=|NE;y_KA%=pQ>tkfeHQjj=~48S{F%)6QkRLk@iwab7Ius6_c;X0^k{q
zW5JMWDN_{%Arfnqc_UZCyO-Jg;J(F+&iLfVHWo@7ckKc+B-#8(p*;4WcF{_Udp=o#Kh2Lm)}vxVvR*K
zQL_KQP~VcJg~`3;$z1QefQ5v70C3GRhbhnm88bOJ4D2j;#Kf!TGWxvME`*nX5e8KX
z1ZfIGa8T+{1*11=1nyZKK)L{5irK{CNMJHNOfbQDF~><;YB}C*>{E}h<6h8lY8t)V^p
zc58^a)YFyEZJf+7eP^7L9T?oPZ$ODiT9vKVq)%V7_nr;p!t=>H-y}SF&X1x_EKg-lt?aH&E)DWu?3&`#NGu9$ZP&F_R%XZ`p4J)a?^u*mM`xe9Xrs{7PZ8X
z>(t;}&l4w`n=EF@l105^6Jr5|{QjnwcXUg`L)+%BTD@(<-IGHHB2l>eaJ6b#7H4zz
zJZav$Io;4E$e79D0bppj6~;DN(lH1w?)c-ITayLWZWIeOS?q>csLdDQvx=C*@XQ3q
zg__pau*_s5o>~_Yry(gCmRWu%Pi#?;LCufW_0)4`{Tt)*wX!aXkZ;FbHa1z{&wc6V
z#4yQC48~HFK2y}7F0C}!6AI0EG?(V(S*OuSeuMdaoy8hi&`0jO|B=PZQX98rE`*^Z
zslMtpn7NPzW62U7A)g45J+Un#jp5TK!tq<
zrCKyXlXvafy?eo;h38*z%hey~ebEap-th1(ANcTrOJ8HRcXqw$>-WF&o$>2_w&uQv
z?)bn})y$<>Nd5vaDP+C7IlNuk*h*tk}6}>jU?Z
zAfM^#YJrohZB^mb0c2mRTPk%snL7nbB34!6Fw4dAhp-A9ZFnAUXsoZNb7Fj`t#e*x
zY;2Zwq9YxIviPw_$frKGR$yAL{njs$fqhQS*td4${ttD
z-g-w{aWaUV7d-z$*Zu)7D8+Ja=?e15qxr=v_b*$r?$3WzbCXtYM^Fxu%iq?QD-Fd7m`CkQ=&6h8^`R2!iiLSfuBo|x+(+wKpDG&^rZuCdjt%00obbS1U
zFTBupey(d`Fwk174!{4(*9OGgnd??x^8Sr)d)rF8p66JR3kjU2AS|~Uz$*RNi8^an
zz;oDa@M5&JGB61^gm|9i4Cz_a1|d_vm`g^;*zVzIBKcom%Y6D{qeBC~dH?&#L-&yC
zM4>g5{^BR~E3OzW$v=s+-}$Tl+B@P&Nlh3Alq&Kvsq
zFJkTO%D2A3zU_^VBjDd9myl$f7*%mFQ;0{&isj0=&)>EFEb`e;w6-RLnTa9XJ*Lvc
zX77IcqK{tvz{btwIcJkkT}|}rs2Y*e5#Femu>xt9xle&6$e777Vq8Sm^CH*Uh$;k2
z`HJKs0z^?J0mM6od4WU5sQo1(6#-)~b?@F-LeN#jX;P?52@|x~I**J^j7Sq+Am}d>
zpvk4+`iof{NBr#+EILgHbBc7cRxGe2biqs4{?qFozw9z)&n^;AN}^cr?U^^Ye`|Z|
z!av<|*Hu@ySY|F1U5U7CE0_H@0!wHOn(0G_W`*S*yZ^!a?irrUY}>GbuKrt6twR+9
z@6{c5jt>u!p^?1{7KY1>Y%VvF&yfZ56Ns%KD`p{I4a%`7%?)0$tm?$%_#gjoY}4c0
z4)jw$XrAR@4)GuVan9Gid>?c%L6!XXf3JqALI2+E8iIfcc2{T5&W#zPL26ZlWy=tX
z5U#xL%tdd0+s@11p8EaohJNw0`6CmL$0IPbDs!U6NbJY1zNcI#e|g|>Jgx#Cq{)L=
znx+IXcVpocz=T$;Lu9A`BqQK1B1oXjwN*C_!w#E
z|Gq@p)-2SAMprEBzU~Jy%c{1nU2=h*TG^rZ@9paj-*MY&5{i#+A56DKSTWBz#%;GO
zF>6E7AX1uH_uSFt8Y9VM@XKFXo5>D$b*2lYq4UmLv-Ib2Vu#zh0&jln#$;L{O8mO(
ztVK(go_pSaB0G2p5Ggz?b3gumFq{<26O%lV|L3}O`SNZx$cPfuX0}-xg(-#rMSv6T3Mi;PwGpJ7{4f{zPFGMaiIsik3F!A&;
zT!O6yHB2!u@gw{mN1|S=PYAmYn}QFJs*1DA77!iMBJ}@Vcq*aaL>fh5XUOWsB`6&z2)-w?`|A>-K*0*3pyQ}W$ZyQ
z(kqNl)EY&FQ{6_WRwS*7g$OSGpPwO17Lb2`TQB;uig;m5AMZu|Us~IBcuL$u9@-{)noSz<=vgnx{BJf8q)$-J%PxA#3xO$-=
z6c@t&`$?A(@EEb0X<+?1x3ZZ@VoX;T{8AB;hz8!OL$S&sSCfAhjUDdoQVP;T9>Q=~
zn&G86i%dt!xp~Yb@mPF(bbuk*i(f|mcneu`20`Q)ty+|&>N)3-8*d=zy@-T^(*E7K
zkZQmBQpn5^0aU;77r*}AcQz08@00~+a35LN*ZHQ`UHbS#8_GF)f+95FPC2hT*wLnL
zd4l97OQIV#s>o}Km>HFPCZ9@m#MMN8d=l}uh6na_FIxTRgXF>&FFNnMb3XT(pTpb|
zslgaiU)lEUyKevA)}%78E1ZtQRlx{IRijQ2CrV=Nbb^OPLRVW#ua^LYbAyj9TpYUm
zGIGPO$h+SG+o^25zB?Eqh1|XsD?9#j7rFSN#Chkw=;K%4h&T^?JQ$A!$_4VB?_3`U
z@=rYe(0S(*6)FQ*4IueDG=wxhJC$?Hxe{bcb;2X;aCQ(Ypxh9R0V?pMQG;YrM|jg1
zym2{wXmB92`Cfs|$9hCjvDmbP5g{VYibTQ?hm>T6q!9mf$9BS(TT(<-NdD1%fe49o
zDfL>>vC82v+rC_Yg2OULO=C!w%EX=MSsjc;VNGKuknO#g4+U6Q*dSwjD6Ui{2Z1YK
z@SEyPjP2T7oXA%zh^FHxDlA6eo`x_aq+XnJgnd=
z0^%OdHIYe<3cH)-_pAn>e8*c?mBtF-!nQf`n%6Ewd3F3_2|nl-0|z5k+)wSiG~f^Jn+LGk{|wX=lSRVTohbzyK-@d#MdT<
z5ni)2e}4C6ZzMPURxjo!qlpk)w{|^tbI+Q-u|1m{E!Wi>gS24r87+ka+rRT|^5Y-x
ze&O?PIBPwrS4lJ|!9L)w+ZTQH%f>7I;g%0xRsO)0h`l?qd*?l!Z6q@?G&wTBk}-IJ
zjSe5s>&0*g58>p458nE!e_V!MTy(+0*3L+|RDk-XdwtvZ_~z?>O5XLh-1FA|<*ao?
z$_luvC^UoI$$&}$u*QpcEW(5oGof@*F%(3U$%4iZIdLV#l
znW$X>m=k2Q-NA
zS@Q6Gis4~4fH5)&*2{$PXXkonqqXv+E)L<
zzxncGz1^{%kA@*DDSRl9z8vY!IYidRY6dHm*(~teLWC`3B2g@omY8jiuMCM>ga%!{
z6D>x~4kVf_kQj)fjfr=HrZ1x8pWRl?W{;1pZVIx{UnHv};fmg-k)`XOchj)BiP-Ig
zNm5wm5rcY^Fgn9D@Xd7tNc(bZw`ra|a}=QdKJbL{kRIM7D)T4E9*iX=5F!*GSkp3_
zo>&*+pAhSg$VsNgX-+-VO{y8h^kk8QGZdAo^@(7}&E?9Rovc^tz3Y3+`?iN+Kw(LR
zj1`Ob*2+c@yr-o;xo1y2+M1bcw6%6yc7s=u71$XYG2-#4oObta*)gwcJ~R&y5H{)+
z*K|T{>GIJ2@bdZPo&Di>!nMR=MK3pMp=iRkrBn(^i-uM&ixOKb7PW>Gi$x5x7D+}*
zxlE+BooG%mp9`uylpWE<%SwAUN78&DQy1KYy5=MntNH$ZQ;W28CM)&Fk=?_nh8b5b
zRwoxN>KWLh_bgt&cW7|I!d8;sj=)vR7CrIsmP=VDGrE6UdpHshkvg>I*f}BK6twh`
zOD1=Y6~dxAdpZ9A-x(?{g))+Zkb&bF%d7=hKF!P99z9FtHY(IK1Qym5#Y2jS)6JTz
zCKbEVXf%kLf*3)Bd5a+NwuQ9LRQ$@Z9QKr+j{MG%c#F`enl#{t5+}T)m5QiILPQYi
zk6%KX*>ECJ9?yl-axtSt(;=f$5fSegsft3-eGJGcFG!HmO$rv0&bj(nMKi;#M9)z%
zrjVZ37#vgrcBKe_65-;qX-t%>I8g`&6P3m|noV=B!ug+}zz&I_Fp0wdmOhbqKJmeG
ziHU=g%FY?f&wO~&t|LAy0=3x|QoJKyC5?%Oh$XWcGGON3yybQa}rUI!66wmeYa7N))F&-%Oc!3&1m2$QD(9kbG9xh
zQ>kYvW(rt(IzSKDf*cCX8STr|Kq3^ZZWsfGEOdX)!dTk4W_daV3{4NUCEQXD%%x}5
zJSRgcMJo`Bn$`dUw8XlU;;x!AR1ZgbD*1s>l*HzD)CP73)AL97ZHpOJI0)6E(bmyX
z7zZxltN9#Kx3@2xZ{){@_Y@YakV>Qdk#I|Pd;(UMu>~oT-491oVOM{+LnsX9VrO(l
zN9(b!6k+5&+x7}VE*cRvEzgm*cq~N#Fw6=8Rp%AC#cU8+yva?Sw7CF}%ef;4-
zh)j-Bv!QUv5Cmpq>n6l_Xz7WJ4?T`Ftf{te6>+`TMiQa+f?Q8;@4g+|=dGB(^|8B`
zCru{E<3iIcxJIV0ua&85^+JZGX2ZkmLQztOx`Y>eW;l1`$E+F>3Brx(H0OI`5-FNv
zEJ2_#ND>%lauSo5Agi2JCs{h6R9lf$jB=w|gzUmrla#d^6|PdQCprS0S+^Tbc*WZ4
zp3T7!UTsN?BlSzIJXsP7LkjZJ%ETz>dUg=rC81y|6KUZzq^%HUIQyu=#y%QDE*o?sJPS
ze_Lx{X908pQv;i|@DG8cppd1jK)e+!vZjHX(tY}lcv4e*gG#_gS_40vwtrXerNJTt
z$Gs0uraxe)4j(Q5D?mLxh!ebzx6tHZZ)y|SA_4kg1Pf~s21i8O4d4St|K#nEs?imp
zrA7%xY$GXm8(wcrakqD_K!?1m2h&-$!I8hd7|36>H&aBym-oL|hu_-^;UB
zD6Yn1B$^!AO)*145%*gLqUB%|=5X+udI&4Rv<~vlH7F
zFG(?y+Zfs3)egDIFtM|h(f|?48gkOAgbfHbgJ@SW-ZGh~dwSGa9#BsyiI*HEDodf#wTfB+(c(frC1LpBV0hrZr>uxk`Ry`pnzP)G4yau
zQo;(rqcx!eX@$~!cz&Bn-0XU?4S
zJHPWgzw@h>!I=TkJMqx!2-!do_*V3)q!SNQ#<-$r3L*cqbD1+dSrob
zYD*y*!}bq4X_7fURos|`!x+m%1PCQvu6m{53%FU)s@4l26RaKb`@4%1hQ}Q(=W^{G
z0pe?n4Q-7g&nukckvkJ`K#XGO!WYEHo+@Ktr3K4F>LfJw&iy!2zY2#>g`yAv^-&2B1HMzfli*J0vmb7^Q@)IfiP^^b#+
zKqsvD)X@V|b>|V%cc*@O9o4l~q1_rfr%6uBor-q7iZ;Uo18$R3kstspJZtefHAe(?
zHz2)$tN&b8e#Jt
zo&`^=`8Sc<=3=LK(%@iEjrU{9QBK3OSf`J;Li^u>C|&enI1R*UhZGa`tahf@cV
zE!gfHsTQ1}nTE;s&Z>6RvvVvQ2m=S4okr``6y`hG*`1A{@W*h_X6$Me&Rgx-S*^n<
z!Q2I%1a43~!EhMFuUT!X*>~)5w~fg=h?O8h(1w>TOBAi)4I#`u9ru}A=F}xKckB*M
z%jvwL8#>G4sNX7YfPW7-PO9Q)uKbO!7ruT~G-y>!Q#LHt<7I3Yf8@%_efRo9AzyK@
z1SL!FY4e(!2J$7+y)4z7DxPrduA{($+=U6r%vqG-kC0ORm_$K2ou@x_a{Q18W{{uSPcc6)MV^!?4c}`rZw~7^bV4Z<-tX@DiEU3vWqr3U*--kKLqFy0mTqgfl_&#z`hBr
zWDq+=QYqq+Kd>Mgu^Y9=$A_kT0`|TTXge&zo=5C_vF`18Wq;2xvktI^{e9y6q+$#e3fo>7xRyaZUC*dMo!Bx(qXbpAFNN|
z7mp}B5Ho=cc{w=6C}zYWZAd48#4yO)2Jbc&I!cJ1;9(E##XsxmbV2_4W4h;+e}*&I
zgz+>}g9UnGv8E1@tsOGVHqDG66beCT6iAMMpkP7}s>tIvEeMV&wV5j~Cj{nfG7dJh
z9j@G_B07*}%5cyRV@48@hu0KB39ljLI5+ZA8_4`_So+4zOAC`tL2#)I(pziej}EkV
z_q2QUfvw~7`j*rio7|pGc%X;8ZV$||kpGx>j}8oEQc*=^GfR?{u}PPk86C6RJHjRc
z|L~eWltIir(+qWV_gQ2^xt4G5^gR2-#s%{dph0aZvf@~euE~g&XwjVS6{S?dE`oXk
zYKZ1RmZF_8MBpge0XM7RTH1lFW!wqoK%XA-uo!gr)dF%}rk@vhWDR8cM
zG;!r8*Z=7Mjhy{&LhqusaC9u6)jY_MqO!f+z2i?w#EN|7OO5aUAQ0@18rkt_q_PKl
zFz4#q2?4C`)RYECXU7R7r>HHGKvyV8Ha=B}Mc7p4NVm5p%P_TZQ?6vUtYFrj+bpuF
zfHQ_Mp$F1AFd5in5VlEJS@a;^tYX-%$sB^0FKx;R*gX)v9Wutf1LOvbdp8e&TzKS;8J(qJ--
zSO(cT21poo+cqz?UQb?vsl;D9Y;Xqp}w8mWP6
z@11u{A@{7?MUelntK<0W#I5xzG%%E1fW|eH?i<;>x$DSfjqxqE-E@0J+u*y7=qqfm
z^&NGFQp=7HPr$Iw7g<&}{h@+_)z~ND_|EH!2=(l5fMO6i@jssG#pNtUE
zM}{V$L;MR8m&3M_2oNWrIEU7q2m6Rz^6(S2bT_rga9X3W!39gh$DR63SjoUz7VU)=
z0+K@Nsp061rm-~#yLZp8k1`p+I*twmV2-{(UkyK!MN7lzcnbp1&LK`bD<~{n3~~Em
zgP+d_*T3Y-9FuXd!R}0KY;GJ$2CbYDW!9<|b5PSNg$Y~NJzivfCh#T$UH-R!E3aL9
zrdc%Z~FLMB2^JvG^W^l6(Oec(&i
zjtvfy-j2t=cul->UQ98BNOa+=U-?K~C9iqyBm(v&Qp+Sof-a+fqviK4>P&boJ)~8R
zVDwwf=HiAtq0|x|e$UhW{g1*T?=5dxcj0SKb9t199$b6%=Tt>oAB&SOeYt$%Y4h8}
zaC_UMKl|S1?_95h!}7;JVys%VvRtm5a6Gx~kGafykFPWb+B@c#O4XnKDqYjYGu`Q-
z0sG@09?nmZuI}=cpN-9*zu=6M@8bos>X>!+-LuTLvvW+w!N$31tgj`HaMs1$ixKP^
zsG$)QCCS($kB>(DO+E$V#vvMm$qvC-VHz8BNL39R0GM{8m~f_WAyKRYC>@dv;(|8N
zkcuT=te22DvHfG?a0sPkCnMsVAM^us_BqQ^i&R>uYz{%ByL{KO7!em0MeBlk4|k%QF(HKt-4
z3$cb@jz-PBV^0XoF&TS8;~z
zQyQXQsw$b7Adf$O;?wJ-x4mt{&G+&>y^Cs%tgd-)zIl_Xk$DS)(Zsy%Yq$LRw`14;
zc%`oB8`e(z&(8~Aylx(BJHP(r$1Zsz|GGCG|LLnAD%Z)-NI4j#Uhx-R@I+?^85whE
zi*+mQA?u1IJ1&0j+BaX)`I-yPx%uW>ul>rz6`wzY7}-yrwdS**?mhDr=Wf}y{>slj
z^4psNUQcLnluTyz#~#1<#^3z*y04TUU2~LXZaVKga_!aR*4uA>%^PSJUVHx1Ojq~V
z)MGAB=-0m*zW(|*xY+RD9=ZL`H;=#d?Wz0jfBWj=fBxtrujiO?g!!Xwm@6{}0xhx(
z;_WO)kV#WQE{Ft~KH!p>=uT6@4TFE^y<29UG#TpQQEa%Z(}j&;+#F@Pb`@BwAf=ng
zxI7U;qEq>%WedrSSZ|WRbTeQKSQ*pSITz2s`xk=+&SvrQV+c4Imiw0;g1|~|GiHyT71;K58c|kfc)WCE9=!Qojsvi5dxG~9(~Mz
zE6gTji~7;eS1Gce^-rGjh9kap!^E>s-#$LEe${E@!6yde?Q0h;Sbq0?efjELu7C}1
z^^bh=(uV%b+b=u!8(+V@R@RF3@$)Wy)mdjrPi=hiiH+*OHgf)Xo4)h?*ePfB70abx
z{f1nAnGg#_mn~oMy&J}_{=!lHPg4oH%WJ4=$z>mcp_LCd4$QLpD8G#T;x0A=DsYy%
zJRoK4@O4%_G{2{SC;DQ(!Fv
z7Zl`FnxVxOXx0I`nS-4tc%~M^1XEnGR!0b77TpIBP?}OB;K!L`CO1PnJ7b$Y$7CGL
zp#!$lZ6B3nP~rnStd>DOP+JrN)f(}6<3yJfSUE$(0TU%`CKx4`%R%fcx*;$ai$&t;
zj$?}Dzk&f@w|-45Mz-&mSoMH@2l0=gOs;M9w~M9juvHjRw{o&yFV&ZEdNn
zp<9}+WZIJ;D}`cq@sfE1L-#6LIo0kfmL?;i-pW`OD}~#u%WADqncTQ;{LiysIg{XH)nX0=a`IxJAfd>KzYny8UujhKAq6Od5)vPWKzm2L6293
zA+*WB_S_px+E%f>BPvx(P?v!3_J&=J>@c1%%z8BLsn(<~ed)tJ^S<}N4{!eYuU=Ky
zQ3yx6u@%{{@vQ7bUMVLL;3%9L%x0$yY%7T(xQvmp&EOzd%Exc|1JgaPdvJU-omx>eqlo7y2m+ERp&fVr
z^|hiasOlwy8BXQ72cl+(P
zL&d}M>g2@0MXx8CR?p{0w{Ks6_Bk7ew%)(|U;~
zrOm({Y!*Sof#E=JxCkL81m&usP=jqh{WueV%HR)=5BLg5>#&?-T0l#(o5P?GgY1V#
z3~YqU0pOsbXhCRN*Elp_r;7!Zm$cYHj1RW<;5lfVevT?X;i#^`eV#+aFr*=*jK@qJ
zuU7lf5tgBGmeDl|WE)2iI)iGhX>rgM0KtFUILBf*KzTV2)5TN2oP9X7-sJ?sa|kiD
z%AlJF6vpoC=;+^GIQgUvaX+2q#X9MoPk!|CzDAvNc6i%Dh;vLHzU#^3j!W^j3sSv-
z{*CQjot08~QD1!H`Ul^53HiJqps-ar3SSM@)=e(Mp7$Yqz2Q_o$pZO!Iu
zK7Yh#Klk)6e_OutDx@qTC!e-7H@OYLuQ;{>e^sc9>CVcUJnmS`v@*}xU;HBZ?)TO|
zzIOdbKT3Q)5{pQdQM&EVnG4U^!ZBMAW9VDoA?ZxAnr|SV^8Ah!d?>eZ?W0}Y;1wzh
z7j^x6MtJ92^I!Ok5{!~^A{N$An#&w3DT2`<@MY`XnbpUa
z*jmR0ls@Zl82I1nJ6*{D5O{D9fr0M>B$_msDZPqK_B1bZcm>7+4T1`RDs7!rma-bH
zMHfwm7xJ!FV3|fEXRZnX@(D1zw3`(26jNJ6;P7?$0vg;J5&#`w0XH>QUUmpz<#~xX
zzh`{Ym%Z8l{Do-V%b$gnYC9oF7R)9mLlIlN4`IchwoTb~drM|VB-Fua>eQBPFwKu6
z+JB>fq{@I%8m#cLG>$CD`
zYIJgF$uUh8Y8=&T8e!x^f~uu^#q#{%Ce9@rI%hUx>1C_!+{hE_9$tE+$KTeT-@=81
zaorw6Xpd$c{&5H(Jnr-P
zv!ki0iPU_lR2m&GFJ9^~N;1nby34NXQN=uVAL4e&&9-L*$SuDX@w3bZDKtn$ORu)0xz-l1l3=P2W5-G~RsEY^q+C4kF
z3sL_L0=P)^rw+uZSO~Df5;!dd@1)i0j%%on3PTNz^bGeWih3W^UPY*?lerD^3pO9?dZs
z2Xl0&%@GWo1xpc{eqW$)-|8^4fg0bth2gqCmFz{lOP}9If)TA&ELXB^9c@La8I8ts
z!()*EuQtnpq?brO%`lpFMN;f|tViIuk-`3+`97^6xkQ&ld@heyXbTNLxhd%NMdo$X
zhqo#U3Htn^FQ94#sEJk86O4DLO+*Tvj3+otQ>La!Iwk70b|K;;{L`@iz<#rohZRWD
z*SF-^yBvVC;D#QKB<42Vt_SbTxLz=^KSBg`|^pX|BrPG{Q=iMm@WIEXwIQv7|3
zo`ZvP9S7V%4MeB2K$zr6EFAF(9UKT#9Ug+(Lbck5X5qSX16+Gj)DLu8g%`A;p
zE0t*6ZBSnpl1?Jagc^>pjj17jiY^fFC`ojB3j@X4!+%?LbOcE>%Y${8VTb*61yQ95
ze`88z3!n6
zLp_T;m5G`xk(kEUsts?z_NG00L8cCVb7h7=02CQ6sZL{IK)N%)b{4|vTIZZa6nYU@
zia<4hw?aiimsp4MfNAc|0dklO=(#Ym4vC`XpEGj2DD0{23;IQQ2zr8o&QP~LsDz-U
zYH@yaI9j|iNAH;~_|vz~mFGcVj>&i)NDlAH@*xOr<$OYo>LX7ajtRVqNPK!O2j$D|L=?Z~K|j`IlY
zm8&2*2q<yh=+IT_WPV*x=uaz4J(_-A&39xd}bpmynBjkP&#GfX+Dcj;UAc{wOS^
zOn;gbwl?FD4Dke|@h!O`wGkl^o>Yu_fdo4J#qE=^_Ed3vD(1~Ja}9qOc}+|tR*j{J
zRK$e#D#d`_;9am$%?K0yQ!Z~c6sOV3VF}lsCe6GY@QLAtJ)~F+v6cWgeGNI@WL`wt
zgt$?do$N&m5pgRAj%CZX
z!6V`~$`#Sg{mdLGO4pD}7C6`HmxHM|fXTCw<(@&3777hYkLeZKV@j5%1@?25?h^vL
z=fFO1nfu|zLx3VUWd&R?`ZDleBn(#g8Y=Me%*aGFn&7F?2BW~@+!Z9ega8;M6!A98
zO|PHSCrF^1ua6n77^9SBH*%vl8odjA*4AyvT}o0ul9QT4h#D@0GcmhT#0ye=ZgoO|
z8=Jkc}-}st)zL;1(kK8&kyqJn?km^RTjHdR%UIBBWGC
zF^@ADIL%QoAv1|Q)bs?P5wQ^ROB>timD3`iJVkqFaic31W406r
zv;OET+jO<2A|KW;X+ENscmNy*)^~u3DwQm1kb$ortZ)=`6jIYtP=Cw8$C0Aa@L%|V
zBg9u~kFdw;N{5Cv8^cTWCNp%TpzH_tfUdOKkKW=0AFx-DTsTk$NPw;sJ0Z!y80g49
z`yBkKfd(BW3LD(gD$ha5ft_=0y2fkQD`)xtIh%}wIlxGqOd2%MEwOUxVA}(KIk|74
zULAit5P)w7RiIGx#>AkaJH*@Hg}^Nw-V@7r;&*ETI6wd0ug-O6|M7yYcjPF~-9h<%
z>_;&zLHHbsL)(M4;#}QLfS!91$Rb@==oF^%7&M)(AM|!QXR#APZM1+$As)aUKRH*O
zEiKN_ROdlDnIXhAB#rnoq>h{d{@&4v_$$tNVtDdC;$KG0Ae{MIBoc%HFGALA2Ri|#
z793jj&K+Mq2vB6f@FC=pL%vNOJ9XJvGDU=o^|~1ixgcyv>FD@t5T}8UrFI#LW@#|H
z_6QzXmo-g;nJ~r^`MGAOgkSvb($p)?)Uaub*4Lmd;l{IWH?^jgQ
zP#C`l0c%O6N+Mx|F|0=rEY;ztbp-MPk)zb_P$@IfCS#7tIGET2!%t~a^(95Z_b&)9
zShx0)T4@bW##1T3UaUZ33B3W{hfR--4Fnc(Y~EWc?}OQjL$@yUR|wKL$2A%GsCzAL
z>B`l&OsbC(rV|b(wk=X#1~36>q@KWFec;^=HfWB?_}7dnWir4WVpOmnL@*2<`NJE~
z>LE7-OTxBE)1)DvxKwY30$y;NFev6cpyIk|TO7k;J>zNo2+EqauFSIQJQj1BBmljm
z$YPN2Ji?uSdK;`22$NQ1bZ3=>Lpe=6Pb)T^8FGAd#{f{DeLP*rl@BLx3vb)
zMrx8!!8o_i@UgCIy!V!!tgjuASJ}$B(O?hjVchU
z2r-ph&BM<`tr~(Za+VbHicO@F8jbYt!}wZPOBTd>2eW4DwH|PfLV>&l>8n_aDqX|WurEO72QeWWt{Nc|L8T8DR*wciR9&{|6}{=2?8}#3ull!d7tO3vV?}?WC6sg|8Hm=W
zGuU;2CIe!7SkE2Q(VDC5pFn_Wx2d5bGDNT#7mJ4sqv4nxAl_TB*&v8pugX)RuR#nN
zxZd%H^phr5FeK%nDi)<&bO*y!QV%H>e2r$=b?kEy=u|R^A2N9G$ylGJLV+aB*9AcV
zmM51E4>AJ%QJv+OG>2_7)&8|G{ht8;CH-u%tf}itQ`LO_FlsR
zFsh>IOB&UhClcc@F0fUQ>a%TJ_Jwayen7w`D?DUM;I*Nw!hS}o
z)>Yk%Cex~7if(Vqvg0L<#k4#$6D1jQOvb@P1>0t21u4WxK3_OuSt1c7lcPk$L;^6@W>jEsELM3M><3S9QTHY*1VTv$p%O(@)B65Hrzj>jIrA|n-
zQ$ZA>tRO2q7FhU4&9dtXr0*W$^OI6lF&pkq1iypQ2uVM&bBMuK#hBcnlZvOegV<40
z?VxGNVF59XOa`kp47Z+$ncT{35rabRTV
zaM?p27?fV@(_kPPGSN+vNXFMaHTl@uv61mDqvPB1dT~mYCM9dKVNW&eoMac9c2Tj4
zs+O0HoNVQq*5PoRl$VaB$sU%8cC-k(WtoY;agH3KWVJ*a%V_l
zh@=LJ&)m@I$`JEjxq2IE{&n_^%f9jLb|T%`;fk=)?P7c&yWvNjz)$_5X5}tv;*NyS
zNz`H1XFc}7U7mm|5ayApX|5bN1m+|e2M)vCHJA*QDpwnp&ufb;681DfQy{+Nz$4Sh
zdLkv&AlBHVQwauj%HZG%2z3d_I3?n<{YY&rXg9S=P4IZB6jvua=KG{!pa{BuvOY1qr;%MOA;}>+ZgO;ey7%
zwg*C9S3KgaHK$BVfl!y@IG*P{9uLlCS+*<-_W!f&x+=?vivcrAoe|(Y#<*3tS7c32
zt+Rp^B!;dUQ=G?i1p|cb5?v<;VrLNFatl(8=_!yrRf?rZJW4rqq7{onu_(Cp(v$c8
zH0CKY*0_r)@qCkYF@o1+u)N&Vh-x83?<^aa7r-}|xKcE$S&x^8`7#0)dIFuL
za=`03s$=;Dgk(ySS~!+5fyKh1wGYQg0e4!*nG#lfj(i`?=?=vR{8L?`ihvNhB`bOp
zUSz!BhkZ9t+QwSyuoKi^-|?*n-G(hbHQ+xy3T!g;y6$obu1E|$hWHjB85+%ZbtN1g
z!(p=kn-)Om5j@%90-Qq?1>gwpp?23bwBqRHSayB-d*hGGSi;c{7V2Rwyp+2v(xWh>(IAx>R1
z9xaw8Jbt!ZpAtM~T}lMHPbTomnZ9DPk$BQj)k3+DN{3^yxZ2z%dK;op;n=ZEvLRIm
z`~m28sLHZhMvy=7NFCC2RN=st~@
z&3Y~yZCftYbYDmWK?kBw--sO!HP1;h4(2F>7Pm|DmsOlv
zR1mFGg58Q#aWGqP=+@QJfMBtrKyVcPXe&;rc!L(J6?D9%vu?2(j>Nw8>)i2WhX9pi
z)Db+whdtqWIU>>
zx?#z+KSfa#FH#jiUZH6&xJn=%hN56I<3rp$%q$ELMu0P<{L{WRd2-$V3g$B&c2H!;
z5r3*R`_N!|o8hKGGY^mPqTV8$M#J!cCetuKrp4+ePl>fb;!<Ym6#{MAYUhbWfWb6efFZmJ{(Uum^Ss*dXowU~udjYyjdE(ZBig1aDh)Hpq
zM%>#OmH8#Vb>=(>>PFeF7Gr^b^c+jk&W(ce3k`nkkUSh)rL|n``Zo9fWraX%Xm$>e
z^JWYOK16Ryg5N_*Q^z0s^$qKfwPel3X%hoxDvj8nlzclk&-$aqQpp4+Jq>%sAxjWr
zg6-gJy;9D`xG>KmWdNd6Xqv1Hj{PT910uhWs_HuAd9(mZEmp$;*M1zH<1kPaI2D#<
zQ5!3=xk)LR@PWf9<>hEx@Fi1re$5H1Z&?4x$?y^4osBttjia`uBnjDRXcuPvNTJUr
zv8bAw7Q?|(Xt!wyPznvxY(_(#k=%a~87d?lC|s9`Kh(N=?sz~Dm}4>y2z<|fn58a%
zdz6*{0~e^N0e*s{1M4g-5RlRbUunpJ=T_N09-F17RDgj<3eR;Jr#k`Uz`;4REHFU+
z@M&F`rNEde-P&^yD9SoKqTuss#qF+$f795t;~Q@XiV|XGWaeW-4YwhD4y&Rwwu1PQ
z$c#o8Z)c|wTNsrmCOsiisgSm`I65_?k3F3@_9U!tEbDN4b{FM%&TK8H`C
zd=>Z&j}!h_1&knf!l*UWrfH3jO+3(d`YM9dQH*Lg3Jf1c(uFw}`UAv{IVR%(0r+>1
zJG*e_%5%KM9=}8K502TvaqQQD>DT~K^|mA8*yFz0drIZ#4ujR|BECW3jB{rhgB;hf
zSKHNn=VnLrzU#`||Cbp8Ku*L*1X+Gwp+VAUMjM8y4v*-XAqHK%OH)fUviMLOq_!jM%6{p%c`I@&=KHhIsyzYvEj4{+w)>;
z`t5H6X6pUGX46d!Kd}*;7Dh#gDO|^hg@e4{i-)5Nhy<02O58>ufFLJeokP2+`b_Qf
zzqs9VOvb?+0J<(ZOat)JId>{=Q6d`a576Fa`AOLe`s>~(_`z(_p;Z@p>ts%8fy5DA
zVguX?gZP}H1Z>Byv|NXhhx(xf$(OG+ln5?ls
zrb)yIB5u*O_HZe?X0Ju}yI8-mXgQZG;%yJ8**XGaR7Z#}!Hf(Q&OGx6+pF)<6_fE$
z#u`Eh$Q}ZL02qR1v$?-E8F(BI0{o~7Oa`iQYOpw88?3!phEJuD=g=xojYN_$V#O>o
zOc-QpgfK&O+}!*GSFoBgGQr3lCIy270~9#^m~rav$0#(eIwE@tTDib9#!F|NeccY_
zJ;X}es=&B;!)kInQw<*`0GgI=I&^+oYCcRWMO*=z0MPN9z;TZc%~wM0Jt-ZctOiXw
zoPheir=L>-4IG94=2-V4`I
zuh(hRxk73A^6$F5L5_6`Zb8Zdr-9$#M|N5E&hm3-glLyVWZt1iDlMQhytKV8hNxU8
z*-5HZTl9vukN*%HnBWgW2mv2UJlSFqU`~N6`#aQl7K}yfDTpyzJPKqREW;_X0rLzP
zTBvn7($Nie=9pvtgQi-A+=9-j)(2^3z+pHBC9`~t{vI2#Z$az;Fc#o2(EVN8n4mw<
z)4gCv^G_sS*Q+W9q@m!r7tG(^k(#@I7g?W!#KC|7ja6q8(t~1>kD>^@@6{@Z&Ij(MaB)Rek!Sd7b
zG<1RHV0HNB0~wyf{@FPu;~=8|uz8OO+p63lJrtvN7s_rpTr%aA9q|T!Yuz!skBH+$
zp|H#Rg0dO_lR#|0yP@)TXO5;DcRKg~-7j-rUN#6|aGd4Sc_DQEki@stC4%T7rk}V1
z<*Mv*VU^-NJY#347=cF6z@XA~%ZYIUtpF|{P8|l+xdMMGXH4l4ZdUMaaM%}m1nyfc
z|09!bG2skAXTu&>P$x}2ZxKiiz>2o+hkn5Ent+=GeTp@0nq=LgiaE2@28X)^3y+xI
zXbcPysPCdvGgw$890Hp022#sXE&(zI-9l&(JWSO@s1do(&>zZTu?V?^XikVohUKb-
z$+${UnEp!NZ6l<&PDPZ>Cf5CCoiGAU8=+8VC=j4&YDH6)k%%jZ`?qb|cK`kNcXoDm
zb#+1aL2KHd0*y)Qb`i!ggiK6KJpAy(>o-2}zRNyLHJ;hkhn&MA*6*$h(<>XJ*AI7cclFW
z#GEV6ufQ1^JDu`dbVO*XCI{NkDA}AzcUf5K(GrXoc4c@k^|LdnTod(BIDqfLYb{7$
z7(koWk6$r-Cg4x;4_9=w3RRf!F{O1?n)jdMQEUDGsN2eVoTz+uNHNs_ax
zWN`w8LJRR`?);)`0THp^1*Zo}!GZRhNalbb16W5*U>TMo-sP*yMNR<4R~Zom8%sZa
zpdXg#RC`F*eyaWAytFmJ9d=;LDF1CWlJ)CWO
zbj{UlYOG*pCv>(gW@x&lSxSSGDzNcOvMwyDg!K{5E!0)b7^_w|kCy58~5?Z=+5?b1uOU-hXmF0f2dSk~t;OkY-Qbh!L#rm1K;>kBc642u&>U>R{}MCU}43)t0$sp5r($cbI$qF5{OY@(}Pvso{A
z4cy?V)M4tvHxXOe$26Kc7mFIEEz`!(w0(HAApry6VN8h`g#bQ4Rq)R^T5vrU+#Y0v
zXw0AgX(D)Fy1fNu{1c3mUVnu4Y
zeF42Rdd#ucYM&1`e*srBt$Y10%WxygwlE3mQo;`pXoDiV`x&G7tQB|DN?wP^gwP057F3t>L8
z*ln2Q!Sybm>I)I6Mkce(1xxxG&1yJ3Z^tvbfIU3%pr7@U%({d|uIveV6|-4WxOgJN
z2+i!2lv%KJa_jxcIPtZ43WIVy?tqwfQ)g+8We0T`!X*(!QmdAXShwgG)rs-JP0xOo
z1pF|ZEmcdu``z!p|NZZej*kA|2R~?0r2R#eebKS^zwe4Ked){N6S=EC_387^K9{Cv
zWJ9N%@_*|d>7?QZIvQY%0*Oa{8%oL5JM3pji+i&n6G*R;ZmUz?O52%
z6}|qXBG=t*@xo{}p7dphq)5o+3rDqb13X6{7&de>+`Dw>=}kS0<5I4Gkrmwv?+R;8
zMd;{lPL6eUhY_PxuGr8w*?N!>GSyMzwXed(faAx1!yGaYuWqT3^Skm0XPry~{DK=1|$%1$Awg>Z-#r<(?d=V0!KL{$*i
z#AL;q((ni1E42qLa)x^Du)h$PwGe~|v0AN$!{H@MmOv~Co&zFEtN}Qgl?7WF^y@i?
zdz`mWVODnb5bRV7+TifeHt5>%70U*=js2aFGv$7_&(|mxgaf2?wIS@R6R-f~g6uFfyL%O(og`Oggn?OT*UZTSjWz
z_HsQ}6MaOnnx0_L$h$aZadkW63oQ{sOEfDv^lY(N7Q=0eJi!GPSy-1-neJmZZ&e#|
zI-mCjB8#gK$8bSIhOj2$OD)ERHW*F21mf|er?N`DMna+FwkMxSuR5h%LPQWg-hs5M
z*beWdScTf?b|tnrq08#f5cMVThC)CHoZWE44IlZ)N5ElVReSTB-;9T$>DXVC#=d^9
z1vUG8p2r@2^d0Yb$IpKDGouEN5_13jZ`?~0aS4hAUKPWZlV1s%qJW_WZNqir?}py`
z9&+3nyesm=>hnAoTuSbH80?qQw)#kmjXnO@R4J<(dcYmb^p9$cf4*Wzrm9-gLfF$z
z*+>%3r!X$X3~8pfFqx%>4RR(HT&gRbxpAW|$u_6eYm(DWW=;;qzSi>z76)qtTh_zVW|D1}D74hG^+H<4feCK2%Y^SK-_cEyo>3m2DUQxg5&(b2*+*DAUE
zWFR>CKmXHfm|{6EoPGB8D?dZ7xu)dvkSjh=LXy#Me;W&X?h~KRU3h8xL$|E|)Q8B|
zzmfacCkK-ma@&JPiiJt3WM}i04_#i(=7=v$-v1%;rgxt{H8${?H;jDkYonj}V)d^3
z+c&Hm|K_(yp^}Xz$eZ3WeAcTk6oUa6XOybVOD-(-^pfko>0yJO>_kB`Np?a_rZW8l
zTdx1V$NzE*>FIdzzke95RaBoBVgaiAe?FLWopc_P)F*O~xW{57)^}uOFz*R#Cm(an
z+GhqKXoO((p@$yAw8h2%{MP=?(-*k^%U}NT=f7}mrCPcC1D6kOd;7KDdS@#v$MYLW
zMNL>tk>MP9;6+|jT$+sJY0Pc6lHdIynCvySKDC(@$w_DW!{J7(Cz*e03+L&*_Bv$x
z$o2H*zVP|p&Uwe@^Yzou82iMPSRz*N}_eoF3jb`HGXb
zU;Pg3n#?XQ+TqeC2I__;c_0)8m=;_H)kIK0Zp8E~tFx
zdyBo9*wYVge*2rqXRoUK#5B@-cHRkiF;4rtiEG-eek*Y*4o3b{pJJQSKo
zB#HXnczGbFNeq4;Oyu)xn7gts2+Ue0qopGUdjTQd^5x61r);^TLs`BrSj_0_p!g_I
znqX~%%m!;47;|iu@O4J_Yo;_l8jV7j)QT9L&*z~ahtg^ma~P(kQ4dUn$#B+4xt!-r
zor?-i#7}3?9Nxl_HbcBYB^;QNg22P%k+NTDB*WAL!L+W4QFm}?WWCq#|IBAbFT9YP
zd;ZEtA6xg~j|~3uXXlO&Yf6*+?zd#!y0g|iyyHKv8+h;KBOql
zE1Js2?|g6Yp1&RU=$bVbpS9s@|Iw2Ow_S4SnqU8-r|*cBH{NvH=dM-Hxnwld>GsCS
zmeK0^;T7Yf+duJH^6l@WI=eFuJiP96UnVENS{8khCrZBh&5>K~SR&V>AN%CP-}`CY
zAB^f+wQu>U<*Cj8_nXosuWSG8Rg3>{<2|?CR(kt;mro2llSxve!siz;DmDgk{=T-_
z=v1*m+}Z5WM}I@HzfpE>g~usSrWtOJ&jWi1Mfvu3
ze*DAl{`g&QBUgR2bFU9VT0?`t8!%7t+g8XUh`d{DN=P1EgAYpAJW_?s#%e4(D@jJ{
z)tdT)|J?Gncl(#Gn7?-IhX1^N@Pk*R+B3^Ed&4u^$scZAlpjfd>|^)8;#~5lJC+P?
zHQ#^vw$&%ryZcs}=DK_DBkQ-k_NPDk<4=EPTysreYRA-9zDhp-#o+1_&iUp4yY=5c
zA#EI9wE3CG!wHgWkpKCufAiqOm%hvR-(M$^ZK1X6c6{m+WYZ;~Z{2YIx#!>Vi<{ab
z9X#VoeB-<0AO0vgVfC@kt}p)A^;<4_6IrpMi?K(b+`H{B^GRH6?iin%sP-;MWtR0?
zg-KFwI6A!NOt%cwkTs+hzn8sVTZUyxR-Jg{O8zXF{ckI~F*Vi{NFaTjJy1Zq}mRZ@^L$Fg%
zKm9azrGPvbJ8&4-+=JmmIkacVOK%-Ii||icp|E`U=e<53te!Z;mYjkU0rVr-9peL8
zyd%cInN2F?S}YO`hl5D|xnSNrx4_F%V`y-2U~mi;f1#+?WXx=qTyWv*CMNU8pLEow
z&4|GvrBh4cVflZ5x`Yo!1A+8JmMl5KpYBL!I+j%{WZ|M?HH}3qiZ5Jydc9fhTap4t
z9S$tz_|$_Bo)b-Eh6cx8dDiROQY2rlWD8T+#D46miywbtBf~TIJ#h9>E6x<$kyoB|
z=Dd0EV6-+qy8-HwtFKwcvR=~;LdStH-Q`*pb_{DDT3@ahcmI_{;xTW!{S6mg`0eii
zbly})YG2}actmabMRh1RE5zX)I
zn;3yv0!c)PCX>dt+~lOZVAbk7?j$Fk^y>KwSDby$Ik((O1Xm)PRe6DY_~YHOiuhnr
zD9$dw;wZ(Cc~=M=OeowrI#_^J&Zn-rC^wON{UyhN+bCC=-bKg%=XaNdqw#XF_||uR
zh~>%1j>#pR@&cUL5AAlf%0N>No
zGbsOt6bibtF>5MKKzLvG&s~4<5SX=+4A6I2eL{KxZlgu()9ExOHc;)wLuUrv2{8ut
zl-NCkqk_f+Gz*PyZLeogFJ^92A@N4zAvwb~9fTf>3PuECGm!h4+o>05In<6)spNxA
zM*laavNv!FQneCsUX&D|0|$HIJh}&qg|H0>QJ&9EK{8RVmN|}ZPp1SA6nw59|Kh$k
zTn~CN2`q
zFEDTxfu}|tOdD%^db`PnHRD}fi`_6~)@`jZuz81i$|;etXP?EgYiRbiEn9nfJ7Dn;
z4JF1#ihw}C&&R^iDBo8q60e8#!(GFM7s(SkjcY1~L!d>OQez0NJBmur`!^4!(w%?4
z`Hnx{G>{*;TQi715GfTJH1dcUPsF;$M@v(q%merDSig~g;p<3}{;lQi_I5bzAoAO`
z&D)M$@kU$Q=Jm#Xq1eJjz4gYUrfrE{564z&Rr#pXmy_m%QlJjFmM*cp!SRgJltu5}
zB~OZC=yqLMzdn8R@q&$5s0`5vyjgZ)@?Ky!cj?7KVAe7jkj=s-17N_G3j`5L6R;Q9
zWzN>kCFm6T3sZnr2hnSYaIntpix|CF1ev?<#X$i0217gmAFBoIi@|3=o6utQUR(t;
z>@FUtWqFAUyS^&eTLJmt!BS*Pgh$*07-670U<2qsEJY~MctVq#ZWsTlPeT1M_1f22
z(MYUOt^Dq$XCHZ-oPVLBsMHZG7zmq092neMtr54Esnv_25b0Z-F4gko>X=iXRV)=)
zTMdMWAnNf%0Pm3+2IDhr&WI<-rp-^y>xq5xeQS73^YgP42pWU&f&-a!$EJx6b4}R#Wpxdw1sxB7XLjVpSAQvu?MAEUbq5c{|o4Qy{
zZQ|sCza5!~q@)u3E4X~+FiM4ko
z!%(~|JaGjGj5M#ubh#}kz>Zx>);=QjrqeKo)L3oZ8uk0%CwD&RcY7q(l7c=y8cmFk
zY=^W;lPhiUprOLoqyWOo)Ts
z3Pe)Es%hKkIE4R>lQWM=XiK?c0Cy
zWAes}Ni-ZO7iyQkm)!W9UutS?WH^7(MerreCA&lQ2Bhmdf+58pYPRGf0CFg%(@fmK
zvPp^%75%^ex)Fl?wQB}WIFUq>vL_*J*+$MhqwAy-PQB+Zw?M?g!#jmnwL0l)3z>2`
z>gP9aAaA|og1+v=Lw7$#6xjJGa(NWOj{mxTL#37-9Nzr)caY8NHYMX8>}g%11_PT{
zz5)?I>ba@@zdd;88{ho$%|mM8x|HjzGzV4r@L@xmvW<7C?|5U!-@`Hy{c@vVO*x8MA*Pw0N~(a}HMNZ$Ky
zMAYyj(ApWNkcaO3qajaj+VJ$HuLsjMs?^8AJ_0vgwK36|a)YN##)M{7O-4AxBI8{p
z)tC|(^3(tMtxpXjOZwLSVe;D7rF*-V-uah@qy~WnF5$8;5DB^sm)-Pm
z`j!pk%#)A4=(Xql{1U*xE
zAF|;R&8Rb+=JOL?fKO|K;|=PZY-<(*p6+A3JRTmL<^1`dBrXIIp>Z<2ZZFTx+D-Ug
zkYU;`%~~d7+8{Pp@f-x^Ab{O!llS@bQt8-ZKM$W8npM=r6-WPZ#ibEDX?#Y@+n$o@
zRV>)^mMnbBo5(MIPR>1h`v*Rt{rgAAajO<%Dd=0!e#RNyx8G*I`qhJ9yN+CTnHZ1r
zJ2u_d(}Sg=?shjv$JayZUMpwusaA&<_K`wyN>_`}iL5-j?@gEXfB$>r$}1N!q(HRn
zSHDWGyKdywXWirx&3KFq^*_THg`Q5*tPV%gVWe}r{yTv;U-Iksy!F;hlC-yxMrl(#
zpvVn!^a}FscMaa~!%gR%+qYy{cx14G$IJP_N^#(0A5DJl(*u`Yvg6uonqT=!yQ-9?
za-~)p;pZbn1s0x;W|rYNtXVJ)8=Uwi{8wp$IfA^bc>wK>JMMVbyWaKWlTU&Ld43Hq
ze1)p3Bne_9uo}>cf~g%E8oKeu8^8PA?|$MFpMalJ9{!yKx!Dq=Sh(=QKkl_Qh@32B
z@t~2!@KIn$!>}gH)Hz1_*oV3Q{iSxoDL?qV#!f$Lp%O<@$1N&E+Rp%6?8W~^Qoh6zKLA&hIPOB^}s17g%&MO4Q?8NRtv!j
zXkL48fQSl;ezn|x@D(2#hifkd95dwH!-$hXr8k;kAZ}Q-C6U|9-E)`r2Ldz#=KkEj
z``*@rFZuD^6;00>8V0<{UMn&?;n2li&58vAAujC@K#}>M|YFYZ5a^*3iZI?zf#qs(U7X!
zo<+-t{`LrViplo*vP5L9Z1ZEWOpjGbWhV>qwCeKf6QkKwvV*nKTefb<^dhGh!b&A%
zS@j216M;9yBOZG2@ncVMv0UV+zNtqZdc7FhF;&>wz4D~3_dgg8yW3Lj`O&i16H#O{
zmU0trv!UvxiAXY&u2nY$Gvd^#Aqu#q`+e!y*7Xl9IzC0lrZD$tfGhMEL9WnOwgEi?
z#4Pey%@bhCO*@!jN3ubW@Yd9-_bc_FJKPSZ5}5Bmh5>u+$;rv??ru=37N}q3u_gZi
z)XviG~$Q4h6v;As9;Bx`h4X=t^U
z`zF8tLRxkFKv^!HtqGWxcOr|om9pS$G?)l}C9t?B2(j+uWvSfLA^QD1hdq#ss{kO
z`aPq=HIg4sCIj(ANUBVDe5SxFJ{Mma8yejHWFo=265in**;tTi)F-9d;Nq1%2;L1k
zr7QVxl(S7$ZOVi*j$gUh);I*xf|H@H4>uc=kpMsN$UTb|cD1E4lS4aVQN;7l#o|W2
zvb|o>vGDsurdiAe{X`m9+ZM*u+*6Sx?~U@RH0t*#eTzCqA6&~AayY=tl_9A(Kn%WpmC@ycdSX?i7E6Kh#U&LE)6bV!B=ni>3
zhLj!S`9>s#JPA`%g9GqD0V8S1Bc1buM3GVn67(~n-ptT;*(K84Hl(@X#Isi<)1HAx
z*JTnBv#EMT)*G~sIx0T6`A?FxrMow!)``!jHpaFGJ+K4id
zWs(>*zesfWq8b%Vo?y(fKpJjNLTGsS+#+!Ms?&~u>IZDGBSiz}>)_-+OLK-e8E^`l
z2S+2sIDqL4Oj&81j1~*Fci_!keUT8DV=`VOpyqCygTNdFc0=GF<7CLhtRiOww$v6)
zc;cu?9MN=(;V|7^R}(4EB{-UfU@nNHJ`A!?dF)zYd%$nOxxvkn`Nz!{JdMJ$Te~}5
zqDL@gQ&$RRX%yMCV4aAnCw7z}1#iIbqt?(R(`>lSrhUvxA~&}Y6InDH-IGsZMBL{O&BqS^3We+0AAhed4@cKK6x5F3mYPl@96$A$*buADG%5|jSB(YFxYFr7X
zqi#`ZRHs4-lIbMvNk19i1j_?rNS2}mqTye`9+!@S@TdWC08Z84XJO`_SmTd>DL6Geo
zd;=sUxK8aE_f>YW7rWU)y2Cf4odFV-d2h)ZsF)<58+;b_mC!U*>p4RKtD*ZsoX5lH
z^}Md+;3VtQktwM
zmaXXDILdg-y(@T*8$n(gxkC7O((mO9S(t!yd3ug)&nzfBJCvI!76&IXM;;jpC5*Z?
zK1|%*y~H1bGRPAR20e_e7kyDzD9M+$H!H(W*DB*2m00X#o-CWAA8X^AvC%j@&1X=A4GHn
zf)pi4LBSKPNfTh8$O;K$#LB3Om6y+?%!#aSP-6yPPl6at!bsT7y1iY^is6k5$ldn%
z|7Y(_0OY9Z{P9;;S6AQN)7^8=B$GPA|8Ops_TWj>MGud_Yc=q
z*K=J(T}1>G6p&NG9mqwlNoFQ<_Vn~!UDb8}Ki{gE5Fkj9&3`fEQPfmkzk2oF_Z{Ew
z`=0mgIsSx&FlbfPnOJ9sJJT?lqLPiN#j#iif~?3*-9Y%O$_&dzme{5{I=*w>0*bQA
zDN$QB8=9GhJVlH;YMeOeG0jtF977V5GL!1s4231tH7}W=6ThV@QasV96&w$?EiAgU
zgAD^8`td;M&lBR3(j;r^gaIT>Gvz{A6O`U;&qtWBmL->~O;QOZS7tbP8wThA5CMS}
zCvpxjfwsWAAX-ol6ukp+FjO>P_kx6D{Pa|*J=X^7lGfy{tB!pAy4!pAFD~&%i9Y(|
z2XKoFlfuBK+gPYQhx2`-riCTJ(j2fQU`Gn{3qudw!xBRrGK`?1GO$)yG|u$e^jIqq
zVd3uirNQC0Y}$5ou{Wpg+5^5%REhGbEL^iWtt!IS!Hh@=vqW!ZlWq0;k0d-Ao<3!rr>EQZnFvBb8=yD%>i%wYnM4fpf#S
zXc{q8U9I9#R6gpN>-aHccn$yJ5J%F3neJ1?C8n&0V=G0B(ab_im?tFKnqC88P+(nh
zSX@Ftd>-jAk?}l$_d(Rfpzx}iSv9YNonfE8;`
zij}I6q4>a}6EPBwlt}PwnL{iwxNQM%>q1GbZ@
z!&a&bSj&b%Y=+>M_+2|88Oxl`Tzt01RS6hKq7!pfN-5EI^cvC!N~|H6;u`QGyJz*$Vy-}
z5(6N>rkUOu?=0_m=<2w1&whvueA5X5CHtfxJXQGzcLYL(#v};9XavF_tzK>Fh%v_C
zxkLg~5TsNyY{P9q3gNL>mh6dU#+_uGfr2El2si+)BtdC{7mQkkwBpEo2909b_5^;j
zbhT85s|>Q?h=7ud$F!hAa)y
zbnSRbg84Lyi>zw11_nT8oq1-Bv#JY2m1t6Nnc(q;Cs2ra*G@tY!xO9E&wpI3qk{f&-v)=&(JpS11mQ)ce9XZlMG
zLBMLrl|`7lBmQ_4ZS=jyAsBgZ?xNaIxfh6^XO9D?`<#xA(%69sxOuX!qNmCtCKTC)7;;2DpMo1~Y-6f$z{K
zXjAYLG`8j@C$(xep;0JF(0-;A9A5VO>we#Q=JM3{ClbE6A4tx&2gRN=--5oNi*t1Z
zuzl7$eQw{c_}zTgW<#0H13a~J33Sl}7)*)c6bxY1~02>fpa
zyav2WA4fmv{0Hq#;BSg6i?Y4}1x;Q5MJyv2ZgL`y;`q00)#}rsP!!Vw7|1JBInqI#
zOHV+DyjQ^z)Mx;`T8U)HM&yr{oyg*d*~;UU8NEKkQothc4GIdQUtu*JScmrf+pt(C?AF;_6ijTGp1U6{et_V7pGNH&WQCWs^qR0BHsox}#08rE7$#
zEl%1fb@rqkquShA2ahDbh&6ZXn#OVqc-F-BL>+dV2Jjr$orT*+vxVqr_;k3wt(Jhh
z^f&}Err;IxT?uETNI}13mO-dptW4Tk04UL;Jpp6kcVBD5q(W;t*zHu6PsY2F2rXo)
zj7#8WFdkrC0$9NGG%!97$b~t;9njx^fdT3y2qOS87q!VUf}}<`L>sf9zGC`uzFe)T
z$C6=?We#TvShldaz_4O+p}DRM;t*U3QURs$!ae{6PDm?4^~nlMIHQ?lB#KXIfDD*S
z5!sxaaN(39)*ds;YNg;ob%8?Bx}cM6=voTVNPP;%#s24Xv`z4A_Faz$G%kk=Jp}>>7lNQLEXErgE6&jPI!2SZ
zb=I_qVupngHa$?UnAwkdW^k>C>uO@9K7CHx@%P7vc})Ap-~@*tue_BVme|nTLuRKu4O|p9KJk!usANU
zD-jkMKbbf_;Mm0)R17h&pLWr?!Ex(wL6*zo*P+odenbcI+0?F!Ry4tPz!M`#sNDq&aRJw1
znDCPgmk10t0HZ!sNa@P1<0J#%V;AQ=-E?)G@FV7qs)EamXAFYZ((RVY0hMx?Uky#g
zGki<(HsVAY*y(s|d@W7Y)H;R_mkq9~p>ZG!d8ehJeBCd@!>6*{(y7c`{q!ZY4Ld7M
z0K&^?p;=R(Xpd%*Y{26!wFRpR?0qN$>_hX-FNE4^O4_Lr|>
zr&RrZp}cMCCSJrVnp&$>rfJgg9vTm?R+NteVnanJRGNvf0n{}ID9k5I035aGKXVS|
zoug?4Hx8Z*X4IKF%AiiP2M(kG9aO6WSHpvVOVG9r0JaEQkRr?i@R~m~xDx;{Sg6N=
z6hNsI_AsU8R<;7UBPfU?v{fvogNx2_s^&SEBB{1g1r{X?(Ju*aae`Vhu#qRa+e$@K
zt=m9lF4kiUn3#5e#QbDsn$^cy1ZW2E6oeLeE8tnSt+J=68V;y^w40YWln3r%Aqk;S
zf!$k;@p!T&NM(fUab~pkfdoEUpQxLfBZatx%<5a6Y=p^)e#q>I&#aUB`-z
z2#Ky*soAV*j_-@X!Bz$#OoXZM=h1!q_#Wffqd&{Swy1<483E$~cPN3vlL{XG1_}dj
zLGcrW1s-q*sewB*F*F_XAFgsp8~}|85g41n!@cBqu||`}d}Y~CwV^dJNchE;Ffnz#
z1Ss<9NU7GUHq4e~647e3fZD^d#N^P-q^4Gw3w{R2xduc0bD2=Dtk!9cVgGV1&b2-G
za-}1g06$t7Q_Zna1LxN30%#Zvc37-5G)$q^1V{%AJyWZ+HHSNM0A_Wv1=a{?8hk}n
z5lh8O_vM?aRVnLMlQ|l5N+9Z(jW$Qpm_L{q@QeaE3x>wPq{LW4j}&8F@XV$q$&$;P
z@V|&XL`~(h8=tvcGGB2=!>H($-CTWI%}oYQxGCM_v>Tc3FA=26N0tbM2ZFZ@J|*5c?sV
zB(V7tJ%Tzhbq?U}h|B^bwZxKWd9=|uG8Cm*H!?BQ-!&hnHxb`K^RWd3*9Z;J1Ae74
z@A&2L6K^|$?$c3`?Yj#nuYHYHtYg`WOpUNII^95X{H+|rh_<6yz*|_UpzTo=oa8t}
zry+ik-((+D0Wan0!w&T^80#Wo_kqnfbl2r@#DEuH)K3X7&n1EquDLW@z;8*=7#o^s
z@M{Ai3Cp^QKO(%@0146R1{#HqRomV7-MVC801Xy=-p*WIf9)@il7Sw*WI6)K7|>c0
zP7DM_=>Ank#5VklFN#({LwIhAhauFNR)R(uoIxVK0?w?lC=A)s^cnd2L7U(s(6K9i
zh}}@CjSeO7P3^h@@@>0}{8&VW+(tm)Sex8XDif#qh~YmdL>mRmC2o#;|!aw6T;
z4X;uJY=1{=Or!od4@NZYj@r}m!I_sCuq%#@Q5bBPjcK$~_RE7*)QKVsV`%usbTJx<
z@i>xWRH2lQy*ZL*R=ZXxM3O3;JTtS0!RLUmn?+z=nbM{UkvQs1K&6lB=W1{^gf>+W
z@-!xhN|MW%58P$|1Z26daY3_GR2_A@5T0I`JL|gt
zIWC{kBH?;GA*oZvSpPtMa1aM{oPR^v?DXJZzM})gUu53ALoL5EU)R*cyoHtRQgXFcGZu-e6&=U0
zXe!LOvNm?l32WZ?hZ|nnvw$z|x;GOOAcqpt-SusSL}!P-RjBop2Xy(jO$^16x?S}%O3H3UMLBqB$^W3
z_u8*MS6SQt&z(8AM25o~7OTTOeq~G==#BNXvwE3HK1UoRFKn1`54J7BuV7tZG=b#y
zUI0db^9Zi{V99+8?CaGR`Ev<~nh->c=wgyi!fUQc_c@F^SMIO=MUx2CgQY7ogm6S`
zh2gP!t_#s9a3mn?NSb1P!)PwTWgZ7213R!RI5N#l{3HOaHNg?kV3#gtqI?=+>1<3;
zD^nnvkbqQO21Rg0nFjhIU;v@}L`FcsU``P`1E+eLTz>O;lDs@MfzH7d7Q!Ge3Xl~)
zkxhaDEWH^ErbR*5K>1LROqzkTIMDlA(5eJMZgM1VO!v$Wz3ajoetS!!N^~HO>7Xdy_V!~gIRC<{zxlb_@2nPZ
z(Bu&vnk7=~ymPzWaoHtTU3Jy%w;Kql1!5BU$uv9n-1bW^dFNGEef7_`YkTuSEu4F9
z*QJ+U>X&alIo~h;rLW$02bBjEhkC%(Klj|8%PzU}D_^?m4!<7Ck1{AKzV4jPOD?y`gtr4_`D(h_De3g>a#!n^PMFXWDL~wI0h%&=bab6
zGS`A_EbP7abOluJ+D7Ej(Wa#^-ur%Cq>Z8w#0-qt7z;SU;pHJ=X@Za22F#h
zg+nvV0DJ{w<_{a9lMaSb#?A+>4GV?#jJ0#yx@4RKkD*eY2BC(H55z7Q_;?QD6vAlp
z5X*0x8Xpo%LUMQLgpxs!RK
zrlKCOpj%BX_--bL?<%OD=LLMXsr&i7l+9(dW(zs^I*vz!yLRC0o=PM(KmIseM{6xz
zK>ZN~@tK0}X0mOVpZm#gYnKE?(+%P-M?x*VIa4lxq{w8`2r#DUs7Lhcv8Z3X*w)q_
z5<S
zGq62PXiYQU+ch>Z*a~Yiwd9e@KNd}{_6c*SD?oBjBqHV^&3WRg=;0_hB3KQZnKij+
z;F3}2$83BXR_clsS8bWT3eGEL1_#%y`N^*7&%iM#WS1+Jf8`L%H>*V<%r9Gh^^VD}
zF@rDf7&&qEH@6kP#H!;gq@Q%k5AJ>BeU<|y#P)p0hbxu8xLi(@yIpp$V&;L!z}8n$
z8+ME9XiH(aHA++Q9L8<3IsNcaN4#^_^w%(Q#W}
zo3=6pIs_##%Ug#i0z?KR!M-veVRc9x@vG1J@FeI|V&fwwz?1JvEQ+X)APB6MVS8@A
zEen+)Q!}1k@|kiVdoE2of+9tF1uwj4{`}vmW~r*p#KG2JQO_F0xrU@(k}hDo@1<8LnR$Q46Em2^#rbijcVt$;r1oZ=WA7tta3
z6QErkzj;(0D)qIxp9X2Dngg{!&m7_shb}GWTm>Qs9NzZ$Xv=OZ7TaEX-mkz^X|$N`l}M%oG1guU&8JrQ)PEDW&Ydfwj3M9h@BF8Bi5#S*E
zuq@c^I_NLLAb~6Z=cUo8*-+p!ZOe5+kOM%t5|W`C)2ug8kz+!A&&rO
zu0h=lbdBSXl7BoJ0r>(zG~kWFLH(2u!Zb?xe*JaTZ_w;_sXZZuhR7rDje!5af(5qa
zs9H0XNMd?}I)ShZnl@-pSPF%s5!}(9dIjzWo}LeHhD|@;vRo@1lETptf{J0Ro?KoD
z!&FfUgV|99&%v`CPa^|np)G=FrV(hLa8(2mBc0D8+8+{f5d}URp@w4CYm)#w95tB^
zF9{uyNGvS3ph_{id%U}=AJH8eh7LsrRUcS)SNBDi{6CWN@Sw{f8w`P&5zHiX7i5rH
ztwv?rP^ZEgNA30t?U79RrB
zf;IxMOc7Mgs_og41XC*v9~CLjiE(^prle)kk^Qg7r>>R1<=>cZq~yc|qvb`zIIH_x
zqTSdtx}m2_loZd^r!8oMruvu{V@?clSD95pu#iJ-T%KvZIkq38F6OEw%V^1%t~8@P
ztaQ845>uU!W7|TU;~`m8whRs}U$_ACUVyjS7fd=#WISyscpcj#REwCG?U9p@J$$O&
zdN3i#kzBl083SI$lJs#btveuQjJS_bahuJj8iAIOXrO&+1AhrK6NO1B_%*oCW>I#z
z?DZ_jKvfVb+)8`StJQS9MW<*;0QMlaJ)$
z3Q#(T4D^tQ45}=6#uL2^5(@JiBsCEnP|o0VpZt1iql-mvU{QKvw1Pu8P@`!&V6A6!
zs1g$DQ_64!Fq{}PNphXbZ1N_M6Wdm_MUd);F6r6RgeN)eNFo8^?f$5dVN=Dh5nqmFNbuuCHzD6s`d2
znrOiSTf$^|a@E0`&vds~We^d&p^?sUnu3aPJhXYuG8O1i?2`y_62kx&oz?MA`ZJr*
zYzg*l$!IDjF{2KZ4OTDi%%;Y2Q8Ntc3f5l%u^i|_5dGv+E@V`OjhRl##N&WUBS-)N
zoR}wlI`~L$21W=rtjC3xi}P}AqTT~mIuu>3*1mwG!cR0Tcy;b~!VL(I|B2vqF_Pa5w8Gpm=ZS34xlK5$pfE{@XSOYCofK33-)>BABokQ
z&_zdiD2;$tLfA!cx~P0joy$jgM)|YlYfcl2jX;)U$LO^zkabkP0rLc^UxXe!PzG)w
zbo}qmwTEyvwZ|_X>6KvB7f82wz8h3mquzw(H9RjIV)^xY
zC6>fk^0231pa3n73~MdctlN=TT(i6w7u_{FlI!ThrjzYrg|gk5I=EYIT#jh4GqOc+
z_C#n^LDRl$!ng!sI6#3LHbSk!x>bp{wLz;FszS*WJYpz^*tk5?e5=>=XcAFp$>NDD
zxE(u|$-ud1quhw6bNvIIBcprzdY3jG!{$tpms^G!B|YoI>3Kn5Kj`Xt)%TQ_Jy8y4
z`EbUA%M{3QO*@r{DM>h9v1hF+L170M&I4GeCN^KJReGj7Y+UhP@Jx5SWrH`&z}5B3
z&?|UA8NV={ujv9O-o=gzgH9$$$*cfM9r(dTVH;MWK>?IGu*-3wlAlGBTP^I)PDPjG
zR76e$G6HPlpeKkPqRkh`1WlP^!yqHrk;!KUniG*jN$}ut9)wvP?-;zT0vDiJf@{DZ
z09}~(pf-T<0`x$@1Tz7C?qGan3XThMM}$!pj@M7SV4MNGRYR=iShPM>@9KqiSF}9d
z0t&=gW%h!mrEk&kL=JumGAZB1^K2&&MTsOdXbjvQ5l#XgcOim+JUL9QtEn!u17QD1
z1kiIy1TkEoGw_E<1nMGAfdGXfgNCVV|{3KJ-D1m$i*FnIYRKA6LNlC*KQq{3<5OUv
z!@@-?yC6*@MRGORt`MEXV`jG8XU@0%^5Bv9}+6ppw}l*dtZt~@lXQ69}#nOz1m1QxGhujx@ePz9A?j_VmELjX4pj0&GwQX2(>
zMM!3$DkM85S3xEg4n~JeOMn`Q{v?{yAM;wh**m`zV>mim;3HBf6VvMsQ5XW-Gf@y_
zh`T~9gyPR2`2YYw07*naRI+TgAeDh}1*$m|^GUCA&-8>Ck|l*SnH!*BLrji}hKs-)
zsix`l_72EWNOw&5w9001Sa~k1Ws09Xk?
zqbi??s#DciC%nO!IF`ZIA`}tqrXwneR$U8671wSVus#A#0mC4`aX~$SW++w~Rc}Lf
zF2!TDLOlsJIMDRK1ez_78y);S`&m5xwP#>3AYP#FC~Me@jyPuL1dg|q1;-n7BB33_
zuK{LG&~o(y>PQqY625nRegu6AyEIAxtr`?G2!?}j1n}tnuM*fjF#n`m$tpmY(21_pd|!iU=n$(27h|w
z))~zN-afDdk}04o{C5B%V!>1Is`Df1p)K#JP5xFEro!DYPX(A0t%-WLKiMeOpyLg)
zBa}><<(dT8;}nmHg@oz|#CyLEbqq^D7l1fnlp_jS&55KX@F$2tin)T4!HCn@-%pr$
zv(J8o^ef>}ve}2O=tKp9ntWyg$Pri%p&8*?Lr-SnjT!=FQ7Ne{Q6H@*$j8#&_TWRP
z-yc8Rh%e={whrX(WAUfA6Y3#+CSw)LQcST_U4k4vk<|ATpf3bRM&OLISV${YBOQuU
z)rDLPWFRTjf=Ym=Mj*ek8tyM^8H*PNCQEvPt3i!>Fp034If%Uhj&ab3@5eG
z|DRO3{b~AKKlOK69&qp%IrSYo5x^DP0|?Lz$1k9x3230>@fQU!z2|`W0_gPLqfW-b
z<=tVF$W)ci>vZ6RISILX1;v3w(d=mZD4*s#79dWuJfF%*Fn%5$pnXM0mf2bB7pHB8RyIT~cg2m;&T3oUKj_a|llnUbct3dG2OFwAK(s~uhqqD$qnx($0}*vf
zi)BNsrh$p$j@R>x6K=Im{(8G)IUkxCYGiwTW8an+f=Or{XMYeTI)ncO$lL)_YDV4{E{X{#-
zlapTt%EE$W$2!~KjL0mNs&zA!2tjcZt|pRUvr#R_Q%RDPc(z)oN8x-L)y%dBe}c;W
zxk(#8e)WGlpgS59K*^t_^d7a4&t|7~%ycZy+OX6>SP081ZYyNK;6cB@^-vMhQUJYy
z!i^?_3n*y2h#{d+wA%-wjZz_=$AH$r0rbX7`9)n;Rjrh3`SzUBo-Oa$l{be8zEren+)LzNirC*9}G^<}MNpy*FK$oAG
zjlo2~Oea>8N8}-xQ**A@uT9%Q4xB`X&w}HJRon5N+_*
zi{OrBDFhaa;Oh}{mX;WRwC}paMvVzfTXz7>y}*1Cz~>-!@!%2}XfzfUO=3TwjwjSz
z!NjtoVMM}>P`>Z&l~yV6C?w#TjFY})fc1+l9WIG%u%U5q)ob}4sQz)9(cr@ns?|ba
z4rbnPNjIAajpI;`+A&95_^J9o+e?i14=+5gfDP`M*{r=
zBz$CcxAkWsnSH>M7|x7Hv$Tf)=$8zpssBi?Qm07|p9**o<-#bJh%55MEX7Q_7B*lW
zX+#ns_+k{`P6Rtaum(^MzzALlEeDCDs%QgM@+^0}Mu!*JOvK^fFb2IeW-BHt4=MGE
z9$s?v@Ne!OSPapRt(6+t#d&pnIu=hh4Lh37RHnz%f^566o#a&AlLg4*ZUgp^u~U
zVLlX1w9G1eGe=Sc6F8*tSQ8Fm1x2owTj6CZMt*ba!o|>~Z!{~V%#x%rRikwjB1hUo
zyY=295Cg3A;g6j``Yb;43GWkZ=Mo7`h~WcZQm4rv${!7QqbDE+ke(}iDF204AO}Ls
zCn17f0}?(22wJ}Gi@z(to(K@5E0|;l5hk-l47Lh<4&&qB{qs56h56{;F{At;awbiz4g*v}YS
zG`A0`hMDh54eze@ba^m;BqE0D*_-?Y@1L+Ko2H8Ez{Mdxf=>r*Y~=Y%?SSq<#kAEz
zC1W<>ZJK#FH{)FG(+*h0Fe<@@LNpbe{08-7NfU<|e`XmQb4wrf_%jy>z-AJdGVnu}
zX)jMhQX0t|yRx?FJ_udl!<&|X4>?o=J5s+tXa%_uKCnA*E>tYT(e_@eUP)%!CnpLW
z?MY6N;Vog$jd%CY54T!cvthR_?Nx_I5m-nwL6EsoXbB=F5+`zC{-`>6q(O6n4Rp5Y
z=m2nxzZB=dasYqPc&u<}$6(^&IiNtn#?W7P!P#Mcy;`3lDgeZ#27kcq(5HxpLaJSx
zsnww~oQx+N+m<3>8zcvfJK*5M$A=}}BhWxz0{m{eiKL`M=o(^LMS~28#w$pBAMj6t
z;#|I88{Ws!99g0aK^+T4$$-9R
z7d&Ts&~gR;O%X$iJv>%uvFt~`_+`>k7T^ig2bAA1x}h-uJ0Z`#umb@Pwj5?RofCo{
zJbO8nkK|rPlxd-b`pAU8#d<_lTCt;hSSSx6A
zK)u385ln;*E*9A5^Z(b6h^|7U|K5!hP{J$@hH4Hs(4@vv4hD2?v-`hp_}}&S5AO6L
zv_xlpBpN!PRE!?c1i=+#19$q1(iL0KN9P53)16z6T)nW>m^Mw-@+jI<%WyN<)cWf;
z^!M^nc(8)g4266-$p{k>a%#&JR?_NAvAgwVdckGp!EWJzz|-oo=xKZ{0HppM9&0dFC0QsXQ_)+5PLCo4M>YN7i_**+{l~lJ@UbJM%N%r
z2V=%I6{s9WqVP#Ka@RxYHbi1W$9*EhZv$#XS$}u;D?@z;kN|!#Y+b9heM7OcM@q$@
zo`&Yy;Ls#GQ;9A-nqcRKm-MRJhhQ^;C>C&}F2b-)Afq4_#X(Kh>pGMHHApH*NMb{a
z0wjlj8PG|fu0EFp!pz4*;7(v9Fc+}S0TTD8*Zk@9(b^R{OU+Fo-m=QMH>Op8Nogp(3%L-5JI2^9I4S)#X^*Ya=D(L7q=U8
zPRjPz+9$!3*cg1hp{FvrMzt~Y*mNe%_4Lo5^d`{z5L~)dDoQlmmQ4+Bn*{mQ+o$yO
zShQ#R>529P|MrJ(_P1yK^OVBDgrnKTg*&@8+&Z%I=;-#%&Hj0C)djAe#Bm0^g1VLg
z4!DGX4T1%=dB>I?y?f`1m0`!=wr(Ej?oP-FG#ir^d_FVXnN4@XZMiCYPIU1?ZTn7G
z830ZIw^oL~8oPVV@f#m`FqBk&@ZE2|{tZ_p(-Dt6`lAV$t(fX~LVNa762bUmt0v71
z%yy24HVxJ!@&S=U{vK>0{?0(43A&6?q`6Ip4FViiA+Q=~YXA`Wu>&{xrnjF{(KHVgL^=8(0(244K5nv~p&Ezcu^CSG>53*{-RlGJ?dkY`%16oC@KsJ0-&|Jeue3F;=@U(`>+c!Ezk2ocu
zgD&p-tZs5C1|3E60Ok`JaDx=|8|o=7)CQ3dLRiS5SaqfuO>}MCFnsxk%MU*Shg66n
z=*v@3F->$o(MC>fpo{~!qqq%!rH1>hZ({`sT3yTb^)(@GP}PZ%$|-AV2+!y`);+%*
zie;7DQF&l2XtKG2;~46r8;d?i+$Fyh@NkI{Ld__fpHHS
z5z2(PKp`UT4E_mU0^+y6Q-wPYIJCr&n&AJ4she)y`IWEN?!0>(4mK4z11+1G>E@4r
zggKy-?`r}MT}0+#Qu%-ZbpR0u=SARv>XCKeF+@<3CW(uZBr~9dd+^{7T+sB{-I%KK
zt94~bj1KNB#`E+0da^yoo>H8u|Mb6%6HnT;YUQ@`FDQKTYeOQRL|o0bbY!OBhfkZU
zHW;FSk`C^(9}PbJ*Y80kv-hAen9pcZNFOit_i?Oe;gaL$iF{=3YA^+5m>|Nz6+(%&
zV3~*zFj6EWCd)I{)!zX1D4Q+e+gF1%6KU4;TwfCIG1NwLe0cigwdE$v9z5rsU+s*v
z3F#x@@B>2}X*Ky&cG>MeeXy&2p)99A_@UoL<54*D@@ZuPqJN3NB95*Q
zvGM4FehvUYv*N{Y2h_me^rM&t3jx#yHUy%@iFyuzK(GR2AdUisf#>JCWKhk4CJ@Kq
z@X>_>fdJko(KWs|KU%NURMMUaHc67v`iBK{;l(muWF$pS9bq6BEGwTD#30fZ;%~Er
zgM4W3-Et2U_J_+oBLo2DgPX{V3SR(n!i;tzkcyGhEs*#`{UZ;94YW)=a*Qthu_L@&
zyXGf@XTG{qA^rm-XmVH-Zv5>esFP?Y)>09{P%$-57I;H-qp&w5w2##biL}3x>6xz=
zn!oxvJ8_L^;Y<#HSFpsi9hi@J*XD}zQE{P>TTM2%n?F5_a
z6VyOZIrs?vrbGWC(gQt!$^jL3d1#5WP%V5}Ap9UNCS5~nRfU^wge51t{#v$rHDbtN
z`IqT*h>y@~kQhMfLjoEs3lbYX>mA;pU3i^{uYaHv;^U;DX~XhG!Kt$=FWr7i3si-!
z>ZhFD&MKwh$EW8lmO0x1<3(>-*IdJnUq!+$yw6lPtxyCz4vP;6jgSGHBU*4&gMOh&
zw4WYG^05&eBk&&dM$swkfbbB>xEMTOF+T3{IOoBe6k+iX{_#gj1^6q!_M^a!BjFpNiydKSIQTTf{frO?G1>L6P&zA$a`wgP`jKV}-5a!0S
zB86Ud>YjV7_;I~_j^F2W&*xZO$;7&u(Eq7_-TKG%UDG8I
zD#KDJ3JDClLb^e;2K*k;1G?iUs&n=ce>^bWy*QN$*21BFr=HXN@rN3{hOr5TkNOWd
z1d1#Ek0=vBiOS$Q(DmY1{Ty!i4te|xzU9A1F^K(%?QbCdY@cmRuneII><{IkK2pJ)
z1W0E0(z$`44bI0t1P1Kk1T>!~M@8uhhL^Grr@s{f2bahIk&H!0vp5(l+BAV^p-O@8
zVx{>z>E0#hm+9`ye(rPH=;iL>XCx8AvwKVMJ7(u>e*>*f
zD(3$}wc!Ef@rT3?o|+>-JZ#`K_hQUi)rhyx
ztBemu;xIL|Tn~P)!TW$S7N7xzbRxOBfET?ex<&^bj6T@{gsPQrxyTlt`1-=8hf8L;
zSYfBX;v`iwr^X8l7cUif`Qo>YU2>_jbMv-Ei;jYyO$SsgCY8^8=AAg5^}z!GMeW92
z42@W#S?VBID@05PI0so-3SaTj65xo5fg>i(J%Oo2X1Fml29&6u4~+?_QmVA~vQmRB
zTYHQ;Q41@*h)`P{ol=r%)3sCSW$?vSoY@jpqN%p!HhTp681VT);${|ClDX;OU72)}
z=Mx^EE==ys<*Zm*+Vxm-!IF9T?nbN0d1g$>F5GzE9yl1S7j?DjAsSB0;NYy4?PWNFw0*QcN(l90Z+q4M)1!$Aka?WKhx$B!0PD`o2%e|>n}d&e*`yd
zwzOHy){KmxdH%m?LgFVshi+*9p?;^q!sSDUIvX%RiNFfvfc{oCSAc#;Nxv{XA5MQO
z1m@=7-}?TuzDFApK0>G)d^`_le_t;Hiq~MfTP|F2lL0sV>d$f4mL}&PkpNnJ;Ne|R
z+=Fi;F+8w-Qymz8$uSE|#WH01B`?3{AI>YhpcdaYnX|e+V|nhcb;(S&ebRH
zx_`rv?j=rt
zdCe6=7Mx*WTX$2Q8~1pJPLIIMKt=xf7tQlA5Oo)e6Ji4Yf-?*%KyCL=cZ6|8_~`ZZ
zTagPkvK!}cQYX;>pg_>Z97b&}!i;%wV4-j{ZdzUecAGK#+COYO^BiV|C(n94`~Hs*
zPH8~5MLC*1VNLCt|1O>XhDJ@5k2`VnM?c%M=CtWh?%2n6xUW2CV)co;UUufL-~ORe
zYA&oA^N%@cdZsy0QkQPs-FCs7$27R$Am1KL2_0p(YEpukLb+j?uF(6+*S7dXcD$x-
z8)Zw6+J5Bfk=MO(;*m{q%UXQg+O0siYfsu9&I~jP4cKjha}vZ=nVT{Ge(JAORDPfd
zY#82TaJn7&w{2}
z_rQbycv<bvv&;^
z*{QEBG<2_N_ndb6?wLx{4JGe*Kz-{!RgPM{?&uTO{rB%`QgZQBO#%C_Zri$TfWxE2
z+Du)84wLJMO+C@DSDyYFU5Rx$P5DoE0Yt+~PAr}DnwdMc7j{fm&wKk849%-gdng27
z>pFaSC5buY%S3!~5_6x}XGA6Y+@INLA54CXroSosx8U(mzXzM!(>v~qGKt57pRgwc
zR{$ks9<)S6D)uS(2l9CT5^zTjUBQtK6bGr#P`h44!!*}f^qIzDZn|O)`w6UzeJ*Uz
z`+~+tO$TknUKAB$vK`C>3X$~10z^EEUx`nS6FA8Z!6d+jqBu|KyyPpT6|RKizDB*0{4(~rFSArf@6Ud5ek{uFdGNxjUT(SEwb!$ko-W;b#~VKW$yZ$V?wh-M
z7ez81!11Eg{y)FzuxtpPiPixpgQNj?pbNpu@P~{_z}yHpG6XC-i<65BVjz=z+RyV}
zK?n&jMLgiqIntQ=>>+*|Xpwyqy#nJ>7^6yB0}6bZ-lL9I>-rCW!rpq>OUupjnp4u>
z{{gF1W40Ho)EMIUEL<@E%U?}o`c`1KXzySCn?J1DJwEb|_mn>W)no3w?}Kl8TmL6N
zr?$A5Cx>7AMt0YI8~8|W*JyR&GM36G)Ru-14h_~3#|7>$5$_H0#5V7s=;np0*1d4~
zdq2d!{PktqcYXDuw;lDt%Ll8P_{fHLKsfaKn^&6+71D?qgj+?l5yY|=bf4ZrxAfVy
zijF^rg!uq=3oZiiES&LxJrU|42rlFBF(p$f8n@p9&cVX*sa+rX$SXeo1vY0HOWh425c`jLNGbn6`#eEFNlUG{-09|>>X`B9iE
z-+uQ?xDbx|eP}A|KYw|huyECySN_9a{_XSacR%=+i!MFk2R}uSXO~yRPh4^DtIqDZ
zYu)Rwx%P<9e+Ba=f9Ks7!Ar=muY08@w&b|;gC9%({$2Lgx8LxID<1yyo$KM3%XJh;
zbD-Mr@lQPbt$)Ah?z=DP>1V&a-YVC4%kKEuFLs`GI$OWxf^CBqylCWmb2S6%nefP-
z92%QIv!UNQQQ-GX8h^R3dEwjUeeWl$-}#fx
zol7)~GPcy+BfDCb3LlgqI7JO7Mkj69+6-@>5auoW$~W1EKECRv+uwV|m)HLD$Mo)n
zOSbO#R$XHc-FsqpK4loJT7#cmO!9p%8f<^rV&y(@(S$#I`NxOg5b+dfV0)npAUeoM
zE1)y5DeZ$evCilm_mpeD?R-kJ550fxowT#vr|FEecZLW5^oQx-4_5H8L;eonzMzsA
zSE8lj%!#MA!>Q8l?S*`L$$jf?2g~pD(^qr0#
zO4I24;wAHXk2!*rC4votn
zHg75B+Yz>^FP~k}*|GBIqnKkQs})IABa_o?>5`LryN?;&J_1#awJ+)JTWs@@(M^MA
zrt;=w^`7^9D~SFS>2clW%$H`bhck`
z#JU}-+EN*eDD(k=CQVr-{YwJf-<}AXxl--n;=+2ux2GuUy>O*#_Ic
z*fF6;nyewkDt>eC8PfXtlx3ci(XRaj!f7WwtYQ%E^mr4cO=I=pBe`*}{%J
zcCqE{=$UW)_`k%l;f?jiC~D|iV3zBTT2?Khh`+yi{)a9XPCkYG&#%~d=WP1J@9xj{
zA73gMk3I_9rB)`-U;c@UfAoEpOD!B8EZz4PcK-P<*|g<>3om>_rHn}SPFMdTfGHkJ
z9I|5V_blaBoOBeOtaKmwh$vuOE
zo3SXG%~CFxzWl>yCzDUs!~fgI`S6>EA#fN1FH#6R`Goy{4g_e9g;UMR@kq4rp%1fP
z{bKYh-#hO=-+TRg-w(22rZjEM?>=PVbKYtLC&*BcW$mB3L0WP#@tF1
z0l|fy?k;VHLU{KqOxG%v`ZP2$5S*z}DC&x^03r8EqqKT=`$I422_ZRoOc(`Ofce
zJ2l>pc*H|uC^S>9^bX8Vw+%+)T(L3)e7t?@wqO2o1n&1Ae&}KN858~Xa0+N{eF?yFy4`I8@Pxa5*s
zp||(-f6u()j8mM3Gq@YZnfY2}kH?BIfdMbZadns1On8DKPwP-6Y`~oj59)?g84fT#
z<;38>1#o-r+uwE(?>v%EWjv#C`9D28F~yEvdK10^4-D}Xd+nhu|`{CXN
zsj<KDX8=tyj>nqQmh(*)3HGSgAzXtV#$&$ucd7+grd0Daa
z=SHJAufM(3?8xR>TU+PIj$yFsTCJ8oHWif<2tcxA@xqDXX4_ydJ9VAsu7jdwGJ+7P
z)oezomY`rU9OoC4CJLzq^Vqig*R4JM*xg%e*I)b4)HvI@
z6KXOnm5g;HIttV9^y-A=NV(jU$uzOFb>=5fbHcRbG4-S|7b$yOhmm8DiVZE-BiXxP0NZHK(I-UYR3@e1TnkqU9UZBB
z9?mnW$plO=KyjcBkOE*r`^*M{3S~X_^fWdGRTv!i=W0g90WXfTEVnW;v3YFr@k*WD
zz3!wE_SOp#MCV+$u;lVhoNDHI95>NFdrrAzz9
zMp=7SNhO7_+g*Yo7W|cx=*~*n|iEsw~TU%O05+1wvu0LG=)?fYXw9kB;z4eVVgPVu+ngKi8
zZMWRlD7E@J=5=P_)eSMhVk0{zzW$}*fnIjPD)#MfyxDB9csSd?{0J!W#v+MYNrm=f
zZ{M<=j}IeEHt2>$^OuIBS;P=~)ftnI+`Hb;oZhb9$&sxl$|^S!o82*~JA5Ko*1b10!4VGoe-iYNM~4
z-S)>LAK!fL;~U<6>rH1nCUi*aVB|yb&yPCxO4D2+7HjA_AK*HxUhYJ0{Dd7KEf8*9yCKu2J(8IG=P_
z>d0kkRWB8WuKfJ#H$QgKyWYWG_nOTEeYuJ455Z#DHmlG`{ei^8elJzb*6~@7<_1;KAc5ivkC^o-<$#p<0()Dh2cwK2*vMB
zc!tCTh7FbZ%W^m0Ts!x5@OjYS`Dv{=GJhaat#3Kw73}W2noE{saefblD~XJ!C`P`G
z9eu>Im@FH$CIX8up0{}I>SJ!aZWuAgdpmkUoG5ys#q-z?zw5o}4M`P2P2pBOM6m=X
zCkuL0h=-%eXphKJl|mzr=%!LaVUaUV8QisP%YyEFE*$}XNUxX8W&;>2H?Xi$s_KaF
zK0`tcXsLQkhH!(rL4E+>bei;I4?N9Dp8%zOUqXG}r~YkyzP$~h*{-~D*L&U#pJ}G+
z)~9!@*VG9^D}Clu?EZUqH5*efb@=Izhc?}F=boX*Atf=iN{Dx^{KA$$-Sq2$Wxa~b
zQV~Q7izFjaD7!5^>gY5=S-VbY8cd69VYC*JqK|K4=e+8uvtDuPpMHN`1~y5SxbgPQ
zAN&A&;NH7JLgMaQhfhCcLsz~X{yqo1gR0eZltc&IiI&S_XPpU#
zQ#q#aFFlQIf9z3peDp7OZTRPZ-of08ZjQd~t!(q=J)?Vuule~e(bcY{%gdk;N7;tQ
z)|E@eE59&^;A+vZ7mIRB2A~9Fjt_19@qd2jqBs8@lr+!aLY?&=Jy4n4ZR-_Cg>18!
zh}c@4)n>-K@|loiypZdh)U+%tfWN5={|6y5AJDZx=kxF?>bR#8SPP;`)gl%;Oy73_q-<#SBa%kA(v;0;*LyA&l`Y$2=EI?
zEfHHfjf|{n4T`ph@3q=
zwmvQ|f8+UG|9ttxnWyfV--}SRg_b&4E|G1g$Y#og8AOWz_isuc{m`~Zg1!6Q?2ZJh
z6t`wWjh=k&wPz)M{qqekKXs+r8j{@1#E1@j`Sv&cu~75-j)kkmQfGU5&FaKkFRs7kO*urX
zfhNJn{{?oL<5yq3&=bZDedgo;8vp0_H9qs1|3)QW{U%6KX<~Tm@vGR0N8WthZ~EJ_
z?cjfShSl2%d*;l?Kf>OA(MGr)U%MJJjb)PUTB7*MSM_}A6GKCvn}T5I%U^<%w|Yw-
zKldDV{4o#Q_uz^~ZSd1qh~K^1KI3JZ0e$$t0)_D}A73KLWzKRgzNr0&|GE9vTeo-j
zvG4wf*Np80%T~QoX#eK73hVxL_>y-=8Q(1I+`4qh{EvTp=zZ@W!6&}>1$OTr+4R)*
zhCcEi-(GwE`S-(jKB(*8{OTyr+sfy20$1C5_wN@U*_O_Bwxxy~vtaSjkQ9zN1hIMrjaJ
z`P$zv&t_Py#4@aM#V6Q@uP`RYHo{W-i=Shi+4$J#=C#MOGtOw;aO)H?{J_pSoDM_a
zFa!=m;CVpcAcuN~CoS@a$Ad%L9^y8vKQ<;k%Ihvz+^*}8HHk|x7Z9Wa=t1z^Gr{@}
zu9_QFE|KlBwQ5sGSnZx_sTxAGr#7WJGZ9gu0^b2|hK6MbqGQ>rAaYS9(r7qNE5VCi
zCa*V|)kaClwJkL@DVp^f+MTxNIcje_(%G_RY`2_D8K#L?nsQrPTgx1Uas~o`L1~_|
z;R4I%MBfE9d^*8mlDAC9G9!G$UbS-7Bh&DR3E4i-B2UJ-2%$>Ccn`gxf571+c@*;m
zgnGxIAd`3_2s}%w1%hjt$q+=|EXK3P9yn9t7mO$db~5c0O$2;X(GG4Yhv@GoqZwQksD@*%^$aF?Jt^STSB4UfrHRbVXsT=
zXP=0Wt^m^s22rB6%$#WQ~tb%v*GPWqd4_uq0lp6ufjt
z#uNT;oFzL)wyn>!b;r|7py}vwJ90Vrc7ujv+-ORTX1RYws$QHFy<8}itd#1x
z1)0Lw1MOXz%2+BK&M94y;f)XX_s-{J1ZUkAPb36uAyhjMb%d2LLRjGnd=%TwiawmC66k&stNd_CR!6;-X_3m2=$S3a|C(w5y2sjyR#6fq
z6y-1k&@Bb41I>1PFQ|Y6x&-%YG*XBPj~UYDyC+A5)LM)pkKVy{nu9Z|U`*jyzC|>j
zBRQOeNkS22G5RPe04C(L2(C?eJ4L=+g(3y(a}X*8^C#r;Ixng;$ILePdI!?N=mi&{_
z0)Y=P%nG7v(=>&I3Wd(FGbq3W5Y6bJf|0f1sLXCD1_{7yIj-{vr6$8zn-_FlGa`{*
zIb@CP-q~}+s?>r<%j7g4>A=U=FMjxT7y^eOaBv{-_ef;Wf%}D(e8W+HR|8)j|KYrA
zP-Fz!=}2+Xmqz%J!thqnt3wDtF3(aJz)<9zgY!tP
zfsVr0FNek>s8Z0XfK>qe;h{S~JYbgi?E+3E(FH)#O6NG%C2#rtp3h!EuF60C8EL_(
ziz_>~B;ZI2{SZJ*NE}b32@h|ftVy94;njn;=xy{Gs*j!ltV9vd@IVn?$>TeS5;P3W
zlyDR_ns5#u7GTK3rhs0-!U1^$9mD4XCz44Kd@Qi~)p~a>E4Z3bX}C6msxX)_J1}MO
zNCy*WAEy5_G9JRdpifQ8q3Ho%B@K8eLA(!j=FbBmsg=z)8RkkDb5+
zvxY6fEVhYlyl;}Vjb`oXeeb^A{r{e-nf6GUu_aq$k3`p}r>1V*x^=5g)vfcZQ>RYR
z?h=+_(nFxCScB)#c@l#Mb-eT$b}MC_JTBHcNm+O5!}p{|nf~J_IfX2s9us5w75$Z`
zKr?_c(3kFM_`oo*i{;E_c5d534JxU*imRFPyM3r6H>w3U_
zArzs{>(cA}!i%=uq@yA#qsx<649#F#9w{K2xE!L&HANMzPL(8uY`?~Lrkz-cl@`YV
zWn7qXU$EjYc)lie(Uxp{u6EHbVMZmNoMbC?r2vAFT}~WEs|lnt=z3iWbScoKz!6el
zje!hIrN|tOA(CNH*cgr_7o~@9K?5=fGkJtrvVF2f0#5#sRI-th8#3-o8aR(|FIa+(
z5fp)A(1k4#qjNDiFTO?CmpGkN9w!w!95u%(kFXwIz!8{rj;gA&S0Whov>WXF;AQ+^
zZ~DJnp>PMAG#H423J){eUN{Uztd~h0iG%mTgW*RuRyC^k@7p-$`s&v=r~s0WvYNi1
zBWDGlNQPhthXaX(TnQcYPa`TamIV5T$4w~)z)rtiU&6Fpo@OSKvfD|t89Y29%vXy!5HI_4YsSM@ciAzR%~VyW3t4AFDRYfF9n@pY9Y*fd%Ga>L7N{^j%^I
zOZBK7hFf*>;!7xM_){uVW~VYo0oMO-M#rX3rrw@tPK2@T6gy#y0*
zuU*oe*1TU{scX$G8bZos3M%i>paG$mj$C-N>Au@6(Hbe%+wZvId9rm`cNg=buHU6VmjYc194Q6X7|3AU
zGsCG&pf!Au@fYr^heawUB4A=FoFFe345Kpo%g8AMyX_N{!VRJ%h67PejGRBhtWU;P
zn`L%G@#S#N`W{QUbmQ?d5g)N7jmMCyjBk36lms-L}RXm-A+J7X2jw+@e~uH
ztd~4SCyk;mzx?Gs_Z_pDdVd6+1}|s#*3!zyf`(}#&9xz(p5N<|5~JTM^pLxv*24;g
z)Y9D0@sh-}wgIE0)hEjtmds6g96oAuRtPn&%0o>y(YWa=Z3}siaB8_L2c2-*J$k{W
zcd?MbDue6?g_61kI$mTTpaT!QU`w0
z;h-odsvKx>gg2Y2=>E?IPGn2cl-ifF>7Fc5h$Rp3g49b&EWWgowtuhRK!tcc3vEIu
z>2H#($pVd*UbSnrN<13OW@lmp!Q50<`C4yyGub)}9ycQezN?9hcddm1W$u8UviLfsTc&qq9cd^6FLgw&j`=
zkisFNjOPeNV9D|#o?sN!gYrYfBZjn)1;#}{CwS=YVTTMalH?5ang<9Vz;OVGV2Y;g
z%9m=zy;B2&{sy;LbpR4kHtuoBiLx@mT);pW-IgLbJaR~z{4^I~ZZ3-~pb9LLa}b&e
z4U(^~n$J0Wy~A5JwO#k-vZ7c)5mYEGN>%Ig*M9!u7YvRJ#eCjYJy~&caL5AX
zbOZ53=OH<67a4=_^CeCb1u6;X)KucOlue^fR#HUPB@H2_oyl1+7O0HckdK>_X{G0=
zn&?|JBUGDNKBw$j3Ja^qi6Ww(;Q$T7m1TuamMYNbCAB<7ShA);L@S8gbQ>E}sPl8v
z{Ts%M(>a>ohei=oWUSwsDr2p|B-+t+9
z{vhxem%~gMx_*}eT?+iJQebU?3{>^nTGqQTtrsYuogR2~Xi>(n5F;vjG99$EoE+ZJ
zf<4=o2tpW&xy2zPu$%^5Rt8@gTj8VRWOCN>@TI&;vgLX~=3!obRQ!M!4uf-+Ypou@
zQq$SjKN5@7D;%4`oLG)KugPLL0*qE1JRx#;sReA$qgoh{08g+uK@5@*eCDGZy0%`p
zfyg}aE@xTzcd~UXg#Om3CJ7Ps*&Uz_~Ql#P7ZH3f<8p2;uM<~fmy5(iZftI6y
zFqnctf{B-?Z}2S=l>z{X52!by{u%Y+S)-WNoDl7RdjmV?1dVnh4`
zp7_^)oqN%9dwsEZBe^$|aSRMZqj7}yKrfw)f=S1q_3>#$no>(FI&DWcpm9y-AuJ0h
zINrze!u|E!-Kmdt)@7H)2)Y~nM@Yy51QH?siK?$QJSH)k`|2}x;mu?QssIiG2Bj~_
zgAQ3?kQUGckgyaH04F_r$Xgfi49eH3ild$k5d=V>N@IkrK;TE2A(Y
zq73h5lByGO12*Z*%K%DPE;&S7>(Va_&Q;YGdjboyc6K6|X|9Z$lAEww!iNr{jK4Cz
zFL{@K;o*6d^iZZNQTYt26)5*Lf&sPTf!!yp&xL{^yBW3HQAaa^KA`1b-$%n?v+n>%
zA*Z>vSp|SY*a_JqU{yrML%{@#6lAMKb(^3Kw*0oUyB+|uKuo`EjBhw^Xq`8ou_~Dj
z;fS;8jn2&O3%j>)61rCX;|Mqy9pH|Dkr~710A-bIYp3v5Y5{Tj=Yb>dTN<_N`+R?
z$1!dmB>L5iD4FUuLYA`#GAOMGdzgQV5MuGo(ddWECOV#e
zkH=R}&UxVS=#w-R);a03&Dpd&0NKF@QacfCNq}v=^l(HYw6eq*%w(_*SGZ2clCMG@
z6j76CqKJeugu-mi^*n<4&I$UbSQTa@CjBY#$*&KJ@ZgP%Vg`->9$0Pbq
z^5c!rz3aLZ=u)6dfk#JyRR`flEiF8kaFg8@6*jRp-IeC1y1GTu=;L@w1@I4cHYgnfxnXJ~0{l>KV#t-8%)1Oz
zUMQh1fF^@#{a9YfQ>>MEIoE2Bq}R|$_y({9n$`Bx1dFxPoP{)S8qGRHYNLNz)GwKt
z+AuZOsU!ySFfm6Pf(DBv)LdGcG7yZR`~W|Ei0?_-M{?49fFzkiOUIzr_);%lrK$4u
zv23wCm^cX=9@G2xxT^t_5F5g(;m7<8vy)CD02HRJJAi&(=OQ49YE@*#r^Wswu}#7&
zL{FiO3?nF15add;@@gu?4h|b5-x?gyqrfOJ5hRF~G5v>H(oeMPM?^=w2bqxI1`Q+F
zC`;#|R1^kZe@6mbcuKgw#J74VxzFvKD(so54<-NrKmbWZK~!BAiBzg-m!sbDIz#>q
z`D~31wLr#JyVll4WlyiEBkwV?H%%XK9**2-0jdM_s0d=InpVv*OEU;YaJ*XM5*kW6
zKRrf_*y`mOh)f!&*TPy%wOMyH{ccAufTP$-vpt(H$kFnkPVB*ws9kCM%KLVuG9};m
zczAwZ4YHTK>y91;L}OZibNUOXd(x&0&V2N8Aq^*v7A1&JQ+EC1j{;^Glpe6y;(9RD
zZLeo6rnhLW$5$*LbSI%sbZmI5YbOI5ux4E<7Au9~>D$LM*(wAb8&>=GKW6Ia(U)8}
zzo}H#q}MGFjVg>ME;LoAO@u=%X`fC*EoO3XX*5@sQ6A?|>qgYxDH$8$G2d->><)xN
z!Ei{Bfy9}S!Hg6Vbzsaw8i0u9uxizM!0+drE^>~96lb!KIc#1YGlNa1oV2*JAu-I{qe!4=e1Ulid|pJo&QAF8kcI|9<6_H#eI)
zJ@E_qyj0R(^&1l}>4|^m*^>X~zIf#)e`DTT)P_i|cnA5s?3!!;^~x)6ll+6KNbi#L
z&%Eq%%K3k)I=?ylJ7Fn81+o>-cLwYw8sY>H2o!m()x0
zY4hH5C7;hhhg-=f80J)7=@NhW)@Q!#rI-E7|NYEAed^{`L(@ms_l<8p^H2WdwV(g@
z&wk_|Ztfip-+AYBh*Ma)?kG`!FR9(Evzy%`0y?W$s(Ji=Ah-DnZN!z9!mt}AW!V>&
zoN4tAS{!XC%#{M@^*nGg;f_xe6JF|LD3H^G8CxPT&L|e2FfkaaKPaVnig9Dvc-anp
zV9qAJdHd2gK72lhrZh2jU3sxXm{&cRp3TU{etIl14WRpS?==Ihp#xCV)wA
z!sOhc68V^L$2WJOkIA2S6JyFlylkqGv8{Pfpcox-2Y`Aq{#oz5Qr)jN>UE12R~aa=QIM(k2=~
zPK!O^PM0cIu=C3yy>PhZr>^|xZ+zn$<6|3Zwwy-d7$OXpos!$v>*K+2fAejf|LNVwt3HqV+czR3q_2>G>d?s`46i0!o8cC+qw
zdGQGo(|OlH^>VSEtKWN&58XO%;q8==9PsO`LM}lPB|qZJ4p=$&+;hjr$8WjimK{5G5P1~yHw88&E0s#r$nWEx)nx3BCuwesvm|7fRX3HceAFvmcA%HXFotvBKNrdfY
z)$R6jAA)(^vPooaex|3V*S71Adpw}0-?p0%l~c4W)Le275EcnXo^sw(1_uXeW%?ll
zOvA1t^m!u6dBpUI#}jTD!mNBT3!TH^poMk)LW#5NWlGp}M}qh^fp
zL{(=F?E#6_`};h9`IjI2)vs>&>-T@)>@!bdF3xr&^sIpsxTWJI;iZ>Li$>d#Td5@C
zkX%khA`+I5W(B7Qp=ItZ&VvrVwbFZ6nlnC3dS+@ECT0sfG7NkG7BSKXmvfyen+!Yt
z()TWXmrl>%3L|KCe1@w)z@u-;>LUR;-9o1UUSsk$77NVJ=ll91^YevREL^EDpJb_#
zftpX?06&w#*6;x_CXG+FkTHN!2b7$I5fP8?bkYWrz7wO<+q07sEntJg``-7y|HN%4
zzxmJJc)}+1!#Sj|=5pF@4sFI7FIrz>l-VQZ_GIaloP~Rmd&ezDv$YcU=$Wyp=Ogk+
z!(5rKGYU^mPOe+Gjxa2wGn;>mlwi2e=kv%jwr}5_&1S(FpZnbBp8C|MI#=qgNBBPG
zqo9hVg(plNrXL-CW~8UeooDGB(4pCEg0~JolP54GNDGouep)Fig?hL)$z^6_&~5$uSxnRAYR0BhrZWt+7CSNz$KSla>ETbfHQvj
z)1RJt>Zt*LK$m}+^iN#*SEL)gk*c|vR-*=DH)w8fhTdh{1sRXMgG&y8jAp&&@_H*A
zZ_AOmes6{CKIl%ddAgy_JMV($KmYmf{i`>^m=K<$Q$0Uli$ugStmY}=>)*po&lqRe
zja({K!eM_lTZ}|P#UfvjQQTRk7Apz5VxEoe~N)K
z1SDYILRL#($D`cB4@JYQzVF^OiAla6{_saP-1O@Yf9S89?eYm5hQXppyjy;gE>VnWrCWCC5rh@u3A!McTkZqXoa?NyPaUhIHB=Vm3yyx|=fBpRY{2%}E
zAAkGX-#-8R^I=g(meC5SJ4L0yQ~|b1LMjzS`{PI)4}yWHJM5DWhQ|#Bj+Nz-4j6*q
zj0;>+k=|Z8mh4E#uwq&xx-cYyN;Dteyux$?>!PUj=7e-U)F|Cv9d9AtB(KLk-s#0=
zJG+>4Q%X5q-bNiI3+5Y+FMsK)XPtRYC>VM9%U=1N>%Mo&$=fNRm)$sPsQfF^jlt0G
z4+5SLBJ;IUFA86-RD26tuUBli?u{d$0MdK;Tv$g#Yud#^39K2z?YV+_#})5F8|HPd
zxtQC#cF%9z*bB1jiF&aos4<4{EkPR^W{}2ktV3VjY&Sg?YP@xylrY&L5?j~n0VVP$~g@YOHl
zNKLG~{m{DT<%14o2uMm{$T}?#b$-xYZ*DiWSn7M+ZFd01R31vm$TkoUGBSq(6l{6$
zRL;&WQ%bbf0s(0%T@(C;GBX6o=65N-c`5ajH0^e3c7JT^NvZVg>1Uk%s#m>Ya&qFc
zpZ)B|KmMLnGD8BV!^L1LG7k`j$U$_SmVNOWj$Cy~2930o-y5EdY~U!;1pdTuf9tKc
zvJ!zv12M+VojaGl^fA7R{5w#?WCfqoZGQwAGjM~B&6<(vf?R@HnDrh(E>B$2nVA{B
zAIeWf%y(j{v(g}Sq$TCUCUYo5=7zS=Tt=dHbA|Z!nu-T9q8s#+pZw&>Pku5IJCtvJ
z``h0Ff2qQnDkl_PwmeLB4bG!MX<0s7nw!X@gdvZ#I~=#^G2hN;RjV~!9%r>Co3_w_
zx&Hb)zVwwZf9OLWO2jQ9(c>xR%090BLeOl#_{A^!`ufNpkqHAR
z;p?uu?jCD0-;2PMdVNY~R{p4pqrK?0^
z?AQ{)23w6w#cU!m91RUs3ps5q&CJS|erwCOO9MkYva4Qpo%3Uhzxk~+-l9ReY`gH(
zvhiX&U^!>x2Z!Eal5l7wG2{&#%5O)na++A;q(yK#^MNCd;O
zj$asv^abI7Uf9+5J4{~!NQR8eL##An#6bH5`IcLi<=b}B)=VmO!3BTt+uQ!9
zTB#$!@S$G{sxXQiJZ-9aa9P&+^{RsmKmaQRW>Jt~%PeI95|4DbVI@K$4EXxjzy6xn
zyat3p{`4Ev`%%ld^wLXLdgO@WDJnBmip{1HYJsCVoj!El2IqV@l6ce83*ek9^YK9R8YoAgCeMWz
zFS2kVc?Vhp&s`PNQ=hBOF+Z;6gVo6*v==(X2gd%*=4uxZ6WOFAyC_~IA8_{(4ZGV*p3
z@FCHhbQHQQ53ZdWbxU%LQh-jyI7nXt<1%p5@#uule)hA$9P~XpDv?y}g)e;J=Rf}i
zE=lJ1qe0eUc7h~`-_lX(7$rit*pH3^+7K<+L9{p@a>6}SIOr;uR8K5CKRXu*1*;X=
z-~bA7d4q*=-4~2hudyD>rDqfmqaf6>**cBQbQ_RhvH^bd_v!AQK1l%Z&X@)MIQR{I7=GWoJU6eCZQ+o67?-dgrYH6QT@#UAlT8K@%#
zpqx}W9P8zE6oY!1pCO2;rm5+&^j|iTP5@X5hXU#O`JsWqx#^kS-o9dOE^cwCc+xM~eUeLz5MV!C(atE@1rXtFOiY7eY1zcmWnnD_{4z
z*S-AZFDITy%(&0v20|XK@^tfg{3x)NJ}rQPk?1mmBEZ^>*XzFOs(*g}``-`9s8*5w
zwwNrkZ}1Ioc;lPi^rpY~i+775AS~zGvJsj930&svxyO%!-8Zcf3NY=KpN1OxY)9tL
zdJ4@d3g)k{{D>Ug%$E=uFxDaG2)Mn~8p=;-Y&3cuR=v^o2Rw~>9U+IsK?^L4Fto|k
zS>zdLH!NG#U3(^w_4f4-vsIEDFuI1-U5DkV!atA1=@-cdX$IuZuuO)8jpHt*G7eiH
zCZNkGp1CZQu>?`KIKUD7|mC7O5`8dwq4POd7s2W|&5o!uYz#QVh4}2$yT+
z+yt>RCQ2Slr58)XI(OsEB{Kw=S1?J4g`<4(OjdpVa7U6sbx43uX{2hBJ8B=aGC-1d
z;majP?YNY9B6JD3l&wJ8Oy$VP#vMC%ZQOXuo_*83z5R_E+M^FijF1ZPh?q-}8XtS^
zSOOV{E@%=X#-OE{FCwKNfFuLL)4z?{1kI0OF63Hw+;PW-4I4&BN5LO30Hd_g6=oc3
zom4(By?KiOAMF$Ci^i+l9V(Zr^f#=8uxpwathkNXaDWAtyDN27V#Wo9tVmuzzQr;)FE{FMcP5!QTG$;Tg60@Bwk~pw?uypJN9*Bkb
z-X1kGlkV&7&F69X&!u@sL7h&Oqfx0o>1U0Q~vrG+M)
z_Z}2a2`LF*=+gM5^;#P5^Kr(Z+wW(sBvY+2fvr)_fdLSe)Lqwze>BTNef6_k8aQx}
zzm(1kX|Mzu2}M)M`Qd@#+3C6dM1L+{5J`rBj76LwVhs9@&P`(!9zKTL(vH5Si_I#D
zX+{FzO2W(wvETf>=RFVI3)&v2i(I;cLSFHTSN!eY{w<3p)QZFgf8ej_N_GpkJOvmI
zaBIQGG@+mACTbSZC?~F|{=WXVzV+=de8EL=&W;lixE#sG539zQ&S%-~V;}p6&wcLS
z8V!^-M5j`(T$5rg)a7u>pb6jgjv57+$RatAnY77L=D*t6oGl{E3gn7CGTHFx8Qwt^}G%WAZ1>(mdG@VCj;ZS`em2CT6K`?i!yQ
zV6_?|NS;V;P@J>{#6Zl0ryu0MY`i|e8FS*uiKP7e<5~Qb%1?8&>a~hZThsw3F1Irg
zjk4*(W~;Hb=_&Q1ROU<+&Yg6+xgb}70ir4m4-j5ROOcZEXON%J%ESY6h`YCO7vng<{C<45{ZV1(JzXsmnjIEaDm
zcHjU0_n-2Vrx^V^KnBQzA`w8sF*Y^^B0+};@wJHrh-d(Nq%ZHLe*!76FdRRDC0O!m
zW}H@PJ{OBcQSX_aW@C0AGO}O(@|Rn;ZUy_25?KXlKp5CU*s=5ebIv&{l}Z|QBBX0Z
z`*=x)Yd^^F-E~KY0vvVKbZ|zlvktqmLad^3d4JPy1-o8k3
zY9GQ{63W48E*An?G=cC5Gl-dPw#bcyRcRr?ii^T1SMuQcu`$+J7#rC!$0H1?P(tLvfoTT1$l9ZSw?v0QfyHUxVI*DUBr>=GAmo$}20BphFMc6L#7{fz
z=EsE
z-BF|f3|i~($y8S6-w)}bOOFz%gwe?m#>uF~fYz=x{4RH`T8adNrBWdj46@$Ambs>!
zktWI*WPt%u2lgMhY_{~i*kww*al`1;zJ2UivCD<|sfmzBbm!AEld!a9Qa?kom#wrj$SJN(-WxpZ}m3P@t)4~utA8s5&g;BMO<)#PUaI>y=5@x+)&e0Je9
zN_q3(p|4oBu$&mQY&?&f@|b`rCqBhnHhoVh$Xzf{)bH7~Yd=%gv(GzE)hm4LrX(~2
z0pk;J%aLqU6%7isK9FQcJISS>4iQ5b-@KjU+E}&%OHE8njE|qNd-v|q4O`fohM8St
z7bbt5lCtqUPal)t-MAJD?-X)Io5BY2}
zZZ)d_*KpWZ%BMldKltwdd)eieU=FQN$c7`4TD8E~Uo4m1h_igoLN@ui>IO5}~~T}GlMZP~UsSAfED=a_6-so`01KG&hHjQULQ>cn??>RtF?Js$-0AH|5wi_JMNtY^ADvUO6C*vXcXNiw{TQ^~to{MI(i$3BE0$y6&f3-|d=oqL$1EFK
zU628{Hu%sfU5*25WqFAoAfhHKQvSMXV`nWEaFq*6PLZ;e&)-m1+4RT*e21Ikarqoo
zyAce#>!sqizW&8hMg8N4-4uNRNQ^?A+d1qE|Vs)XYTx
z`i)q9MM^2g@aVPlQMx`yEw@$BtvGksZe-$#A!4d^)o>SUjch!yPGnkL_k>Y^PnmbG
z4PVLer2F^pM}#&qGMt=G{q(0l=B%8*{+stwLXPHT=LqT-tjqTH_RP*EvE0U@9`V@F
zWE5jGLRW*kW+i(K)oUdRKVgl2e7=}D3y{JBW7JD>yUGNXJ=$206ZRg3e6m?t!p93Uc#MPl|rAOoX1PxT#l
z;j+7u$OwZo;CML^js4WWxar1iC!Zn`M$4L>oE%y=!ZN4bDjLc+8|;a4?b*FM)<0xo
z`qytjZsi2_pfMy}1GK?eh+f*=*#cqM;V3A^->&8xwO9%0+UN4Rv0yEw?YbwF0_KZd
z3%(fJ246r8MvA_^#P!!-KR!OroRUk{nDMu4*|KBD4tAYv*sy`aBT$vU^Ugczv8*eb
zu8T^VUhX50wNRsnFT)es?8oEF;SyN-X5Io6VB8b2mkf;juVdSjxjQEh7t3@0ppShA
zZnwW$uQ*+vVyO}chK=8_n=ZE;%OI#iGSN8!SOl&#K>@HRg!aN8nblb>8<0U7Y`1cJ
zm$k#^+9|?frryp#qviBkHSQfIrL}=`U2Yx#7DxwXIF%jR3qOh1Lnh-sAVbFNs`w^e
zVM-D1UQ?E~WFOss;BXeiM;D4=Y*8NskRdl
zk<3&@bOL1H1tiooUs9)~c|$dgE%1cjaVd>QD_G8Ir5240%_Xym0gO52yq-~(Vl)(^
zR^+LPyugN*l5A=AYdTB?R@c!8+8J!Y7XaFWt#hUvwB}~JUQBZwU)yf9Ffs$%ceu+|
z25E>rcV2T9I7C-?MHjVJi|ZGy??kw%>NgYmV^H#_jvl
z4KAm1E#k9f+vzBI94UTYl{7yzYWRht$PJUKIXj=+$-$Y49!lLR)eEajoo?>O8U%gf7(xz7CIX&iXRwQ}ShfGlHVutVE2G)Uc!FvdLq~6K
zFRLdgtgKo=o`8&38DvOD1WL#boW;uVM)WY8J%JdA!>yX@5)r?v90*n{Yu2G;@CC*l
z`V-RvB4Sfzjd7D%I~We8^0JhM9^O>4k}au5p~?22y;FG%7|f(<`)5m}4@YBMV$z0i
zz#ow;?54BX@Tj_9)x7*#RcEW#E~Zqipq#G0b>ljX%H^!EXWbLkDHqAr{lB&-fVCA0
zgswa4^o$FHQIAJN!7xD>2*QqkW|@RB;sQTFNgm8$?!qL9XJkR0o56g_v{2t0$kKzpE9k^f$CCNGq
zC|m$U82R}wf#%J!q0Kztfy?ghv9g;x5=P-(UziXuH*7sp3Kv${N%6>ogsmhT^
zxLnEwyuFQvoT`YH5B-OJ1+-=a@G9YSxk1x#Ka1b~+
z*WiQ2Tatz~0j6|BaaRi}WFXZbgGjV7I+v0U%MM12vAFm`4yfKsKH@F-&gw##NZu&A
z`LYNi!WDTJKwq1a0Dhs#fy4H?JgxEZIqUtOr&XWFW&3c%fGZXuxs+d-mRO=E=|M
zkE?uAx=q6pT^i{M2l{6DD;!W&6p}qEUs4_?2JIJ8Zr-SN>=H2B<8u&?GVnn;@J`Mf
za<^4TcS8E3{Ir}8K&<ryF>56c9-U(hKCPoJZ>P8%YLc
zF4=0zX=+O)8Db7jub4c#7d^(O%Ow)BGP9hTN5B7N7`sUqDiHjhysr3Y5=&lnxD_R
zJ*{Zmz2SuQqr>Xzf4Zzc)(8cQ≫&Srrg0=^ye@xvtv{zt=aPPGQ@Qvy!9XNFWr%
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ώ*z^(#z_Bl)uFqqE;C8X
zKJ1o@8c&#cYzLR0J!@SSdv`C}vRRfXN!Q?vkLJx<$Ty+B71>It8H!*B+reWG&QD|fuQ=~I}q*(1wK!+^2Te|>{
zRi^u%53d2(*NshE5`^O#LQ+`KkT+-{ONNYEOh9o#BCJ>TLj2SA#KyOfc6?
z8{y8hQNG$IWMzA&8%w&VZE7Gnb`@^p8ueGpFUAp0k1Kh1NF!tkqNj(1lfrFjnMyiK
z@OtD!%5FK`?x=g4xk_Yj3^v0BoAHmaW;PR%>m(I}skyO+NehevpBHydNP=i)AqIA5
z2o%XyN~s%-B=M9HOx*Yg9DJ`;YDWcM#U1pa9z!
zO=+xD7Te@jx61#e{9~3_YtlRi>yfJ#a{a57{~FBy=%z1(&&%WzEmn1s=U$ZhFUf=$
z<=M?@xE)O}^bdCZFX{PM1}VsdwPefVzvch`s+%v^E3?G5#;9`&#AiFS_2pgp2*l4*2ymJ9Smtal8rt*jWGY3FrLF;{(j!,CharSequence{
+    //用于存储字符串的值
+    private final charvalue[];
+    //缓存字符串的 hash code
+    private int hash; //Default to 0
+    //......其他内容
+}
+```
+
+## Stirng中的几个重要方法
+
+### 1.多构造方法
+
+String字符串中4个重要的构造方法:
+
+```java
+// String 为参数的构造方法
+public String(String original) {
+        this.value = original.value;
+        this.hash = original.hash;
+    }
+// char[] 为参数的构造方法
+public String(char value[]) {
+        this.value = Arrays.copyOf(value, value.length);
+    }
+// StringBuffer 为参数的构造方法
+  public String(StringBuffer buffer) {
+        synchronized(buffer) {
+            this.value = Arrays.copyOf(buffer.getValue(), buffer.length());
+        }
+    }
+// StringBuilder 为参数的构造方法
+public String(StringBuilder builder) {
+        this.value = Arrays.copyOf(builder.getValue(), builder.length());
+    }
+```
+
+### 2.equals()比较两个字符串是否相等
+
+源码如下：
+
+```java
+public boolean equals(Object anObject) {
+    // 对象引用相同直接返回true
+    if (this == anObject) {
+        return true;
+    }
+    // 判断需要对比的值是否为 String 类型，如果不是则直接返回 false
+    if (anObject instanceof String) {
+        String anotherString = (String)anObject;
+        int n = value.length;
+        if (n == anotherString.value.length) {
+            // 把两个字符串转化为 char 数组对比
+            char v1[] = value;
+            char v2[] = anotherString.value;
+            int i = 0;
+            // 循环比对两个字符串的每一字符
+            while (n-- != 0) {
+                // 如果其中一个字符不相等就返回false 若相等就继续比对
+                if (v1[i] != v2[i])
+                    return false;
+                i++;
+            }
+            return true;
+        }
+    }
+    return false;
+}
+```
+
+ `String`类型重写了`Object`中的`equals()`方法，`equals()`方法需要传递一个`Object`类型的参数值，在比较时会先通过`instanceof`判断是否为`String`类型，如果不是则会直接返回`false`，`instanceof`的使用如下：
+
+```java
+Object oString ="123";
+Object oInt =123;
+System.out.println(oString instanceof String);//返回 true 
+System.out.println(oInt instanceof String);//返回false
+```
+
+当判断参数为`String`类型之后，会循环对比两个字符串中的每一个字符，当所有字符都相等时返回`true`，否则则返回`false`。
+还有一个和`equals()`比较类似的方法`equalslgnoreCase()`，它是用于忽略字符串的大小写之后进行字符串对比。
+
+### 3.compareTo()比较两个字符串
+
+compareTo() 方法用于比较两个字符串，返回的结果为 int 类型的值，源码如下：
+
+```java
+public int compareTo(String anotherString) {
+        int len1 = value.length;
+        int len2 = anotherString.value.length;
+        // 获取两个字符串长度最短的那个 int 值
+        int lim = Math.min(len1, len2);
+        char v1[] = value;
+        char v2[] = anotherString.value;
+
+        int k = 0;
+    	// 对比每个字符串
+        while (k < lim) {
+            char c1 = v1[k];
+            char c2 = v2[k];
+            if (c1 != c2) {
+                // 有字符不相等就返回差值
+                return c1 - c2;
+            }
+            k++;
+        }
+        return len1 - len2;
+    }
+```
+
+从源码中可以看出，`compareTo()`方法会循环对比所有的字符，当两个字符串中有任意一个字符不相同时，则`return char1-char2`。比如，两个字符串分别存储的是1和2，返回的值是-1；如果存储的是1和1，则返回的值是0，如果存储的是2和1，则返回的值是1。
+还有一个和`compareTo()`比较类似的方法 `compareTolgnoreCase()`，用于忽略大小写后比较两个字符串。
+可以看出`compareTo()`方法和`equals()`方法都是用于比较两个字符串的，但它们有两点不同：
+
+* `equals()`可以接收一个`Object` 类型的参数，而`compareTo()`只能接收一个`String`类型的参数;
+* `equals()`返回值为`Boolean`，而`compareTo()`的返回值则为`int`。
+
+它们都可以用于两个字符串的比较，当 `equals() `方法返回 `true `时，或者是` compareTo() `方法返回` 0` 时，则表示两个字符串完全相同。
+
+### 4.其他重要方法
+
+* indexOf():查询字符串首次出现的下标的位置
+* lastIndexOf():查询字符串最后出现的下表的位置
+* contains():查询字符串中是否含有另一个字符串
+* toLowerCase():把字符串全部转化为小写
+* toUpperCase():把字符串全部转化为大写
+* length():查询字符串的长度
+* trim():去除字符串首尾的空格
+* replace():替换字符串中的某些字符
+* split():把字符串分割并返回字符串数组
+* jion():把字符串数组转化为字符串
+
+## 考点分析
+这道题目考察的重点是，你对 Java 源码的理解，这也从侧面反应了你是否热爱和喜欢专研程序，而这正是一个优秀程序员所必备的特质。
+
+String 源码属于所有源码中最基础、最简单的一个，对 String 源码的理解也反应了你的 Java 基础功底。
+
+String 问题如果再延伸一下，会问到一些更多的知识细节，这也是大厂一贯使用的面试策略，从一个知识点入手然后扩充更多的知识细节，对于 String 也不例外，通常还会关联的询问以下问题：
+
+* 为什么 String 类型要用 final 修饰？
+* == 和 equals 的区别是什么？
+* String 和 StringBuilder、StringBuffer 有什么区别？
+* String 的 intern() 方法有什么含义？
+* String 类型在 JVM（Java 虚拟机）中是如何存储的？编译器对 String 做了哪些优化？
+
+# String的扩展问题
+
+## 1.==和equals的区别
+
+`==`对于基本数据类型来说，是用于比较“值"是否相等的；而对于引用类型来说，是用于比较引用地址是否相同的。
+查看源码我们可以知道`Object`中也有`equals()`方法，源码如下：
+
+```java
+public boolean equals(Object obj) {
+    return (this == obj);
+}
+```
+
+可以看出，Object 中的 equals() 方法其实就是 ==，而 String 重写了 equals() 方法把它修改成比较两个字符串的值是否相等。源码如下：
+
+```java
+public boolean equals(Object anObject) {
+    // 对象引用相同直接返回true
+    if (this == anObject) {
+        return true;
+    }
+    // 判断需要对比的值是否为 String 类型，如果不是则直接返回 false
+    if (anObject instanceof String) {
+        String anotherString = (String)anObject;
+        int n = value.length;
+        if (n == anotherString.value.length) {
+            // 把两个字符串转化为 char 数组对比
+            char v1[] = value;
+            char v2[] = anotherString.value;
+            int i = 0;
+            // 循环比对两个字符串的每一字符
+            while (n-- != 0) {
+                // 如果其中一个字符不相等就返回false 若相等就继续比对
+                if (v1[i] != v2[i])
+                    return false;
+                i++;
+            }
+            return true;
+        }
+    }
+    return false;
+}
+```
+
+## 2.final修饰的好处
+
+从 String 类的源码我们可以看出 String 是被 final 修饰的不可继承类，源码如下：
+
+```java
+public final class String implements java.io.Serializable,Comparable,CharSequence{
+    ...
+}
+```
+
+那这样设计有什么好处呢？
+
+Java 语言之父James Gosling的回答是，他会更倾向于使用final，因为它能够缓存结果，当你在传参时不需要考虑谁会修
+
+改它的值；如果是可变类的话，则有可能需要重新拷贝出来一个新值进行传参，这样在性能上就会有一定的损失。
+
+James Gosling 还说迫使String类设计成不可变的另一个原因是安全，当你在调用其他方法时，比如调用一些系统级操作
+
+指令之前，可能会有一系列校验，如果是可变类的话，可能在你校验过后，它的内部的值又被改变了，这样有可能会引起
+
+严重的系统崩溃问题，这是迫使String类设计成不可变类的一个重要原因。
+
+总结来说，使用final修饰的第一个好处是**安全**；第二个好处是**高效**，以JVM中的字符串常量池来举例，如下两个变量：
+
+```java
+String s1 = "java";
+String s2 = "java";
+```
+
+只有字符串是不可变时，我们才能实现字符串常量池，字符串常量池可以为我们缓存字符串，提高程序的运行效率，如下图所示：
+
+![](https://raw.githubusercontent.com/krislinzhao/IMGcloud/master/img/20200313211609.png)
+
+试想一下如果`String`是可变的，那当 s1 的值修改之后，s2 的值也跟着改变了，这样就和我们预期的结果不相符了，因此也就没有办法实现字符串常量池的功能了。
+
+## 3. String 和 StringBuilder、StringBuffer 的区别
+
+因为`String`类型是不可变的，所以在字符串拼接的时候如果使用`String`的话性能会很低，因此我们就需要使用另一个数据类型`StringBuffer`，它提供了`append`和`insert`方法可用于字符串的拼接，它使用`synchronized`来保证线程安全，如下源码所示：
+
+```java
+    @Override
+    public synchronized StringBuffer append(Object obj) {
+        toStringCache = null;
+        super.append(String.valueOf(obj));
+        return this;
+    }
+
+    @Override
+    public synchronized StringBuffer append(String str) {
+        toStringCache = null;
+        super.append(str);
+        return this;
+    }
+```
+
+因为它使用了`synchronized`来保证线程安全，所以性能不是很高，于是在JDK1.5就有了`StringBuilder`，它同样提供了`append`和`insert`的拼接方法，但它没有使用`synchronized`来修饰，因此在性能上要优于`StringBuffer`，所以在非并发操作的环境下可使用`StringBuilder`来进行字符串拼接。
+
+## 4.String和JVM
+
+`String`常见的创建方式有两种，直接赋值的方式`"String s1="Java";"`和`"String s2=new String("Java");"`的方式，但两者在JVM的存储区域却截然不同，在JDK1.8中，变量s1会先去字符串常量池中找字符串`"Java”`，如果有相同的字符则直接返回常量句柄，如果没有此字符串则会先在常量池中创建此字符串，然后再返回常量句柄；而变量s2是直接在堆上创建一个变量，如果调用`intern`方法才会把此字符串保存到常量池中，如下代码所示：
+
+```java
+String s1 = new String("Java");
+String s2 = s1.intern();
+String s3 = "Java";
+System.out.println(s1 == s2); // false
+System.out.println(s2 == s3); // true
+```
+
+它们在 JVM 存储的位置，如下图所示：
+
+![](https://raw.githubusercontent.com/krislinzhao/IMGcloud/master/img/20200313214234.png)
+
+> 小贴士：JDK 1.7 之后把永生代换成的元空间，把字符串常量池从方法区移到了 Java 堆上。
+>
+> 除此之外编译器还会对 String 字符串做一些优化，例如以下代码：
+>
+> ```java
+> String s1 = "Ja" + "va";
+> String s2 = "Java";
+> System.out.println(s1 == s2);
+> ```
+>
+> 虽然 s1 拼接了多个字符串，但对比的结果却是 true，我们使用反编译工具，看到的结果如下：
+>
+> ```java
+>  0 ldc #2 
+>  2 astore_1
+>  3 ldc #2 
+>  5 astore_2
+>  6 getstatic #3 
+>  9 aload_1
+> 10 aload_2
+> 11 if_acmpne 18 (+7)
+> 14 iconst_1
+> 15 goto 19 (+4)
+> 18 iconst_0
+> 19 invokevirtual #4 
+> 22 return
+> ```
+>
+> 从编译代码 #2 可以看出，代码 "Ja"+"va" 被直接编译成了 "Java" ，因此 s1==s2 的结果才是 true，这就是编译器对字符串优化的结果。
+>
+
+# 小结
+本课时从 String 的源码入手，重点讲了 String 的构造方法、equals() 方法和 compareTo() 方法，其中 equals() 重写了 Object 的 equals() 方法，把引用对比改成了字符串值对比，也介绍了 final 修饰 String 的好处，可以提高效率和增强安全性，同时我们还介绍了 String 和 JVM 的一些执行细节。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/02.HashMap 底层实现原理是什么？JDK8 做了哪些优化？.md b/Java基础教程/Java面试原理/02.HashMap 底层实现原理是什么？JDK8 做了哪些优化？.md
new file mode 100644
index 00000000..e79ac6c9
--- /dev/null
+++ b/Java基础教程/Java面试原理/02.HashMap 底层实现原理是什么？JDK8 做了哪些优化？.md	
@@ -0,0 +1,355 @@
+# `HashMap` 底层实现原理是什么？JDK8 做了哪些优化？
+
+HashMap 是使用频率最高的类型之一，同时也是面试经常被问到的问题之一，这是因为 HashMap 的知识点有很多，同时它又属于 Java 基础知识的一部分，因此在面试中经常被问到。
+
+本课时的面试题是，HashMap 底层是如何实现的？在 JDK 1.8 中它都做了哪些优化？
+
+## 典型回答
+
+在JDK1.7中`HashMap`是以数组加链表的形式组成的，JDK1.8之后新增了红黑树的组成结构，当链表大于8时，链表结构会转换成红黑树结构，它的组成结构如下图所示：
+
+![](https://raw.githubusercontent.com/krislinzhao/IMGcloud/master/img/20200314141314.png)
+
+数组中的元素我们称之为哈希桶，它的定义如下：
+
+```java
+static class Node implements Map.Entry {
+        final int hash;
+        final K key;
+        V value;
+        Node next;
+
+        Node(int hash, K key, V value, Node next) {
+            this.hash = hash;
+            this.key = key;
+            this.value = value;
+            this.next = next;
+        }
+
+        public final K getKey()        { return key; }
+        public final V getValue()      { return value; }
+        public final String toString() { return key + "=" + value; }
+
+        public final int hashCode() {
+            return Objects.hashCode(key) ^ Objects.hashCode(value);
+        }
+
+        public final V setValue(V newValue) {
+            V oldValue = value;
+            value = newValue;
+            return oldValue;
+        }
+
+        public final boolean equals(Object o) {
+            if (o == this)
+                return true;
+            if (o instanceof Map.Entry) {
+                Map.Entry e = (Map.Entry)o;
+                if (Objects.equals(key, e.getKey()) &&
+                    Objects.equals(value, e.getValue()))
+                    return true;
+            }
+            return false;
+        }
+    }
+```
+
+可以看出每个哈希桶中包含了四个字段：hash、key、value、next，其中next 表示链表的下一个节点。
+
+JDK 1.8之所以添加红黑树是因为一旦链表过长，会严重影响`HashMap`的性能，而红黑树具有快速增删改查的特点，这样就可以有效的解决链表过长时操作比较慢的问题。
+
+## 考点分析
+上面大体介绍了 HashMap 的组成结构，但面试官想要知道的远远不止这些，和 HashMap 相关的面试题还有以下几个：
+
+* JDK 1.8 HashMap 扩容时做了哪些优化？
+* 加载因子为什么是 0.75？
+* 当有哈希冲突时，HashMap 是如何查找并确认元素的？
+* HashMap 源码中有哪些重要的方法？
+* HashMap 是如何导致死循环的？
+
+# 知识扩展
+
+## 1.HashMap源码分析
+
+`HashMap`源码中包含一下几个属性：
+
+```java
+// HashMap初始化长度
+static final int DEFAULT_INITIAL_CAPACITY = 1 << 4; // aka 16
+// HashMap最大长度
+static final int MAXIMUM_CAPACITY = 1 << 30; //1073741824
+// 默认加载因子（扩容因子）
+static final float DEFAULT_LOAD_FACTOR = 0.75f;
+//转换红黑树的临界值，当链表长度大于此值时，会把链表结构转换为红黑树结构
+static final int TREEIFY_THRESHOLD = 8;
+//转换链表的临界值，当元素小于此值时，会将红黑树结构转换成链表结构
+static final int UNTREEIFY_THRESHOLD = 6;
+//最小树容量
+static final int MIN TREEIFY CAPACITY = 64;
+```
+
+### 1.1.什么时加载因子？为什么加载因子时0.75？
+
+加载因子也叫扩容因子或负载因子，用来判断什么时候进行扩容的，假如加载因子是0.5，`HashMap`的初始化容量是16，那么当`HashMap`中有16*0.5=8个元素时，`HashMap`就会进行扩容。
+
+那加载因子为什么是0.75而不是0.5或者1.0呢？
+
+这其实是出于容量和性能之间平衡的结果：
+
+* 当加载因子设置比较大的时候，扩容的门槛就被提高了，扩容发生的频率比较低，占用的空间会比较小，但此时发生Hash冲突的几率就会提升，因此需要更复杂的数据结构来存储元素，这样对元素的操作时间就会增加，运行效率也会因此降低；
+* 而当加载因子值比较小的时候，扩容的门槛会比较低，因此会占用更多的空间，此时元素的存储就比较稀疏，发生哈希冲突的可能性就比较小，因此操作性能会比较高。
+
+所以综合了以上情况就取了一个 0.5 到 1.0 的平均数 0.75 作为加载因子。
+
+### 1.2.HashMap源码中三个重要方法：**查询**、**新增**和**数据扩容**。
+
+#### 1.2.1.查询
+
+```java
+public V get(Object key) {
+        Node e;
+    	// 对key进行哈希操作
+        return (e = getNode(hash(key), key)) == null ? null : e.value;
+    }
+final Node getNode(int hash, Object key) {
+        Node[] tab; Node first, e; int n; K k;
+    	// 非空判断
+        if ((tab = table) != null && (n = tab.length) > 0 &&
+            (first = tab[(n - 1) & hash]) != null) {
+            // 判断第一个是否是要查询的元素
+            if (first.hash == hash && // always check first node
+                ((k = first.key) == key || (key != null && key.equals(k))))
+                return first;
+            // 判断下一个节点是否非空
+            if ((e = first.next) != null) {
+                // 如果第一节点时树结构，则使用getTreeNode获取相应的数据
+                if (first instanceof TreeNode)
+                    return ((TreeNode)first).getTreeNode(hash, key);
+                do {
+                    // 非树结构，循环判断
+                    // hash相等并且key相等，返回此节点
+                    if (e.hash == hash &&
+                        ((k = e.key) == key || (key != null && key.equals(k))))
+                        return e;
+                } while ((e = e.next) != null);
+            }
+        }
+        return null;
+    }
+```
+
+从以上源码可以看出，当哈希冲突时我们需要通过判断 key 值是否相等，才能确认此元素是不是我们想要的元素。
+
+#### 1.2.2.新增
+
+```java
+public V put(K key, V value) {
+    	// 对key进行哈希操作
+        return putVal(hash(key), key, value, false, true);
+    }
+final V putVal(int hash, K key, V value, boolean onlyIfAbsent,
+                   boolean evict) {
+        Node[] tab; Node p; int n, i;
+    	// 哈希表为空则创建表
+        if ((tab = table) == null || (n = tab.length) == 0)
+            n = (tab = resize()).length;
+    	// 根据 key 的哈希值计算出要插入的数组索引 i
+        if ((p = tab[i = (n - 1) & hash]) == null)
+            // 如果table[i]等于nul1，则直接插入
+            tab[i] = newNode(hash, key, value, null);
+        else {
+            Node e; K k;
+            // 如果key已经存在了，直接覆盖 value
+            if (p.hash == hash &&
+                ((k = p.key) == key || (key != null && key.equals(k))))
+                e = p;
+            // 如果key不存在，判断是否为红黑树
+            else if (p instanceof TreeNode)
+                // 红黑树直接插入键值对
+                e = ((TreeNode)p).putTreeVal(this, tab, hash, key, value);
+            else {
+                // 为链表结构，循环准备插入
+                for (int binCount = 0; ; ++binCount) {
+                    // 下一个元素为空时
+                    if ((e = p.next) == null) {
+                        p.next = newNode(hash, key, value, null);
+                        //链表长度大于8转换为红黑树进行处理
+                        if (binCount >= TREEIFY_THRESHOLD - 1) // -1 for 1st
+                            treeifyBin(tab, hash);
+                        break;
+                    }
+                    // key已经存在直接覆盖 value
+                    if (e.hash == hash &&
+                        ((k = e.key) == key || (key != null && key.equals(k))))
+                        break;
+                    p = e;
+                }
+            }
+            if (e != null) { // existing mapping for key
+                V oldValue = e.value;
+                if (!onlyIfAbsent || oldValue == null)
+                    e.value = value;
+                afterNodeAccess(e);
+                return oldValue;
+            }
+        }
+        ++modCount;
+    	// 超过最大容量，扩容
+        if (++size > threshold)
+            resize();
+        afterNodeInsertion(evict);
+        return null;
+    }
+
+```
+
+新增方法的执行流程，如下图所示：
+
+![](https://raw.githubusercontent.com/krislinzhao/IMGcloud/master/img/20200314151422.png)
+
+#### 1.2.3.扩容
+
+```java
+final Node[] resize() {
+    	// 扩容前的数组
+        Node[] oldTab = table;
+    	// 扩容前的数组的大小和阈值
+        int oldCap = (oldTab == null) ? 0 : oldTab.length;
+        int oldThr = threshold;
+    	//预定义新数组的大小和阈值
+        int newCap, newThr = 0;
+        if (oldCap > 0) {
+            //超过最大值就不再扩容了
+            if (oldCap >= MAXIMUM_CAPACITY) {
+                threshold = Integer.MAX_VALUE;
+                return oldTab;
+            }
+            //扩大容量为当前容量的两倍，但不能超过MAXIMUM_CAPACITY
+            else if ((newCap = oldCap << 1) < MAXIMUM_CAPACITY &&
+                     oldCap >= DEFAULT_INITIAL_CAPACITY)
+                newThr = oldThr << 1; // double threshold
+        }
+    	//当前数组没有数据，使用初始化的值
+        else if (oldThr > 0) // initial capacity was placed in threshold
+            newCap = oldThr;
+        else {               // zero initial threshold signifies using defaults
+            //如果初始化的值为0，则使用默认的初始化容量
+            newCap = DEFAULT_INITIAL_CAPACITY;
+            newThr = (int)(DEFAULT_LOAD_FACTOR * DEFAULT_INITIAL_CAPACITY);
+        }
+    	//如果新的容量等于0
+        if (newThr == 0) {
+            float ft = (float)newCap * loadFactor;
+            newThr = (newCap < MAXIMUM_CAPACITY && ft < (float)MAXIMUM_CAPACITY ?
+                      (int)ft : Integer.MAX_VALUE);
+        }
+        threshold = newThr;
+        @SuppressWarnings({"rawtypes","unchecked"})
+            Node[] newTab = (Node[])new Node[newCap];
+    	//开始扩容，将新的容量赋值给 table
+        table = newTab;
+    	//原数据不为空，将原数据复制到新 table中
+        if (oldTab != null) {
+            //根据容量循环数组，复制非空元素到新 table
+            for (int j = 0; j < oldCap; ++j) {
+                Node e;
+                if ((e = oldTab[j]) != null) {
+                    oldTab[j] = null;
+                    //如果链表只有一个，则进行直接赋值
+                    if (e.next == null)
+                        newTab[e.hash & (newCap - 1)] = e;
+                    else if (e instanceof TreeNode)
+                        // 红黑树相关操作
+                        ((TreeNode)e).split(this, newTab, j, oldCap);
+                    else { // preserve order
+                        //链表复制，JDK1.8扩容优化部分
+                        Node loHead = null, loTail = null;
+                        Node hiHead = null, hiTail = null;
+                        Node next;
+                        do {
+                            next = e.next;
+                            // 原索引
+                            if ((e.hash & oldCap) == 0) {
+                                if (loTail == null)
+                                    loHead = e;
+                                else
+                                    loTail.next = e;
+                                loTail = e;
+                            }
+                            // 原索引 + oldCap
+                            else {
+                                if (hiTail == null)
+                                    hiHead = e;
+                                else
+                                    hiTail.next = e;
+                                hiTail = e;
+                            }
+                        } while ((e = next) != null);
+                        // 将原索引放到哈希桶中
+                        if (loTail != null) {
+                            loTail.next = null;
+                            newTab[j] = loHead;
+                        }
+                        // 将 原索引+oldCap 放到哈希桶中
+                        if (hiTail != null) {
+                            hiTail.next = null;
+                            newTab[j + oldCap] = hiHead;
+                        }
+                    }
+                }
+            }
+        }
+        return newTab;
+    }
+```
+
+从以上源码可以看出，JDK1.8在扩容时并没有像JDK1.7那样，重新计算每个元素的哈希值，而是通过高位运算(`e.hash&oldCap`)来确定元素是否需要移动，比如key1的信息如下：
+
+* key1.hash = 10 0000 1010
+* oldCap = 16 0001 0000
+
+使用`e.hash&oldCap`得到的结果高一位为0，当结果为0时表示元素在扩容时位置不会发生任何变化，而key 2信息如下：
+
+* key2.hash = 10 0001 0001
+* oldCap = 16 0001 0000
+
+这时候得到的结果高一位为 1，当结果为 1 时，表示元素在扩容时位置发生了变化，新的下标位置等于原下标位置 + 原数组长度，如下图所示：
+
+![](https://raw.githubusercontent.com/krislinzhao/IMGcloud/master/img/20200314160052.png)
+
+其中红色的虚线图代表了扩容时元素移动的位置。
+
+## 2.HashMap死循环分析
+
+以JDK1.7为例，假设`HashMap`默认大小为2，原本`HashMap`中有一个元素key(5)，我们再使用两个线程：t1添加元素key(3)，t2添加元素key(7)，当元素key(3)和key(7)都添加到`HashMap`中之后，线程t1在执行到`Entrynext=e.next`；时，交出了CPU的使用权，源码如下：
+
+```java
+void transfer(Entry[] newTable,boolean rehash){
+    int newCapacity = newTable.length;
+    for(Entry e : table){
+        while(null != e){
+            Entry next = e.next; //线程一执行此处
+            if(rehash){
+                e.hash = null==e.key ? 0 : hash(e.key);
+            }
+            int i = indexFor(e.hash,newCapacity);
+            e.next = newTable[i];
+            newTable[i] = e;
+            e = next;
+        }
+    }
+}
+```
+
+那么此时线程t1中的e指向了key(3)，而next指向了key(7)；之后线程t2重新rehash之后链表的顺序被反转，链表的位置变成了key(5)→key(7)→ key(3)，其中 “→” 用来表示下一个元素。
+
+当 t1 重新获得执行权之后，先执行`newTalbe[i] = e` 把 key(3) 的 next 设置为 key(7)，而下次循环时查询到 key(7) 的 next 元素为 key(3)，于是就形成了 key(3) 和 key(7) 的循环引用，因此就导致了死循环的发生，如下图所示：
+
+![](https://raw.githubusercontent.com/krislinzhao/IMGcloud/master/img/20200314161713.png)
+
+当然发生死循环的原因是JDK1.7链表插入方式为首部倒序插入，这个问题在JDK1.8得到了改善，变成了尾部正序插入。
+
+有人曾经把这个问题反馈给了Sun公司，但Sun公司认为这不是一个问题，因为`HashMap`本身就是非线程安全的，如果要在多线程下，建议使用`ConcurrentHashMap`替代，但这个问题在面试中被问到的几率依然很大，所以在这里需要特别说明一下。
+
+# 小结
+本课时介绍了 HashMap 的底层数据结构，在 JDK 1.7 时 HashMap 是由数组和链表组成的，而 JDK 1.8 则新增了红黑树结构，当链表的长度大于 8 并且容量大于 64 时会转换为红黑树存储，以提升元素的操作性能。同时还介绍了 HashMap 的三个重要方法，查询、添加和扩容，以及 JDK 1.7 resize()  在并发环境下导致死循环的原因。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/03 关键字.md b/Java基础教程/Java面试原理/03 关键字.md
index 866d3ea9..0860f99c 100644
--- a/Java基础教程/Java面试原理/03 关键字.md	
+++ b/Java基础教程/Java面试原理/03 关键字.md	
@@ -216,173 +216,3 @@
 
 
 
-
-### final
-
-**1. 数据**  
-
-声明数据为常量，可以是编译时常量，也可以是在运行时被初始化后不能被改变的常量。
-
-- 对于基本类型，final 使数值不变；
-- 对于引用类型，final 使引用不变，也就不能引用其它对象，但是被引用的对象本身是可以修改的。
-- 如果引用时类的成员变量，则必须当场赋值，否则编译会报错。
-```java
-final int x = 1;
-// x = 2;  // cannot assign value to final variable 'x'
-final A y = new A();
-y.a = 1;
-```
-
-**2. 方法**  
-
-声明方法不能被子类重写。当使用final修饰方法时，这个方法将成为最终方法，无法被子类重写。但是，该方法仍然可以被继承。
-
-private 方法隐式地被指定为 final，如果在子类中定义的方法和基类中的一个 private 方法签名相同，此时子类的方法不是重写基类方法，而是在子类中定义了一个新的方法。
-
-**3. 类**  
-
-声明类不允许被继承。
-
-### static
-
-**1. 静态变量**  
-
-- 静态变量：又称为类变量，也就是说这个变量属于类的，类所有的实例都共享静态变量，可以直接通过类名来访问它。静态变量在内存中只存在一份。
-- 实例变量：每创建一个实例就会产生一个实例变量，它与该实例同生共死。
-
-```java
-public class A {
-
-    private int x;         // 实例变量
-    private static int y;  // 静态变量
-
-    public static void main(String[] args) {
-        // int x = A.x;  // Non-static field 'x' cannot be referenced from a static context
-        A a = new A();
-        int x = a.x;
-        int y = A.y;
-    }
-}
-```
-
-**2. 静态方法**  
-
-静态方法在类加载的时候就存在了，它不依赖于任何实例。所以静态方法必须有实现，也就是说它不能是抽象方法。
-
-```java
-public abstract class A {
-    public static void func1(){
-    }
-    // public abstract static void func2();  // Illegal combination of modifiers: 'abstract' and 'static'
-}
-```
-
-只能访问所属类的静态字段和静态方法，方法中不能有 this 和 super 关键字，因为这两个关键字与具体对象关联。
-
-```java
-public class A {
-
-    private static int x;
-    private int y;
-
-    public static void func1(){
-        int a = x;
-        // int b = y;  // Non-static field 'y' cannot be referenced from a static context
-        // int b = this.y;     // 'A.this' cannot be referenced from a static context
-    }
-}
-```
-
-**3. 静态语句块**  
-
-静态语句块在类初始化时运行一次。
-
-```java
-public class A {
-    static {
-        System.out.println("123");
-    }
-
-    public static void main(String[] args) {
-        A a1 = new A();
-        A a2 = new A();
-    }
-}
-```
-
-```html
-123
-```
-
-**4. 静态内部类**  
-
-非静态内部类依赖于外部类的实例，也就是说需要先创建外部类实例，才能用这个实例去创建非静态内部类。而静态内部类不需要。
-
-```java
-public class OuterClass {
-
-    class InnerClass {
-    }
-
-    static class StaticInnerClass {
-    }
-
-    public static void main(String[] args) {
-        // InnerClass innerClass = new InnerClass(); // 'OuterClass.this' cannot be referenced from a static context
-        OuterClass outerClass = new OuterClass();
-        InnerClass innerClass = outerClass.new InnerClass();
-        StaticInnerClass staticInnerClass = new StaticInnerClass();
-    }
-}
-```
-
-静态内部类不能访问外部类的非静态的变量和方法。
-
-**5. 静态导包**  
-
-在使用静态变量和方法时不用再指明 ClassName，从而简化代码，但可读性大大降低。
-
-```java
-import static com.xxx.ClassName.*
-```
-
-**6. 初始化顺序**  
-
-静态变量和静态语句块优先于实例变量和普通语句块，静态变量和静态语句块的初始化顺序取决于它们在代码中的顺序。
-
-```java
-public static String staticField = "静态变量";
-```
-
-```java
-static {
-    System.out.println("静态语句块");
-}
-```
-
-```java
-public String field = "实例变量";
-```
-
-```java
-{
-    System.out.println("普通语句块");
-}
-```
-
-最后才是构造函数的初始化。
-
-```java
-public InitialOrderTest() {
-    System.out.println("构造函数");
-}
-```
-
-存在继承的情况下，初始化顺序为：
-
-- 父类（静态变量、静态语句块）
-- 子类（静态变量、静态语句块）
-- 父类（实例变量、普通语句块）
-- 父类（构造函数）
-- 子类（实例变量、普通语句块）
-- 子类（构造函数）
diff --git a/Java基础教程/Java面试原理/03.线程的状态有哪些？它是如何工作的？.md b/Java基础教程/Java面试原理/03.线程的状态有哪些？它是如何工作的？.md
new file mode 100644
index 00000000..5d86f6a7
--- /dev/null
+++ b/Java基础教程/Java面试原理/03.线程的状态有哪些？它是如何工作的？.md
@@ -0,0 +1,332 @@
+# 线程的状态有哪些？它是如何工作的？
+
+线程（Thread）是并发编程的基础，也是程序执行的最小单元，它依托进程而存在。一个进程中可以包含多个线程，多线程可以共享一块内存空间和一组系统资源，因此线程之间的切换更加节省资源、更加轻量化，也因此被称为轻量级的进程。
+
+当然，线程也是面试中常被问到的一个知识点，是程序员必备的基础技能，使用它可以有效地提高程序的整体运行速度。
+
+本课时的面试问题是，线程的状态有哪些？它是如何工作的？
+
+## 典型回答
+
+线程的状态在 JDK 1.5 之后以枚举的方式被定义在 Thread 的源码中，它总共包含以下 6 个状态：
+
+* **NEW**，新建状态，线程被创建出来，但尚未启动时的状态；
+* **RUNNABLE**，就绪状态，表示可以运行的线程状态，它可能正在运行，或者是排队等待CPU分配给它资源；
+* **BLOCKED**，阻塞等待锁的线程状态，表示处于阻塞状态的线程正在等待监视器锁，比如等待执行synchronized代码块或者使用synchronized标记的方法；
+* **WAITING**，等待状态，一个处于等待状态的线程正在等待另一个线程执行某个特定的动作，比如，一个线程调用了`Object.wait()`方法，那它就在等待另一个线程调用`Object.notify()`或`Object.notifyAll()`方法；
+* **TIMED_WAITING**，计时等待状态，和等待状态(`WAITING`)类似，它只是多了超时时间，比如调用了有超时时间设置的方法`Object.wait(longtimeout)`和`Thread.join(longtimeout)`等这些方法时，它才会进入此状态；
+* **TERMINATED**，终止状态，表示线程已经执行完成。
+
+线程状态的源代码如下：
+
+```java
+public enum State {
+        /**
+         * 新建状态，线程被创建出来，但尚未启动时的状态
+         */
+        NEW,
+
+        /**
+         * 就绪状态，表示可以运行的线程状态，它可能正在运行，或者是排队等待CPU分配给它资源
+         */
+        RUNNABLE,
+
+        /**
+         * 阻塞等待锁的线程状态，表示处于阻塞状态的线程正在等待监视器锁，
+         * 比如等待执行synchronized代码块或者使用synchronized标记的方法
+         */
+        BLOCKED,
+
+        /**
+         * 等待状态，一个处于等待状态的线程正在等待另一个线程执行某个特定的动作，比如，
+         * 一个线程调用了`Object.wait()`方法，那它就在等待另一个线程调用`Object.notify()`
+         * 或`Object.notifyAll()`方法
+         */
+        WAITING,
+
+        /**
+         * 计时等待状态，和等待状态(`WAITING`)类似，它只是多了超时时间，
+         * 比如调用了有超时时间设置的方法`Object.wait(longtimeout)`和`Thread.join(longtimeout)`
+         * 等这些方法时，它才会进入此状态
+         */
+        TIMED_WAITING,
+
+        /**
+         * 终止状态，表示线程已经执行完成
+         */
+        TERMINATED;
+    }
+```
+
+线程工作模式是，首先先要创建线程并指定线程需要执行的业务方法，然后再调用线程的`start()`方法，此时线程就从**NEW(新建)**状态变成了**RUNNABLE(就绪)**状态，此时线程会判断要执行的方法中有没有**synchronized**同步代码块，如果有并且其他线程也在使用此锁，那么线程就会变为**BLOCKED(阻塞等待)**状态，当其他线程使用完此锁之后，线程会继续执行剩余的方法。
+
+当遇到**Object.wait()**或**Thread.join()**方法时，线程会变为**WAITING(等待状态)**状态，如果是带了超时时间的等待方法，那么线程会进入**TIMED_WAITING(计时等待)**状态，当有其他线程执行了**notify()**或**notifyAll()**方法之后，线程被唤醒继续执行剩余的业务方法，直到方法执行完成为止，此时整个线程的流程就执行完了，执行流程如下图所示：
+
+![](https://raw.githubusercontent.com/krislinzhao/IMGcloud/master/img/20200322103225.png)
+
+## 考点分析
+线程一般会作为并发编程的起始问题，用于引出更多的关于并发编程的面试问题。当然对于线程的掌握程度也决定了你对并发编程的掌握程度，通常面试官还会问：
+
+* BLOCKED（阻塞等待）和 WAITING（等待）有什么区别？
+* start() 方法和 run() 方法有什么区别？
+* 线程的优先级有什么用？该如何设置？
+* 线程的常用方法有哪些？
+
+# 知识扩展
+
+## 1.BLOCKED 和 WAITING 的区别
+
+虽然**BLOCKED**和**WAITING**都有等待的含义，但二者有着本质的区别，首先它们状态形成的调用方法不同，其次**BLOCKED**可以理解为当前线程还处于活跃状态，只是在阻塞等待其他线程使用完某个锁资源；而**WAITING**则是因为自身调用了**Object.wait()**或着是**Thread.join()**又或者是**LockSupport.park()**而进入等待状态，只能等待其他线程执行某个特定的动作才能被继续唤醒，比如当线程因为调用了**Object.wait()**而进入**WAITING**状态之后，则需要等待另一个线程执行**Object.notify()**或**Object.notifyAll()**才能被唤醒。
+
+## 2.start() 和 run() 的区别
+
+首先从 **Thread** 源码来看，**start()** 方法属于 **Thread** 自身的方法，并且使用了 **synchronized** 来保证线程安全，源码如下：
+
+```java
+public synchronized void start() {
+	   // 状态验证，不等于 NEW 的状态会抛出异常
+        if (threadStatus != 0)
+            throw new IllegalThreadStateException();
+
+        // 通知线程组，此线程即将启动
+        group.add(this);
+
+        boolean started = false;
+        try {
+            start0();
+            started = true;
+        } finally {
+            try {
+                if (!started) {
+                    group.threadStartFailed(this);
+                }
+            } catch (Throwable ignore) {
+                // 不处理任何异常，如果 start0 抛出异常，则它将被传递到调用堆栈上
+            }
+        }
+    }
+```
+
+**run()**方法为**Runnable**的抽象方法，必须由调用类重写此方法，重写的**run()**方法其实就是此线程要执行的业务方法，源码如下：
+
+```java
+public class Thread implements Runnable{
+    // 忽略其他方法...
+    private Runnable target;
+    @Override 
+    public void run(){
+        if(target！=nul1){
+            target.run();
+        }
+    }
+    @FunctionalInterface
+    public interface Runnable{
+        public abstract void run();
+    }
+}
+```
+
+从执行的效果来说，**start()**方法可以开启多线程，让线程从**NEW**状态转换成**RUNNABLE**状态，而**run()**方法只是一个普通的方法。
+其次，它们可调用的次数不同，**start()**方法不能被多次调用，否则会抛出**java.lang.llegalStateException**；而**run()**方法可以进行多次调用，因为它只是一个普通的方法而已。
+
+## 3.线程优先级
+
+在 Thread 源码中和线程优先级相关的属性有 3 个：
+
+```java
+//线程可以拥有的最小优先级
+public final static int MIN_PRIORITY =1；
+//线程默认优先级
+public final static int NORM_PRIORITY =5；
+//线程可以拥有的最大优先级
+public final static int MAX_PRIORITY =10
+```
+
+线程的优先级可以理解为线程抢占CPU时间片的概率，优先级越高的线程优先执行的概率就越大，但并不能保证优先级高的线程一定先执行。
+在程序中我们可以通过**Thread.setPriority()**来设置优先级，**setPriority()**源码如下：
+
+```java
+public final void setPriority(int newPriority) {
+        ThreadGroup g;
+        checkAccess();
+    	//先验证优先级的合理性
+        if (newPriority > MAX_PRIORITY || newPriority < MIN_PRIORITY) {
+            throw new IllegalArgumentException();
+        }
+        if((g = getThreadGroup()) != null) {
+            //优先级如果超过线程组的最高优先级，则把优先级设置为线程组的最高优先级
+            if (newPriority > g.getMaxPriority()) {
+                newPriority = g.getMaxPriority();
+            }
+            setPriority0(priority = newPriority);
+        }
+    }
+```
+
+## 4.线程常用的方法
+
+### join()
+
+在一个线程中调用**other.join()**，这时候当前线程会让出执行权给**other**线程，直到**other**线程执行完或者过了超时时间之后再继续执行当前线程，**join()**源码如下：
+
+```java
+public final synchronized void join(long millis)
+    throws InterruptedException {
+        long base = System.currentTimeMillis();
+        long now = 0;
+		//超时时间不能小于0
+        if (millis < 0) {
+            throw new IllegalArgumentException("timeout value is negative");
+        }
+		//等于0表示无限等待，直到线程执行完为止
+        if (millis == 0) {
+            //判断子线程（其他线程）为活跃线程，则一直等待
+            while (isAlive()) {
+                wait(0);
+            }
+        } else {
+            //循环判断
+            while (isAlive()) {
+                long delay = millis - now;
+                if (delay <= 0) {
+                    break;
+                }
+                wait(delay);
+                now = System.currentTimeMillis() - base;
+            }
+        }
+    }
+```
+
+从源码中可以看出 **join()** 方法底层还是通过 **wait()** 方法来实现的。
+
+例如，再未使用**join()**时，代码如下:
+
+```java
+public class ThreadExample {
+    public static void main(String[] args) {
+        Thread thread = new Thread(()->{
+            for (int i=1;i<6;i++){
+                try {
+                    Thread.sleep(1000);
+                }catch (InterruptedException e){
+                    e.printStackTrace();
+                }
+                System.out.println("子线程休眠："+i+"秒");
+            }
+        });
+        //开启线程
+        thread.start();
+        //主线程执行
+        for(int i=1;i<4;i++){
+            try {
+                Thread.sleep(1000);
+            }catch (InterruptedException e){
+                e.printStackTrace();
+            }
+            System.out.println("主线程休眠："+i+"秒");
+        }
+    }
+}
+```
+
+结果如下:
+
+```java
+主线程休眠：1秒
+子线程休眠：1秒
+主线程休眠：2秒
+子线程休眠：2秒
+主线程休眠：3秒
+子线程休眠：3秒
+子线程休眠：4秒
+子线程休眠：5秒
+```
+
+从结果可以看出，在未使用 join() 时主子线程会交替执行。
+
+然后我们再把 join() 方法加入到代码中，代码如下：
+
+```java
+public class ThreadExample {
+    public static void main(String[] args) throws InterruptedException {
+        Thread thread = new Thread(()->{
+            for (int i=1;i<6;i++){
+                try {
+                    Thread.sleep(1000);
+                }catch (InterruptedException e){
+                    e.printStackTrace();
+                }
+                System.out.println("子线程休眠："+i+"秒");
+            }
+        });
+        //开启线程
+        thread.start();
+        //等待子进程两秒钟
+        thread.join(2000);
+        //主线程执行
+        for(int i=1;i<4;i++){
+            try {
+                Thread.sleep(1000);
+            }catch (InterruptedException e){
+                e.printStackTrace();
+            }
+            System.out.println("主线程休眠："+i+"秒");
+        }
+    }
+}
+```
+
+结果如下：
+
+```java
+子线程休眠：1秒
+子线程休眠：2秒
+子线程休眠：3秒
+主线程休眠：1秒
+主线程休眠：2秒
+子线程休眠：4秒
+主线程休眠：3秒
+子线程休眠：5秒
+```
+
+从执行结果可以看出，添加 **join()** 方法之后，主线程会先等子线程执行 2 秒之后才继续执行。
+
+### yield()
+
+看 Thread 的源码可以知道 yield() 为本地方法，也就是说 yield() 是由 C 或 C++ 实现的，源码如下：
+
+```java
+public static native void yield();
+```
+
+**yield()**方法表示给线程调度器一个当前线程愿意出让 CPU 使用权的暗示，但是线程调度器可能会忽略这个暗示。
+
+比如我们执行这段包含了 yield() 方法的代码，如下所示：
+
+```java
+public class YieldExample {
+    public static void main(String[] args) {
+        Runnable runnable = new Runnable() {
+            @Override
+            public void run() {
+                for (int i=0;i<10;i++){
+                    System.out.println("线程："+Thread.currentThread().getName()+" I:"+i);
+                    if (i == 5){
+                        Thread.yield();
+                    }
+                }
+            }
+        };
+        Thread t1 = new Thread(runnable,"T1");
+        Thread t2 = new Thread(runnable,"T2");
+        t1.start();
+        t2.start();
+    }
+}
+```
+
+当我们把这段代码执行多次之后会发现，每次执行的结果都不相同，这是因为**yield()**执行非常不稳定，线程调度器不一定会采纳**yield()**出让CPU使用权的建议，从而导致了这样的结果。
+
+# 小结
+本课时我们介绍了线程的 6 种状态以及线程的执行流程，还介绍了 BLOCKED（阻塞等待）和 WAITING（等待）的区别，start() 方法和 run() 方法的区别，以及 join() 方法和 yield() 方法的作用，但我们不能死记硬背，要多动手实践才能真正的理解这些知识点。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/04.详解 ThreadPoolExecutor 的参数含义及源码执行流程？.md b/Java基础教程/Java面试原理/04.详解 ThreadPoolExecutor 的参数含义及源码执行流程？.md
new file mode 100644
index 00000000..3ef71737
--- /dev/null
+++ b/Java基础教程/Java面试原理/04.详解 ThreadPoolExecutor 的参数含义及源码执行流程？.md	
@@ -0,0 +1,362 @@
+# 详解 `ThreadPoolExecutor` 的参数含义及源码执行流程？
+
+线程池是为了避免线程频繁的创建和销毁带来的性能消耗，而建立的一种池化技术，它是把已创建的线程放入“池”中，当有任务来临时就可以重用已有的线程，无需等待创建的过程，这样就可以有效提高程序的响应速度。但如果要说线程池的话一定离不开**`ThreadPoolExecutor`**，在阿里巴巴的《Java开发手册》中是这样规定线程池的：
+线程池不允许使用**`Executors`**去创建，而是通过**`ThreadPoolExecutor`**的方式，这样的处理方式让写的读者更加明确线程池的运行规则，规避资源耗尽的风险。
+
+说明：Executors 返回的线程池对象的弊端如下：
+
+* 1）**`FixedThreadPool`** 和 **`SingleThreadPool`**：允许的请求队列长度为 **`Integer.MAX_VALUE`**，可能会堆积大量的请求，从而导致 **OOM**(Out Of Memory)
+* 2）**`CachedThreadPool`** 和 **`ScheduledThreadPool`**：允许的创建线程数量为 **`Integer.MAX_VALUE`**，可能会创建大量的线程，从而导致 **OOM**。
+
+其实当我们去看**`Executors`**的源码会发现，**`Executors.newFixedThreadPool()`**、**`Executors.newSingleThreadExecutor()`**和 **`Executors.newCachedThreadPool()`** 等方法的底层都是通过 **`ThreadPoolExecutor`** 实现的。
+
+## 典型回答
+
+**`ThreadPoolExecutor`** 的核心参数指的是它在构建时需要传递的参数，其构造方法如下所示：
+
+```java
+ public ThreadPoolExecutor(int corePoolSize,
+                              int maximumPoolSize,
+                              long keepAliveTime,
+                              TimeUnit unit,
+                              BlockingQueue workQueue,
+                              ThreadFactory threadFactory,
+                              RejectedExecutionHandler handler) {
+        if (corePoolSize < 0 ||
+            //maximumPoolSize必须大于0，且必须大于corePoolSize
+            maximumPoolSize <= 0 ||
+            maximumPoolSize < corePoolSize ||
+            keepAliveTime < 0)
+            throw new IllegalArgumentException();
+        if (workQueue == null || threadFactory == null || handler == null)
+            throw new NullPointerException();
+        this.acc = System.getSecurityManager() == null ?
+                null :
+                AccessController.getContext();
+        this.corePoolSize = corePoolSize;
+        this.maximumPoolSize = maximumPoolSize;
+        this.workQueue = workQueue;
+        this.keepAliveTime = unit.toNanos(keepAliveTime);
+        this.threadFactory = threadFactory;
+        this.handler = handler;
+    }
+```
+
+* 第1个参数：**`corePoolSize`**表示线程池的常驻核心线程数。如果设置为0，则表示在没有任何任务时，销毁线程池；如果大于0，即使没有任务时也会保证线程池的线程数量等于此值。但需要注意，此值如果设置的比较小，则会频繁的创建和销毁线程；如果设置的比较大，则会浪费系统资源，所以开发者需要根据自己的实际业务来调整此值。
+* 第2个参数：**`maximumPoolSize`**表示线程池在任务最多时，最大可以创建的线程数。官方规定此值必须大于0，也必须大于等于**`corePoolSize`**，此值只有在任务比较多，且不能存放在任务队列时，才会用到。
+* 第3个参数：**`keepAliveTime`**表示线程的存活时间，当线程池空闲时并且超过了此时间，多余的线程就会销毁，直到线程池中的线程数量销毁的等于**`corePoolSize`**为止，如果**`maximumPoolSize`**等于**`corePoolSize`**，那么线程池在空闲的时候也不会销毁任何线程。
+* 第4个参数：**unit** 表示存活时间的单位，它是配合**`keepAliveTime`**参数共同使用的。
+* 第5个参数：**`workQueue`**表示线程池执行的任务队列，当线程池的所有线程都在处理任务时，如果来了新任务就会缓存到此任务队列中排队等待执行。
+* 第6个参数：**`threadFactory`**表示线程的创建工厂，此参数一般用的比较少，我们通常在创建线程池时不指定此参数，它会使用默认的线程创建工厂的方法来创建线程，源代码如下：
+
+```java
+  public ThreadPoolExecutor(int corePoolSize,
+                              int maximumPoolSize,
+                              long keepAliveTime,
+                              TimeUnit unit,
+                              BlockingQueue workQueue,
+                              ThreadFactory threadFactory) {
+        this(corePoolSize, maximumPoolSize, keepAliveTime, unit, workQueue,
+             threadFactory, defaultHandler);
+    }
+
+public static ThreadFactory defaultThreadFactory() {
+        return new DefaultThreadFactory();
+    }
+
+// 默认的线程创建工厂，需要实现 ThreadFactory 接口
+static class DefaultThreadFactory implements ThreadFactory {
+        private static final AtomicInteger poolNumber = new AtomicInteger(1);
+        private final ThreadGroup group;
+        private final AtomicInteger threadNumber = new AtomicInteger(1);
+        private final String namePrefix;
+
+        DefaultThreadFactory() {
+            SecurityManager s = System.getSecurityManager();
+            group = (s != null) ? s.getThreadGroup() :
+                                  Thread.currentThread().getThreadGroup();
+            namePrefix = "pool-" +
+                          poolNumber.getAndIncrement() +
+                         "-thread-";
+        }
+
+    	// 创建线程
+        public Thread newThread(Runnable r) {
+            Thread t = new Thread(group, r,
+                                  namePrefix + threadNumber.getAndIncrement(),
+                                  0);
+            if (t.isDaemon())
+                //创建一个非守护线程
+                t.setDaemon(false);
+            if (t.getPriority() != Thread.NORM_PRIORITY)
+                //线程优先级设置为默认值
+                t.setPriority(Thread.NORM_PRIORITY);
+            return t;
+        }
+    }
+```
+
+我们也可以自定义一个线程工厂，通过实现**`ThreadFactory`**接口来完成，这样就可以自定义线程的名称或线程执行的优先级了。
+
+* 第7个参数：**`RejectedExecutionHandler`** 表示指定线程池的拒绝策略，当线程池的任务已经在缓存队列**`workQueue`**中存储满了之后，并且不能创建新的线程来执行此任务时，就会用到此拒绝策略，它属于一种限流保护的机制。
+  线程池的工作流程要从它的执行方法**execute()**说起，源码如下：
+
+  ```java
+  public void execute(Runnable command) {
+          if (command == null)
+              throw new NullPointerException();
+          /*
+            *分3步进行：
+            *
+            * 1.如果少于正在运行的corePoolSize线程，请尝试
+            *以给定的命令作为第一个线程启动一个新线程
+            *任务。 对addWorker的调用自动检查runState和
+            * workerCount，因此可以防止假警报的增加
+            *通过返回false返回不应该执行的线程。
+            *
+            * 2.如果任务可以成功排队，那么我们仍然需要
+            *仔细检查我们是否应该添加线程
+            *（因为现有的自上次检查后死亡）或
+            *自从进入此方法以来，该池已关闭。 所以我们
+            *重新检查状态，并在必要时回退排队
+            *停止，如果没有，则启动一个新线程。
+            *
+            * 3.如果我们无法将任务排队，那么我们尝试添加一个新的
+            *线程。 如果失败，我们知道我们已经关闭或饱和
+            *并因此拒绝任务。
+            */
+          int c = ctl.get();
+      	// 当前工作的线程小于核心线程数
+          if (workerCountOf(c) < corePoolSize) {
+              //创建新的线程执行次任务
+              if (addWorker(command, true))
+                  return;
+              c = ctl.get();
+          }
+      	// 检查线程池是否处于可运行状态，如果是则把任务添加到队列
+          if (isRunning(c) && workQueue.offer(command)) {
+              int recheck = ctl.get();
+              //再次检查线程池是否处于可运行状态，防止第一次校验通过后线程池关闭
+              //如果是非运行状态，则把刚加入队列的任务移除
+              if (! isRunning(recheck) && remove(command))
+                  reject(command);
+              //如果线程池的线程数为0时(当corePoolSize设置为0时会发生)
+              else if (workerCountOf(recheck) == 0)
+                  //新建线程执行任务
+                  addWorker(null, false);
+          }
+      	//核心线程都在忙且队列都已爆满，尝试新启动一个线程执行失败
+          else if (!addWorker(command, false))
+              //执行拒绝策略
+              reject(command);
+      }
+  ```
+
+  其中**`addWorker(Runnable firstTask,boolean core)`**方法参数说明:
+
+  * **`firstTask`**:线程首先执行的任务，如果没有则设置为null
+  * **core**:判断是否可以创建线程的阈值(最大值)，如果等于true则表示使用**`corePoolSize`**作为阈值，false则表示使用**`maximumPoolSize`**作为阈值
+
+
+## 考点分析
+
+本课时的这道面试题考察的是你对于线程池和 ThreadPoolExecutor 的掌握程度，也属于 Java 的基础知识，几乎所有的面试都会被问到，其中线程池任务执行的主要流程，可以参考以下流程图：
+
+  ![](https://raw.githubusercontent.com/krislinzhao/IMGcloud/master/img/20200323094637.png)
+
+与 ThreadPoolExecutor 相关的面试题还有以下几个：
+
+* ThreadPoolExecutor 的执行方法有几种？它们有什么区别？
+* 什么是线程的拒绝策略？
+* 拒绝策略的分类有哪些？
+* 如何自定义拒绝策略？
+* ThreadPoolExecutor 能不能实现扩展？如何实现扩展？
+
+  # 知识扩展
+
+  ## execute()和submit()
+
+  execute()和submit()都是用来执行线程任务的，他们最主要的区别是，submit()能接受线程池执行的返回值，execute()不能接受返回值。
+
+  两个方法的具体使用:
+
+  ```java
+  public static void main(String[] args) throws ExecutionException, InterruptedException {
+          ThreadPoolExecutor execute = new ThreadPoolExecutor(2,10,10L, TimeUnit.SECONDS,new LinkedBlockingQueue<>(20));
+          //execute使用
+          execute.execute(new Runnable() {
+              @Override
+              public void run() {
+                  System.out.println("Hello,execute");
+              }
+          });
+          //submit使用
+          Future future = execute.submit(new Callable() {
+              @Override
+              public String call() throws Exception {
+                  System.out.println("Hello,submit");
+                  return "Success";
+              }
+          });
+          System.out.println(future.get());
+      }
+  ```
+
+  程序执行结果:
+
+  ```java
+  Hello,execute
+  Hello,submit
+  Success
+  ```
+
+  从以上结果可以看出submit()方法可以配合Futrue来接收线程执行的返回值。它们的另一个区别是execute()方法属于Executor接口的方法，而 submit() 方法则是属于 ExecutorService 接口的方法，它们的继承关系如下图所示：
+
+  ![](https://raw.githubusercontent.com/krislinzhao/IMGcloud/master/img/20200323103705.png)
+
+  ## 线程池拒绝策略
+
+当线程池中的任务队列已经被存满，再有任务添加时会先判断当前线程池中的线程数是否大于等于线程池的最大值，如果是，则会触发线程池的拒绝策略。
+
+Java自带的拒绝策略有四种：
+
+* `AbortPolicy`，终止策略，线程池会抛出异常并终止执行，它是默认的拒绝策略；
+* `CallerRunsPolicy`，把任务交给当前线程来执行
+* `DiscardPolicy`，忽略此任务(最新的任务)
+* `DiscardOldestPolicy`，忽略最早的任务(最先加入队列的任务)
+
+`AbortPolicy`拒绝策略示例:
+
+```java
+ThreadPoolExecutor executor = new ThreadPoolExecutor(1,3,10,TimeUnit.SECONDS,new LinkedBlockingQueue<>(2),new ThreadPoolExecutor.AbortPolicy());
+        for (int i=0;i<6;i++){
+            executor.execute(()->{
+                System.out.println(Thread.currentThread().getName());
+            });
+        }
+```
+
+程序运行结果:
+
+```java
+pool-1-thread-1
+pool-1-thread-2
+pool-1-thread-2
+pool-1-thread-2
+pool-1-thread-3
+Exception in thread "main" java.util.concurrent.RejectedExecutionException: Task example.ThreadPoolExecutorExample$$Lambda$1/1149319664@4dd8dc3 rejected from java.util.concurrent.ThreadPoolExecutor@6d03e736[Running, pool size = 3, active threads = 3, queued tasks = 2, completed tasks = 0]
+	at java.util.concurrent.ThreadPoolExecutor$AbortPolicy.rejectedExecution(ThreadPoolExecutor.java:2063)
+	at java.util.concurrent.ThreadPoolExecutor.reject(ThreadPoolExecutor.java:830)
+	at java.util.concurrent.ThreadPoolExecutor.execute(ThreadPoolExecutor.java:1379)
+	at example.ThreadPoolExecutorExample.main(ThreadPoolExecutorExample.java:34)
+```
+
+可以看出当第6个任务来的时候，线程池则执行了`AbortPolicy` 拒绝策略，抛出了异常。因为队列最多存储2个任务，最大可以创建3个线程来执行任务（2+3=5），所以当第6个任务来的时候，此线程池就“忙”不过来了。
+
+## 自定义拒绝策略
+
+自定义拒绝策略只需要新建一个`RejectedExecutionHandler`对象，然后重写它的`rejectedExecution()`方法即可，如下代码所示：
+
+```java
+ThreadPoolExecutor executor = new ThreadPoolExecutor(1, 3, 10, TimeUnit.SECONDS, new LinkedBlockingQueue<>(2),
+                //添加自定义拒绝策略
+                new RejectedExecutionHandler() {
+            @Override
+            public void rejectedExecution(Runnable r, ThreadPoolExecutor executor) {
+                //业务执行方法
+                System.out.println("执行自定义拒绝策略");
+            }
+        });
+        for (int i=0;i<6;i++){
+            executor.execute(()->{
+                System.out.println(Thread.currentThread().getName());
+            });
+        }
+```
+
+程序执行结果:
+
+```java
+执行自定义拒绝策略
+pool-1-thread-1
+pool-1-thread-1
+pool-1-thread-1
+pool-1-thread-2
+pool-1-thread-3
+```
+
+可以看出线程池执行了自定义的拒绝策略，我们可以在`rejectedExecution`中添加自己业务处理的代码。
+
+## `ThreadPoolExecutor`扩展
+
+`ThreadPoolExecutor`的扩展主要是通过重写它的`beforeExecute()`和`afterExecute()`方法实现的，我们可以在扩展方法中添加日志或者实现数据统计，比如统计线程的执行时间，如下代码所示：
+
+```java
+public class ThreadPoolExtend {
+    public static void main(String[] args) {
+        //线程池扩展调用
+        MyThreadPoolExtend executor = new MyThreadPoolExtend(2,4,10, TimeUnit.SECONDS,new LinkedBlockingQueue<>());
+        for (int i=0;i<3;i++){
+            executor.execute(()->{
+                System.out.println(Thread.currentThread().getName());
+            });
+        }
+    }
+
+    /**
+     * 线程池扩展
+     */
+    static class MyThreadPoolExtend extends ThreadPoolExecutor{
+        //保存线程开始执行的时间
+        private final ThreadLocal localTime = new ThreadLocal<>();
+        public MyThreadPoolExtend(int corePoolSize, int maximumPoolSize, long keepAliveTime, TimeUnit unit, BlockingQueue workQueue) {
+            super(corePoolSize, maximumPoolSize, keepAliveTime, unit, workQueue);
+        }
+
+        /**
+         * 开始执行之前
+         * @param t 线程
+         * @param r 任务
+         */
+        @Override
+        protected void beforeExecute(Thread t, Runnable r) {
+            //开始时间（单位：纳秒）
+            Long sTime = System.nanoTime();
+            localTime.set(sTime);
+            System.out.println(String.format("%s|before|time=%s",t.getName(),sTime));
+            super.beforeExecute(t, r);
+        }
+
+        /**
+         * 执行 完成之后
+         * @param r 任务
+         * @param t 抛出的遗产
+         */
+        @Override
+        protected void afterExecute(Runnable r, Throwable t) {
+            //结束时间（单位：纳秒）
+            long eTime = System.nanoTime();
+            long totalTime = eTime - localTime.get();
+            System.out.println(String.format("%s|after|time=%s|耗时:%s毫秒",Thread.currentThread().getName(),eTime,totalTime/1000000.0));
+            super.afterExecute(r, t);
+        }
+    }
+}
+```
+
+程序执行结果:
+
+```java
+pool-1-thread-1|before|time=95659085427600
+pool-1-thread-1
+pool-1-thread-2|before|time=95659085423300
+pool-1-thread-2
+pool-1-thread-2|after|time=95659113130200|耗时:27.7069毫秒
+pool-1-thread-1|after|time=95659112193700|耗时:26.7661毫秒
+pool-1-thread-2|before|time=95659117635200
+pool-1-thread-2
+pool-1-thread-2|after|time=95659117822000|耗时:0.1868毫秒
+```
+
+# 小结
+最后我们总结一下：线程池的使用必须要通过 ThreadPoolExecutor 的方式来创建，这样才可以更加明确线程池的运行规则，规避资源耗尽的风险。同时，也介绍了 ThreadPoolExecutor 的七大核心参数，包括核心线程数和最大线程数之间的区别，当线程池的任务队列没有可用空间且线程池的线程数量已经达到了最大线程数时，则会执行拒绝策略，Java 自动的拒绝策略有 4 种，用户也可以通过重写 rejectedExecution() 来自定义拒绝策略，我们还可以通过重写 beforeExecute() 和 afterExecute() 来实现 ThreadPoolExecutor 的扩展功能。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/05.synchronized和ReentrantLock.md b/Java基础教程/Java面试原理/05.synchronized和ReentrantLock.md
new file mode 100644
index 00000000..2c9daac2
--- /dev/null
+++ b/Java基础教程/Java面试原理/05.synchronized和ReentrantLock.md
@@ -0,0 +1,258 @@
+# synchronized 和 ReentrantLock 的实现原理是什么？它们有什么区别？
+
+在 JDK 1.5 之前共享对象的协调机制只有 synchronized 和 volatile，在 JDK 1.5 中增加了新的机制 ReentrantLock，该机制的诞生并不是为了替代 synchronized，而是在 synchronized 不适用的情况下，提供一种可以选择的高级功能。
+
+## 典型回答
+
+synchronized 属于独占式悲观锁，是通过 JVM 隐式实现的，synchronized 只允许同一时刻只有一个线程操作资源。
+
+在 Java 中每个对象都隐式包含一个 monitor（监视器）对象，加锁的过程其实就是竞争 monitor 的过程，当线程进入字节码 monitorenter 指令之后，线程将持有 monitor 对象，执行 monitorexit 时释放 monitor 对象，当其他线程没有拿到 monitor 对象时，则需要阻塞等待获取该对象。  
+
+ReentrantLock 是 Lock 的默认实现方式之一，它是基于 AQS（Abstract Queued Synchronizer，队列同步器）实现的，它默认是通过非公平锁实现的，在它的内部有一个 state 的状态字段用于表示锁是否被占用，如果是 0 则表示锁未被占用，此时线程就可以把 state 改为 1，并成功获得锁，而其他未获得锁的线程只能去排队等待获取锁资源。
+
+synchronized 和 ReentrantLock 都提供了锁的功能，具备互斥性和不可见性。在 JDK 1.5 中 synchronized 的性能远远低于  ReentrantLock，但在 JDK 1.6 之后  synchronized 的性能略低于ReentrantLock，它的区别如下：
+
+* synchronized 是 JVM 隐式实现的，而 ReentrantLock 是 Java 语言提供的 API；
+
+* ReentrantLock 可设置为公平锁，而 synchronized 却不行；
+
+* ReentrantLock 只能修饰代码块，而 synchronized 可以用于修饰方法、修饰代码块等；
+
+* ReentrantLock 需要手动加锁和释放锁，如果忘记释放锁，则会造成资源被永久占用，而 synchronized 无需手动释放锁；
+
+* ReentrantLock 可以知道是否成功获得了锁，而 synchronized  却不行。
+
+## 考点分析
+synchronized 和 ReentrantLock 是比线程池还要高频的面试问题，因为它包含了更多的知识点，且涉及到的知识点更加深入，对面试者的要求也更高，前面我们简要地介绍了 synchronized 和 ReentrantLock 的概念及执行原理，但很多大厂会更加深入的追问更多关于它们的实现细节，比如：
+
+* ReentrantLock 的具体实现细节是什么？
+* JDK 1.6 时锁做了哪些优化？
+
+# 知识扩展
+
+## ReentrantLock 源码分析
+
+ReentrantLock 的两个构造函数:
+
+```java
+public ReentrantLock() {
+    sync = new NonfairSync(); // 非公平锁
+}
+public ReentrantLock(boolean fair) {
+    sync = fair ? new FairSync() : new NonfairSync();
+}
+```
+
+无参的构造函数创建了一个非公平锁，用户也可以根据第二个构造函数，设置一个 boolean 类型的值，来决定是否使用公平锁来实现线程的调度。
+
+## 公平锁 VS 非公平锁
+
+公平锁的含义是线程需要按照请求的顺序来获得锁；而非公平锁则允许“插队”的情况存在，所谓的“插队”指的是，线程在发送请求的同时该锁的状态恰好变成了可用，那么此线程就可以跳过队列中所有排队的线程直接拥有该锁。
+
+而公平锁由于有挂起和恢复所以存在一定的开销，因此性能不如非公平锁，所以 ReentrantLock 和 synchronized 默认都是非公平锁的实现方式。
+
+ReentrantLock 是通过 lock() 来获取锁，并通过 unlock() 释放锁，使用代码如下：
+
+```java
+Lock lock = new ReentrantLock();
+try {
+    // 加锁
+    lock.lock();
+    //......业务处理
+} finally {
+    // 释放锁
+    lock.unlock();
+}
+```
+
+ReentrantLock 中的 lock() 是通过 sync.lock() 实现的，但 Sync 类中的 lock() 是一个抽象方法，需要子类 NonfairSync 或 FairSync 去实现，NonfairSync 中的 lock() 源码如下：
+
+```java
+final void lock() {
+    if (compareAndSetState(0, 1))
+        // 将当前线程设置为此锁的持有者
+        setExclusiveOwnerThread(Thread.currentThread());
+    else
+        acquire(1);
+}
+```
+
+FairSync 中的 lock() 源码如下：
+
+```java
+final void lock() {
+    acquire(1);
+}
+```
+
+可以看出非公平锁比公平锁只是多了一行 compareAndSetState 方法，该方法是尝试将 state 值由 0 置换为 1，如果设置成功的话，则说明当前没有其他线程持有该锁，不用再去排队了，可直接占用该锁，否则，则需要通过 acquire 方法去排队。
+
+acquire 源码如下：
+
+```java
+public final void acquire(int arg) {
+    if (!tryAcquire(arg) && 
+        acquireQueued(addWaiter(Node.EXCLUSIVE), arg))
+        selfInterrupt();
+}
+```
+
+tryAcquire 方法尝试获取锁，如果获取锁失败，则把它加入到阻塞队列中，来看 tryAcquire 的源码：
+
+```java
+protected final boolean tryAcquire(int acquires) {
+    final Thread current = Thread.currentThread();
+    int c = getState();
+    if (c == 0) {
+        // 公平锁比非公平锁多了一行代码 !hasQueuedPredecessors() 
+        if (!hasQueuedPredecessors() &&
+            compareAndSetState(0, acquires)) { //尝试获取锁
+            setExclusiveOwnerThread(current); // 获取成功，标记被抢占
+            return true;
+        }
+    }
+    else if (current == getExclusiveOwnerThread()) {
+        int nextc = c + acquires;
+        if (nextc < 0)
+            throw new Error("Maximum lock count exceeded");
+        setState(nextc); // set state=state+1
+        return true;
+    }
+    return false;
+}
+```
+
+对于此方法来说，公平锁比非公平锁只多一行代码 !hasQueuedPredecessors()，它用来查看队列中是否有比它等待时间更久的线程，如果没有，就尝试一下是否能获取到锁，如果获取成功，则标记为已经被占用。
+
+如果获取锁失败，则调用 addWaiter 方法把线程包装成 Node 对象，同时放入到队列中，但 addWaiter 方法并不会尝试获取锁，acquireQueued 方法才会尝试获取锁，如果获取失败，则此节点会被挂起，源码如下：
+
+```java
+/**
+ * 队列中的线程尝试获取锁，失败则会被挂起
+ */
+final boolean acquireQueued(final Node node, int arg) {
+    boolean failed = true; // 获取锁是否成功的状态标识
+    try {
+        boolean interrupted = false; // 线程是否被中断
+        for (;;) {
+            // 获取前一个节点（前驱节点）
+            final Node p = node.predecessor();
+            // 当前节点为头节点的下一个节点时，有权尝试获取锁
+            if (p == head && tryAcquire(arg)) {
+                setHead(node); // 获取成功，将当前节点设置为 head 节点
+                p.next = null; // 原 head 节点出队，等待被 GC
+                failed = false; // 获取成功
+                return interrupted;
+            }
+             // 判断获取锁失败后是否可以挂起
+            if (shouldParkAfterFailedAcquire(p, node) &&
+                parkAndCheckInterrupt())
+                // 线程若被中断，返回 true
+                interrupted = true;
+        }
+    } finally {
+        if (failed)
+            cancelAcquire(node);
+    }
+}
+```
+
+该方法会使用 for(;;) 无限循环的方式来尝试获取锁，若获取失败，则调用 shouldParkAfterFailedAcquire 方法，尝试挂起当前线程，源码如下：
+
+```java
+/**
+ * 判断线程是否可以被挂起
+ */
+private static boolean shouldParkAfterFailedAcquire(Node pred, Node node) {
+    // 获得前驱节点的状态
+    int ws = pred.waitStatus;
+    // 前驱节点的状态为 SIGNAL，当前线程可以被挂起（阻塞）
+    if (ws == Node.SIGNAL)
+        return true;
+    if (ws > 0) { 
+        do {
+        // 若前驱节点状态为 CANCELLED，那就一直往前找，直到找到一个正常等待的状态为止
+            node.prev = pred = pred.prev;
+        } while (pred.waitStatus > 0);
+        // 并将当前节点排在它后边
+        pred.next = node;
+    } else {
+        // 把前驱节点的状态修改为 SIGNAL
+        compareAndSetWaitStatus(pred, ws, Node.SIGNAL);
+    }
+    return false;
+}
+```
+
+线程入列被挂起的前提条件是，前驱节点的状态为 SIGNAL，SIGNAL 状态的含义是后继节点处于等待状态，当前节点释放锁后将会唤醒后继节点。所以在上面这段代码中，会先判断前驱节点的状态，如果为 SIGNAL，则当前线程可以被挂起并返回 true；如果前驱节点的状态 >0，则表示前驱节点取消了，这时候需要一直往前找，直到找到最近一个正常等待的前驱节点，然后把它作为自己的前驱节点；如果前驱节点正常（未取消），则修改前驱节点状态为 SIGNAL。
+
+到这里整个加锁的流程就已经走完了，最后的情况是，没有拿到锁的线程会在队列中被挂起，直到拥有锁的线程释放锁之后，才会去唤醒其他的线程去获取锁资源，整个运行流程如下图所示：
+
+![](https://cdn.jsdelivr.net/gh/krislinzhao/IMGcloud/img/20200425133636.png)
+
+unlock 相比于 lock 来说就简单很多了，源码如下：
+
+```java
+public void unlock() {
+    sync.release(1);
+}
+public final boolean release(int arg) {
+    // 尝试释放锁
+    if (tryRelease(arg)) {
+        // 释放成功
+        Node h = head;
+        if (h != null && h.waitStatus != 0)
+            unparkSuccessor(h);
+        return true;
+    }
+    return false;
+}
+```
+
+锁的释放流程为，先调用 tryRelease 方法尝试释放锁，如果释放成功，则查看头结点的状态是否为 SIGNAL，如果是，则唤醒头结点的下个节点关联的线程；如果释放锁失败，则返回 false。
+
+tryRelease 源码如下：
+
+```java
+/**
+ * 尝试释放当前线程占有的锁
+ */
+protected final boolean tryRelease(int releases) {
+    int c = getState() - releases; // 释放锁后的状态，0 表示释放锁成功
+    // 如果拥有锁的线程不是当前线程的话抛出异常
+    if (Thread.currentThread() != getExclusiveOwnerThread())
+        throw new IllegalMonitorStateException();
+    boolean free = false;
+    if (c == 0) { // 锁被成功释放
+        free = true;
+        setExclusiveOwnerThread(null); // 清空独占线程
+    }
+    setState(c); // 更新 state 值，0 表示为释放锁成功
+    return free;
+}
+```
+
+在 tryRelease 方法中，会先判断当前的线程是不是占用锁的线程，如果不是的话，则会抛出异常；如果是的话，则先计算锁的状态值 getState() - releases 是否为 0，如果为 0，则表示可以正常的释放锁，然后清空独占的线程，最后会更新锁的状态并返回执行结果。
+
+# JDK 1.6 锁优化
+
+## 自适应自旋锁
+
+JDK 1.5 在升级为 JDK 1.6 时，HotSpot 虚拟机团队在锁的优化上下了很大功夫，比如实现了自适应式自旋锁、锁升级等。
+
+JDK 1.6 引入了自适应式自旋锁意味着自旋的时间不再是固定的时间了，比如在同一个锁对象上，如果通过自旋等待成功获取了锁，那么虚拟机就会认为，它下一次很有可能也会成功 (通过自旋获取到锁)，因此允许自旋等待的时间会相对的比较长，而当某个锁通过自旋很少成功获得过锁，那么以后在获取该锁时，可能会直接忽略掉自旋的过程，以避免浪费 CPU 的资源，这就是自适应自旋锁的功能。
+
+## 锁升级
+
+锁升级其实就是从偏向锁到轻量级锁再到重量级锁升级的过程，这是 JDK 1.6 提供的优化功能，也称之为锁膨胀。
+
+**偏向锁**是指在无竞争的情况下设置的一种锁状态。偏向锁的意思是它会偏向于第一个获取它的线程，当锁对象第一次被获取到之后，会在此对象头中设置标示为“01”，表示偏向锁的模式，并且在对象头中记录此线程的 ID，这种情况下，如果是持有偏向锁的线程每次在进入的话，不再进行任何同步操作，如 Locking、Unlocking 等，直到另一个线程尝试获取此锁的时候，偏向锁模式才会结束，偏向锁可以提高带有同步但无竞争的程序性能。但如果在多数锁总会被不同的线程访问时，偏向锁模式就比较多余了，此时可以通过 -XX:-UseBiasedLocking 来禁用偏向锁以提高性能。
+
+**轻量锁**是相对于重量锁而言的，在 JDK 1.6 之前，synchronized 是通过操作系统的互斥量（mutex lock）来实现的，这种实现方式需要在用户态和核心态之间做转换，有很大的性能消耗，这种传统实现锁的方式被称之为重量锁。
+
+而轻量锁是通过比较并交换（CAS，Compare and Swap）来实现的，它对比的是线程和对象的 Mark Word（对象头中的一个区域），如果更新成功则表示当前线程成功拥有此锁；如果失败，虚拟机会先检查对象的 Mark Word 是否指向当前线程的栈帧，如果是，则说明当前线程已经拥有此锁，否则，则说明此锁已经被其他线程占用了。当两个以上的线程争抢此锁时，轻量级锁就膨胀为重量级锁，这就是锁升级的过程，也是 JDK 1.6 锁优化的内容。
+
+# 小结
+本课时首先讲了 synchronized 和 ReentrantLock 的实现过程，然后讲了 synchronized 和 ReentrantLock 的区别，最后通过源码的方式讲了 ReentrantLock 加锁和解锁的执行流程。接着又讲了 JDK 1.6 中的锁优化，包括自适应式自旋锁的实现过程，以及 synchronized 的三种锁状态和锁升级的执行流程。
+
+synchronized 刚开始为偏向锁，随着锁竞争越来越激烈，会升级为轻量级锁和重量级锁。如果大多数锁被不同的线程所争抢就不建议使用偏向锁了。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/06.谈谈你对锁的理解？如何手动模拟一个死锁？.md b/Java基础教程/Java面试原理/06.谈谈你对锁的理解？如何手动模拟一个死锁？.md
new file mode 100644
index 00000000..33263bdd
--- /dev/null
+++ b/Java基础教程/Java面试原理/06.谈谈你对锁的理解？如何手动模拟一个死锁？.md
@@ -0,0 +1,235 @@
+# 谈谈你对锁的理解？如何手动模拟一个死锁？
+
+在并发编程中有两个重要的概念：线程和锁，多线程是一把双刃剑，它在提高程序性能的同时，也带来了编码的复杂性，对开发者的要求也提高了一个档次。而锁的出现就是为了保障多线程在同时操作一组资源时的数据一致性，当我们给资源加上锁之后，只有拥有此锁的线程才能操作此资源，而其他线程只能排队等待使用此锁。当然，在所有的面试中也都少不了关于“锁”方面的相关问题。
+
+## 典型回答
+
+死锁是指两个线程同时占用两个资源，又在彼此等待对方释放锁资源，如下图所示：
+
+![](https://cdn.jsdelivr.net/gh/krislinzhao/IMGcloud/img/20200425140218.png)
+
+死锁的代码演示如下：
+
+```java
+import java.util.concurrent.TimeUnit;
+
+public class LockExample {
+    public static void main(String[] args) {
+        deadLock(); // 死锁
+    }
+/**
+ * 死锁
+ */
+private static void deadLock() {
+    Object lock1 = new Object();
+    Object lock2 = new Object();
+    // 线程一拥有 lock1 试图获取 lock2
+    new Thread(() -> {
+        synchronized (lock1) {
+            System.out.println("获取 lock1 成功");
+            try {
+                TimeUnit.SECONDS.sleep(3);
+            } catch (InterruptedException e) {
+                e.printStackTrace();
+            }
+            // 试图获取锁 lock2
+            synchronized (lock2) {
+                System.out.println(Thread.currentThread().getName());
+            }
+        }
+    }).start();
+    // 线程二拥有 lock2 试图获取 lock1
+    new Thread(() -> {
+        synchronized (lock2) {
+            System.out.println("获取 lock2 成功");
+            try {
+                TimeUnit.SECONDS.sleep(3);
+            } catch (InterruptedException e) {
+                e.printStackTrace();
+            }
+            // 试图获取锁 lock1
+            synchronized (lock1) {
+                System.out.println(Thread.currentThread().getName());
+            }
+        }
+    }).start();
+}
+```
+
+以上程序执行结果如下：
+
+```
+获取 lock1 成功
+获取 lock2 成功
+```
+
+
+可以看出当我们使用线程一拥有锁 lock1 的同时试图获取 lock2，而线程二在拥有 lock2 的同时试图获取 lock1，这样就会造成彼此都在等待对方释放资源，于是就形成了死锁。
+
+锁是指在并发编程中，当有多个线程同时操作一个资源时，为了保证数据操作的正确性，我们需要让多线程排队一个一个的操作此资源，而这个过程就是给资源加锁和释放锁的过程，就好像去公共厕所一样，必须一个一个排队使用，并且在使用时需要锁门和开门一样。
+
+## 考点分析
+锁的概念不止出现在 Java 语言中，比如乐观锁和悲观锁其实很早就存在于数据库中了。锁的概念其实不难理解，但要真正的了解锁的原理和实现过程，才能打动面试官。
+
+和锁相关的面试问题，还有以下几个：
+
+* 什么是乐观锁和悲观锁？它们的应用都有哪些？乐观锁有什么问题？
+* 什么是可重入锁？用代码如何实现？它的实现原理是什么？
+* 什么是共享锁和独占锁？
+
+# 知识扩展
+
+## 1.悲观锁和乐观锁
+
+悲观锁指的是数据对外界的修改采取保守策略，它认为线程很容易会把数据修改掉，因此在整个数据被修改的过程中都会采取锁定状态，直到一个线程使用完，其他线程才可以继续使用。
+
+我们来看一下悲观锁的实现流程，以 synchronized 为例，代码如下：
+
+```java
+public class LockExample {
+    public static void main(String[] args) {
+        synchronized (LockExample.class) {
+            System.out.println("lock");
+        }
+    }
+}
+```
+
+我们使用反编译工具查到的结果如下：
+
+```classes
+Compiled from "LockExample.java"
+public class com.lagou.interview.ext.LockExample {
+  public com.lagou.interview.ext.LockExample();
+    Code:
+       0: aload_0
+       1: invokespecial #1                  // Method java/lang/Object."":()V
+       4: return
+
+  public static void main(java.lang.String[]);
+    Code:
+       0: ldc           #2                  // class com/lagou/interview/ext/LockExample
+       2: dup
+       3: astore_1
+       4: monitorenter // 加锁
+       5: getstatic     #3                  // Field java/lang/System.out:Ljava/io/PrintStream;
+       8: ldc           #4                  // String lock
+      10: invokevirtual #5                  // Method java/io/PrintStream.println:(Ljava/lang/String;)V
+      13: aload_1
+      14: monitorexit // 释放锁
+      15: goto          23
+      18: astore_2
+      19: aload_1
+      20: monitorexit
+      21: aload_2
+      22: athrow
+      23: return
+    Exception table:
+       from    to  target type
+           5    15    18   any
+          18    21    18   any
+}
+```
+
+
+可以看出被 synchronized 修饰的代码块，在执行之前先使用 monitorenter 指令加锁，然后在执行结束之后再使用 monitorexit 指令释放锁资源，在整个执行期间此代码都是锁定的状态，这就是典型悲观锁的实现流程。
+
+乐观锁和悲观锁的概念恰好相反，乐观锁认为一般情况下数据在修改时不会出现冲突，所以在数据访问之前不会加锁，只是在数据提交更改时，才会对数据进行检测。
+
+Java 中的乐观锁大部分都是通过 CAS（Compare And Swap，比较并交换）操作实现的，CAS 是一个多线程同步的原子指令，CAS 操作包含三个重要的信息，即内存位置、预期原值和新值。如果内存位置的值和预期的原值相等的话，那么就可以把该位置的值更新为新值，否则不做任何修改。
+
+CAS 可能会造成 ABA 的问题，ABA 问题指的是，线程拿到了最初的预期原值 A，然而在将要进行 CAS 的时候，被其他线程抢占了执行权，把此值从 A 变成了 B，然后其他线程又把此值从 B 变成了 A，然而此时的 A 值已经并非原来的 A 值了，但最初的线程并不知道这个情况，在它进行 CAS 的时候，只对比了预期原值为 A 就进行了修改，这就造成了 ABA 的问题。
+
+以警匪剧为例，假如某人把装了 100W 现金的箱子放在了家里，几分钟之后要拿它去赎人，然而在趁他不注意的时候，进来了一个小偷，用空箱子换走了装满钱的箱子，当某人进来之后看到箱子还是一模一样的，他会以为这就是原来的箱子，就拿着它去赎人了，这种情况肯定有问题，因为箱子已经是空的了，这就是 ABA 的问题。
+
+ABA 的常见处理方式是添加版本号，每次修改之后更新版本号，拿上面的例子来说，假如每次移动箱子之后，箱子的位置就会发生变化，而这个变化的位置就相当于“版本号”，当某人进来之后发现箱子的位置发生了变化就知道有人动了手脚，就会放弃原有的计划，这样就解决了 ABA 的问题。
+
+JDK 在 1.5 时提供了 AtomicStampedReference 类也可以解决 ABA 的问题，此类维护了一个“版本号” Stamp，每次在比较时不止比较当前值还比较版本号，这样就解决了 ABA 的问题。
+
+相关源码如下：
+
+```java
+public class AtomicStampedReference {
+    private static class Pair {
+        final T reference;
+        final int stamp; // “版本号”
+        private Pair(T reference, int stamp) {
+            this.reference = reference;
+            this.stamp = stamp;
+        }
+        static  Pair of(T reference, int stamp) {
+            return new Pair(reference, stamp);
+        }
+    }
+    // 比较并设置
+    public boolean compareAndSet(V   expectedReference,
+                                 V   newReference,
+                                 int expectedStamp, // 原版本号
+                                 int newStamp) { // 新版本号
+        Pair current = pair;
+        return
+            expectedReference == current.reference &&
+            expectedStamp == current.stamp &&
+            ((newReference == current.reference &&
+              newStamp == current.stamp) ||
+             casPair(current, Pair.of(newReference, newStamp)));
+    }
+    //.......省略其他源码
+}
+```
+
+
+可以看出它在修改时会进行原值比较和版本号比较，当比较成功之后会修改值并修改版本号。
+
+小贴士：乐观锁有一个优点，它在提交的时候才进行锁定的，因此不会造成死锁。
+
+## 2.可重入锁
+
+可重入锁也叫递归锁，指的是同一个线程，如果外面的函数拥有此锁之后，内层的函数也可以继续获取该锁。在 Java 语言中 ReentrantLock 和 synchronized 都是可重入锁。
+
+下面我们用 synchronized 来演示一下什么是可重入锁，代码如下：
+
+```java
+public class LockExample {
+    public static void main(String[] args) {
+        reentrantA(); // 可重入锁
+    }
+    /**
+     * 可重入锁 A 方法
+     */
+    private synchronized static void reentrantA() {
+        System.out.println(Thread.currentThread().getName() + "：执行 reentrantA");
+        reentrantB();
+    }
+    /**
+     * 可重入锁 B 方法
+     */
+    private synchronized static void reentrantB() {
+        System.out.println(Thread.currentThread().getName() + "：执行 reentrantB");
+    }
+}
+```
+
+以上代码的执行结果如下：
+
+```
+main：执行 reentrantA
+main：执行 reentrantB
+```
+
+
+从结果可以看出 reentrantA 方法和 reentrantB 方法的执行线程都是“main” ，我们调用了 reentrantA 方法，它的方法中嵌套了 reentrantB，如果 synchronized 是不可重入的话，那么线程会被一直堵塞。
+
+可重入锁的实现原理，是在锁内部存储了一个线程标识，用于判断当前的锁属于哪个线程，并且锁的内部维护了一个计数器，当锁空闲时此计数器的值为 0，当被线程占用和重入时分别加 1，当锁被释放时计数器减 1，直到减到 0 时表示此锁为空闲状态。
+
+## 3.共享锁和独占锁
+
+只能被单线程持有的锁叫独占锁，可以被多线程持有的锁叫共享锁。
+
+独占锁指的是在任何时候最多只能有一个线程持有该锁，比如 synchronized 就是独占锁，而 ReadWriteLock 读写锁允许同一时间内有多个线程进行读操作，它就属于共享锁。
+
+独占锁可以理解为悲观锁，当每次访问资源时都要加上互斥锁，而共享锁可以理解为乐观锁，它放宽了加锁的条件，允许多线程同时访问该资源。
+
+# 小结
+
+本节我们讲了悲观锁和乐观锁，其中悲观锁的典型应用为 synchronized，而 ReadWriteLock 为乐观锁的典型应用，乐观锁可能会导致 ABA 的问题，常见的解决方案是添加版本号来防止 ABA 问题的发生；同时，还讲了可重入锁，在 Java 中，synchronized 和 ReentrantLock 都是可重入锁；最后讲了独占锁和共享锁，其中独占锁可以理解为悲观锁，而共享锁可以理解为乐观锁。
diff --git a/Java基础教程/Java面试原理/07.深克隆和浅克隆有什么区别？它的实现方式有哪些？.md b/Java基础教程/Java面试原理/07.深克隆和浅克隆有什么区别？它的实现方式有哪些？.md
new file mode 100644
index 00000000..5e48072d
--- /dev/null
+++ b/Java基础教程/Java面试原理/07.深克隆和浅克隆有什么区别？它的实现方式有哪些？.md
@@ -0,0 +1,519 @@
+# 深克隆和浅克隆有什么区别？它的实现方式有哪些？
+
+使用克隆可以为我们快速地构建出一个已有对象的副本，它属于 Java 基础的一部分，也是面试中常被问到的知识点之一。
+
+我们本课时的面试题是，什么是浅克隆和深克隆？如何实现克隆？
+
+## 典型回答
+
+浅克隆（Shadow Clone）是把原型对象中成员变量为值类型的属性都复制给克隆对象，把原型对象中成员变量为引用类型的引用地址也复制给克隆对象，也就是原型对象中如果有成员变量为引用对象，则此引用对象的地址是共享给原型对象和克隆对象的。
+
+简单来说就是浅克隆只会复制原型对象，但不会复制它所引用的对象，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200605211316.png)
+
+深克隆（Deep Clone）是将原型对象中的所有类型，无论是值类型还是引用类型，都复制一份给克隆对象，也就是说深克隆会把原型对象和原型对象所引用的对象，都复制一份给克隆对象，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200605211420.png)
+
+在 Java 语言中要实现克隆则需要实现 Cloneable 接口，并重写 Object 类中的 clone() 方法，实现代码如下：
+
+```java
+public class CloneExample {
+    public static void main(String[] args) throws CloneNotSupportedException {
+        // 创建被赋值对象
+        People p1 = new People();
+        p1.setId(1);
+        p1.setName("Java");
+        // 克隆 p1 对象
+        People p2 = (People) p1.clone();
+        // 打印名称
+        System.out.println("p2:" + p2.getName());
+    }
+    static class People implements Cloneable {
+        // 属性
+        private Integer id;
+        private String name;
+        /**
+         * 重写 clone 方法
+         * @throws CloneNotSupportedException
+         */
+        @Override
+        protected Object clone() throws CloneNotSupportedException {
+            return super.clone();
+        }
+        public Integer getId() {
+            return id;
+        }
+        public void setId(Integer id) {
+            this.id = id;
+        }
+        public String getName() {
+            return name;
+        }
+        public void setName(String name) {
+            this.name = name;
+        }
+    }
+}
+```
+
+以上程序执行的结果为：
+
+```
+p2:Java
+```
+
+## 考点分析
+克隆相关的面试题不算太难，但因为使用频率不高，因此很容易被人忽略，面试官通常会在一面或者二面的时候问到此知识点，和它相关的面试题还有以下这些：
+
+* 在 java.lang.Object 中对 clone() 方法的约定有哪些？
+* Arrays.copyOf() 是深克隆还是浅克隆？
+* 深克隆的实现方式有几种？
+* Java 中的克隆为什么要设计成，既要实现空接口 Cloneable，还要重写 Object 的 clone() 方法？
+  
+
+# 知识扩展
+
+## 1. clone() 源码分析
+要想真正的了解克隆，首先要从它的源码入手，代码如下：
+
+```java
+/**
+ * Creates and returns a copy of this object.  The precise meaning
+ * of "copy" may depend on the class of the object. The general
+ * intent is that, for any object {@code x}, the expression:
+ * 

+ * 
+ * x.clone() != x

+ * will be true, and that the expression:
+ * 

+ * 
+ * x.clone().getClass() == x.getClass()

+ * will be {@code true}, but these are not absolute requirements.
+ * While it is typically the case that:
+ * 

+ * 
+ * x.clone().equals(x)

+ * will be {@code true}, this is not an absolute requirement.
+ * 

+ * By convention, the returned object should be obtained by calling
+ * {@code super.clone}.  If a class and all of its superclasses (except
+ * {@code Object}) obey this convention, it will be the case that
+ * {@code x.clone().getClass() == x.getClass()}.
+ * 

+ * By convention, the object returned by this method should be independent
+ * of this object (which is being cloned).  To achieve this independence,
+ * it may be necessary to modify one or more fields of the object returned
+ * by {@code super.clone} before returning it.  Typically, this means
+ * copying any mutable objects that comprise the internal "deep structure"
+ * of the object being cloned and replacing the references to these
+ * objects with references to the copies.  If a class contains only
+ * primitive fields or references to immutable objects, then it is usually
+ * the case that no fields in the object returned by {@code super.clone}
+ * need to be modified.
+ * 

+ * ......
+ */
+protected native Object clone() throws CloneNotSupportedException;
+```
+
+从以上源码的注释信息中我们可以看出，Object 对 clone() 方法的约定有三条：
+
+* 对于所有对象来说，x.clone() !=x 应当返回 true，因为克隆对象与原对象不是同一个对象；
+
+* 对于所有对象来说，x.clone().getClass() == x.getClass() 应当返回 true，因为克隆对象与原对象的类型是一样的；
+
+* 对于所有对象来说，x.clone().equals(x) 应当返回 true，因为使用 equals 比较时，它们的值都是相同的。
+
+
+除了注释信息外，我们看 clone() 的实现方法，发现 clone() 是使用 native 修饰的本地方法，因此执行的性能会很高，并且它返回的类型为 Object，因此在调用克隆之后要把对象强转为目标类型才行。
+
+## 2. Arrays.copyOf()
+如果是数组类型，我们可以直接使用 Arrays.copyOf() 来实现克隆，实现代码如下：
+
+```java
+People[] o1 = {new People(1, "Java")};
+People[] o2 = Arrays.copyOf(o1, o1.length);
+// 修改原型对象的第一个元素的值
+o1[0].setName("Jdk");
+System.out.println("o1:" + o1[0].getName());
+System.out.println("o2:" + o2[0].getName());
+```
+
+以上程序的执行结果为：
+
+```
+o1:jdk
+o2:jdk
+```
+
+从结果可以看出，我们在修改克隆对象的第一个元素之后，原型对象的第一个元素也跟着被修改了，这说明 Arrays.copyOf() 其实是一个浅克隆。
+
+因为数组比较特殊数组本身就是引用类型，因此在使用 Arrays.copyOf() 其实只是把引用地址复制了一份给克隆对象，如果修改了它的引用对象，那么指向它的（引用地址）所有对象都会发生改变，因此看到的结果是，修改了克隆对象的第一个元素，原型对象也跟着被修改了。
+
+## 3. 深克隆实现方式汇总
+深克隆的实现方式有很多种，大体可以分为以下几类：
+
+* 所有对象都实现克隆方法；
+
+* 通过构造方法实现深克隆；
+
+* 使用 JDK 自带的字节流实现深克隆；
+
+* 使用第三方工具实现深克隆，比如 Apache Commons Lang；
+
+* 使用 JSON 工具类实现深克隆，比如 Gson、FastJSON 等。
+
+接下来我们分别来实现以上这些方式，在开始之前先定义一个公共的用户类，代码如下：
+
+```java
+/**
+ * 用户类
+ */
+public class People {
+    private Integer id;
+    private String name;
+    private Address address; // 包含 Address 引用对象
+    // 忽略构造方法、set、get 方法
+}
+/**
+ * 地址类
+ */
+public class Address {
+    private Integer id;
+    private String city;
+    // 忽略构造方法、set、get 方法
+}
+```
+
+可以看出在 People 对象中包含了一个引用对象 Address。
+
+### 1.所有对象都实现克隆
+
+这种方式我们需要修改 People 和 Address 类，让它们都实现 Cloneable 的接口，让所有的引用对象都实现克隆，从而实现 People 类的深克隆，代码如下：
+
+```java
+public class CloneExample {
+    public static void main(String[] args) throws CloneNotSupportedException {
+          // 创建被赋值对象
+          Address address = new Address(110, "北京");
+          People p1 = new People(1, "Java", address);
+          // 克隆 p1 对象
+          People p2 = p1.clone();
+          // 修改原型对象
+          p1.getAddress().setCity("西安");
+          // 输出 p1 和 p2 地址信息
+          System.out.println("p1:" + p1.getAddress().getCity() +
+                  " p2:" + p2.getAddress().getCity());
+    }
+    /**
+     * 用户类
+     */
+    static class People implements Cloneable {
+        private Integer id;
+        private String name;
+        private Address address;
+        /**
+         * 重写 clone 方法
+         * @throws CloneNotSupportedException
+         */
+        @Override
+        protected People clone() throws CloneNotSupportedException {
+            People people = (People) super.clone();
+            people.setAddress(this.address.clone()); // 引用类型克隆赋值
+            return people;
+        }
+        // 忽略构造方法、set、get 方法
+    }
+    /**
+     * 地址类
+     */
+    static class Address implements Cloneable {
+        private Integer id;
+        private String city;
+        /**
+         * 重写 clone 方法
+         * @throws CloneNotSupportedException
+         */
+        @Override
+        protected Address clone() throws CloneNotSupportedException {
+            return (Address) super.clone();
+        }
+        // 忽略构造方法、set、get 方法
+    }
+}
+```
+
+以上程序的执行结果为：
+
+```
+p1:西安 p2:北京
+```
+
+从结果可以看出，当我们修改了原型对象的引用属性之后，并没有影响克隆对象，这说明此对象已经实现了深克隆。
+
+### 2.通过构造方法实现深克隆
+
+《Effective Java》 中推荐使用构造器（Copy Constructor）来实现深克隆，如果构造器的参数为基本数据类型或字符串类型则直接赋值，如果是对象类型，则需要重新 new 一个对象，实现代码如下：
+
+```java
+public class SecondExample {
+    public static void main(String[] args) throws CloneNotSupportedException {
+        // 创建对象
+        Address address = new Address(110, "北京");
+        People p1 = new People(1, "Java", address);
+
+        // 调用构造函数克隆对象
+        People p2 = new People(p1.getId(), p1.getName(),
+                new Address(p1.getAddress().getId(), p1.getAddress().getCity()));
+
+        // 修改原型对象
+        p1.getAddress().setCity("西安");
+
+        // 输出 p1 和 p2 地址信息
+        System.out.println("p1:" + p1.getAddress().getCity() +
+                " p2:" + p2.getAddress().getCity());
+    }
+
+    /**
+     * 用户类
+     */
+    static class People {
+        private Integer id;
+        private String name;
+        private Address address;
+        // 忽略构造方法、set、get 方法
+    }
+
+    /**
+     * 地址类
+     */
+    static class Address {
+        private Integer id;
+        private String city;
+        // 忽略构造方法、set、get 方法
+    }
+}
+```
+
+以上程序的执行结果为：
+
+```
+p1:西安 p2:北京
+```
+
+从结果可以看出，当我们修改了原型对象的引用属性之后，并没有影响克隆对象，这说明此对象已经实现了深克隆。
+
+### 3.通过字节流实现深克隆
+
+通过 JDK 自带的字节流实现深克隆的方式，是要先将原型对象写入到内存中的字节流，然后再从这个字节流中读出刚刚存储的信息，来作为一个新的对象返回，那么这个新对象和原型对象就不存在任何地址上的共享，这样就实现了深克隆，代码如下：
+
+```java
+import java.io.*;
+
+public class ThirdExample {
+    public static void main(String[] args) throws CloneNotSupportedException {
+        // 创建对象
+        Address address = new Address(110, "北京");
+        People p1 = new People(1, "Java", address);
+
+        // 通过字节流实现克隆
+        People p2 = (People) StreamClone.clone(p1);
+
+        // 修改原型对象
+        p1.getAddress().setCity("西安");
+
+        // 输出 p1 和 p2 地址信息
+        System.out.println("p1:" + p1.getAddress().getCity() +
+                " p2:" + p2.getAddress().getCity());
+    }
+
+    /**
+     * 通过字节流实现克隆
+     */
+    static class StreamClone {
+        public static  T clone(People obj) {
+            T cloneObj = null;
+            try {
+                // 写入字节流
+                ByteArrayOutputStream bo = new ByteArrayOutputStream();
+                ObjectOutputStream oos = new ObjectOutputStream(bo);
+                oos.writeObject(obj);
+                oos.close();
+                // 分配内存,写入原始对象,生成新对象
+                ByteArrayInputStream bi = new ByteArrayInputStream(bo.toByteArray());//获取上面的输出字节流
+                ObjectInputStream oi = new ObjectInputStream(bi);
+                // 返回生成的新对象
+                cloneObj = (T) oi.readObject();
+                oi.close();
+            } catch (Exception e) {
+                e.printStackTrace();
+            }
+            return cloneObj;
+        }
+    }
+
+    /**
+     * 用户类
+     */
+    static class People implements Serializable {
+        private Integer id;
+        private String name;
+        private Address address;
+        // 忽略构造方法、set、get 方法
+    }
+
+    /**
+     * 地址类
+     */
+    static class Address implements Serializable {
+        private Integer id;
+        private String city;
+        // 忽略构造方法、set、get 方法
+    }
+}
+```
+
+以上程序的执行结果为：
+
+```
+p1:西安 p2:北京
+```
+
+此方式需要注意的是，由于是通过字节流序列化实现的深克隆，因此每个对象必须能被序列化，必须实现 Serializable 接口，标识自己可以被序列化，否则会抛出异常 (java.io.NotSerializableException)。
+
+### 4.通过第三方工具实现深克隆
+
+本课时使用 Apache Commons Lang 来实现深克隆，实现代码如下：
+
+```java
+import org.apache.commons.lang3.SerializationUtils;
+
+import java.io.Serializable;
+
+/**
+ * 深克隆实现方式四：通过 apache.commons.lang 实现
+ */
+public class FourthExample {
+    public static void main(String[] args) throws CloneNotSupportedException {
+        // 创建对象
+        Address address = new Address(110, "北京");
+        People p1 = new People(1, "Java", address);
+
+        // 调用 apache.commons.lang 克隆对象
+        People p2 = (People) SerializationUtils.clone(p1);
+
+        // 修改原型对象
+        p1.getAddress().setCity("西安");
+
+        // 输出 p1 和 p2 地址信息
+        System.out.println("p1:" + p1.getAddress().getCity() +
+                " p2:" + p2.getAddress().getCity());
+    }
+
+    /**
+     * 用户类
+     */
+    static class People implements Serializable {
+        private Integer id;
+        private String name;
+        private Address address;
+        // 忽略构造方法、set、get 方法
+    }
+
+    /**
+     * 地址类
+     */
+    static class Address implements Serializable {
+        private Integer id;
+        private String city;
+        // 忽略构造方法、set、get 方法
+    }
+}
+```
+
+以上程序的执行结果为：
+
+```
+p1:西安 p2:北京
+```
+
+可以看出此方法和第三种实现方式类似，都需要实现 Serializable 接口，都是通过字节流的方式实现的，只不过这种实现方式是第三方提供了现成的方法，让我们可以直接调用。
+
+### 5.通过 JSON 工具类实现深克隆
+
+本课时我们使用 Google 提供的 JSON 转化工具 Gson 来实现，其他 JSON 转化工具类也是类似的，实现代码如下：
+
+```java
+import com.google.gson.Gson;
+
+/**
+ * 深克隆实现方式五：通过 JSON 工具实现
+ */
+public class FifthExample {
+    public static void main(String[] args) throws CloneNotSupportedException {
+        // 创建对象
+        Address address = new Address(110, "北京");
+        People p1 = new People(1, "Java", address);
+
+        // 调用 Gson 克隆对象
+        Gson gson = new Gson();
+        People p2 = gson.fromJson(gson.toJson(p1), People.class);
+
+        // 修改原型对象
+        p1.getAddress().setCity("西安");
+
+        // 输出 p1 和 p2 地址信息
+        System.out.println("p1:" + p1.getAddress().getCity() +
+                " p2:" + p2.getAddress().getCity());
+    }
+
+    /**
+     * 用户类
+     */
+    static class People {
+        private Integer id;
+        private String name;
+        private Address address;
+        // 忽略构造方法、set、get 方法
+    }
+
+    /**
+     * 地址类
+     */
+    static class Address {
+        private Integer id;
+        private String city;
+        // 忽略构造方法、set、get 方法
+    }
+}
+```
+
+以上程序的执行结果为：
+
+```
+p1:西安 p2:北京
+```
+
+使用 JSON 工具类会先把对象转化成字符串，再从字符串转化成新的对象，因为新对象是从字符串转化而来的，因此不会和原型对象有任何的关联，这样就实现了深克隆，其他类似的 JSON 工具类实现方式也是一样的。
+
+### 6. 克隆设计理念猜想
+对于克隆为什么要这样设计，官方没有直接给出答案，我们只能凭借一些经验和源码文档来试着回答一下这个问题。Java 中实现克隆需要两个主要的步骤，一是 实现 Cloneable 空接口，二是重写 Object 的 clone() 方法再调用父类的克隆方法 (super.clone())，那为什么要这么做？
+
+从源码中可以看出 Cloneable 接口诞生的比较早，JDK 1.0 就已经存在了，因此从那个时候就已经有克隆方法了，那我们怎么来标识一个类级别对象拥有克隆方法呢？克隆虽然重要，但我们不能给每个类都默认加上克隆，这显然是不合适的，那我们能使用的手段就只有这几个了：
+
+* 在类上新增标识，此标识用于声明某个类拥有克隆的功能，像 final 关键字一样；
+* 使用 Java 中的注解；
+* 实现某个接口；
+* 继承某个类。
+
+先说第一个，为了一个重要但不常用的克隆功能， 单独新增一个类标识，这显然不合适；再说第二个，因为克隆功能出现的比较早，那时候还没有注解功能，因此也不能使用；第三点基本满足我们的需求，第四点和第一点比较类似，为了一个克隆功能需要牺牲一个基类，并且 Java 只能单继承，因此这个方案也不合适。采用排除法，无疑使用实现接口的方式是那时最合理的方案了，而且在 Java 语言中一个类可以实现多个接口。
+
+那为什么要在 Object 中添加一个 clone() 方法呢？
+
+因为 clone() 方法语义的特殊性，因此最好能有 JVM 的直接支持，既然要 JVM 直接支持，就要找一个 API 来把这个方法暴露出来才行，最直接的做法就是把它放入到一个所有类的基类 Object 中，这样所有类就可以很方便地调用到了。
+
+# 小结 
+
+本课时我们讲了浅克隆和深克隆的概念，以及 Object 对 clone() 方法的约定；还演示了数组的 copyOf() 方法其实为浅克隆，以及深克隆的 5 种实现方式；最后我们讲了 Java 语言中克隆的设计思路猜想。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/08.动态代理是如何实现的？JDK Proxy 和 CGLib 有什么区别？.md b/Java基础教程/Java面试原理/08.动态代理是如何实现的？JDK Proxy 和 CGLib 有什么区别？.md
new file mode 100644
index 00000000..c4f8b2c7
--- /dev/null
+++ b/Java基础教程/Java面试原理/08.动态代理是如何实现的？JDK Proxy 和 CGLib 有什么区别？.md	
@@ -0,0 +1,270 @@
+# 动态代理是如何实现的？JDK Proxy 和 CGLib 有什么区别？
+
+90% 的程序员直接或者间接的使用过动态代理，无论是日志框架或 Spring 框架，它们都包含了动态代理的实现代码。动态代理是程序在运行期间动态构建代理对象和动态调用代理方法的一种机制。
+
+我们本课时的面试题是，如何实现动态代理？JDK Proxy 和 CGLib 有什么区别？
+
+## 典型回答
+
+动态代理的常用实现方式是反射。反射机制是指程序在运行期间可以访问、检测和修改其本身状态或行为的一种能力，使用反射我们可以调用任意一个类对象，以及类对象中包含的属性及方法。
+
+但动态代理不止有反射一种实现方式，例如，动态代理可以通过 CGLib 来实现，而 CGLib 是基于 ASM（一个 Java 字节码操作框架）而非反射实现的。简单来说，动态代理是一种行为方式，而反射或 ASM 只是它的一种实现手段而已。
+
+JDK Proxy 和 CGLib 的区别主要体现在以下几个方面：
+
+* JDK Proxy 是 Java 语言自带的功能，无需通过加载第三方类实现；
+* Java 对 JDK Proxy 提供了稳定的支持，并且会持续的升级和更新 JDK Proxy，例如 Java 8 版本中的 JDK Proxy 性能相比于之前版本提升了很多；
+* JDK Proxy 是通过拦截器加反射的方式实现的；
+* JDK Proxy 只能代理继承接口的类；
+* JDK Proxy 实现和调用起来比较简单；
+* CGLib 是第三方提供的工具，基于 ASM 实现的，性能比较高；
+* CGLib 无需通过接口来实现，它是通过实现子类的方式来完成调用的。
+
+## 考点分析
+
+本课时考察的是你对反射、动态代理及 CGLib 的了解，很多人经常会把反射和动态代理划为等号，但从严格意义上来说，这种想法是不正确的，真正能搞懂它们之间的关系，也体现了你扎实 Java 的基本功。和这个问题相关的知识点，还有以下几个：
+
+* 你对 JDK Proxy 和 CGLib 的掌握程度。
+* Lombok 是通过反射实现的吗？
+* 动态代理和静态代理有什么区别？
+* 动态代理的使用场景有哪些？
+* Spring 中的动态代理是通过什么方式实现的？
+
+# 知识扩展
+
+## 1. JDK Proxy 和 CGLib 的使用及代码分析
+
+### JDK Proxy 动态代理实现
+
+JDK Proxy 动态代理的实现无需引用第三方类，只需要实现 InvocationHandler 接口，重写 invoke() 方法即可，整个实现代码如下所示：
+
+```java
+import java.lang.reflect.InvocationHandler;
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+import java.lang.reflect.Proxy;
+
+/**
+ * JDK Proxy 相关示例
+ */
+public class ProxyExample {
+    static interface Car {
+        void running();
+    }
+
+    static class Bus implements Car {
+        @Override
+        public void running() {
+            System.out.println("The bus is running.");
+        }
+    }
+
+    static class Taxi implements Car {
+        @Override
+        public void running() {
+            System.out.println("The taxi is running.");
+        }
+    }
+
+    /**
+     * JDK Proxy
+     */
+    static class JDKProxy implements InvocationHandler {
+        private Object target; // 代理对象
+
+        // 获取到代理对象
+        public Object getInstance(Object target) {
+            this.target = target;
+            // 取得代理对象
+            return Proxy.newProxyInstance(target.getClass().getClassLoader(),
+                    target.getClass().getInterfaces(), this);
+        }
+
+        /**
+         * 执行代理方法
+         * @param proxy  代理对象
+         * @param method 代理方法
+         * @param args   方法的参数
+         * @return
+         * @throws InvocationTargetException
+         * @throws IllegalAccessException
+         */
+        @Override
+        public Object invoke(Object proxy, Method method, Object[] args)
+                throws InvocationTargetException, IllegalAccessException {
+            System.out.println("动态代理之前的业务处理.");
+            Object result = method.invoke(target, args); // 执行调用方法（此方法执行前后，可以进行相关业务处理）
+            return result;
+        }
+    }
+
+    public static void main(String[] args) {
+        // 执行 JDK Proxy
+        JDKProxy jdkProxy = new JDKProxy();
+        Car carInstance = (Car) jdkProxy.getInstance(new Taxi());
+        carInstance.running();
+    }
+```
+
+以上程序的执行结果是：
+
+```
+动态代理之前的业务处理.
+The taxi is running.
+```
+
+可以看出 JDK Proxy 实现动态代理的核心是实现 Invocation 接口，我们查看 Invocation 的源码，会发现里面其实只有一个 invoke() 方法，源码如下：
+
+```java
+public interface InvocationHandler {
+  public Object invoke(Object proxy, Method method, Object[] args)
+          throws Throwable;
+}
+```
+
+这是因为在动态代理中有一个重要的角色也就是代理器，它用于统一管理被代理的对象，显然 InvocationHandler 就是这个代理器，而 invoke() 方法则是触发代理的执行方法，我们通过实现 Invocation 接口来拥有动态代理的能力。
+
+### CGLib 的实现
+
+在使用 CGLib 之前，我们要先在项目中引入 CGLib 框架，在 pom.xml 中添加如下配置：
+
+```xml
+
+
+    cglib
+    cglib
+    3.3.0
+
+```
+
+CGLib 实现代码如下：
+
+```java
+import net.sf.cglib.proxy.Enhancer;
+import net.sf.cglib.proxy.MethodInterceptor;
+import net.sf.cglib.proxy.MethodProxy;
+
+import java.lang.reflect.Method;
+
+public class CGLibExample {
+
+    static class Car {
+        public void running() {
+            System.out.println("The car is running.");
+        }
+    }
+
+    /**
+     * CGLib 代理类
+     */
+    static class CGLibProxy implements MethodInterceptor {
+        private Object target; // 代理对象
+
+        public Object getInstance(Object target) {
+            this.target = target;
+            Enhancer enhancer = new Enhancer();
+            // 设置父类为实例类
+            enhancer.setSuperclass(this.target.getClass());
+            // 回调方法
+            enhancer.setCallback(this);
+            // 创建代理对象
+            return enhancer.create();
+        }
+
+        @Override
+        public Object intercept(Object o, Method method,
+                                Object[] objects, MethodProxy methodProxy) throws Throwable {
+            System.out.println("方法调用前业务处理.");
+            Object result = methodProxy.invokeSuper(o, objects); // 执行方法调用
+            return result;
+        }
+    }
+
+    // 执行 CGLib 的方法调用
+    public static void main(String[] args) {
+        // 创建 CGLib 代理类
+        CGLibProxy proxy = new CGLibProxy();
+        // 初始化代理对象
+        Car car = (Car) proxy.getInstance(new Car());
+        // 执行方法
+        car.running();
+    }
+```
+
+以上程序的执行结果是：
+
+```
+方法调用前业务处理.
+The car is running.
+```
+
+可以看出 CGLib 和 JDK Proxy 的实现代码比较类似，都是通过实现代理器的接口，再调用某一个方法完成动态代理的，唯一不同的是，CGLib 在初始化被代理类时，是通过 Enhancer 对象把代理对象设置为被代理类的子类来实现动态代理的。因此被代理类不能被关键字 final 修饰，如果被 final 修饰，再使用 Enhancer 设置父类时会报错，动态代理的构建会失败。
+
+## 2. Lombok 原理分析
+在开始讲 Lombok 的原理之前，我们先来简单地介绍一下 Lombok，它属于 Java 的一个热门工具类，使用它可以有效的解决代码工程中那些繁琐又重复的代码，如 Setter、Getter、toString、equals 和 hashCode 等等，向这种方法都可以使用 Lombok 注解来完成。
+
+例如，我们使用比较多的 Setter 和 Getter 方法，在没有使用 Lombok 之前，代码是这样的：
+
+```java
+public class Person {
+    private Integer id;
+    private String name;
+    public Integer getId() {
+        return id;
+    }
+    public void setId(Integer id) {
+        this.id = id;
+    }
+    public String getName() {
+        return name;
+    }
+    public void setName(String name) {
+        this.name = name;
+    }
+}
+```
+
+在使用 Lombok 之后，代码是这样的：
+
+```java
+@Data
+public class Person {
+    private Integer id;
+    private String name;
+}
+```
+
+可以看出 Lombok 让代码简单和优雅了很多。
+
+> 小贴士：如果在项目中使用了 Lombok 的 Getter 和 Setter 注解，那么想要在编码阶段成功调用对象的 set 或 get 方法，我们需要在 IDE 中安装 Lombok 插件才行，比如 Idea 的插件如下图所示：
+>
+> ![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200606112218.png)
+
+接下来讲讲 Lombok 的原理。
+
+Lombok 的实现和反射没有任何关系，前面我们说了反射是程序在运行期的一种自省（introspect）能力，而 Lombok 的实现是在编译期就完成了，为什么这么说呢？
+
+回到我们刚才 Setter/Getter 的方法，当我们打开 Person 的编译类就会发现，使用了 Lombok 的 @Data 注解后的源码竟然是这样的：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200606112319.png)
+
+可以看出 Lombok 是在编译期就为我们生成了对应的字节码。
+
+其实 Lombok 是基于 Java 1.6 实现的 JSR 269: Pluggable Annotation Processing API 来实现的，也就是通过编译期自定义注解处理器来实现的，它的执行步骤如下：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200606112419.png)
+
+从流程图中可以看出，在编译期阶段，当 Java 源码被抽象成语法树（AST）之后，Lombok 会根据自己的注解处理器动态修改 AST，增加新的代码（节点），在这一切执行之后就生成了最终的字节码（.class）文件，这就是 Lombok 的执行原理。
+
+## 3.动态代理知识点扩充
+
+当面试官问动态代理的时候，经常会问到它和静态代理的区别？静态代理其实就是事先写好代理类，可以手工编写也可以使用工具生成，但它的缺点是每个业务类都要对应一个代理类，特别不灵活也不方便，于是就有了动态代理。
+
+动态代理的常见使用场景有 RPC 框架的封装、AOP（面向切面编程）的实现、JDBC 的连接等。
+
+Spring 框架中同时使用了两种动态代理 JDK Proxy 和 CGLib，当 Bean 实现了接口时，Spring 就会使用 JDK Proxy，在没有实现接口时就会使用 CGLib，我们也可以在配置中指定强制使用 CGLib，只需要在 Spring 配置中添加 ` `即可。
+
+# 小结
+本课时我们介绍了 JDK Proxy 和 CGLib 的区别，JDK Proxy 是 Java 语言内置的动态代理，必须要通过实现接口的方式来代理相关的类，而 CGLib 是第三方提供的基于 ASM 的高效动态代理类，它通过实现被代理类的子类来实现动态代理的功能，因此被代理的类不能使用 final 修饰。
+
+除了 JDK Proxy 和 CGLib 之外，我们还讲了 Java 中常用的工具类 Lombok 的实现原理，它其实和反射是没有任何关系的；最后讲了动态代理的使用场景以及 Spring 中动态代理的实现方式。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/09.如何实现本地缓存和分布式缓存？.md b/Java基础教程/Java面试原理/09.如何实现本地缓存和分布式缓存？.md
new file mode 100644
index 00000000..e7ce4ff7
--- /dev/null
+++ b/Java基础教程/Java面试原理/09.如何实现本地缓存和分布式缓存？.md
@@ -0,0 +1,416 @@
+# 如何实现本地缓存和分布式缓存？
+
+缓存（Cache） 是指将程序或系统中常用的数据对象存储在像内存这样特定的介质中，以避免在每次程序调用时，重新创建或组织数据所带来的性能损耗，从而提高了系统的整体运行速度。
+
+以目前的系统架构来说，用户的请求一般会先经过缓存系统，如果缓存中没有相关的数据，就会在其他系统中查询到相应的数据并保存在缓存中，最后返回给调用方。
+
+缓存既然如此重要，那本课时我们就来重点看一下，应该如何实现本地缓存和分布式缓存？
+
+## 典型回答
+
+本地缓存是指程序级别的缓存组件，它的特点是本地缓存和应用程序会运行在同一个进程中，所以本地缓存的操作会非常快，因为在同一个进程内也意味着不会有网络上的延迟和开销。
+
+本地缓存适用于单节点非集群的应用场景，它的优点是快，缺点是多程序无法共享缓存，比如分布式用户 Session 会话信息保存，由于每次用户访问的服务器可能是不同的，如果不能共享缓存，那么就意味着每次的请求操作都有可能被系统阻止，因为会话信息只保存在某一个服务器上，当请求没有被转发到这台存储了用户信息的服务器时，就会被认为是非登录的违规操作。
+
+除此之外，无法共享缓存可能会造成系统资源的浪费，这是因为每个系统都单独维护了一份属于自己的缓存，而同一份缓存有可能被多个系统单独进行存储，从而浪费了系统资源。
+
+分布式缓存是指将应用系统和缓存组件进行分离的缓存机制，这样多个应用系统就可以共享一套缓存数据了，它的特点是共享缓存服务和可集群部署，为缓存系统提供了高可用的运行环境，以及缓存共享的程序运行机制。
+
+本地缓存可以使用 EhCache 和 Google 的 Guava 来实现，而分布式缓存可以使用 Redis 或 Memcached 来实现。
+
+由于 Redis 本身就是独立的缓存系统，因此可以作为第三方来提供共享的数据缓存，而 Redis 的分布式支持主从、哨兵和集群的模式，所以它就可以支持分布式的缓存，而 Memcached 的情况也是类似的。
+
+## 考点分析
+本课时的面试题显然不只是为了问你如何实现本地缓存和分布式缓存这么简单，主要考察的是你对缓存系统的理解，以及对缓存本质原理的洞察，和缓存相关的面试题还有这些：
+
+更加深入的谈谈 EhCache 和 Guava。
+如何自己手动实现一个缓存系统？
+
+# 知识扩展
+
+## 1. EhCache 和 Guava 的使用及特点分析
+EhCache 是目前比较流行的开源缓存框架，是用纯 Java 语言实现的简单、快速的 Cache 组件。EhCache 支持内存缓存和磁盘缓存，支持 LRU（Least Recently Used，最近很少使用）、LFU（Least Frequently Used，最近不常被使用）和 FIFO（First In First Out，先进先出）等多种淘汰算法，并且支持分布式的缓存系统。
+
+EhCache 最初是独立的本地缓存框架组件，在后期的发展中（从 1.2 版）开始支持分布式缓存，分布式缓存主要支持 RMI、JGroups、EhCache Server 等方式。
+
+LRU 和 LFU 的区别
+
+LRU 算法有一个缺点，比如说很久没有使用的一个键值，如果最近被访问了一次，那么即使它是使用次数最少的缓存，它也不会被淘汰；而 LFU 算法解决了偶尔被访问一次之后，数据就不会被淘汰的问题，它是根据总访问次数来淘汰数据的，其核心思想是“如果数据过去被访问多次，那么将来它被访问次数也会比较多”。因此 LFU 可以理解为比 LRU 更加合理的淘汰算法。
+
+EhCache 基础使用
+
+首先，需要在项目中添加 EhCache 框架，如果为 Maven 项目，则需要在 pom.xml 中添加如下配置：
+
+```xml
+
+
+    org.ehcache
+    ehcache
+    3.8.1
+
+```
+
+无配置参数的 EhCache 3.x 使用代码如下：
+
+```java
+import org.ehcache.Cache;
+import org.ehcache.CacheManager;
+import org.ehcache.config.builders.CacheConfigurationBuilder;
+import org.ehcache.config.builders.CacheManagerBuilder;
+import org.ehcache.config.builders.ResourcePoolsBuilder;
+
+public class EhCacheExample {
+    public static void main(String[] args) {
+        // 创建缓存管理器
+        CacheManager cacheManager = CacheManagerBuilder.newCacheManagerBuilder().build();
+        // 初始化 EhCache
+        cacheManager.init();
+        // 创建缓存（存储器）
+        Cache myCache = cacheManager.createCache("MYCACHE",
+                CacheConfigurationBuilder.newCacheConfigurationBuilder(
+                        String.class, String.class,
+                        ResourcePoolsBuilder.heap(10))); // 设置缓存的最大容量
+        // 设置缓存
+        myCache.put("key", "Hello,Java.");
+        // 读取缓存
+        String value = myCache.get("key");
+        // 输出缓存
+        System.out.println(value);
+        // 关闭缓存
+        cacheManager.close();
+    }
+}
+```
+
+其中：
+
+* CacheManager：是缓存管理器，可以通过单例或者多例的方式创建，也是 Ehcache 的入口类；
+* Cache：每个 CacheManager 可以管理多个 Cache，每个 Cache 可以采用 hash 的方式存储多个元素。
+
+它们的关系如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200606211651.png)
+
+更多使用方法，请参考官方文档。
+
+EhCache 的特点是，它使用起来比较简单，并且本身的 jar 包不是很大，简单的配置之后就可以正常使用了。EhCache 的使用比较灵活，它支持多种缓存策略的配置，它同时支持内存和磁盘缓存两种方式，在 EhCache 1.2 之后也开始支持分布式缓存了。
+
+Guava Cache 是 Google 开源的 Guava 里的一个子功能，它是一个内存型的本地缓存实现方案，提供了线程安全的缓存操作机制。
+
+Guava Cache 的架构设计灵感来源于 ConcurrentHashMap，它使用了多个 segments 方式的细粒度锁，在保证线程安全的同时，支持了高并发的使用场景。Guava Cache 类似于 Map 集合的方式对键值对进行操作，只不过多了过期淘汰等处理逻辑。
+
+在使用 Guava Cache 之前，我们需要先在 pom.xml 中添加 Guava 框架，配置如下：
+
+```xml
+
+
+    com.google.guava
+    guava
+    28.2-jre
+
+```
+
+Guava Cache 的创建有两种方式，一种是 LoadingCache，另一种是 Callable，代码示例如下：
+
+```java
+import com.google.common.cache.*;
+
+import java.util.concurrent.Callable;
+import java.util.concurrent.ExecutionException;
+import java.util.concurrent.TimeUnit;
+
+public class GuavaExample {
+    public static void main(String[] args) throws ExecutionException {
+        // 创建方式一：LoadingCache
+        LoadingCache loadCache = CacheBuilder.newBuilder()
+                // 并发级别设置为 5，是指可以同时写缓存的线程数
+                .concurrencyLevel(5)
+                // 设置 8 秒钟过期
+                .expireAfterWrite(8, TimeUnit.SECONDS)
+                //设置缓存容器的初始容量为 10
+                .initialCapacity(10)
+                // 设置缓存最大容量为 100，超过之后就会按照 LRU 算法移除缓存项
+                .maximumSize(100)
+                // 设置要统计缓存的命中率
+                .recordStats()
+                // 设置缓存的移除通知
+                .removalListener(new RemovalListener() {
+                    public void onRemoval(RemovalNotification notification) {
+                        System.out.println(notification.getKey() + " was removed, cause is " + notification.getCause());
+                    }
+                })
+                // 指定 CacheLoader，缓存不存在时，可自动加载缓存
+                .build(
+                        new CacheLoader() {
+                            @Override
+                            public String load(String key) throws Exception {
+                                // 自动加载缓存的业务
+                                return "cache-value:" + key;
+                            }
+                        }
+                );
+        // 设置缓存
+        loadCache.put("c1", "Hello, c1.");
+        // 查询缓存
+        String val = loadCache.get("c1");
+        System.out.println(val);
+        // 查询不存在的缓存
+        String noval = loadCache.get("noval");
+        System.out.println(noval);
+
+        // 创建方式二：Callable
+        Cache cache = CacheBuilder.newBuilder()
+                .maximumSize(2) // 设置缓存最大长度
+                .build();
+        // 设置缓存
+        cache.put("k1", "Hello, k1.");
+        // 查询缓存
+        String value = cache.get("k1", new Callable() {
+            @Override
+            public String call() {
+                // 缓存不存在时，执行
+                return "nil";
+            }
+        });
+        // 输出缓存值
+        System.out.println(value);
+        // 查询缓存
+        String nokey = cache.get("nokey", new Callable() {
+            @Override
+            public String call() {
+                // 缓存不存在时，执行
+                return "nil";
+            }
+        });
+        // 输出缓存值
+        System.out.println(nokey);
+    }
+}
+```
+
+以上程序的执行结果为：
+
+```
+Hello, c1.
+cache-value:noval
+Hello, k1.
+nil
+```
+
+可以看出 Guava Cache 使用了编程式的 build 生成器进行创建和管理，让使用者可以更加灵活地操纵代码，并且 Guava Cache 提供了灵活多样的个性化配置，以适应各种使用场景。
+
+## 2. 手动实现一个缓存系统
+上面我们讲了通过 EhCache 和 Guava 实现缓存的方式，接下来我们来看看自己如何自定义一个缓存系统，当然这里说的是自己手动实现一个本地缓存。
+
+要自定义一个缓存，首先要考虑的是数据类型，我们可以使用 Map 集合中的 HashMap、Hashtable 或 ConcurrentHashMap 来实现，非并发情况下我们可以使用 HashMap，并发情况下可以使用 Hashtable 或 ConcurrentHashMap，由于 ConcurrentHashMap 的性能比 Hashtable 的高，因此在高并发环境下我们可以倾向于选择 ConcurrentHashMap，不过它们对元素的操作都是类似的。
+
+选定了数据类型之后，我们还需要考虑缓存过期和缓存淘汰等问题，在这里我们可以借鉴 Redis 对待过期键的处理策略。
+
+目前比较常见的过期策略有以下三种：
+
+* 定时删除
+* 惰性删除
+* 定期删除
+
+**定时删除**是指在设置键值的过期时间时，创建一个定时事件，当到达过期时间后，事件处理器会执行删除过期键的操作。它的优点是可以及时的释放内存空间，缺点是需要开启多个延迟执行事件来处理清除任务，这样就会造成大量任务事件堆积，占用了很多系统资源。
+
+**惰性删除**不会主动删除过期键，而是在每次请求时才会判断此值是否过期，如果过期则删除键值，否则就返回 null。它的优点是只会占用少量的系统资源，缺点是清除不够及时，会造成一定的空间浪费。
+
+**定期删除**是指每隔一段时间检查一次数据库，随机删除一些过期键值。
+
+Redis 使用的是定期删除和惰性删除这两种策略，我们本课时也会参照这两种策略。
+
+先来说一下自定义缓存的实现思路，首先需要定义一个存放缓存值的实体类，这个类里包含了缓存的相关信息，比如缓存的 key 和 value，缓存的存入时间、最后使用时间和命中次数（预留字段，用于支持 LFU 缓存淘汰），再使用 ConcurrentHashMap 保存缓存的 key 和 value 对象（缓存值的实体类），然后再新增一个缓存操作的工具类，用于添加和删除缓存，最后再缓存启动时，开启一个无限循环的线程用于检测并删除过期的缓存，实现代码如下。
+
+首先，定义一个缓存值实体类，代码如下：
+
+```java
+import lombok.Getter;
+import lombok.Setter;
+
+/**
+ * 缓存实体类
+ */
+@Getter
+@Setter
+public class CacheValue implements Comparable {
+    // 缓存键
+    private Object key;
+    // 缓存值
+    private Object value;
+    // 最后访问时间
+    private long lastTime;
+    // 创建时间
+    private long writeTime;
+    // 存活时间
+    private long expireTime;
+    // 命中次数
+    private Integer hitCount;
+
+    @Override
+    public int compareTo(CacheValue o) {
+        return hitCount.compareTo(o.hitCount);
+    }
+}
+```
+
+然后定义一个全局缓存对象，代码如下：
+
+```java
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.ConcurrentMap;
+
+/**
+ * Cache 全局类
+ */
+public class CacheGlobal {
+    // 全局缓存对象
+    public static ConcurrentMap concurrentMap = new ConcurrentHashMap<>();
+}
+```
+
+定义过期缓存检测类的代码如下：
+
+```java
+import java.util.concurrent.TimeUnit;
+
+/**
+ * 过期缓存检测线程
+ */
+public class ExpireThread implements Runnable {
+    @Override
+    public void run() {
+        while (true) {
+            try {
+                // 每十秒检测一次
+                TimeUnit.SECONDS.sleep(10);
+                // 缓存检测和清除的方法
+                expireCache();
+            } catch (Exception e) {
+                e.printStackTrace();
+            }
+        }
+    }
+
+    /**
+     * 缓存检测和清除的方法
+     */
+    private void expireCache() {
+        System.out.println("检测缓存是否过期缓存");
+        for (String key : CacheGlobal.concurrentMap.keySet()) {
+            MyCache cache = CacheGlobal.concurrentMap.get(key);
+            // 当前时间 - 写入时间
+            long timoutTime = TimeUnit.NANOSECONDS.toSeconds(
+                    System.nanoTime() - cache.getWriteTime());
+            if (cache.getExpireTime() > timoutTime) {
+                // 没过期
+                continue;
+            }
+            // 清除过期缓存
+            CacheGlobal.concurrentMap.remove(key);
+        }
+    }
+}
+```
+
+接着，我们要新增一个缓存操作的工具类，用于查询和存入缓存，实现代码如下：
+
+```java
+import org.apache.commons.lang3.StringUtils;
+
+import java.util.concurrent.TimeUnit;
+
+/**
+ * 缓存操作工具类
+ */
+public class CacheUtils {
+
+    /**
+     * 添加缓存
+     * @param key
+     * @param value
+     * @param expire
+     */
+    public void put(String key, Object value, long expire) {
+        // 非空判断，借助 commons-lang3
+        if (StringUtils.isBlank(key)) return;
+        // 当缓存存在时，更新缓存
+        if (CacheGlobal.concurrentMap.containsKey(key)) {
+            MyCache cache = CacheGlobal.concurrentMap.get(key);
+            cache.setHitCount(cache.getHitCount() + 1);
+            cache.setWriteTime(System.currentTimeMillis());
+            cache.setLastTime(System.currentTimeMillis());
+            cache.setExpireTime(expire);
+            cache.setValue(value);
+            return;
+        }
+        // 创建缓存
+        MyCache cache = new MyCache();
+        cache.setKey(key);
+        cache.setValue(value);
+        cache.setWriteTime(System.currentTimeMillis());
+        cache.setLastTime(System.currentTimeMillis());
+        cache.setHitCount(1);
+        cache.setExpireTime(expire);
+        CacheGlobal.concurrentMap.put(key, cache);
+    }
+
+    /**
+     * 获取缓存
+     * @param key
+     * @return
+     */
+    public Object get(String key) {
+        // 非空判断
+        if (StringUtils.isBlank(key)) return null;
+        // 字典中不存在
+        if (CacheGlobal.concurrentMap.isEmpty()) return null;
+        if (!CacheGlobal.concurrentMap.containsKey(key)) return null;
+        MyCache cache = CacheGlobal.concurrentMap.get(key);
+        if (cache == null) return null;
+        // 惰性删除，判断缓存是否过期
+        long timoutTime = TimeUnit.NANOSECONDS.toSeconds(
+                System.nanoTime() - cache.getWriteTime());
+        // 缓存过期
+        if (cache.getExpireTime() <= timoutTime) {
+            // 清除过期缓存
+            CacheGlobal.concurrentMap.remove(k
+            return null;
+        }
+        cache.setHitCount(cache.getHitCount() + 1);
+        cache.setLastTime(System.currentTimeMillis());
+        return cache.getValue();
+    }
+}
+```
+
+最后是调用缓存的测试代码：
+
+```java
+public class MyCacheTest {
+    public static void main(String[] args) {
+        CacheUtils cache = new CacheUtils();
+        // 存入缓存
+        cache.put("key", "老王", 10);
+        // 查询缓存
+        String val = (String) cache.get("key");
+        System.out.println(val);
+        // 查询不存在的缓存
+        String noval = (String) cache.get("noval");
+        System.out.println(noval);
+    }
+}
+```
+
+以上程序的执行结果如下：
+
+```
+老王
+null
+```
+
+到目前为止，自定义缓存系统就已经实现完了。
+
+# 小结
+
+本课时讲解了本地缓存和分布式缓存这两个概念和实现的具体方式，其中本地缓存可以通过自己手动编码或借助 Guava Cache 来实现，而分布式缓存可以使用 Redis 或 EhCache 来实现。此外，本课时重点演示了手动实现缓存代码的方式和实现思路，并使用定期删除和惰性删除策略来实现缓存的清除。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/10.如何手写一个消息队列和延迟消息队列？.md b/Java基础教程/Java面试原理/10.如何手写一个消息队列和延迟消息队列？.md
new file mode 100644
index 00000000..08ec6144
--- /dev/null
+++ b/Java基础教程/Java面试原理/10.如何手写一个消息队列和延迟消息队列？.md
@@ -0,0 +1,244 @@
+# 如何手写一个消息队列和延迟消息队列？
+
+第一次听到“消息队列”这个词时，不知你是不是和我反应一样，感觉很高阶很厉害的样子，其实当我们了解了消息队列之后，发现它与普通的技术类似，当我们熟悉之后，也能很快地上手并使用。
+
+我们本课时的面试题是，消息队列的使用场景有哪些？如何手动实现一个消息队列和延迟消息队列？
+
+## 典型回答
+
+消息队列的使用场景有很多，最常见的使用场景有以下几个。
+
+### 1.商品秒杀
+
+比如，我们在做秒杀活动时，会发生短时间内出现爆发式的用户请求，如果不采取相关的措施，会导致服务器忙不过来，响应超时的问题，轻则会导致服务假死，重则会让服务器直接宕机，给用户带来的体验也非常不好。如果这个时候加上了消息队列，服务器接收到用户的所有请求后，先把这些请求全部写入到消息队列中再排队处理，这样就不会导致同时处理多个请求的情况；如果消息队列长度超过可以承载的最大数量，那么我们可以抛弃当前用户的请求，通知前台用户“页面出错啦，请重新刷新”等提示，这样就会有更好的交互体验。
+
+### 2.系统解耦
+
+使用了消息队列之后，我们可以把系统的业务功能模块化，实现系统的解耦。例如，在没有使用消息队列之前，当前台用户完善了个人信息之后，首先我们需要更新用户的资料，再添加一条用户信息修改日志。但突然有一天产品经理提了一个需求，在前台用户信息更新之后，需要给此用户的增加一定的积分奖励，然后没过几天产品经理又提了一个需求，在前台用户信息更新之后，不但要增加积分奖励，还要增加用户的经验值，但没过几天产品经理的需求又变了，他要求完善资料无需增加用户的积分了，这样反反复复、来来回回的折腾，我想研发的同学一定受不了，但这是互联网公司的常态，那我们有没有一劳永逸的办法呢？
+
+没错，这个时候我们想到了使用消息队列来实现系统的解耦，每个功能的实现独立开，只需要一个订阅或者取消订阅的开关就可以了，当需要增加功能时，只需要打开订阅“用户信息完善”的队列就行，如果过两天不用了，再把订阅的开关关掉就行了，这样我们就不用来来回回的改业务代码了，也就轻松的实现了系统模块间的解耦。
+
+### 3.日志记录
+
+我们大部分的日志记录行为其实是和前台用户操作的主业务没有直接关系的，只是我们的运营人和经营人员需要拿到这部分用户操作的日志信息，来进行用户行为分析或行为监控。在我们没有使用消息队列之前，笼统的做法是当有用户请求时，先处理用户的请求再记录日志，这两个操作是放在一起的，而前台用户也需要等待日志添加完成之后才能拿到后台的响应信息，这样其实浪费了前台用户的部分时间。此时我们可以使用消息队列，当响应完用户请求之后，只需要把这个操作信息放入消息队列之后，就可以直接返回结果给前台用户了，无序等待日志处理和日志添加完成，从而缩短了前台用户的等待时间。
+
+我们可以通过 JDK 提供的 Queue 来实现自定义消息队列，使用 DelayQueue 实现延迟消息队列。
+
+## 考点分析
+对于消息队列的考察更侧重于消息队列的核心思想，因为只有理解了什么是消息队列？以及什么情况下要用消息队列？才能解决我们日常工作中遇到的问题，而消息队列的具体实现，只需要掌握一个消息中间件的使用即可，因为消息队列中间件的核心实现思路是一致的，不但如此，消息队列中间件的使用也大致类似，只要掌握了一个就能触类旁通的用好其他消息中间件。
+
+和本课时相关的面试题，还有以下这两个：
+
+* 介绍一个你熟悉的消息中间件？
+* 如何手动实现消息队列？
+
+# 知识扩展
+## 1.常用消息中间件 RabbitMQ
+
+目前市面上比较常用的 MQ（Message Queue，消息队列）中间件有 RabbitMQ、Kafka、RocketMQ，如果是轻量级的消息队列可以使用 Redis 提供的消息队列，本课时我们先来介绍一下 RabbitMQ。
+
+RabbitMQ 是一个老牌开源的消息中间件，它实现了标准的 AMQP（Advanced Message Queuing Protocol，高级消息队列协议）消息中间件，使用 Erlang 语言开发，支持集群部署，和多种客户端语言混合调用，它支持的主流开发语言有以下这些：
+
+* Java and Spring
+
+* .NET
+
+* Ruby
+
+* Python
+
+* PHP
+
+* JavaScript and Node
+
+* Objective-C and Swift
+
+* Rust
+
+* Scala
+
+* Go
+
+更多支持语言，请点击这里访问官网查看。
+
+RabbitMQ 中有 3 个重要的概念：生产者、消费者和代理。
+
+* 生产者：消息的创建者，负责创建和推送数据到消息服务器。
+
+* 消费者：消息的接收方，用于处理数据和确认消息。
+
+* 代理：也就是 RabbitMQ 服务本身，它用于扮演“快递”的角色，因为它本身并不生产消息，只是扮演了“快递”的角色，把消息进行暂存和传递。
+
+它们的运行流程，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200607112505.png)
+
+RabbitMQ 具备以下几个优点：
+
+* **支持持久化**，RabbitMQ 支持磁盘持久化功能，保证了消息不会丢失；
+* **高并发**，RabbitMQ 使用了 Erlang 开发语言，Erlang 是为电话交换机开发的语言，天生自带高并发光环和高可用特性；
+* **支持分布式集群**，正是因为 Erlang 语言实现的，因此 RabbitMQ 集群部署也非常简单，只需要启动每个节点并使用 --link 把节点加入到集群中即可，并且 RabbitMQ 支持自动选主和自动容灾；
+* **支持多种语言**，比如 Java、.NET、PHP、Python、JavaScript、Ruby、Go 等；
+* **支持消息确认**，支持消息消费确认（ack）保证了每条消息可以被正常消费；
+* **支持很多插件**，比如网页控制台消息管理插件、消息延迟插件等，RabbitMQ 的插件很多并且使用都很方便。
+
+RabbitMQ 的消息类型，分为以下四种：
+
+* **direct（默认类型）模式**，此模式为一对一的发送方式，也就是一条消息只会发送给一个消费者；
+* **headers 模式**，允许你匹配消息的 header 而非路由键（RoutingKey），除此之外 headers 和 direct 的使用完全一致，但因为 headers 匹配的性能很差，几乎不会被用到；
+* **fanout 模式**，为多播的方式，会把一个消息分发给所有的订阅者；
+* **topic 模式**，为主题订阅模式，允许使用通配符（#、*）匹配一个或者多个消息，我可以使用“cn.mq.#”匹配到多个前缀是“cn.mq.xxx”的消息，比如可以匹配到“cn.mq.rabbit”、“cn.mq.kafka”等消息。
+
+## 2.自定义消息队列
+我们可使用 Queue 来实现消息队列，Queue 大体可分为以下三类：
+
+* **双端队列（Deque）**是 Queue 的子类也是 Queue 的补充类，头部和尾部都支持元素插入和获取；
+* **阻塞队列**指的是在元素操作时（添加或删除），如果没有成功，会阻塞等待执行，比如当添加元素时，如果队列元素已满，队列则会阻塞等待直到有空位时再插入；
+* **非阻塞队列**，和阻塞队列相反，它会直接返回操作的结果，而非阻塞等待操作，双端队列也属于非阻塞队列。
+
+自定义消息队列的实现代码如下：
+
+```java
+import java.util.LinkedList;
+import java.util.Queue;
+
+public class CustomQueue {
+    // 定义消息队列
+    private static Queue queue = new LinkedList<>();
+
+    public static void main(String[] args) {
+        producer(); // 调用生产者
+        consumer(); // 调用消费者
+    }
+
+    // 生产者
+    public static void producer() {
+        // 添加消息
+        queue.add("first message.");
+        queue.add("second message.");
+        queue.add("third message.");
+    }
+
+    // 消费者
+    public static void consumer() {
+        while (!queue.isEmpty()) {
+            // 消费消息
+            System.out.println(queue.poll());
+        }
+    }
+}
+```
+
+以上程序的执行结果是：
+
+```
+first message.
+second message.
+third message.
+```
+
+可以看出消息是以先进先出顺序进行消费的。
+
+实现自定义延迟队列需要实现 Delayed 接口，重写 getDelay() 方法，延迟队列完整实现代码如下：
+
+```java
+import lombok.Getter;
+import lombok.Setter;
+
+import java.text.DateFormat;
+import java.util.Date;
+import java.util.concurrent.DelayQueue;
+import java.util.concurrent.Delayed;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * 自定义延迟队列
+ */
+public class CustomDelayQueue {
+    // 延迟消息队列
+    private static DelayQueue delayQueue = new DelayQueue();
+
+    public static void main(String[] args) throws InterruptedException {
+        producer(); // 调用生产者
+        consumer(); // 调用消费者
+    }
+
+    // 生产者
+    public static void producer() {
+        // 添加消息
+        delayQueue.put(new MyDelay(1000, "消息1"));
+        delayQueue.put(new MyDelay(3000, "消息2"));
+    }
+
+    // 消费者
+    public static void consumer() throws InterruptedException {
+        System.out.println("开始执行时间：" +
+                DateFormat.getDateTimeInstance().format(new Date()));
+        while (!delayQueue.isEmpty()) {
+            System.out.println(delayQueue.take());
+        }
+        System.out.println("结束执行时间：" +
+                DateFormat.getDateTimeInstance().format(new Date()));
+    }
+
+    /**
+     * 自定义延迟队列
+     */
+    static class MyDelay implements Delayed {
+        // 延迟截止时间（单位：毫秒）
+        long delayTime = System.currentTimeMillis();
+
+        // 借助 lombok 实现
+        @Getter
+        @Setter
+        private String msg;
+
+        /**
+         * 初始化
+         * @param delayTime 设置延迟执行时间
+         * @param msg       执行的消息
+         */
+        public MyDelay(long delayTime, String msg) {
+            this.delayTime = (this.delayTime + delayTime);
+            this.msg = msg;
+        }
+
+        // 获取剩余时间
+        @Override
+        public long getDelay(TimeUnit unit) {
+            return unit.convert(delayTime - System.currentTimeMillis(), TimeUnit.MILLISECONDS);
+        }
+
+        // 队列里元素的排序依据
+        @Override
+        public int compareTo(Delayed o) {
+            if (this.getDelay(TimeUnit.MILLISECONDS) > o.getDelay(TimeUnit.MILLISECONDS)) {
+                return 1;
+            } else if (this.getDelay(TimeUnit.MILLISECONDS) < o.getDelay(TimeUnit.MILLISECONDS)) {
+                return -1;
+            } else {
+                return 0;
+            }
+        }
+
+        @Override
+        public String toString() {
+            return this.msg;
+        }
+    }
+}
+```
+
+以上程序的执行结果是：
+
+```
+开始时间:2020-6-7
+MyDelay{msg='消息1'}
+MyDelay{msg='消息2'}
+结束时间:2020-6-7
+```
+
+可以看出，消息 1 和消息 2 都实现了延迟执行的功能。
+
+# 小结
+本课时讲了消息队列的使用场景：商品秒杀、系统解耦和日志记录，我们还介绍了 RabbitMQ 以及它的消息类型和它的特点等内容，同时还使用 Queue 的子类 LinkedList 实现了自定义消息队列，使用 DelayQueue 实现了自定义延迟消息队列。
diff --git a/Java基础教程/Java面试原理/11.底层源码分析Spring的核心功能和执行流程(上).md b/Java基础教程/Java面试原理/11.底层源码分析Spring的核心功能和执行流程(上).md
new file mode 100644
index 00000000..c45d227e
--- /dev/null
+++ b/Java基础教程/Java面试原理/11.底层源码分析Spring的核心功能和执行流程(上).md
@@ -0,0 +1,422 @@
+# 底层源码分析 Spring 的核心功能和执行流程(上)
+
+Spring Framework 已是公认的 Java 标配开发框架了，甚至还有人说 Java 编程就是面向 Spring 编程的，可见 Spring 在整个 Java 体系中的重要位置。
+
+Spring 中包含了众多的功能和相关模块，比如 spring-core、spring-beans、spring-aop、spring-context、spring-expression、spring-test 等，本课时先从面试中必问的问题出发，来帮你更好的 Spring 框架。
+
+我们本课时的面试题是，Spring Bean 的作用域有哪些？它的注册方式有几种？
+
+## 典型回答
+
+在 Spring 容器中管理一个或多个 Bean，这些 Bean 的定义表示为 BeanDefinition 对象，这些对象包含以下重要信息：
+
+* Bean 的实际实现类
+* Bean 的作用范围
+* Bean 的引用或者依赖项
+
+### Bean 的三种注册方式
+
+* XML 配置文件的注册方式
+* Java 注解的注册方式
+* Java API 的注册方式
+
+#### 1. XML 配置文件注册方式
+
+```xml
+
+   
+   
+
+```
+
+#### 2. Java 注解注册方式
+
+可以使用 @Component 注解方式来注册 Bean，代码如下：
+
+```java
+@Component
+public class Person {
+   private Integer id;
+   private String name
+   // 忽略其他方法
+}
+```
+
+也可以使用 @Bean 注解方式来注册 Bean，代码如下：
+
+```java
+@Configuration
+public class Person {
+   @Bean
+   public Person  person(){
+      return new Person();
+   }
+   // 忽略其他方法
+}
+```
+
+其中 @Configuration 可理解为 XML 配置里的 `` 标签，而 @Bean 可理解为用 XML 配置里面的 `` 标签。
+
+#### 3. Java API 注册方式
+
+使用 BeanDefinitionRegistry.registerBeanDefinition() 方法的方式注册 Bean，代码如下：
+
+```java
+public class CustomBeanDefinitionRegistry implements BeanDefinitionRegistryPostProcessor {
+	@Override
+	public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException {
+	}
+	@Override
+	public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException {
+		RootBeanDefinition personBean = new RootBeanDefinition(Person.class);
+		// 新增 Bean
+		registry.registerBeanDefinition("person", personBean);
+	}
+}
+```
+
+### Bean的作用域
+
+#### 1.singleton作用域
+
+表示在 Spring 容器中只有一个 Bean 实例，以单例的形式存在，是默认的 Bean 作用域。
+
+配置方式，缺省即可，XML 的配置方式如下：
+
+```xml
+
+```
+
+#### 2. prototype作用域
+
+原型作用域，每次调用 Bean 时都会创建一个新实例，也就是说每次调用 getBean() 方法时，相当于执行了 new Bean()。
+
+XML 的配置方式如下：
+
+```xml
+
+```
+
+#### 3.request作用域
+
+每次 Http 请求时都会创建一个新的 Bean，该作用域仅适应于 WebApplicationContext 环境。
+
+XML 的配置方式如下：
+
+```xml
+
+```
+
+Java注解的配置方式如下：
+
+```java
+@Scope(WebApplicationContext.SCOPE_REQUEST)
+```
+
+或是：
+
+```java
+@RequestScope(WebApplicationContext.SCOPE_REQUEST)
+```
+
+#### 4.session作用域
+
+同一个 Http Session 共享一个 Bean 对象，不同的 Session 拥有不同的 Bean 对象，仅适用于 WebApplicationContext 环境。
+
+XML 的配置方式如下：
+
+```xml
+
+```
+
+Java注解的配置方式如下：
+
+```java
+@Scope(WebApplicationContext.SCOPE_SESSION)
+```
+
+或是:
+
+```java
+@RequestScope(WebApplicationContext.SCOPE_SESSION)
+```
+
+#### 5.application作用域
+
+全局的 Web 作用域，类似于 Servlet 中的 Application。
+
+XML 的配置方式如下：
+
+```xml
+
+```
+
+Java注解的配置方式如下：
+
+```java
+@Scope(WebApplicationContext.SCOPE_APPLICATION)
+```
+
+或是：
+
+```java
+@RequestScope(WebApplicationContext.SCOPE_APPLICATION)
+```
+
+## 考点分析
+
+在 Spring 中最核心的概念是 AOP（面向切面编程）、IOC（控制反转）、DI（依赖注入）等，而最实用的功能则是 Bean，他们是概念和具体实现的关系。和 Bean 相关的面试题，还有以下几个：
+
+* 什么是同名 Bean？它是如何产生的？应该如何避免？
+* 聊一聊 Bean 的生命周期。
+
+# 知识扩展
+
+## 1.同名Bean问题
+
+每个 Bean 拥有一个或多个标识符，在基于 XML 的配置中，我们可以使用 id 或者 name 来作为 Bean 的标识符。通常 Bean 的标识符由字母组成，允许使用特殊字符。
+
+同一个 Spring 配置文件中 Bean 的 id 和 name 是不能够重复的，否则 Spring 容器启动时会报错。但如果 Spring 加载了多个配置文件的话，可能会出现同名 Bean 的问题。同名 Bean 指的是多个 Bean 有相同的 name 或者 id。
+
+Spring 对待同名 Bean 的处理规则是使用最后面的 Bean 覆盖前面的 Bean，所以我们在定义 Bean 时，尽量使用长命名非重复的方式来定义，避免产生同名 Bean 的问题。
+
+Bean 的 id 或 name 属性并非必须指定，如果留空的话，容器会为 Bean 自动生成一个唯一的名称，这样也不会出现同名 Bean 的问题。
+
+## 2.Bean生命周期
+
+对于 Spring Bean 来说，并不是启动阶段就会触发 Bean 的实例化，只有当客户端通过显式或者隐式的方式调用 BeanFactory 的 getBean() 方法时，它才会触发该类的实例化方法。当然对于 BeanFactory 来说，也不是所有的 getBean() 方法都会实例化 Bean 对象，例如作用域为 singleton 时，只会在第一次，实例化该 Bean 对象，之后会直接返回该对象。但如果使用的是 ApplicationContext 容器，则会在该容器启动的时候，立即调用注册到该容器所有 Bean 的实例化方法。
+
+getBean() 既然是 Bean 对象的入口，我们就先从这个方法说起，getBean() 方法是属于 BeanFactory 接口的，它的真正实现是 AbstractAutowireCapableBeanFactory 的 createBean() 方法，而 createBean() 是通过 doCreateBean() 来实现的，具体源码实现如下：
+
+```java
+@Override
+protected Object createBean(String beanName, RootBeanDefinition mbd, @Nullable Object[] args)
+        throws BeanCreationException {
+    if (logger.isTraceEnabled()) {
+        logger.trace("Creating instance of bean '" + beanName + "'");
+    }
+    RootBeanDefinition mbdToUse = mbd;
+    // 确定并加载 Bean 的 class
+    Class resolvedClass = resolveBeanClass(mbd, beanName);
+    if (resolvedClass != null && !mbd.hasBeanClass() && mbd.getBeanClassName() != null) {
+        mbdToUse = new RootBeanDefinition(mbd);
+        mbdToUse.setBeanClass(resolvedClass);
+    }
+    // 验证以及准备需要覆盖的方法
+    try {
+        mbdToUse.prepareMethodOverrides();
+    }
+    catch (BeanDefinitionValidationException ex) {
+        throw new BeanDefinitionStoreException(mbdToUse.getResourceDescription(),
+                beanName, "Validation of method overrides failed", ex);
+    }
+    try {
+        // 给BeanPostProcessors 一个机会来返回代理对象来代替真正的 Bean 实例，在这里实现创建代理对象功能
+        Object bean = resolveBeforeInstantiation(beanName, mbdToUse);
+        if (bean != null) {
+            return bean;
+        }
+    }
+    catch (Throwable ex) {
+        throw new BeanCreationException(mbdToUse.getResourceDescription(), beanName,
+                "BeanPostProcessor before instantiation of bean failed", ex);
+    }
+    try {
+        // 创建 Bean
+        Object beanInstance = doCreateBean(beanName, mbdToUse, args);
+        if (logger.isTraceEnabled()) {
+            logger.trace("Finished creating instance of bean '" + beanName + "'");
+        }
+        return beanInstance;
+    }
+    catch (BeanCreationException | ImplicitlyAppearedSingletonException ex) {
+        throw ex;
+    }
+    catch (Throwable ex) {
+        throw new BeanCreationException(
+                mbdToUse.getResourceDescription(), beanName, "Unexpected exception during bean creation", ex);
+    }
+}
+```
+
+doCreateBean 源码如下：
+
+```java
+protected Object doCreateBean(final String beanName, final RootBeanDefinition mbd, final @Nullable Object[] args)
+        throws BeanCreationException {
+    // 实例化 bean，BeanWrapper 对象提供了设置和获取属性值的功能
+    BeanWrapper instanceWrapper = null;
+    // 如果 RootBeanDefinition 是单例，则移除未完成的 FactoryBean 实例的缓存
+    if (mbd.isSingleton()) {
+        instanceWrapper = this.factoryBeanInstanceCache.remove(beanName);
+    }
+    if (instanceWrapper == null) {
+        // 创建 bean 实例
+        instanceWrapper = createBeanInstance(beanName, mbd, args);
+    }
+    // 获取 BeanWrapper 中封装的 Object 对象，其实就是 bean 对象的实例
+    final Object bean = instanceWrapper.getWrappedInstance();
+    // 获取 BeanWrapper 中封装 bean 的 Class
+    Class beanType = instanceWrapper.getWrappedClass();
+    if (beanType != NullBean.class) {
+        mbd.resolvedTargetType = beanType;
+    }
+    // 应用 MergedBeanDefinitionPostProcessor 后处理器，合并 bean 的定义信息
+    // Autowire 等注解信息就是在这一步完成预解析，并且将注解需要的信息放入缓存
+    synchronized (mbd.postProcessingLock) {
+        if (!mbd.postProcessed) {
+            try {
+                applyMergedBeanDefinitionPostProcessors(mbd, beanType, beanName);
+            } catch (Throwable ex) {
+                throw new BeanCreationException(mbd.getResourceDescription(), beanName,
+                        "Post-processing of merged bean definition failed", ex);
+            }
+            mbd.postProcessed = true;
+        }
+    }
+    boolean earlySingletonExposure = (mbd.isSingleton() && this.allowCircularReferences &&
+            isSingletonCurrentlyInCreation(beanName));
+    if (earlySingletonExposure) {
+        if (logger.isTraceEnabled()) {
+            logger.trace("Eagerly caching bean '" + beanName +
+                    "' to allow for resolving potential circular references");
+        }
+        // 为了避免循环依赖，在 bean 初始化完成前，就将创建 bean 实例的 ObjectFactory 放入工厂缓存（singletonFactories）
+        addSingletonFactory(beanName, () -> getEarlyBeanReference(beanName, mbd, bean));
+    }
+    // 对 bean 属性进行填充
+    Object exposedObject = bean;
+    try {
+        populateBean(beanName, mbd, instanceWrapper);
+        // 调用初始化方法，如 init-method 注入 Aware 对象
+        exposedObject = initializeBean(beanName, exposedObject, mbd);
+    } catch (Throwable ex) {
+        if (ex instanceof BeanCreationException && beanName.equals(((BeanCreationException) ex).getBeanName())) {
+            throw (BeanCreationException) ex;
+        } else {
+            throw new BeanCreationException(
+                    mbd.getResourceDescription(), beanName, "Initialization of bean failed", ex);
+        }
+    }
+    if (earlySingletonExposure) {
+        // 如果存在循环依赖，也就是说该 bean 已经被其他 bean 递归加载过，放入了提早公布的 bean 缓存中
+        Object earlySingletonReference = getSingleton(beanName, false);
+        if (earlySingletonReference != null) {
+            // 如果 exposedObject 没有在 initializeBean 初始化方法中被增强
+            if (exposedObject == bean) {
+                exposedObject = earlySingletonReference;
+            } else if (!this.allowRawInjectionDespiteWrapping && hasDependentBean(beanName)) {
+                // 依赖检测
+                String[] dependentBeans = getDependentBeans(beanName);
+                Set actualDependentBeans = new LinkedHashSet<>(dependentBeans.length);
+                for (String dependentBean : dependentBeans) {
+                    if (!removeSingletonIfCreatedForTypeCheckOnly(dependentBean)) {
+                        actualDependentBeans.add(dependentBean);
+                    }
+                }
+                // 如果 actualDependentBeans 不为空，则表示依赖的 bean 并没有被创建完，即存在循环依赖
+                if (!actualDependentBeans.isEmpty()) {
+                    throw new BeanCurrentlyInCreationException(beanName,
+                            "Bean with name '" + beanName + "' has been injected into other beans [" +
+                                    StringUtils.collectionToCommaDelimitedString(actualDependentBeans) +
+                                    "] in its raw version as part of a circular reference, but has eventually been " +
+                                    "wrapped. This means that said other beans do not use the final version of the " +
+                                    "bean. This is often the result of over-eager type matching - consider using " +
+                                    "'getBeanNamesOfType' with the 'allowEagerInit' flag turned off, for example.");
+                }
+            }
+        }
+    }
+    try {
+        // 注册 DisposableBean 以便在销毁时调用
+        registerDisposableBeanIfNecessary(beanName, bean, mbd);
+    } catch (BeanDefinitionValidationException ex) {
+        throw new BeanCreationException(
+                mbd.getResourceDescription(), beanName, "Invalid destruction signature", ex);
+    }
+    return exposedObject;
+}
+```
+
+从上述源码中可以看出，在 doCreateBean() 方法中，首先对 Bean 进行了实例化工作，它是通过调用 createBeanInstance() 方法来实现的，该方法返回一个 BeanWrapper 对象。BeanWrapper 对象是 Spring 中一个基础的 Bean 接口，说它是基础接口是因为它连基本的属性都没有。
+
+BeanWrapper 接口有一个默认实现类 BeanWrapperImpl，其主要作用是对 Bean 进行填充，比如填充和注入 Bean 的属性等。
+
+当 Spring 完成 Bean 对象实例化并且设置完相关属性和依赖后，则会调用 Bean 的初始化方法 initializeBean()，初始化第一个阶段是检查当前 Bean 对象是否实现了 BeanNameAware、BeanClassLoaderAware、BeanFactoryAware 等接口，源码如下：
+
+```java
+private void invokeAwareMethods(final String beanName, final Object bean) {
+    if (bean instanceof Aware) {
+        if (bean instanceof BeanNameAware) {
+            ((BeanNameAware) bean).setBeanName(beanName);
+        }
+        if (bean instanceof BeanClassLoaderAware) {
+            ClassLoader bcl = getBeanClassLoader();
+            if (bcl != null) {
+                ((BeanClassLoaderAware) bean).setBeanClassLoader(bcl);
+            }
+        }
+        if (bean instanceof BeanFactoryAware) {
+            ((BeanFactoryAware) bean).setBeanFactory(AbstractAutowireCapableBeanFactory.this);
+        }
+    }
+}
+```
+
+其中，BeanNameAware 是把 Bean 对象定义的 beanName 设置到当前对象实例中；
+
+BeanClassLoaderAware 是将当前 Bean 对象相应的 ClassLoader 注入到当前对象实例中；
+
+BeanFactoryAware 是 BeanFactory 容器会将自身注入到当前对象实例中，这样当前对象就会拥有一个 BeanFactory 容器的引用。
+
+初始化第二个阶段则是 BeanPostProcessor 增强处理，它主要是对 Spring 容器提供的 Bean 实例对象进行有效的扩展，允许 Spring 在初始化 Bean 阶段对其进行定制化修改，比如处理标记接口或者为其提供代理实现。
+
+在初始化的前置处理完成之后就会检查和执行 InitializingBean 和 init-method 方法。
+
+InitializingBean 是一个接口，它有一个 afterPropertiesSet() 方法，在 Bean 初始化时会判断当前 Bean 是否实现了 InitializingBean，如果实现了则调用 afterPropertiesSet() 方法，进行初始化工作；然后再检查是否也指定了 init-method，如果指定了则通过反射机制调用指定的 init-method 方法，它的实现源码如下：
+
+```java
+protected void invokeInitMethods(String beanName, final Object bean, @Nullable RootBeanDefinition mbd)
+        throws Throwable {
+    // 判断当前 Bean 是否实现了 InitializingBean，如果是的话需要调用 afterPropertiesSet()
+    boolean isInitializingBean = (bean instanceof InitializingBean);
+    if (isInitializingBean && (mbd == null || !mbd.isExternallyManagedInitMethod("afterPropertiesSet"))) {
+        if (logger.isTraceEnabled()) {
+            logger.trace("Invoking afterPropertiesSet() on bean with name '" + beanName + "'");
+        }
+        if (System.getSecurityManager() != null) { // 安全模式
+            try {
+                AccessController.doPrivileged((PrivilegedExceptionAction) () -> {
+                    ((InitializingBean) bean).afterPropertiesSet(); // 属性初始化
+                    return null;
+                }, getAccessControlContext());
+            } catch (PrivilegedActionException pae) {
+                throw pae.getException();
+            }
+        } else {
+            ((InitializingBean) bean).afterPropertiesSet(); // 属性初始化
+        }
+    }
+    // 判断是否指定了 init-method()
+    if (mbd != null && bean.getClass() != NullBean.class) {
+        String initMethodName = mbd.getInitMethodName();
+        if (StringUtils.hasLength(initMethodName) &&
+                !(isInitializingBean && "afterPropertiesSet".equals(initMethodName)) &&
+                !mbd.isExternallyManagedInitMethod(initMethodName)) {
+            // 利用反射机制执行指定方法
+            invokeCustomInitMethod(beanName, bean, mbd);
+        }
+    }
+}
+```
+
+初始化完成之后就可以正常的使用 Bean 对象了，在 Spring 容器关闭时会执行销毁方法，但是 Spring 容器不会自动去调用销毁方法，而是需要我们主动的调用。
+
+如果是 BeanFactory 容器，那么我们需要主动调用 destroySingletons() 方法，通知 BeanFactory 容器去执行相应的销毁方法；如果是 ApplicationContext 容器，那么我们需要主动调用 registerShutdownHook() 方法，告知 ApplicationContext 容器执行相应的销毁方法。
+
+> 注：本课时源码基于 Spring 5.2.2.RELEASE。
+
+# 小结
+ Bean 的三种注册方式：XML、Java 注解和 JavaAPI，以及 Bean 的五个作用域：singleton、prototype、request、session 和 application；还讲了读取多个配置文件可能会出现同名 Bean 的问题，以及通过源码讲了 Bean 执行的生命周期，它的生命周期如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200612141655.png)
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/12.底层源码分析 Spring 的核心功能和执行流程(下).md b/Java基础教程/Java面试原理/12.底层源码分析 Spring 的核心功能和执行流程(下).md
new file mode 100644
index 00000000..cc51ae5d
--- /dev/null
+++ b/Java基础教程/Java面试原理/12.底层源码分析 Spring 的核心功能和执行流程(下).md	
@@ -0,0 +1,366 @@
+# 底层源码分析 Spring 的核心功能和执行流程(下)
+
+上一课时我们讲了 Bean 相关的内容，它其实也是属于 IOC 的具体实现之一，本课时我们就来讲讲 Spring 中其他几个高频的面试点，希望能起到抛砖引玉的作用，能为你理解 Spring 打开一扇门。因为 Spring 涉及的内容和知识点太多了，用它来写一本书也绰绰有余，因此这里我们只讲核心的内容，希望下来你能查漏补缺，完善自己的 Spring 技术栈。
+
+我们本课时的面试题是，谈一谈你对 IOC 和 DI 的理解。
+
+## 典型回答
+
+**IOC**（Inversion of Control，翻译为“控制反转”）不是一个具体的技术，而是一种设计思想。与传统控制流相比，IOC 会颠倒控制流，在传统的编程中需要开发者自行创建并销毁对象，而在 IOC 中会把这些操作交给框架来处理，这样开发者就不用关注具体的实现细节了，拿来直接用就可以了，这就是控制反转。
+
+IOC 很好的体现出了面向对象的设计法则之一——好莱坞法则：“别找我们，我们找你”。即由 IOC 容器帮对象找到相应的依赖对象并注入，而不是由对象主动去找。
+
+举个例子，比如说传统找对象，先要设定好你的要求，如身高、体重、长相等，然后再一个一个的主动去找符合要求的对象，而 IOC 相当于，你把这些要求直接告诉婚介中心，由他们直接给你匹配到符合要求的对象，理想情况下是直接会帮你找到合适的对象，这就是传统编程模式和 IOC 的区别。
+
+**DI**（Dependency Injection，翻译为“依赖注入”）表示组件间的依赖关系交由容器在运行期自动生成，也就是说，由容器动态的将某个依赖关系注入到组件之中，这样就能提升组件的重用频率。通过依赖注入机制，我们只需要通过简单的配置，就可指定目标需要的资源，完成自身的业务逻辑，而不需要关心资源来自哪里、由谁实现等问题。
+
+IOC 和 DI 其实是同一个概念从不同角度的描述的，由于控制反转这个概念比较含糊（可能只理解成了容器控制对象这一个层面，很难让人想到谁来维护对象关系），所以 2004 年被开发者尊称为“教父”的 Martin Fowler（世界顶级专家，敏捷开发方法的创始人之一）又给出了一个新的名字“依赖注入”，相对 IOC 而言，“依赖注入”明确描述了“被注入对象依赖 IOC 容器配置依赖对象”。
+
+## 考点分析
+
+IOC 和 DI 为 Spring 框架设计的精髓所在，也是面试中必问的考点之一，这个优秀的设计思想对于初学者来说可能理解起来比较困难，但对于 Spring 的使用者来说可以很快的看懂。因此如果对于此概念还有疑问的话，建议先上手使用 Spring 实现几个小功能再回头来看这些概念，相信你会豁然开朗。
+
+Spring 相关的高频面试题，还有以下这些：
+
+* Spring IOC 有哪些优势？
+* IOC 的注入方式有哪些？
+* 谈一谈你对 AOP 的理解。
+
+# 知识扩展
+
+## 1.Spring IOC 的优点
+IOC 的优点有以下几个：
+
+* 使用更方便，拿来即用，无需显式的创建和销毁的过程；
+* 可以很容易提供众多服务，比如事务管理、消息服务等；
+* 提供了单例模式的支持；
+* 提供了 AOP 抽象，利用它很容易实现权限拦截、运行期监控等功能；
+* 更符合面向对象的设计法则；
+* 低侵入式设计，代码的污染极低，降低了业务对象替换的复杂性。
+
+## 2.Spring IOC 注入方式汇总
+IOC 的注入方式有三种：构造方法注入、Setter 注入和接口注入。
+
+### 1.构造方法注入
+
+构造方法注入主要是依赖于构造方法去实现，构造方法可以是有参的也可以是无参的，我们平时 new 对象时就是通过类的构造方法来创建类对象的，每个类对象默认会有一个无参的构造方法，Spring 通过构造方法注入的代码示例如下：
+
+```java
+public class Person {
+    public Person() {
+	}
+	public Person(int id, String name) {
+		this.id = id;
+		this.name = name;
+	}
+	private int id;
+	private String name;
+    // 忽略 Setter、Getter 的方法
+}
+```
+
+applicationContext.xml 配置如下：
+
+```xml
+
+    
+    
+
+```
+
+### 2.Setter注入
+
+Setter 方法注入的方式是目前 Spring 主流的注入方式，它可以利用 Java Bean 规范所定义的 Setter/Getter 方法来完成注入，可读性和灵活性都很高，它不需要使用声明式构造方法，而是使用 Setter 注入直接设置相关的值，实现示例如下：
+
+```xml
+
+    
+    
+
+```
+
+### 3.接口注入
+
+接口注入方式是比较古老的注入方式，因为它需要被依赖的对象实现不必要的接口，带有侵入性，因此现在已经被完全舍弃了，所以本文也不打算做过多的描述，大家只要知道有这回事就行了。
+
+## 3.Spring AOP
+
+AOP（Aspect-Oriented-Programming，面向切面编程）可以说是 OOP（Object-Oriented Programing，面向对象编程）的补充和完善，OOP 引入封装、继承和多态性等概念来建立一种公共对象处理的能力，当我们需要处理公共行为的时候，OOP 就会显得无能为力，而 AOP 的出现正好解决了这个问题。比如统一的日志处理模块、授权验证模块等都可以使用 AOP 很轻松的处理。
+
+Spring AOP 目前提供了三种配置方式：
+
+* 基于 Java API 的方式；
+* 基于 @AspectJ（Java）注解的方式；
+* 基于 XML`  `标签的方式。
+
+### 1.基于Java API的方式
+
+此配置方式需要实现相关的接口，例如 `MethodBeforeAdvice` 和 `AfterReturningAdvice`，并且在 XML 配置中定义相应的规则即可实现。
+
+我们先来定义一个实体类，代码如下：
+
+```java
+package org.springframework.beans;
+
+
+public class Person {
+   public Person findPerson() {
+      Person person = new Person(1, "JDK");
+      System.out.println("findPerson 被执行");
+      return person;
+   }
+   public Person() {
+   }
+   public Person(Integer id, String name) {
+      this.id = id;
+      this.name = name;
+   }
+   private Integer id;
+   private String name;
+   // 忽略 Getter、Setter 方法
+}
+```
+
+再定义一个 advice 类，用于对拦截方法的调用之前和调用之后进行相关的业务处理，实现代码如下：
+
+```java
+import org.springframework.aop.AfterReturningAdvice;
+import org.springframework.aop.MethodBeforeAdvice;
+
+import java.lang.reflect.Method;
+
+public class MyAdvice implements MethodBeforeAdvice, AfterReturningAdvice {
+   @Override
+   public void before(Method method, Object[] args, Object target) throws Throwable {
+      System.out.println("准备执行方法: " + method.getName());
+   }
+
+   @Override
+   public void afterReturning(Object returnValue, Method method, Object[] args, Object target) throws Throwable {
+      System.out.println(method.getName() + " 方法执行结束");
+   }
+```
+
+然后需要在 application.xml 文件中配置相应的拦截规则，配置如下：
+
+```xml
+
+
+
+
+    
+    
+
+
+
+
+```
+
+从以上配置中可以看出，我们需要配置一个拦截方法的规则，然后定义一个 DefaultAdvisorAutoProxyCreator 让所有的 advisor 配置自动生效。
+
+最后，我们使用测试代码来完成调用：
+
+```java
+public class MyApplication {
+   public static void main(String[] args) {
+      ApplicationContext context =
+            new ClassPathXmlApplicationContext("classpath*:application.xml");
+      Person person = context.getBean("person", Person.class);
+      person.findPerson();
+   }
+}
+```
+
+以上程序的执行结果为：
+
+```
+准备执行方法: findPerson
+findPerson 被执行
+findPerson 方法执行结束
+```
+
+可以看出 AOP 的拦截已经成功了。
+
+### 2.基于@AspectJ注解的方式
+
+首先需要在项目中添加 aspectjweaver 的 jar 包，配置如下：
+
+```xml
+
+
+    org.aspectj
+    aspectjweaver
+    1.9.5
+
+```
+
+此 jar 包来自于 AspectJ，因为 Spring 使用了 AspectJ 提供的一些注解，因此需要添加此 jar 包。之后，我们需要开启 @AspectJ 的注解，开启方式有两种。
+
+可以在 application.xml 配置如下代码中开启 @AspectJ 的注解：
+
+```xml
+
+```
+
+也可以使用 `@EnableAspectJAutoProxy`注解开启，代码如下：
+
+```java
+@Configuration
+@EnableAspectJAutoProxy
+public class AppConfig {
+}
+```
+
+之后我们需要声明拦截器的类和拦截方法，以及配置相应的拦截规则，代码如下：
+
+```java
+import org.aspectj.lang.annotation.After;
+import org.aspectj.lang.annotation.Aspect;
+import org.aspectj.lang.annotation.Before;
+import org.aspectj.lang.annotation.Pointcut;
+
+@Aspect
+public class MyAspectJ {
+
+   // 配置拦截类 Person
+   @Pointcut("execution(* org.springframework.beans.Person.*(..))")
+   public void pointCut() {
+   }
+
+   @Before("pointCut()")
+   public void doBefore() {
+      System.out.println("执行 doBefore 方法");
+   }
+
+   @After("pointCut()")
+   public void doAfter() {
+      System.out.println("执行 doAfter 方法");
+   }
+}
+```
+
+然后我们只需要在 application.xml 配置中添加注解类，配置如下：
+
+```xml
+
+```
+
+紧接着，我们添加一个需要拦截的方法：
+
+```java
+package org.springframework.beans;
+
+// 需要拦截的 Bean
+public class Person {
+   public Person findPerson() {
+      Person person = new Person(1, "JDK");
+      System.out.println("执行 findPerson 方法");
+      return person;
+   }
+    // 获取其他方法
+}
+```
+
+最后，我们开启测试代码：
+
+```java
+import org.springframework.beans.Person;
+import org.springframework.context.ApplicationContext;
+import org.springframework.context.support.ClassPathXmlApplicationContext;
+
+public class MyApplication {
+   public static void main(String[] args) {
+      ApplicationContext context =
+            new ClassPathXmlApplicationContext("classpath*:application.xml");
+      Person person = context.getBean("person", Person.class);
+      person.findPerson();
+   }
+}
+```
+
+以上程序的执行结果为：
+
+```
+执行 doBefore 方法
+执行 findPerson 方法
+执行 doAfter 方法
+```
+
+可以看出 AOP 拦截成功了。
+
+### 3.基于 XML `` 标签的方式
+
+基于 XML 的方式与基于注解的方式类似，只是无需使用注解，把相关信息配置到 application.xml 中即可，配置如下：
+
+```xml
+
+
+
+    
+    
+    
+    
+        
+        
+    
+
+```
+
+之后，添加一个普通的类来进行拦截业务的处理，实现代码如下：
+
+```java
+public class MyPointcut {
+   public void doBefore() {
+      System.out.println("执行 doBefore 方法");
+   }
+   public void doAfter() {
+      System.out.println("执行 doAfter 方法");
+   }
+}
+```
+
+拦截的方法和测试代码与第二种注解的方式相同，这里就不在赘述。
+
+最后执行程序，执行结果为：
+
+```
+执行 doBefore 方法
+执行 findPerson 方法
+执行 doAfter 方法
+```
+
+可以看出 AOP 拦截成功了。
+
+Spring AOP 的原理其实很简单，它其实就是一个动态代理，我们在调用 getBean() 方法的时候返回的其实是代理类的实例，而这个代理类在 Spring 中使用的是 JDK Proxy 或 CgLib 实现的，它的核心代码在 DefaultAopProxyFactory#createAopProxy(...) 中，源码如下：
+
+```java
+public class DefaultAopProxyFactory implements AopProxyFactory, Serializable {
+
+	@Override
+	public AopProxy createAopProxy(AdvisedSupport config) throws AopConfigException {
+		if (config.isOptimize() || config.isProxyTargetClass() || hasNoUserSuppliedProxyInterfaces(config)) {
+			Class targetClass = config.getTargetClass();
+			if (targetClass == null) {
+				throw new AopConfigException("TargetSource cannot determine target class: " +
+						"Either an interface or a target is required for proxy creation.");
+			}
+            // 判断目标类是否为接口
+			if (targetClass.isInterface() || Proxy.isProxyClass(targetClass)) {
+                // 是接口使用 jdk 的代理
+				return new JdkDynamicAopProxy(config);
+			}
+            // 其他情况使用 CgLib 代理
+			return new ObjenesisCglibAopProxy(config);
+		}
+		else {
+			return new JdkDynamicAopProxy(config);
+		}
+	}
+    // 忽略其他代码
+}
+```
+
+# 小结
+
+本课时讲了 IOC 和 DI 概念，以及 IOC 的优势和 IOC 注入的三种方式：构造方法注入、Setter 注入和接口注入，最后讲了 Spring AOP 的概念与它的三种配置方式：基于 Java API 的方式、基于 Java 注解的方式和基于 XML 标签的方式。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/13.MyBatis使用了哪些设计模式？在源码中是如何体现的？.md b/Java基础教程/Java面试原理/13.MyBatis使用了哪些设计模式？在源码中是如何体现的？.md
new file mode 100644
index 00000000..68d37104
--- /dev/null
+++ b/Java基础教程/Java面试原理/13.MyBatis使用了哪些设计模式？在源码中是如何体现的？.md
@@ -0,0 +1,314 @@
+# MyBatis 使用了哪些设计模式？在源码中是如何体现的？
+
+MyBatis 的前身是 IBatis，IBatis 是由 Internet 和 Abatis 组合而成，其目的是想当做互联网的篱笆墙，围绕着数据库提供持久化服务的一个框架，2010 年正式改名为 MyBatis。它是一款优秀的持久层框架，支持自定义 SQL、存储过程及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作，还可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Ordinary Java Object，普通 Java 对象）为数据库中的记录。
+
+关于 MyBatis 的介绍与使用，官方已经提供了比较详尽的中文参考文档，可点击这里查看，而本课时则以面试的角度出发，聊一聊不一样的知识点，它也是 MyBatis 比较热门的面试题之一，MyBatis 使用了哪些设计模式？在源码中是如何体现的？
+
+注意：本课时使用的 MyBatis 源码为 3.5.5。
+
+## 典型回答
+
+### 1.工厂模式
+工厂模式想必都比较熟悉，它是 Java 中最常用的设计模式之一。工厂模式就是提供一个工厂类，当有客户端需要调用的时候，只调用这个工厂类就可以得到自己想要的结果，从而无需关注某类的具体实现过程。这就好比你去餐馆吃饭，可以直接点菜，而不用考虑厨师是怎么做的。
+
+工厂模式在 MyBatis 中的典型代表是 SqlSessionFactory。
+
+SqlSession 是 MyBatis 中的重要 Java 接口，可以通过该接口来执行 SQL 命令、获取映射器示例和管理事务，而 SqlSessionFactory 正是用来产生 SqlSession 对象的，所以它在 MyBatis 中是比较核心的接口之一。
+
+工厂模式应用解析：SqlSessionFactory 是一个接口类，它的子类 DefaultSqlSessionFactorys 有一个 openSession(ExecutorType execType) 的方法，其中使用了工厂模式，源码如下：
+
+```java
+private SqlSession openSessionFromDataSource(ExecutorType execType, TransactionIsolationLevel level, boolean autoCommit) {
+    Transaction tx = null;
+    try {
+        final Environment environment = configuration.getEnvironment();
+        final TransactionFactory transactionFactory = getTransactionFactoryFromEnvironment(environment);
+        tx = transactionFactory.newTransaction(environment.getDataSource(), level, autoCommit);
+        final Executor executor = configuration.newExecutor(tx, execType);
+        return new DefaultSqlSession(configuration, executor, autoCommit);
+    } catch (Exception e) {
+        closeTransaction(tx); 
+        throw ExceptionFactory.wrapException("Error opening session.  Cause: " + e, e);
+    } finally {
+        ErrorContext.instance().reset();
+    }
+}
+```
+
+从该方法我们可以看出它会 configuration.newExecutor(tx, execType) 读取对应的环境配置，而此方法的源码如下：
+
+```java
+public Executor newExecutor(Transaction transaction, ExecutorType executorType) {
+    executorType = executorType == null ? defaultExecutorType : executorType;
+    executorType = executorType == null ? ExecutorType.SIMPLE : executorType;
+    Executor executor;
+    if (ExecutorType.BATCH == executorType) {
+        executor = new BatchExecutor(this, transaction);
+    } else if (ExecutorType.REUSE == executorType) {
+        executor = new ReuseExecutor(this, transaction);
+    } else {
+        executor = new SimpleExecutor(this, transaction);
+    }
+    if (cacheEnabled) {
+        executor = new CachingExecutor(executor);
+    }
+    executor = (Executor) interceptorChain.pluginAll(executor);
+    return executor;
+}
+```
+
+可以看出 newExecutor() 方法为标准的工厂模式，它会根据传递 ExecutorType 值生成相应的对象然后进行返回。
+
+### 2.建造者模式（Builder）
+建造者模式指的是将一个复杂对象的构建与它的表示分离，使得同样的构建过程可以创建不同的表示。也就是说建造者模式是通过多个模块一步步实现了对象的构建，相同的构建过程可以创建不同的产品。
+
+例如，组装电脑，最终的产品就是一台主机，然而不同的人对它的要求是不同的，比如设计人员需要显卡配置高的；而影片爱好者则需要硬盘足够大的（能把视频都保存起来），但对于显卡却没有太大的要求，我们的装机人员根据每个人不同的要求，组装相应电脑的过程就是建造者模式。
+
+建造者模式在 MyBatis 中的典型代表是 SqlSessionFactoryBuilder。
+
+普通的对象都是通过 new 关键字直接创建的，但是如果创建对象需要的构造参数很多，且不能保证每个参数都是正确的或者不能一次性得到构建所需的所有参数，那么就需要将构建逻辑从对象本身抽离出来，让对象只关注功能，把构建交给构建类，这样可以简化对象的构建，也可以达到分步构建对象的目的，而 SqlSessionFactoryBuilder 的构建过程正是如此。
+
+在 SqlSessionFactoryBuilder 中构建 SqlSessionFactory 对象的过程是这样的，首先需要通过 XMLConfigBuilder 对象读取并解析 XML 的配置文件，然后再将读取到的配置信息存入到 Configuration 类中，然后再通过 build 方法生成我们需要的 DefaultSqlSessionFactory 对象，实现源码如下（在 SqlSessionFactoryBuilder 类中）：
+
+```java
+public SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) {
+    try {
+        XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties);
+        return build(parser.parse());
+    } catch (Exception e) {
+        throw ExceptionFactory.wrapException("Error building SqlSession.", e);
+    } finally {
+        ErrorContext.instance().reset();
+        try {
+        inputStream.close();
+        } catch (IOException e) {
+        // Intentionally ignore. Prefer previous error.
+        }
+    }
+}
+public SqlSessionFactory build(Configuration config) {
+    return new DefaultSqlSessionFactory(config);
+}
+```
+
+SqlSessionFactoryBuilder 类相当于一个建造工厂，先读取文件或者配置信息、再解析配置、然后通过反射生成对象，最后再把结果存入缓存，这样就一步步构建造出一个 SqlSessionFactory 对象。
+
+### 3.单例模式
+单例模式（Singleton Pattern）是 Java 中最简单的设计模式之一，此模式保证某个类在运行期间，只有一个实例对外提供服务，而这个类被称为单例类。
+
+单例模式也比较好理解，比如一个人一生当中只能有一个真实的身份证号，每个收费站的窗口都只能一辆车子一辆车子的经过，类似的场景都是属于单例模式。
+
+单例模式在 MyBatis 中的典型代表是 ErrorContext。
+
+ErrorContext 是线程级别的的单例，每个线程中有一个此对象的单例，用于记录该线程的执行环境的错误信息。
+
+ErrorContext 的实现源码如下：
+
+```java
+public class ErrorContext {
+  private static final String LINE_SEPARATOR = System.lineSeparator();
+  // 每个线程存储的容器
+  private static final ThreadLocal LOCAL = ThreadLocal.withInitial(ErrorContext::new);
+  public static ErrorContext instance() {
+    return LOCAL.get();
+  }
+  // 忽略其他
+}
+```
+
+可以看出 ErrorContext 使用 private 修饰的 ThreadLocal 来保证每个线程拥有一个 ErrorContext 对象，在调用 instance() 方法时再从 ThreadLocal 中获取此单例对象。
+
+### 4.适配器模式
+适配器模式是指将一个不兼容的接口转换成另一个可以兼容的接口，这样就可以使那些不兼容的类可以一起工作。
+
+例如，最早之前我们用的耳机都是圆形的，而现在大多数的耳机和电源都统一成了方形的 typec 接口，那之前的圆形耳机就不能使用了，只能买一个适配器把圆形接口转化成方形的，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613153121.png)
+
+而这个转换头就相当于程序中的适配器模式，适配器模式在 MyBatis 中的典型代表是 Log。
+
+MyBatis 中的日志模块适配了以下多种日志类型：
+
+* SLF4J
+* Apache Commons Logging
+* Log4j 2
+* Log4j
+* JDK logging
+
+首先 MyBatis 定义了一个 Log 的接口，用于统一和规范接口的行为，源码如下：
+
+```java
+public interface Log {
+  boolean isDebugEnabled();
+  boolean isTraceEnabled();
+  void error(String s, Throwable e);
+  void error(String s);
+  void debug(String s);
+  void trace(String s);
+  void warn(String s);
+}
+```
+
+然后 MyBatis 定义了多个适配接口，例如 Log4j2 实现源码如下：
+
+```java
+public class Log4j2Impl implements Log {
+  private final Log log;
+  public Log4j2Impl(String clazz) {
+    Logger logger = LogManager.getLogger(clazz);
+    if (logger instanceof AbstractLogger) {
+      log = new Log4j2AbstractLoggerImpl((AbstractLogger) logger);
+    } else {
+      log = new Log4j2LoggerImpl(logger);
+    }
+  }
+  @Override
+  public boolean isDebugEnabled() {
+    return log.isDebugEnabled();
+  }
+  @Override
+  public boolean isTraceEnabled() {
+    return log.isTraceEnabled();
+  }
+  @Override
+  public void error(String s, Throwable e) {
+    log.error(s, e);
+  }
+  @Override
+  public void error(String s) {
+    log.error(s);
+  }
+  @Override
+  public void debug(String s) {
+    log.debug(s);
+  }
+  @Override
+  public void trace(String s) {
+    log.trace(s);
+  }
+  @Override
+  public void warn(String s) {
+    log.warn(s);
+  }
+}
+```
+
+这样当你项目中添加了 Log4j2 时，MyBatis 就可以直接使用它打印 MyBatis 的日志信息了。Log 的所有子类如下图所示：![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613153328.png)
+
+### 5.代理模式
+代理模式指的是给某一个对象提供一个代理对象，并由代理对象控制原对象的调用。
+
+代理模式在生活中也比较常见，比如我们常见的超市、小卖店其实都是一个个“代理”，他们的最上游是一个个生产厂家，他们这些代理负责把厂家生产出来的产品卖出去。
+
+代理模式在 MyBatis 中的典型代表是 MapperProxyFactory。
+
+MapperProxyFactory 的 newInstance() 方法就是生成一个具体的代理来实现功能的，源码如下：
+
+```java
+public class MapperProxyFactory {
+  private final Class mapperInterface;
+  private final Map methodCache = new ConcurrentHashMap<>();
+  public MapperProxyFactory(Class mapperInterface) {
+    this.mapperInterface = mapperInterface;
+  }
+  public Class getMapperInterface() {
+    return mapperInterface;
+  }
+  public Map getMethodCache() {
+    return methodCache;
+  }
+  // 创建代理类
+  @SuppressWarnings("unchecked")
+  protected T newInstance(MapperProxy mapperProxy) {
+    return (T) Proxy.newProxyInstance(mapperInterface.getClassLoader(), new Class[] { mapperInterface }, mapperProxy);
+  }
+  public T newInstance(SqlSession sqlSession) {
+    final MapperProxy mapperProxy = new MapperProxy<>(sqlSession, mapperInterface, methodCache);
+    return newInstance(mapperProxy);
+  }
+}
+```
+
+### 6.模板方法模式
+模板方法模式是最常用的设计模式之一，它是指定义一个操作算法的骨架，而将一些步骤的实现延迟到子类中去实现，使得子类可以不改变一个算法的结构即可重定义该算法的某些特定步骤。此模式是基于继承的思想实现代码复用的。
+
+例如，我们喝茶的一般步骤都是这样的：
+
+* 把热水烧开
+* 把茶叶放入壶中
+* 等待一分钟左右
+* 把茶倒入杯子中
+* 喝茶
+
+整个过程都是固定的，唯一变的就是泡入茶叶种类的不同，比如今天喝的是绿茶，明天可能喝的是红茶，那么我们就可以把流程定义为一个模板，而把茶叶的种类延伸到子类中去实现，这就是模板方法的实现思路。
+
+模板方法在 MyBatis 中的典型代表是 BaseExecutor。
+
+在 MyBatis 中 BaseExecutor 实现了大部分 SQL 执行的逻辑，然后再把几个方法交给子类来实现，它的继承关系如下图所示：![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613153623.png)
+
+比如 doUpdate() 就是交给子类自己去实现的，它在 BaseExecutor 中的定义如下：
+
+```java
+protected abstract int doUpdate(MappedStatement ms, Object parameter) throws SQLException;
+```
+
+在 SimpleExecutor 中的实现如下：
+
+```java
+public class SimpleExecutor extends BaseExecutor {
+  // 构造方法
+  public SimpleExecutor(Configuration configuration, Transaction transaction) {
+    super(configuration, transaction);
+  }
+  // 更新方法
+  @Override
+  public int doUpdate(MappedStatement ms, Object parameter) throws SQLException {
+    Statement stmt = null;
+    try {
+      Configuration configuration = ms.getConfiguration();
+      StatementHandler handler = configuration.newStatementHandler(this, ms, parameter, RowBounds.DEFAULT, null, null);
+      stmt = prepareStatement(handler, ms.getStatementLog());
+      return handler.update(stmt);
+    } finally {
+      closeStatement(stmt);
+    }
+  }
+  // 忽略其他代码...
+}
+```
+
+可以看出 SimpleExecutor 每次使用完 Statement 对象之后，都会把它关闭掉，而 ReuseExecutor 中的实现源码如下：
+
+```java
+public class ReuseExecutor extends BaseExecutor {
+  private final Map statementMap = new HashMap<>();
+  public ReuseExecutor(Configuration configuration, Transaction transaction) {
+    super(configuration, transaction);
+  }
+  // 更新方法
+  @Override
+  public int doUpdate(MappedStatement ms, Object parameter) throws SQLException {
+    Configuration configuration = ms.getConfiguration();
+    StatementHandler handler = configuration.newStatementHandler(this, ms, parameter, RowBounds.DEFAULT, null, null);
+    Statement stmt = prepareStatement(handler, ms.getStatementLog());
+    return handler.update(stmt);
+  }
+  // 忽略其他代码...
+}
+```
+
+可以看出，ReuseExecutor 每次使用完 Statement 对象之后不会把它关闭掉。
+
+### 7.装饰器模式
+装饰器模式允许向一个现有的对象添加新的功能，同时又不改变其结构，这种类型的设计模式属于结构型模式，它是作为现有类的一个包装。
+
+装饰器模式在生活中很常见，比如装修房子，我们在不改变房子结构的同时，给房子添加了很多的点缀；比如安装了天然气报警器，增加了热水器等附加的功能都属于装饰器模式。
+
+装饰器模式在 MyBatis 中的典型代表是 Cache。
+
+Cache 除了有数据存储和缓存的基本功能外（由 PerpetualCache 永久缓存实现），还有其他附加的 Cache 类，比如先进先出的 FifoCache、最近最少使用的 LruCache、防止多线程并发访问的 SynchronizedCache 等众多附加功能的缓存类，Cache 所有实现子类如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613154009.png)
+
+# 小结
+本课时我们重点讲了 MyBatis 源码中的几个主要设计模式，即工厂模式、建造者模式、单例模式、适配器模式、代理模式、模板方法模式等，希望本课时的内容能起到抛砖引玉的作用，对你理解设计模式和 MyBatis 提供一些帮助，如果想要阅读全部的 MyBatis 源码可以访问：https://github.com/mybatis/mybatis-3 。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/14.SpringBoot有哪些优点？它和Spring有什么区别？.md b/Java基础教程/Java面试原理/14.SpringBoot有哪些优点？它和Spring有什么区别？.md
new file mode 100644
index 00000000..24863fe5
--- /dev/null
+++ b/Java基础教程/Java面试原理/14.SpringBoot有哪些优点？它和Spring有什么区别？.md
@@ -0,0 +1,266 @@
+# SpringBoot 有哪些优点？它和 Spring 有什么区别？
+
+Spring 和 Spring Boot 的区别很多新手容易搞混，从这道简单的面试题也可以很轻易试探出你的 Java 基础功底，如果连这个问题都答不上来的话，通常就没有什么下文了，因为这已经是用人单位对面试者的最低要求了，所以本课时我们就来看一下二者的区别，以及 Spring Boot 的特性。
+
+我们本课时的面试题是，Spring 和 Spring Boot 有什么区别？Spring Boot 的优点有哪些？
+
+## 典型回答
+
+作为 Java 开发人员对 Spring 框架都很熟悉，Spring 为 Java 程序提供了全面的基础架构支持，包含了很多非常实用的功能，如 Spring JDBC、Spring AOP、Spring ORM、Spring Test 等，这些模块的出现，大大的缩短了应用程序的开发时间，同时提高了应用开发的效率。
+
+Spring Boot 本质上是 Spring 框架的延伸和扩展，它的诞生是为了简化 Spring 框架初始搭建以及开发的过程，使用它可以不再依赖 Spring 应用程序中的 XML 配置，为更快、更高效的开发 Spring 提供更加有力的支持。Spring Boot 具体的特性如下。
+
+### Spring Boot 特性一：更快速的构建能力
+Spring Boot 提供了更多的 Starters 用于快速构建业务框架，Starters 可以理解为启动器，它包含了一系列可以集成到应用里面的依赖包，你可以一站式集成 Spring 及其他技术，而不需要到处找依赖包。
+
+例如在 Spring 中如果要创建 Web 应用程序的最小依赖项为：
+
+```xml
+
+    org.springframework
+    spring-web
+    xxx
+
+
+    org.springframework
+    spring-webmvc
+    xxx
+
+```
+
+而 Spring Boot 只需要一个依赖项就可以来启动和运行 Web 应用程序，如下所示：
+
+```xml
+
+    org.springframework.boot
+    spring-boot-starter-web
+
+```
+
+当我们添加了 Starter 模块支持之后，在项目的构建期，它就会把所有其他依赖项将自动添加到项目中。
+
+这样的例子还有很多，比如测试库，如果是 Spring 项目我们通常要添加 Spring Test、JUnit、Hamcrest 和 Mockito 库；而如果是 Spring Boot 项目的话，只需要添加 spring-boot-starter-test 即可，它会自动帮我们把其他的依赖项添加到项目中。
+
+常见的 Starters 有以下几个：
+
+* spring-boot-starter-test
+* spring-boot-starter-web
+* spring-boot-starter-data-jpa
+* spring-boot-starter-thymeleaf
+
+点击这里访问文档，查看完整的 Starters 列表。
+
+### Spring Boot 特性二：起步依赖
+Spring Boot 提供了起步依赖，也就是在创建 Spring Boot 时可以直接勾选依赖模块，这样在项目初始化时就会把相关依赖直接添加到项目中，大大缩短了查询并添加依赖的时间，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613155541.png)
+
+### Spring Boot 特性三：内嵌容器支持
+Spring Boot 内嵌了 Tomcat、Jetty、Undertow 三种容器，其默认嵌入的容器是 Tomcat，这个在我们启动 Spring Boot 项目的时候，在控制台上就能看到，具体信息如下：
+
+> o.s.b.w.embedded.tomcat.TomcatWebServer :Tomcat started on port(s): 8080 (http) with context path ''
+
+可以看出 Spring Boot 默认使用的是 Tomcat 容器启动的。
+
+我们可以通过修改 pom.xml 来移除内嵌的 Tomcat 更换为其他的容器，比如更换为 Jetty 容器，配置如下：
+
+```xml
+
+    org.springframework.boot
+    spring-boot-starter-web
+    
+    
+        
+            org.springframework.boot
+            spring-boot-starter-tomcat
+        
+    
+
+
+
+    org.springframework.boot
+    spring-boot-starter-jetty
+
+```
+
+当我们添加完成之后，再重新生成 pom.xml 文件，然后再启动 Spring Boot 项目容器信息就变了，如下所示：
+
+> o.e.jetty.server.AbstractConnector: Started ServerConnector@53f9009d{HTTP/1.1, (http/1.1)}{0.0.0.0:8080}
+> o.s.b.web.embedded.jetty.JettyWebServer
+
+可以看出 Spring Boot 使用了我们指定的 Jetty 容器启动了。
+
+### Spring Boot 特性四：Actuator 监控
+Spring Boot 自带了 Actuator 监控功能，主要用于提供对应用程序监控，以及控制的能力，比如监控应用程序的运行状况，或者内存、线程池、Http 请求统计等，同时还提供了关闭应用程序等功能。
+
+Actuator 提供了 19 个接口，接口请求地址和代表含义如下表所示：
+
+|     访问路径      |                             描述                             |
+| :---------------: | :----------------------------------------------------------: |
+|   /auditevents    |            显示应用暴露的审计事件（比如认证进入）            |
+|      /beans       |          显示应用程序中所有 Spring Bean 的完整列表           |
+|      /caches      |                        公开可用的缓存                        |
+|    /conditions    | 显示在配置和自动配置类上评估的条件以及它们匹配或不匹配的原因 |
+|   /configprops    |         显示所有 @ConfigurationPropertie 的整理列表          |
+|       /env        |                       获取全部环境属性                       |
+|      /flyway      |                提供一份 Flyway 数据库迁移信息                |
+|      /health      |                   显示应用程序运行状况信息                   |
+|    /httptrace     | 显示 HTTP 跟踪信息（默认情况下，最近 100 个 HTTP 请求-响应交换） |
+|       /info       |    获取应用程序的定制信息，这些信息由 info 开头的属性提供    |
+| /integrationgraph | 显示 Spring Integration 图，需要依赖于 spring-integration-core |
+|     /loggers      |                   显示和修改应用程序的配置                   |
+|    /liquibase     |            显示已应用的所有 Liquibase 数据库迁移             |
+|  /metrics/{name}  |                 报告指定名称的应用程序度量值                 |
+|     /mappings     |             显示所有 @RequestMapping 路径的列表              |
+|  /scheduledtasks  |                   显示应用程序中的计划任务                   |
+|     /sessions     | 允许从 Spring Session 支持的会话存储中检索和删除用户会话，需要使用 Spring Session 基于 Servlet 的 Web 应用程序 |
+|     /shutdown     |                 使应用程序正常关闭，默认禁用                 |
+|    /threaddump    |                      获取线程活动的快照                      |
+
+## 考点分析
+很多人都知道 Spring Boot 是基于 Spring 的，使用它可以更加快速高效的构建 Spring，然而当面试官问到 Spring Boot 是如何高效构建 Spring 时，可能大部分人回答不上来了，上面讲解的 Spring Boot 四大特性基本涵盖了此问题的答案。如果面试官继续追问更深的细节的话，可能会问到关于 Spring Boot 执行的源码细节，比如 Spring Boot 的启动流程是怎么样的？
+
+# 知识扩展
+
+## Spring Boot 启动源码分析
+我们知道 Spring Boot 程序的入口是 SpringApplication.run(Application.class, args) 方法，那么就从 run() 方法开始分析吧，它的源码如下：
+
+```java
+public ConfigurableApplicationContext run(String... args) {
+    // 1.创建并启动计时监控类
+    StopWatch stopWatch = new StopWatch();
+    stopWatch.start();
+    // 2.声明应用上下文对象和异常报告集合
+    ConfigurableApplicationContext context = null;
+    Collection exceptionReporters = new ArrayList();
+    // 3.设置系统属性 headless 的值
+    this.configureHeadlessProperty();
+    // 4.创建所有 Spring 运行监听器并发布应用启动事件
+    SpringApplicationRunListeners listeners = this.getRunListeners(args);
+    listeners.starting();
+    Collection exceptionReporters;
+    try {
+        // 5.处理 args 参数
+        ApplicationArguments applicationArguments = new DefaultApplicationArguments(args);
+        // 6.准备环境
+        ConfigurableEnvironment environment = this.prepareEnvironment(listeners, applicationArguments);
+        this.configureIgnoreBeanInfo(environment);
+        // 7.创建 Banner 的打印类
+        Banner printedBanner = this.printBanner(environment);
+        // 8.创建应用上下文
+        context = this.createApplicationContext();
+        // 9.实例化异常报告器
+        exceptionReporters = this.getSpringFactoriesInstances(SpringBootExceptionReporter.class, new Class[]{ConfigurableApplicationContext.class}, context);
+        // 10.准备应用上下文
+        this.prepareContext(context, environment, listeners, applicationArguments, printedBanner);
+        // 11.刷新应用上下文
+        this.refreshContext(context);
+        // 12.应用上下文刷新之后的事件的处理
+        this.afterRefresh(context, applicationArguments);
+        // 13.停止计时监控类
+        stopWatch.stop();
+        // 14.输出日志记录执行主类名、时间信息
+        if (this.logStartupInfo) {
+            (new StartupInfoLogger(this.mainApplicationClass)).logStarted(this.getApplicationLog(), stopWatch);
+        }
+        // 15.发布应用上下文启动完成事件
+        listeners.started(context);
+        // 16.执行所有 Runner 运行器
+        this.callRunners(context, applicationArguments);
+    } catch (Throwable var10) {
+        this.handleRunFailure(context, var10, exceptionReporters, listeners);
+        throw new IllegalStateException(var10);
+    }
+    try {
+        // 17.发布应用上下文就绪事件
+        listeners.running(context);
+        // 18.返回应用上下文对象
+        return context;
+    } catch (Throwable var9) {
+        this.handleRunFailure(context, var9, exceptionReporters, (SpringApplicationRunListeners)null);
+        throw new IllegalStateException(var9);
+    }
+}
+```
+
+从以上源码可以看出 Spring Boot 的启动总共分为以下 18 个步骤。
+
+## Spring Boot 的启动流程
+### 1.创建并启动计时监控类
+
+此计时器是为了监控并记录 Spring Boot 应用启动的时间的，它会记录当前任务的名称，然后开启计时器。
+
+### 2.声明应用上下文对象和异常报告集合
+
+此过程声明了应用上下文对象和一个异常报告的 ArrayList 集合。
+
+### 3.设置系统属性 headless 的值
+
+设置 Java.awt.headless = true，其中 awt（Abstract Window Toolkit）的含义是抽象窗口工具集。设置为 true 表示运行一个 headless 服务器，可以用它来作一些简单的图像处理。
+
+### 4.创建所有 Spring 运行监听器并发布应用启动事件
+
+此过程用于获取配置的监听器名称并实例化所有的类。
+
+### 5.初始化默认应用的参数类
+
+也就是说声明并创建一个应用参数对象。
+
+### 6.准备环境
+
+创建配置并且绑定环境（通过 property sources 和 profiles 等配置文件）。
+
+### 7.创建 Banner 的打印类
+
+Spring Boot 启动时会打印 Banner 图片，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200613160904.png)
+
+此 banner 信息是在 SpringBootBanner 类中定义的，我们可以通过实现 Banner 接口来自定义 banner 信息，然后通过代码 setBanner() 方法设置 Spring Boot 项目使用自己自定义 Banner 信息，或者是在 resources 下添加一个 banner.txt，把 banner 信息添加到此文件中，就可以实现自定义 banner 的功能了。
+
+### 8.创建应用上下文
+
+根据不同的应用类型来创建不同的 ApplicationContext 上下文对象。
+
+### 9.实例化异常报告器
+
+它调用的是 getSpringFactoriesInstances() 方法来获取配置异常类的名称，并实例化所有的异常处理类。
+
+### 10.准备应用上下文
+
+此方法的主要作用是把上面已经创建好的对象，传递给 prepareContext 来准备上下文，例如将环境变量 environment 对象绑定到上下文中、配置 bean 生成器以及资源加载器、记录启动日志等操作。
+
+### 11.刷新应用上下文
+
+此方法用于解析配置文件，加载 bean 对象，并且启动内置的 web 容器等操作。
+
+### 12.应用上下文刷新之后的事件处理
+
+这个方法的源码是空的，可以做一些自定义的后置处理操作。
+
+### 13.停止计时监控类
+
+停止此过程第一步中的程序计时器，并统计任务的执行信息。
+
+### 14.输出日志信息
+
+把相关的记录信息，如类名、时间等信息进行控制台输出。
+
+### 15.发布应用上下文启动完成事件
+
+触发所有 SpringApplicationRunListener 监听器的 started 事件方法。
+
+### 16.执行所有 Runner 运行器
+
+执行所有的 ApplicationRunner 和 CommandLineRunner 运行器。
+
+### 17.发布应用上下文就绪事件
+
+触发所有的 SpringApplicationRunListener 监听器的 running 事件。
+
+### 18.返回应用上下文对象
+
+到此为止 Spring Boot 的启动程序就结束了，我们就可以正常来使用 Spring Boot 框架了。
+
+# 小结
+本课时首先讲了 Spring 和 Spring Boot 的区别，Spring Boot 本质上是 Spring 的延伸，它是基于 Spring 的，它为快速构建和开发 Spring 提供了有力的支撑；接着介绍了 Spring Boot 的四大特性：更快速的构建能力、起步依赖、内嵌容器支持、Actuator 监控支持等，最后 还介绍了 Spring Boot 启动的 18 个步骤。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/15.MQ有什么作用？你都用过哪些MQ中间件.md b/Java基础教程/Java面试原理/15.MQ有什么作用？你都用过哪些MQ中间件.md
new file mode 100644
index 00000000..4394b252
--- /dev/null
+++ b/Java基础教程/Java面试原理/15.MQ有什么作用？你都用过哪些MQ中间件.md
@@ -0,0 +1,112 @@
+# MQ 有什么作用？你都用过哪些 MQ 中间件？
+
+在第10篇中讲过“手写消息队列”，当时粗略的讲了 Java API 中使用 Queue 实现自定义消息队列，以及使用 Delayed 实现延迟队列的示例；同时还讲了 RabbitMQ 中的一些基础概念。本课时我们将会更加深入的讲解 MQ（Message Queue，消息队列）中间件，以及这些热门中间件的具体使用。
+
+我们本课时的面试题是，MQ 常见的使用场景有哪些？你都用过哪些 MQ 中间件？
+
+## 典型回答
+
+在介绍 MQ 的使用场景之前，先来回忆一下 MQ 的作用。MQ 可以用来实现削峰填谷，也就是使用它可以解决短时间内爆发式的请求任务，在不使用 MQ 的情况下会导致服务处理不过来，出现应用程序假死的情况，而使用了 MQ 之后可以把这些请求先暂存到消息队列中，然后进行排队执行，那么就不会出现应用程序假死的情况了，所以它的第一个应用就是商品秒杀以及产品抢购等使用场景，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200614145120.png)
+
+### 使用 MQ 实现消息通讯
+
+使用 MQ 可以作为消息通讯的实现手段，利用它可以实现点对点的通讯或者多对多的聊天室功能。
+
+点对点的消息通讯如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200614145219.png)
+
+多对多的消息通讯如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200614145241.png)
+
+### 使用 MQ 实现日志系统
+可使用 MQ 实现对日志的采集和转发，比如有多个日志写入到程序中，然后把日志添加到 MQ，紧接着由日志处理系统订阅 MQ，最后 MQ 将消息接收并转发给日志处理系统，这样就完成了日志的分析和保存功能，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200614145326.png)
+
+常用的 MQ 中间件有 RabbitMQ、Kafka 和 Redis 等，其中 Redis 属于轻量级的消息队列，而 RabbitMQ、Kafka 属于比较成熟且比较稳定和高效的 MQ 中间件。
+
+## 考点分析
+
+MQ 属于中高级或优秀的程序员必备的技能，对于 MQ 中间件掌握的数量则是你技术广度和编程经验的直接体现信息之一。值得庆幸的是，关于 MQ 中间件的实现原理和使用方式都比较类似，因此如果开发者掌握一项 MQ 中间件再去熟悉其他 MQ 中间件时，会非常的容易。
+
+MQ 相关的面试题还有这些：
+
+* MQ 的特点是什么？引入 MQ 中间件会带来哪些问题？
+* 常见的 MQ 中间件的优缺点分析。
+
+# 知识扩展
+
+## MQ 的特点及注意事项
+### MQ 具有以下 5 个特点
+
+* **先进先出**：消息队列的顺序一般在入列时就基本确定了，最先到达消息队列的信息，一般情况下也会先转发给订阅的消费者，我们把这种实现了先进先出的数据结构称之为队列。
+* **发布、订阅工作模式**：生产者也就是消息的创建者，负责创建和推送数据到消息服务器；消费者也就是消息的接收方，用于处理数据和确认消息的消费；消息队列也是 MQ 服务器中最重要的组成元素之一，它负责消息的存储，这三者是 MQ 中的三个重要角色。而它们之间的消息传递与转发都是通过发布以及订阅的工作模式来进行的，即生产者把消息推送到消息队列，消费者订阅到相关的消息后进行消费，在消息非阻塞的情况下，此模式基本可以实现同步操作的效果。并且此种工作模式会把请求的压力转移给 MQ 服务器，以减少了应用服务器本身的并发压力。
+* **持久化**：持久化是把消息从内存存储到磁盘的过程，并且在服务器重启或者发生宕机的情况下，重新启动服务器之后是保证数据不会丢失的一种手段，也是目前主流 MQ 中间件都会提供的重要功能。
+* **分布式**：MQ 的一个主要特性就是要应对大流量、大数据的高并发环境，一个单体的 MQ 服务器是很难应对这种高并发的压力的，所以 MQ 服务器都会支持分布式应用的部署，以分摊和降低高并发对 MQ 系统的冲击。
+* **消息确认**：消息消费确认是程序稳定性和安全性的一个重要考核指标，假如消费者在拿到消息之后突然宕机了，那么 MQ 服务器会误认为此消息已经被消费者消费了，从而造成消息丢失的问题，而目前市面上的主流 MQ 都实现了消息确认的功能，保证了消息不会丢失，从而保证了系统的稳定性。
+
+### 引入 MQ 系统会带来的问题
+
+任何系统的引入都是有两面性的，MQ 也不例外，在引入 MQ 之后，可能会带来以下两个问题。
+
+* **增加了系统的运行风险**：引入 MQ 系统，则意味着新增了一套系统，并且其他的业务系统会对 MQ 系统进行深度依赖，系统部署的越多则意味着发生故障的可能性就越大，如果 MQ 系统挂掉的话可能会导致整个业务系统瘫痪。
+* **增加了系统的复杂度**：引入 MQ 系统后，需要考虑消息丢失、消息重复消费、消息的顺序消费等问题，同时还需要引入新的客户端来处理 MQ 的业务，增加了编程的运维门槛，增加了系统的复杂性。
+
+### 使用 MQ 需要注意的问题
+
+不要过度依赖 MQ，比如发送短信验证码或邮件等功能，这种低频但有可能比较耗时的功能可以使用多线程异步处理即可，不用任何的功能都依赖 MQ 中间件来完成，但像秒杀抢购可能会导致超卖（也就是把货卖多了，库存变成负数了）等短时间内高并发的请求，此时建议使用 MQ 中间件。
+
+## 常用的 MQ 中间件
+常用的 MQ 中间件有 Redis、RabbitMQ、Kafka，下来我们分别来看看各自的作用。
+
+### Redis 轻量级的消息中间件
+
+Redis 是一个高效的内存性数据库中间件，但使用 Redis 也可以实现消息队列的功能。
+
+早期的 Redis（Redis 5.0 之前）是不支持消息确认的，那时候我们可以通过 List 数据类型的 lpush 和 rpop 方法来实现队列消息的存入和读取功能，或者使用 Redis 提供的发布订阅（pub/sub）功能来实现消息队列，但这种模式不支持持久化，List 虽然支持持久化但不能设置复杂的路由规则来匹配多个消息，并且他们二者都不支持消息消费确认。
+
+于是在 Redis 5.0 之后提供了新的数据类型 Stream 解决了消息确认的问题，但它同样不能提供复杂的路由匹配规则，因此在业务不复杂的场景下可以尝试性的使用 Redis 提供的消息队列。
+
+### RabbitMQ
+
+在第10篇中，我们对 RabbitMQ 有过初步的讲解，它是一个实现了标准的高级消息队列协议（AMQP，Advanced Message Queuing Protocol）的老牌开源消息中间件，最初起源于金融系统，后来被普遍应用在了其他分布式系统中，它支持集群部署，和多种客户端调用。
+
+之前主要介绍了 RabbitMQ 的基础功能，本课时我们重点来看 RabbitMQ 集群相关的内容。
+
+RabbitMQ 集群是由多个节点组成，但默认情况下每个节点并不是存储所有队列的完整拷贝，这是出于存储空间和性能的考虑，因为如果存储了队列的完整拷贝，那么就会有很多冗余的重复数据，并且在新增节点的情况下，不但没有新增存储空间，反而需要更大的空间来存储旧的数据；同样的道理，如果每个节点都保存了所有队列的完整信息，那么非查询操作的性能就会很慢，就会需要更多的网络带宽和磁盘负载来存储这些数据。
+
+为了能兼顾性能和稳定性，RabbitMQ 集群的节点分为两种类型，即磁盘节点和内存节点，对于磁盘节点来说显然它的优势就是稳定，可以把相关数据保存下来，若 RabbitMQ 因为意外情况宕机，重启之后保证了数据不丢失；而内存节点的优势是快，因为是在内存中进行数据交换和操作，因此性能比磁盘节点要高出很多倍。
+
+如果是单个 RabbitMQ 那么就必须要求是磁盘节点，否则当 RabbitMQ 服务器重启之后所有的数据都会丢失，这样显然是不能接受的。在 RabbitMQ 的集群中，至少需要一个磁盘节点，这样至少能保证集群数据的相对可靠性。
+
+如果集群中的某一个磁盘节点崩溃了，此时整个 RabbitMQ 服务也不会处于崩溃的状态，不过部分操作会受影响，比如不能创建队列、交换器、也不能添加用户及修改用户权限，更不能添加和删除集群的节点等功能。
+
+> 小贴士：对于 RabbitMQ 集群来说，我们启动集群节点的顺序应该是先启动磁盘节点再启动内存节点，而关闭的顺序正好和启动的顺序相反，不然可能会导致 RabbitMQ 集群启动失败或者是数据丢失等异常问题。
+
+### Kafka
+
+Kafka 是 LinkedIn 公司开发的基于 ZooKeeper 的多分区、多副本的分布式消息系统，它于 2010 年贡献给了 Apache 基金会，并且成为了 Apache 的顶级开源项目。其中 ZooKeeper 的作用是用来为 Kafka 提供集群元数据管理以及节点的选举和发现等功能。
+
+与 RabbitMQ 比较类似，一个典型的 Kafka 是由多个 Broker、多个生产者和消费者，以及 ZooKeeper 集群组成的，其中 Broker 可以理解为一个代理，Kafka 集群中的一台服务器称之为一个 Broker，其组成框架图如下所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200614150422.png)
+
+### Kafka VS RabbitMQ
+
+Kafka（2.0.0）和 RabbitMQ（3.6.10）的区别主要体现在以下几点：
+
+* Kafka 支持消息回溯，它可以根据 Offset（消息偏移量）、TimeStamp（时间戳）等维度进行消息回溯，而 RabbitMQ 并不支持消息回溯；
+* Kafka 的消息消费是基于拉取数据的模式，也就是消费者主动向服务器端发送拉取消息请求，而 RabbitMQ 支持拉取数据模式和主动推送数据的模式，也就说 RabbitMQ 服务器会主动把消息推送给订阅的消费者；
+* 在相同配置下，Kafka 的吞吐量通常会比 RabbitMQ 高一到两个级别，比如在单机模式下，RabbitMQ 的吞吐量大概是万级别的处理能力，而 Kafka 则可以到达十万甚至是百万的吞吐级别；
+* Kafka 从 0.11 版本就开始支持幂等性了，当然所谓的幂等性指的是对单个生产者在单分区上的单会话的幂等操作，但对于全局幂等性则还需要结合业务来处理，比如，消费者在消费完一条消息之后没有来得及确认就发生异常了，等到恢复之后又得重新消费原来消费过的消息，类似这种情况，是无法在消息中间件层面来保证的，这个时候则需要引入更多的外部资源来保证全局幂等性，比如唯一的订单号、消费之前先做去重判断等；而 RabbitMQ 是没有幂等性功能支持的；
+* RabbitMQ 支持多租户的功能，也就是常说的 Virtual Host（vhost），每一个 vhost 相当于一个独立的小型 RabbitMQ 服务器，它们拥有自己独立的交换器、消息队列及绑定关系等，并且拥有自己独立权限，而且多个 vhost 之间是绝对隔离的，但 Kafka 并不支持多租户的功能。
+
+Kafka 和 RabbitMQ 都支持分布式集群部署，并且都支持数据持久化和消息消费确认等 MQ 的核心功能，对于 MQ 的选型要结合自己团队本身的情况，从性能、稳定性及二次开发的难易程度等维度来进行综合的考量并选择。
+
+# 小结
+
+本篇我们讲了 MQ 的常见使用场景，以及常见的 MQ 中间件（Redis、RabbitMQ、Kafka）及其优缺点分析；同时还了解了 MQ 的五大特点：先进先出、发布和订阅的模式、持久化、分布式和消息确认等；接着讲了 MQ 引入对系统可能带来的风险；最后讲了 MQ 在使用时需要注意的问题。希望本课时对你整体了解 MQ 系统有所帮助。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/16.MySQL 的运行机制是什么？它有哪些引擎？.md b/Java基础教程/Java面试原理/16.MySQL 的运行机制是什么？它有哪些引擎？.md
new file mode 100644
index 00000000..a25fbb2e
--- /dev/null
+++ b/Java基础教程/Java面试原理/16.MySQL 的运行机制是什么？它有哪些引擎？.md	
@@ -0,0 +1,111 @@
+# MySQL 的运行机制是什么？它有哪些引擎？
+
+数据库是 Java 程序员面试必问的知识点之一，它和 Java 的核心面试点共同组成了一个完整的技术面试。而数据库一般泛指的就是 MySQL，因为 MySQL 几乎占据了数据库的半壁江山，即使有些公司没有使用 MySQL 数据库，如果你对 MySQL 足够精通的话，也是会被他们录取的。因为数据库的核心与原理基本是相通的，所以有了 MySQL 的基础之后，再去熟悉其他数据库也是非常快的，那么接下来的几个课时就让我们好好的学习一下 MySQL。
+
+我们本课时的面试题是，MySQL 是如何运行的？说一下它有哪些引擎？
+
+## 典型回答
+
+MySQL 的执行流程是这样的，首先客户端先要发送用户信息去服务器端进行授权认证。如果使用的是命令行工具，通常需要输入如下信息：
+
+> mysql -h 主机名(IP) -u 用户名 -P 端口 -p
+
+其中：
+
+* -h 表示要连接的数据库服务器的主机名或者 IP 信息；
+* -u 表示数据库的用户名称；
+* -P 表示数据库服务器的端口号，
+* 小写的 -p 表示需要输入数据库的密码。
+
+具体使用示例，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200614151032.png)
+
+当输入正确密码之后可以连接到数据库了，如果密码输入错误，则会提示`“Access denied for user 'xxx'@'xxx' (using password: YES)”`密码错误信息，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200614151107.png)
+
+当连接服务器端成功之后就可以正常的执行 SQL 命令了，MySQL 服务器拿到 SQL 命令之后，会使用 MySQL 的分析器解析 SQL 指令，同时会根据语法分析器验证 SQL 指令，查询 SQL 指令是否满足 MySQL 的语法规则。如果不支持此语法，则会提示“SQL syntax”语法错误信息。
+
+当分析器验证并解析 SQL 命令之后，会进入优化器阶段，执行生成计划，并设置相应的索引；当上面的这些步骤都执行完之后，就进入了执行器阶段，并开始正式执行 SQL 命令。同样在执行命令之前，它会先对你的执行命令进行权限查询，看看是否有操作某个表的权限，如果有相应的权限，执行器就去调用 MySQL 数据库引擎提供的接口，执行相应的命令；如果是非查询操作会记录对应的操作日志，再命令执行完成之后返回结果给客户端，这就是整个 MySQL 操作的完整流程。
+
+需要注意的是，如果执行的是 select 语句并且是 MySQL 8.0 之前的版本的话，则会去 MySQL 的查询缓存中查看之前是否有执行过这条 SQL；如果缓存中可以查到，则会直接返回查询结果，这样查询性能就会提升很高。
+
+整个 SQL 的执行流程，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200614151300.png)
+
+我们可以使用 SHOW ENGINES 命令来查看 MySQL 数据库使用的存储引擎，如下图所示：
+
+```sql
+SHOW ENGINES
+```
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200614151407.png)
+
+常用的数据库引擎有 InnoDB、MyISAM、MEMORY 等，其中 InnoDB 支持事务功能，而 MyISAM 不支持事务，但 MyISAM 拥有较高的插入和查询的速度。而 MEMORY 是内存型的数据库引擎，它会将表中的数据存储到内存中，因为它是内存级的数据引擎，因此具备最快速的查询效率，但它的缺点是，重启数据库之后，所有数据都会丢失，因为这些数据是存放在内存中的。
+
+## 考点分析
+
+此面试题考察的是面试者对 MySQL 基础知识的掌握程度，以及对于 MySQL 引擎的了解程度，这些都是属于 MySQL 最核心的原理之一，也是面试中常见的面试问题，它一般作为数据库面试题的开始题目，和此面试题相关的面试点还有以下几个：
+
+* 查询缓存存在什么问题？
+* 如何选择数据库的引擎？
+* InnoDB 自增索引的持久化问题。
+
+# 知识扩展
+
+## 1.查询缓存的利弊
+MySQL 8.0 之前可以正常的使用查询缓存的功能，可通过`SHOW GLOBAL VARIABLES LIKE 'query_cache_type`命令查询数据库是否开启了查询缓存的功能，它的结果值有以下三项：
+
+* OFF，关闭了查询缓存功能；
+* ON，开启了查询缓存功能；
+* DEMAND，在 sql 语句中指定 sql_cache 关键字才会有查询缓存，也就是说必须使用 sql_cache 才可以把该 select 语句的查询结果缓存起来，比如`select sql_cache name from token where tid=1010`语句。
+
+开启和关闭查询缓存可以通过修改 MySQL 的配置文件 my.cnf 进行修改，它的配置项如下：
+
+```cnf
+query_cache_type = ON
+```
+
+> 注意：配置被更改之后需要重启 MySQL 服务才能生效。
+
+查询缓存的功能要根据实际的情况进行使用，建议设置为按需缓存（DEMAND）模式，因为查询缓存的功能并不是那么好用。比如我们设置了 `query_cache_type = ON`，当我们好不容易缓存了很多查询语句之后，任何一条对此表的更新操作都会把和这个表关联的所有查询缓存全部清空，那么在更新频率相对较高的业务中，查询缓存功能完全是一个鸡肋。因此，在 MySQL 8.0 的版本中已经完全移除了此功能，也就是说在 MySQL 8.0 之后就完全没有查询缓存这个概念和功能了。
+
+## 2.如何选择数据库引擎
+选择数据库引擎要从实际的业务情况入手，比如是否需要支持事务？是否需要支持外键？是否需要支持持久化？以及是否支持地理位置存储以及索引等方面进行综合考量。
+
+我们最常用的数据库引擎是 InnoDB，它是 MySQL 5.5.5 之后的默认引擎，其优点是支持事务，且支持 4 种隔离级别。
+
+* 读未提交：也就是一个事务还没有提交时，它做的变更就能被其他事务看到。
+* 读已提交：指的是一个事务只有提交了之后，其他事务才能看得到它的变更。
+* 可重复读：此方式为默认的隔离级别，它是指一个事务在执行过程中（从开始到结束）看到的数据都是一致的，在这个过程中未提交的变更对其他事务也是不可见的。
+* 串行化：是指对同一行记录的读、写都会添加读锁和写锁，后面访问的事务必须等前一个事务执行完成之后才能继续执行，所以这种事务的执行效率很低。
+
+InnoDB 还支持外键、崩溃后的快速恢复、支持全文检索（需要 5.6.4+ 版本）、集群索引，以及地理位置类型的存储和索引等功能。
+
+MyISAM 引擎是 MySQL 原生的引擎，但它并不支持事务功能，这也是后来被 InnoDB 替代为默认引擎的主要原因。MyISAM 有独立的索引文件，因此在读取数据方面的性能很高，它也支持全文索引、地理位置存储和索引等功能，但不支持外键。
+
+InnoDB 和 MyISAM 都支持持久化，但 MEMORY 引擎是将数据直接存储在内存中了，因此在重启服务之后数据就会丢失，但它带来的优点是执行速度很快，可以作为临时表来使用。
+
+我们可以根据实际的情况设置相关的数据库引擎，还可以针对不同的表设置不同的数据引擎，只需要在创建表的时候指定 engine=引擎名称即可，SQL 代码如下：
+
+```sql
+create table student(
+   id int primary key auto_increment,
+   uname varchar(60),
+   age int
+) engine=Memory;
+```
+
+### 3.InnoDB 自增主键
+在面试的过程中我们经常看到这样一道面试题：
+
+> 在一个自增表里面一共有 5 条数据，id 从 1 到 5，删除了最后两条数据，也就是 id 为 4 和 5 的数据，之后重启的 MySQL 服务器，又新增了一条数据，请问新增的数据 id 为几？
+
+我们通常的答案是如果表为 MyISAM 引擎，那么 id 就是 6，如果是 InnoDB 那么 id 就是 4。
+
+但是这个情况在高版本的 InnoDB 中，也就是 MySQL 8.0 之后就不准确了，它的 id 就不是 4 了，而是 6 了。因为在 MySQL 8.0 之后 InnoDB 会把索引持久化到日志中，重启服务之后自增索引是不会丢失的，因此答案是 6，这个需要面试者注意一下。
+
+# 小结
+本课时我们讲了 MySQL 数据库运行流程的几个阶段，先从连接器授权，再到分析器进行语法分析。如果是 MySQL 8.0 之前的 select 语句可能会先查询缓存，如果有缓存则会直接返回结果给客户端，否则会从分析器进入优化器生成 SQL 的执行计划，然后交给执行器调用操作引擎执行相关的 SQL，再把结果返回给客户端。我们还讲了最常见的三种数据库引擎 InnoDB、MyISAM、MEMORY，以及它们的利弊分析。最后讲了 InnoDB 在高版本（8.0）之后可以持久化自增主键的小特性。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/17.MySQL 的优化方案有哪些？.md b/Java基础教程/Java面试原理/17.MySQL 的优化方案有哪些？.md
new file mode 100644
index 00000000..39fa633e
--- /dev/null
+++ b/Java基础教程/Java面试原理/17.MySQL 的优化方案有哪些？.md	
@@ -0,0 +1,135 @@
+# MySQL 的优化方案有哪些？
+
+性能优化（Optimize）指的是在保证系统正确性的前提下，能够更快速响应请求的一种手段。而且有些性能问题，比如慢查询等，如果积累到一定的程度或者是遇到急速上升的并发请求之后，会导致严重的后果，轻则造成服务繁忙，重则导致应用不可用。它对我们来说就像一颗即将被引爆的定时炸弹一样，时刻威胁着我们。因此在上线项目之前需要严格的把关，以确保 MySQL 能够以最优的状态进行运行。同时，在实际工作中还有面试中关于 MySQL 优化的知识点，都是面试官考察的重点内容。
+
+我们本课时的面试题是，MySQL 的优化方案有哪些？
+
+## 典型回答
+
+MySQL 数据库常见的优化手段分为三个层面：**SQL和索引优化**、**数据库结构优化**、**系统硬件优化**等，然而每个大的方向中又包含多个小的优化点，下面我们具体来看看。
+
+### 1.SQL 和索引优化
+此优化方案指的是通过优化 SQL 语句以及索引来提高 MySQL 数据库的运行效率，具体内容如下。
+
+#### 1.使用正确的索引
+
+索引是数据库中最重要的概念之一，也是提高数据库性能最有效的手段之一，它的诞生本身就是为了提高数据查询效率的，就像字典的目录一样，通过目录可以很快找到相关的内容。
+
+假如我们没有添加索引，那么在查询时就会触发全表扫描，因此查询的数据就会很多，并且查询效率会很低，为了提高查询的性能，我们就需要给最常使用的查询字段上，添加相应的索引，这样才能提高查询的性能。
+
+> 小贴士：我们应该尽可能的使用主键查询，而非其他索引查询，因为主键查询不会触发回表查询，因此节省了一部分时间，变相的提高了查询的性能。
+
+在 MySQL 5.0 之前的版本要尽量避免使用 or 查询，可以使用 union 或者子查询来替代，因为早期的 MySQL 版本使用 or 查询可能会导致索引失效，在 MySQL 5.0 之后的版本中引入了索引合并，简单来说就是把多条件查询，比如 or 或 and 查询的结果集进行合并交集或并集的功能，因此就不会导致索引失效的问题了。
+
+避免在 where 查询条件中使用 != 或者 <> 操作符，因为这些操作符会导致查询引擎放弃索引而进行全表扫描。
+
+适当使用前缀索引，MySQL 是支持前缀索引的，也就是说我们可以定义字符串的一部分来作为索引。我们知道索引越长占用的磁盘空间就越大，那么在相同数据页中能放下的索引值也就越少，这就意味着搜索索引需要的查询时间也就越长，进而查询的效率就会降低，所以我们可以适当的选择使用前缀索引，以减少空间的占用和提高查询效率。比如，邮箱的后缀都是固定的“@xxx.com”，那么类似这种后面几位为固定值的字段就非常适合定义为前缀索引。
+
+#### 2.查询具体的字段而非全部字段
+
+要尽量避免使用 select *，而是查询需要的字段，这样可以提升速度，以及减少网络传输的带宽压力。
+
+#### 3.优化子查询
+
+尽量使用 Join 语句来替代子查询，因为子查询是嵌套查询，而嵌套查询会新创建一张临时表，而临时表的创建与销毁会占用一定的系统资源以及花费一定的时间，但 Join 语句并不会创建临时表，因此性能会更高。
+
+#### 4.注意查询结果集
+
+我们要尽量使用小表驱动大表的方式进行查询，也就是如果 B 表的数据小于 A 表的数据，那执行的顺序就是先查 B 表再查 A 表，具体查询语句如下：
+
+```sql
+select name from A where id in (select id from B);
+```
+
+#### 5.不要在列上进行运算操作
+
+不要在列字段上进行算术运算或其他表达式运算，否则可能会导致查询引擎无法正确使用索引，从而影响了查询的效率。
+
+#### 6.适当增加冗余字段
+
+增加冗余字段可以减少大量的连表查询，因为多张表的连表查询性能很低，所有可以适当的增加冗余字段，以减少多张表的关联查询，这是以空间换时间的优化策略。
+
+### 2.数据库结构优化
+#### 1.最小数据长度
+
+一般说来数据库的表越小，那么它的查询速度就越快，因此为了提高表的效率，应该将表的字段设置的尽可能小，比如身份证号，可以设置为 char(18) 就不要设置为 varchar(18)。
+
+#### 2.使用最简单数据类型
+
+能使用 int 类型就不要使用 varchar 类型，因为 int 类型比 varchar 类型的查询效率更高。
+
+#### 3.尽量少定义 text 类型
+
+text 类型的查询效率很低，如果必须要使用 text 定义字段，可以把此字段分离成子表，需要查询此字段时使用联合查询，这样可以提高主表的查询效率。
+
+#### 4.适当分表、分库策略
+
+分表和分库方案也是我们经常说的垂直分隔（分表）和水平分隔（分库）。
+
+**分表**是指当一张表中的字段更多时，可以尝试将一张大表拆分为多张子表，把使用比较高频的主信息放入主表中，其他的放入子表，这样我们大部分查询只需要查询字段更少的主表就可以完成了，从而有效的提高了查询的效率。
+
+**分库**是指将一个数据库分为多个数据库。比如我们把一个数据库拆分为了多个数据库，一个主数据库用于写入和修改数据，其他的用于同步主数据并提供给客户端查询，这样就把一个库的读和写的压力，分摊给了多个库，从而提高了数据库整体的运行效率。
+
+### 3.硬件优化
+MySQL 对硬件的要求主要体现在三个方面：磁盘、网络和内存。
+
+#### 1.磁盘
+
+磁盘应该尽量使用有高性能读写能力的磁盘，比如固态硬盘，这样就可以减少 I/O 运行的时间，从而提高了 MySQL 整体的运行效率。
+
+磁盘也可以尽量使用多个小磁盘而不是一个大磁盘，因为磁盘的转速是固定的，有多个小磁盘就相当于拥有多个并行运行的磁盘一样。
+
+#### 2.网络
+
+保证网络带宽的通畅（低延迟）以及够大的网络带宽是 MySQL 正常运行的基本条件，如果条件允许的话也可以设置多个网卡，以提高网络高峰期 MySQL 服务器的运行效率。
+
+#### 3.内存
+
+MySQL 服务器的内存越大，那么存储和缓存的信息也就越多，而内存的性能是非常高的，从而提高了整个 MySQL 的运行效率。
+
+## 考点分析
+
+MySQL 性能优化的方案很多，因此它可以全面考察的一个程序员的经验是否丰富。当然这个问题的回答也是可深可浅，不同的岗位对此问题的答案要求也是不同的，这个问题也可以引申出更多的面试问题，比如：
+
+* 联合索引需要注意什么问题？
+* 如何排查慢查询？
+
+# 知识扩展
+
+## 正确使用联合索引
+使用了 B+ 树的 MySQL 数据库引擎，比如 InnoDB 引擎，在每次查询复合字段时是从左往右匹配数据的，因此在创建联合索引的时候需要注意索引创建的顺序。例如，我们创建了一个联合索引是 idx(name,age,sex)，那么当我们使用，姓名+年龄+性别、姓名+年龄、姓名等这种最左前缀查询条件时，就会触发联合索引进行查询；然而如果非最左匹配的查询条件，例如，性别+姓名这种查询条件就不会触发联合索引。
+
+当然，当我们已经有了（name,age）这个联合索引之后，一般情况下就不需要在 name 字段单独创建索引了，这样就可以少维护一个索引。
+
+## 慢查询
+慢查询通常的排查手段是先使用慢查询日志功能，查询出比较慢的 SQL 语句，然后再通过 explain 来查询 SQL 语句的执行计划，最后分析并定位出问题的根源，再进行处理。
+
+慢查询日志指的是在 MySQL 中可以通过配置来开启慢查询日志的记录功能，超过 long_query_time 值的 SQL 将会被记录在日志中。我们可以通过设置“slow_query_log=1”来开启慢查询，它的开启方式有两种：
+
+* 通过 MySQL 命令行的模式进行开启，只需要执行“set global slow_query_log=1”即可，然而这种配置模式再重启 MySQL 服务之后就会失效；
+* 另一种方式可通过修改 MySQL 配置文件的方式进行开启，我们需要配置 my.cnf 中的“slow_query_log=1”即可，并且可以通过设置“slow_query_log_file=/tmp/mysql_slow.log”来配置慢查询日志的存储目录，但这种方式配置完成之后需要重启 MySQL 服务器才可生效。
+
+需要注意的是，在开启慢日志功能之后，会对 MySQL 的性能造成一定的影响，因此在生产环境中要慎用此功能。
+
+explain 执行计划的使用示例 SQL 如下：
+
+```sql
+explain select * from person where uname = 'Java';
+```
+
+它的执行结果如下图所示：
+
+![](https://cdn.jsdelivr.net/gh/krislinzhao/IMGcloud/img/20200615205146.png)
+
+摘要说明如下表所示：
+
+![](https://cdn.jsdelivr.net/gh/krislinzhao/IMGcloud/img/20200615205237.png)
+
+以上字段中最重要的就是 type 字段，它的所有值如下所示：
+
+![](https://cdn.jsdelivr.net/gh/krislinzhao/IMGcloud/img/20200615205327.png)
+
+当 type 为 all 时，则表示全表扫描，因此效率会比较低，此时需要查看一下为什么会造成此种原因，是没有创建索引还是索引创建的有问题？以此来优化整个 MySQL 运行的速度。
+
+# 小结
+本课时我们从三个维度讲了 MySQL 的优化手段：SQL 和索引优化、数据库结构优化以及系统硬件优化等；同时深入到每个维度中，详细地介绍了 MySQL 具体的优化细节；最后我们讲了联合索引的最左匹配原则，以及慢查询的具体解决方案。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/18.关系型数据和文档型数据库有什么区别？.md b/Java基础教程/Java面试原理/18.关系型数据和文档型数据库有什么区别？.md
new file mode 100644
index 00000000..3fcff1bf
--- /dev/null
+++ b/Java基础教程/Java面试原理/18.关系型数据和文档型数据库有什么区别？.md
@@ -0,0 +1,104 @@
+# 关系型数据和文档型数据库有什么区别？
+
+关系数据库（Relational Database）是建立在关系模型基础上的数据库，借助于几何代数等数学概念和方法来处理数据库中的数据。所谓关系模型是一对一、一对多或者多对多等关系，常见的关系型数据库有 Oracle、SQL Server、DB2、MySQL 等。
+
+而文档型数据库是一种非关系型数据库，非关系型数据库（Not Only SQL，NoSQL）正好与关系型数据库相反，它不是建立在“关系模型”上的数据库。文档型数据库的典型代表是 MongoDB。
+
+我们本课时的面试题是，关系型数据库和文档型数据库有什么区别？
+
+## 典型回答
+
+关系型数据库属于早期的传统型数据库，它有着标准化的数据模型，以及事务和持久化的支持、例如，关系型数据库都会支持的 ACID 特性，也就是原子性（Atomicity）、一致性（Consistency）、隔离性（Isolation）和持久性（Durability），具体含义如下。
+
+* **原子性（Atomicity）**：是指一个事务中的所有操作，要么全部完成、要么全部不完成，不会存在中间的状态。也就是说事务在正常的情况下会执行完成；异常的情况下，比如在执行的过程中如果出现问题，会回滚成最初的状态，而非中间状态。
+* **一致性（Consistency）**：是指事务从开始执行到结束执行之间的中间状态不会被其他事务看到。
+* **隔离性（Isolation）**：是指数据库允许多个事务同时对数据进行读写或修改的能力，并且整个过程对各个事务来说是相互隔离的。
+* **持久性（Durability）**：是指每次事务提交之后都不会丢失。
+
+关系型数据库一般遵循三范式设计思想，具体内容如下。
+
+**第一范式（The First Normal Form，1NF）**：要求对属性的原子性，也就是说要求数据库中的字段需要具备原子性，不能再被拆分。
+
+比如，用户表中有字段：用户 ID、用户名、电话；而其中电话又可以分为：家庭电话和移动电话等。因此，此表不符合第一范式，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200615205857.png)
+
+**第二范式（The Second Normal Form，2NF）**：例如订单详情表有这些字段：订单 ID、产品 ID、产品名称、产品单价、折扣。其中，订单 ID 和产品 ID 为联合主键，但这个表中的产品名称和产品单价两个字段只依赖产品 ID，和订单 ID 就没有任何关系了，因此这个表也不符合第二范式。
+
+我们可以把原来的订单表拆分为订单表和产品表，其中订单表包含：订单 ID、产品 ID、折扣等字段；而产品表包含：产品 ID、产品名称、产品单价等字段。这样就消除了产品名称和产品单价多次重复出现的情况了，从而避免了冗余数据的产生。
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200615210023.png)
+
+**第三范式（The Third Normal Form，3NF）**：想要满足第三范式必须先满足第二范式，第三范式要求所有的非主键字段必须直接依赖主键，且不存在传递依赖的情况。
+
+例如，有一个学生表中包含了：学生 ID、姓名、所在学院 ID、学院电话、学院地址等字段。这个表的所有字段（除去主键字段）都完全依赖唯一的主键字段（学生 ID），所以符合第二范式。但它存在一个问题，学院电话、学院地址依赖非主键字段学院 ID，而不是直接依赖于主键，它是通过传递才依赖于主键，所以不符合第三范式。
+
+我们可以把学生表分为两张表，一张是学生表包含了：学生 ID、姓名、所在学院 ID 等字段；另一张为学院表包含了：学院 ID、学院电话、学院地址等字段，这样就满足第三范式的要求了。
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200615210155.png)
+
+可以看出，使用三范式可以避免数据的冗余，而且在更新表操作时，只需要更新单张表就可以了。
+
+但随着互联网应用的快速发展，我们需要应对日益复杂且快速迭代的数据库，以应对互联网快速发展的趋势，于是诞生了以 MongoDB 为代表的文档型数据库。它提供了更高效的读/写性能以及可自动容灾的数据库集群，还有灵活的数据库结构，从而给系统的数据库存储带来了更多可能 性。
+
+当然 MongoDB 的诞生并不是为了替代关系型数据库，而是为系统的快速开发提供一种可能性，它和关系型数据库是一种互补的关系，可供开发者在不同的业务场景下选择相对应的数据库类型。
+
+## 考点分析
+
+本课时的面试题考察的是面试者对数据库整体概念的理解与区分，这个问题看似简单，但包含着众多小的知识点，面试者需要真正的理解关系型数据库和非关系型数据库以及文档型数据库之间的区别才能灵活应对。与之相关的面试题还有：
+
+* 非关系型数据库和文档型数据库有什么区别？
+* MongoDB 支持事务吗？
+
+# 知识扩展
+
+## 非关系型数据库 VS 文档型数据库
+非关系型数据和文档型数据库属于包含关系，非关系型数据包含了文档型数据库，文档型数据库属于非关系型数据。
+
+非关系型数据通常包含 3 种数据库类型：文档型数据库、键值型数据库和全文搜索型数据库，下面分别来看每种类型的具体用途。
+
+### 1.文档型数据库
+
+文档型数据库以 MongoDB 和 Apache CouchDB 为代表，文档型数据库通常以 JSON 或者 XML 为格式进行数据存储。
+
+以 MongoDB 为例，它是由 C++ 编写的一种面向文档的数据库管理系统，在 2007 年 10 月 由 10gen 团队所开发，并在 2009 年 2 月首度推出。MongoDB 是以二进制 JSON 格式存储数据的，MongoDB 对 JSON 做了一些优化，它支持了更多的数据类型，这种二进制存储的 JSON 我们也可以称之为 BSON（Binary JSON）。
+
+BSON 具备三个特点：轻量、可遍历以及高效，它的缺点是空间利用率不是很理想。MongoDB 使用 BSON 进行存储的另一个重要原因是 BSON 具备可遍历性。
+
+MongoDB 存储结构示例如下：
+
+```json
+{"_id":ObjectId(“57ce2d4cce8685a6fd9df3a3"),"name":"老王","email":['java@qq.com','java@163.com']}
+```
+
+其中，“_id”为 MongoDB 默认的主键字段，它会为我们生成一起全局唯一的 id 值，并且这个值在做数据分片时非常有用。
+
+文档型数据库的使用场景如下。
+
+* **敏捷开发**，因为 MongoDB 拥有比关系型数据库更快的开发速度，因此很多敏捷开发组织，包括纽约时报等都采用了 MongoDB 数据库。使用它可以有效地避免在增加和修改数据库带来的沟通成本，以及维护和创建数据库模型成本，使用 MongoDB 只需要在程序层面严格把关就行，程序提交的数据结构可以直接更新到数据库中，并不需要繁杂的设计数据库模型再生成修改语句等过程。
+* **日志系统**，使用 MongoDB 数据库非常适合存储日志，日志对应到数据库中就是很多个文件，而 MongoDB 更擅长存储和查询文档，它提供了更简单的存储和更方便的查询功能。
+* **社交系统**，使用 MongoDB 可以很方便的存储用户的位置信息，可以方便的实现查询附近的人以及附近的地点等功能。
+
+### 2. 键值型数据库
+
+键值数据库也就是 Key-Value 数据库，它的典型代表数据库是 Redis 和 Memcached，而它们通常被当做非持久化的内存型数据库缓存来使用。当然 Redis 数据库是具备可持久化得能力的，但是开启持久化会降低系统的运行效率，因此在使用时需要根据实际的情况，选择开启或者关闭持久化的功能。
+
+键值型数据库以极高的性能著称，且除了 Key-Value 字符串类型之外，还包含一些其他的数据类型。以 Redis 为例，它提供了字符串类型（String）、列表类型（List）、哈希表类型（Hash）、集合类型（Set）、有序集合类型（ZSet）等五种最常用的基础数据类型，还有管道类型（Pipeline）、地理位置类型（GEO）、基数统计类型（HyperLogLog）和流类型（Stream），并且还提供了消息队列的功能。
+
+此数据库的优点是性能比较高，缺点是对事务的支持不是很好。
+
+### 3. 全文搜索型数据库
+
+传统的关系型数据库主要是依赖索引来实现快速查询功能的，而在全文搜索的业务下，索引很难满足查询的需求。因为全文搜索需要支持模糊匹配的，当数据量比较大的情况下，传递的关系型数据库的查询效率是非常低的；另一个原因是全文搜索需要支持多条件随意组合排序，如果要通过索引来实现的话，则需要创建大量的索引，而传统型数据库也很难实现，因此需要专门全文搜索引擎和相关的数据库才能实现此功能。
+
+全文搜索型数据库以 ElasticSearch 和 Solr 为代表，它们的出现解决了关系型数据库全文搜索功能较弱的问题。
+
+## MongoDB 事务
+MongoDB 在 4.0 之前是不支持事务的，不支持的原因也很简单，因为文档型数据库和传统的关系型数据库不一样，不需要满足三范式。文档型数据库之所以性能比较高的另一个主要原因，就是使用文档型数据库不用进行多表关联性查询，因为文档型数据库会把相关的信息存放到一张表中。因此，无需关联多表查询的 MongoDB，在这种情况下的查询性能是比较高的。
+
+把所有相关的数据都放入一个表中，这也是 MongoDB 之前很长一段时间内不支持事务的原因，它可以保证单表操作的原子性，一条记录要么成功插入，要么插入失败，不会存在插入了一半的数据。因此，在这种设计思路下，MongoDB 官方认为“事务功能”的实现没有那么紧迫。
+
+但在 MongoDB 4.0 之中正式添加了事务的功能，并且在 MongoDB 4.2 中实现了分布式事务的功能，至此 MongoDB 开启了支持事务之旅。
+
+# 小结
+本课时我们首先讲了关系型数据库的 ACID 特性以及设计时需要遵循的三范式设计思想；然后介绍了以 MongoDB 为代表的文档型数据库与关系型数据库的不同；最后还讲了 MongoDB 的事务功能，以及文档性数据库与非关系型数据库的关系，希望本课时的内容对你有帮助。
diff --git a/Java基础教程/Java面试原理/19.Redis的过期策略和内存淘汰机制有什么区别？.md b/Java基础教程/Java面试原理/19.Redis的过期策略和内存淘汰机制有什么区别？.md
new file mode 100644
index 00000000..45a3a9a4
--- /dev/null
+++ b/Java基础教程/Java面试原理/19.Redis的过期策略和内存淘汰机制有什么区别？.md
@@ -0,0 +1,217 @@
+# Redis 的过期策略和内存淘汰机制有什么区别？
+
+Redis 和 MySQL 是面试绕不过的两座大山，他们一个是关系型数据库的代表（MySQL），一个是键值数据库以及缓存中间件的一哥。尤其 Redis 几乎是所有互联网公司都在用的技术，比如国内的 BATJ、新浪、360、小米等公司；国外的微软、Twitter、Stack Overflow、GitHub、暴雪等公司。有的公司用 MySQL、有的用 SQL Server、甚至还有的用 Oracle 和 DB2，但缓存无一例外使用的都是 Redis，从某种程度上来讲 Redis 是普及率最高的技术，没有之一。
+
+我们本课时的面试题是，Redis 是如何处理过期数据的？当内存不够用时 Redis 又是如何处理的？
+
+## 典型回答
+
+我们在新增 Redis 缓存时可以设置缓存的过期时间，该时间保证了数据在规定的时间内失效，可以借助这个特性来实现很多功能。比如，存储一定天数的用户（登录）会话信息，这样在一定范围内用户不用重复登录了，但为了安全性，需要在一定时间之后重新验证用户的信息。因此，我们可以使用 Redis 设置过期时间来存储用户的会话信息。
+
+对于已经过期的数据，Redis 将使用两种策略来删除这些过期键，它们分别是惰性删除和定期删除。
+
+### 惰性删除
+
+惰性删除是指 Redis 服务器不主动删除过期的键值，而是当访问键值时，再检查当前的键值是否过期，如果过期则执行删除并返回 null 给客户端；如果没过期则正常返回值信息给客户端。
+
+它的优点是不会浪费太多的系统资源，只是在每次访问时才检查键值是否过期。缺点是删除过期键不及时，造成了一定的空间浪费。
+
+惰性删除的源码位于 src/db.c 文件的 expireIfNeeded 方法中，如下所示：
+
+```c
+int expireIfNeeded(redisDb *db, robj *key) {
+    // 判断键是否过期
+    if (!keyIsExpired(db,key)) return 0;
+    if (server.masterhost != NULL) return 1;
+    /* 删除过期键 */
+    // 增加过期键个数
+    server.stat_expiredkeys++;
+    // 传播键过期的消息
+    propagateExpire(db,key,server.lazyfree_lazy_expire);
+    notifyKeyspaceEvent(NOTIFY_EXPIRED,
+        "expired",key,db->id);
+    // server.lazyfree_lazy_expire 为 1 表示异步删除，否则则为同步删除
+    return server.lazyfree_lazy_expire ? dbAsyncDelete(db,key) :
+                                         dbSyncDelete(db,key);
+}
+// 判断键是否过期
+int keyIsExpired(redisDb *db, robj *key) {
+    mstime_t when = getExpire(db,key);
+    if (when < 0) return 0; 
+    if (server.loading) return 0;
+    mstime_t now = server.lua_caller ? server.lua_time_start : mstime();
+    return now > when;
+}
+// 获取键的过期时间
+long long getExpire(redisDb *db, robj *key) {
+    dictEntry *de;
+    if (dictSize(db->expires) == 0 ||
+       (de = dictFind(db->expires,key->ptr)) == NULL) return -1;
+    serverAssertWithInfo(NULL,key,dictFind(db->dict,key->ptr) != NULL);
+    return dictGetSignedIntegerVal(de);
+}
+```
+
+惰性删除的执行流程如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200616182536.png)
+
+### 定期删除
+
+除了惰性删除之外，Redis 还提供了定期删除功能以弥补惰性删除的不足。
+
+定期删除是指 Redis 服务器每隔一段时间会检查一下数据库，看看是否有过期键可以被清除。
+
+默认情况下 Redis 定期检查的频率是每秒扫描 10 次，用于定期清除过期键。当然此值还可以通过配置文件进行设置，在 redis.conf 中修改配置“hz”即可，默认的值为“hz 10”。
+
+> 小贴士：定期删除的扫描并不是遍历所有的键值对，这样的话比较费时且太消耗系统资源。Redis 服务器采用的是随机抽取形式，每次从过期字典中，取出 20 个键进行过期检测，过期字典中存储的是所有设置了过期时间的键值对。如果这批随机检查的数据中有 25% 的比例过期，那么会再抽取 20 个随机键值进行检测和删除，并且会循环执行这个流程，直到抽取的这批数据中过期键值小于 25%，此次检测才算完成。
+
+定期删除的源码在 expire.c 文件的 activeExpireCycle 方法中，如下所示：
+
+```c
+void activeExpireCycle(int type) {
+    static unsigned int current_db = 0; /* 上次定期删除遍历到的数据库ID */
+    static int timelimit_exit = 0;      
+    static long long last_fast_cycle = 0; /* 上次执行定期删除的时间点 */
+    int j, iteration = 0;
+    int dbs_per_call = CRON_DBS_PER_CALL; // 需要遍历数据库的数量
+    long long start = ustime(), timelimit, elapsed;
+    if (clientsArePaused()) return;
+    if (type == ACTIVE_EXPIRE_CYCLE_FAST) {
+        if (!timelimit_exit) return;
+        // ACTIVE_EXPIRE_CYCLE_FAST_DURATION 快速定期删除的执行时长
+        if (start < last_fast_cycle + ACTIVE_EXPIRE_CYCLE_FAST_DURATION*2) return;
+        last_fast_cycle = start;
+    }
+    if (dbs_per_call > server.dbnum || timelimit_exit)
+        dbs_per_call = server.dbnum;
+    // 慢速定期删除的执行时长
+    timelimit = 1000000*ACTIVE_EXPIRE_CYCLE_SLOW_TIME_PERC/server.hz/100;
+    timelimit_exit = 0;
+    if (timelimit <= 0) timelimit = 1;
+    if (type == ACTIVE_EXPIRE_CYCLE_FAST)
+        timelimit = ACTIVE_EXPIRE_CYCLE_FAST_DURATION; /* 删除操作花费的时间 */
+    long total_sampled = 0;
+    long total_expired = 0;
+    for (j = 0; j < dbs_per_call && timelimit_exit == 0; j++) {
+        int expired;
+        redisDb *db = server.db+(current_db % server.dbnum);
+        current_db++;
+        do {
+            // .......
+            expired = 0;
+            ttl_sum = 0;
+            ttl_samples = 0;
+            // 每个数据库中检查的键的数量
+            if (num > ACTIVE_EXPIRE_CYCLE_LOOKUPS_PER_LOOP)
+                num = ACTIVE_EXPIRE_CYCLE_LOOKUPS_PER_LOOP;
+            // 从数据库中随机选取 num 个键进行检查
+            while (num--) {
+                dictEntry *de;
+                long long ttl;
+                if ((de = dictGetRandomKey(db->expires)) == NULL) break;
+                ttl = dictGetSignedInteger
+                // 过期检查，并对过期键进行删除
+                if (activeExpireCycleTryExpire(db,de,now)) expired++;
+                if (ttl > 0) {
+                    ttl_sum += ttl;
+                    ttl_samples++;
+                }
+                total_sampled++;
+            }
+            total_expired += expired;
+            if (ttl_samples) {
+                long long avg_ttl = ttl_sum/ttl_samples;
+                if (db->avg_ttl == 0) db->avg_ttl = avg_ttl;
+                db->avg_ttl = (db->avg_ttl/50)*49 + (avg_ttl/50);
+            }
+            if ((iteration & 0xf) == 0) { /* check once every 16 iterations. */
+                elapsed = ustime()-start;
+                if (elapsed > timelimit) {
+                    timelimit_exit = 1;
+                    server.stat_expired_time_cap_reached_count++;
+                    break;
+                }
+            }
+            /* 判断过期键删除数量是否超过 25% */
+        } while (expired > ACTIVE_EXPIRE_CYCLE_LOOKUPS_PER_LOOP/4);
+    }
+    // .......
+}
+```
+
+定期删除的执行流程，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200616182843.png)
+
+> 小贴士：Redis 服务器为了保证过期删除策略不会导致线程卡死，会给过期扫描增加了最大执行时间为 25ms。
+
+以上是 Redis 服务器对待过期键的处理方案，当 Redis 的内存超过最大允许的内存之后，Redis 会触发内存淘汰策略，这和过期策略是完全不同的两个概念，经常有人把二者搞混，这两者一个是在正常情况下清除过期键，一个是在非正常情况下为了保证 Redis 顺利运行的保护策略。
+
+当 Redis 内存不够用时，Redis 服务器会根据服务器设置的淘汰策略，删除一些不常用的数据，以保证 Redis 服务器的顺利运行。
+
+## 考点分析
+本课时的面试题并非 Redis 的入门级面试题，需要面试者对 Redis 有一定的了解才能对答如流，并且 Redis 的过期淘汰策略和内存淘汰策略的概念比较类似，都是用于淘汰数据的。因此很多人会把二者当成一回事，但其实并不是，这个面试者特别注意一下，和此知识点相关的面试题还有以下这些：
+
+* Redis 内存淘汰策略有哪些？
+* Redis 有哪些内存淘汰算法？
+
+# 知识扩展
+
+## Redis 内存淘汰策略
+我们可以使用 `config get maxmemory-policy`命令，来查看当前 Redis 的内存淘汰策略，示例代码如下：
+
+```shell
+127.0.0.1:6379> config get maxmemory-policy
+1) "maxmemory-policy"
+2) "noeviction"
+```
+
+从上面的结果可以看出，当前 Redis 服务器设置的是“noeviction”类型的内存淘汰策略，那么这表示什么含义呢？Redis 又有几种内存淘汰策略呢？
+
+在 4.0 版本之前 Redis 的内存淘汰策略有以下 6 种。
+
+* noeviction：不淘汰任何数据，当内存不足时，执行缓存新增操作会报错，它是 Redis 默认内存淘汰策略。
+* allkeys-lru：淘汰整个键值中最久未使用的键值。
+* allkeys-random：随机淘汰任意键值。
+* volatile-lru：淘汰所有设置了过期时间的键值中最久未使用的键值。
+* volatile-random：随机淘汰设置了过期时间的任意键值。
+* volatile-ttl：优先淘汰更早过期的键值。
+
+可以看出我们上面示例使用的是 Redis 默认的内存淘汰策略“noeviction”。
+
+而在 Redis 4.0 版本中又新增了 2 种淘汰策略：
+
+* volatile-lfu，淘汰所有设置了过期时间的键值中最少使用的键值；
+* allkeys-lfu，淘汰整个键值中最少使用的键值。
+
+> 小贴士：从以上内存淘汰策略中可以看出，allkeys-xxx 表示从所有的键值中淘汰数据，而 volatile-xxx 表示从设置了过期键的键值中淘汰数据。
+
+这个内存淘汰策略我们可以通过配置文件来修改，redis.conf 对应的配置项是“maxmemory-policy noeviction”，只需要把它修改成我们需要设置的类型即可。
+
+需要注意的是，如果使用修改 redis.conf 的方式，当设置完成之后需要重启 Redis 服务器才能生效。
+
+还有另一种简单的修改内存淘汰策略的方式，我们可以使用命令行工具输入“config set maxmemory-policy noeviction”来修改内存淘汰的策略，这种修改方式的好处是执行成功之后就会生效，无需重启 Redis 服务器。但它的坏处是不能持久化内存淘汰策略，每次重启 Redis 服务器之后设置的内存淘汰策略就会丢失。
+
+## Redis 内存淘汰算法
+内存淘汰算法主要包含两种：LRU 淘汰算法和 LFU 淘汰算法。
+
+### LRU 淘汰算法
+
+LRU（ Least Recently Used，最近最少使用）淘汰算法：是一种常用的页面置换算法，也就是说最久没有使用的缓存将会被淘汰。
+
+LRU 是基于链表结构实现的，链表中的元素按照操作顺序从前往后排列，最新操作的键会被移动到表头，当需要进行内存淘汰时，只需要删除链表尾部的元素即可。
+
+Redis 使用的是一种近似 LRU 算法，目的是为了更好的节约内存，它的实现方式是给现有的数据结构添加一个额外的字段，用于记录此键值的最后一次访问时间。Redis 内存淘汰时，会使用随机采样的方式来淘汰数据，它是随机取 5 个值 (此值可配置) ，然后淘汰最久没有使用的数据。
+
+### LFU 淘汰算法
+
+LFU（Least Frequently Used，最不常用的）淘汰算法：最不常用的算法是根据总访问次数来淘汰数据的，它的核心思想是“如果数据过去被访问多次，那么将来被访问的频率也更高”。
+
+LFU 相对来说比 LRU 更“智能”，因为它解决了使用频率很低的缓存，只是最近被访问了一次就不会被删除的问题。如果是使用 LRU 类似这种情况数据是不会被删除的，而使用 LFU 的话，这个数据就会被删除。
+
+Redis 内存淘汰策略使用了 LFU 和近 LRU 的淘汰算法，具体使用哪种淘汰算法，要看服务器是如何设置内存淘汰策略的，也就是要看“maxmemory-policy”的值是如何设置的。
+
+# 小结
+
+本课时我们讲了 Redis 的过期删除策略：惰性删除 + 定期删除；还讲了 Redis 的内存淘汰策略，它和过期策略是完全不同的两个概念，内存淘汰策略是当内存不够用时才会触发的一种机制，它在 Redis 4.0 之后提供了 8 种内存淘汰策略，这些淘汰策略主要使用了近 LRU 淘汰算法和 LFU 淘汰算法。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/20.Redis怎样实现的分布式锁？.md b/Java基础教程/Java面试原理/20.Redis怎样实现的分布式锁？.md
new file mode 100644
index 00000000..6dce66a6
--- /dev/null
+++ b/Java基础教程/Java面试原理/20.Redis怎样实现的分布式锁？.md
@@ -0,0 +1,130 @@
+# Redis 怎样实现的分布式锁？
+
+“锁”是我们实际工作和面试中无法避开的话题之一，正确使用锁可以保证高并发环境下程序的正确执行，也就是说只有使用锁才能保证多人同时访问时程序不会出现问题。
+
+我们本课时的面试题是，什么是分布式锁？如何实现分布式锁？
+
+## 典型回答
+
+第06篇时讲了单机锁的一些知识，包括悲观锁、乐观锁、可重入锁、共享锁和独占锁等内容，但它们都属于单机锁也就是程序级别的锁，如果在分布式环境下使用就会出现锁不生效的问题，因此我们需要使用分布式锁来解决这个问题。
+
+分布式锁是控制分布式系统之间同步访问共享资源的一种方式。是为了解决分布式系统中，不同的系统或是同一个系统的不同主机共享同一个资源的问题，它通常会采用互斥来保证程序的一致性，这就是分布式锁的用途以及执行原理。
+
+分布式锁示意图，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200616185240.png)
+
+分布式锁的常见实现方式有四种：
+
+* 基于 MySQL 的悲观锁来实现分布式锁，这种方式使用的最少，因为这种实现方式的性能不好，且容易造成死锁；
+* 基于 Memcached 实现分布式锁，可使用 add 方法来实现，如果添加成功了则表示分布式锁创建成功；
+* 基于 Redis 实现分布式锁，这也是本课时要介绍的重点，可以使用 setnx 方法来实现；
+* 基于 ZooKeeper 实现分布式锁，利用 ZooKeeper 顺序临时节点来实现。
+
+由于 MySQL 的执行效率问题和死锁问题，所以这种实现方式会被我们先排除掉，而 Memcached 和 Redis 的实现方式比较类似，但因为 Redis 技术比较普及，所以会优先使用 Redis 来实现分布式锁，而 ZooKeeper 确实可以很好的实现分布式锁。但此技术在中小型公司的普及率不高，尤其是非 Java 技术栈的公司使用的较少，如果只是为了实现分布式锁而重新搭建一套 ZooKeeper 集群，显然实现成本和维护成本太高，所以综合以上因素，我们本文会采用 Redis 来实现分布式锁。
+
+之所以可以使用以上四种方式来实现分布式锁，是因为以上四种方式都属于程序调用的“外部系统”，而分布式的程序是需要共享“外部系统”的，这就是分布式锁得以实现的基本前提。
+
+## 考点分析
+分布式锁的问题看似简单，但却有很多细节需要注意，比如，需要考虑分布式锁的超时问题，如果不设置超时时间的话，可能会导致死锁的产生，所以在对待这个“锁”的问题上，一定不能马虎。和此知识点相关的面试还有以下这些：
+
+* 单机锁有哪些？它为什么不能在分布式环境下使用？
+* Redis 是如何实现分布式锁的？可能会遇到什么问题？
+* 分布式锁超时的话会有什么问题？如何解决？
+
+# 知识扩展
+
+## 单机锁
+程序中使用的锁叫单机锁，我们日常中所说的“锁”都泛指单机锁，其分类有很多，大体可分为以下几类：
+
+* **悲观锁**，是数据对外界的修改采取保守策略，它认为线程很容易把数据修改掉，因此在整个数据被修改的过程中都会采取锁定状态，直到一个线程使用完，其他线程才可以继续使用，典型应用是 synchronized；
+* **乐观锁**，和悲观锁的概念恰好相反，乐观锁认为一般情况下数据在修改时不会出现冲突，所以在数据访问之前不会加锁，只是在数据提交更改时，才会对数据进行检测，典型应用是 ReadWriteLock 读写锁；
+* **可重入锁**，也叫递归锁，指的是同一个线程在外面的函数获取了锁之后，那么内层的函数也可以继续获得此锁，在 Java 语言中 ReentrantLock 和 synchronized 都是可重入锁；
+* **独占锁和共享锁**，只能被单线程持有的锁叫做独占锁，可以被多线程持有的锁叫共享锁，独占锁指的是在任何时候最多只能有一个线程持有该锁，比如 ReentrantLock 就是独占锁；而 ReadWriteLock 读写锁允许同一时间内有多个线程进行读操作，它就属于共享锁。
+
+单机锁之所以不能应用在分布式系统中是因为，在分布式系统中，每次请求可能会被分配在不同的服务器上，而单机锁是在单台服务器上生效的。如果是多台服务器就会导致请求分发到不同的服务器，从而导致锁代码不能生效，因此会造成很多异常的问题，那么单机锁就不能应用在分布式系统中了。
+
+## 使用 Redis 实现分布式锁
+使用 Redis 实现分布式锁主要需要使用 setnx 方法，也就是 set if not exists（不存在则创建），具体的实现代码如下：
+
+```shell
+127.0.0.1:6379> setnx lock true
+(integer) 1 #创建锁成功
+#逻辑业务处理...
+127.0.0.1:6379> del lock
+(integer) 1 #释放锁
+```
+
+当执行 setnx 命令之后返回值为 1 的话，则表示创建锁成功，否则就是失败。释放锁使用 del 删除即可，当其他程序 setnx 失败时，则表示此锁正在使用中，这样就可以实现简单的分布式锁了。
+
+但是以上代码有一个问题，就是没有设置锁的超时时间，因此如果出现异常情况，会导致锁未被释放，而其他线程又在排队等待此锁就会导致程序不可用。
+
+有人可能会想到使用 expire 来设置键值的过期时间来解决这个问题，例如以下代码：
+
+```shell
+127.0.0.1:6379> setnx lock true
+(integer) 1 #创建锁成功
+127.0.0.1:6379> expire lock 30 #设置锁的(过期)超时时间为 30s
+(integer) 1 
+#逻辑业务处理...
+127.0.0.1:6379> del lock
+(integer) 1 #释放锁
+```
+
+但这样执行仍然会有问题，因为 setnx lock true 和 expire lock 30 命令是非原子的，也就是一个执行完另一个才能执行。但如果在 setnx 命令执行完之后，发生了异常情况，那么就会导致 expire 命令不会执行，因此依然没有解决死锁的问题。
+
+这个问题在 Redis 2.6.12 之前一直没有得到有效的处理，当时的解决方案是在客户端进行原子合并操作，于是就诞生了很多客户端类库来解决此原子问题，不过这样就增加了使用的成本。因为你不但要添加 Redis 的客户端，还要为了解决锁的超时问题，需额外的增加新的类库，这样就增加了使用成本，但这个问题在 Redis 2.6.12 版本中得到了有效的处理。
+
+在 Redis 2.6.12 中我们可以使用一条 set 命令来执行键值存储，并且可以判断键是否存在以及设置超时时间了，如下代码所示：
+
+```shell
+127.0.0.1:6379> set lock true ex 30 nx
+OK #创建锁成功
+```
+
+其中，ex 是用来设置超时时间的，而 nx 是 not exists 的意思，用来判断键是否存在。如果返回的结果为“OK”则表示创建锁成功，否则表示此锁有人在使用。
+
+## 锁超时
+从上面的内容可以看出，使用 set 命令之后好像一切问题都解决了，但在这里我要告诉你，其实并没有。例如，我们给锁设置了超时时间为 10s，但程序的执行需要使用 15s，那么在第 10s 时此锁因为超时就会被释放，这时候线程二在执行 set 命令时正常获取到了锁，于是在很短的时间内 2s 之后删除了此锁，这就造成了锁被误删的情况，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200616190418.png)
+
+锁被误删的解决方案是在使用 set 命令创建锁时，给 value 值设置一个归属标识。例如，在 value 中插入一个 UUID，每次在删除之前先要判断 UUID 是不是属于当前的线程，如果属于再删除，这样就避免了锁被误删的问题。
+
+注意：在锁的归属判断和删除的过程中，不能先判断锁再删除锁，如下代码所示：
+
+```java
+if(uuid.equals(uuid)){ // 判断是否是自己的锁
+	del(luck); // 删除锁
+}
+```
+
+应该把判断和删除放到一个原子单元中去执行，因此需要借助 Lua 脚本来执行，在 Redis 中执行 Lua 脚本可以保证这批命令的原子性，它的实现代码如下：
+
+```java
+/**
+ * 释放分布式锁
+ * @param jedis Redis客户端
+ * @param lockKey 锁的 key
+ * @param flagId 锁归属标识
+ * @return 是否释放成功
+ */
+public static boolean unLock(Jedis jedis, String lockKey, String flagId) {
+    String script = "if redis.call('get', KEYS[1]) == ARGV[1] then return redis.call('del', KEYS[1]) else return 0 end";
+    Object result = jedis.eval(script, Collections.singletonList(lockKey), Collections.singletonList(flagId));
+    if ("1L".equals(result)) { // 判断执行结果
+        return true;
+    }
+    return false;
+}
+```
+
+其中，Collections.singletonList() 方法是将 String 转成 List，因为 jedis.eval() 最后两个参数要求必须是 List 类型。
+
+锁超时可以通过两种方案来解决：
+
+* 把执行耗时的方法从锁中剔除，减少锁中代码的执行时间，保证锁在超时之前，代码一定可以执行完；
+* 把锁的超时时间设置的长一些，正常情况下我们在使用完锁之后，会调用删除的方法手动删除锁，因此可以把超时时间设置的稍微长一些。
+
+# 小结
+本课时我们讲了分布式锁的四种实现方式，即 MySQL、Memcached、Redis 和 ZooKeeper，因为 Redis 的普及率比较高，因此对于很多公司来说使用 Redis 实现分布式锁是最优的选择。本课时我们还讲了使用 Redis 实现分布式锁的具体步骤以及实现代码，还讲了在实现过程中可能会遇到的一些问题以及解决方案。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/21.Redis中如何实现的消息队列？实现的方式有几种？.md b/Java基础教程/Java面试原理/21.Redis中如何实现的消息队列？实现的方式有几种？.md
new file mode 100644
index 00000000..0cbafe5e
--- /dev/null
+++ b/Java基础教程/Java面试原理/21.Redis中如何实现的消息队列？实现的方式有几种？.md
@@ -0,0 +1,313 @@
+# Redis 中如何实现的消息队列？实现的方式有几种？
+
+细心的你可能发现了，本系列课程中竟然出现了三篇都是在说消息队列，第10篇时讲了程序级别的消息队列以及延迟消息队列的实现，而第15篇讲了常见的消息队列中间件 RabbitMQ、Kafka 等，由此可见消息队列在整个 Java 技术体系中的重要程度。本课时我们将重点来看一下 Redis 是如何实现消息队列的。
+
+我们本课时的面试题是，在 Redis 中实现消息队列的方式有几种？
+
+## 典型回答
+早在 Redis 2.0 版本之前使用 Redis 实现消息队列的方式有两种：
+
+使用 List 类型实现
+使用 ZSet 类型实现
+其中使用**List 类型实现的方式最为简单和直接**，它主要是通过 lpush、rpop 存入和读取实现消息队列的，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200617150400.png)
+
+lpush 可以把最新的消息存储到消息队列（List 集合）的首部，而 rpop 可以读取消息队列的尾部，这样就实现了先进先出，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200617150614.png)
+
+命令行的实现命令如下：
+
+```shell
+127.0.0.1:6379> lpush mq "java" #推送消息 java
+(integer) 1
+127.0.0.1:6379> lpush mq "msg" #推送消息 msg
+(integer) 2
+127.0.0.1:6379> rpop mq #接收到消息 java
+"java"
+127.0.0.1:6379> rpop mq #接收到消息 msg
+"mq"
+```
+
+其中，mq 相当于消息队列的名称，而 lpush 用于生产并添加消息，而 rpop 用于拉取并消费消息。
+使用 List 实现消息队列的优点是消息可以被持久化，List 可以借助 Redis 本身的持久化功能，AOF 或者是 RDB 或混合持久化的方式，用于把数据保存至磁盘，这样当 Redis 重启之后，消息不会丢失。
+
+但使用 List 同样存在一定的问题，比如消息不支持重复消费、没有按照主题订阅的功能、不支持消费消息确认等。
+
+ZSet 实现消息队列的方式和 List 类似，它是利用 zadd 和 zrangebyscore 来实现存入和读取消息的，这里就不重复叙述了。但 ZSet 的实现方式更为复杂一些，因为 ZSet 多了一个分值（score）属性，我们可以使用它来实现更多的功能，比如用它来存储时间戳，以此来实现延迟消息队列等。
+
+ZSet 同样具备持久化的功能，List 存在的问题它也同样存在，不但如此，使用 ZSet 还不能存储相同元素的值。因为它是有序集合，有序集合的存储元素值是不能重复的，但分值可以重复，也就是说当消息值重复时，只能存储一条信息在 ZSet 中。
+
+在 Redis 2.0 之后 Redis 就新增了专门的发布和订阅的类型，Publisher（发布者）和 Subscriber（订阅者）来实现消息队列了，它们对应的执行命令如下：
+
+* 发布消息，publish channel "message"
+* 订阅消息，subscribe channel
+
+使用发布和订阅的类型，我们可以实现主题订阅的功能，也就是 Pattern Subscribe 的功能。因此我们可以使用一个消费者“queue_*”来订阅所有以“queue_”开头的消息队列，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200617151011.png)
+
+发布订阅模式的优点很明显，但同样存在以下 3 个问题：
+
+* 无法持久化保存消息，如果 Redis 服务器宕机或重启，那么所有的消息将会丢失；
+* 发布订阅模式是“发后既忘”的工作模式，如果有订阅者离线重连之后就不能消费之前的历史消息；
+* 不支持消费者确认机制，稳定性不能得到保证，例如当消费者获取到消息之后，还没来得及执行就宕机了。因为没有消费者确认机制，Redis 就会误以为消费者已经执行了，因此就不会重复发送未被正常消费的消息了，这样整体的 Redis 稳定性就被没有办法得到保障了。
+
+然而在 Redis 5.0 之后新增了 Stream 类型，我们就可以使用 Stream 的 xadd 和 xrange 来实现消息的存入和读取了，并且 Stream 提供了 xack 手动确认消息消费的命令，用它我们就可以实现消费者确认的功能了，使用命令如下：
+
+```shell
+127.0.0.1:6379> xack mq group1 1580959593553-0
+(integer) 1
+```
+
+相关语法如下：
+
+```
+xack key group-key ID [ID ...] 
+```
+
+消费确认增加了消息的可靠性，一般在业务处理完成之后，需要执行 xack 确认消息已经被消费完成，整个流程的执行如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200617151524.png)
+
+其中“Group”为群组，消费者也就是接收者需要订阅到群组才能正常获取到消息。
+
+以上就 Redis 实现消息队列的四种方式，他们分别是：
+
+* 使用 List 实现消息队列；
+* 使用 ZSet 实现消息队列；
+* 使用发布订阅者模式实现消息队列；
+* 使用 Stream 实现消息队列。
+
+## 考点分析
+本课时的题目比较全面的考察了面试者对于 Redis 整体知识框架和新版本特性的理解和领悟。早期版本中比较常用的实现消息队列的方式是 List、ZSet 和发布订阅者模式，使用 Stream 来实现消息队列是近两年才流行起来的方案，并且很多企业也没有使用到 Redis 5.0 这么新的版本。因此只需回答出前三种就算及格了，而 Stream 方式实现消息队列属于附加题，如果面试中能回答上来的话就更好了，它体现了你对新技术的敏感度与对技术的热爱程度，属于面试中的加分项。
+
+和此知识点相关的面试题还有以下几个：
+
+* 在 Java 代码中使用 List 实现消息队列会有什么问题？应该如何解决？
+* 在程序中如何使用 Stream 来实现消息队列？
+
+# 知识扩展
+## 使用 List 实现消息队列
+
+在 Java 程序中我们需要使用 Redis 客户端框架来辅助程序操作 Redis，比如 Jedis 框架。
+
+使用 Jedis 框架首先需要在 pom.xml 文件中添加 Jedis 依赖，配置如下：
+
+```xml
+
+
+  redis.clients
+  jedis
+  ${version}
+
+```
+
+List 实现消息队列的完整代码如下：
+
+```java
+import redis.clients.jedis.Jedis;
+publicclass ListMQTest {
+    public static void main(String[] args){
+        // 启动一个线程作为消费者
+        new Thread(() -> consumer()).start();
+        // 生产者
+        producer();
+    }
+    /**
+     * 生产者
+     */
+    public static void producer() {
+        Jedis jedis = new Jedis("127.0.0.1", 6379);
+        // 推送消息
+        jedis.lpush("mq", "Hello, List.");
+    }
+    /**
+     * 消费者
+     */
+    public static void consumer() {
+        Jedis jedis = new Jedis("127.0.0.1", 6379);
+        // 消费消息
+        while (true) {
+            // 获取消息
+            String msg = jedis.rpop("mq");
+            if (msg != null) {
+                // 接收到了消息
+                System.out.println("接收到消息：" + msg);
+            }
+        }
+    }
+}
+```
+
+以上程序的运行结果是：
+
+```
+接收到消息：Hello, Java.
+```
+
+但是以上的代码存在一个问题，可以看出以上消费者的实现是通过 while 无限循环来获取消息，但如果消息的空闲时间比较长，一直没有新任务，而 while 循环不会因此停止，它会一直执行循环的动作，这样就会白白浪费了系统的资源。
+
+此时我们可以借助 Redis 中的阻塞读来替代 rpop 的方法就可以解决此问题，具体实现代码如下：
+
+```java
+import redis.clients.jedis.Jedis;
+public class ListMQExample {
+    public static void main(String[] args) throws InterruptedException {
+        // 消费者
+        new Thread(() -> bConsumer()).start();
+        // 生产者
+        producer();
+    }
+    /**
+     * 生产者
+     */
+    public static void producer() throws InterruptedException {
+        Jedis jedis = new Jedis("127.0.0.1", 6379);
+        // 推送消息
+        jedis.lpush("mq", "Hello, Java.");
+        Thread.sleep(1000);
+        jedis.lpush("mq", "message 2.");
+        Thread.sleep(2000);
+        jedis.lpush("mq", "message 3.");
+    }
+    /**
+     * 消费者（阻塞版）
+     */
+    public static void bConsumer() {
+        Jedis jedis = new Jedis("127.0.0.1", 6379);
+        while (true) {
+            // 阻塞读
+            for (String item : jedis.brpop(0,"mq")) {
+                // 读取到相关数据，进行业务处理
+                System.out.println(item);
+            }
+        }
+    }
+}
+```
+
+以上程序的运行结果是：
+
+```
+接收到消息：Hello, Java.
+```
+
+以上代码是经过改良的，我们使用 brpop 替代 rpop 来读取最后一条消息，就可以解决 while 循环在没有数据的情况下，一直循环消耗系统资源的情况了。brpop 中的 b 是 blocking 的意思，表示阻塞读，也就是当队列没有数据时，它会进入休眠状态，当有数据进入队列之后，它才会“苏醒”过来执行读取任务，这样就可以解决 while 循环一直执行消耗系统资源的问题了。
+
+## 使用 Stream 实现消息队列
+在开始实现消息队列之前，我们必须先创建分组才行，因为消费者需要关联分组信息才能正常运行，具体实现代码如下：
+
+```java
+import com.google.gson.Gson;
+import redis.clients.jedis.Jedis;
+import redis.clients.jedis.StreamEntry;
+import redis.clients.jedis.StreamEntryID;
+import utils.JedisUtils;
+import java.util.AbstractMap;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+public class StreamGroupExample {
+    private static final String _STREAM_KEY = "mq"; // 流 key
+    private static final String _GROUP_NAME = "g1"; // 分组名称
+    private static final String _CONSUMER_NAME = "c1"; // 消费者 1 的名称
+    private static final String _CONSUMER2_NAME = "c2"; // 消费者 2 的名称
+    public static void main(String[] args) {
+        // 生产者
+        producer();
+        // 创建消费组
+        createGroup(_STREAM_KEY, _GROUP_NAME);
+        // 消费者 1
+        new Thread(() -> consumer()).start();
+        // 消费者 2
+        new Thread(() -> consumer2()).start();
+    }
+    /**
+     * 创建消费分组
+     * @param stream    流 key
+     * @param groupName 分组名称
+     */
+    public static void createGroup(String stream, String groupName) {
+        Jedis jedis = JedisUtils.getJedis();
+        jedis.xgroupCreate(stream, groupName, new StreamEntryID(), true);
+    }
+    /**
+     * 生产者
+     */
+    public static void producer() {
+        Jedis jedis = JedisUtils.getJedis();
+        // 添加消息 1
+        Map map = new HashMap<>();
+        map.put("data", "redis");
+        StreamEntryID id = jedis.xadd(_STREAM_KEY, null, map);
+        System.out.println("消息添加成功 ID：" + id);
+        // 添加消息 2
+        Map map2 = new HashMap<>();
+        map2.put("data", "java");
+        StreamEntryID id2 = jedis.xadd(_STREAM_KEY, null, map2);
+        System.out.println("消息添加成功 ID：" + id2);
+    }
+    /**
+     * 消费者 1
+     */
+    public static void consumer() {
+        Jedis jedis = JedisUtils.getJedis();
+        // 消费消息
+        while (true) {
+            // 读取消息
+            Map.Entry entry = new AbstractMap.SimpleImmutableEntry<>(_STREAM_KEY,
+                    new StreamEntryID().UNRECEIVED_ENTRY);
+            // 阻塞读取一条消息（最大阻塞时间120s）
+            List>> list = jedis.xreadGroup(_GROUP_NAME, _CONSUMER_NAME, 1,
+                    120 * 1000, true, entry);
+            if (list != null && list.size() == 1) {
+                // 读取到消息
+                Map content = list.get(0).getValue().get(0).getFields(); // 消息内容
+                System.out.println("Consumer 1 读取到消息 ID：" + list.get(0).getValue().get(0).getID() +
+                        " 内容：" + new Gson().toJson(content));
+            }
+        }
+    }
+    /**
+     * 消费者 2
+     */
+    public static void consumer2() {
+        Jedis jedis = JedisUtils.getJedis();
+        // 消费消息
+        while (true) {
+            // 读取消息
+            Map.Entry entry = new AbstractMap.SimpleImmutableEntry<>(_STREAM_KEY,
+                    new StreamEntryID().UNRECEIVED_ENTRY);
+            // 阻塞读取一条消息（最大阻塞时间120s）
+            List>> list = jedis.xreadGroup(_GROUP_NAME, _CONSUMER2_NAME, 1,
+                    120 * 1000, true, entry);
+            if (list != null && list.size() == 1) {
+                // 读取到消息
+                Map content = list.get(0).getValue().get(0).getFields(); // 消息内容
+                System.out.println("Consumer 2 读取到消息 ID：" + list.get(0).getValue().get(0).getID() +
+                        " 内容：" + new Gson().toJson(content));
+            }
+        }
+    }
+}
+```
+
+以上代码运行结果如下：
+
+````
+消息添加成功 ID：1580971482344-0
+消息添加成功 ID：1580971482415-0
+Consumer 1 读取到消息 ID：1580971482344-0 内容：{"data":"redis"}
+Consumer 2 读取到消息 ID：1580971482415-0 内容：{"data":"java"}
+````
+
+其中，jedis.xreadGroup() 方法的第五个参数 noAck 表示是否自动确认消息，如果设置 true 收到消息会自动确认 (ack) 消息，否则需要手动确认。
+
+可以看出，同一个分组内的多个 consumer 会读取到不同消息，不同的 consumer 不会读取到分组内的同一条消息。
+
+> 小贴士：Jedis 框架要使用最新版，低版本 block 设置大于 0 时，会出现 bug，抛连接超时异常。
+
+# 小结
+本课时我们讲了 Redis 中消息队列的四种实现方式：List 方式、ZSet 方式、发布订阅者模式、Stream 方式，其中发布订阅者模式不支持消息持久化、而其他三种方式支持持久化，并且 Stream 方式支持消费者确认。我们还使用 Jedis 框架完成了 List 和 Stream 的消息队列功能，需要注意的是在 List 中需要使用 brpop 来读取消息，而不是 rpop，这样可以解决没有任务时 ，while 一直循环浪费系统资源的问题。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/22.Redis是如何实现高可用的？.md b/Java基础教程/Java面试原理/22.Redis是如何实现高可用的？.md
new file mode 100644
index 00000000..618d0c8b
--- /dev/null
+++ b/Java基础教程/Java面试原理/22.Redis是如何实现高可用的？.md
@@ -0,0 +1,100 @@
+# Redis是如何实现高可用的？
+
+高可用是通过设计，减少系统不能提供服务的时间，是分布式系统的基础也是保障系统可靠性的重要手段。而 Redis 作为一款普及率最高的内存型中间件，它的高可用技术也非常的成熟。
+
+我们本课时的面试题是，Redis 是如何保证系统高可用的？它的实现方式有哪些？
+
+## 典型回答
+Redis 高可用的手段主要有以下四种：
+
+* 数据持久化
+* 主从数据同步（主从复制）
+* Redis 哨兵模式（Sentinel）
+* Redis 集群（Cluster）
+
+其中数据持久化保证了系统在发生宕机或者重启之后数据不会丢失，增加了系统的可靠性和减少了系统不可用的时间（省去了手动恢复数据的过程）；而主从数据同步可以将数据存储至多台服务器，这样当遇到一台服务器宕机之后，可以很快地切换至另一台服务器以继续提供服务；哨兵模式用于发生故障之后自动切换服务器；而 Redis 集群提供了多主多从的 Redis 分布式集群环境，用于提供性能更好的 Redis 服务，并且它自身拥有故障自动切换的能力。
+
+## 考点分析
+高可用的问题属于 Redis 中比较大的面试题了，因为很多知识点都和这个面试题有关，同时也属于比较难的面试题了。因为涉及了分布式集群，而分布式集群属于 Redis 中比较难懂的一个知识点。和此问题相关的面试题还有以下几个：
+
+* 数据持久化有几种方式？
+* Redis 主从同步有几种模式？
+* 什么是 Redis 哨兵模式？它解决了什么问题？
+* Redis 集群的优势是什么？
+
+# 知识扩展
+## 1.数据持久化
+
+持久化功能是 Redis 和 Memcached 的主要区别之一，因为只有 Redis 提供了此功能。
+
+在 Redis 4.0 之前数据持久化方式有两种：AOF 方式和 RDB 方式。
+
+RDB（Redis DataBase，快照方式）是将某一个时刻的内存数据，以二进制的方式写入磁盘。
+AOF（Append Only File，文件追加方式）是指将所有的操作命令，以文本的形式追加到文件中。
+
+RDB 默认的保存文件为 dump.rdb，优点是以二进制存储的，因此占用的空间更小、数据存储更紧凑，并且与 AOF 相比，RDB 具备更快的重启恢复能力。
+
+AOF 默认的保存文件为 appendonly.aof，它的优点是存储频率更高，因此丢失数据的风险就越低，并且 AOF 并不是以二进制存储的，所以它的存储信息更易懂。缺点是占用空间大，重启之后的数据恢复速度比较慢。
+
+可以看出 RDB 和 AOF 各有利弊，RDB 具备更快速的数据重启恢复能力，并且占用更小的磁盘空间，但有数据丢失的风险；而 AOF 文件的可读性更高，但却占用了更大的空间，且重启之后的恢复速度更慢，于是在 Redis 4.0 就推出了混合持久化的功能。
+
+混合持久化的功能指的是 Redis 可以使用 RDB + AOF 两种格式来进行数据持久化，这样就可以做到扬长避短物尽其用了，混合持久化的存储示意图如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200617153326.png)
+
+我们可以使用`config get aof-use-rdb-preamble`的命令来查询 Redis 混合持久化的功能是否开启，执行示例如下：
+
+```shell
+127.0.0.1:6379> config get aof-use-rdb-preamble
+1) "aof-use-rdb-preamble"
+2) "yes"
+```
+
+如果执行结果为“no”则表示混合持久化功能关闭，不过我们可以使用`config set aof-use-rdb-preamble yes`的命令打开此功能。
+Redis 混合持久化的存储模式是，开始的数据以 RDB 的格式进行存储，因此只会占用少量的空间，并且之后的命令会以 AOF 的方式进行数据追加，这样就可以减低数据丢失的风险，同时可以提高数据恢复的速度。
+
+## 2.Redis 主从同步
+主从同步是 Redis 多机运行中最基础的功能，它是把多个 Redis 节点组成一个 Redis 集群，在这个集群当中有一个主节点用来进行数据的操作，其他从节点用于同步主节点的内容，并且提供给客户端进行数据查询。
+
+Redis 主从同步分为：主从模式和从从模式。
+
+主从模式就是一个主节点和多个一级从节点，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200617153638.png)
+
+而从从模式是指一级从节点下面还可以拥有更多的从节点，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200617153733.png)
+
+主从模式可以提高 Redis 的整体运行速度，因为使用主从模式就可以实现数据的读写分离，把写操作的请求分发到主节点上，把其他的读操作请求分发到从节点上，这样就减轻了 Redis 主节点的运行压力，并且提高了 Redis 的整体运行速度。
+
+不但如此使用主从模式还实现了 Redis 的高可用，当主服务器宕机之后，可以很迅速的把从节点提升为主节点，为 Redis 服务器的宕机恢复节省了宝贵的时间。
+
+并且主从复制还降低了数据丢失的风险，因为数据是完整拷贝在多台服务器上的，当一个服务器磁盘坏掉之后，可以从其他服务器拿到完整的备份数据。
+
+## 3.Redis 哨兵模式
+Redis 主从复制模式有那么多的优点，但是有一个致命的缺点，就是当 Redis 的主节点宕机之后，必须人工介入手动恢复，那么到特殊时间段，比如公司组织全体团建或者半夜突然发生主节点宕机的问题，此时如果等待人工去处理就会很慢，这个时间是我们不允许的，并且我们还需要招聘专职的人来负责数据恢复的事，同时招聘的人还需要懂得相关的技术才能胜任这份工作。既然如此的麻烦，那有没有简单一点的解决方案，这个时候我们就需要用到 Redis 的哨兵模式了。
+
+Redis 哨兵模式就是用来监视 Redis 主从服务器的，当 Redis 的主从服务器发生故障之后，Redis 哨兵提供了自动容灾修复的功能，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200617154426.png)
+
+Redis 哨兵模块存储在 Redis 的 src/redis-sentinel 目录下，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200617154611.png)
+
+我们可以使用命令`./src/redis-sentinel sentinel.conf`来启动哨兵功能。
+
+有了哨兵功能之后，就再也不怕 Redis 主从服务器宕机了。哨兵的工作原理是每个哨兵会以每秒钟 1 次的频率，向已知的主服务器和从服务器，发送一个 PING 命令。如果最后一次有效回复 PING 命令的时间，超过了配置的最大下线时间（Down-After-Milliseconds）时，默认是 30s，那么这个实例会被哨兵标记为主观下线。
+
+如果一个主服务器被标记为主观下线，那么正在监视这个主服务器的所有哨兵节点，要以每秒 1 次的频率确认主服务器是否进入了主观下线的状态。如果有足够数量（quorum 配置值）的哨兵证实该主服务器为主观下线，那么这个主服务器被标记为客观下线。此时所有的哨兵会按照规则（协商）自动选出新的主节点服务器，并自动完成主服务器的自动切换功能，而整个过程都是无须人工干预的。
+
+## 4.Redis 集群
+Redis 集群也就是 Redis Cluster，它是 Redis 3.0 版本推出的 Redis 集群方案，将数据分布在不同的主服务器上，以此来降低系统对单主节点的依赖，并且可以大大提高 Redis 服务的读写性能。Redis 集群除了拥有主从模式 + 哨兵模式的所有功能之外，还提供了多个主从节点的集群功能，实现了真正意义上的分布式集群服务，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200617154826.png)
+
+Redis 集群可以实现数据分片服务，也就是说在 Redis 集群中有 16384 个槽位用来存储所有的数据，当我们有 N 个主节点时，可以把 16384 个槽位平均分配到 N 台主服务器上。当有键值存储时，Redis 会使用 crc16 算法进行 hash 得到一个整数值，然后用这个整数值对 16384 进行取模来得到具体槽位，再把此键值存储在对应的服务器上，读取操作也是同样的道理，这样我们就实现了数据分片的功能。
+
+# 小结
+本课时我们讲了保障 Redis 高可用的 4 种手段：数据持久化保证了数据不丢失；Redis 主从让 Redis 从单机变成了多机。它有两种模式：主从模式和从从模式，但当主节点出现问题时，需要人工手动恢复系统；Redis 哨兵模式用来监控 Redis 主从模式，并提供了自动容灾恢复的功能。最后是 Redis 集群，除了可以提供主从和哨兵的功能之外，还提供了多个主从节点的集群功能，这样就可以把数据均匀的存储各个主机主节点上，实现了系统的横向扩展，大大提高了 Redis 的并发处理能力。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/23.JVM 的内存布局和运行原理.md b/Java基础教程/Java面试原理/23.JVM 的内存布局和运行原理.md
new file mode 100644
index 00000000..204ed4ce
--- /dev/null
+++ b/Java基础教程/Java面试原理/23.JVM 的内存布局和运行原理.md	
@@ -0,0 +1,121 @@
+# 说一下 JVM 的内存布局和运行原理？
+
+JVM（Java Virtual Machine，Java 虚拟机）顾名思义就是用来执行 Java 程序的“虚拟主机”，实际的工作是将编译的 class 代码（字节码）翻译成底层操作系统可以运行的机器码并且进行调用执行，这也是 Java 程序能够“一次编写，到处运行”的原因（因为它会根据特定的操作系统生成对应的操作指令）。JVM 的功能很强大，像 Java 对象的创建、使用和销毁，还有垃圾回收以及某些高级的性能优化，例如，热点代码检测等功能都是在 JVM 中进行的。因为 JVM 是 Java 程序能够运行的根本，因此掌握 JVM 也已经成了一个合格 Java 程序员必备的技能。
+
+我们本课时的面试题是，说一下 JVM 的内存布局和运行原理？
+
+## 典型回答
+JVM 的种类有很多，比如 HotSpot 虚拟机，它是 Sun/OracleJDK 和 OpenJDK 中的默认 JVM，也是目前使用范围最广的 JVM。我们常说的 JVM 其实泛指的是 HotSpot 虚拟机，还有曾经与 HotSpot 齐名为“三大商业 JVM”的 JRockit 和 IBM J9 虚拟机。但无论是什么类型的虚拟机都必须遵守 Oracle 官方发布的《Java虚拟机规范》，它是 Java 领域最权威最重要的著作之一，用于规范 JVM 的一些具体“行为”。
+
+同样对于 JVM 的内存布局也一样，根据《Java虚拟机规范》的规定，JVM 的内存布局分为以下几个部分：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200618212842.png)
+
+以上 5 个内存区域的主要用途如下。
+
+### 1. 堆
+堆（Java Heap） 也叫 Java 堆或者是 GC 堆，它是一个线程共享的内存区域，也是 JVM 中占用内存最大的一块区域，Java 中所有的对象都存储在这里。
+
+《Java虚拟机规范》对 Java 堆的描述是：“所有的对象实例以及数组都应当在堆上分配”。但这在技术日益发展的今天已经有点不那么“准确”了，比如 JIT（Just In Time Compilation，即时编译 ）优化中的逃逸分析，使得变量可以直接在栈上被分配。
+
+当对象或者是变量在方法中被创建之后，其指针可能被线程所引用，而这个对象就被称作指针逃逸或者是引用逃逸。
+
+比如以下代码中的 sb 对象的逃逸：
+
+```java
+public static StringBuffer createString() {
+    StringBuffer sb = new StringBuffer();
+    sb.append("Java");
+    return sb;
+}
+```
+
+sb 虽然是一个局部变量，但上述代码可以看出，它被直接 return 出去了，因此可能被赋值给了其他变量，并且被完全修改，于是此 sb 就逃逸到了方法外部。
+
+想要 sb 变量不逃逸也很简单，可以改为如下代码：
+
+```java
+public static String createString() {
+    StringBuffer sb = new StringBuffer();
+    sb.append("Java");
+    return sb.toString();
+}
+```
+
+> 小贴士：通过逃逸分析可以让变量或者是对象直接在栈上分配，从而极大地降低了垃圾回收的次数，以及堆分配对象的压力，进而提高了程序的整体运行效率。
+
+回到主题，堆大小的值可通过 -Xms 和 -Xmx 来设置（设置最小值和最大值），当堆超过最大值时就会抛出 OOM（OutOfMemoryError）异常。
+
+### 2. 方法区
+方法区（Method Area） 也被称为非堆区，用于和“Java 堆”的概念进行区分，它也是线程共享的内存区域，用于存储已经被 JVM 加载的类型信息、常量、静态变量、代码缓存等数据。
+
+说到方法区有人可能会联想到“永久代”，但对于《Java虚拟机规范》来说并没有规定这样一个区域，同样它也只是 HotSpot 中特有的一个概念。这是因为 HotSpot 技术团队把垃圾收集器的分代设计扩展到方法区之后才有的一个概念，可以理解为 HotSpot 技术团队只是用永久代来实现方法区而已，但这会导致一个致命的问题，这样设计更容易造成内存溢出。因为永久代有 -XX：MaxPermSize（方法区分配的最大内存）的上限，即使不设置也会有默认的大小。例如，32 位操作系统中的 4GB 内存限制等，并且这样设计导致了部分的方法在不同类型的 Java 虚拟机下的表现也不同，比如 String::intern() 方法。所以在 JDK 1.7 时 HotSpot 虚拟机已经把原本放在永久代的字符串常量池和静态变量等移出了方法区，并且在 JDK 1.8 中完全废弃了永久代的概念。
+
+### 3. 程序计数器
+程序计数器（Program Counter Register） 线程独有一块很小的内存区域，保存当前线程所执行字节码的位置，包括正在执行的指令、跳转、分支、循环、异常处理等。
+
+### 4.虚拟机栈
+
+虚拟机栈也叫 Java 虚拟机栈（Java Virtual Machine Stack），和程序计数器相同它也是线程独享的，用来描述 Java 方法的执行，在每个方法被执行时就会同步创建一个栈帧，用来存储局部变量表、操作栈、动态链接、方法出口等信息。当调用方法时执行入栈，而方法返回时执行出栈。
+
+### 5.本地方法栈
+
+本地方法栈（Native Method Stacks）与虚拟机栈类似，它是线程独享的，并且作用也和虚拟机栈类似。只不过虚拟机栈是为虚拟机中执行的 Java 方法服务的，而本地方法栈则是为虚拟机使用到的本地（Native）方法服务。
+
+> 小贴士：需要注意的是《Java虚拟机规范》只规定了有这么几个区域，但没有规定 JVM 的具体实现细节，因此对于不同的 JVM 来说，实现也是不同的。例如，“永久代”是 HotSpot 中的一个概念，而对于 JRockit 来说就没有这个概念。所以很多人说的 JDK 1.8 把永久代转移到了元空间，这其实只是 HotSpot 的实现，而非《Java虚拟机规范》的规定。
+
+JVM 的执行流程是，首先先把 Java 代码（.java）转化成字节码（.class），然后通过类加载器将字节码加载到内存中，所谓的内存也就是我们上面介绍的运行时数据区，但字节码并不是可以直接交给操作系统执行的机器码，而是一套 JVM 的指令集。这个时候需要使用特定的命令解析器也就是我们俗称的**执行引擎（Execution Engine）**将字节码翻译成可以被底层操作系统执行的指令再去执行，这样就实现了整个 Java 程序的运行，这也是 JVM 的整体执行流程。
+
+## 考点分析
+JVM 的内存布局是一道必考的 Java 面试题，一般会作为 JVM 方面的第一道面试题出现，它也是中高级工程师必须掌握的一个知识点。和此知识点相关的面试题还有这些：类的加载分为几个阶段？每个阶段代表什么含义？加载了什么内容？
+
+# 知识扩展——类加载
+类的生命周期会经历以下 7 个阶段：
+
+1. 加载阶段（Loading）
+2. 验证阶段（Verification）
+3. 准备阶段（Preparation）
+4. 解析阶段（Resolution）
+5. 初始化阶段（Initialization）
+6. 使用阶段（Using）
+7. 卸载阶段（Unloading）
+
+其中验证、准备、解析 3 个阶段统称为连接（Linking），如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200618214003.png)
+
+我们平常所说的 JVM 类加载通常指的就是前五个阶段：加载、验证、准备、解析、初始化等，接下来我们分别来看看。
+
+## 1. 加载阶段
+此阶段用于查到相应的类（通过类名进行查找）并将此类的字节流转换为方法区运行时的数据结构，然后再在内存中生成一个能代表此类的 `java.lang.Class` 对象，作为其他数据访问的入口。
+
+> 小贴士：需要注意的是加载阶段和连接阶段的部分动作有可能是交叉执行的，比如一部分字节码文件格式的验证，在加载阶段还未完成时就已经开始验证了。
+
+## 2.验证阶段
+
+此步骤主要是为了验证字节码的安全性，如果不做安全校验的话可能会载入非安全或有错误的字节码，从而导致系统崩溃，它是 JVM 自我保护的一项重要举措。
+
+验证的主要动作大概有以下几个：
+
+* **文件格式校验**包括常量池中的常量类型、Class 文件的各个部分是否被删除或被追加了其他信息等；
+* **元数据校验**包括父类正确性校验（检查父类是否有被 final 修饰）、抽象类校验等；
+* **字节码校验**，此步骤最为关键和复杂，主要用于校验程序中的语义是否合法且符合逻辑；
+* **符号引用校验**，对类自身以外比如常量池中的各种符号引用的信息进行匹配性校验。
+
+## 3. 准备阶段
+此阶段是用来初始化并为类中定义的静态变量分配内存的，这些静态变量会被分配到方法区上。
+
+HotSpot 虚拟机在 JDK 1.7 之前都在方法区，而 JDK 1.8 之后此变量会随着类对象一起存放到 Java 堆中。
+
+## 4. 解析阶段
+此阶段主要是用来解析类、接口、字段及方法的，解析时会把符号引用替换成直接引用。
+
+所谓的符号引用是指以一组符号来描述所引用的目标，符号可以是任何形式的字面量，只要使用时能无歧义地定位到目标即可；而直接引用是可以直接指向目标的指针、相对偏移量或者是一个能间接定位到目标的句柄。
+
+符号引用和直接引用有一个重要的区别：使用符号引用时被引用的目标不一定已经加载到内存中；而使用直接引用时，引用的目标必定已经存在虚拟机的内存中了。
+
+## 5. 初始化
+初始化阶段 JVM 就正式开始执行类中编写的 Java 业务代码了。到这一步骤之后，类的加载过程就算正式完成了。
+
+# 小结
+本课时讲了 JVM 的内存布局主要分为：堆、方法区、程序计数器、虚拟机栈和本地方法栈，并讲了 JVM 的执行流程，先把 Java 代码编译成字节码，再把字节码加载到运行时数据区；然后交给 JVM 引擎把字节码翻译为操作系统可以执行的指令进行执行；最后还讲了类加载的 5 个阶段：加载、验证、准备、解析和初始化。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/24.垃圾回收算法有哪些？.md b/Java基础教程/Java面试原理/24.垃圾回收算法有哪些？.md
new file mode 100644
index 00000000..b64a31f7
--- /dev/null
+++ b/Java基础教程/Java面试原理/24.垃圾回收算法有哪些？.md
@@ -0,0 +1,146 @@
+# 垃圾回收算法有哪些？
+
+说到 Java 虚拟机不得不提的一个词就是**“垃圾回收”（GC，Garbage Collection）**，而垃圾回收的执行速度则影响着整个程序的执行效率，所以我们需要知道更多关于垃圾回收的具体执行细节，以便为我们选择合适的垃圾回收器提供理论持。
+
+我们本课时的面试题是，如何判断一个对象是否“死亡”？垃圾回收的算法有哪些？
+
+## 典型回答
+垃圾回收器首先要做的就是，判断一个对象是存活状态还是死亡状态，死亡的对象将会被标识为垃圾数据并等待收集器进行清除。
+
+判断一个对象是否为死亡状态的常用算法有两个：引用计数器算法和可达性分析算法。
+
+**引用计数算法（Reference Counting）** 属于垃圾收集器最早的实现算法了，它是指在创建对象时关联一个与之相对应的计数器，当此对象被使用时加 1，相反销毁时 -1。当此计数器为 0 时，则表示此对象未使用，可以被垃圾收集器回收。
+
+引用计数算法的优缺点很明显，其优点是垃圾回收比较及时，实时性比较高，只要对象计数器为 0，则可以直接进行回收操作；而缺点是无法解决循环引用的问题，比如以下代码：
+
+```java
+class CustomOne {
+    private CustomTwo two;
+    public CustomTwo getCustomTwo() {
+        return two;
+    }
+    public void setCustomTwo(CustomTwo two) {
+        this.two = two;
+    }
+}
+class CustomTwo {
+    private CustomOne one;
+    public CustomOne getCustomOne() {
+        return one;
+    } 
+    public void setCustomOne(CustomOne one) {
+        this.one = one;
+    }
+}
+public class RefCountingTest {
+    public static void main(String[] args) {
+        CustomOne one = new CustomOne();
+        CustomTwo two = new CustomTwo();
+        one.setCustomTwo(two);
+        two.setCustomOne(one);
+        one = null;
+        two = null;
+    }
+}
+```
+
+即使 one 和 two 都为 null，但因为循环引用的问题，两个对象都不能被垃圾收集器所回收。
+
+**可达性分析算法（Reachability Analysis）** 是目前商业系统中所采用的判断对象死亡的常用算法，它是指从对象的起点（GC Roots）开始向下搜索，如果对象到 GC Roots 没有任何引用链相连时，也就是说此对象到 GC Roots 不可达时，则表示此对象可以被垃圾回收器所回收，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200619124046.png)
+
+当确定了对象的状态之后（存活还是死亡）接下来就是进行垃圾回收了，垃圾回收的常见算法有以下几个：
+
+* 标记-清除算法；
+* 标记-复制算法；
+* 标记-整理算法。
+
+**标记-清除（Mark-Sweep）**算法属于最早的垃圾回收算法，它是由标记阶段和清除阶段构成的。标记阶段会给所有的存活对象做上标记，而清除阶段会把没有被标记的死亡对象进行回收。而标记的判断方法就是前面讲的引用计数算法和可达性分析算法。
+
+标记-清除算法的执行流程如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200619124458.png)
+
+从上图可以看出，标记-清除算法有一个最大的问题就是会产生内存空间的碎片化问题，也就是说标记-清除算法执行完成之后会产生大量的不连续内存，这样当程序需要分配一个大对象时，因为没有足够的连续内存而导致需要提前触发一次垃圾回收动作。
+
+**标记-复制算法**是标记-清除算法的一个升级，使用它可以有效地解决内存碎片化的问题。它是指将内存分为大小相同的两块区域，每次只使用其中的一块区域，这样在进行垃圾回收时就可以直接将存活的东西复制到新的内存上，然后再把另一块内存全部清理掉。这样就不会产生内存碎片的问题了，其执行流程如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200619125111.png)
+
+标记-复制的算法虽然可以解决内存碎片的问题，但同时也带来了新的问题。因为需要将内存分为大小相同的两块内存，那么内存的实际可用量其实只有原来的一半，这样此算法导致了内存的可用率大幅降低了。
+
+**标记-整理算法**的诞生晚于标记-清除算法和标记-复制算法，它也是由两个阶段组成的：标记阶段和整理阶段。其中标记阶段和标记-清除算法的标记阶段一样，不同的是后面的一个阶段，标记-整理算法的后一个阶段不是直接对内存进行清除，而是把所有存活的对象移动到内存的一端，然后把另一端的所有死亡对象全部清除，执行流程图如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200619125735.png)
+
+## 考点分析
+本题目考察的是关于垃圾收集的一些理论算法问题，都属于概念性的问题，只要深入理解之后还是挺容易记忆的。和此知识点相关的面试题还有这些：
+
+* Java 中可作为 CG Roots 的对象有哪些？
+* 说一下死亡对象的判断细节？
+
+# 知识扩展
+## GC Roots
+
+在 Java 中可以作为 GC Roots 的对象，主要包含以下几个：
+
+* 所有被同步锁持有的对象，比如被 synchronize 持有的对象；
+* 字符串常量池里的引用（String Table）；
+* 类型为引用类型的静态变量；
+* 虚拟机栈中引用对象；
+* 本地方法栈中的引用对象。
+
+## 死亡对象判断
+当使用可达性分析判断一个对象不可达时，并不会直接标识这个对象为死亡状态，而是先将它标记为“待死亡”状态再进行一次校验。校验的内容就是此对象是否重写了 finalize() 方法，如果该对象重写了 finalize() 方法，那么这个对象将会被存入到 F-Queue 队列中，等待 JVM 的 Finalizer 线程去执行重写的 finalize() 方法，在这个方法中如果此对象将自己赋值给某个类变量时，则表示此对象已经被引用了。因此不能被标识为死亡状态，其他情况则会被标识为死亡状态。
+
+以上流程对应的示例代码如下：
+
+```java
+public class FinalizeTest {
+    // 需要状态判断的对象
+    public static FinalizeTest Hook = null;
+    @Override
+    protected void finalize() throws Throwable {
+        super.finalize();
+        System.out.println("执行了 finalize 方法");
+        FinalizeTest.Hook = this;
+    }
+    public static void main(String[] args) throws InterruptedException {
+        Hook = new FinalizeTest();
+        // 卸载对象，第一次执行 finalize()
+        Hook = null;
+        System.gc();
+        Thread.sleep(500); // 等待 finalize() 执行
+        if (Hook != null) {
+            System.out.println("存活状态");
+        } else {
+            System.out.println("死亡状态");
+        }
+        // 卸载对象，与上一次代码完全相同
+        Hook = null;
+        System.gc();
+        Thread.sleep(500); // 等待 finalize() 执行
+        if (Hook != null) {
+            System.out.println("存活状态");
+        } else {
+            System.out.println("死亡状态");
+        }
+    }
+}
+```
+
+上述代码的执行结果为：
+
+```
+执行了 finalize 方法
+存活状态
+死亡状态
+```
+
+从结果可以看出，卸载了两次对象，第一次执行了 finalize() 方法，成功地把自己从待死亡状态拉了回来；而第二次同样的代码却没有执行 finalize() 方法，从而被确认为了死亡状态，这是因为**任何对象的 finalize() 方法都只会被系统调用一次**。
+
+虽然可以从 finalize() 方法中把自己从死亡状态“拯救”出来，但是不建议这样做，因为所有对象的 finalize() 方法只会执行一次。因此同样的代码可能产生的结果是不同的，这样就给程序的执行带来了很大的不确定性。
+
+# 小结
+本课时讲了对象状态判断的两种算法：引用计数算法和可达性分析算法。其中引用计数算法无法解决循环引用的问题，因此对于绝大多数的商业系统来说使用的都是可达性分析算法；同时还讲了垃圾回收的三种算法：标记-清除算法、标记-复制算法、标记-整理算法，其中，标记-清除算法会带来内存碎片的问题，而标记-复制算法会降低内存的利用率。所以，标记-整理算法算是一个不错的方案。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/25.你用过哪些垃圾回收器？它们有什么区别？.md b/Java基础教程/Java面试原理/25.你用过哪些垃圾回收器？它们有什么区别？.md
new file mode 100644
index 00000000..3659e993
--- /dev/null
+++ b/Java基础教程/Java面试原理/25.你用过哪些垃圾回收器？它们有什么区别？.md
@@ -0,0 +1,81 @@
+# 你用过哪些垃圾回收器？它们有什么区别？
+
+上一课时我们讲了垃圾回收的理论知识，而本课时将介绍这些理论知识的具体实践。垃圾回收器也叫垃圾收集器，不同的厂商对垃圾收集器的实现也是不同的，这里主要介绍目前使用最广泛的 OracleJDK 中自带的 HotSpot 虚拟机中的几个垃圾收集器。
+
+我们本课时的面试题是，你用过哪些垃圾回收器？它们有什么区别？
+
+## 典型回答
+《Java 虚拟机规范》并没有对垃圾收集器的具体实现做任何的规定，因此每家垃圾收集器的实现方式都不同，但比较常用的垃圾回收器是 OracleJDK 中自带的 HotSpot 虚拟机。HotSpot 中使用的垃圾收集器主要包括 7 个：**Serial、ParNew、Parallel Scavenge、Serial Old、Parallel Old、CMS 和 G1（Garbage First）收集器**。
+
+ **Serial 收集器**属于最早期的垃圾收集器，也是 JDK 1.3 版本之前唯一的垃圾收集器。它是单线程运行的垃圾收集器，其单线程是指在进行垃圾回收时所有的工作线程必须暂停，直到垃圾回收结束为止，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200619133514.png)
+
+Serial 收集器的特点是简单和高效，并且本身的运行对内存要求不高，因此它在客户端模式下使用的比较多。
+
+**ParNew收集器**实际上是 Serial 收集器的多线程并行版本，运行示意图如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200619133550.png)
+
+**Parallel Scavenge 收集器**和 ParNew 收集器类似，它也是一个并行运行的垃圾回收器；不同的是，该收集器关注的侧重点是实现一个可以控制的吞吐量。而这个吞吐量计算的也很奇怪，它的计算公式是：用户运行代码的时间 / （用户运行代码的时间 + 垃圾回收执行的时间）。比如用户运行的时间是 8 分钟，垃圾回收运行的时间是 2 分钟，那么吞吐量就是 80%。Parallel Scavenge 收集器追求的目标就是将这个吞吐量的值，控制在一定的范围内。
+
+Parallel Scavenge 收集器有两个重要的参数：
+
+* -XX:MaxGCPauseMillis 参数：它是用来控制垃圾回收的最大停顿时间；
+* -XX:GCTimeRatio 参数：它是用来直接设置吞吐量的值的。
+
+**Serial Old 收集器**为 Serial 收集器的老年代版本，而 Parallel Old 收集器是 Parallel Scavenge 收集器的老年代版本。
+
+**CMS（Concurrent Mark Sweep）收集器**与以吞吐量为目标的 Parallel Scavenge 收集器不同，它强调的是提供最短的停顿时间，因此可能会牺牲一定的吞吐量。它主要应用在 Java Web 项目中，它满足了系统需要短时间停顿的要求，以此来提高用户的交互体验。
+
+**Garbage First（简称 G1）收集器**是历史发展的产物，也是一款更先进的垃圾收集器，主要面向服务端应用的垃圾收集器。它将内存划分为多个 Region 分区，回收时则以分区为单位进行回收，这样它就可以用相对较少的时间优先回收包含垃圾最多区块。从 JDK 9 之后也成了官方默认的垃圾收集器，官方也推荐使用 G1 来代替选择 CMS 收集器。
+
+## 考点分析
+JVM 内存布局和垃圾回收算法是面试中常考的题目，也是我们理解并优化 Java 程序的理论基础，而对于垃圾收集器来说除了目前主流版本（JDK 8）常用的 CMS 之外，其他的垃圾收集器都属于面试中的加分项。对于 G1 和 JDK 11 中的 ZGC 的理解代表了你对技术的热爱和新技术的敏感程度，也属于面试中的重要加分项。
+
+和此知识点相关的面试题还有以下这些：
+
+* 讲一下分代收集理论？
+* CMS 收集器的具体执行流程是什么？
+* 讲一下 JDK 11 中的 ZGC 收集器？
+
+# 知识扩展
+## 1.分代收集
+
+说到垃圾收集器不得不提的一个理论就是“分代收集”，因为目前商用虚拟机的垃圾收集器都是基于分代收集的理论进行设计的，它是指将不同“年龄”的数据分配到不同的内存区域中进行存储，所谓的“年龄”指的是经历过垃圾收集的次数。这样我们就可以把那些朝生暮死的对象集中分配到一起，把不容易消亡的对象分配到一起，对于不容易死亡的对象我们就可以设置较短的垃圾收集频率，这样就能消耗更少的资源来实现更理想的功能了。
+
+通常情况下分代收集算法会分为两个区域：新生代（Young Generation）和老年代（Old Generation），其中新生代用于存储刚刚创建的对象，这个区域内的对象存活率不高，而对于经过了一定次数的 GC 之后还存活下来的对象，就可以成功晋级到老生代了。
+
+对于上面介绍的 7 个垃圾收集器来说，新生代垃圾收集器有：Serial、ParNew、Parallel Scavenge，老生代的垃圾收集器有：Serial Old、Parallel Old、CMS，而 G1 属于混合型的垃圾收集器，如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200619134108.png)
+
+## 2. CMS 收集器的具体执行流程
+CMS 收集器是基于标记-清除算法实现的，我们之前有讲过关于标记-清除的算法，这里简单地回顾一下。标记-清除的算法是由标记阶段和清除阶段构成的，标记阶段会给所有的存活对象做上标记；而清除阶段会把被标记为死亡的对象进行回收，而死亡对象的判断是通过引用计数法或者是目前主流的可达性分析算法实现的。但是 CMS 的实现稍微复杂一些，它的整个过程可以分为四个阶段：
+
+* 初始标记（CMS initial mark）
+* 并发标记（CMS concurrent mark）
+* 重新标记（CMS remark）
+* 并发清除（CMS concurrent sweep）
+
+首先，初始标记阶段的执行时间很短，它只是标记一下 GC Roots 的关联对象；并发阶段是从 GC Roots 关联的对象进行遍历判断并标识死亡对象，这个过程比较慢，但不需要停止用户线程，用户的线程可以和垃圾收集线程并发执行；而重新标记阶段则是为了判断并标记，刚刚并发阶段用户继续运行的那一部分对象，所以此阶段的执行时间也比较短；最后是并发清除阶段，也就是清除上面标记的死亡对象，由于 CMS 使用的是标记-清除算法，而非标记-整理算法，因此无须移动存活的对象，这个阶段垃圾收集线程也可以和用户线程并发执行。
+
+CMS 的整个执行过程中只有执行时间很短的初始标记和重新标记需要 Stop The World（全局停顿）的，执行过程如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200619134706.png)
+
+因为 CMS 是一款基于标记清除算法实现的垃圾收集器，因此会在收集时产生大量的空间碎片，为了解决这个问题，CMS 收集器提供了一个 `-XX:+UseCMS-CompactAtFullCollection` 的参数（默认是开启的，此参数从 JDK9 开始废弃），用于在 CMS 收集器进行 Full GC 时开启内存碎片的合并和整理。
+
+但又因为碎片整理的过程必须移动存活的对象，所以它和用户线程是无法并发执行的，为了解决这个问题 CMS 收集器又提供了另外一个参数` -XX:CMSFullGCsBefore-Compaction`，用于规定多少次（根据此参数的值决定）之后再进行一次碎片整理。
+
+## 3. ZGC
+ZGC 收集器是 JDK 11 中新增的垃圾收集器，它是由 Oracle 官方开发的，并且支持 TB 级别的堆内存管理，而且 ZGC 收集器也非常高效，可以做到 10ms 以内完成垃圾收集。
+
+在 ZGC 收集器中没有新生代和老生代的概念，它只有一代。ZGC 收集器采用的着色指针技术，利用指针中多余的信息位来实现着色标记，并且 ZGC 使用了读屏障来解决 GC 线程和应用线程可能存在的并发（修改对象状态的）问题，从而避免了Stop The World（全局停顿），因此使得 GC 的性能大幅提升。
+
+ZGC 的执行流程和 CMS 比较相似，首先是进行 GC Roots 标记，然后再通过指针进行并发着色标记，之后便是对标记为死亡的对象进行回收（被标记为橘色的对象），最后是重定位，将 GC 之后存活的对象进行移动，以解决内存碎片的问题。
+
+# 小结
+本课时我们介绍了 JDK 11 之前的 7 种垃圾收集器：Serial、Serial Old、ParNew、Parallel Scavenge、Parallel Old、CMS、G1，其中 CMS 收集器是 JDK 8 之前的主流收集器，而 JDK 9 之后的默认收集器为 G1，并且在文章的最后，介绍了性能更加强悍、综合表现更好的 ZGC 收集器，希望本课时的内容可以切实的帮助到你。
+
+OK，这节课就讲到这里啦，下一课时我将分享“生产环境如何排查和优化 JVM？”，记得按时来听课哈。
\ No newline at end of file
diff --git a/Java基础教程/Java面试原理/26.生产环境如何排除和优化JVM？.md b/Java基础教程/Java面试原理/26.生产环境如何排除和优化JVM？.md
new file mode 100644
index 00000000..6a72a3c0
--- /dev/null
+++ b/Java基础教程/Java面试原理/26.生产环境如何排除和优化JVM？.md
@@ -0,0 +1,372 @@
+# 生产环境如何排除和优化 JVM？
+
+通过前面几个课时的学习，相信你对 JVM 的理论及实践等相关知识有了一个大体的印象。而本课时将重点讲解 JVM 的排查与优化，这样就会对 JVM 的知识点有一个完整的认识，从而可以更好地应用于实际工作或者面试了。
+
+我们本课时的面试题是，生产环境如何排查问题？
+
+## 典型回答
+如果是在生产环境中直接排查 JVM 的话，最简单的做法就是使用 JDK 自带的 6 个非常实用的命令行工具来排查。它们分别是：jps、jstat、jinfo、jmap、jhat 和 jstack，它们都位于 JDK 的 bin 目录下，可以使用命令行工具直接运行，其目录如下图所示：
+
+![](https://gitee.com/krislin_zhao/IMGcloud/raw/master/img/20200620130932.png)
+
+### 1. jps（虚拟机进程状况工具）
+jps（JVM Process Status tool，虚拟机进程状况工具）它的功能和 Linux 中的 ps 命令比较类似，用于列出正在运行的 JVM 的 LVMID（Local Virtual Machine IDentifier，本地虚拟机唯一 ID），以及 JVM 的执行主类、JVM 启动参数等信息。语法如下：
+
+```bash
+jps [options] [hostid]
+```
+
+常用的 options 选项：
+
+* -l：用于输出运行主类的全名，如果是 jar 包，则输出 jar 包的路径；
+* -q：用于输出 LVMID（Local Virtual Machine Identifier，虚拟机唯一 ID）；
+* -m：用于输出虚拟机启动时传递给主类 main() 方法的参数；
+* -v：用于输出启动时的 JVM 参数。
+
+### 2. jstat（虚拟机统计信息监视工具）
+jstat（JVM Statistics Monitoring Tool，虚拟机统计信息监视工具）用于监控虚拟机的运行状态信息。
+
+例如，我们用它来查询某个 Java 进程的垃圾收集情况，示例如下：
+
+```bash
+➜  jstat -gc 43704
+ S0C    S1C    S0U    S1U      EC       EU        OC         OU       MC     MU    CCSC   CCSU   YGC     YGCT    FGC    FGCT    CGC    CGCT     GCT
+10752.0 10752.0  0.0    0.0   65536.0   5243.4   175104.0     0.0     4480.0 774.0  384.0   75.8       0    0.000   0      0.000   -          -    0.000
+```
+
+参数说明如下表所示：
+
+| 参数 |                       说明                        |
+| :--: | :-----------------------------------------------: |
+| S0C  |            年轻代中第一个存活区的大小             |
+| S1C  |            年轻代中第二个存活区的大小             |
+| S0U  |     年轻代中第一个存活区已使用的空间（字节）      |
+| S1U  |     年轻代中第二个存活区已使用的空间（字节）      |
+|  EC  |                    Edem 区大小                    |
+|  EU  |       年轻代中 Edem 区已使用的空间（字节）        |
+|  OC  |                    老年代大小                     |
+|  OU  |            老年代已使用的空间（字节）             |
+| YGC  |      从应用程序启动到采样时 young gc 的次数       |
+| YGCT | 从应用程序启动到采样时 young gc 的所用的时间（s） |
+| FGC  |       从应用程序启动到采样时 full gc 的次数       |
+| FGCT |    从应用程序启动到采样时 full gc 的所用的时间    |
+| GCT  |     从应用程序启动到采样时整个 gc 所用的时间      |
+
+> 注意：年轻代的 Edem 区满了会触发 young gc，老年代满了会触发 old gc。full gc 指的是清除整个堆，包括 young 区 和 old 区。
+
+jstat 常用的查询参数有：
+
+* -class，查询类加载器信息；
+* -compiler，JIT 相关信息；
+* -gc，GC 堆状态；
+* -gcnew，新生代统计信息；
+* -gcutil，GC 堆统计汇总信息。
+
+### 3. jinfo（查询虚拟机参数配置工具）
+jinfo（Configuration Info for Java）用于查看和调整虚拟机各项参数。语法如下：
+
+```bash
+jinfo