Summary

Rewrite the specification in java.lang.reflect.Proxy about the invocation dispatching to InvocationHandler to make it self-contained within Proxy.

Problem

java.lang.reflect.InvocationHandler is designed to be used with Proxy, but since its introduction, it has been used for other purposes, such as for other dynamic proxy libraries like cglib. It may be inappropriate to specify InvocationHandler to be too closely-tied to the behaviors of java.lang.reflect.Proxy; specific Proxy behavior should move to Proxy instead.

In addition, the specification for Proxy about dispatching can be consolidated and simplified as well.

Solution

Rewrite the specification of Proxy about instance behavior and invocation dispatching, to simplify and cover the documentation already present in InvocationHandler.

Specification

(WIP)