cvs: phpdoc /en/functions java.xml

sbergmann Sun Jul 8 08:06:17 2001 EDT Modified files: /phpdoc/en/functions java.xml Log: Some tweaking. Index: phpdoc/en/functions/java.xml diff -u phpdoc/en/functions/java.xml:1.7 phpdoc/en/functions/java.xml:1.8 --- phpdoc/en/functions/java.xml:1.7 Sat Jul 7 17:27:11 2001 +++ phpdoc/en/functions/java.xml Sun Jul 8 08:06:16 2001 @@ -4,36 +4,36 @@ <partintro> <para> There are two possible ways to bridge PHP and Java: you can either - integrate Java into PHP, which is the more stable and efficient - solution, or integrate PHP into a Java Servlet environment. - The former is provided by ext/java, the latter by a SAPI module that - interfaces with the Servlet server. + integrate PHP into a Java Servlet environment, which is the more + stable and efficient solution, or integrate Java support into PHP. + The former is provided by a SAPI module that interfaces with the + Servlet server, the latter by the Java extension. </para> <para> PHP 4 ext/java provides a simple and effective means for creating and invoking methods on Java objects from PHP. The JVM is created using JNI, and everything runs in-process. Build instructions for ext/java can be - found in php4/ext/java/README. + found in <filename>php4/ext/java/README</filename>. <example> <title>Java Example</title> <programlisting role="php"> &lt;?php // get instance of Java class java.lang.System in PHP - $system = new Java("java.lang.System"); + $system = new Java('java.lang.System'); // demonstrate property access - print "Java version=".$system-&gt;getProperty("java.version")." &lt;br&gt;"; - print "Java vendor=" .$system-&gt;getProperty("java.vendor")." &lt;br&gt;"; - print "OS=".$system-&gt;getProperty("os.name")." ". - $system-&gt;getProperty("os.version")." on ". - $system-&gt;getProperty("os.arch")." &lt;br&gt;"; + print 'Java version='.$system-&gt;getProperty('java.version').' &lt;br&gt;'; + print 'Java vendor=' .$system-&gt;getProperty('java.vendor').' &lt;br&gt;'; + print 'OS='.$system-&gt;getProperty('os.name').' '. + $system-&gt;getProperty('os.version').' on '. + $system-&gt;getProperty('os.arch').' &lt;br&gt;'; // java.util.Date example - $formatter = new Java("java.text.SimpleDateFormat", + $formatter = new Java('java.text.SimpleDateFormat', "EEEE, MMMM dd, yyyy 'at' h:mm:ss a zzzz"); - print $formatter-&gt;format(new Java("java.util.Date")); + print $formatter-&gt;format(new Java('java.util.Date')); ?&gt; </programlisting> </example> @@ -43,15 +43,15 @@ &lt;?php // This example is only intented to be run as a CGI. - $frame = new Java("java.awt.Frame", "Zend"); - $button = new Java("java.awt.Button", "Hello Java world!"); + $frame = new Java('java.awt.Frame', 'PHP'); + $button = new Java('java.awt.Button', 'Hello Java World!'); - $frame-&gt;add("North", $button); + $frame-&gt;add('North', $button); $frame-&gt;validate(); $frame-&gt;pack(); $frame-&gt;visible = True; - $thread = new Java("java.lang.Thread"); + $thread = new Java('java.lang.Thread'); $thread-&gt;sleep(10000); $frame-&gt;dispose(); @@ -64,25 +64,27 @@ <itemizedlist> <listitem> <simpara> - new Java() will create an instance of a class if a suitable constructor - is available. If no parameters are passed and the default constructor - is useful as it provides access to classes like "java.lang.System" - which expose most of their functionallity through static methods. + <literal>new Java()</literal> will create an instance of a class if + a suitable constructor is available. If no parameters are passed and + the default constructor is useful as it provides access to classes + like <literal>java.lang.System</literal> which expose most of their + functionallity through static methods. </simpara> </listitem> <listitem> <simpara> Accessing a member of an instance will first look for bean properties - then public fields. In other words, "print $date.time" will first - attempt to be resolved as "$date.getTime()", then as "$date.time"; + then public fields. In other words, <literal>print $date.time</literal> + will first attempt to be resolved as <literal>$date.getTime()</literal>, + then as <literal>$date.time</literal>. </simpara> </listitem> <listitem> <simpara> Both static and instance members can be accessed on an object with the same syntax. Furthermore, if the java object is of type - "java.lang.Class", then static members of the class (fields and - methods) can be accessed. + <literal>java.lang.Class</literal>, then static members of the class + (fields and methods) can be accessed. </simpara> </listitem> <listitem> @@ -125,11 +127,12 @@ </itemizedlist> </para> <para> - PHP4 sapi/servlet builds upon the mechanism defined by ext/java to enable + sapi/servlet builds upon the mechanism defined by ext/java to enable the entire PHP processor to be run as a servlet. The primary advanatage of this from a PHP perspective is that web servers which support servlets typically take great care in pooling and reusing JVMs. Build instructions - for the Servlet SAPI module can be found in php4/sapi/README. + for the Servlet SAPI module can be found in + <filename>php4/sapi/README</filename>. Notes: @@ -192,7 +195,7 @@ <title>Java exception handler</title> <programlisting role="php"> <?php - $stack = new Java("java.util.Stack"); + $stack = new Java('java.util.Stack'); $stack-&gt;push(1); // This should succeed