APIリファレンスの見方と解釈の仕方

Question

アンドロイドからのWebSocket通信に関するご質問です。
現在下記のコードを、使えてはいるのですが、内容を理解しようとしてコードとリファレンスを見比べても、APIリファレンスの見方を含めて、コードがどのように動いているのかよく理解できません。
分からないのは、コメントアウトの「ここから」「ここまで」の２行です。
その辺を教えて頂けないでしょうか。
（アンドロイドはUIスレッドからの通信を禁止していることは理解しています）

私の考察としては、サーバーとのやり取りをトリガーとしてonOpenが非同期処理を実行しているのではないかと思っています。
宜しくお願い致します。

import androidx.appcompat.app.AppCompatActivity;
import org.java_websocket.client.WebSocketClient;
import org.java_websocket.handshake.ServerHandshake;

public class MainActivity extends AppCompatActivity {

    private class MyWsClientListener extends WebSocketClient {

        @Override
        public void onOpen(ServerHandshake handshakedata) {　  // ここから

            runOnUiThread(new Runnable() {                     // ここまで
                @Override
                public void run() {
                    wsStateTextView.setText("Conneted!!");
                }
            });
        }

APIリファレンスのリンク
・onOpen
・ServerHandshake
・runOnUiThread
・Runnable

わかったようなことを書いていますが、当方初心者です（汗）
初心者向けのご回答を頂けると幸いです。

Comments

[m.ts10806]

ご自身の解釈もある程度（もう少し具体的に）考察として書かれたほうが丸投げ感も薄まると思います。
例えば、ドキュメントから該当しそうな箇所を抜粋してくるとか

[kfsuuh384]

ご指摘ありがとうございます。
自分なりの考察を追加致しました。
宜しくお願い致します。

Answer 1

私の考察としては、サーバーとのやり取りをトリガーとしてonOpenが非同期処理を実行しているのではないかと思っています。

わからない箇所をもっと明確にするために、もっと平易で具体的な言葉に置き換えてみると良いかもしれません。

例えば、次の問いに答えてみてください。

• サーバーとのやり取りとは？
• トリガーとは？
• 非同期処理とは？

例えば、コードから平易な質問に置き換えると、次のような問いが考えられます。

• onOpen が実行される条件は？
• ServerHandshake として受け取る情報は何か？
• runOnUiThread は何をしているのか？
• Runnable とは何を表現したものなのか？

このように疑問に対して言語化できると検索できるので考え方の糸口が拡がっていきます。

Answer 2

APIリファレンスのリンク

最初のonOpenのリンクは正しくありません。

org.java_websocket.client.WebSocketClientは、java.net.http.WebSocket.Listenerを実装していませんので、当該のonOpenは、このコードで使われているonOpenとは無関係です。

Comments

[kfsuuh384]

ご指摘ありがとうございます。
onOpenは、org.java_websocket.client.WebSocketClientのメソッドでした。
修正致しましたので、宜しくお願い致します。