org.yarnandtail.andhow.property

Class QuotedSpacePreservingTrimmer

java.lang.Object

org.yarnandtail.andhow.property.QuotedSpacePreservingTrimmer

All Implemented Interfaces:

Trimmer

public class QuotedSpacePreservingTrimmer
extends Object
implements Trimmer

This trimmer trims to null and treats double quotes as whitespace preserving markers. This is the default for String Properties - Other property types should use the TrimToNullTrimmer. Whitespace is handled differently across source formats. The QuotedSpacePreservingTrimmer uses a quoted text convention that 'solves' whitespace in most situations. If, after removing all beginning and ending whitespace, the first and last characters are double quotes, those quotes are considered to be whitespace preserving string delineators. The quotes are stripped off and the string inside the quotes, including whitespace, will be preserved as the actual value. A few examples of trimming behavior, using ... to represent whitespace and :: to separate the raw value on the left from the trimmed value on the right.

• ... :: [[null]] (An all whitespace raw value is trimmed to null)
• [[null]] :: [[null]]
• ...abc... :: abc (whitespace on either side of text removed)
• "...abc..." :: ...abc... (Quotes are removed and all characters inside preserved)
• ..."...abc..."... :: ...abc... (same result - whitespace outside the quotes is removed
• ...some "words" you said... :: some "words" you said (No special quote handling here)
• ..".some "words" you said.".. :: .some "words" you said.
• .."".. :: [[Empty String]] (Using quotes, it is possible to assign an empty string)

Author:

ericeverman

Constructor Summary

Constructors

Constructor and Description
QuotedSpacePreservingTrimmer()

Method Summary

Modifier and Type	Method and Description
static QuotedSpacePreservingTrimmer	instance()
String	trim(String raw) Trims the raw string to remove whitespace

Methods inherited from class java.lang.Object

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

Constructor Detail

QuotedSpacePreservingTrimmer

public QuotedSpacePreservingTrimmer()

Method Detail

instance

public static QuotedSpacePreservingTrimmer instance()

trim

public String trim(String raw)

Description copied from interface: Trimmer

Trims the raw string to remove whitespace

Specified by:

trim in interface Trimmer

Parameters:

raw - Null and empty strings will generally return null unless noted.

Returns:

A string with whitespace removed