001 /*
002 $Id: Compiler.java,v 1.25 2005/06/09 19:51:59 blackdrag Exp $
003
004 Copyright 2003 (C) James Strachan and Bob Mcwhirter. All Rights Reserved.
005
006 Redistribution and use of this software and associated documentation
007 ("Software"), with or without modification, are permitted provided
008 that the following conditions are met:
009
010 1. Redistributions of source code must retain copyright
011 statements and notices. Redistributions must also contain a
012 copy of this document.
013
014 2. Redistributions in binary form must reproduce the
015 above copyright notice, this list of conditions and the
016 following disclaimer in the documentation and/or other
017 materials provided with the distribution.
018
019 3. The name "groovy" must not be used to endorse or promote
020 products derived from this Software without prior written
021 permission of The Codehaus. For written permission,
022 please contact info@codehaus.org.
023
024 4. Products derived from this Software may not be called "groovy"
025 nor may "groovy" appear in their names without prior written
026 permission of The Codehaus. "groovy" is a registered
027 trademark of The Codehaus.
028
029 5. Due credit should be given to The Codehaus -
030 http://groovy.codehaus.org/
031
032 THIS SOFTWARE IS PROVIDED BY THE CODEHAUS AND CONTRIBUTORS
033 ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT
034 NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
035 FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
036 THE CODEHAUS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
037 INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
038 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
039 SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
040 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
041 STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
042 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
043 OF THE POSSIBILITY OF SUCH DAMAGE.
044
045 */
046
047 package org.codehaus.groovy.tools;
048
049 import java.io.File;
050
051 import org.codehaus.groovy.control.CompilationFailedException;
052 import org.codehaus.groovy.control.CompilationUnit;
053 import org.codehaus.groovy.control.CompilerConfiguration;
054 import org.codehaus.groovy.control.SourceUnit;
055
056
057
058
059 /**
060 * A convenience front end for getting standard compilations done.
061 * All compile() routines generate classes to the filesystem.
062 *
063 * @author <a href="mailto:cpoirier@dreaming.org">Chris Poirier</a>
064 *
065 * @version $Id: Compiler.java,v 1.25 2005/06/09 19:51:59 blackdrag Exp $
066 */
067
068 public class Compiler
069 {
070 public static Compiler DEFAULT = new Compiler();
071
072 private CompilerConfiguration configuration = null; // Optional configuration data
073
074 /**
075 * Initializes the Compiler with default configuration.
076 */
077
078 public Compiler()
079 {
080 configuration = null;
081 }
082
083
084 /**
085 * Initializes the Compiler with the specified configuration.
086 */
087
088 public Compiler( CompilerConfiguration configuration )
089 {
090 this.configuration = configuration;
091 }
092
093
094
095 /**
096 * Compiles a single File.
097 */
098
099 public void compile( File file ) throws CompilationFailedException
100 {
101 CompilationUnit unit = new CompilationUnit( configuration );
102 unit.addSource( file );
103 unit.compile();
104 }
105
106
107
108 /**
109 * Compiles a series of Files.
110 */
111
112 public void compile( File[] files ) throws CompilationFailedException
113 {
114 CompilationUnit unit = new CompilationUnit( configuration );
115 unit.addSources( files );
116 unit.compile();
117 }
118
119
120
121 /**
122 * Compiles a series of Files from file names.
123 */
124
125 public void compile( String[] files ) throws CompilationFailedException
126 {
127 CompilationUnit unit = new CompilationUnit( configuration );
128 unit.addSources( files );
129 unit.compile();
130 }
131
132
133
134 /**
135 * Compiles a string of code.
136 */
137
138 public void compile( String name, String code ) throws CompilationFailedException
139 {
140 CompilationUnit unit = new CompilationUnit( configuration );
141 unit.addSource( new SourceUnit(name, code, configuration, unit.getClassLoader(), unit.getErrorCollector()) );
142 unit.compile();
143 }
144
145 }
146
147
148
149