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

Class TemplatedExecutableStatementBuilder

java.lang.Object
net.shibboleth.shared.component.AbstractInitializableComponent
net.shibboleth.idp.attribute.resolver.dc.rdbms.AbstractExecutableStatementBuilder
net.shibboleth.idp.attribute.resolver.dc.rdbms.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.

  • Field Details

    • log

      private final org.slf4j.Logger log
      Class logger.

    • template

      @NonnullAfterInit private Template template
      Template to be evaluated.

    • templateText

      @NonnullAfterInit private String templateText
      Template (as Text) to be evaluated.

    • engine

      @NonnullAfterInit private org.apache.velocity.app.VelocityEngine engine
      VelocityEngine.

    • eventHandler

      @Nullable private org.apache.velocity.app.event.ReferenceInsertionEventHandler eventHandler
      Event handler used for escaping.

    • v2Compatibility

      private boolean v2Compatibility
      Do we need to make ourself V2 Compatible?

  • Constructor Details

    • TemplatedExecutableStatementBuilder

      public TemplatedExecutableStatementBuilder()

  • Method Details

    • 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 org.apache.velocity.app.VelocityEngine getVelocityEngine()
      Gets the VelocityEngine to be used.
      Returns:
      the template

    • setVelocityEngine

      public void setVelocityEngine(@Nonnull org.apache.velocity.app.VelocityEngine velocityEngine)
      Sets the VelocityEngine to be used.
      Parameters:
      velocityEngine - engine to be used

    • getReferenceInsertionEventHandler

      @Nullable public org.apache.velocity.app.event.ReferenceInsertionEventHandler getReferenceInsertionEventHandler()
      Gets the ReferenceInsertionEventHandler to be used.
      Returns:
      the reference insertion event handler

    • setReferenceInsertionEventHandler

      public void setReferenceInsertionEventHandler(@Nullable org.apache.velocity.app.event.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.

    • doInitialize

      protected void doInitialize() throws ComponentInitializationException
      Overrides:
      doInitialize in class AbstractInitializableComponent
      Throws:
      ComponentInitializationException

    • merge

      @Nonnull protected String merge(@Nonnull org.apache.velocity.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

      @Nonnull public final 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.

    • addExtraVelocityContext

      protected void addExtraVelocityContext(@Nonnull org.apache.velocity.VelocityContext velocityContext, @Nonnull AttributeResolutionContext resolutionContext)
      Method to allow private additions to the velocity context.
      Parameters:
      velocityContext - where to add the information
      resolutionContext - current resolution context