2017 年你不能錯過的 Java 類庫

Retrofit

Retrofit 是 Square 下的型別安全的 HTTP 客戶端，支援 Android 和 Java 等，它能將你的 HTTP API 轉換為 Java 介面。

Retrofit 將 HTTP API 轉換為 Java 介面：

public interface GitHubService {
    @GET("users/{user}/repos")
    Call<List<Repo>listRepos(@Path("user") String user);
}
Retrofit 類實現 GitHubService 介面：

Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("https://api.github.com/")
    .build();

GitHubService service = retrofit.create(GitHubService.class);

JDeferred

與JQuery類似的Java Deferred/Promise類庫

• Deferred 物件和 Promise
• Promise 回撥：.then(…), .done(…), .fail(…), .progress(…), .always(…)
• 支援多個promises - .when(p1, p2, p3, …).then(…)
• Callable 和 Runnable - wrappers.when(new Runnable() {…})
• 使用 Executor 服務
• 支援Java 泛型： Deferred<Integer, Exception, Doubledeferred;, deferred.resolve(10);, deferred.reject(new Exception());,deferred.notify(0.80);,
• 支援Android
• Java 8 Lambda的友好支援

GitHu連結，官方網站連結

RxJava

RxJava – JVM的響應式程式設計擴充套件 – 是一個為Java虛擬機器編寫的使用可觀察序列的構建非同步的基於事件的程式的類庫。

它基於觀察者模式實現對資料/事件的序列的支援，並新增了一些操作符，允許你以宣告式構建序列， 使得開發者無需關心底層的執行緒、同步、執行緒安全和併發資料結構。

RxJava最常見的一個用法就是在後臺執行緒執行一些計算和網路請求，而在UI執行緒顯示結果（或者錯誤）：

Flowable.fromCallable(() -{
     Thread.sleep(1000); //  imitate expensive computation
     return "Done";
 })
   .subscribeOn(Schedulers.io())
   .observeOn(Schedulers.single())
   .subscribe(System.out::println, Throwable::printStackTrace);

 Thread.sleep(2000); // <--- wait for the flow to finish

GitHub, Wiki

MBassador

MBassador是一個實現了釋出-訂閱模式的輕量級的，高效能的事件匯流排。它易於使用，併力求功能豐富，易於擴充套件，而同時又保證資源的高效利用和高效能。

MBassador的高效能的核心是一個專業的資料結構，它提供了非阻塞的讀取器，並最小化寫入器的鎖爭用，因此併發讀寫訪問的效能衰減會是最小的。

• 註解驅動的
• 提供任何東西，慎重對待型別層次結構
• 同步和非同步的訊息傳遞
• 可配置的引用型別
• 訊息過濾
• 封裝的訊息
• 處理器的優先順序
• 自定義錯誤處理
• 可擴充套件性

// Define your listener
class SimpleFileListener{
    @Handler
    public void handle(File msg){
      // do something with the file
    }
}

// somewhere else in your code
MBassador bus = new MBassador();
Object listener = new SimpleFileListener();
bus.subscribe (listener);
bus.post(new File("/tmp/smallfile.csv")).now();
bus.post(new File("/tmp/bigfile.csv")).asynchronously();

GitHub, Javadoc

Lombok專案

使用註解來減少Java中的重複程式碼，比如getter，setters，非空檢查，生成的Builder等。

• val - 總算有了！無憂的final本地變數。
• @NonNull - 或：我如何學會不再擔心並愛上了非空異常（NullPointerException）。
• @Cleanup - 自動的資源管理：安全呼叫你的close() 方法，無需任何麻煩。
• @Getter / @Setter - 再也不用寫 public int getFoo() {return foo;}了。
• @ToString - 無需啟動偵錯程式來檢查你的欄位：就讓Lombok來為你生成一個toString方法吧！
• @EqualsAndHashCode - 實現相等的判斷變得容易了：它會從你的物件的欄位裡為你生成hashCode和equals方法的實現。
• @NoArgsConstructor, @RequiredArgsConstructor and @AllArgsConstructor - 定做建構函式：為你生成各種各樣的建構函式，包括無參的，每一個final或非空的欄位作為一個引數的，或者每一個欄位都作為引數的。
• @Data - 所有的都同時生成：這是一個快捷方式，可以為所有欄位生成@ToString, @EqualsAndHashCode, @Getter註解，以及為所有非final的欄位生成@Setter註解，以及生成@RequiredArgsConstructor！
• @Value - 宣告一個不可變類變得非常容易。
• @Builder - … 而且鮑伯是你叔叔：建立物件的無爭議且奢華的介面！
• @SneakyThrows - 在以前沒有人丟擲檢查型異常的地方大膽的丟擲吧！
• @Synchronized - 正確的實現同步：不要暴露你的鎖。
• @Getter(lazy=true) 懶惰是一種美德！
• @Log - 船長日誌，星曆24435.7： “那一行又是什麼呢？”

GitHub, Website

Java簡單日誌門面（SLF4J）

Java簡單日誌門面 (SLF4J) 為不同的日誌框架（比如java.util.logging, logback, log4j）提供了簡單的門面或者抽象的實現，允許終端使用者在部署時能夠接入自己想要使用的日誌框架。

簡言之，類庫和其他嵌入式的元件都應該考慮採用SLF4J作為他們的日誌需求，因為類庫無法將它們對日誌框架的選擇強加給終端使用者。另一方面，對於獨立的應用來說，就不一定需要使用SLF4J。獨立應用可以直接呼叫他們自己選擇的日誌框架。而對於logback來說，這個問題是沒有意義的，因為logback是通過SLF4J來暴露其日誌介面的。

Website, GitHub, FAQ

JUnitParams

對測試進行引數化，還不錯

       @Test
       @Parameters({"17, false", 
                    "22, true" })
       public void personIsAdult(int age, boolean valid) throws Exception {
         assertThat(new Person(age).isAdult(), is(valid));
       }

與標準的JUnit 引數化執行器的區別如下：

• 更明確 – 引數實在測試方法的引數中，而不是在類的欄位中
• 更少的程式碼 – 你不需要用建構函式來設定引數
• 你可以在同一個類混合使用引數化和非引數化的方法。
• 引數可以通過一個CSV字串或者一個引數提供類傳入。
• 引數提供類可以擁有儘可能多的引數提供方法，這樣你可以給不同的用例進行分類。
• 你可以擁有可以提供引數的測試方法 （再也不需要外部類或者靜態類了）
• 你可以在你的整合開發工具中看到實際的引數值（而在JUnit的Parametrised裡，只有連續數目的引數）

官方網站，GitHub，快速入門

Mockito

Java裡單元測試的非常棒（tasty）的模擬框架：

 //你可以模擬具體的類，而不只是介面
 LinkedList mockedList = mock(LinkedList.class);

 //打樁
 when(mockedList.get(0)).thenReturn("first");
 when(mockedList.get(1)).thenThrow(new RuntimeException());

 //以下程式碼列印出"first"字串
 System.out.println(mockedList.get(0));

 //以下程式碼丟擲執行時異
 System.out.println(mockedList.get(1));

 //以下程式碼列印出"null"，因為get(999)沒有被打樁
 System.out.println(mockedList.get(999));

 //儘管是可以驗證一個打過樁的呼叫，但通常是多餘的
 //如果你的程式碼關心get(0)返回值的內容，那麼其他東西就會中斷（往往在verify()執行之前就發生了）。
 //如果你的程式碼不關心get(0)返回值的內容，那麼它就不應該被打樁。不相信嗎？看看這裡。
 verify(mockedList).get(0);

@RunWith(JukitoRunner.class)
public class EmailSystemTest {

  @Inject EmailSystemImpl emailSystem;
  Email dummyEmail;

  @Before
  public void setupMocks(
      IncomingEmails incomingEmails,
      EmailFactory factory) {
    dummyEmail = factory.createDummy();
    when(incomingEmails.count()).thenReturn(1);
    when(incomingEmails.get(0)).thenReturn(dummyEmail);
  }

  @Test
  public void shouldFetchEmailWhenStarting(
      EmailView emailView) {
    // WHEN
    emailSystem.start();

    // THEN
    verify(emailView).addEmail(dummyEmail);
  }
}

GitHub, Website

@Test
public void updatesCustomerStatus() throws Exception {
    // Publish an asynchronous event:
    publishEvent(updateCustomerStatusEvent);
    // Awaitility lets you wait until the asynchronous operation completes:
    await().atMost(5, SECONDS).until(customerStatusIsUpdated());
    ...
}