net.shibboleth.idp.attribute.resolver.dc.rdbms.impl

Class TemplatedExecutableStatementBuilder

java.lang.Object

net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

net.shibboleth.idp.attribute.resolver.dc.rdbms.impl.AbstractExecutableStatementBuilder

net.shibboleth.idp.attribute.resolver.dc.rdbms.impl.TemplatedExecutableStatementBuilder

All Implemented Interfaces:

ExecutableSearchBuilder<ExecutableStatement>, Component, DestructableComponent, InitializableComponent

public class TemplatedExecutableStatementBuilder
extends AbstractExecutableStatementBuilder

An ExecutableSearchBuilder that generates the SQL statement to be executed by evaluating a Template against the currently resolved attributes within a AttributeResolutionContext.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	TemplatedExecutableStatementBuilder.EscapingReferenceInsertionEventHandler Escapes SQL values added to the template context.

Field Summary

Fields

Modifier and Type	Field and Description
private VelocityEngine	engine VelocityEngine.
private ReferenceInsertionEventHandler	eventHandler Event handler used for escaping.
private org.slf4j.Logger	log Class logger.
private Template	template Template to be evaluated.
private String	templateText Template (as Text) to be evaluated.
private boolean	v2Compatibility Do we need to make ourself V2 Compatible?

Constructor Summary

Constructors

Constructor and Description
TemplatedExecutableStatementBuilder()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doInitialize()
ReferenceInsertionEventHandler	getReferenceInsertionEventHandler() Gets the ReferenceInsertionEventHandler to be used.
protected String	getSQLQuery(AttributeResolutionContext resolutionContext, Map<String,List<IdPAttributeValue<?>>> dependencyAttributes) Apply the context to the template.
Template	getTemplate() Gets the template to be evaluated.
String	getTemplateText() Gets the template text to be evaluated.
VelocityEngine	getVelocityEngine() Gets the VelocityEngine to be used.
boolean	isV2Compatibility() Are we in V2 Compatibility mode?
protected String	merge(VelocityContext context) Invokes Template.merge(org.apache.velocity.context.Context) on the supplied context.
void	setReferenceInsertionEventHandler(ReferenceInsertionEventHandler handler) Sets the ReferenceInsertionEventHandler to be used.
void	setTemplateText(String velocityTemplate) Sets the template to be evaluated.
void	setV2Compatibility(boolean compat) What is out V2 Compatibility mode.
void	setVelocityEngine(VelocityEngine velocityEngine) Sets the VelocityEngine to be used.

Methods inherited from class net.shibboleth.idp.attribute.resolver.dc.rdbms.impl.AbstractExecutableStatementBuilder

build, getQueryTimeout, setQueryTimeout

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

destroy, doDestroy, initialize, isDestroyed, isInitialized

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

log

private final org.slf4j.Logger log

Class logger.

template

private Template template

Template to be evaluated.

templateText

private String templateText

Template (as Text) to be evaluated.

engine

private VelocityEngine engine

VelocityEngine.

eventHandler

private ReferenceInsertionEventHandler eventHandler

Event handler used for escaping.

v2Compatibility

private boolean v2Compatibility

Do we need to make ourself V2 Compatible?

Constructor Detail

TemplatedExecutableStatementBuilder

public TemplatedExecutableStatementBuilder()

Method Detail

getTemplate

@NonnullAfterInit
public Template getTemplate()

Gets the template to be evaluated.

Returns:

the template

getTemplateText

@NonnullAfterInit
public String getTemplateText()

Gets the template text to be evaluated.

Returns:

the template text

setTemplateText

public void setTemplateText(@Nullable
                   String velocityTemplate)

Sets the template to be evaluated.

Parameters:

velocityTemplate - template to be evaluated

getVelocityEngine

@Nullable
@NonnullAfterInit
public VelocityEngine getVelocityEngine()

Gets the VelocityEngine to be used.

Returns:

the template

setVelocityEngine

public void setVelocityEngine(@Nonnull
                     VelocityEngine velocityEngine)

Sets the VelocityEngine to be used.

Parameters:

velocityEngine - engine to be used

getReferenceInsertionEventHandler

@Nullable
public ReferenceInsertionEventHandler getReferenceInsertionEventHandler()

Gets the ReferenceInsertionEventHandler to be used.

Returns:

the reference insertion event handler

setReferenceInsertionEventHandler

public void setReferenceInsertionEventHandler(@Nullable
                                     ReferenceInsertionEventHandler handler)

Sets the ReferenceInsertionEventHandler to be used.

Parameters:

handler - reference insertion event handler to be used

isV2Compatibility

public boolean isV2Compatibility()

Are we in V2 Compatibility mode?

Returns:

Returns the v2Compat.

setV2Compatibility

public void setV2Compatibility(boolean compat)

What is out V2 Compatibility mode.

Parameters:

compat - The mode to set.

merge

protected String merge(@Nonnull
           VelocityContext context)

Invokes Template.merge(org.apache.velocity.context.Context) on the supplied context.

Parameters:

context - to merge

Returns:

result of the merge operation

getSQLQuery

protected String getSQLQuery(@Nonnull
                 AttributeResolutionContext resolutionContext,
                 @Nonnull
                 Map<String,List<IdPAttributeValue<?>>> dependencyAttributes)
                      throws ResolutionException

Apply the context to the template. Method to return the query SQL.

Specified by:

getSQLQuery in class AbstractExecutableStatementBuilder

Parameters:

resolutionContext - the context of the resolution

dependencyAttributes - made available to the executable search

Returns:

the SQL string

Throws:

ResolutionException - if we get an error building the exception.

doInitialize

protected void doInitialize()
                     throws ComponentInitializationException

Overrides:

doInitialize in class AbstractInitializableComponent

Throws:

ComponentInitializationException