UIスレッドのコールバック用OPTIONALLYデザインパターン

Question

非同期コード補完ブロックを頻繁に使用するAPIを設計しています。

public interface IResult<T extends Result.I> { 
    void onResult(T); 
} 

public void doXYZ(IResult<Result.TypeA> iResult) { ... } 

ユーザーは、私のAPIのdoXYZ（）を呼び出してしまうと、別のネットワークワーカースレッドが後でiResult.onResult（）を呼び出します。時には彼はonResult（）が呼び出されたスレッドを気にしません。UIを更新するだけの場合もあります。ユーザーの負担を軽減し、匿名の内部クラスをきれいに保つことができます。小さい。

このAPIはAndroid用で、多くの場合（すべてではありません）、UI要素に影響を与えるonResult（）コールバックで何か操作を行い、コードがUIスレッド上で実行されることが必要な場合があります。 runOnUIThread（...）の呼び出しでコードをダーティにすることをユーザーに負わせるのではなく、doXYZ（）の呼び出し時に、 UIスレッドでコールバックを呼び出すかどうかを指定します。

1. パフォーマンス上の理由から、私のAPIが常にUIスレッドでonResult（）を呼び出さないようにしたいと思います。

2. 私が見た1つのパターンは、doXYZ（...、boolean callOnUIThread）メソッドパラメータを追加することです。しかし、APIが文書化されているので、私はむしろそれらの追加のブール値をすべて持つことによって、ドキュメンテーション（およびメソッドシグネチャ）を汚してはいけません。

3. 別の考えでは、各doXYZ（）がcallOnUIThreadパラメータのあるものと1つを持つようにオーバーロードされていましたが、膨大なためにドキュメント化に非常に悪いです。

4. もう1つは、onResult（）メソッドにonResult（）に加えてonResultUI（）メソッドを追加することでしたが、ユーザーのコードを匿名クラスで常に定義する必要があるため、

これを達成するためのクリーンな方法の提案は、次のとおりです。 i。簡潔 ii。コードの可読性には最適 iii。文書化が容易 ？

Answer 1

IResultのデコレータパターンを使用してください。

など。あなたがインターフェイスIResultを持っている場合は、あなたが飾られていることを保証デコレータを作成することができます

interface IResult<T> { 
    void onResult(T result); 
} 

この

class PrintCurrentThreadAndResult implements IResult<String> { 
    @Override 
    public void onResult(String result) { 
    Thread thread = Thread.currentThread(); 
    System.out.print(thread.getName()); 
    System.out.print(" - "); 
    System.out.println(result); 
    } 
} 

のような結果コールバックの実装（私は、デモ用に簡単ジェネリック型Tを作りました）結果は特別なスレッド（例えば、UIスレッド）上で呼び出されます。誰もが簡単にコンパイルしてテストできるように、ここでスイングのイベントディスパッチャスレッドを使用します。

class UIThreadAwareResult<T> implements IResult<T> { 

    private IResult<T> delegate; 

    public UIThreadAwareResult(IResult<T> delegate) { 
    this.delegate = delegate; 
    } 

    @Override 
    public void onResult(T result) { 
    invokeOnUIThread(result); 
    } 

    private void invokeOnUIThread(final T result) { 
    try { 
     EventQueue.invokeAndWait(new Runnable() { 
     @Override 
     public void run() { 
      delegate.onResult(result); 
     } 
     }); 
    } catch (Exception e) { 
     throw new RuntimeException(e); 
    } 
    } 
} 

クライアントコードは、元の結果を飾るだけで実行するスレッドを選択できます。

public class Main { 

    public static void main(String[] args) { 
    Main main = new Main(); 

    IResult<String> result = new PrintCurrentThreadAndResult(); 
    main.doXYZ(result); 

    IResult<String> uiThreadAwareResult = new UIThreadAwareResult<String>(result); 
    main.doXYZ(uiThreadAwareResult); 
    } 

    public void doXYZ(IResult<String> iResult) { 
    iResult.onResult("Hello"); 
    } 
} 

出力は

main - Hello 
AWT-EventQueue-0 - Hello