001// Copyright 2004, 2005 The Apache Software Foundation
002//
003// Licensed under the Apache License, Version 2.0 (the "License");
004// you may not use this file except in compliance with the License.
005// You may obtain a copy of the License at
006//
007//     http://www.apache.org/licenses/LICENSE-2.0
008//
009// Unless required by applicable law or agreed to in writing, software
010// distributed under the License is distributed on an "AS IS" BASIS,
011// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
012// See the License for the specific language governing permissions and
013// limitations under the License.
014
015package org.apache.tapestry.util.text;
016
017/**
018 * Matches a whitespace character.
019 * 
020 * @author mb
021 * @since 4.0
022 */
023public class WhitespaceMatcher implements ICharacterMatcher 
024{
025    private boolean _matchEndLines;
026    
027    /**
028     * Creates an object that matches all whitespace characters, line terminators included
029     */
030    public WhitespaceMatcher()
031    {
032        this(true);
033    }
034    
035    /**
036     * Creates an object that matches whitespace characters. 
037     * Line terminators are included only if this is specified.
038     * 
039     * @param matchEndLines match line terminators as well
040     */
041    public WhitespaceMatcher(boolean matchEndLines)
042    {
043        _matchEndLines = matchEndLines;
044    }
045    
046    /**
047     * Matches whitespace characters. Line terminators may be matched 
048     * depending on the constructor used to create the object.
049     * 
050     * @see org.apache.tapestry.util.text.ICharacterMatcher#matches(char)
051     */
052    public boolean matches(char ch)
053    {
054        if (!_matchEndLines)
055            if (ch == '\n' || ch == '\r')
056                return false;
057        
058        return Character.isWhitespace(ch);
059    }
060}