Package org.codehaus.plexus.compiler

Interface Compiler

All Known Implementing Classes:

AbstractCompiler, CSharpCompiler, EclipseJavaCompiler, J2ObjCCompiler, JavacCompiler, JikesCompiler

public interface Compiler

The interface of an compiling language processor (aka compiler).

Author:

Jason van Zyl, Trygve Laugstøl, Matthew Pocock

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	ROLE

Method Summary

Modifier and Type	Method	Description
boolean	canUpdateTarget(CompilerConfiguration configuration)
java.util.List<CompilerError>	compile(CompilerConfiguration configuration)	Deprecated.
java.lang.String[]	createCommandLine(CompilerConfiguration config)	Create the command line that would be executed using this configuration.
CompilerOutputStyle	getCompilerOutputStyle()
java.lang.String	getInputFileEnding(CompilerConfiguration configuration)
java.lang.String	getOutputFile(CompilerConfiguration configuration)
java.lang.String	getOutputFileEnding(CompilerConfiguration configuration)
CompilerResult	performCompile(CompilerConfiguration configuration)	Performs the compilation of the project.

Field Detail

ROLE

static final java.lang.String ROLE

Method Detail

getCompilerOutputStyle

CompilerOutputStyle getCompilerOutputStyle()

getInputFileEnding

java.lang.String getInputFileEnding(CompilerConfiguration configuration)
                             throws CompilerException

Throws:

CompilerException

getOutputFileEnding

java.lang.String getOutputFileEnding(CompilerConfiguration configuration)
                              throws CompilerException

Throws:

CompilerException

getOutputFile

java.lang.String getOutputFile(CompilerConfiguration configuration)
                        throws CompilerException

Throws:

CompilerException

canUpdateTarget

boolean canUpdateTarget(CompilerConfiguration configuration)
                 throws CompilerException

Throws:

CompilerException

performCompile

CompilerResult performCompile(CompilerConfiguration configuration)
                       throws CompilerException

Performs the compilation of the project. Clients must implement this method.

Parameters:

configuration - the configuration description of the compilation to perform

Returns:

the result of the compilation returned by the language processor

Throws:

CompilerException

compile

@Deprecated
java.util.List<CompilerError> compile(CompilerConfiguration configuration)
                               throws CompilerException

Deprecated.

This method is provided for backwards compatibility only. Clients should use performCompile(CompilerConfiguration) instead.

Parameters:

configuration - the configuration description of the compilation to perform

Returns:

the result of the compilation returned by the language processor

Throws:

CompilerException

createCommandLine

java.lang.String[] createCommandLine(CompilerConfiguration config)
                              throws CompilerException

Create the command line that would be executed using this configuration. If this particular compiler has no concept of a command line then returns null.

Parameters:

config - the CompilerConfiguration describing the compilation

Returns:

an array of Strings that make up the command line, or null if this compiler has no concept of command line

Throws:

CompilerException - if there was an error generating the command line