2.3.11 アプレットへの終了問合せ

JBKプラグインが提供するアプレットへの終了問合せ機能を説明します。

注意

この機能は現在の環境では推奨しません。

JBKプラグインは、ユーザがブラウザのウィンドウを閉じようとしたときに、そのウィンドウ上で実行しているアプレットに対して終了の問合せを行う機能を提供しています。この機能を使用するアプレットは、JBKプラグインからの終了問合せに対して、終了の許可／不許可を返答することができます。

それぞれの場合の動作は以下のようになります。

終了を許可した場合には、JBKプラグインはアプレットの終了処理を行った後にブラウザのウィンドウを閉じます。
終了を許可しなかった場合には、ブラウザのウィンドウを閉じる処理はキャンセルされ、アプレットの実行はそのまま継続します。

この機能を用いると、アプレットがある特定の処理(例えばデータベースへの接続処理など)を行っている場合に、ブラウザの終了を一時的に抑止することが可能になります。

アプレットへの終了問合せ機能

アプレットからJBKプラグインの終了問合せ機能を使用するには、アプレットにPluginAppletCallbackインタフェースを実装してください。PluginAppletCallbackインタフェースはJBKプラグインが提供するインタフェースです。PluginAppletCallbackインタフェースのAPIは以下のとおりです。

インタフェース名：
- com.fujitsu.jbk.plugin.browser.PluginAppletCallback
  (extends java.lang.Object)
メソッド：
- destroyRequested
  ブラウザのウィンドウが閉じるときに、アプレットに終了を問い合わせるために呼び出されます。
  public abstract boolean destroyRequested()
  返り値
  終了を許可する場合はtrueを返してください。許可しない場合はfalseを返してください。
- destroyCancelled
  ブラウザのウィンドウを閉じる処理がキャンセルされたときに呼び出されます。
  public abstract void destroyCancelled()

例

終了問合せ機能を使用するアプレットの例

import java.applet.*;

import com.fujitsu.jbk.plugin.browser.PluginAppletCallback;

/**
 * 終了問い合わせを使用するアプレット
 */
public class DestroySample extends Applet implements PluginAppletCallback
{
    /**
     * アプレットの終了問い合わせ時に呼び出されるメソッド
     */
    public boolean destroyRequested() {
        // アプレットの終了を許可しない場合にはfalseを返してください。
        if (/* アプレットの終了を許可しない場合 */) {
            return false;
        }

        // アプレットの終了を許可する場合にはtrueを返してください。
        return true;
    }

    /**
     * アプレットの終了が不許可となり、ブラウザのウィンドウを閉じる処理が
     * キャンセルされたときに呼び出されるメソッド
     */
    public void destroyCancelled() {
        // ブラウザのウィンドウを閉じる処理がキャンセルされたときに
        // 何か処理を行う必要がある場合には、ここに記述してください。
    }
}

注意

destroyRequested()メソッドおよびdestroyCancelled()メソッドの中では、ダイアログ表示およびキーボードやマウス入力などのGUI操作を伴う処理を行わないようにしてください。これらの処理を行うと、ブラウザが処理を受け付けなくなる場合があります。

複数のアプレットが実行されている場合

ブラウザのウィンドウ上で複数のアプレットが実行されている場合には、JBKプラグインはそれらすべてのアプレットに対して順番にdestroyRequested()メソッドを呼び出します。

すべてのアプレットが終了を許可した(trueを返した)場合には、ブラウザのウィンドウが閉じられます。
1つでも終了を許可しない(falseを返した)アプレットがあった場合には、JBKプラグインはその時点でdestroyRequested()メソッドの呼出しを止め、ブラウザのウィンドウを閉じる処理をキャンセルし、その後ですべてのアプレットに対してdestroyCancelled()メソッドを呼び出します。
したがって、各アプレットは自分が終了を許可した場合にも、他のアプレットが終了を許可しなかったということを知ることができます。