01: /*
02: * $Id: TemplateEngine.java 1082 2004-04-19 07:29:47Z cpoirier $version Mar 8, 2004 2:08:49 AM $user Exp $
03: *
04: * Copyright 2003 (C) Sam Pullara. All Rights Reserved.
05: *
06: * Redistribution and use of this software and associated documentation
07: * ("Software"), with or without modification, are permitted provided that the
08: * following conditions are met: 1. Redistributions of source code must retain
09: * copyright statements and notices. Redistributions must also contain a copy
10: * of this document. 2. Redistributions in binary form must reproduce the above
11: * copyright notice, this list of conditions and the following disclaimer in
12: * the documentation and/or other materials provided with the distribution. 3.
13: * The name "groovy" must not be used to endorse or promote products derived
14: * from this Software without prior written permission of The Codehaus. For
15: * written permission, please contact info@codehaus.org. 4. Products derived
16: * from this Software may not be called "groovy" nor may "groovy" appear in
17: * their names without prior written permission of The Codehaus. "groovy" is a
18: * registered trademark of The Codehaus. 5. Due credit should be given to The
19: * Codehaus - http://groovy.codehaus.org/
20: *
21: * THIS SOFTWARE IS PROVIDED BY THE CODEHAUS AND CONTRIBUTORS ``AS IS'' AND ANY
22: * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
23: * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
24: * DISCLAIMED. IN NO EVENT SHALL THE CODEHAUS OR ITS CONTRIBUTORS BE LIABLE FOR
25: * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
27: * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
28: * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
31: * DAMAGE.
32: *
33: */
34: package groovy.text;
35:
36: import java.io.File;
37: import java.io.FileNotFoundException;
38: import java.io.FileReader;
39: import java.io.IOException;
40: import java.io.InputStreamReader;
41: import java.io.Reader;
42: import java.io.StringReader;
43: import java.net.URL;
44:
45: import org.codehaus.groovy.control.CompilationFailedException;
46:
47: /**
48: * Represents an API to any template engine which is basically a factory of Template instances from a given text input.
49: *
50: * @author sam
51: */
52: public abstract class TemplateEngine {
53: public abstract Template createTemplate(Reader reader)
54: throws CompilationFailedException, ClassNotFoundException,
55: IOException;
56:
57: public Template createTemplate(String templateText)
58: throws CompilationFailedException, FileNotFoundException,
59: ClassNotFoundException, IOException {
60: return createTemplate(new StringReader(templateText));
61: }
62:
63: public Template createTemplate(File file)
64: throws CompilationFailedException, FileNotFoundException,
65: ClassNotFoundException, IOException {
66: return createTemplate(new FileReader(file));
67: }
68:
69: public Template createTemplate(URL url)
70: throws CompilationFailedException, ClassNotFoundException,
71: IOException {
72: return createTemplate(new InputStreamReader(url.openStream()));
73: }
74: }
|