【Android開発】PriorityBlockingQueueのoffer()メソッドの使い方をわかりやすく解説

PriorityBlockingQueueとは

サンプルコードに入る前に、まずPriorityBlockingQueue（プライオリティブロッキングキュー）について簡単に確認しておきましょう。PriorityBlockingQueueは「無制限（アンバウンド）」のキューであり、優先度キューと同じ順序ルールに従って要素を管理します。内部的にはヒープ構造を採用しており、要素は自然順序付け（または指定したComparator）に基づいて並べ替えられます。また、スレッドセーフであるため、マルチスレッド環境での producer-consumer パターンなどにも活用されています。

この記事では、AndroidのPriorityBlockingQueueでoffer()メソッドを使用する方法を、実際のサンプルコードとともに解説します。

なお、offer()はadd()と同様にキューへ要素を挿入するメソッドですが、容量制限のあるキューで挿入に失敗した場合に例外をスローせずfalseを返す点が特徴です。PriorityBlockingQueue自体は無制限キューのため、通常は常に挿入が成功します。

ステップ1：新規プロジェクトの作成

Android Studioで新しいプロジェクトを作成します。メニューから[File] → [New Project] を選択し、必要な項目をすべて入力してプロジェクトを作成しましょう。

ステップ2：レイアウトファイルの作成

res/layout/activity_main.xml に以下のコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:gravity="center"
    android:layout_height="match_parent"
    tools:context=".MainActivity"
    android:orientation="vertical">
    <TextView
        android:id="@+id/actionEvent"
        android:textSize="40sp"
        android:layout_marginTop="30dp"
        android:layout_width="wrap_content"
        android:layout_height="match_parent" />
</LinearLayout>

このレイアウトでは、PriorityBlockingQueueの要素を表示するためのTextViewを1つ配置しています。テキストサイズを40spに設定し、画面中央に表示されるようにしています。

ステップ3：MainActivity.javaの実装

src/MainActivity.java に以下のコードを追加します。

package com.example.myapplication;
import android.os.Build;
import android.os.Bundle;
import android.support.annotation.RequiresApi;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.TextView;
import java.util.concurrent.PriorityBlockingQueue;
public class MainActivity extends AppCompatActivity {
   PriorityBlockingQueue priorityBlockingQueue;
   @RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      priorityBlockingQueue = new PriorityBlockingQueue();
      final TextView actionEvent = findViewById(R.id.actionEvent);
      priorityBlockingQueue.add("sai");
      priorityBlockingQueue.add("ram");
      priorityBlockingQueue.add("krishna");
      priorityBlockingQueue.add("prasad");
      priorityBlockingQueue.add("ram");
      actionEvent.setText("" + priorityBlockingQueue);
      actionEvent.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            priorityBlockingQueue.offer("tutorialspoint.com");
            actionEvent.setText("" + priorityBlockingQueue);
         }
      });
   }
}

コードのポイント

• 初期状態： onCreate()内でadd()メソッドを使って複数の文字列をキューに追加し、その内容をTextViewに表示しています。
• クリック時の処理： TextViewをタップするとoffer()メソッドが呼び出され、新しい要素「tutorialspoint.com」がキューに追加されます。追加後、最新のキューの内容がTextViewに再描画されます。
• 文字列の場合は辞書順（自然順序）で並び替えられるため、挿入位置は自動的に決まります。

アプリの実行と動作確認

それではアプリケーションを実行してみましょう。実際のAndroid端末をパソコンに接続している前提で説明します。Android Studioからアプリを実行するには、プロジェクト内のアクティビティファイルを開き、ツールバーの実行（Run）アイコンをクリックしてください。表示された選択肢から接続済みのモバイルデバイスを選ぶと、端末にアプリの初期画面が表示されます。

次に、画面上のTextViewをタップしてみてください。offer()によって要素が追加され、以下のように更新されたキューの内容が表示されます。

まとめ

このように、PriorityBlockingQueueのoffer()メソッドを使えば、例外を発生させることなく安全にキューへ要素を追加できます。add()との違いを理解し、用途に応じて使い分けることで、より堅牢なAndroidアプリケーションを構築できるでしょう。