Debido a que la documentaci�n oficial sobre XSP es algo escasa se incluir� en esta secci�n una breve gu�a de aprendizaje para comenzar a programar XSPs.
Una XSP es un documento XML. Por ser un documento XML debe estar bien formado y dem�s. El hecho de que las XSP sean documentos XML proporciona ciertas ventajas, sobre todo en cuanto a sus posibilidades de transformaci�n. (vease apartado referente a XSP taglibs). Tiene adem�s ciertas caracter�sticas propias:
- Como documento XML que es, su primera l�nea debe ser:
<?xml version="1.0"?>
Donde adem�s conviene especificar la codificaci�n de caracteres:
<?xml version="1.0" encoding="UTF-8"?>
- Para que el XSPProcessor de Cocoon sepa que el documento procesado es un XSP es
necesario a�adir al principio una instrucci�n de proceso.
<?cocoon-process type="xsp"?>
- El elemento ra�z del documento debe ser xsp:page. Tiene un atributo en el que se
especifica el lenguaje de programaci�n usado para la l�gica embebida. De momento
Cocoon s�lo soporta Java. Adem�s en el elemento ra�z se declaran los espacios de
nombres usados y como m�nimo hay que declarar el espacio de nombres xsp. Con todo
esto, el elemento ra�z t�pico de una XSP tiene este aspecto:
<xsp:page language="java" xmlns:xsp="http://www.apache.org/1999/XSP/Core" >
- El primer elemento que aparezca dentro de xsp:page y no est� en el espacio de nombres ser� el elemento ra�z del documento generado.
Y con estas primeras nociones se podr�a construir una XSP, absolutamente trivial, pero v�lida:
Nuestro primer XSP
<?xml version="1.0" encoding="UTF-8"?> <?cocoon-process type="xsp"?> <xsp:page language="java" xmlns:xsp="http://www.apache.org/1999/XSP/Core"> <root> Hello World XSP Page </root> </xsp:page>
Esta p�gina, tras ser compilada a una clase producir�a siempre el mismo XML resultante:
Resultado de nuestro primer XSP
<?xml version="1.0" encoding="UTF-8"?> <root> Hello World XSP Page </root>