• Nuestro primer XSP

Nuestro primer XSP

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:

<?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:

<?xml version="1.0" encoding="UTF-8"?>
<root>
Hello World XSP Page
</root>