Module io.github.ascopes.jct

Package io.github.ascopes.jct.filemanagers

Class LoggingFileManagerProxy

java.lang.Object

io.github.ascopes.jct.filemanagers.LoggingFileManagerProxy

All Implemented Interfaces:

InvocationHandler

@API(since="0.0.1",
     status=STABLE)
public final class LoggingFileManagerProxy
extends Object
implements InvocationHandler

A proxy that wraps a JctFileManager in a proxy that can log all interactions with the JavaFileManager, along with a corresponding stacktrace.

This is useful for diagnosing difficult-to-find errors being produced by javac during testing, however, it may produce a hefty performance overhead when in use.

All logs are emitted with the DEBUG logging level.

Since:

0.0.1

Author:

Ashley Scopes

Method Summary

Modifier and Type	Method	Description
Object	invoke(Object proxy, Method method, Object @Nullable ... args)	Invoke the given call.
String	toString()
static JctFileManager	wrap(JctFileManager manager, boolean stackTraces)	Wrap the given JctFileManager in a proxy that logs any calls.

Methods inherited from class java.lang.Object

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

Method Details

invoke

public Object invoke(Object proxy,
 Method method,
 Object @Nullable ... args)
              throws Throwable

Invoke the given call.

Specified by:

invoke in interface InvocationHandler

Parameters:

proxy - the proxy.

method - the method.

args - the arguments.

Returns:

the result.

Throws:

Throwable - any exception that is thrown.

toString

public String toString()

Overrides:

toString in class Object

wrap

public static JctFileManager wrap(JctFileManager manager,
 boolean stackTraces)

Wrap the given JctFileManager in a proxy that logs any calls.

Parameters:

manager - the manager to wrap.

stackTraces - true to dump stacktraces on each interception, or false to omit them.

Returns:

the proxy JctFileManager to use.