org.apache.cocoon.components.source
Interface SourceInspector

All Known Subinterfaces:

SourceDescriptor

All Known Implementing Classes:

AbstractConfigurableSourceDescriptor, AbstractConfigurableSourceInspector, AbstractImageSourceInspector, SimpleJdbcSourceDescriptor, SourceDescriptorManager, XPathSourceInspector

public interface SourceInspector

A source inspector exposes source properties.

Version:

CVS $Id: SourceInspector.java 55389 2004-10-23 15:46:58Z cziegeler $

Author:

Stephan Michels, Unico Hommes

Field Summary

static String

ROLE

Method Summary

SourceProperty[]	getSourceProperties(Source source) Gets all the SourceProperties associated with the given Source.
SourceProperty	getSourceProperty(Source source, String namespace, String name) Gets the SourceProperty associated with the given Source identified by the requested namespace and name.
SourceValidity	getValidity(Source source) Get the validity object that describes the validity state of the properties belonging to the given source.
boolean	handlesProperty(String namespace, String name) Check if this inspector handles the property of the given type.

Field Detail

ROLE

public static final String ROLE

Method Detail

getSourceProperty

public SourceProperty getSourceProperty(Source source,
                                        String namespace,
                                        String name)
                                 throws SourceException

Gets the SourceProperty associated with the given Source identified by the requested namespace and name.

Parameters:

source - the source for which to compute the property

namespace - the namespace of the property

name - the name of the property

Returns:

the SourceProperty associated with the Source, null if the inspector does not provide this property.

Throws:

SourceException

getSourceProperties

public SourceProperty[] getSourceProperties(Source source)
                                     throws SourceException

Gets all the SourceProperties associated with the given Source.

Parameters:

source - the Source for wich to compute the property.

Returns:

the collection of all SourceProperties that could be computed by this SourceInspector.

Throws:

SourceException

handlesProperty

public boolean handlesProperty(String namespace,
                               String name)

Check if this inspector handles the property of the given type.

Parameters:

namespace - the namespace of the property

name - the name of the property

Returns:

true if this inspector handles properties of the given type else false.

getValidity

public SourceValidity getValidity(Source source)

Get the validity object that describes the validity state of the properties belonging to the given source.

Parameters:

source - the Source for which to calculate the validity its properties, null if the source properties are not cacheable.