Splatch’s devblog

Integracja między językami czy też platformami to kwestia poruszana nie od dzisiaj. Na poziomie platform funkcjonuje od dłuższego czasu CORBA i Web Services z trio SOAP + WSDL + XML Schema na czele. Integracja systemów napisanych w tym samym języku sprowadza się zwykle do wykorzystania serializacji, która jest najszybsza i najwygodniejsza. Gorzej jeśli idzie o połączenie dwóch języków – w moim przypadku PHP i Javy.
Zend ma swój mostek, który umożliwia na zintegrowanie Javy i PHP, jest też dodatkowe rozszerzenie do PHP, które pozwala na wykorzystanie Javy w PHP, jednakże moje oczekiwania nie był aż tak wielkie. Potrzebowałem po prostu odczytać dane specyficzne dla PHP – powiedzmy informacje o jakiejś klasie. Standardowo taka operacja wymagała stworzenia parsera, co jest zadaniem powiedzmy, nie na moje siły i umiejętności.. stąd też postanowiłem sobie nieco uprościć pracę. :)

Wspólny, najwygodniejszy format (zarówno w odczycie i zapisie danych) z jednej i drugiej strony to oczywiście XML. Problem w tym, jaki format ma być wykorzystany. Nie da się przecież bezpośrednio odwzorować obiektu z PHP do Javy głównie z racji na dynamikę. Jeśli w PHP ktoś dorzuci pole do obiektu, poprzez proste $someUser->city = ‘Białystok’ to Java bazująca tylko na statycznych, zadeklarowanych polach w klasie nie odczyta tej informacji. Serializacja w postaci specyficznej dla PHP również wiąże się ze stworzeniem parsera po stronie Javy by to wszystko obsługiwać i dodatkowo coś co by później mapowało obiekty z Javy do XMLa w postaci przyjaznej dla PHP. Wyjściem z całej sytuacji okazały się funkcje wddx_*. Po prostu strzał w dziesiątkę. WDDX to standard może nie najnowszy, ale dosyć spójny, i co najważniejsze umożliwiający przesyłanie złożonych obiektów bez zbytniej walki. Po chwili poszukiwań znalazłem DTD, zatem ze strony Javy wystarczy odpalić JAXB i jesteśmy na miejscu.

Przykładowy skrypt PHP, który uzyskuje informacje o konfiguracji Agavi:

< ?php
include_once 'E:/htdocs/shop/agavi/agavi.php';
$value = wddx_serialize_value(AgaviConfig::export());

$value = "<?xml version='1.0' encoding='utf-8' ?>\n< !DOCTYPE wddxPacket SYSTEM 'wddx.dtd'>\n" . $value;

echo $value;

A teraz część wyniku, który PHP wyświetla w konsoli:

< ?xml version="1.0" encoding="utf-8" ?>
< !DOCTYPE wddxPacket SYSTEM 'wddx.dtd'>
<wddxpacket version='1.0'>
	<header />
	<data>
		<struct>
			<var name='core.minimum_php_version'>
				<string>5.1.0</string>
			</var>
			<var name='core.agavi_dir'>
				<string>E:\htdocs\shop\agavi</string>
			</var>
			<!-- i tak dalej -->
		</struct>
	</data>
</wddxpacket>

Teraz kod Javy, który odczytuje sobie informacje.. (nawiasy kwadratowe przy listach podyktowane błędami w skrypcie, który koloruje składnię)

		// odpalamy interpreter PHP
		Runtime runtime = Runtime.getRuntime();
		Process exec = runtime.exec("php -q E:/agavi-ide/org.codehouse.bridge/src/org/codehouse/bridge/test2.php");

		// podnosimy kontekst JAXB
		JAXBContext context = JAXBContext.newInstance(ObjectFactory.class);
		// deserializujemy XML wygenerowany przez PHP
		WddxPacket object = (WddxPacket) context.createUnmarshaller().unmarshal(exec.getInputStream());

		// odczytujemy informacje
		for (Object stc : object.getData().getWDDXData()) {
			// spodziewamy się informacji o typie złożonym
			if (stc instanceof Struct) {
				List[generated.Var] vara = ((Struct) stc).getVar();
				for (Var value : vara) {
					// pozostaje nam tylko odczytanie zserializowanej wartości
					List[Object] configurationValue = value.getWDDXData();
					System.out.println(value.getName() + ": " + ((generated.String) configurationValue.get(0)).getvalue());
				}
			}
		}

Wynik działania poniższego kodu to:

core.minimum_php_version: 5.1.0
core.agavi_dir: E:\htdocs\shop\agavi
exception.default_template: E:\htdocs\shop\agavi/exception/templates/shiny.php
agavi.name: Agavi
agavi.major_version: 0
agavi.minor_version: 11
agavi.micro_version: 0
agavi.status: DEV
agavi.branch: trunk
agavi.version: 0.11.0-DEV
agavi.release: Agavi 0.11.0-DEV
agavi.url: http://www.agavi.org
agavi_info: Agavi 0.11.0-DEV (http://www.agavi.org)

Czyli wszystko czego trzeba było nam do szczęścia! :)

Pora na przykład bardziej złożony, wyciągnięcie informacji o jakiejś klasie widoku użytej w aplikacji opartej o Agavi.

< ?php

include_once 'E:/htdocs/shop/agavi/agavi.php';

AgaviConfig::set('core.app_dir', 'E:/htdocs/shop/project/');
AgaviConfig::set('core.system_config_dir', 'E:/htdocs/shop/agavi/config/defaults/');

// metoda dopisana przeze mnie, konfiguruje Agavi bez wyrzucania wyjątków.
Agavi::bootstrap2('');

include_once 'E:/htdocs/shop/project/modules/Cart/lib/BaseInputView.class.php';

$obj = new ReflectionClass('Cart_BaseInputView');
$orig = $obj->getFileName();

$myMethods = $obj->getMethods();

$methods = array();

foreach ($myMethods as $method) {
	// sprawdzenie czy plik w którym jest zadeklarowana metoda
	// pokrywa się z plikiem w którym jest zadeklarowana klasa
	// w ten sposób pozbywam się niepotrzebnych metod z klas nadrzędnych
	if ($method->getFileName() == $orig) {
		$methods[] = $method;
	}
}


$value = wddx_serialize_value($methods);
$value = "< ?xml version='1.0' encoding='utf-8' ?>< !DOCTYPE wddxPacket SYSTEM 'wddx.dtd'>\n" . $value;
echo $value;

?>

Drobna przeróbka kodu Javy, który był użyty wcześniej i wynikiem jest

php_class_name: ReflectionMethod
name: execute
class: Cart_BaseInputView

Tym, którzy dobrnęli do końca tej noty dziękuję za wytrwałość. :) Kolejna nota będzie być może o tym jak wywoływać metody statyczne klas Javy z poziomu XSLT (wierzcie mi, da się!).