org.codehaus.plexus.interpolation.multi
Class MultiDelimiterStringSearchInterpolator

java.lang.Object
  extended by org.codehaus.plexus.interpolation.multi.MultiDelimiterStringSearchInterpolator
All Implemented Interfaces:
Interpolator

public class MultiDelimiterStringSearchInterpolator
extends Object
implements Interpolator


Constructor Summary
MultiDelimiterStringSearchInterpolator()
           
 
Method Summary
 MultiDelimiterStringSearchInterpolator addDelimiterSpec(String delimiterSpec)
           
 void addPostProcessor(InterpolationPostProcessor postProcessor)
          Add a new post-processor to handle final processing after recursively-interpolated value is determined.
 void addValueSource(ValueSource valueSource)
          Add a new ValueSource to the stack used to resolve expressions in this interpolator instance.
 void clearAnswers()
           
 void clearFeedback()
          Clear the feedback messages from previous interpolate(..) calls.
 String getEscapeString()
           
 List getFeedback()
          Return any feedback messages and errors that were generated - but suppressed - during the interpolation process.
 String interpolate(String input)
          See Interpolator.interpolate(String, String, RecursionInterceptor).
 String interpolate(String input, RecursionInterceptor recursionInterceptor)
          Entry point for recursive resolution of an expression and all of its nested expressions.
 String interpolate(String input, String thisPrefixPattern)
          See Interpolator.interpolate(String, String, RecursionInterceptor).
 String interpolate(String input, String thisPrefixPattern, RecursionInterceptor recursionInterceptor)
          Attempt to resolve all expressions in the given input string, using the given pattern to first trim an optional prefix from each expression.
 boolean isCacheAnswers()
           
 boolean removeDelimiterSpec(String delimiterSpec)
           
 void removePostProcessor(InterpolationPostProcessor postProcessor)
          Remove the given post-processor.
 void removeValuesSource(ValueSource valueSource)
          Remove the specified ValueSource from the stack used to resolve expressions in this interpolator instance.
 void setCacheAnswers(boolean cacheAnswers)
           
 MultiDelimiterStringSearchInterpolator setDelimiterSpecs(LinkedHashSet specs)
           
 void setEscapeString(String escapeString)
           
 MultiDelimiterStringSearchInterpolator withPostProcessor(InterpolationPostProcessor postProcessor)
           
 MultiDelimiterStringSearchInterpolator withValueSource(ValueSource vs)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

MultiDelimiterStringSearchInterpolator

public MultiDelimiterStringSearchInterpolator()
Method Detail

addDelimiterSpec

public MultiDelimiterStringSearchInterpolator addDelimiterSpec(String delimiterSpec)

removeDelimiterSpec

public boolean removeDelimiterSpec(String delimiterSpec)

withValueSource

public MultiDelimiterStringSearchInterpolator withValueSource(ValueSource vs)

withPostProcessor

public MultiDelimiterStringSearchInterpolator withPostProcessor(InterpolationPostProcessor postProcessor)

addValueSource

public void addValueSource(ValueSource valueSource)
Add a new ValueSource to the stack used to resolve expressions in this interpolator instance.

Specified by:
addValueSource in interface Interpolator

removeValuesSource

public void removeValuesSource(ValueSource valueSource)
Remove the specified ValueSource from the stack used to resolve expressions in this interpolator instance.

Specified by:
removeValuesSource in interface Interpolator

addPostProcessor

public void addPostProcessor(InterpolationPostProcessor postProcessor)
Add a new post-processor to handle final processing after recursively-interpolated value is determined.

Specified by:
addPostProcessor in interface Interpolator

removePostProcessor

public void removePostProcessor(InterpolationPostProcessor postProcessor)
Remove the given post-processor.

Specified by:
removePostProcessor in interface Interpolator

interpolate

public String interpolate(String input,
                          String thisPrefixPattern)
                   throws InterpolationException
Description copied from interface: Interpolator
See Interpolator.interpolate(String, String, RecursionInterceptor).
This method triggers the use of a SimpleRecursionInterceptor instance for protection against expression cycles.

Specified by:
interpolate in interface Interpolator
Parameters:
input - The input string to interpolate
thisPrefixPattern - An optional pattern that should be trimmed from the start of any expressions found in the input.
Throws:
InterpolationException

interpolate

public String interpolate(String input,
                          String thisPrefixPattern,
                          RecursionInterceptor recursionInterceptor)
                   throws InterpolationException
Description copied from interface: Interpolator
Attempt to resolve all expressions in the given input string, using the given pattern to first trim an optional prefix from each expression. The supplied recursion interceptor will provide protection from expression cycles, ensuring that the input can be resolved or an exception is thrown. return an empty String if input is null

Specified by:
interpolate in interface Interpolator
Parameters:
input - The input string to interpolate
thisPrefixPattern - An optional pattern that should be trimmed from the start of any expressions found in the input.
recursionInterceptor - Used to protect the interpolation process from expression cycles, and throw an exception if one is detected.
Throws:
InterpolationException

interpolate

public String interpolate(String input)
                   throws InterpolationException
Description copied from interface: Interpolator
See Interpolator.interpolate(String, String, RecursionInterceptor).
This method triggers the use of a SimpleRecursionInterceptor instance for protection against expression cycles. It also leaves empty the expression prefix which would otherwise be trimmed from expressions. The result is that any detected expression will be resolved as-is.

Specified by:
interpolate in interface Interpolator
Parameters:
input - The input string to interpolate
Throws:
InterpolationException

interpolate

public String interpolate(String input,
                          RecursionInterceptor recursionInterceptor)
                   throws InterpolationException
Entry point for recursive resolution of an expression and all of its nested expressions.

Specified by:
interpolate in interface Interpolator
Parameters:
input - The input string to interpolate
recursionInterceptor - Used to protect the interpolation process from expression cycles, and throw an exception if one is detected.
Throws:
InterpolationException

getFeedback

public List getFeedback()
Return any feedback messages and errors that were generated - but suppressed - during the interpolation process. Since unresolvable expressions will be left in the source string as-is, this feedback is optional, and will only be useful for debugging interpolation problems.

Specified by:
getFeedback in interface Interpolator
Returns:
a List that may be interspersed with String and Throwable instances.

clearFeedback

public void clearFeedback()
Clear the feedback messages from previous interpolate(..) calls.

Specified by:
clearFeedback in interface Interpolator

isCacheAnswers

public boolean isCacheAnswers()
Specified by:
isCacheAnswers in interface Interpolator

setCacheAnswers

public void setCacheAnswers(boolean cacheAnswers)
Specified by:
setCacheAnswers in interface Interpolator

clearAnswers

public void clearAnswers()
Specified by:
clearAnswers in interface Interpolator

getEscapeString

public String getEscapeString()

setEscapeString

public void setEscapeString(String escapeString)

setDelimiterSpecs

public MultiDelimiterStringSearchInterpolator setDelimiterSpecs(LinkedHashSet specs)


Copyright © 2001-2011 Codehaus. All Rights Reserved.