#12 Lepší ošetření chyb – vypíšeme varování a na výstup vložíme původní text bez zvýraznění syntaxe.
authorFrantišek Kučera <franta-hg@frantovo.cz>
Mon Aug 22 01:10:55 2011 +0200 (2011-08-22)
changeset 283298cafa8686
parent 27 037a9f20bf3a
child 29 7bd7aaa9874a
#12 Lepší ošetření chyb – vypíšeme varování a na výstup vložíme původní text bez zvýraznění syntaxe.
vstup/produkty.xml
šablona/funkce/src/cz/frantovo/xmlWebGenerator/Funkce.java
šablona/stránka.xsl
     1.1 --- a/vstup/produkty.xml	Mon Aug 22 00:23:38 2011 +0200
     1.2 +++ b/vstup/produkty.xml	Mon Aug 22 01:10:55 2011 +0200
     1.3 @@ -20,19 +20,22 @@
     1.4  		<p>Vivamus nec dictum dolor. Aliquam et tellus dolor. Curabitur et est sapien. Sed nec neque massa. Integer luctus erat vel arcu molestie ac dapibus dolor pretium. Curabitur eget augue non ipsum pulvinar venenatis eget et lectus. Proin fringilla aliquet sapien, non luctus est lobortis vel. Nunc vehicula volutpat varius. Aliquam suscipit accumsan sollicitudin. Morbi ultricies, mauris id elementum pellentesque, nunc dolor viverra nisl, sit amet consequat velit libero at ligula. Nulla luctus rhoncus tortor nec sollicitudin. Vivamus posuere sodales ipsum, hendrerit cursus felis pharetra sit amet. Nunc interdum facilisis massa ac congue.</p>
     1.5  		<p>Aliquam erat volutpat. Quisque vitae libero est. Aliquam erat volutpat. Integer elementum, nisl nec lacinia facilisis, dolor tellus varius eros, sit amet facilisis sem sapien vitae nulla. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Integer rutrum sodales venenatis. Donec mollis aliquet enim, id venenatis urna faucibus sed. Suspendisse pharetra neque et nibh tincidunt suscipit. Morbi ut justo sit amet lectus faucibus tempor quis non libero. Aenean in dolor sem, in lacinia sem.</p>
     1.6  		
     1.7 -		<m:pre>#!/bin/bash
     1.8 -# tento kód nebude zvýrazněn
     1.9 -# &lt;blee/&gt;</m:pre>
    1.10 +		
    1.11  
    1.12  		<m:pre jazyk="java">public class Pokus {
    1.13  		// komentář
    1.14  		// &lt;blee/&gt;
    1.15  }</m:pre>
    1.16  
    1.17 -	<m:pre jazyk="grrrrrrr">public class Pokus {
    1.18 -		// komentář
    1.19 -		// &lt;blee/&gt;
    1.20 -}</m:pre>
    1.21 +		<m:pre jazyk="xml"><![CDATA[<xmlDokument>
    1.22 +	<element1>toto je <strong>pěkné</strong> XML!!!</element1>
    1.23 +</xmlDokument>]]></m:pre>
    1.24 +
    1.25 +		<m:pre jazyk="xxxxxxxx">chybný jazyk → syntaxe nebude zvýrazněna</m:pre>
    1.26 +		
    1.27 +		<m:pre>#!/bin/bash
    1.28 +# tento kód nebude zvýrazněn, protože atribut „jazyk“ chybý
    1.29 +# &lt;blee/&gt;</m:pre>
    1.30  		
    1.31  		<p>Vhodnost zvířete do domácnosti:</p>
    1.32  		<m:měřák hodnota="80"/>
     2.1 --- a/šablona/funkce/src/cz/frantovo/xmlWebGenerator/Funkce.java	Mon Aug 22 00:23:38 2011 +0200
     2.2 +++ b/šablona/funkce/src/cz/frantovo/xmlWebGenerator/Funkce.java	Mon Aug 22 01:10:55 2011 +0200
     2.3 @@ -10,22 +10,41 @@
     2.4  import java.net.URI;
     2.5  import java.net.URISyntaxException;
     2.6  
     2.7 +/**
     2.8 + * Knihovna funkcí volaných z XSLT.
     2.9 + *  
    2.10 + * TODO: časem rozdělit na více modulů (jmenných prostorů).
    2.11 + * 
    2.12 + * @author fiki
    2.13 + */
    2.14  public class Funkce {
    2.15  
    2.16 +	/**
    2.17 +	 * Zjištuje, kdy byl naposledy daný soubor změněn.
    2.18 +	 * @param soubor cesta k souboru
    2.19 +	 * @return datum poslední změny
    2.20 +	 * @throws URISyntaxException
    2.21 +	 */
    2.22  	public static Date posledníZměna(String soubor) throws URISyntaxException {
    2.23 -		return new Date(new File(new URI(soubor)).lastModified());
    2.24 +		URI uri = new URI(soubor);
    2.25 +		File f = new File(uri);
    2.26 +		return new Date(f.lastModified());
    2.27  	}
    2.28  
    2.29  	/**
    2.30  	 * Zvýrazňuje syntaxi zdrojového kódu. Používá k tomu externí program/knihovnu pygmentize.
    2.31  	 * @param zdroják zdrojový kód, který předáme příkazu pygmentize na standardním vstupu
    2.32  	 * @param jazyk předáme příkazu pygmentize jako parametr -l &lt;lexer&gt;
    2.33 -	 * @return TODO: použít (?) místo textu instanci com.icl.saxon.om.NodeInfo http://saxon.sourceforge.net/saxon6.5.3/extensibility.html
    2.34 +	 * @return zvýrazněný text nebo null, pokud došlo k chybě.
    2.35 +	 * TODO: použít (?) místo textu instanci com.icl.saxon.om.NodeInfo http://saxon.sourceforge.net/saxon6.5.3/extensibility.html
    2.36  	 */
    2.37  	public static String zvýrazniSyntaxi(String zdroják, String jazyk) throws IOException, InterruptedException {
    2.38 -		String příkaz = "pygmentizexxx";
    2.39 +		String příkaz = "pygmentize";
    2.40  
    2.41 -		if (isPrikazDostupny(příkaz)) {
    2.42 +		if (jazyk == null || jazyk.length() == 0) {
    2.43 +			System.err.println("Není vyplněn atribut „jazyk“ → není jasné, jak se má zvýrazňovat.");
    2.44 +			return null;
    2.45 +		} else if (isPrikazDostupny(příkaz)) {
    2.46  			Runtime r = Runtime.getRuntime();
    2.47  			Process p = r.exec(new String[]{příkaz, "-f", "html", "-l", jazyk});
    2.48  
    2.49 @@ -39,20 +58,27 @@
    2.50  			p.waitFor();
    2.51  
    2.52  			if (chyby.length() == 0) {
    2.53 +				// Pozor: pygmentize má i při chybě návratový kód 0 → je potřeba kontrolovat chybový výstup.
    2.54  				return výsledek;
    2.55  			} else {
    2.56 -				System.err.println("Při zvýrazňování syntaxe došlo k chybě: " + chyby);
    2.57 -				return "______chyba_____";
    2.58 +				System.err.print("Při zvýrazňování syntaxe došlo k chybě: " + chyby);
    2.59 +				return null;
    2.60  			}
    2.61  		} else {
    2.62  			System.err.println("Příkaz " + příkaz + " není na vašem systému dostupný → zvýrazňování syntaxe nebude fungovat.");
    2.63 -			System.err.println("Můžete ho nainstalovat pomocí: aptitude install python-pygments");
    2.64 -			// TODO: příkaz pro Fedoru/RedHat
    2.65 -			// TODO: vracet escapovaný zdroják v <pre/>
    2.66 -			return "__xxx____chyba_____";
    2.67 +			System.err.println("Můžete ho nainstalovat pomocí:");
    2.68 +			System.err.println("\t$ aptitude install python-pygments   # (Debian/Ubuntu)");
    2.69 +			System.err.println("\t$ yum install python-pygments        # (Fedora/RedHat)");
    2.70 +			return null;
    2.71  		}
    2.72  	}
    2.73  
    2.74 +	/**
    2.75 +	 * Čte proud dat dokud to jde a výsledek pak vrátí jako text.
    2.76 +	 * @param proud vstupní proud
    2.77 +	 * @return obsah proudu jako text
    2.78 +	 * @throws IOException 
    2.79 +	 */
    2.80  	private static String načtiProud(InputStream proud) throws IOException {
    2.81  		StringBuilder výsledek = new StringBuilder();
    2.82  		BufferedReader buf = new BufferedReader(new InputStreamReader(proud));
    2.83 @@ -68,6 +94,11 @@
    2.84  		return výsledek.toString();
    2.85  	}
    2.86  
    2.87 +	/**
    2.88 +	 * Pomocí programu which zjistí, jestli je daný příkaz v systému přítomný.
    2.89 +	 * @param příkaz jehož přítomnost zjišťujeme
    2.90 +	 * @return true pokud příkaz v systému existuje
    2.91 +	 */
    2.92  	private static boolean isPrikazDostupny(String příkaz) {
    2.93  		try {
    2.94  			Runtime r = Runtime.getRuntime();
     3.1 --- a/šablona/stránka.xsl	Mon Aug 22 00:23:38 2011 +0200
     3.2 +++ b/šablona/stránka.xsl	Mon Aug 22 01:10:55 2011 +0200
     3.3 @@ -117,13 +117,17 @@
     3.4      <!--
     3.5      	Makro pro zvýraznění syntaxe:
     3.6      -->    
     3.7 -    <xsl:template match="m:pre[@jazyk]">
     3.8 -    	<xsl:value-of disable-output-escaping="yes" select="j:zvýrazniSyntaxi(text(), @jazyk)"/>
     3.9 -    </xsl:template>
    3.10      <xsl:template match="m:pre">
    3.11 -    	<!-- Pokud jazyk uveden není, nic nezvýrazňujeme. -->
    3.12 -    	<pre><xsl:apply-templates/></pre>    	
    3.13 -    </xsl:template>
    3.14 -    
    3.15 +    	<xsl:variable name="zvýrazněnýText" select="j:zvýrazniSyntaxi(text(), @jazyk)"/>
    3.16 +    	<xsl:choose>
    3.17 +    		<xsl:when test="$zvýrazněnýText">
    3.18 +    			<xsl:value-of disable-output-escaping="yes" select="$zvýrazněnýText"/>		
    3.19 +    		</xsl:when>
    3.20 +    		<xsl:otherwise>
    3.21 +    			<xsl:message>Zvýraznění syntaxe se nezdařilo → bude vložen původní nezvýrazněný kód.</xsl:message>
    3.22 +    			<pre><xsl:apply-templates/></pre>
    3.23 +    		</xsl:otherwise>
    3.24 +    	</xsl:choose>
    3.25 +    </xsl:template>   
    3.26  
    3.27  </xsl:stylesheet>