Package org.springframework.extensions.surf.extensibility

Interface ExtensibilityModel

All Known Implementing Classes:

ExtensibilityModelImpl

public interface ExtensibilityModel

Method Summary

Modifier and Type	Method	Description
void	addDiscardContent()	Add a new DiscardUnboundContentModelElementImpl into the model so that when content is rendered it will be discarded.
void	addUnboundContent()	Add a new UnboundContentModelElementImpl into the model so that when content is rendered it will be kept but will not be available to extensions to modify.
void	after(ExtensibilityDirectiveData directive)	Places content in the modell after some base content.
void	before(ExtensibilityDirectiveData directive)	Places content in the model before some base content.
boolean	clearRelocatedContent(java.lang.String id, java.lang.String directiveName)
ContentModelElement	findContentModelElement(java.lang.String id)	Finds a specific ContentModelElement (with the supplied identifier) in the model.
void	flushModel(java.io.Writer out)	Flushes the entire content of the model to the supplied Writer.
java.util.List<ExtensibilityModelElement>	getAdditionalContentElements()	Retrieves the list of elements being generated as part of extension processing.
ExtensibilityDebugData	getChildDebugData()
ExtensibilityDebugData	getDebugData()
DeferredContentTargetModelElement	getDeferredContent(java.lang.String directiveId, java.lang.String directiveName)
ExtensibilityModel	getParentModel()	Gets the ExtensibilityModel enclosing this model (assuming that this model is nested within a parent).
ModelWriter	getWriter()	Gets the ModelWriter being used by this instance.
void	insertDeferredContentTarget(int index, OpenModelElement open, DeferredContentTargetModelElement target, CloseModelElement close)	Allows DeferredContentTargetModelElement instances (along with their associated OpenModelElement and CloseModelElement instances) to be inserted at a requested point in the model.
boolean	isExtensionProcessing()	Indicates whether the base model is complete and extensions are now being processed.
boolean	isModelStarted()	Indicates whether or not the has been started.
void	merge(ExtensibilityDirectiveData directive)	Places new content in the base model.
void	remove(ExtensibilityDirectiveData directive)	Removes content from the model.
void	replace(ExtensibilityDirectiveData directive)	Replaces content in the model.
void	setChildDebugData(ExtensibilityDebugData childData)	Sets the ExtensibilityDebugData associated with the nested child ExtensibilityModel.
void	switchToExtensionProcessing()	Switches from defining the base model to processing extensions.

Method Detail

isModelStarted

boolean isModelStarted()

Indicates whether or not the has been started.

Returns:

boolean

switchToExtensionProcessing

void switchToExtensionProcessing()

Switches from defining the base model to processing extensions. When extension processing the "merge" action can no longer be used but the "remove", "replace", "modify", "before" and "after" actions can be.

isExtensionProcessing

boolean isExtensionProcessing()

Indicates whether the base model is complete and extensions are now being processed. Extension processing commences once the switchToExtensionProcessing method has been called. When extension processing the "merge" action can no longer be used but the "remove", "replace", "modify", "before" and "after" actions can be.

Returns:

boolean

getParentModel

ExtensibilityModel getParentModel()

Gets the ExtensibilityModel enclosing this model (assuming that this model is nested within a parent).

Returns:

The enclosing ExtensibilityModel if the current model is nested and null otherwise.

getWriter

ModelWriter getWriter()

Gets the ModelWriter being used by this instance.

Returns:

ModelWriter

flushModel

void flushModel(java.io.Writer out)

Flushes the entire content of the model to the supplied Writer. Once this has been done it will no longer be possible to update the model.

Parameters:

out - A Writer to render the model to.

addUnboundContent

void addUnboundContent()

Add a new UnboundContentModelElementImpl into the model so that when content is rendered it will be kept but will not be available to extensions to modify. This is used when processing the content in base files that is not provided by an ExtensibilityDirective.

addDiscardContent

void addDiscardContent()

Add a new DiscardUnboundContentModelElementImpl into the model so that when content is rendered it will be discarded. This is used when extension files are processed that contain "unbounded" content (that is content that is not provided by an ExtensibilityDirective).

getDeferredContent

DeferredContentTargetModelElement getDeferredContent(java.lang.String directiveId,
                                                     java.lang.String directiveName)

clearRelocatedContent

boolean clearRelocatedContent(java.lang.String id,
                              java.lang.String directiveName)

remove

void remove(ExtensibilityDirectiveData directive)
     throws freemarker.template.TemplateException,
            java.io.IOException

Removes content from the model.

Parameters:

directive - ExtensibilityDirectiveData

Throws:

freemarker.template.TemplateException

java.io.IOException

replace

void replace(ExtensibilityDirectiveData directive)
      throws freemarker.template.TemplateException,
             java.io.IOException

Replaces content in the model.

Parameters:

directive - ExtensibilityDirectiveData

Throws:

freemarker.template.TemplateException

java.io.IOException

merge

void merge(ExtensibilityDirectiveData directive)
    throws freemarker.template.TemplateException,
           java.io.IOException

Places new content in the base model.

Parameters:

directive - ExtensibilityDirectiveData

Throws:

freemarker.template.TemplateException

java.io.IOException

before

void before(ExtensibilityDirectiveData directive)
     throws freemarker.template.TemplateException,
            java.io.IOException

Places content in the model before some base content.

Parameters:

directive - ExtensibilityDirectiveData

Throws:

freemarker.template.TemplateException

java.io.IOException

after

void after(ExtensibilityDirectiveData directive)
    throws freemarker.template.TemplateException,
           java.io.IOException

Places content in the modell after some base content.

Parameters:

directive - ExtensibilityDirectiveData

Throws:

freemarker.template.TemplateException

java.io.IOException

findContentModelElement

ContentModelElement findContentModelElement(java.lang.String id)

Finds a specific ContentModelElement (with the supplied identifier) in the model.

Parameters:

id - String

Returns:

ContentModelElement

getDebugData

ExtensibilityDebugData getDebugData()

Returns:

The ExtensibilityDebugData associated with the ExtensibilityModel.

getChildDebugData

ExtensibilityDebugData getChildDebugData()

Returns:

The ExtensibilityDebugData associated with the nested child ExtensibilityModel.

setChildDebugData

void setChildDebugData(ExtensibilityDebugData childData)

Sets the ExtensibilityDebugData associated with the nested child ExtensibilityModel.

getAdditionalContentElements

java.util.List<ExtensibilityModelElement> getAdditionalContentElements()

Retrieves the list of elements being generated as part of extension processing.

Returns:

List

insertDeferredContentTarget

void insertDeferredContentTarget(int index,
                                 OpenModelElement open,
                                 DeferredContentTargetModelElement target,
                                 CloseModelElement close)

Allows DeferredContentTargetModelElement instances (along with their associated OpenModelElement and CloseModelElement instances) to be inserted at a requested point in the model. This facility should be used with extreme care and was provided to allow WebScripts run outside of the context of a page to process dependencies.

Parameters:

index - The index within the model to insert the elements

open - The OpenModelElement that identifies the start of the content

target - The DeferredContentTargetModelElement for adding deferred content into

close - The CloseModelElement that identifies the end of the content