Package com.sun.tools.javac.api

Class ClientCodeWrapper

java.lang.Object

com.sun.tools.javac.api.ClientCodeWrapper

public class ClientCodeWrapper
extends Object

Wrap objects to enable unchecked exceptions to be caught and handled. For each method, exceptions are handled as follows:

• Checked exceptions are left alone and propogate upwards in the obvious way, since they are an expected aspect of the method's specification.
• Unchecked exceptions which have already been caught and wrapped in ClientCodeException are left alone to continue propogating upwards.
• All other unchecked exceptions (i.e. subtypes of RuntimeException and Error) and caught, and rethrown as a ClientCodeException with its cause set to the original exception.

The intent is that ClientCodeException can be caught at an appropriate point in the program and can be distinguished from any unanticipated unchecked exceptions arising in the main body of the code (i.e. bugs.) When the ClientCodeException has been caught, either a suitable message can be generated, or if appropriate, the original cause can be rethrown.

This is NOT part of any supported API. If you write code that depends on this, you do so at your own risk. This code and its internal interfaces are subject to change or deletion without notice.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ClientCodeWrapper.DiagnosticSourceUnwrapper
static interface	ClientCodeWrapper.Trusted
protected class	ClientCodeWrapper.WrappedDiagnosticListener<T>
protected class	ClientCodeWrapper.WrappedFileObject
protected class	ClientCodeWrapper.WrappedJavaFileManager
protected class	ClientCodeWrapper.WrappedJavaFileObject
protected class	ClientCodeWrapper.WrappedTaskListener

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ClientCodeWrapper(Context context)

Method Summary

Modifier and Type	Method and Description
static ClientCodeWrapper	instance(Context context)
protected boolean	isTrusted(Object o)
<T> DiagnosticListener<T>	wrap(DiagnosticListener<T> dl)
FileObject	wrap(FileObject fo)
JavaFileManager	wrap(JavaFileManager fm)
JavaFileObject	wrap(JavaFileObject fo)
Iterable<JavaFileObject>	wrapJavaFileObjects(Iterable<? extends JavaFileObject> list)

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientCodeWrapper

protected ClientCodeWrapper(Context context)

Method Detail

instance

public static ClientCodeWrapper instance(Context context)

wrap

public JavaFileManager wrap(JavaFileManager fm)

wrap

public FileObject wrap(FileObject fo)

wrap

public JavaFileObject wrap(JavaFileObject fo)

wrapJavaFileObjects

public Iterable<JavaFileObject> wrapJavaFileObjects(Iterable<? extends JavaFileObject> list)

wrap

public <T> DiagnosticListener<T> wrap(DiagnosticListener<T> dl)

isTrusted

protected boolean isTrusted(Object o)