XLVII. Java

Es gibt zwei Wege, um die Welten von Java und PHP zu verbinden. Einerseits besteht die M�glichkeit PHP in eine Java Servlet Umgebung zu integrieren, andererseits kann man mit der Java Extension aus PHP heraus auf Java Klassen zugreifen. Die erste der beiden genannten M�glichkeit ist wesentlich stabiler und performanter als die zweitgenannte L�sung.

Die Java Erweiterung f�r PHP nutzt das Object Overloading von PHP 4 um auf Java Klassen zuzugreifen. Die Java Virtual Machine (JVM) wird hierbei �ber das Java Native Interface (JNI) erzeugt. Eine detaillierte Installationsbeschreibung entnehmen Sie bitte der Datei php4/ext/java/README.

<?php
  // In PHP Instanz der Java Klasse java.lang.System erzeugen
  $system = new Java('java.lang.System');

  // Zugriff auf die Objekteigenschaften
  print 'Java version='.$system->getProperty('java.version').' <br>';
  print 'Java vendor=' .$system->getProperty('java.vendor').'  <br>';
  print 'OS='.$system->getProperty('os.name').' '.
              $system->getProperty('os.version').' on '.
              $system->getProperty('os.arch').' <br>';

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

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

<?php
  // Dieses Beispiel kann nur als CGI ausgef�hrt werden.

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

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

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

  $frame->dispose();
?>

• new Java() erzeugt eine Instanz der angegebenen Java Klasse, falls ein geeigneter Konstruktur gefunden wird. F�r den Zugriff auf Klassen mit statischen Methoden ben�tigt man keinen Parameter.

• Beim Zugriff auf Mitglieder (Members) einer Instanz wird zun�chst nach Bean Eigenschaften gesucht, danach erst nach �ffentlichen (public) Eigenschaften. Mit anderen Worten: Es wird zuerst versucht werden, zum Beispiel print $date.time als $date.getTime() zu interpretieren, danach erst wird $date.time versucht werden.

• Der Zugriff auf statische und Instanzeigenschaften erfolgt mit der selben Syntax.

• Das Ausl�sen einer Java Exception resultiert in einer PHP Warnung und einem NULL Ergebnis. Folgende Funktionen erm�glichen den Zugriff auf die eigentlichen Exceptions:

  • java_last_exception_get()

  • java_last_exception_clear()

• Traditionell k�nnen Arrays und Hashes in PHP weitestgehend als gleichwertig angesehen werden. Beim Austausch dieser Datentypen zwischen PHP und Java ist zu beachten, dass Hashes in PHP nur mit Integer- und Stringwerten indiziert werden k�nnen und Arrays von primitiven Datentypen in Java nicht d�nn besetzt sein d�rfen. Ferner ist zu beachten, dass diese Datenstrukturen by-Value �bergeben werden, was ung�nstig in Bezug auf Speicher- und Zeitbedarf sein kann.

Das PHP 4 Servlet SAPI Modul baut auf dem von der Java Extension zur Verf�gung gestellten Mechanismus auf, allerdings wird der PHP Prozessor hierbei von einer Servlet Engine, wie zum Beispiel Apache Jakarta / Tomcat, ausgef�hrt. Dies f�hrt zu einer wesentlich h�heren Stabilit�t und besserer Performance als der umgekehrte Weg, wie in die Java Extension an sich anbietet. Dies kommt daher, dass die Servlet Engine sich um das Pooling und die Wiederverwendung von Java Virtual Machines (JVMs) k�mmert. Eine detaillierte Anleitung zur Integration von PHP in eine Servlet Engine entnehmen Sie bitte der Datei php4/sapi/README. Bemerkungen:

• Das Servlet SAPI Modul sollte zwar auf jeder Java Servlet Engine funktionieren, wurde aber bislang nur in Verbindung mit Apache Jakarta/Tomcat getestet. Meldungen von Problem - aber auch von Erfolgserlebnissen - bei der Verendung mit anderen Servlet Engines werden dankbar aufgenommen.

• PHP hat die Angewohnheit das aktuelle Arbeitsverzeichnis (CWD) zu �ndern. sapi/servlet wird versuchen, den alten Zustand wieder herzustellen. W�hrend PHP l�uft kann es sein, dass die Servlet Engine kann Klassen aus dem CLASSPATH finden kann, die �ber relative Pfade angesprochen werden.