Class AbstractFileSetCheck

    • Method Detail

      • processFiltered

        protected abstract void processFiltered​(File file,
                                                List<String> lines)
                                         throws CheckstyleException
        Called to process a file that matches the specified file extensions.
        Parameters:
        file - the file to be processed
        lines - an immutable list of the contents of the file.
        Throws:
        CheckstyleException - if error condition within Checkstyle occurs.
      • init

        public void init()
        Description copied from interface: FileSetCheck
        Initialise the instance. This is the time to verify that everything required to perform it job.
        Specified by:
        init in interface FileSetCheck
      • process

        public final SortedSet<LocalizedMessageprocess​(File file,
                                                         List<String> lines)
                                                  throws CheckstyleException
        Description copied from interface: FileSetCheck
        Request to process a file. The implementation should use the supplied contents and not read the contents again. This reduces the amount of file I/O.

        The file set to process might contain files that are not interesting to the FileSetCheck. Such files should be ignored, no error message should be fired for them. For example a FileSetCheck that checks java files should ignore HTML or properties files.

        The method should return the set of messages to be logged.

        Specified by:
        process in interface FileSetCheck
        Parameters:
        file - the file to be processed
        lines - an immutable list of the contents of the file.
        Returns:
        the sorted set of messages to be logged.
        Throws:
        CheckstyleException - if error condition within Checkstyle occurs
      • finishProcessing

        public void finishProcessing()
        Description copied from interface: FileSetCheck
        Called when all the files have been processed. This is the time to perform any checks that need to be done across a set of files. In this method, the implementation is responsible for the logging of messages.
        Specified by:
        finishProcessing in interface FileSetCheck
      • getMessageDispatcher

        protected final MessageDispatcher getMessageDispatcher()
        A message dispatcher is used to fire violation messages to interested audit listeners.
        Returns:
        the current MessageDispatcher.
      • getFileExtensions

        public String[] getFileExtensions()
        Makes copy of file extensions and returns them.
        Returns:
        file extensions that identify the files that pass the filter of this FileSetCheck.
      • setFileExtensions

        public final void setFileExtensions​(String... extensions)
        Sets the file extensions that identify the files that pass the filter of this FileSetCheck.
        Parameters:
        extensions - the set of file extensions. A missing initial '.' character of an extension is automatically added.
        Throws:
        IllegalArgumentException - is argument is null
      • getMessageCollector

        protected final LocalizedMessages getMessageCollector()
        Returns the collector for violation messages. Subclasses can use the collector to find out the violation messages to fire via the message dispatcher.
        Returns:
        the collector for localized messages.
      • log

        public final void log​(int lineNo,
                              int colNo,
                              String key,
                              Object... args)
        Description copied from class: AbstractViolationReporter
        Log a message that has column information.
        Specified by:
        log in class AbstractViolationReporter
        Parameters:
        lineNo - the line number where the error was found
        colNo - the column number where the error was found
        key - the message that describes the error
        args - the details of the message
        See Also:
        MessageFormat
      • fireErrors

        protected final void fireErrors​(String fileName)
        Notify all listeners about the errors in a file. Calls MessageDispatcher.fireErrors() with all logged errors and than clears errors' list.
        Parameters:
        fileName - the audited file