cvs: phpdoc /fr/functions java.xml
| From: | Damien Seguy | Date: | Thu, 12 Jul 2001 12:19:58 +0000 |
| Subject: | cvs: phpdoc /fr/functions java.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336207@lists.php.net to get a copy of this message | ||
dams Thu Jul 12 08:19:58 2001 EDT
Added files:
/phpdoc/fr/functions java.xml
Log:
Initial translation
Index: phpdoc/fr/functions/java.xml +++ phpdoc/fr/functions/java.xml <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> <refentry id="function.java-last-exception-clear"> <refnamediv> <refname>java_last_exception_clear</refname> <refpurpose>Efface la dernière exception Java</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>void <function>java_last_exception_clear</function></funcdef> <void/> </funcprototype> </funcsynopsis> </refsect1> </refentry> <refentry id="function.java-last-exception-get"> <refnamediv> <refname>java_last_exception_get</refname> <refpurpose>Lit la dernière exception Java</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>exception <function>java_last_exception_get</function></funcdef> <void/> </funcprototype> </funcsynopsis> <para> L'exemple ci-dessous montre l'utilisation du gestionnaire d'exceptions java : <example> <title>Gestionnaire d'exception Java</title> <programlisting role="php"> <?php $stack = new Java("java.util.Stack"); $stack->push(1); // Cela doit marcher $result = $stack->pop(); $ex = java_last_exception_get(); if (!$ex) print "$result\n"; // Cela doit échouer (le rapport d'erreurs est supprimé par >) $result = @$stack->pop(); $ex = java_last_exception_get(); if ($ex) print $ex->toString(); // Efface la dernière exception java_last_exception_clear(); ?> </programlisting> </example> </para> </refsect1> </refentry> </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 sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: -->
Index: phpdoc/fr/functions/java.xml +++ phpdoc/fr/functions/java.xml <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> <refentry id="function.java-last-exception-clear"> <refnamediv> <refname>java_last_exception_clear</refname> <refpurpose>Efface la dernière exception Java</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>void <function>java_last_exception_clear</function></funcdef> <void/> </funcprototype> </funcsynopsis> </refsect1> </refentry> <refentry id="function.java-last-exception-get"> <refnamediv> <refname>java_last_exception_get</refname> <refpurpose>Lit la dernière exception Java</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>exception <function>java_last_exception_get</function></funcdef> <void/> </funcprototype> </funcsynopsis> <para> L'exemple ci-dessous montre l'utilisation du gestionnaire d'exceptions java : <example> <title>Gestionnaire d'exception Java</title> <programlisting role="php"> <?php $stack = new Java("java.util.Stack"); $stack->push(1); // Cela doit marcher $result = $stack->pop(); $ex = java_last_exception_get(); if (!$ex) print "$result\n"; // Cela doit échouer (le rapport d'erreurs est supprimé par >) $result = @$stack->pop(); $ex = java_last_exception_get(); if ($ex) print $ex->toString(); // Efface la dernière exception java_last_exception_clear(); ?> </programlisting> </example> </para> </refsect1> </refentry> </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 sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: -->