4. "Basics" du Cocoon Framework

4.1 Principe de base

Cocoon est un "publishing framework" basé XML et écrit en Java

Philosophie de base = séparation des tâches:

Création de XML: Typiquement ces fichiers sont produits par des auteurs/spécialistes de contenu avec un éditeur XML.
Traitement de XML: Certains vocabulaires ou tags nécessitent un traitement spécial par un "logicsheet". Imaginez un tag <publications name="dill"> qui fait de sorte à ce que toutes les publications de "dill" soient sorties d'une base de données.
Mise en forme (rendering de XML). Le contenu XML final sera mise en forme par une feuille de style. Actuellement surtout du HTML, mais on peut servir des contenus HTML, PDF, XML, WML, XHTML, VRML, etc. en fonction du client)

Résumé: Cocoon/XSP permet de séparer contenu, "logique" et style.

... ceci est quasi-impossible avec Php, Jsp, Asp etc.

Vous faites un fichier *.sxml (contenu) et un fichier *.xsl (style)

Vous devez indiquer à Cocoon comment traiter le fichier xml et comment utiliser la feuille de style dans le fichier xsl selon les règles ci-dessous

Fichier XML (extension = *.sxml):

<?xml version="1.0" encoding="ISO-8859-1"?>

<?xml-stylesheet href="VOTRE_FICHER_XSL.xsl" type="text/xsl"?>

<?cocoon-process type="xslt"?>

Fichier XSL (extension = .xsl):

<?xml version="1.0" encoding="ISO-8859-1"?>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

// doit aller DANS le template pour la racine XML !!!

<xsl:template match="VOTRE_RACINE">

<xsl:processing-instruction name="cocoon-format">type="text/html"
     </xsl:processing-instruction>

......

<?xml version="1.0"?>

<?xml-stylesheet href="hello-page-html.xsl" type="text/xsl"?>

<?cocoon-process type="xslt"?>

 <title>Hello Cocoon friend</title>

 <content> ...... </content>

 <comment>  Written by DKS/Tecfa, adapted from S.M./the Cocoon samples

 </comment>

</page>

hello-page-html.xsl:

<?xml version="1.0"?>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

  <xsl:template match="page">

   <xsl:processing-instruction name="cocoon-format">type="text/html"</xsl:processing-instruction>

   <html> <head> <title> <xsl:value-of select="title"/> </title> </head>

    <body bgcolor="#ffffff">

     <xsl:apply-templates/>

    </body>

   </html>

  </xsl:template>

......

</xsl:stylesheet>

<?xml version="1.0"?>

<?xml-stylesheet href="ldap.xsl" type="text/xsl"?>

<?cocoon-process type="ldap"?>

<?cocoon-process type="xslt"?>

<page>

  <ldap-defs>

    <ldap-server name="tecfa">

      <initializer>com.sun.jndi.ldap.LdapCtxFactory</initializer>

      <ldap-serverurl>ldap://tecfa2.unige.ch:389</ldap-serverurl>

    </ldap-server>

    <ldap-querydefs name="standard" default="yes"/>

  </ldap-defs>

  <ldap-query server="tecfa" ldap-searchbase="o=tecfa.unige.ch" defs="standard">

     givenname=Daniel

  </ldap-query>

</page>

Xinclude est un standard (working draft) W3C pour construire des documents composites ("composite infoset") à partir d'autre documents ou bouts de documents ("infosets")
http://www.w3.org/TR/xinclude/
Xinclude est essentiellement bâti sur le standard XPointer qui repose lui-même sur XPath.
Définition de XPointer : "supports addressing into the internal structures of XML documents. It allows for examination of a hierarchical document structure and choice of its internal parts based on various properties, such as element types, attribute values, character content, and relative position. "

<?xml version="1.0" encoding="ISO-8859-1"?>

<?xml-stylesheet href="style.xsl" type="text/xsl"?>

<?cocoon-process type="xinclude"?>

<?cocoon-process type="xslt"?>

<page xmlns:xinclude="http://www.w3.org/1999/XML/xinclude">

 <include xinclude:parse="xml" xinclude:href="inclure.xml"/>

</page>

<?xml version='1.0' encoding='ISO-8859-1'?>

<?xml-stylesheet href="dtd/evallist.xsl" type="text/xsl"?>

<?cocoon-process type="xinclude"?>

<?cocoon-process type="xslt"?>

<page xmlns:xinclude="http://www.w3.org/1999/XML/xinclude">

<include xinclude:parse="xml" xinclude:href="proj/proj1/info.xml"/>

<specification>

<include xinclude:parse="xml" xinclude:href="proj/proj1/specification.xml#xpointer(//specification/evaluation)"/>

</specification>

<include xinclude:parse="xml" xinclude:href="proj/proj12/info.xml"/>

<specification>

<include xinclude:parse="xml" xinclude:href="proj/proj12/specification.xml#xpointer(//specification/evaluation)"/>

</specification>

</page>