6. Cocoon 1

A. Usages à TECFA

• Cocoon est "en production" à TECFA depuis 1999

Exemple 6-1: Le plan de cours d'une formation continue à TECFA

• DTD fait maison
• Information dans un seul fichier XML
• Plusieurs vues (résumé de la formation, résumé des séances, modules en détail)
• version XSLT -> HTML
• version XSLT + XSLFO -> PDF

Exemple 6-2: Portefeuilles des étudiants

• Ils doivent indexer leurs travaux dans un fichier XML (DTD imposé)
• Ils peuvent adapter la feuille de XSLT à leur goût
• On a des servlets qui vont extraire de l'information de ces fichiers

B. Instructions de traitement Cocoon

Il faut faire un fichier *.xml (sxml à TECFA) et un fichier *.xsl (style)

Vous devez indiquer à Cocoon (selon l'exemple ci-dessous):

• comment traiter le fichier xml (avec des "processing instructions")
• comment utiliser la feuille de style

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

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

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

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

......

Template:

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

Exemple 6-3: Un simple stylesheet XSLT + FO

<?xml version="1.0"?>

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

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

<?xml version="1.0"?>

<xsl:stylesheet

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

  xmlns:fo="http://www.w3.org/1999/XSL/Format"

  version="1.0" >

<xsl:template match="page">

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

    </xsl:processing-instruction>

 <fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
>

  <fo:layout-master-set>

.......

Exemple 6-4: Good Morning ou good Afternoon

<?xml version="1.0"?>

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

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

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

<xsp:page language="java" 

	  xmlns:xsp="http://www.apache.org/1999/XSP/Core"

	  xmlns:util="http://www.apache.org/1999/XSP/Util"

  <page>

    <title>Good morning or good afternoon</title>	

  <p> It is <util:time
 format=
"HH:mm, dd-MM-yyyy"/> </p>

  <p> .... or <util:time format=""/> if you prefer. </p>

 </page>

</xsp:page>

A. Anatomie d'une simple page XSP

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

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

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

<xsp:page language="java" xmlns:xsp="http://www.apache.org/1999/XSP/Core">

<racine_XML>

 <xsp:logic>

 du code Java (comme les scriptlets <% %> en JSP

 </xsp:logic>

<xsp:expr>

  une simple expression Java  (comme les <%= %> en JSP )

</xsp:expr>

</racine_XML>

</xsp:page>

B. Traitement de formulaires (GET/POST)

Exemple 6-5: Simple calcul

<xsp:page 
language="java" xmlns:xsp="http://www.apache.org/1999/XSP/Core">

<page>

 <xsp:logic>

    String choice = request.getParameter("choice
");

    String choice2 = request.getParameter("choice2
");

    int score = 0;

    if ((choice == null) || (choice2 == null)) {   

       <xsp:content>
Please use the <a href="form.html">form</a> </xsp:content>

      return;

    } else score = Integer.parseInt(choice) + Integer.parseInt(choice2);

 </xsp:logic>

 <title>Form - XSP Demo </title>

 <content>You entered <xsp:expr>
choice</xsp:expr>
 and <xsp:expr>
choice2</xsp:expr>
. That makes <xsp:expr>score</xsp:expr>.</content>

</page>

</xsp:page>

Exemple 6-6: XSP/ESQL simple 1

<?xml version="1.0"?>

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

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

<?xml-stylesheet href="simple-taglib-html.xsl" type="text/xsl"?>

<xsp:page

  language="java"

  xmlns:xsp="http://www.apache.org/1999/XSP/Core"

  xmlns:esql="http://apache.org/cocoon/SQL/v2" >

<page>

 <title>Cocoon XSP ESQL TagLibs demo</title>

 <author> <name>Daniel Schneider</name> </author>

<p> Shows some of Cocoon's SQL/XSP tag library. Also shows how to build a simple table with xsl </p>

  <esql:connection>

   <esql:driver>
org.gjt.mm.mysql.Driver</esql:driver>

   <esql:dburl>
jdbc:mysql://tecfa.unige.ch/demo</esql:dburl>

   <esql:username>
nobody</esql:username>

   <esql:password>
</esql:password>

 <esql:execute-query>

    <esql:query>
SELECT * FROM demo1 order by id;</esql:query>

    <esql:results>

     <ROWSET>

      <esql:row-results>

       <ROW>

       <esql:get-columns/>

		  </ROW>

     </esql:row-results>

     </ROWSET>

    </esql:results>

   </esql:execute-query>

  </esql:connection>

<p> See <a href="./">directory and appended README.html</a> for more information. </p>

</page>

</xsp:page>

• Les balises <ROWSET> et <ROW> sont des balises arbitraires qu'on insère pour "entourer" les résultats d'une balise (sinon on obtient une liste à plat)
• <esql:results> : le "result tree" selon les spécifications
• <esql:row-results> retourne chaque ligne selon les spécifications
• La balise <esql:get-columns> retourne les colonnes d'une ligne entourés des balises portant le nom du label de la colonne

Exemple 6-7: XSP/ESQL simple 2

• Choix selectif de certaines colonnes
• Chaque résultat est inséré dans des balises
• choisis au "hasard", mais qui doivent évidémment respecter le DTD (réel ou virtuel) de la feuille de style

<esql:results>

  <ROWSET>

   <esql:row-results>

    <ROW>

		<id><esql:get-int
 column="id"/></id>

		<login><esql:get-string
 column="login"/></login>

		<fullname><esql:get-string column="fullname"/></fullname>

		<url><esql:get-string column="url"/></url>

		<food><esql:get-string column="food"/></food>

    	</ROW>

   </esql:row-results>

  </ROWSET>

 </esql:results>