Package org.jsesoft.ri

Provides class inspection by reflection (subclass- and strategy pattern, resp).

See:
Description

Interface Summary

Inspector<T>	Provides an inspector for type T.
PassBack	Provides services for PassBack objects.

Class Summary

AnnotationInspector	Provides an inspectors for annotations.
ClassInspector	Provides an inspector for classes.
ConstructorInspector	Provides services for .
FieldInspector	Provides an inspector for fields.
InspectorFactory	Provides a factory for inspectors.
MethodInspector	Provides an inspector for methods.
ParameterTypesInspector	Provides inspectors for parameter types.
ReflectionInspectionHelpers	Provides helpers for reflection inspection.

Enum Summary

InspectorType

Specifies names for the different inspector types.

Annotation Types Summary

SampleAnnotation

Provides an example of an annotation for inspection by the ReflectionInspector.

Package org.jsesoft.ri Description

Provides class inspection by reflection (subclass- and strategy pattern, resp).

Package Specification

The package org.jsesoft.ri provides for class inspection by Java reflection.

The class ReflectionInspector

The class ReflectionInspector traverses the reflection tree of the inspectee and calls handler function for all fields, constructors, methods, and annotations found.

The Reflection Inspector offers two methods of exploiting the information provided:

• subclassing the inspector
• attaching a strategy to the inspector

The JUnit test class org.jsesoft.ri.TestReflectionInspector demonstrates both types of usage (below).

The interface InspectStrategy

The interface org.jsesoft.ri.InspectStrategy defines all the methods the ReflectionInspector calls during traversal of the inspectee's reflection tree. There are three kinds of such functions:

• the inspectXYZ() functions called whenever the inspector detects an element XYZ in the reflection tree (meant for doing the real work on the element). Implementations of these functions should return true whenever they completely processed an element, and false if default processing should be accomplished.
• the preInspectXYZ() functions called by the inspector before it handles the XYZ element (meant for preprocessing the element)
• the postInspectXYZ() functions called by the inspector after it handled the XYZ element (meant for postprocessing the element)

The class InspectorSupport

The class org.jsesoft.ri.InspectorSupport provides a default implementation for all the methods the ReflectionInspector calls during traversal of the inspectee's reflection tree. This default implementation simply calls the respective function of the attached strategy. If no strategy is attached, the default implementation returns immediately returning false where a return value is required (meaning that default processing should take place).

The test class TestReflectionInspector

The TestReflectionInspector demonstrates both, using the InspectorSupport class

• with an attached strategy (see testReflectionInspectorWithStrategy)
• as a subclass (see testReflectionInspectorSuclassed)

The sample annotation SampleAnnotation

This annotation provides an example of an annotation for inspection by the ReflectionInspector.

By the way, this annotation serves for full coverage of the unit test.

Related Documentation

For overviews, tutorials, examples, guides, and tool documentation, please see:

• JSESoft MMBI homepage

Since:

0.1