Overview

Packages

  • None
  • pdb

Classes

  • Java
  • java_AbstractJava
  • java_ApplyArg
  • java_Arg
  • java_ArrayProxy
  • java_ArrayProxyFactory
  • java_CacheEntry
  • java_ChunkedSocketChannel
  • java_class
  • java_Client
  • java_CompositeArg
  • java_EmptyChannel
  • java_ExceptionProxy
  • java_ExceptionProxyFactory
  • java_GlobalRef
  • java_HttpTunnelHandler
  • java_InternalJava
  • java_IteratorProxy
  • java_IteratorProxyFactory
  • java_JavaProxy
  • java_JavaProxyProxy
  • java_NativeParser
  • java_objectIterator
  • java_Parser
  • java_ParserString
  • java_ParserTag
  • java_Protocol
  • java_ProxyFactory
  • java_SimpleFactory
  • java_SimpleHttpHandler
  • java_SimpleHttpTunnelHandler
  • java_SimpleParser
  • java_SocketChannel
  • java_SocketChannelP
  • java_SocketHandler
  • java_ThrowExceptionProxyFactory
  • JavaClass
  • pdb_AddBreakpointRequest
  • pdb_AddBreakpointResponse
  • pdb_AddFilesRequest
  • pdb_AddFilesResponse
  • pdb_Breakpoint
  • pdb_ContinueProcessFileNotification
  • pdb_DebugScriptEndedNotification
  • pdb_DebugSessionStart
  • pdb_End
  • pdb_Environment
  • pdb_ErrorNotification
  • pdb_FileContentExtendedRequest
  • pdb_FileContentExtendedResponse
  • pdb_GetCallStackRequest
  • pdb_GetCallStackResponse
  • pdb_GetCWDRequest
  • pdb_GetCWDResponse
  • pdb_GetVariableValueRequest
  • pdb_GetVariableValueResponse
  • pdb_GoRequest
  • pdb_GoResponse
  • pdb_HeaderOutputNotification
  • pdb_In
  • pdb_Logger
  • pdb_Message
  • pdb_MessageRequest
  • pdb_MsgEvalRequest
  • pdb_MsgEvalResponse
  • pdb_Out
  • pdb_OutputNotification
  • pdb_Parser
  • pdb_ReadyNotification
  • pdb_RemoveAllBreakpointsRequest
  • pdb_RemoveAllBreakpointsResponse
  • pdb_RemoveBreakpointRequest
  • pdb_RemoveBreakpointResponse
  • pdb_Serializer
  • pdb_SetProtocolRequest
  • pdb_SetProtocolResponse
  • pdb_StartProcessFileNotification
  • pdb_StartRequest
  • pdb_StartResponse
  • pdb_StepIntoRequest
  • pdb_StepIntoResponse
  • pdb_StepOutRequest
  • pdb_StepOutResponse
  • pdb_StepOverRequest
  • pdb_StepOverResponse

Interfaces

  • java_JavaType

Exceptions

  • java_ConnectException
  • java_exception
  • java_IllegalArgumentException
  • java_IllegalStateException
  • java_InternalException
  • java_IOException
  • java_JavaException
  • java_RuntimeException
  • JavaException

Functions

  • __javaproxy_Client_getClient
  • Java
  • java_autoload
  • java_autoload_function
  • java_autoload_function5
  • java_begin_document
  • java_call_with_continuation
  • java_cast
  • java_cast_internal
  • java_checkCliSapi
  • java_closure
  • java_closure_array
  • java_context
  • java_defineHostFromInitialQuery
  • java_end_document
  • java_eval
  • java_get_base
  • java_get_closure
  • java_get_context
  • java_get_lifetime
  • java_get_server_name
  • java_get_session
  • java_get_values
  • java_getCompatibilityOption
  • java_getHeader
  • java_inspect
  • java_inspect_internal
  • java_instanceof
  • java_instanceof_internal
  • java_invoke
  • java_is_false
  • java_is_null
  • java_is_true
  • java_isfalse
  • java_isnull
  • java_istrue
  • java_last_exception_clear
  • java_last_exception_get
  • java_require
  • java_reset
  • java_server_name
  • java_session
  • java_session_array
  • java_set_encoding
  • java_set_file_encoding
  • java_shutdown
  • java_truncate
  • java_unwrap
  • java_values
  • java_values_internal
  • java_virtual
  • java_wrap
  • pdb_endInclude
  • pdb_error_handler
  • pdb_getDebugHeader
  • pdb_getDefinedVars
  • pdb_shutdown
  • pdb_startCall
  • pdb_startInclude
  • pdb_step
  • Overview
  • Package
  • Class
  • Todo
  • Deprecated
  1:   2:   3:   4:   5:   6:   7:   8:   9:  10:  11:  12:  13:  14:  15:  16:  17:  18:  19:  20:  21:  22:  23:  24:  25:  26:  27:  28:  29:  30:  31:  32:  33:  34:  35:  36:  37:  38:  39:  40:  41:  42:  43:  44:  45:  46:  47:  48:  49:  50:  51:  52:  53:  54:  55:  56:  57:  58:  59:  60:  61:  62:  63:  64:  65:  66:  67:  68:  69:  70:  71:  72:  73:  74:  75:  76:  77:  78:  79:  80:  81:  82:  83:  84:  85:  86:  87:  88:  89:  90:  91:  92:  93:  94:  95:  96:  97:  98:  99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133: 134: 135: 136: 137: 138: 139: 140: 141: 142: 143: 144: 145: 146: 147: 148: 149: 150: 151: 152: 153: 154: 155: 156: 157: 158: 159: 160: 161: 162: 163: 164: 165: 166: 167: 168: 169: 170: 171: 172: 173: 174: 175: 176: 177: 178: 179: 180: 181: 182: 183: 184: 185: 186: 187: 188: 189: 190: 191: 192: 193: 194: 195: 196: 197: 198: 199: 200: 201: 202: 203: 204: 205: 206: 207: 208: 209: 210: 211: 212: 213: 214: 215: 216: 217: 218: 219: 220: 221: 222: 223: 224: 225: 226: 227: 228: 229: 230: 231: 232: 233: 234: 235: 236: 237: 238: 239: 240: 241: 242: 243: 244: 245: 246: 247: 248: 249: 250: 251: 252: 253: 254: 255: 256: 257: 258: 259: 260: 261: 262: 263: 264: 265: 266: 267: 268: 269: 270: 271: 272: 273: 274: 275: 276: 277: 278: 279: 280: 281: 282: 283: 284: 285: 286: 287: 288: 289: 290: 291: 292: 293: 294: 295: 296: 297: 298: 299: 300: 301: 302: 303: 304: 305: 306: 307: 308: 309: 310: 311: 312: 313: 314: 315: 316: 317: 318: 319: 320: 321: 322: 323: 324: 325: 326: 327: 328: 329: 330: 331: 332: 333: 334: 335: 336: 337: 338: 339: 340: 341: 342: 343: 344: 345: 346: 347: 348: 349: 350: 351: 352: 353: 354: 355: 356: 357: 358: 359: 360: 361: 362: 363: 364: 365: 366: 367: 368: 369: 370: 371: 372: 373: 374: 375: 376: 377: 378: 379: 380: 381: 382: 383: 384: 385: 386: 387: 388: 389: 390: 391: 392: 393: 394: 395: 396: 397: 398: 399: 400: 401: 402: 403: 404: 405: 406: 407: 408: 409: 410: 411: 412: 413: 414: 415: 416: 417: 418: 419: 420: 421: 422: 423: 424: 425: 426: 427: 428: 429: 430: 431: 432: 433: 434: 435: 436: 437: 438: 439: 440: 441: 442: 443: 444: 445: 446: 447: 448: 449: 450: 451: 452: 
<?php /*-*- mode: php; tab-width:4 -*-*/

  /** java_JavaBridge.php -- provides the PHP/Java Bridge PHP API.
   * 
   * Copyright (C) 2003-2007 Jost Boekemeier
   * 
   * This file is part of the PHP/Java Bridge.
   * 
   * The PHP/Java Bridge ("the library") is free software; you can
   * redistribute it and/or modify it under the terms of the GNU General
   * Public License as published by the Free Software Foundation; either
   * version 2, or (at your option) any later version.
   * 
   * The library is distributed in the hope that it will be useful, but
   * WITHOUT ANY WARRANTY; without even the implied warranty of
   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   * General Public License for more details.
   * 
   * You should have received a copy of the GNU General Public License
   * along with the PHP/Java Bridge; see the file COPYING.  If not, write to the
   * Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
   * 02111-1307 USA.
   * 
   * Linking this file statically or dynamically with other modules is
   * making a combined work based on this library.  Thus, the terms and
   * conditions of the GNU General Public License cover the whole
   * combination.
   * 
   * As a special exception, the copyright holders of this library give you
   * permission to link this library with independent modules to produce an
   * executable, regardless of the license terms of these independent
   * modules, and to copy and distribute the resulting executable under
   * terms of your choice, provided that you also meet, for each linked
   * independent module, the terms and conditions of the license of that
   * module.  An independent module is a module which is not derived from
   * or based on this library.  If you modify this library, you may extend
   * this exception to your version of the library, but you are not
   * obligated to do so.  If you do not wish to do so, delete this
   * exception statement from your version. 
   *
   * @author     Jost Boekemeier
   * @license    GPL
   * @link       http://php-java-bridge.sf.net
   */

if(!function_exists("java_get_base")) {

  1.0E512; // Workaround pfsockopen bug; initialize the socket subsystem

  /**
   * @access private
   */
  function java_get_base() {
    $ar = get_required_files();
    $arLen = sizeof($ar);
    if($arLen>0) {
      $thiz = $ar[$arLen-1];
      return dirname($thiz);
    } else {
      return "java";
    }
  }
  /**
   * @access private
   */
  function java_truncate($str) {
    if (strlen($str)>955)
      return substr($str, 0, 475).'[...]'.substr($str,-475);
    return $str;
  }
  require_once(java_get_base()."/Options.inc");
  require_once(java_get_base()."/JavaProxy.inc");

  /**
   * @access private
   */
  class java_JavaException  extends Exception {
    function __toString() {return $this->getMessage();}
  };
  /**
   * @access private
   */
  class java_RuntimeException extends java_JavaException {};
  /**
   * @access private
   */
  class java_IOException extends java_JavaException {};
  /**
   * @access private
   */
  class java_ConnectException extends java_IOException {};
  /**
   * @access private
   */
  class java_IllegalStateException extends java_RuntimeException {};
  /**
   * @access private
   */
  class java_IllegalArgumentException extends java_RuntimeException {
    function __construct($ob) {
      parent::__construct("illegal argument: ".gettype($ob));
    }
  };

  /**
   * @access private
   */
  function java_eval($code) {
    $newCode = '';
    foreach (token_get_all($code) as $item)
    {
        if (is_array($item))
        {
            switch ($item[0])
            {
                case T_EXIT :
                    $item[1] = 'return';
                    break;
            }
            $item = $item[1];
        }
        $newCode.= $item;
    }
    $c=__javaproxy_Client_getClient();
    $exitCode=eval((substr($newCode,0,2)=='<'.'?'?'?'.'>':'').$newCode);
    $c->setExitCode($exitCode);
    return $exitCode;
  }

  /**
   * @access private
   */
  function java_autoload_function5($x) {
    $s=str_replace("_", ".", $x);

    $c=__javaproxy_Client_getClient();
    if(!($c->invokeMethod(0, "typeExists", array($s)))) return false;

    $i = "class ${x} extends Java {".
      "static function type(\$sub=null){if(\$sub) \$sub='\$'.\$sub; return java('${s}'.\"\$sub\");}".
      'function __construct() {$args = func_get_args();'.
      'array_unshift($args, '."'$s'".'); parent::__construct($args);}}';
    eval ("$i");
    return true;
  }
  /**
   * @access private
   */
  function java_autoload_function($x) {
    $idx = strrpos($x, "\\"); if (!$idx) return java_autoload_function5($x);

    $str=str_replace("\\", ".", $x);

    $client=__javaproxy_Client_getClient();
    if(!($client->invokeMethod(0, "typeExists", array($str)))) return false;

    $package = substr($x,0, $idx);
    $name = substr($x, 1+$idx);
    $instance = "namespace $package; class ${name} extends \\Java {".
      "static function type(\$sub=null){if(\$sub) \$sub='\$'.\$sub;return \\java('${str}'.\"\$sub\");}".
      "static function __callStatic(\$procedure, \$args) {return \\java_invoke(\\java('${str}'), \$procedure, \$args);}".
      'function __construct() {$args = func_get_args();'.
      'array_unshift($args, '."'$str'".'); parent::__construct($args);}}';
    eval ("$instance");
    return true;
  }
  /** Autoload Java classes if not disabled via define("JAVA_DISABLE_AUTOLOAD", true); */
  if(!defined("JAVA_DISABLE_AUTOLOAD") && function_exists("spl_autoload_register")) spl_autoload_register("java_autoload_function");

  /**
   * @access private
   */
  function java_autoload($libs=null) {
    trigger_error('Please use <a href="http://php-java-bridge.sourceforge.net/pjb/webapp.php>tomcat or jee hot deployment</a> instead', E_USER_WARNING);
  }

  /**
   * Include the output of some Java resource.

   * java_virtual() uses the PHP/Java Bridge protocol to render .jsp,
   * .jsf or other Java resources through PHP scripts running within
   * Apache, IIS or as a JEE sub component.
   *
   * Example: 
   * <code>
   * <?php require_once("java/Java.inc");
   * java_session();
   * echo java_virtual("/test.jsp", true);
   * ?>
   * </code>
   *
   * @access public
   * @param string The local resource
   * @param bool return the response
   * @return mixed The response or true
   * @see http://php.net/manual/en/function.virtual.php
   * @see java_session();
   */
  function java_virtual($path, $return=false) {

    $req = java_context()->getHttpServletRequest();
    $req = new java("php.java.servlet.VoidInputHttpServletRequest", $req);

    $res = java_context()->getHttpServletResponse();
    $res = new java("php.java.servlet.RemoteHttpServletResponse", $res);

    $req->getRequestDispatcher($path)->include($req, $res);
    if ($return) return $res->getBufferContents();

    echo $res->getBufferContents();
    return true;
  }
  /**
   * Access the java type with the given name. 
   *
   * This procedure can be
   * used to access constants or procedures within a class.  <br>
   *
   * To access class features, use the java constructor instead.<br>
   *
   * Example: <code> java("java.lang.Long")->MAX_VALUE </code>
   *
   *<br> Any declared exception can be caught by PHP code. <br>
   * Exceptions derived from java.lang.RuntimeException or Error must
   * not be caught unless declared in the methods throws clause -- OutOfMemoryErrors cannot be caught at all,
   * even if declared.
   *
   * @access public
   * @param string The type name
   * @see Java
   */
  function Java($name) { 
    static $classMap = array();
    if(array_key_exists($name, $classMap)) return $classMap[$name];
    return $classMap[$name]=new JavaClass($name);
  }

  /**
   * Alias for java_closure();
   * @access private
   * @see java_closure();
   */
  function java_get_closure() {return java_closure_array(func_get_args());}

  /**
   * Alias for java_closure();
   * @access private
   * @see java_closure();
   */
  function java_wrap() {return java_closure_array(func_get_args());}
  
  /**
   * Alias for java_values();
   * @access private
   * @see java_values();
   */
  function java_get_values($arg) { return java_values($arg); }

  /**
   * Alias for java_session();
   * @access private
   * @see java_session();
   */
  function java_get_session() {return java_session_array(func_get_args());}

  /**
   * Alias for java_context();
   * @access private
   * @see java_context();
   */
  function java_get_context() {return java_context(); }

  /**
   * Alias for java_server_name();
   * @access private
   * @see java_server_name();
   */
  function java_get_server_name() { return java_server_name(); }

  /**
   * Alias for java_is_null();
   * @access private
   * @see java_is_null();
   */
  function java_isnull($value) { return is_null (java_values ($value)); }

  /**
   * Checks whether a value is null or not.
   *
   * Example: <code> java_is_null(java("java.lang.System")->getProperty("foo")) </code>
   *
   * @access public
   * @param mixed A Java object or a PHP value
   * @return true if $value is the PHP or Java null value.
   */
  function java_is_null($value) { return is_null (java_values ($value)); }

  /**
   * Alias for java_is_true();
   * @access private
   * @see java_is_true();
   */
  function java_istrue($value) { return  (boolean)(java_values ($value)); }

  /**
   * Checks whether a value is not NULL, 0, "" or false. 

   * Note that if
   * you want to check if a value is boolean true, use the following
   * test: <code>java_values($value)===true</code>
   * 
   * Example:
   * <code>
   * java_is_true(new java.lang.String("12")) => true
   * </code>
   *
   * Example:
   * <code>
   * java_is_true(new java.lang.String("")) => false
   * </code>
   *
   * Example:
   * <code>
   * java_is_true(1==1) => true
   * </code>
   *
   * Example: <code> java_is_true(java("java.lang.System")->getProperty("foo")) </code>
   *
   * @access public
   * @param mixed A Java object or a PHP value
   * @return true if the PHP or Java value is true.
   */
  function java_is_true($value) { return (boolean)(java_values ($value)); }

  /**
   * Alias for java_is_false();
   * @access private
   * @see java_is_false();
   */
  function java_isfalse($value) { return !(java_values ($value)); }

  /**
   * Checks whether a value is NULL, 0, "" or false. 
   *
   * Note that if you want to check if a value is boolean false, use
   * the following test: <code>java_values($value)===false</code>
   * 
   * Example:
   * <code>
   * java_is_false(new java.lang.String("12")) => false
   * </code>
   *
   * Example:
   * <code>
   * java_is_false(new java.lang.String("")) => true
   * </code>
   *
   * Example:
   * <code>
   * java_is_false(1==1) => false
   * </code>
   *
   * Example: <code> java_is_false(java("java.lang.System")->getProperty("foo")) </code>
   *
   * @access public
   * @param mixed A Java object or a PHP value
   * @return true if the PHP or Java value is false.
   */
  function java_is_false($value) { return !(java_values ($value)); }

  /**
   * Alias for java_set_file_encoding();
   * @access private
   * @see java_set_file_encoding();
   */
  function java_set_encoding($enc) { return java_set_file_encoding ($enc); }

  /**
   * Call the current Java continuation with the closed-over PHP environment
   * $kontinuation as its argument.
   *
   * This procedure can be used to transfer control back to a Java
   * continuation so that Java can call PHP procedures defined within
   * the passed environment. If no current Java continuation exists,
   * the procedure does nothing.
   *
   *
   * Example PHP script:
   * <code>
   * <?php require_once("java/Java.inc");
   *
   * // ... calculate sales for a given month ...
   * function calculateSales($month) {return ((int)(string)$month)+1;}
   *
   * write_response($response);
   *
   * // prepare for out-of-band data: make our top-level environment
   * // available to Java. But only if it has been requested by Java:
   * java_call_with_continuation();
   * ?>
   * </code>
   *
   * If the above PHP script is named
   * "calculateSales.php", the JSR 223 API can be used to invoke its
   * functions or methods, to debug or test certain
   * functionality from Java while keeping the script running in a
   * production environment. The Java code follows:
   * <code>
   * import javax.script.*;
   * import java.net.*;
   * import java.io.*;
   * class SalesTest {
   *     public static void test(Integer month) throws Exception {
   *         ScriptEngine e = new ScriptEngineManager().getEngineByName("php-invocable");
   *         ByteArrayOutputStream out;
   *         OutputStreamWriter writer;
   *         e.getContext().setWriter(writer=new OutputStreamWriter(out=new ByteArrayOutputStream()));
   *         Object res=e.eval(new php.java.script.URLReader(new URL("http://localhost/calculateSales.php")));
   *         System.err.println(((Invocable)e).invokeFunction("calculateSales", new Object[]{month}));
   *         ((Closeable)e).close();
   *         System.err.println("PHP exit() code:" + String.valueOf(res));
   *         System.err.println("PHP output:" + String.valueOf(out));
   *      }
   *      public static void main(String s[]) throws Exception {
   *         test(new Integer(12));
   *      }
   * }
   * </code>
   *
   * The above Java program opens a URL connection to the PHP script,
   * invokes the calculateSales() function from the passed PHP 
   * environment and then outputs the exit code and the HTML response
   * of the PHP script.
   *
   * @access public
   * @param mixed May either be null, a PHP function name, a PHP object or a java_closure. If a PHP object is provided, the object is passed to Java. If a function name is provided, the function must return a java_closure. Otherwise the current environment is used.
   */
  function java_call_with_continuation($kontinuation=null) {
    if (java_getHeader("X_JAVABRIDGE_INCLUDE", $_SERVER) && !java_getHeader("X_JAVABRIDGE_INCLUDE_ONLY", $_SERVER)) {
      if (is_null($kontinuation))
        java_context()->call(java_closure());
      elseif (is_string($kontinuation)) 
        java_context()->call(call_user_func($kontinuation));
      elseif ($kontinuation instanceof java_JavaType) 
        java_context()->call($kontinuation);
      else
        java_context()->call(java_closure($kontinuation));
    }
  }
 } //!java_defined  DO NOT REMOVE THIS LINE
?>
VM Bridge API documentation generated by ApiGen