基本的な使用法

例1 Java の例


<?php
// Java クラス java.lang.System のインスタンスをPHPに作成する
$system = new Java('java.lang.System');

// プロパティへのアクセスのデモ
echo 'Java version=' . $system->getProperty('java.version') . '<br />';
echo 'Java vendor=' . $system->getProperty('java.vendor') . '<br />';
echo 'OS=' . $system->getProperty('os.name') . ' ' .
             $system->getProperty('os.version') . ' on ' .
             $system->getProperty('os.arch') . ' <br />';

// java.util.Dateの例
$formatter = new Java('java.text.SimpleDateFormat',
                      "EEEE, MMMM dd, yyyy 'at' h:mm:ss a zzzz");

echo $formatter->format(new Java('java.util.Date'));
?>

例2 AWT Example


<?php
// この例は、CLI を使用して実行することのみを考慮しています。

$frame  = new Java('java.awt.Frame', 'PHP');
$button = new Java('java.awt.Button', 'Hello Java World!');

$frame->add('North', $button);
$frame->validate();
$frame->pack();
$frame->visible = True;

$thread = new Java('java.lang.Thread');
$thread->sleep(10000);

$frame->dispose();
?>

注意:

new Java() は、有効なコンストラクタがある場合、クラスのインスタンスを生成します。引数が指定されない場合には、デフォルトのコンストラクタにより java.lang.Systemのようなクラスにアクセスすると良いでしょう。このクラスは、ほとんどの機能を静的なメソッドとして公開しています。
あるインスタンスのメンバーにアクセスする際には、まず bean プロパティが探されてから、次に public フィールドが探されます。言い換えると、 print $date.time はまず $date.getTime() と解釈され、続いて $date.time と解釈されます。
静的メンバおよびインスタンスメンバは共に同じ構文でアクセス可能です。さらに、java オブジェクトが java.lang.Class 型の場合、このクラスの静的メンバ(フィールドとメソッド)にアクセス可能です。
例外が発生すると PHP の警告が出力され、結果は NULL となります。警告は "@" 記号を付けてメソッドをコールすることに抑圧できます。直近のエラーを取得し、リセットするために以下の API を使用することができます。
- java_last_exception_get()
- java_last_exception_clear()
オーバーロードの解決は、二つの言語の間で型の違いがあるため一般には困難な問題です。PHP の Java 拡張機能は、どのオーバーロードが最も一致するかを定義するための方法として、簡単ですがかなり効率的なものを使用しています。加えて、PHP のメソッド名は大文字小文字を区別しないため、選択されるオーバーロードの数は増加する傾向があります。メソッドが一度選択されると、パラメータの値は必要に応じて調整されます。このため、(倍精度実数が論理値に変換されるといった)データの劣化が発生する可能性があります。
PHP では伝統的に配列とハッシュテーブルは相互に完全に可換でした。PHP のハッシュテーブルは整数または文字列の添字のみを使用できることに注意してください。また、Java の primitive 型の配列は疎とすることができないことにも注意してください。これらの構造は値で渡されるため、メモリと時間の消費量が大きくする可能性があります。