Quercus:Resin module

From Resin 3.0

Revision as of 03:08, 4 April 2006 by Sam (Talk | contribs)
Jump to: navigation, search

jndi_lookup

Returns an object located using a jndi name, or null if no object matches the name.

 $hogwarts = jndi_lookup("java:comp/env/persistence/PersistenceContext/hogwarts");

If the name begins with "java:comp/env/", then the "java:comp/env/" does not need to be included in the name.

 $hogwarts = jndi_lookup("persistence/PersistenceContext/hogwarts")

mbean_lookup

Returns an mbean object located using a jmx name, or null if no object matches the name.

 $hogwartsApp = mbean_lookup("resin:type=WebApp,Server=default,Host=default,name=/hogwarts");

If the name does not contain a `:', then it is a partial name and the lookup is done as if the name contained the fully qualified name of the current web application. For example, the following are equivalent if performed from the web-app /hogwarts:

 $foo = mbean_lookup("resin:Server=default,Host=default,WebApp=/hogwarts,type=MyMBean,name=foo");
 $foo = mbean_lookup("type=MyMBean,name=foo");

If the name is not provided, then the object that is returned is the mbean for the web application.

 $app = mbean_lookup();

mbean_query

Returns an array of object names that match a JMX query.

<?php
   $webappNames = mbean_query("resin:type=WebApp,*"); 

   foreach ($webappNames as $webappName) {
     echo $webappName . "\n";

     $webapp = mbean_lookup($webappName);

     ...
  }
?>
 resin:type=WebApp,Server=default,Host=default,name=/
 resin:type=WebApp,Server=default,Host=default,name=/gryffindor
 ...

The string names have special behaviour, the elements of the JMX name can be accessed using the field getting syntax of php.

<?php
   $webappNames = mbean_query("resin:type=WebApp,*"); 

   foreach ($webappNames as $webappName) {
     echo "Host is".  $webappName->Host . " name is " . $webappName->name . "\n";
  }
?>
 Host is default name is /
 Host is default name is /gryffindor
 ...
Personal tools