View Javadoc
1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one   *
3    * or more contributor license agreements.  See the NOTICE file *
4    * distributed with this work for additional information        *
5    * regarding copyright ownership.  The ASF licenses this file   *
6    * to you under the Apache License, Version 2.0 (the            *
7    * "License"); you may not use this file except in compliance   *
8    * with the License.  You may obtain a copy of the License at   *
9    *                                                              *
10   *   http://www.apache.org/licenses/LICENSE-2.0                 *
11   *                                                              *
12   * Unless required by applicable law or agreed to in writing,   *
13   * software distributed under the License is distributed on an  *
14   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY       *
15   * KIND, either express or implied.  See the License for the    *
16   * specific language governing permissions and limitations      *
17   * under the License.                                           *
18   */
19  package org.apache.rat.analysis.matchers;
20  
21  import org.apache.commons.lang3.StringUtils;
22  import org.apache.rat.analysis.IHeaders;
23  import org.apache.rat.config.parameters.ComponentType;
24  import org.apache.rat.config.parameters.ConfigComponent;
25  
26  import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;
27  
28  /**
29   * A simple text matching IHeaderMatcher implementation.
30   */
31  @ConfigComponent(type = ComponentType.MATCHER, name = "text", desc = "Matches the enclosed text")
32  public class SimpleTextMatcher extends AbstractHeaderMatcher {
33      /**
34       * The text to match.
35       */
36      @ConfigComponent(type = ComponentType.PARAMETER, name = "simpleText", desc = "The text to match", required = true)
37      private final String simpleText;
38  
39      /**
40       * Constructs the simple text matcher for the simple string.
41       *
42       * @param simpleText The pattern to match. Will only match a single line from
43       * the input stream.
44       */
45      public SimpleTextMatcher(final String simpleText) {
46          this(null, simpleText);
47      }
48  
49      // no sonar and supress FI_USELESS because this is how we ensure that the finalize bug does not bite us
50      @SuppressFBWarnings("FI_USELESS")
51      @Override
52      protected final void finalize() throws Throwable { // NOSONAR
53          // finalizer attack remediation.
54          super.finalize(); // NOSONAR
55      }
56  
57      /**
58       * Constructs the simple text matcher for the simple string.
59       *
60       * @param id The id for this matcher.
61       * @param simpleText The pattern to match.
62       */
63      public SimpleTextMatcher(final String id, final String simpleText) {
64          super(id);
65          if (StringUtils.isBlank(simpleText)) {
66              throw new IllegalArgumentException("Simple text may not be null, empty or blank");
67          }
68          this.simpleText = simpleText;
69      }
70  
71      public String getSimpleText() {
72          return this.simpleText;
73      }
74  
75      @Override
76      public boolean matches(final IHeaders headers) {
77          return headers.raw().contains(simpleText);
78      }
79  }