Java Interface

In Quercus, Java methods can be called from within PHP. Java arguments for Java methods need to be marshaled to the correct type from the PHP parameters that were passed in.

Java Argument Type	Allowable PHP Values
String	any
boolean	any
byte	any
short	any
int	any
long	any
float	any
double	any
char	any
Boolean	any
Byte	any
Short	any
Integer	any
Long	any
Float	any
Double	any
Character	any
byte[]	array, string
char[]	array, string
T[] (any other array)	array
Calendar	int
Date	int
URL	string
Collection	array
List	array
Map	array

When the Java argument type is declared to be Object, the value will be marshaled to a Java object. For example, a PHP int (LongValue) will be marshaled to an Integer. The only exceptions are PHP arrays and objects: they are passed in as-is without marshaling.

When the Java argument type is declared to be a Quercus Value, the PHP value is passed in directly without marshaling.

If the Java argument is an object, passing in a PHP NULL will set the Java argument to null.

Java Method Returns

When a Java method is called from PHP code, the return value of that Java method needs to be marshaled into a valid Quercus value.

Java Return Type	resultant PHP Type	Quercus Type
String	string (unicode)	UnicodeValue
boolean	bool	BooleanValue
byte	int	LongValue
short	int	LongValue
int	int	LongValue
long	int	LongValue
float	float	DoubleValue
double	float	DoubleValue
char	string (unicode)	UnicodeValue
Boolean	bool	BooleanValue
Byte	int	LongValue
Short	int	LongValue
Integer	int	LongValue
Long	int	LongValue
Float	float	DoubleValue
Double	float	DoubleValue
Character	string (unicode)	UnicodeValue
null	NULL	NullValue
byte[]	string (binary)	BinaryValue
char[]	string (unicode)	UnicodeValue
T[] (any other array)	array	ArrayValue
Calendar	effectively int (getTimeInMillis())	JavaValue
Date	effectively int (getTime())	JavaValue
URL	effectively string (toString())	JavaValue
Collection	effectively array	JavaValue
List	effectively array	JavaValue
Map	effectively array	JavaValue
other Java Objects	unspecified	JavaValue
Value	n/a	Value

Java objects like Calendar and Map are placed inside JavaValues and then returned to the PHP environment. A JavaValue is just a wrapper that exposes the object's Java methods to PHP. For example, if $url is holding a Java URL object, then we can use $url->getHost() to call the URL's getHost() method.

Some Java objects may have an effective PHP value. Take for instance, Date. A Date object is, for practical purposes, a PHP int with it's value pegged to Date.getTime().

Collection, List, and Map behave just like PHP arrays. Suppose $map holds a Java HashMap, then it's certainly valid to do $map["foo"] = "bar". However, there are some limitations that are dependant on the underlying Java type. For example, $list[-1] = 5 will not be possible for a Java List because List indexes start at 0.

Working with Java Classes in PHP

Getting Static Classes

Java classes can be accessed by PHP by using the java() function.

<?php

  $a = java("java.lang.System");

  echo $a->nanoTime();

?>

Instantiating Objects

To get new instances of Java ojects, use new java() by passing in the class name and any constructor arguments.

<?php

  $a = new java("java.util.Date", 123);

  echo $a->nanoTime();

?>

Note java() and new java() have the same behavior and may be used interchangeably.

Resin Module

Quercus

Troubleshooting FAQ