1   ////////////////////////////////////////////////////////////////////////////////
2   // checkstyle: Checks Java source code for adherence to a set of rules.
3   // Copyright (C) 2001-2019 the original author or authors.
4   //
5   // This library is free software; you can redistribute it and/or
6   // modify it under the terms of the GNU Lesser General Public
7   // License as published by the Free Software Foundation; either
8   // version 2.1 of the License, or (at your option) any later version.
9   //
10  // This library is distributed in the hope that it will be useful,
11  // but WITHOUT ANY WARRANTY; without even the implied warranty of
12  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  // Lesser General Public License for more details.
14  //
15  // You should have received a copy of the GNU Lesser General Public
16  // License along with this library; if not, write to the Free Software
17  // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
18  ////////////////////////////////////////////////////////////////////////////////
19  
20  package com.puppycrawl.tools.checkstyle.api;
21  
22  import java.util.Locale;
23  
24  /**
25   * Represents a Java visibility scope.
26   *
27   */
28  public enum Scope {
29  
30      /** Nothing scope. */
31      NOTHING,
32      /** Public scope. */
33      PUBLIC,
34      /** Protected scope. */
35      PROTECTED,
36      /** Package or default scope. */
37      PACKAGE,
38      /** Private scope. */
39      PRIVATE,
40      /** Anonymous inner scope. */
41      ANONINNER;
42  
43      @Override
44      public String toString() {
45          return getName();
46      }
47  
48      /**
49       * Returns name of severity level.
50       * @return the name of this severity level.
51       */
52      public String getName() {
53          return name().toLowerCase(Locale.ENGLISH);
54      }
55  
56      /**
57       * Checks if this scope is a subscope of another scope.
58       * Example: PUBLIC is a subscope of PRIVATE.
59       *
60       * @param scope a {@code Scope} value
61       * @return if {@code this} is a subscope of {@code scope}.
62       */
63      public boolean isIn(Scope scope) {
64          return compareTo(scope) <= 0;
65      }
66  
67      /**
68       * Scope factory method.
69       *
70       * @param scopeName scope name, such as "nothing", "public", etc.
71       * @return the {@code Scope} associated with {@code scopeName}
72       */
73      public static Scope getInstance(String scopeName) {
74          return valueOf(Scope.class, scopeName.trim().toUpperCase(Locale.ENGLISH));
75      }
76  
77  }