šablona/funkce/src/cz/frantovo/xmlWebGenerator/Funkce.java
author František Kučera <franta-hg@frantovo.cz>
Mon, 22 Aug 2011 13:57:20 +0200
changeset 31 da6ae32853cb
parent 30 cefd5fe75cb8
child 32 6bc25517ac4f
permissions -rw-r--r--
Zvýrazňování syntaxe #12 – prakticky hotové.
franta-hg@6
     1
package cz.frantovo.xmlWebGenerator;
franta-hg@6
     2
franta-hg@27
     3
import java.io.BufferedReader;
franta-hg@6
     4
import java.io.File;
franta-hg@27
     5
import java.io.IOException;
franta-hg@27
     6
import java.io.InputStream;
franta-hg@27
     7
import java.io.InputStreamReader;
franta-hg@27
     8
import java.io.PrintStream;
franta-hg@6
     9
import java.util.Date;
franta-hg@6
    10
import java.net.URI;
franta-hg@6
    11
import java.net.URISyntaxException;
franta-hg@6
    12
franta-hg@28
    13
/**
franta-hg@28
    14
 * Knihovna funkcí volaných z XSLT.
franta-hg@28
    15
 *  
franta-hg@28
    16
 * TODO: časem rozdělit na více modulů (jmenných prostorů).
franta-hg@28
    17
 * 
franta-hg@28
    18
 * @author fiki
franta-hg@28
    19
 */
franta-hg@6
    20
public class Funkce {
franta-hg@27
    21
franta-hg@30
    22
	private static final String PŘÍKAZ_PYGMENTIZE = "pygmentize";
franta-hg@30
    23
	private static final String PŘÍKAZ_WHICH = "which";
franta-hg@30
    24
franta-hg@28
    25
	/**
franta-hg@28
    26
	 * Zjištuje, kdy byl naposledy daný soubor změněn.
franta-hg@28
    27
	 * @param soubor cesta k souboru
franta-hg@28
    28
	 * @return datum poslední změny
franta-hg@28
    29
	 * @throws URISyntaxException
franta-hg@28
    30
	 */
franta-hg@21
    31
	public static Date posledníZměna(String soubor) throws URISyntaxException {
franta-hg@28
    32
		URI uri = new URI(soubor);
franta-hg@28
    33
		File f = new File(uri);
franta-hg@28
    34
		return new Date(f.lastModified());
franta-hg@21
    35
	}
franta-hg@27
    36
franta-hg@27
    37
	/**
franta-hg@27
    38
	 * Zvýrazňuje syntaxi zdrojového kódu. Používá k tomu externí program/knihovnu pygmentize.
franta-hg@27
    39
	 * @param zdroják zdrojový kód, který předáme příkazu pygmentize na standardním vstupu
franta-hg@27
    40
	 * @param jazyk předáme příkazu pygmentize jako parametr -l &lt;lexer&gt;
franta-hg@28
    41
	 * @return zvýrazněný text nebo null, pokud došlo k chybě.
franta-hg@31
    42
	 * TODO: 
franta-hg@31
    43
	 *	- použít (?) místo textu instanci com.icl.saxon.om.NodeInfo http://saxon.sourceforge.net/saxon6.5.3/extensibility.html
franta-hg@31
    44
	 *  - nebo kontrolovat validitu vygenerovaného kódu (v současnosti se spoléháme na bezchybnost pygmentize)
franta-hg@27
    45
	 */
franta-hg@27
    46
	public static String zvýrazniSyntaxi(String zdroják, String jazyk) throws IOException, InterruptedException {
franta-hg@28
    47
		if (jazyk == null || jazyk.length() == 0) {
franta-hg@28
    48
			System.err.println("Není vyplněn atribut „jazyk“ → není jasné, jak se má zvýrazňovat.");
franta-hg@28
    49
			return null;
franta-hg@30
    50
		} else if (isPrikazDostupny(PŘÍKAZ_PYGMENTIZE)) {
franta-hg@27
    51
			Runtime r = Runtime.getRuntime();
franta-hg@30
    52
			Process p = r.exec(new String[]{PŘÍKAZ_PYGMENTIZE, "-f", "html", "-l", jazyk});
franta-hg@27
    53
franta-hg@27
    54
			PrintStream vstupProcesu = new PrintStream(p.getOutputStream());
franta-hg@27
    55
			vstupProcesu.print(zdroják);
franta-hg@27
    56
			vstupProcesu.close();
franta-hg@27
    57
franta-hg@27
    58
			String výsledek = načtiProud(p.getInputStream());
franta-hg@27
    59
			String chyby = načtiProud(p.getErrorStream());
franta-hg@27
    60
franta-hg@27
    61
			p.waitFor();
franta-hg@27
    62
franta-hg@27
    63
			if (chyby.length() == 0) {
franta-hg@28
    64
				// Pozor: pygmentize má i při chybě návratový kód 0 → je potřeba kontrolovat chybový výstup.
franta-hg@27
    65
				return výsledek;
franta-hg@27
    66
			} else {
franta-hg@28
    67
				System.err.print("Při zvýrazňování syntaxe došlo k chybě: " + chyby);
franta-hg@28
    68
				return null;
franta-hg@27
    69
			}
franta-hg@27
    70
		} else {
franta-hg@30
    71
			System.err.println("Příkaz " + PŘÍKAZ_PYGMENTIZE + " není na vašem systému dostupný → zvýrazňování syntaxe nebude fungovat.");
franta-hg@28
    72
			System.err.println("Můžete ho nainstalovat pomocí:");
franta-hg@28
    73
			System.err.println("\t$ aptitude install python-pygments   # (Debian/Ubuntu)");
franta-hg@28
    74
			System.err.println("\t$ yum install python-pygments        # (Fedora/RedHat)");
franta-hg@28
    75
			return null;
franta-hg@27
    76
		}
franta-hg@27
    77
	}
franta-hg@27
    78
franta-hg@28
    79
	/**
franta-hg@31
    80
	 * Vygeneruje CSS styl pro zvýrazňování syntaxe.
franta-hg@31
    81
	 * @return obsah CSS souboru nebo null, pokud generování nebylo možné
franta-hg@31
    82
	 */
franta-hg@31
    83
	public static String generujCssSyntaxe() throws IOException, InterruptedException {
franta-hg@31
    84
		if (isPrikazDostupny(PŘÍKAZ_PYGMENTIZE)) {
franta-hg@31
    85
			Runtime r = Runtime.getRuntime();
franta-hg@31
    86
			Process p = r.exec(new String[]{PŘÍKAZ_PYGMENTIZE, "-S", "default", "-f", "html"});
franta-hg@31
    87
			return načtiProud(p.getInputStream());
franta-hg@31
    88
		} else {
franta-hg@31
    89
			return null;
franta-hg@31
    90
		}
franta-hg@31
    91
	}
franta-hg@31
    92
franta-hg@31
    93
	/**
franta-hg@28
    94
	 * Čte proud dat dokud to jde a výsledek pak vrátí jako text.
franta-hg@28
    95
	 * @param proud vstupní proud
franta-hg@28
    96
	 * @return obsah proudu jako text
franta-hg@28
    97
	 * @throws IOException 
franta-hg@28
    98
	 */
franta-hg@27
    99
	private static String načtiProud(InputStream proud) throws IOException {
franta-hg@27
   100
		StringBuilder výsledek = new StringBuilder();
franta-hg@27
   101
		BufferedReader buf = new BufferedReader(new InputStreamReader(proud));
franta-hg@27
   102
		while (true) {
franta-hg@27
   103
			String radek = buf.readLine();
franta-hg@27
   104
			if (radek == null) {
franta-hg@27
   105
				break;
franta-hg@27
   106
			} else {
franta-hg@27
   107
				výsledek.append(radek);
franta-hg@27
   108
				výsledek.append("\n");
franta-hg@27
   109
			}
franta-hg@27
   110
		}
franta-hg@27
   111
		return výsledek.toString();
franta-hg@27
   112
	}
franta-hg@27
   113
franta-hg@28
   114
	/**
franta-hg@28
   115
	 * Pomocí programu which zjistí, jestli je daný příkaz v systému přítomný.
franta-hg@28
   116
	 * @param příkaz jehož přítomnost zjišťujeme
franta-hg@28
   117
	 * @return true pokud příkaz v systému existuje
franta-hg@28
   118
	 */
franta-hg@27
   119
	private static boolean isPrikazDostupny(String příkaz) {
franta-hg@27
   120
		try {
franta-hg@27
   121
			Runtime r = Runtime.getRuntime();
franta-hg@30
   122
			Process p = r.exec(new String[]{PŘÍKAZ_WHICH, příkaz});
franta-hg@27
   123
			p.waitFor();
franta-hg@27
   124
			return p.exitValue() == 0;
franta-hg@27
   125
		} catch (Exception e) {
franta-hg@30
   126
			System.err.printf("Při zjišťování dostupnosti příkazu „%s“ došlo k chybě: %s", příkaz, e.getLocalizedMessage());
franta-hg@27
   127
			return false;
franta-hg@27
   128
		}
franta-hg@27
   129
	}
franta-hg@6
   130
}