org.milyn.delivery

Interface ContentDeliveryConfig

All Known Implementing Classes:

AbstractContentDeliveryConfig, DOMContentDeliveryConfig, MockContentDeliveryConfig, SAXContentDeliveryConfig

public interface ContentDeliveryConfig

Content delivery configuration.

Provides access to Content Delivery Resources (e.g. Content Delivery Units) and other information for the targeted profile.

Author:

tfennelly

Field Summary

Fields

Modifier and Type	Field and Description
static String	SMOOKS_VISITORS_SORT Should Smooks sort the Visitors, targeted at each selector, based on the what the Visitors produce and consume.

Method Summary

Modifier and Type	Method and Description
void	addToExecutionLifecycleSets() Add the execution lifecycle sets for the configuration.
void	executeHandlerCleanup(ExecutionContext executionContext) Cleanup execution context lifecycle aware handlers.
void	executeHandlerInit(ExecutionContext executionContext) Initialize execution context lifecycle aware handlers.
List<ConfigBuilderEvent>	getConfigBuilderEvents() Get the list of Execution Events generated during the build of the configuration.
DTDStore.DTDObjectContainer	getDTD() Get the DTD (DTDStore.DTDObjectContainer) for this delivery context.
FilterBypass	getFilterBypass() Get the FilterBypass for this delivery configuration.
List	getObjects(String selector) Get a list of Objects from the SmooksResourceConfigurations specified by the selector.
Map<String,List<SmooksResourceConfiguration>>	getSmooksResourceConfigurations() Get the SmooksResourceConfiguration map for the target execution context.
List<SmooksResourceConfiguration>	getSmooksResourceConfigurations(String selector) Get the list of SmooksResourceConfigurations for the specified selector definition.
XMLReader	getXMLReader() Get an XMLReader instance from the reader pool associated with this ContentDelivery config instance.
boolean	isDefaultSerializationOn() Is default serialization on..
Filter	newFilter(ExecutionContext executionContext) Get a new stream filter for the content delivery configuration.
void	returnXMLReader(XMLReader reader) Return an XMLReader instance to the reader pool associated with this ContentDelivery config instance.
void	sort() Sort the Visitors, targeted at each selector, based on the what the Visitors produce and consume.

Field Detail

SMOOKS_VISITORS_SORT

static final String SMOOKS_VISITORS_SORT

Should Smooks sort the Visitors, targeted at each selector, based on the what the Visitors produce and consume. Default value "true".

See Also:

Constant Field Values

Method Detail

getSmooksResourceConfigurations

List<SmooksResourceConfiguration> getSmooksResourceConfigurations(String selector)

Get the list of SmooksResourceConfigurations for the specified selector definition.

This list will be preselected and preordered for the target execution context.

Parameters:

selector - Configuration selector. This parameter is treated case incensitively.

Returns:

List of SmooksResourceConfiguration instances, or null if no SmooksResourceConfigurations are defined under that selector (for the device).

See Also:

getObjects(String)

getSmooksResourceConfigurations

Map<String,List<SmooksResourceConfiguration>> getSmooksResourceConfigurations()

Get the SmooksResourceConfiguration map for the target execution context.

This Map will be preordered for the target execution context.

Returns:

SmooksResourceConfiguration map for the target execution context, keyed by the configuration selector, with each value being a List of preordered SmooksResourceConfiguration instances.

getObjects

List getObjects(String selector)

Get a list of Objects from the SmooksResourceConfigurations specified by the selector.

Gets the SmooksResourceConfigurations specified for the selector and attempts to instanciate a Java class instance from the resource specified by each of the SmooksResourceConfigurations.

Implementations should use SmooksResourceConfigurationStore.getObject(org.milyn.cdr.SmooksResourceConfiguration) to construct each object.

Parameters:

selector - selector attribute value from the .cdrl file in the .cdrar. This parameter is treated case incensitively.

Returns:

List of Object instances. An empty list is returned where no selectors exist.

See Also:

SmooksResourceConfigurationStore.getObject(org.milyn.cdr.SmooksResourceConfiguration), getSmooksResourceConfigurations(String)

newFilter

Filter newFilter(ExecutionContext executionContext)

Get a new stream filter for the content delivery configuration.

Parameters:

executionContext - Execution context.

Returns:

The stream filter.

getDTD

DTDStore.DTDObjectContainer getDTD()

Get the DTD (DTDStore.DTDObjectContainer) for this delivery context.

Returns:

The DTD (DTDStore.DTDObjectContainer) for this delivery context.

getConfigBuilderEvents

List<ConfigBuilderEvent> getConfigBuilderEvents()

Get the list of Execution Events generated during the build of the configuration.

Returns:

The list of events.

isDefaultSerializationOn

boolean isDefaultSerializationOn()

Is default serialization on..

Returns:

True if default serialization is on, otherwise false.

sort

void sort()
   throws SmooksConfigurationException

Sort the Visitors, targeted at each selector, based on the what the Visitors produce and consume.

Throws:

SmooksConfigurationException - Sort failure.

See Also:

SMOOKS_VISITORS_SORT

addToExecutionLifecycleSets

void addToExecutionLifecycleSets()
                          throws SmooksConfigurationException

Add the execution lifecycle sets for the configuration.

Throws:

SmooksConfigurationException - Error resolving the handlers interested in the Execution lifecycle.

executeHandlerInit

void executeHandlerInit(ExecutionContext executionContext)

Initialize execution context lifecycle aware handlers.

Parameters:

executionContext - The execution context.

executeHandlerCleanup

void executeHandlerCleanup(ExecutionContext executionContext)

Cleanup execution context lifecycle aware handlers.

Parameters:

executionContext - The execution context.

getXMLReader

XMLReader getXMLReader()
                throws SAXException

Get an XMLReader instance from the reader pool associated with this ContentDelivery config instance.

Returns:

An XMLReader instance if the pool is not empty, otherwise null.

Throws:

SAXException

returnXMLReader

void returnXMLReader(XMLReader reader)

Return an XMLReader instance to the reader pool associated with this ContentDelivery config instance.

Parameters:

reader - The XMLReader instance to be returned. If the pool is full, the instance is left to the GC (i.e. lost).

getFilterBypass

FilterBypass getFilterBypass()

Get the FilterBypass for this delivery configuration.

Returns:

The FilterBypass for this delivery configuration, or null if non configured.