add all chinese description

leeowenowen · Apr 30, 2016 · 34ed081 · 34ed081
1 parent 54a51e5
commit 34ed081
Show file tree

Hide file tree

Showing 10 changed files with 479 additions and 209 deletions.
diff --git a/RxJava.md b/RxJava.md
@@ -0,0 +1,119 @@
+#RxJava
+
+***
+
+## 什么是RxJava
+RxJava是Rx(Reactive Extensition)异步编程模型的Java语言实现.Rx基于Observer模式，并在此基础上对数据及行为扩展建模，思想最早来源与微软.
+直观的讲，RxJava就是一个Java异步编程函数库．
+在Rx之前，遇到异步任务以及嵌套型异步任务的问题模型时，我们往往用以下几种方式来解决：
+  1. 回调，多层次的回调.这种方式的缺点有两个：
+  　　* 只是简单的将任务的输入输出异步连接起来，却并没有对任务之间的关系建模，一旦遇到涉及任务关系的
+        状况时，就需要开发人员手动编写任务关系组合逻辑代码．
+        比如一个任务A包含３个子任务a,b,c，全部都是消耗性（异步）任务，只有a,b,c全失败整个任务才算失败，有任意一个成功就算成功．这种带有
+        Any或者All语义的任务时，就需要手动写map-reduce的逻辑.
+      * 代码金字塔缩进问题．如果任务嵌套层次过深，则代码的缩进将会严重降低代码的可阅读性.
+  2. 状态机. 多步骤异步任务（子步骤也是异步任务）的情况下，状态机是目前的最佳解决方案，其控制点集中，但缺点就是必须为每一层任务定义状态
+  　及状态切换逻辑．chromium的网络模块是将状态机实践到极致的代码，可谓遍地都是状态机. 
+
+  3. Task编程模型. 又是一个源自微软被复制到各地的模型，在构建系统中尤为普遍，可以指定Task之间的关系，Task的执行线程上下文等. 在也为之前
+    的团队实现了一个简单的Task模型，支持Any, All, While, Before/After等语义,在行为建模上，Task和Rx有很多相似之处，但是Task对于数据的建模
+    只停留在输入输出上（这最多等价于Rx的Operator)，这就决定了它使用范围的局限性．你无法对一个数据源用Task框架异步建模．比如你无法监视一个数据源的变动.
+
+> 微软有一种异步实现方式是await和async,它的实现让异步编程可以和同步编程一样，但是需要强大的底层框架支持．
+
+以上方式的特点都是**基于行为建模**,关注行为及其输入输出；而Rx思想则除了对行为建模还对数据进行建模，我们知道在计算机的世界里只有数据，计算
+机主要的任务也就是处理数据，所以对数据和处理数据的行为这两个关键点建模，就基本上可以涵盖到数据处理的所有Case,这也是我觉得Rx设计受追捧的一个
+原因. 
+Rx思想中另一个优秀的点是将数据以流的形式建模，我们知道一旦一个数据处理任务要高性能的与其他任务之间协作，就必须对数据进行流式拆分且对数据的处理
+支持流式处理.
+>比如你要从网络下载一个1G的文件并存储在本地，为了内存，性能等考虑，你自然不会一次把1G文件从网络全接收到内存，然后再写入文件系统，
+最佳的方式是使用异步IO服务(注意是Proactor形式的读取，而不是Reactor,即读取操作是系统在通知IO完成的时候已经完成）从网络读取数据，每读取一次就将该
+次读取的数据写入文件系统（当然你也可以做缓存，这里只是说明问题）．那么以上整个流程就从一个大数据处理任务拆解成了序列型的多个子任务，这就是流式
+处理中最典型的一种．还有就是XML的sax解析器也是个很好的例子．
+
+Rx将数据及其处理以流式建模，不仅可以让执行流程更加高效，　而且让整个API体系非常易用．我们知道一个优秀的函数库不仅需要其性能等硬
+实力雄厚，API易用性等软实力也不可小觑，如果一个函数库的API及其难用，极其反人类，极其容易出错，那么不管这个库本身多么优秀，其使用者也会大打折扣.
+
+
+## 异步
+  我们已经了解到，RxJava是一个异步函数库，有必要在这里再讨论下异步是做什么的．   
+
+  "设置个回调，不阻塞当前线程",当提到什么是异步以及异步可以做什么的时候，这个是得到的最直接的回答．的确，这个答案是对的.   
+  我自己的理解，异步是**整合资源，合理分配，以达到系统的最佳性能**．这个目标跟"云"的目标似乎是一样的．
+
+  >怎么理解这个结论呢？
+  当异步需要被使用的时候，使用场景往往涉及多个资源访问的,我们的解决方案也通常是按照资源将逻辑分解到多线程上下文，各自处理，互不阻塞，以达到系统的最优性能．
+
+  还是上边的下载1G文件到本地的例子，在我们自己的代码中，我们不难看到很多解决方案是直接起**一个**Executor,背后是个线程池，然后不管三七二十一把网络读取，数据处理
+  以及写文件任务包装成Runnable直接丢到这个线程池里. 这种方式就是没有按照资源分解逻辑到线程上下文的典型例子．如果写文件的任务叫做WriteFileTask,网络读取以及数据
+  处理（比如解压）的任务叫做NetworkTask,那么你的Executor下层的任务队列很容易出现如下状况:
+  -----------------
+  | WriteFileTask |
+  -----------------
+  | WriteFileTask |
+  -----------------
+  | WriteFileTask |
+  -----------------
+  | WriteFileTask |
+  -----------------
+  | NetworkTask   |
+  -----------------
+  | WriteFileTask |
+  -----------------
+  | WriteFileTask |
+  -----------------
+  | WriteFileTask |
+  -----------------
+  | WriteFileTask |
+  -----------------
+  | NetworkTask   |
+  -----------------
+  在这种队列状况下，即使你的网络空闲，NetworkTask仍然可能没有被执行，因为Executor下层的线程池可能满满的都在做WriteFileTask,显然这是一种资源浪费．我们希望任何时候
+  都不要让我们的资源空闲，所以我们应当将NetworkTask和WriteFileTask分解到两个Executor中去，那么运行期的执行就是这个样子：
+
+ -----------------                    -----------------
+ | WriteFileTask |                    | NetworkTask   |
+ -----------------                    -----------------
+ | WriteFileTask |                    | NetworkTask   |
+ -----------------                    -----------------
+ | WriteFileTask |                    | NetworkTask   |
+ -----------------                    -----------------
+ | WriteFileTask |                    | NetworkTask   |
+ -----------------                    -----------------
+ | WriteFileTask |                    | NetworkTask   |
+ -----------------                    -----------------
+
+ 这样任何时候，你的资源都不会闲置，始终在饱和的执行任务． 
+
+ 这样分解的另一个好处是你可以更加容易的对多个任务队列之间进行协调，比如写文件速度太慢，网络很快的时候可能要限制网络读取（毕竟读取的内容会缓存在内存，会对系统内存
+ 产生压力）. Chromium将这种思想实践到了极致，划分出了独立的File, DB, Net, Cache等命名线程，每个命名线程对应独立的任务队列，有兴趣的可以参考.
+
+ 以上内容所涉及的线程上下文（或者应该叫任务队列）分配，以及多任务生产消费之间产生的Back Pressure问题，RxJava都妥妥的在框架级实现，你可以使用一行代码切换你的任务执行上下文Scheduler,而且你可以自定义Scheduler;
+
+ 那么再回到最初的那句总结:整合资源，合理分配，以达到系统的最佳性能, 这就是异步的优势所在，也是编程语言和框架的一个大趋势.
+
+## RxJava
+###RxJava Sample
+ RxJava就是一个异步编程函数库，除了它在异步编程建模上的优越性之外，最大的特点，是它优雅的API. 让开发人员可以连续流畅的写代码，这也是个人比较推崇的一个重要原因.
+
+ 那么下边我就先给出一个使用RxJava的例子，这个例子是之前[构建一个小型系统]()中Android客户端从服务器通过http协议获取数据的实例代码.
+ ~~~
+ ~~~
+ 整个处理流程如下：
+ 1. 
+ 2. 
+
+###RxJava API
+ Rx基于Observer进行建模，同时对数据的操作场景进行了大量的总结和规范．由于场景覆盖非常之多，所以其Java实现--RxJava的API也是非常之多的，其API分为几个大类：
+ 1. 
+ 2. 
+
+ 但目前有一些模块并没有在RxJava代码库中，而是以扩展库的方式存在．
+
+###RxJava Example
+ 终于到了重点了，也是我写这篇文章的目的，为了方便大家了解RxJava的API,我讲所有的RxJava API（至少是官方文档中提到的）都写在一个android apk中，并在其中附以
+ 功能描述,代码示例，marble-diagram(Rx用来描述数据及其处理流程的图),　以及一些使用场景. 所有的资料都是在APK中，使用的时候不会消耗任何流量，而且你可以在任何时候
+ 任何地方使用．APIｊ
+
+
+
diff --git a/app/app.iml b/app/app.iml
@@ -12,10 +12,7 @@
         <option name="SELECTED_TEST_ARTIFACT" value="_android_test_" />
         <option name="ASSEMBLE_TASK_NAME" value="assembleDebug" />
         <option name="COMPILE_JAVA_TASK_NAME" value="compileDebugSources" />
-        <option name="ASSEMBLE_TEST_TASK_NAME" value="assembleDebugAndroidTest" />
-        <option name="COMPILE_JAVA_TEST_TASK_NAME" value="compileDebugAndroidTestSources" />
         <afterSyncTasks>
-          <task>generateDebugAndroidTestSources</task>
           <task>generateDebugSources</task>
         </afterSyncTasks>
         <option name="ALLOW_USER_CONFIGURATION" value="false" />
@@ -28,7 +25,7 @@
   </component>
   <component name="NewModuleRootManager" LANGUAGE_LEVEL="JDK_1_7" inherit-compiler-output="false">
     <output url="file://$MODULE_DIR$/build/intermediates/classes/debug" />
-    <output-test url="file://$MODULE_DIR$/build/intermediates/classes/androidTest/debug" />
+    <output-test url="file://$MODULE_DIR$/build/intermediates/classes/test/debug" />
     <exclude-output />
     <content url="file://$MODULE_DIR$">
       <sourceFolder url="file://$MODULE_DIR$/build/generated/source/r/debug" isTestSource="false" generated="true" />
@@ -50,20 +47,39 @@
       <sourceFolder url="file://$MODULE_DIR$/src/debug/java" isTestSource="false" />
       <sourceFolder url="file://$MODULE_DIR$/src/debug/jni" isTestSource="false" />
       <sourceFolder url="file://$MODULE_DIR$/src/debug/rs" isTestSource="false" />
+      <sourceFolder url="file://$MODULE_DIR$/src/debug/shaders" isTestSource="false" />
+      <sourceFolder url="file://$MODULE_DIR$/src/testDebug/res" type="java-test-resource" />
+      <sourceFolder url="file://$MODULE_DIR$/src/testDebug/resources" type="java-test-resource" />
+      <sourceFolder url="file://$MODULE_DIR$/src/testDebug/assets" type="java-test-resource" />
+      <sourceFolder url="file://$MODULE_DIR$/src/testDebug/aidl" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/src/testDebug/java" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/src/testDebug/jni" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/src/testDebug/rs" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/src/testDebug/shaders" isTestSource="true" />
       <sourceFolder url="file://$MODULE_DIR$/src/main/res" type="java-resource" />
       <sourceFolder url="file://$MODULE_DIR$/src/main/resources" type="java-resource" />
       <sourceFolder url="file://$MODULE_DIR$/src/main/assets" type="java-resource" />
       <sourceFolder url="file://$MODULE_DIR$/src/main/aidl" isTestSource="false" />
       <sourceFolder url="file://$MODULE_DIR$/src/main/java" isTestSource="false" />
       <sourceFolder url="file://$MODULE_DIR$/src/main/jni" isTestSource="false" />
       <sourceFolder url="file://$MODULE_DIR$/src/main/rs" isTestSource="false" />
+      <sourceFolder url="file://$MODULE_DIR$/src/main/shaders" isTestSource="false" />
+      <sourceFolder url="file://$MODULE_DIR$/src/test/res" type="java-test-resource" />
+      <sourceFolder url="file://$MODULE_DIR$/src/test/resources" type="java-test-resource" />
+      <sourceFolder url="file://$MODULE_DIR$/src/test/assets" type="java-test-resource" />
+      <sourceFolder url="file://$MODULE_DIR$/src/test/aidl" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/src/test/java" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/src/test/jni" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/src/test/rs" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/src/test/shaders" isTestSource="true" />
       <sourceFolder url="file://$MODULE_DIR$/src/androidTest/res" type="java-test-resource" />
       <sourceFolder url="file://$MODULE_DIR$/src/androidTest/resources" type="java-test-resource" />
       <sourceFolder url="file://$MODULE_DIR$/src/androidTest/assets" type="java-test-resource" />
       <sourceFolder url="file://$MODULE_DIR$/src/androidTest/aidl" isTestSource="true" />
       <sourceFolder url="file://$MODULE_DIR$/src/androidTest/java" isTestSource="true" />
       <sourceFolder url="file://$MODULE_DIR$/src/androidTest/jni" isTestSource="true" />
       <sourceFolder url="file://$MODULE_DIR$/src/androidTest/rs" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/src/androidTest/shaders" isTestSource="true" />
       <excludeFolder url="file://$MODULE_DIR$/build/intermediates/assets" />
       <excludeFolder url="file://$MODULE_DIR$/build/intermediates/blame" />
       <excludeFolder url="file://$MODULE_DIR$/build/intermediates/bundles" />
@@ -79,41 +95,43 @@
       <excludeFolder url="file://$MODULE_DIR$/build/intermediates/exploded-aar/com.daimajia.easing/library/1.0.1/jars" />
       <excludeFolder url="file://$MODULE_DIR$/build/intermediates/exploded-aar/us.feras.mdv/markdownview/1.1.0/jars" />
       <excludeFolder url="file://$MODULE_DIR$/build/intermediates/incremental" />
+      <excludeFolder url="file://$MODULE_DIR$/build/intermediates/incremental-safeguard" />
       <excludeFolder url="file://$MODULE_DIR$/build/intermediates/instant-run-support" />
       <excludeFolder url="file://$MODULE_DIR$/build/intermediates/jniLibs" />
       <excludeFolder url="file://$MODULE_DIR$/build/intermediates/manifests" />
       <excludeFolder url="file://$MODULE_DIR$/build/intermediates/pre-dexed" />
       <excludeFolder url="file://$MODULE_DIR$/build/intermediates/res" />
       <excludeFolder url="file://$MODULE_DIR$/build/intermediates/rs" />
+      <excludeFolder url="file://$MODULE_DIR$/build/intermediates/shaders" />
       <excludeFolder url="file://$MODULE_DIR$/build/intermediates/symbols" />
       <excludeFolder url="file://$MODULE_DIR$/build/intermediates/transforms" />
       <excludeFolder url="file://$MODULE_DIR$/build/outputs" />
       <excludeFolder url="file://$MODULE_DIR$/build/tmp" />
     </content>
     <orderEntry type="jdk" jdkName="Android API 23 Platform" jdkType="Android SDK" />
     <orderEntry type="sourceFolder" forTests="false" />
-    <orderEntry type="library" exported="" name="library-2.4.0" level="project" />
-    <orderEntry type="library" exported="" name="reactive-streams-1.0.0" level="project" />
-    <orderEntry type="library" exported="" name="rxjava-string-1.1.0" level="project" />
-    <orderEntry type="library" exported="" name="universal-image-loader-1.9.5" level="project" />
+    <orderEntry type="library" exported="" name="library-1.0.1" level="project" />
+    <orderEntry type="library" exported="" name="support-v4-23.2.1" level="project" />
+    <orderEntry type="library" exported="" name="rxjava-joins-0.22.0" level="project" />
+    <orderEntry type="library" exported="" name="design-23.2.1" level="project" />
     <orderEntry type="library" exported="" name="rxjava-computation-expressions-0.21.0" level="project" />
+    <orderEntry type="library" exported="" scope="TEST" name="hamcrest-core-1.3" level="project" />
     <orderEntry type="library" exported="" name="rxjava-1.1.1" level="project" />
-    <orderEntry type="library" exported="" name="design-23.2.1" level="project" />
-    <orderEntry type="library" exported="" name="rxjava-async-util-0.21.0" level="project" />
     <orderEntry type="library" exported="" name="markdownj-core-0.4" level="project" />
-    <orderEntry type="library" exported="" name="recyclerview-v7-23.2.1" level="project" />
-    <orderEntry type="library" exported="" name="rxjava-joins-0.22.0" level="project" />
-    <orderEntry type="library" exported="" name="rxjava-math-1.0.0" level="project" />
-    <orderEntry type="library" exported="" scope="TEST" name="hamcrest-core-1.3" level="project" />
-    <orderEntry type="library" exported="" name="support-v4-23.2.1" level="project" />
-    <orderEntry type="library" exported="" name="markdownview-1.1.0" level="project" />
-    <orderEntry type="library" exported="" name="library-1.0.1" level="project" />
     <orderEntry type="library" exported="" scope="TEST" name="junit-4.12" level="project" />
-    <orderEntry type="library" exported="" name="library-1.1.3" level="project" />
+    <orderEntry type="library" exported="" name="animated-vector-drawable-23.2.1" level="project" />
     <orderEntry type="library" exported="" name="rxjava-reactive-streams-1.0.1" level="project" />
+    <orderEntry type="library" exported="" name="recyclerview-v7-23.2.1" level="project" />
     <orderEntry type="library" exported="" name="support-annotations-23.2.1" level="project" />
-    <orderEntry type="library" exported="" name="animated-vector-drawable-23.2.1" level="project" />
+    <orderEntry type="library" exported="" name="library-1.1.3" level="project" />
+    <orderEntry type="library" exported="" name="rxjava-async-util-0.21.0" level="project" />
+    <orderEntry type="library" exported="" name="rxjava-math-1.0.0" level="project" />
     <orderEntry type="library" exported="" name="support-vector-drawable-23.2.1" level="project" />
+    <orderEntry type="library" exported="" name="markdownview-1.1.0" level="project" />
+    <orderEntry type="library" exported="" name="universal-image-loader-1.9.5" level="project" />
+    <orderEntry type="library" exported="" name="rxjava-string-1.1.0" level="project" />
     <orderEntry type="library" exported="" name="appcompat-v7-23.2.1" level="project" />
+    <orderEntry type="library" exported="" name="library-2.4.0" level="project" />
+    <orderEntry type="library" exported="" name="reactive-streams-1.0.0" level="project" />
   </component>
 </module>