@Retention(value=RUNTIME)
@Target(value={FIELD,PARAMETER})
public @interface Cascading

Indicates a mocked type where the return types of mocked methods get automatically mocked if and when an invocation to the method occurs, with a mocked instance being returned instead of null. Further invocations can then be made on the cascaded instances, with the cascading process repeating itself as needed.

Methods returning String, primitive wrappers, or collection types are not considered for cascading.

In a test having a cascading mocked type, a separate non-cascading mocked type can be used to record/verify expectations on intermediate cascaded instances.