Package org.xmlunit.placeholder

Class PlaceholderSupport

java.lang.Object

org.xmlunit.placeholder.PlaceholderSupport

public class PlaceholderSupport
extends java.lang.Object

Adds support for the placeholder feature to a DifferenceEngineConfigurer - like DiffBuilder or org.xmlunit.matchers.CompareMatcher.

This class and the whole module are considered experimental and any API may change between releases of XMLUnit.

Since:

2.6.0

Method Summary

Modifier and Type	Method	Description
static <D extends org.xmlunit.builder.DifferenceEngineConfigurer<D>> D	withPlaceholderSupport(D configurer)	Adds placeholder support to a DifferenceEngineConfigurer.
static <D extends org.xmlunit.builder.DifferenceEngineConfigurer<D>> D	withPlaceholderSupportChainedAfter(D configurer, org.xmlunit.diff.DifferenceEvaluator evaluator)	Adds placeholder support to a DifferenceEngineConfigurer considering an additional DifferenceEvaluator.
static <D extends org.xmlunit.builder.DifferenceEngineConfigurer<D>> D	withPlaceholderSupportUsingDelimiters(D configurer, java.lang.String placeholderOpeningDelimiterRegex, java.lang.String placeholderClosingDelimiterRegex)	Adds placeholder support to a DifferenceEngineConfigurer.
static <D extends org.xmlunit.builder.DifferenceEngineConfigurer<D>> D	withPlaceholderSupportUsingDelimiters(D configurer, java.lang.String placeholderOpeningDelimiterRegex, java.lang.String placeholderClosingDelimiterRegex, java.lang.String placeholderArgsOpeningDelimiterRegex, java.lang.String placeholderArgsClosingDelimiterRegex, java.lang.String placeholderArgsSeparatorRegex)	Adds placeholder support to a DifferenceEngineConfigurer.
static <D extends org.xmlunit.builder.DifferenceEngineConfigurer<D>> D	withPlaceholderSupportUsingDelimitersChainedAfter(D configurer, java.lang.String placeholderOpeningDelimiterRegex, java.lang.String placeholderClosingDelimiterRegex, java.lang.String placeholderArgsOpeningDelimiterRegex, java.lang.String placeholderArgsClosingDelimiterRegex, java.lang.String placeholderArgsSeparatorRegex, org.xmlunit.diff.DifferenceEvaluator evaluator)	Adds placeholder support to a DifferenceEngineConfigurer considering an additional DifferenceEvaluator.
static <D extends org.xmlunit.builder.DifferenceEngineConfigurer<D>> D	withPlaceholderSupportUsingDelimitersChainedAfter(D configurer, java.lang.String placeholderOpeningDelimiterRegex, java.lang.String placeholderClosingDelimiterRegex, org.xmlunit.diff.DifferenceEvaluator evaluator)	Adds placeholder support to a DifferenceEngineConfigurer considering an additional DifferenceEvaluator.

Methods inherited from class java.lang.Object

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

Method Detail

withPlaceholderSupport

public static <D extends org.xmlunit.builder.DifferenceEngineConfigurer<D>> D withPlaceholderSupport(D configurer)

Adds placeholder support to a DifferenceEngineConfigurer.

This overwrites any DifferenceEvaluator set via earlier invocations of withDifferenceEvaluator.

Type Parameters:

D - type of configurer

Parameters:

configurer - the configurer to add support to

Returns:

the configurer with placeholder support added in

withPlaceholderSupportUsingDelimiters

public static <D extends org.xmlunit.builder.DifferenceEngineConfigurer<D>> D withPlaceholderSupportUsingDelimiters(D configurer,
                                                                                                                    java.lang.String placeholderOpeningDelimiterRegex,
                                                                                                                    java.lang.String placeholderClosingDelimiterRegex)

Adds placeholder support to a DifferenceEngineConfigurer.

This overwrites any DifferenceEvaluator set via earlier invocations of withDifferenceEvaluator.

Type Parameters:

D - type of configurer

Parameters:

configurer - the configurer to add support to

placeholderOpeningDelimiterRegex - regular expression for the opening delimiter of placeholder, defaults to PlaceholderDifferenceEvaluator.PLACEHOLDER_DEFAULT_OPENING_DELIMITER_REGEX if the parameter is null or blank

placeholderClosingDelimiterRegex - regular expression for the closing delimiter of placeholder, defaults to PlaceholderDifferenceEvaluator.PLACEHOLDER_DEFAULT_CLOSING_DELIMITER_REGEX if the parameter is null or blank

Returns:

the configurer with placeholder support added in

withPlaceholderSupportUsingDelimiters

public static <D extends org.xmlunit.builder.DifferenceEngineConfigurer<D>> D withPlaceholderSupportUsingDelimiters(D configurer,
                                                                                                                    java.lang.String placeholderOpeningDelimiterRegex,
                                                                                                                    java.lang.String placeholderClosingDelimiterRegex,
                                                                                                                    java.lang.String placeholderArgsOpeningDelimiterRegex,
                                                                                                                    java.lang.String placeholderArgsClosingDelimiterRegex,
                                                                                                                    java.lang.String placeholderArgsSeparatorRegex)

Adds placeholder support to a DifferenceEngineConfigurer.

This overwrites any DifferenceEvaluator set via earlier invocations of withDifferenceEvaluator.

Type Parameters:

D - type of configurer

Parameters:

configurer - the configurer to add support to

placeholderOpeningDelimiterRegex - regular expression for the opening delimiter of placeholder, defaults to PlaceholderDifferenceEvaluator.PLACEHOLDER_DEFAULT_OPENING_DELIMITER_REGEX if the parameter is null or blank

placeholderClosingDelimiterRegex - regular expression for the closing delimiter of placeholder, defaults to PlaceholderDifferenceEvaluator.PLACEHOLDER_DEFAULT_CLOSING_DELIMITER_REGEX if the parameter is null or blank

placeholderArgsOpeningDelimiterRegex - regular expression for the opening delimiter of the placeholder's argument list, defaults to PlaceholderDifferenceEvaluator.PLACEHOLDER_DEFAULT_ARGS_OPENING_DELIMITER_REGEX if the parameter is null or blank

placeholderArgsClosingDelimiterRegex - regular expression for the closing delimiter of the placeholder's argument list, defaults to PlaceholderDifferenceEvaluator.PLACEHOLDER_DEFAULT_ARGS_CLOSING_DELIMITER_REGEX if the parameter is null or blank

placeholderArgsSeparatorRegex - regular expression for the delimiter between arguments inside of the placeholder's argument list, defaults to PlaceholderDifferenceEvaluator.PLACEHOLDER_DEFAULT_ARGS_SEPARATOR_REGEX if the parameter is null or blank

Returns:

the configurer with placeholder support added in

Since:

2.7.0

withPlaceholderSupportChainedAfter

public static <D extends org.xmlunit.builder.DifferenceEngineConfigurer<D>> D withPlaceholderSupportChainedAfter(D configurer,
                                                                                                                 org.xmlunit.diff.DifferenceEvaluator evaluator)

Adds placeholder support to a DifferenceEngineConfigurer considering an additional DifferenceEvaluator.

This overwrites any DifferenceEvaluator set via earlier invocations of withDifferenceEvaluator.

Type Parameters:

D - type of configurer

Parameters:

configurer - the configurer to add support to

evaluator - the additional evaluator - placeholder support is chained after the given evaluator

Returns:

the configurer with placeholder support added in

withPlaceholderSupportUsingDelimitersChainedAfter

public static <D extends org.xmlunit.builder.DifferenceEngineConfigurer<D>> D withPlaceholderSupportUsingDelimitersChainedAfter(D configurer,
                                                                                                                                java.lang.String placeholderOpeningDelimiterRegex,
                                                                                                                                java.lang.String placeholderClosingDelimiterRegex,
                                                                                                                                org.xmlunit.diff.DifferenceEvaluator evaluator)

Adds placeholder support to a DifferenceEngineConfigurer considering an additional DifferenceEvaluator.

This overwrites any DifferenceEvaluator set via earlier invocations of withDifferenceEvaluator.

Type Parameters:

D - type of configurer

Parameters:

configurer - the configurer to add support to

placeholderOpeningDelimiterRegex - regular expression for the opening delimiter of placeholder, defaults to PlaceholderDifferenceEvaluator.PLACEHOLDER_DEFAULT_OPENING_DELIMITER_REGEX if the parameter is null or blank

placeholderClosingDelimiterRegex - regular expression for the closing delimiter of placeholder, defaults to PlaceholderDifferenceEvaluator.PLACEHOLDER_DEFAULT_CLOSING_DELIMITER_REGEX if the parameter is null or blank

evaluator - the additional evaluator - placeholder support is chained after the given evaluator

Returns:

the configurer with placeholder support added in

withPlaceholderSupportUsingDelimitersChainedAfter

public static <D extends org.xmlunit.builder.DifferenceEngineConfigurer<D>> D withPlaceholderSupportUsingDelimitersChainedAfter(D configurer,
                                                                                                                                java.lang.String placeholderOpeningDelimiterRegex,
                                                                                                                                java.lang.String placeholderClosingDelimiterRegex,
                                                                                                                                java.lang.String placeholderArgsOpeningDelimiterRegex,
                                                                                                                                java.lang.String placeholderArgsClosingDelimiterRegex,
                                                                                                                                java.lang.String placeholderArgsSeparatorRegex,
                                                                                                                                org.xmlunit.diff.DifferenceEvaluator evaluator)

Adds placeholder support to a DifferenceEngineConfigurer considering an additional DifferenceEvaluator.

This overwrites any DifferenceEvaluator set via earlier invocations of withDifferenceEvaluator.

Type Parameters:

D - type of configurer

Parameters:

configurer - the configurer to add support to

placeholderOpeningDelimiterRegex - regular expression for the opening delimiter of placeholder, defaults to PlaceholderDifferenceEvaluator.PLACEHOLDER_DEFAULT_OPENING_DELIMITER_REGEX if the parameter is null or blank

placeholderClosingDelimiterRegex - regular expression for the closing delimiter of placeholder, defaults to PlaceholderDifferenceEvaluator.PLACEHOLDER_DEFAULT_CLOSING_DELIMITER_REGEX if the parameter is null or blank

evaluator - the additional evaluator - placeholder support is chained after the given evaluator

placeholderArgsOpeningDelimiterRegex - regular expression for the opening delimiter of the placeholder's argument list, defaults to PlaceholderDifferenceEvaluator.PLACEHOLDER_DEFAULT_ARGS_OPENING_DELIMITER_REGEX if the parameter is null or blank

placeholderArgsClosingDelimiterRegex - regular expression for the closing delimiter of the placeholder's argument list, defaults to PlaceholderDifferenceEvaluator.PLACEHOLDER_DEFAULT_ARGS_CLOSING_DELIMITER_REGEX if the parameter is null or blank

placeholderArgsSeparatorRegex - regular expression for the delimiter between arguments inside of the placeholder's argument list, defaults to PlaceholderDifferenceEvaluator.PLACEHOLDER_DEFAULT_ARGS_SEPARATOR_REGEX if the parameter is null or blank

Returns:

the configurer with placeholder support added in