001////////////////////////////////////////////////////////////////////////////////
002// checkstyle: Checks Java source code for adherence to a set of rules.
003// Copyright (C) 2001-2018 the original author or authors.
004//
005// This library is free software; you can redistribute it and/or
006// modify it under the terms of the GNU Lesser General Public
007// License as published by the Free Software Foundation; either
008// version 2.1 of the License, or (at your option) any later version.
009//
010// This library is distributed in the hope that it will be useful,
011// but WITHOUT ANY WARRANTY; without even the implied warranty of
012// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
013// Lesser General Public License for more details.
014//
015// You should have received a copy of the GNU Lesser General Public
016// License along with this library; if not, write to the Free Software
017// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
018////////////////////////////////////////////////////////////////////////////////
019
020package com.puppycrawl.tools.checkstyle.checks.regexp;
021
022import java.util.Optional;
023import java.util.regex.Pattern;
024
025import com.puppycrawl.tools.checkstyle.api.AbstractViolationReporter;
026
027/**
028 * Options for a detector.
029 * @author Oliver Burn
030 */
031public final class DetectorOptions {
032
033    /**
034     * Flags to compile a regular expression with.
035     * See {@link Pattern#flags()}.
036     */
037    private int compileFlags;
038    /** Used for reporting violations. */
039    private AbstractViolationReporter reporter;
040    /**
041     * Format of the regular expression to check for.
042     */
043    private String format;
044    /** The message to report on detection. If blank, then use the format. */
045    private String message = "";
046    /** Minimum number of times regular expression should occur in a file. */
047    private int minimum;
048    /** Maximum number of times regular expression should occur in a file. */
049    private int maximum;
050    /** Whether to ignore case when matching. */
051    private boolean ignoreCase;
052    /** Used to determine whether to suppress a detected match. */
053    private MatchSuppressor suppressor;
054    /** Pattern created from format. Lazily initialized. */
055    private Pattern pattern;
056
057    /** Default constructor.*/
058    private DetectorOptions() { }
059
060    /**
061     * Returns new Builder object.
062     * @return Builder object.
063     */
064    public static Builder newBuilder() {
065        return new DetectorOptions().new Builder();
066    }
067
068    /**
069     * Format of the regular expression.
070     * @return format of the regular expression.
071     */
072    public String getFormat() {
073        return format;
074    }
075
076    /**
077     * The violation reporter to use.
078     * @return the violation reporter to use.
079     */
080    public AbstractViolationReporter getReporter() {
081        return reporter;
082    }
083
084    /**
085     * The message to report errors with.
086     * @return the message to report errors with.
087     */
088    public String getMessage() {
089        return message;
090    }
091
092    /**
093     * The minimum number of allowed detections.
094     * @return the minimum number of allowed detections.
095     */
096    public int getMinimum() {
097        return minimum;
098    }
099
100    /**
101     * The maximum number of allowed detections.
102     * @return the maximum number of allowed detections.
103     */
104    public int getMaximum() {
105        return maximum;
106    }
107
108    /**
109     * The suppressor to use.
110     * @return the suppressor to use.
111     */
112    public MatchSuppressor getSuppressor() {
113        return suppressor;
114    }
115
116    /**
117     * The pattern to use when matching.
118     * @return the pattern to use when matching.
119     */
120    public Pattern getPattern() {
121        if (pattern == null) {
122            int options = compileFlags;
123
124            if (ignoreCase) {
125                options |= Pattern.CASE_INSENSITIVE;
126            }
127            pattern = Pattern.compile(format, options);
128        }
129        return pattern;
130    }
131
132    /** Class which implements Builder pattern to build DetectorOptions instance. */
133    public final class Builder {
134
135        /**
136         * Specifies the violation reporter and returns Builder object.
137         * @param val for reporting violations.
138         * @return Builder object.
139         * @noinspection ReturnOfInnerClass
140         */
141        public Builder reporter(AbstractViolationReporter val) {
142            reporter = val;
143            return this;
144        }
145
146        /**
147         * Specifies the compile flags to compile a regular expression with
148         * and returns Builder object.
149         * @param val the format to use when matching lines.
150         * @return Builder object.
151         * @noinspection ReturnOfInnerClass
152         */
153        public Builder compileFlags(int val) {
154            compileFlags = val;
155            return this;
156        }
157
158        /**
159         * Specifies the format to use when matching lines and returns Builder object.
160         * @param val the format to use when matching lines.
161         * @return Builder object.
162         * @noinspection ReturnOfInnerClass
163         */
164        public Builder format(String val) {
165            format = val;
166            return this;
167        }
168
169        /**
170         * Specifies message to use when reporting a match and returns Builder object.
171         * @param val message to use when reporting a match.
172         * @return Builder object.
173         * @noinspection ReturnOfInnerClass
174         */
175        public Builder message(String val) {
176            message = val;
177            return this;
178        }
179
180        /**
181         * Specifies the minimum allowed number of detections and returns Builder object.
182         * @param val the minimum allowed number of detections.
183         * @return Builder object.
184         * @noinspection ReturnOfInnerClass
185         */
186        public Builder minimum(int val) {
187            minimum = val;
188            return this;
189        }
190
191        /**
192         * Specifies the maximum allowed number of detections and returns Builder object.
193         * @param val the maximum allowed number of detections.
194         * @return Builder object.
195         * @noinspection ReturnOfInnerClass
196         */
197        public Builder maximum(int val) {
198            maximum = val;
199            return this;
200        }
201
202        /**
203         * Specifies whether to ignore case when matching and returns Builder object.
204         * @param val whether to ignore case when matching.
205         * @return Builder object.
206         * @noinspection ReturnOfInnerClass, BooleanParameter
207         */
208        public Builder ignoreCase(boolean val) {
209            ignoreCase = val;
210            return this;
211        }
212
213        /**
214         * Specifies the suppressor to use and returns Builder object.
215         * @param val the suppressor to use.
216         * @return current instance
217         * @noinspection ReturnOfInnerClass
218         */
219        public Builder suppressor(MatchSuppressor val) {
220            suppressor = val;
221            return this;
222        }
223
224        /**
225         * Returns new DetectorOptions instance.
226         * @return DetectorOptions instance.
227         */
228        public DetectorOptions build() {
229            message = Optional.ofNullable(message).orElse("");
230            suppressor = Optional.ofNullable(suppressor).orElse(NeverSuppress.INSTANCE);
231            return DetectorOptions.this;
232        }
233
234    }
235
236}