org.metawidget.inspector.impl.propertystyle.PropertyStyle Maven / Gradle / Ivy
// Metawidget
//
// This file is dual licensed under both the LGPL
// (http://www.gnu.org/licenses/lgpl-2.1.html) and the EPL
// (http://www.eclipse.org/org/documents/epl-v10.php). As a
// recipient of Metawidget, you may choose to receive it under either
// the LGPL or the EPL.
//
// Commercial licenses are also available. See http://metawidget.org
// for details.
package org.metawidget.inspector.impl.propertystyle;
import java.util.Map;
import org.metawidget.iface.Immutable;
/**
* Abstraction layer for retrieving properties from types.
*
* Different environments have different approaches to defining what constitutes a 'property'. For
* example, JavaBean-properties are convention-based, whereas Groovy has explicit property support.
* Equally, some environments may have framework-specific, base class properties that should be
* filtered out and excluded from the list of 'real' business model properties (eg. Struts
* ActionForms). Finally, some environments may define properties against something
* other than a java.lang.Class (eg. javassist.CtClass or
* org.jboss.forge.parser.java.JavaClass).
*
* PropertyStyles must be immutable (or, at least, appear that way to clients. They can
* have caches or configuration settings internally, as long as they are threadsafe).
*
* @author Richard Kennard
*/
public interface PropertyStyle
extends Immutable {
//
// Methods
//
/**
* Gets the Properties for the given type.
*
* Properties must be returned using a consistent ordering, so that both unit tests and
* CompositeInspector merging is consistent. If the underlying technology does not
* define an ordering, one must be imposed (eg. sorted alphabetically by name), even though this
* may later be overridden by other mechanisms (eg.
* ComesAfterInspectionResultProcessor sorts by comes-after).
*
* @return the properties for the given type. Never null.
*/
Map getProperties( String type );
/**
* Traverses the given Object heirarchy using properties of the given names.
*
* @return the Object (may be null) and its declared type (not actual type). Never null.
* If the declared type within the ValueAndDeclaredType is null, inspection will be
* aborted
*/
ValueAndDeclaredType traverse( Object toTraverse, String type, boolean onlyToParent, String... names );
}