Exchanger工具类的使用案例

原文链接：http://lixuanbin.iteye.com/blog/2166772

参考链接：http://www.2cto.com/kf/201209/157884.html

一、简介
   Exchanger是自jdk1.5起开始提供的工具套件，一般用于两个工作线程之间交换数据。在本文中我将采取由浅入深的方式来介绍分析这个工具类。首先我们来看看官方的api文档中的叙述：

A synchronization point at which threads can pair and swap elements within pairs. Each thread presents some object on entry to the exchange method, matches with a partner thread, and receives its partner's object on return. An Exchanger may be viewed as a bidirectional form of a SynchronousQueue. Exchangers may be useful in applications such as genetic algorithms and pipeline designs.

    在以上的描述中，有几个要点：

• 此类提供对外的操作是同步的；
• 用于成对出现的线程之间交换数据；
• 可以视作双向的同步队列；
• 可应用于基因算法、流水线设计等场景。

   接着看api文档，这个类提供对外的接口非常简洁，一个无参构造函数，两个重载的范型exchange方法：
public V exchange(V x) throws InterruptedException
public V exchange(V x, long timeout, TimeUnit unit) throws InterruptedException, TimeoutException
   从官方的javadoc可以知道，当一个线程到达exchange调用点时，如果它的伙伴线程此前已经调用了此方法，那么它的伙伴会被调度唤醒并与之进行对象交换，然后各自返回。如果它的伙伴还没到达交换点，那么当前线程将会被挂起，直至伙伴线程到达——完成交换正常返回；或者当前线程被中断——抛出中断异常；又或者是等候超时——抛出超时异常。

二、一个简单的例子
按照某大师的观点，行为知之先，在知道了Exchanger的大致用途并参阅了使用说明后，我们马上动手写个例子来跑一跑：

 

Java代码  

1. import java.util.concurrent.Exchanger;  
2. import java.util.concurrent.ExecutorService;  
3. import java.util.concurrent.Executors;  
4. import java.util.concurrent.TimeUnit;  
5. import org.apache.log4j.Logger;  
6.   
7. /** 
8.  * @Title: ExchangerTest 
9.  * @Description: Test class for Exchanger 
10.  * @Company: CSAIR 
11.  * @Author: lixuanbin 
12.  * @Creation: 2014年12月14日 
13.  * @Version:1.0 
14.  */  
15. public class ExchangerTest {  
16.     protected static final Logger log = Logger.getLogger(ExchangerTest.class);  
17.     private static volatile boolean isDone = false;  
18.   
19.     static class ExchangerProducer implements Runnable {  
20.         private Exchanger<Integer> exchanger;  
21.         private static int data = 1;  
22.         ExchangerProducer(Exchanger<Integer> exchanger) {  
23.             this.exchanger = exchanger;  
24.         }  
25.   
26.         @Override  
27.         public void run() {  
28.             while (!Thread.interrupted() && !isDone) {  
29.                 for (int i = 1; i <= 3; i++) {  
30.                     try {  
31.                         TimeUnit.SECONDS.sleep(1);  
32.                         data = i;  
33.                         System.out.println("producer before: " + data);  
34.                         data = exchanger.exchange(data);  
35.                         System.out.println("producer after: " + data);  
36.                     } catch (InterruptedException e) {  
37.                         log.error(e, e);  
38.                     }  
39.                 }  
40.                 isDone = true;  
41.             }  
42.         }  
43.     }  
44.   
45.     static class ExchangerConsumer implements Runnable {  
46.         private Exchanger<Integer> exchanger;  
47.         private static int data = 0;  
48.         ExchangerConsumer(Exchanger<Integer> exchanger) {  
49.             this.exchanger = exchanger;  
50.         }  
51.   
52.         @Override  
53.         public void run() {  
54.             while (!Thread.interrupted() && !isDone) {  
55.                 data = 0;  
56.                 System.out.println("consumer before : " + data);  
57.                 try {  
58.                     TimeUnit.SECONDS.sleep(1);  
59.                     data = exchanger.exchange(data);  
60.                 } catch (InterruptedException e) {  
61.                     log.error(e, e);  
62.                 }  
63.                 System.out.println("consumer after : " + data);  
64.             }  
65.         }  
66.     }  
67.   
68.     /** 
69.      * @param args 
70.      */  
71.     public static void main(String[] args) {  
72.         ExecutorService exec = Executors.newCachedThreadPool();  
73.         Exchanger<Integer> exchanger = new Exchanger<Integer>();  
74.         ExchangerProducer producer = new ExchangerProducer(exchanger);  
75.         ExchangerConsumer consumer = new ExchangerConsumer(exchanger);  
76.         exec.execute(producer);  
77.         exec.execute(consumer);  
78.         exec.shutdown();  
79.         try {  
80.             exec.awaitTermination(30, TimeUnit.SECONDS);  
81.         } catch (InterruptedException e) {  
82.             log.error(e, e);  
83.         }  
84.     }  
85. }  

   这大致可以看作是一个简易的生产者消费者模型，有两个任务类，一个递增地产生整数，一个产生整数0，然后双方进行交易。每次交易前的生产者和每次交易后的消费者都会sleep 1秒来模拟数据处理的消耗，并在交易前后把整数值打印到控制台以便检测结果。在这个例子里交易循环只执行三次，采用一个volatile boolean来控制交易双方线程的退出。
   我们来看看程序的输出：

 

consumer before : 0
producer before: 1
consumer after : 1
producer after: 0
consumer before : 0
producer before: 2
producer after: 0
consumer after : 2
consumer before : 0
producer before: 3
producer after: 0
consumer after : 3

    输出结果验证了以下两件事情：

• exchange方法真的帮一对线程交换了数据；
• exchange方法真的会阻塞调用方线程直至另一方线程参与交易。

   那么在中断和超时两种情况下程序的运行表现会是怎样呢？作为一个小练习，有兴趣的观众可以设想并编写测试用例覆盖验证之。接下来谈谈最近我在生产场景中对Exchanger的应用。

 

三、实战场景
1.问题描述
   最近接到外部项目组向我组提出的接口需求，需要查询我们业务办理量的统计情况。我们系统目前的情况是，有一个日增长十多万、总数据量为千万级别的业务办理明细表（xxx_info），每人次的业务办理结果会实时写入其中。以往对外提供的业务统计接口是在每次被调用时候在明细表中执行SQL查询（select、count、where、group by等），响应时间很长，对原生产业务的使用也有很大的影响。于是我决定趁着这次新增接口的上线机会对系统进行优化。
2.优化思路
   首先是在明细表之外再建立一个数据统计（xxx_statistics）表，考虑到目前数据库的压力以及公司内部质管流控等因素，暂没有分库存放，仍旧与原明细表放在同一个库。再设置一个定时任务于每日凌晨对明细表进行查询、过滤、统计、排序等操作，把统计结果插入到统计表中。然后对外暴露统计接口查询统计报表。现在的设计与原来的实现相比，虽然牺牲了统计表所占用的少量额外的存储空间（每日新增的十来万条业务办理明细记录经过处理最终会变成几百条统计表的记录），但是却能把select、count这样耗时的数据统计操作放到凌晨时段执行以避开白天的业务办理高峰，分表处理能够大幅降低对生产业务明细表的性能影响，而对外提供的统计接口的查询速度也将得到几个数量级的提升。当然，还有一个缺点是，不能实时提供当天的统计数据，不过这也是双方可以接受的。
3.设计实现
   设计一个定时任务，每日凌晨执行。在定时任务中启动两个线程，一个线程负责对业务明细表（xxx_info）进行查询统计，把统计的结果放置在内存缓冲区，另一个线程负责读取缓冲区中的统计结果并插入到业务统计表（xxx_statistics）中。
   亲，这样的场景是不是听起来很有感觉？没错!两个线程在内存中批量交换数据，这个事情我们可以使用Exchanger去做！我们马上来看看代码如何实现。

   生产者线程：

 

Java代码  

1. class ExchangerProducer implements Runnable {  
2.     private Exchanger<Set<XXXStatistics>> exchanger;  
3.     private Set<XXXStatistics> holder;  
4.     private Date fltDate;  
5.     private int threshold;  
6.   
7.     ExchangerProducer(Exchanger<Set<XXXStatistics>> exchanger,  
8.             Set<XXXStatistics> holder, Date fltDate, int threshold) {  
9.         this.exchanger = exchanger;  
10.         this.holder = holder;  
11.         this.fltDate = fltDate;  
12.         this.threshold = threshold;  
13.     }  
14.   
15.     @Override  
16.     public void run() {  
17.         try {  
18.             while (!Thread.interrupted() && !isDone) {  
19.                 List<XXXStatistics> temp1 = null;  
20.                 List<XXXStatistics> temp11 = null;  
21.                 for (int i = 0; i < allCities.size(); i++) {  
22.                     try {  
23.                         temp1 = xxxDao  
24.                                 .findStatistics1(  
25.                                         fltDate, allCities.get(i));  
26.                         temp11 = xxxDao  
27.                                 .findStatistics2(  
28.                                         fltDate, allCities.get(i),  
29.                                         internationalList);  
30.                         if (temp1 != null && !temp1.isEmpty()) {  
31.                             calculationCounter.addAndGet(temp1.size());  
32.                             if (temp11 != null && !temp11.isEmpty()) {  
33.                                 // merge two lists into temp1  
34.                                 mergeLists(temp1, temp11);  
35.                                 temp11.clear();  
36.                                 temp11 = null;  
37.                             }  
38.                             // merge temp1 into holder set  
39.                             mergeListToSet(holder, temp1);  
40.                             temp1.clear();  
41.                             temp1 = null;  
42.                         }  
43.                     } catch (Exception e) {  
44.                         log.error(e, e);  
45.                     }  
46.                     // Insert every ${threshold} or the last into database.  
47.                     if (holder.size() >= threshold  
48.                             || i == (allCities.size() - 1)) {  
49.                         log.info("data collected: \n" + holder);  
50.                         holder = exchanger.exchange(holder);  
51.                         log.info("data submitted");  
52.                     }  
53.                 }  
54.                 // all cities are calculated  
55.                 isDone = true;  
56.             }  
57.             log.info("calculation job done, calculated: "  
58.                     + calculationCounter.get());  
59.         } catch (InterruptedException e) {  
60.             log.error(e, e);  
61.         }  
62.         exchanger = null;  
63.         holder.clear();  
64.         holder = null;  
65.         fltDate = null;  
66.     }  
67. }  

   代码说明：

 

• threshold：缓冲区的容量阀值；
• allCities：城市列表，迭代这个列表作为入参来执行查询统计；
• XXXStatistics：统计数据封装实体类，实现了Serializable和Comparable接口，覆写equals和compareTo方法，以利用TreeSet提供的去重和排序处理；
• isDone：volatile boolean，标识统计任务是否完成；
• holder：TreeSet<XXXStatistics>，存放统计结果的内存缓冲区，容量达到阀值后提交给Exchanger执行exchange操作；
• dao.findStatistics1，dao.findStatistics2：简化的数据库查询统计操作，此处仅供示意；
• calculationCounter：AtomicInteger，标记生产端所提交的记录总数；
• mergeLists，mergeListToSet：内部私有工具方法，把dao查询返回的列表合并到holder中；

 

   消费者线程：

 

Java代码  

1. class ExchangerConsumer implements Runnable {  
2.     private Exchanger<Set<XXXStatistics>> exchanger;  
3.     private Set<XXXStatistics> holder;  
4.   
5.     ExchangerConsumer(Exchanger<Set<XXXStatistics>> exchanger,  
6.             Set<XXXStatistics> holder) {  
7.         this.exchanger = exchanger;  
8.         this.holder = holder;  
9.     }  
10.   
11.     @Override  
12.     public void run() {  
13.         try {  
14.             List<XXXStatistics> tempList;  
15.             while (!Thread.interrupted() && !isDone) {  
16.                 holder = exchanger.exchange(holder);  
17.                 log.info("got data: \n" + holder);  
18.                 if (holder != null && !holder.isEmpty()) {  
19.                     try {  
20.                         // insert data into database  
21.                         tempList = convertSetToList(holder);  
22.                         insertionCounter.addAndGet(xxxDao  
23.                                 .batchInsertXXXStatistics(tempList));  
24.                         tempList.clear();  
25.                         tempList = null;  
26.                     } catch (Exception e) {  
27.                         log.error(e, e);  
28.                     }  
29.                     // clear the set  
30.                     holder.clear();  
31.                 } else {  
32.                     log.info("wtf, got an empty list");  
33.                 }  
34.                 log.info("data processed");  
35.             }  
36.             log.info("insert job done, inserted: " + insertionCounter.get());  
37.         } catch (InterruptedException e) {  
38.             log.error(e, e);  
39.         }  
40.         exchanger = null;  
41.         holder.clear();  
42.         holder = null;  
43.     }  
44. }  

 

   代码说明：

• convertSetToList：由于dao接口的限制，需把交换得到的Set转换为List；
• batchInsertXXXStatistics：使用jdbc4的batch update而实现的批量插入dao接口；
• insertionCounter：AtomicInteger，标记消费端插入成功的记录总数；

 

   调度器代码：

Java代码  

1. public boolean calculateStatistics(Date fltDate) {  
2.     // initialization  
3.     calculationCounter.set(0);  
4.     insertionCounter.set(0);  
5.     isDone = false;  
6.     exec = Executors.newCachedThreadPool();  
7.     Set<XXXStatistics> producerSet = new TreeSet<XXXStatistics>();  
8.     Set<XXXStatistics> consumerSet = new TreeSet<XXXStatistics>();  
9.     Exchanger<Set<XXXStatistics>> xc = new Exchanger<Set<XXXStatistics>>();  
10.     ExchangerProducer producer = new ExchangerProducer(xc, producerSet,  
11.             fltDate, threshold);  
12.     ExchangerConsumer consumer = new ExchangerConsumer(xc, consumerSet);  
13.   
14.     // execution  
15.     exec.execute(producer);  
16.     exec.execute(consumer);  
17.     exec.shutdown();  
18.     boolean isJobDone = false;  
19.     try {  
20.         // wait for termination  
21.         isJobDone = exec.awaitTermination(calculationTimeoutMinutes,  
22.                 TimeUnit.MINUTES);  
23.     } catch (InterruptedException e) {  
24.         log.error(e, e);  
25.     }  
26.     if (!isJobDone) {  
27.         // force shutdown  
28.         exec.shutdownNow();  
29.         log.error("time elapsed for "  
30.                 + calculationTimeoutMinutes  
31.                 + " minutes, but still not finished yet, shut it down anyway.");  
32.     }  
33.   
34.     // clean up  
35.     exec = null;  
36.     producerSet.clear();  
37.     producerSet = null;  
38.     consumerSet.clear();  
39.     consumerSet = null;  
40.     xc = null;  
41.     producer = null;  
42.     consumer = null;  
43.     System.gc();  
44.   
45.     // return the result  
46.     if (isJobDone && calculationCounter.get() > 0  
47.             && calculationCounter.get() == insertionCounter.get()) {  
48.         return true;  
49.     }  
50.     return false;  
51. }  

   代码说明：
   调度器的代码就四个步骤：初始化、提交任务并等候处理结果、清理、返回。初始化阶段使用了jdk提供的线程池提交生产者和消费者任务，设置了最长等候时间calculationTimeoutMinutes，如果调度器线程被中断或者任务执行超时，awaitTermination会返回false，此时就强行关闭线程池并记录到日志。统计操作每日凌晨执行一次，所以在任务退出前的清理阶段建议jvm执行gc以尽早释放计算时所产生的垃圾对象。在结果返回阶段，如果查询统计出来的记录条数和插入成功的条数相等则返回true，否则返回false。

 

 

4.小结
   在这个案例中，使用Exchanger进行批量的双向数据交换可谓恰如其分：生产者在执行新的查询统计任务填入数据到缓冲区的同时，消费者正在批量插入生产者换入的上一次产生的数据，系统的吞吐量得到平滑的提升；计算复杂度、内存消耗、系统性能也能通过相关的参数设置而得到有效的控制（在消费端也可以对holder进行再次分割以控制每次批插入的大小，建议参阅数据库厂商以及数据库驱动包的说明文档以确定jdbc的最优batch update size）；代码的实现也很简洁易懂。这些优点，是采用有界阻塞队列所难以达到的。
   程序的输出结果与业务紧密相关，就不打印出来了。可以肯定的是，经过了一段时间的摸索调优，内存消耗、执行速度和处理结果还是比较满意的。

http://www.codeceo.com/article/java-8-20-datetime.html( Java 8 时间日期库的20个使用示例 )

http://www.phpxs.com/code/1009829( Java 8 时间日期库的20个使用示例)

http://www.phpxs.com/code/1009804( java zip压缩与解压-支持空目录，保留文件修改时间 )

http://www.phpxs.com/code/1009694( 从网络爬取图片，生成缩略图，保存到百度云存储！ )

http://www.phpxs.com/code/1001496( poi 操作excel 常用操作 )

http://www.phpxs.com/code/1001497( Java实现一个简单的内存缓存类 )

http://www.phpxs.com/code/1001522( 使用NIO进行文件拷贝 )

http://www.phpxs.com/code/1001555( 使用java NIO进行读文件 )

http://www.phpxs.com/code/1002228( Java实现FTP文件上传 )

http://kabike.iteye.com/blog/1775379(AtomicBoolean运用)