随笔 - 312, 文章 - 14, 评论 - 1393, 引用 - 0
数据加载中……

Java SE6调用Java编译器的两种新方法

本文为原创,如需转载,请注明作者和出处,谢谢!

本文曾发表于天极网:http://dev.yesky.com/451/3039451.shtml

在很多Java应用中需要在程序中调用Java编译器来编译和运行。但在早期的版本中(Java SE5及以前版本)中只能通过tools.jar中的com.sun.tools.javac包来调用Java编译器,但由于tools.jar不是标准的Java库,在使用时必须要设置这个jar的路径。而在Java SE6中为我们提供了标准的包来操作Java编译器,这就是javax.tools包。使用这个包,我们可以不用将jar文件路径添加到classpath中了。

一、使用JavaCompiler接口来编译Java源程序

使用Java API来编译Java源程序有很多方法,现在让我们来看一种最简单的方法,通过JavaCompiler进行编译。

我们可以通过ToolProvider类的静态方法getSystemJavaCompiler来得到一个JavaCompiler接口的实例。

JavaCompiler compiler = ToolProvider.getSystemJavaCompiler();

JavaCompiler中最核心的方法是run。通过这个方法可以编译java源程序。这个方法有3个固定参数和1个可变参数(可变参数是从Jave SE5开始提供的一个新的参数类型,用type… argu表示)。前3个参数分别用来为java编译器提供参数、得到Java编译器的输出信息以及接收编译器的错误信息,后面的可变参数可以传入一个或多个Java源程序文件。如果run编译成功,返回0

int run(InputStream in, OutputStream out, OutputStream err, String... arguments)

如果前3个参数传入的是null,那么run方法将以标准的输入、输出代替,即System.inSystem.outSystem.err。如果我们要编译一个test.java文件,并将使用标准输入输出,run的使用方法如下:

int results = tool.run(null, null, null, "test.java");

下面是使用JavaCompiler的完整代码。


import java.io.*;
import javax.tools.*;

public class test_compilerapi
{
    
public static void main(String args[]) throws IOException
    {
        JavaCompiler compiler 
= ToolProvider.getSystemJavaCompiler();
        
int results = compiler.run(nullnullnull"test.java");
        System.out.println((results 
== 0)?"编译成功":"编译失败");
// 在程序中运行test
        Runtime run = Runtime.getRuntime();
        Process p 
= run.exec("java test");
        BufferedInputStream in 
= new BufferedInputStream(p.getInputStream());
        BufferedReader br 
= new BufferedReader(new InputStreamReader(in));
        String s;
        
while ((s = br.readLine()) != null)
            System.out.println(s);
    }
}    


public class test
{
    
public static void main(String[] args) throws Exception
    {
        System.out.println(
"JavaCompiler测试成功!");
    }
}

编译成功的输出结果:

编译成功

JavaCompiler测试成功

编译失败的输出结果:

test.java:9: 找不到符号

符号:方法 printlnln(java.lang.String)

位置: java.io.PrintStream

              System.out.printlnln("JavaCompiler测试成功!");

                        ^

1 错误

编译失败

二、使用StandardJavaFileManager编译Java源程序

在第一部分我们讨论调用java编译器的最容易的方法。这种方法可以很好地工作,但它确不能更有效地得到我们所需要的信息,如标准的输入、输出信息。而在Java SE6中最好的方法是使用StandardJavaFileManager类。这个类可以很好地控制输入、输出,并且可以通过DiagnosticListener得到诊断信息,而DiagnosticCollector类就是listener的实现。

使用StandardJavaFileManager需要两步。首先建立一个DiagnosticCollector实例以及通过JavaCompilergetStandardFileManager()方法得到一个StandardFileManager对象。最后通过CompilationTask中的call方法编译源程序。

在使用这种方法调用Java编译时最复杂的方法就是getTask,下面让我们讨论一下getTask方法。这个方法有如下所示的6个参数。


getTask(Writer out,

JavaFileManager fileManager,

DiagnosticListener
<? super JavaFileObject> diagnosticListener,

Iterable
<String> options,

Iterable
<String> classes,

Iterable
<? extends JavaFileObject> compilationUnits)

这些参数大多数都可为null。它们的含义所下。

1.         out::用于输出错误的流,默认是System.err

2.         fileManager::标准的文件管理。

3.         diagnosticListener: 编译器的默认行为。

4.         options: 编译器的选项

5.         classes:参与编译的class

最后一个参数compilationUnits不能为null,因为这个对象保存了你想编译的Java文件。

在使用完getTask后,需要通过StandardJavaFileManagergetJavaFileObjectsFromFilesgetJavaFileObjectsFromStrings方法得到compilationUnits对象。调用这两个方法的方式如下:.


Iterable<? extends JavaFileObject> getJavaFileObjectsFromFiles(
Iterable
<? extends File> files)
Iterable
<? extends JavaFileObject> getJavaFileObjectsFromStrings(
Iterable
<String> names)

String[] filenames 
= …;
Iterable
<? extends JavaFileObject> compilationUnits =
fileManager.getJavaFileObjectsFromFiles(Arrays.asList(filenames));

    JavaCompiler.CompilationTask task 
= compiler.getTask(null, fileManager,
                        diagnostics, options, 
null, compilationUnits);

    最后需要关闭fileManager.close();

下面是一个完整的演示程序。


import java.io.*;
import java.util.*;
import javax.tools.*;

public class test_compilerapi
{
    
private static void compilejava() throws Exception
    {
        JavaCompiler compiler 
= ToolProvider.getSystemJavaCompiler();
        
// 建立DiagnosticCollector对象
        DiagnosticCollector<JavaFileObject> diagnostics 
= new DiagnosticCollector<JavaFileObject>();      
        StandardJavaFileManager fileManager 
= compiler.getStandardFileManager(
                        diagnostics, 
nullnull);
        
// 建立用于保存被编译文件名的对象
        
// 每个文件被保存在一个从JavaFileObject继承的类中      
        Iterable<? extends JavaFileObject> compilationUnits = fileManager
                        .getJavaFileObjectsFromStrings(Arrays asList(
"test3.java"));
        JavaCompiler.CompilationTask task 
= compiler.getTask(null, fileManager,
                        diagnostics, 
nullnull, compilationUnits);
        
// 编译源程序
        boolean success = task.call();
        fileManager.close();
        System.out.println((success)
?”编译成功”:”编译失败”);
    }
    
public static void main(String args[]) throws Exception
    {
        compilejava();
    }
}

    如果想得到具体的编译错误,可以对Diagnostics进行扫描,代码如下:


        for (Diagnostic diagnostic : diagnostics.getDiagnostics())
            System.out.printf(
            
"Code: %s%n" +
            
"Kind: %s%n" +
            
"Position: %s%n" +
            
"Start Position: %s%n" +
            
"End Position: %s%n" +
            
"Source: %s%n" +
            
"Message: %s%n",
            diagnostic.getCode(), diagnostic.getKind(),
            diagnostic.getPosition(), diagnostic.getStartPosition(),
            diagnostic.getEndPosition(), diagnostic.getSource(),
            diagnostic.getMessage(
null));

被编译的test.java代码如下:

public class test
{
    
public static void main(String[] args) throws Exception
    {
        aa;  
//错误语句
        System.out.println("JavaCompiler测试成功!");
    }
}


在这段代码中多写了个aa,得到的编译错误为:

Code: compiler.err.not.stmt

Kind: ERROR

Position: 89

Start Position: 89

End Position: 89

Source: test.java

Message: test.java:5: 不是语句

Success: false

    通过JavaCompiler进行编译都是在当前目录下生成.class文件,而使用编译选项可以改变这个默认目录。编译选项是一个元素为String类型的Iterable集合。如我们可以使用如下代码在D盘根目录下生成.class文件。


Iterable<String> options = Arrays.asList("-d""d:\\");
JavaCompiler.CompilationTask task 
= compiler.getTask(null, fileManager,
                    diagnostics, options, 
null, compilationUnits);

在上面的例子中options处的参数为null,而要传递编译器的参数,就需要将options传入。

有时我们编译一个Java源程序文件,而这个源程序文件需要另几个Java文件,而这些Java文件又在另外一个目录,那么这就需要为编译器指定这些文件所在的目录。

Iterable<String> options = Arrays.asList("-sourcepath", "d:""src");

上面的代码指定的被编译Java文件所依赖的源文件所在的目录。

 

三、在内存中编译

JavaCompiler不仅可以编译硬盘上的Java文件,而且还可以编译内存中的Java代码,然后使用reflection来运行它们。我们可以编写一个JavaSourceFromString类,通过这个类可以输入Java源代码。一但建立这个对象,你可以向其中输入任意的Java代码,然后编译和运行,而且无需向硬盘上写.class文件。

import java.lang.reflect.*;
import java.io.*;
import javax.tools.*;
import javax.tools.JavaCompiler.CompilationTask;
import java.util.*;
import java.net.*;

public class test_compilerapi
{
    
private static void compilerJava() throws Exception
    {
        JavaCompiler compiler 
= ToolProvider.getSystemJavaCompiler();
        DiagnosticCollector
<JavaFileObject> diagnostics 
= new DiagnosticCollector<JavaFileObject>();
        
// 定义一个StringWriter类,用于写Java程序
        StringWriter writer = new StringWriter();
        PrintWriter out 
= new PrintWriter(writer);
        
// 开始写Java程序
        out.println("public class HelloWorld {");
        out.println(
" public static void main(String args[]) {");
        out.println(
" System.out.println(\"Hello, World\");");
        out.println(
" }");
        out.println(
"}");
        out.close();
        
//为这段代码取个名子:HelloWorld,以便以后使用reflection调用
        JavaFileObject file = new JavaSourceFromString("HelloWorld", writer
                        .toString());
        Iterable
<? extends JavaFileObject> compilationUnits = Arrays
                        .asList(file);
        JavaCompiler.CompilationTask task 
= compiler.getTask(nullnull,
                        diagnostics, 
nullnull, compilationUnits);
        
boolean success = task.call();
        System.out.println(
"Success: " + success);
        
// 如果成功,通过reflection执行这段Java程序
        if (success)
        {
            System.out.println(
"-----输出-----");
            Class.forName(
"HelloWorld").getDeclaredMethod("main"new Class[]
            { String[].
class }).invoke(nullnew Object[]
            { 
null });
            System.out.println(
"-----输出 -----");
        }        
    }
    
public static void main(String args[]) throws Exception
    {
        compilerJava();
    }
}
// 用于传递源程序的JavaSourceFromString类
class JavaSourceFromString extends SimpleJavaFileObject
{
    
final String code;
    JavaSourceFromString(String name, String code)
    {
        
super(URI.create("string:///" + name.replace('.''/')
                        
+ Kind.SOURCE.extension), Kind.SOURCE);
        
this.code = code;
    }
    @Override
    
public CharSequence getCharContent(boolean ignoreEncodingErrors)
    {
        
return code;
    }
}






Android开发完全讲义(第2版)(本书版权已输出到台湾)

http://product.dangdang.com/product.aspx?product_id=22741502



Android高薪之路:Android程序员面试宝典 http://book.360buy.com/10970314.html


新浪微博:http://t.sina.com.cn/androidguy   昵称:李宁_Lining

posted on 2008-05-13 10:25 银河使者 阅读(3022) 评论(3)  编辑  收藏 所属分类: java 原创

评论

# re: Java SE6调用Java编译器的两种新方法  回复  更多评论   

没东西发就别发 发了一年了多了 现在又拿出来重发 搞个毛
2008-05-13 16:59 | as

# re: Java SE6调用Java编译器的两种新方法[未登录]  回复  更多评论   

不同意楼上的观点,每时每刻大家都在学习中。你学到不代表别人学到了。。呵呵!!话语如有过激,请多原谅
2008-05-13 19:10 | Samuel

# re: Java SE6调用Java编译器的两种新方法  回复  更多评论   

最近只是将我在其他媒体发表过的或以前写过的文章都放到blogjava和我在博客园的blog:nokiaguy.cnblogs.com上。做一个备份和总结,也希望对想学习相关知识的朋友有所帮助。 如果大家有什么意见,尽管提。哈哈!!!
2008-05-13 19:13 | 银河使者

只有注册用户登录后才能发表评论。


网站导航: