mirror of
https://github.com/macintoshplus/doc-fr.git
synced 2026-03-26 18:02:17 +01:00
b8daeaab85
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@78204 c90b9560-bf6c-de11-be94-00142212c4b1
179 lines
7.5 KiB
XML
179 lines
7.5 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!-- $Revision: 1.1 $ -->
|
|
<reference id="ref.java">
|
|
<title>Java</title>
|
|
<titleabbrev>Intégration de Java</titleabbrev>
|
|
<partintro>
|
|
<para>
|
|
Il y a deux moyens de connecter PHP et Java : soit en intégrant
|
|
Java directement dans PHP, ce qui est la solution la plus stable et
|
|
la plus efficace, ou en intégrant PHP dans un environnement de
|
|
Servlet Java. La première solution est fournie par cette extension
|
|
Java, et la dernière par le module SAPI qui s'interface avec
|
|
un serveur de Servlet.
|
|
</para>
|
|
<para>
|
|
PHP 4 ext/java fournit un moyen simple mais efficace pour invoquer et
|
|
créer des objets Java, depuis PHP. Une machine virtuelle est
|
|
créée via JNI,
|
|
et le tout fonctionne avec des processus fils. Les instructions d'installation
|
|
pour cette extension sont sont disponibles dans le fichier :
|
|
<filename>php4/ext/java/README</filename>.
|
|
<example>
|
|
<title>Exemple avec Java</title>
|
|
<programlisting role="php">
|
|
<?php
|
|
// crée une instance de Java class java.lang.System en PHP
|
|
$system = new Java("java.lang.System");
|
|
// accède aux propriétés
|
|
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>";
|
|
// Exemple avec java.util.Date
|
|
$formatter = new Java("java.text.SimpleDateFormat",
|
|
"EEEE, MMMM dd, yyyy 'at' h:mm:ss a zzzz");
|
|
print $formatter->format(new Java("java.util.Date"));
|
|
?>
|
|
</programlisting>
|
|
</example>
|
|
<example>
|
|
<title>Exemple AWT</title>
|
|
<programlisting role="php">
|
|
<?php
|
|
// Cet exemple ne fonctionne qu'en mode CGI.
|
|
$frame = new Java("java.awt.Frame", "Zend");
|
|
$button = new Java("java.awt.Button", "Bonjour au monde Java!");
|
|
$frame->add("Nord", $button);
|
|
$frame->validate();
|
|
$frame->pack();
|
|
$frame->visible = true;
|
|
$thread = new Java("java.lang.Thread");
|
|
$thread->sleep(10000);
|
|
$frame->dispose();
|
|
?>
|
|
</programlisting>
|
|
</example>
|
|
Notes:
|
|
<itemizedlist>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>new Java()</literal> crée une nouvelle instance d'une classe,
|
|
si un constructeur valable est disponible. Si aucun paramètre n'est passé,
|
|
et le constructeur par défaut est utile pour accéder à ces classes
|
|
telles que "java.lang.System", qui fournissent leur fonctionnalités via
|
|
des méthodes statiques.
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
Lors de l'accès aux membres d'une instance, PHP commencera par rechercher
|
|
les membres Bean, puis les champs publics. En d'autres termes,
|
|
"<literal>print $date.time</literal>" sera d'abord résolu par
|
|
"<literal>$date.getTime()</literal>", puis par "<literal>$date.time</literal>";
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
Les membres statiques et d'instance sont accessibles avec la même
|
|
syntaxe. De plus, si un objet est de type "<literal>java.lang.Class</literal>",
|
|
les membres statiques de la classe (champs et méthodes) sont accessibles.
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Les exceptions sont transformées en alertes PHP, et résultat NULL.
|
|
Les alertes peuvent être supprimées en préfixant l'appel
|
|
par l'opérateur <literal>></literal>. Les fonctions suivantes
|
|
peuvent être utilisées pour lire et effacer la dernière
|
|
erreur remontée :
|
|
<itemizedlist>
|
|
<listitem><simpara><function>java_last_exception_get</function></simpara></listitem>
|
|
<listitem><simpara><function>java_last_exception_clear</function></simpara></listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
Les surchargements de fonctions sont des problèmes épineux,
|
|
étant donné les différences de type de valeurs entre les deux
|
|
langages. L'extension Java de PHP utilise une métrique simple
|
|
mais efficace pour déterminer la meilleur fonction à utiliser.
|
|
</simpara>
|
|
<simpara>
|
|
De plus, les noms de méthodes ne sont pas sensibles à la casse en
|
|
PHP, ce qui augmente le nombre de conflits potentiels.
|
|
</simpara>
|
|
<simpara>
|
|
Une fois qu'une méthode est sélectionnée, les paramètres sont
|
|
transtypés, avec une perte d'information potentielle non négligeable
|
|
(par exemple, les nombres à virgules flottante en double précisions
|
|
seront convertis en booléen).
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
Traditionnellement en PHP, les tableaux et les tables de hashage peuvent
|
|
être interchangées, et fonctionnent de la même façon.
|
|
Notez que les tables de hashage de PHP ne peuvent être indexées
|
|
qu'avec des entiers ou des chaînes, et que le type primitif de
|
|
tableau de Java ne peut comporter de trous dans les index. Notez aussi
|
|
que les valeurs sont passées par
|
|
valeur, ce qui peut être coûteux en mémoire et en temps.
|
|
</simpara>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
<para>
|
|
L'interface PHP4 sapi/servlet est construite sur un mécanisme défini
|
|
par l'extension Java, qui permet à PHP d'être exécuté
|
|
comme une servlet. L'avantage immédiat d'un point de vue PHP est que les
|
|
serveurs web qui supportent les servlets gèrent rigoureusement les
|
|
machines virtuelles. Les instructions d'installation du module Servlet SAPI
|
|
sont disponibles dans le fichier <filename>php4/sapi/README</filename>.
|
|
Notes:
|
|
<itemizedlist>
|
|
<listitem>
|
|
<simpara>
|
|
Bien que ce code soit prévu pour fonctionner sur n'importe quel
|
|
serveur à Servlet, il n'a été testé qu'avec le module Apache
|
|
Jakarta/tomcat (jusqu'à aujourd'hui). Les remontées de bugs, les
|
|
réussites et les patches nécessaires pour faire fonctionner ce code
|
|
sur d'autres serveurs sont fortement encouragés!
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
PHP a l'habitude de changer le dossier de travail. Le serveur SAPI/Servlet
|
|
le changera à nouveau, mais tant que PHP fonctionnera, le moteur de servlet
|
|
ne pourra pas charger de classes dans le CLASSPATH, si le dossier est
|
|
spécifié avec un chemin relatif, ou ne pourra pas trouver le dossier
|
|
d'administration et de compilation des tâches JSP.
|
|
</simpara>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
</partintro>
|
|
&reference.java.functions;
|
|
|
|
</reference>
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"../../../manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
-->
|
|
|