| //////////////////////////////////////////////////////////////////////////////// |
| // checkstyle: Checks Java source code for adherence to a set of rules. |
| // Copyright (C) 2001-2017 the original author or authors. |
| // |
| // This library is free software; you can redistribute it and/or |
| // modify it under the terms of the GNU Lesser General Public |
| // License as published by the Free Software Foundation; either |
| // version 2.1 of the License, or (at your option) any later version. |
| // |
| // This library is distributed in the hope that it will be useful, |
| // but WITHOUT ANY WARRANTY; without even the implied warranty of |
| // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| // Lesser General Public License for more details. |
| // |
| // You should have received a copy of the GNU Lesser General Public |
| // License along with this library; if not, write to the Free Software |
| // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| //////////////////////////////////////////////////////////////////////////////// |
| |
| package com.puppycrawl.tools.checkstyle.checks.naming; |
| |
| import java.util.regex.Pattern; |
| |
| import com.puppycrawl.tools.checkstyle.StatelessCheck; |
| import com.puppycrawl.tools.checkstyle.api.AbstractCheck; |
| import com.puppycrawl.tools.checkstyle.api.DetailAST; |
| import com.puppycrawl.tools.checkstyle.api.TokenTypes; |
| |
| /** |
| * <p> |
| * Ensures that the names of abstract classes conforming to some |
| * regular expression and check that {@code abstract} modifier exists. |
| * </p> |
| * <p> |
| * Rationale: Abstract classes are convenience base class |
| * implementations of interfaces, not types as such. As such |
| * they should be named to indicate this. Also if names of classes |
| * starts with 'Abstract' it's very convenient that they will |
| * have abstract modifier. |
| * </p> |
| * |
| * @author <a href="mailto:simon@redhillconsulting.com.au">Simon Harris</a> |
| * @author <a href="mailto:solid.danil@gmail.com">Danil Lopatin</a> |
| */ |
| @StatelessCheck |
| public final class AbstractClassNameCheck extends AbstractCheck { |
| |
| /** |
| * A key is pointing to the warning message text in "messages.properties" |
| * file. |
| */ |
| public static final String MSG_ILLEGAL_ABSTRACT_CLASS_NAME = "illegal.abstract.class.name"; |
| |
| /** |
| * A key is pointing to the warning message text in "messages.properties" |
| * file. |
| */ |
| public static final String MSG_NO_ABSTRACT_CLASS_MODIFIER = "no.abstract.class.modifier"; |
| |
| /** Whether to ignore checking the modifier. */ |
| private boolean ignoreModifier; |
| |
| /** Whether to ignore checking the name. */ |
| private boolean ignoreName; |
| |
| /** The regexp to match against. */ |
| private Pattern format = Pattern.compile("^Abstract.+$"); |
| |
| /** |
| * Whether to ignore checking for the {@code abstract} modifier. |
| * @param value new value |
| */ |
| public void setIgnoreModifier(boolean value) { |
| ignoreModifier = value; |
| } |
| |
| /** |
| * Whether to ignore checking the name. |
| * @param value new value. |
| */ |
| public void setIgnoreName(boolean value) { |
| ignoreName = value; |
| } |
| |
| /** |
| * Set the format for the specified regular expression. |
| * @param pattern the new pattern |
| */ |
| public void setFormat(Pattern pattern) { |
| format = pattern; |
| } |
| |
| @Override |
| public int[] getDefaultTokens() { |
| return getRequiredTokens(); |
| } |
| |
| @Override |
| public int[] getRequiredTokens() { |
| return new int[] {TokenTypes.CLASS_DEF}; |
| } |
| |
| @Override |
| public int[] getAcceptableTokens() { |
| return getRequiredTokens(); |
| } |
| |
| @Override |
| public void visitToken(DetailAST ast) { |
| visitClassDef(ast); |
| } |
| |
| /** |
| * Checks class definition. |
| * @param ast class definition for check. |
| */ |
| private void visitClassDef(DetailAST ast) { |
| final String className = |
| ast.findFirstToken(TokenTypes.IDENT).getText(); |
| if (isAbstract(ast)) { |
| // if class has abstract modifier |
| if (!ignoreName && !isMatchingClassName(className)) { |
| log(ast.getLineNo(), ast.getColumnNo(), |
| MSG_ILLEGAL_ABSTRACT_CLASS_NAME, className, format.pattern()); |
| } |
| } |
| else if (!ignoreModifier && isMatchingClassName(className)) { |
| log(ast.getLineNo(), ast.getColumnNo(), |
| MSG_NO_ABSTRACT_CLASS_MODIFIER, className); |
| } |
| } |
| |
| /** |
| * Checks if declared class is abstract or not. |
| * @param ast class definition for check. |
| * @return true if a given class declared as abstract. |
| */ |
| private static boolean isAbstract(DetailAST ast) { |
| final DetailAST abstractAST = ast.findFirstToken(TokenTypes.MODIFIERS) |
| .findFirstToken(TokenTypes.ABSTRACT); |
| |
| return abstractAST != null; |
| } |
| |
| /** |
| * Returns true if class name matches format of abstract class names. |
| * @param className class name for check. |
| * @return true if class name matches format of abstract class names. |
| */ |
| private boolean isMatchingClassName(String className) { |
| return format.matcher(className).find(); |
| } |
| } |