Changeset 28:3298cafa8686 for šablona/funkce/src/cz/frantovo/xmlWebGenerator/Funkce.java

Timestamp:

08/22/11 01:10:55 (13 years ago)

Author:

František Kučera <franta-hg@…>

Branch:

default

Message:

#12 Lepší ošetření chyb – vypíšeme varování a na výstup vložíme původní text bez zvýraznění syntaxe.

Files:

• šablona/funkce/src/cz/frantovo/xmlWebGenerator/Funkce.java (modified) (4 diffs)

šablona/funkce/src/cz/frantovo/xmlWebGenerator/Funkce.java

@@ -11 +11 @@
 import java.net.URISyntaxException;
 
+/**
+ * Knihovna funkcí volaných z XSLT.
+ *  
+ * TODO: časem rozdělit na více modulů (jmenných prostorů).
+ * 
+ * @author fiki
+ */
 public class Funkce {
 
+        /**
+         * Zjištuje, kdy byl naposledy daný soubor změněn.
+         * @param soubor cesta k souboru
+         * @return datum poslední změny
+         * @throws URISyntaxException
+         */
         public static Date posledníZměna(String soubor) throws URISyntaxException {
-                return new Date(new File(new URI(soubor)).lastModified());
+                URI uri = new URI(soubor);
+                File f = new File(uri);
+                return new Date(f.lastModified());
         }
 
@@ -21 +36 @@
          * @param zdroják zdrojový kód, který předáme příkazu pygmentize na standardním vstupu
          * @param jazyk předáme příkazu pygmentize jako parametr -l <lexer>
-         * @return TODO: použít (?) místo textu instanci com.icl.saxon.om.NodeInfo http://saxon.sourceforge.net/saxon6.5.3/extensibility.html
+         * @return zvýrazněný text nebo null, pokud došlo k chybě.
+         * TODO: použít (?) místo textu instanci com.icl.saxon.om.NodeInfo http://saxon.sourceforge.net/saxon6.5.3/extensibility.html
          */
         public static String zvýrazniSyntaxi(String zdroják, String jazyk) throws IOException, InterruptedException {
-                String příkaz = "pygmentizexxx";
+                String příkaz = "pygmentize";
 
-                if (isPrikazDostupny(příkaz)) {
+                if (jazyk == null || jazyk.length() == 0) {
+                        System.err.println("Není vyplněn atribut „jazyk“ → není jasné, jak se má zvýrazňovat.");
+                        return null;
+                } else if (isPrikazDostupny(příkaz)) {
                         Runtime r = Runtime.getRuntime();
                         Process p = r.exec(new String[]{příkaz, "-f", "html", "-l", jazyk});
@@ -40 +59 @@
 
                         if (chyby.length() == 0) {
+                                // Pozor: pygmentize má i při chybě návratový kód 0 → je potřeba kontrolovat chybový výstup.
                                 return výsledek;
                         } else {
-                                System.err.println("Při zvýrazňování syntaxe došlo k chybě: " + chyby);
-                                return "______chyba_____";
+                                System.err.print("Při zvýrazňování syntaxe došlo k chybě: " + chyby);
+                                return null;
                         }
                 } else {
                         System.err.println("Příkaz " + příkaz + " není na vašem systému dostupný → zvýrazňování syntaxe nebude fungovat.");
-                        System.err.println("Můžete ho nainstalovat pomocí: aptitude install python-pygments");
-                        // TODO: příkaz pro Fedoru/RedHat
-                        // TODO: vracet escapovaný zdroják v <pre/>
-                        return "__xxx____chyba_____";
+                        System.err.println("Můžete ho nainstalovat pomocí:");
+                        System.err.println("\t$ aptitude install python-pygments   # (Debian/Ubuntu)");
+                        System.err.println("\t$ yum install python-pygments        # (Fedora/RedHat)");
+                        return null;
                 }
         }
 
+        /**
+         * Čte proud dat dokud to jde a výsledek pak vrátí jako text.
+         * @param proud vstupní proud
+         * @return obsah proudu jako text
+         * @throws IOException 
+         */
         private static String načtiProud(InputStream proud) throws IOException {
                 StringBuilder výsledek = new StringBuilder();
@@ -69 +95 @@
         }
 
+        /**
+         * Pomocí programu which zjistí, jestli je daný příkaz v systému přítomný.
+         * @param příkaz jehož přítomnost zjišťujeme
+         * @return true pokud příkaz v systému existuje
+         */
         private static boolean isPrikazDostupny(String příkaz) {
                 try {