net.jueb.util4j.hotSwap.memoryScript.impl

类 CharSequenceCompiler<T>

java.lang.Object

net.jueb.util4j.hotSwap.memoryScript.impl.CharSequenceCompiler<T>

所有已实现的接口:

MemoryCompiler

public class CharSequenceCompiler<T>
extends Object
implements MemoryCompiler

Compile a String or other CharSequence, returning a Java Class instance that may be instantiated. This class is a Facade around JavaCompiler for a narrower use case, but a bit easier to use.

To compile a String containing source for a Java class which implements MyInterface:

 ClassLoader classLoader = MyClass.class.getClassLoader(); // optional; null is also OK
 List<Diagnostic> diagnostics = new ArrayList<Diagnostic>(); // optional; null is also OK
 JavaStringCompiler<Object> compiler = new JavaStringCompiler<MyInterface>(classLoader,
       null);
 try {
    Class<MyInterface> newClass = compiler.compile("com.mypackage.NewClass",
          stringContaininSourceForNewClass, diagnostics, MyInterface);
    MyInterface instance = newClass.newInstance();
    instance.someOperation(someArgs);
 } catch (JavaStringCompilerException e) {
    handle(e);
 } catch (IllegalAccessException e) {
    handle(e);
 }
 

The source can be in a String, StringBuffer, or your own class which implements CharSequence. If you implement your own, it must be thread safe (preferably, immutable.)

作者:

David J. Biesack

构造器概要

构造器

构造器和说明
CharSequenceCompiler(ClassLoader loader, Iterable<String> options) Construct a new instance which delegates to the named class loader.

方法概要

限定符和类型	方法和说明
Map<String,Class<T>>	compile(Map<String,CharSequence> classes, DiagnosticCollector<JavaFileObject> diagnosticsList) Compile multiple Java source strings and return a Map containing the resulting classes.
Class<T>	compile(String qualifiedClassName, CharSequence javaSource, DiagnosticCollector<JavaFileObject> diagnosticsList, Class<?>... types) Compile Java source in javaSource and return the resulting class.
Class<?>	compile(String qualifiedClassName, String javaSource)
ClassLoader	getClassLoader()
Class<T>	loadClass(String qualifiedClassName) Load a class that was generated by this instance or accessible from its parent class loader.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

CharSequenceCompiler

public CharSequenceCompiler(ClassLoader loader,
                            Iterable<String> options)

Construct a new instance which delegates to the named class loader.

参数:

loader - the application ClassLoader. The compiler will look through to this // class loader for dependent classes

options - The compiler options (such as "-target" "1.5"). See the usage for javac

抛出:

IllegalStateException - if the Java compiler cannot be loaded.

方法详细资料

compile

public Class<?> compile(String qualifiedClassName,
                        String javaSource)
                 throws Exception

指定者:

compile 在接口中 MemoryCompiler

参数:

qualifiedClassName - example: com.rgt.slg.gameserver.script.MemoryCompiler

javaSource - 源码

返回:

抛出:

Exception

compile

public Class<T> compile(String qualifiedClassName,
                        CharSequence javaSource,
                        DiagnosticCollector<JavaFileObject> diagnosticsList,
                        Class<?>... types)
                 throws net.jueb.util4j.hotSwap.memoryScript.impl.CharSequenceCompilerException,
                        ClassCastException

Compile Java source in javaSource and return the resulting class.

Thread safety: this method is thread safe if the javaSource and diagnosticsList are isolated to this thread.

参数:

qualifiedClassName - The fully qualified class name.

javaSource - Complete java source, including a package statement and a class, interface, or annotation declaration.

diagnosticsList - Any diagnostics generated by compiling the source are added to this collector.

types - zero or more Class objects representing classes or interfaces that the resulting class must be assignable (castable) to.

返回:

a Class which is generated by compiling the source

抛出:

net.jueb.util4j.hotSwap.memoryScript.impl.CharSequenceCompilerException - if the source cannot be compiled - for example, if it contains syntax or semantic errors or if dependent classes cannot be found.

ClassCastException - if the generated class is not assignable to all the optional types.

compile

public Map<String,Class<T>> compile(Map<String,CharSequence> classes,
                                    DiagnosticCollector<JavaFileObject> diagnosticsList)
                             throws net.jueb.util4j.hotSwap.memoryScript.impl.CharSequenceCompilerException

Compile multiple Java source strings and return a Map containing the resulting classes.

Thread safety: this method is thread safe if the classes and diagnosticsList are isolated to this thread.

参数:

classes - A Map whose keys are qualified class names and whose values are the Java source strings containing the definition of the class. A map value may be null, indicating that compiled class is expected, although no source exists for it (it may be a non-public class contained in one of the other strings.)

diagnosticsList - Any diagnostics generated by compiling the source are added to this list.

返回:

A mapping of qualified class names to their corresponding classes. The map has the same keys as the input classes; the values are the corresponding Class objects.

抛出:

net.jueb.util4j.hotSwap.memoryScript.impl.CharSequenceCompilerException - if the source cannot be compiled

loadClass

public Class<T> loadClass(String qualifiedClassName)
                   throws ClassNotFoundException

Load a class that was generated by this instance or accessible from its parent class loader. Use this method if you need access to additional classes compiled by compile(), for example if the primary class contained nested classes or additional non-public classes.

参数:

qualifiedClassName - the name of the compiled class you wish to load

返回:

a Class instance named by qualifiedClassName

抛出:

ClassNotFoundException - if no such class is found.

getClassLoader

public ClassLoader getClassLoader()

返回:

This compiler's class loader.