src/xdocs/config_imports.xml

<?xml version="1.0" encoding="UTF-8"?>

<document xmlns="http://maven.apache.org/XDOC/2.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 https://maven.apache.org/xsd/xdoc-2.0.xsd">

  <head>
    <title>Imports</title>
  </head>

  <body>
    <section name="Content">
      <macro name="toc">
        <param name="fromDepth" value="1"/>
        <param name="toDepth" value="1"/>
      </macro>
    </section>

    <section name="AvoidStarImport">
      <p>Since Checkstyle 3.0</p>
      <subsection name="Description" id="AvoidStarImport_Description">
        <p>
          Checks that there are no import statements that use the <code>*</code> notation.
        </p>

        <p>
          Rationale: Importing all classes from a package or static
          members from a class leads to tight coupling between packages
          or classes and might lead to problems when a new version of a
          library introduces name clashes.
        </p>
      </subsection>

      <subsection name="Notes" id="AvoidStarImport_Notes">
        <p>
          Note that property <code>excludes</code> is not recursive,
          subpackages of excluded packages are not automatically excluded.
        </p>
      </subsection>

      <subsection name="Properties" id="AvoidStarImport_Properties">
        <div class="wrapper">
          <table>
            <tr>
              <th>name</th>
              <th>description</th>
              <th>type</th>
              <th>default value</th>
              <th>since</th>
            </tr>
            <tr>
              <td>excludes</td>
              <td>
                Specify packages where starred class imports are
                allowed and classes where starred static member imports are
                allowed.
              </td>
              <td><a href="property_types.html#String.5B.5D">String[]</a></td>
              <td><code>{}</code></td>
              <td>3.2</td>
            </tr>
            <tr>
              <td>allowClassImports</td>
              <td>
                Control whether to allow starred class imports like
                <code>import java.util.*;</code>.
              </td>
              <td><a href="property_types.html#boolean">boolean</a></td>
              <td><code>false</code></td>
              <td>5.3</td>
            </tr>
            <tr>
              <td>allowStaticMemberImports</td>
              <td>
                Control whether to allow starred static member imports like
                <code>import static org.junit.Assert.*;</code>.
              </td>
              <td><a href="property_types.html#boolean">boolean</a></td>
              <td><code>false</code></td>
              <td>5.3</td>
            </tr>
          </table>
        </div>
      </subsection>

      <subsection name="Examples" id="AvoidStarImport_Examples">
        <p>
          To configure the check:
        </p>
        <source>
&lt;module name="AvoidStarImport"/&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
import java.util.Scanner;         // OK
import java.io.*;                 // violation
import static java.lang.Math.*;   // violation
import java.util.*;               // violation
import java.net.*;                // violation
        </source>
        <p>
          To configure the check so that star imports from packages
          <code>java.io and java.net</code> as well as static members from class
          <code>java.lang.Math</code> are allowed:
        </p>
        <source>
&lt;module name="AvoidStarImport"&gt;
  &lt;property name="excludes" value="java.io,java.net,java.lang.Math"/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
import java.util.Scanner;         // OK
import java.io.*;                 // OK
import static java.lang.Math.*;   // OK
import java.util.*;               // violation
import java.net.*;                // OK
        </source>
        <p>
          To configure the check so that star imports
          from all packages are allowed:
        </p>
        <source>
&lt;module name="AvoidStarImport"&gt;
  &lt;property name="allowClassImports" value="true"/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
import java.util.Scanner;         // OK
import java.io.*;                 // OK
import static java.lang.Math.*;   // violation
import java.util.*;               // OK
import java.net.*;                // OK
        </source>
        <p>
          To configure the check so that starred static member imports
          from all packages are allowed:
        </p>
        <source>
&lt;module name="AvoidStarImport"&gt;
  &lt;property name="allowStaticMemberImports" value="true"/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
import java.util.Scanner;         // OK
import java.io.*;                 // violation
import static java.lang.Math.*;   // OK
import java.util.*;               // violation
import java.net.*;                // violation
        </source>
        <p>
          To configure the check so that star imports from packages
          <code>java.io and java.net</code> are allowed:
        </p>
        <source>
&lt;module name="AvoidStarImport"&gt;
  &lt;property name="allowClassImports" value="true"/&gt;
  &lt;property name="excludes" value="java.io,java.net"/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
import java.util.Scanner;         // OK
import java.io.*;                 // OK
import static java.lang.Math.*;   // violation
import java.util.*;               // OK
import java.net.*;                // OK
        </source>
        <p>
          To configure the check so that star imports from packages
          <code>java.io and java.net</code> as well as static members imports
          from all packages are allowed:
        </p>
        <source>
&lt;module name="AvoidStarImport"&gt;
  &lt;property name="allowStaticMemberImports" value="true"/&gt;
  &lt;property name="excludes" value="java.io,java.net"/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
import java.util.Scanner;         // OK
import java.io.*;                 // OK
import static java.lang.Math.*;   // OK
import java.util.*;               // violation
import java.net.*;                // OK
        </source>
      </subsection>

      <subsection name="Example of Usage" id="AvoidStarImport_Example_of_Usage">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources+filename%3Agoogle_checks.xml+repo%3Acheckstyle%2Fcheckstyle+AvoidStarImport">
            Google Style</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources+filename%3Asun_checks.xml+repo%3Acheckstyle%2Fcheckstyle+AvoidStarImport">
            Sun Style</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Aconfig+filename%3Acheckstyle_checks.xml+repo%3Acheckstyle%2Fcheckstyle+AvoidStarImport">
            Checkstyle Style</a>
          </li>
        </ul>
      </subsection>
      <subsection name="Violation Messages" id="AvoidStarImport_Violation_Messages">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22import.avoidStar%22">
            import.avoidStar</a>
          </li>
        </ul>
        <p>
          All messages can be customized if the default message doesn't suit you.
          Please <a href="config.html#Custom_messages">see the documentation</a> to learn how to.
        </p>
      </subsection>
      <subsection name="Package" id="AvoidStarImport_Package">
        <p> com.puppycrawl.tools.checkstyle.checks.imports </p>
      </subsection>

      <subsection name="Parent Module" id="AvoidStarImport_Parent_Module">
        <p>
          <a href="config.html#TreeWalker">TreeWalker</a>
        </p>
      </subsection>
    </section>

    <section name="AvoidStaticImport">
      <p>Since Checkstyle 5.0</p>
      <subsection name="Description" id="AvoidStaticImport_Description">
        <p>
          Checks that there are no static import statements.
        </p>

        <p>
          Rationale: Importing static members can lead to naming
          conflicts between class' members. It may lead to poor code
          readability since it may no longer be clear what class a
          member resides in (without looking at the import statement).
        </p>
      </subsection>

      <subsection name="Notes" id="AvoidStaticImport_Notes">
        <p>
          If you exclude a starred import on a class this automatically
          excludes each member individually.
        </p>
        <p>
          For example: Excluding <code>java.lang.Math.*</code>. will allow the
          import of each static member in the Math class
          individually like <code>java.lang.Math.PI, java.lang.Math.cos, ...</code>.
        </p>
      </subsection>

      <subsection name="Properties" id="AvoidStaticImport_Properties">
        <div class="wrapper">
          <table>
            <tr>
              <th>name</th>
              <th>description</th>
              <th>type</th>
              <th>default value</th>
              <th>since</th>
            </tr>
            <tr>
              <td>excludes</td>
              <td>
                Control whether to allow for certain classes via a star notation to be
                excluded such as <code>java.lang.Math.*</code> or specific static
                members to be excluded like <code>java.lang.System.out</code> for a variable or
                <code>java.lang.Math.random</code> for a method. See notes section for details.
              </td>
              <td><a href="property_types.html#String.5B.5D">String[]</a></td>
              <td><code>{}</code></td>
              <td>5.0</td>
            </tr>
          </table>
        </div>
      </subsection>

      <subsection name="Examples" id="AvoidStaticImport_Examples">
        <p>
          To configure the check:
        </p>
        <source>
&lt;module name="AvoidStaticImport"/&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
import static java.lang.Math.pow;          // violation
import static java.lang.System.*;          // violation
import java.io.File;                       // OK
import java.util.*;                        // OK
        </source>
        <p>
          To configure the check so that the <code>java.lang.System.out</code>
          member and all members from <code>java.lang.Math</code> are allowed:
        </p>
        <source>
&lt;module name="AvoidStaticImport"&gt;
  &lt;property name="excludes" value="java.lang.System.out,java.lang.Math.*"/&gt;
&lt;/module&gt;
        </source>
        <p>
         Example:
        </p>
        <source>
import static java.lang.Math.*;            // OK
import static java.lang.System.out;        // OK
import static java.lang.Integer.parseInt;  // violation
import java.io.*;                          // OK
import java.util.*;                        // OK
        </source>
      </subsection>

      <subsection name="Example of Usage" id="AvoidStaticImport_Example_of_Usage">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Aconfig+filename%3Acheckstyle_checks.xml+repo%3Acheckstyle%2Fcheckstyle+AvoidStaticImport">
            Checkstyle Style</a>
          </li>
        </ul>
      </subsection>

      <subsection name="Violation Messages" id="AvoidStaticImport_Violation_Messages">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22import.avoidStatic%22">
            import.avoidStatic</a>
          </li>
        </ul>
        <p>
          All messages can be customized if the default message doesn't suit you.
          Please <a href="config.html#Custom_messages">see the documentation</a> to learn how to.
        </p>
      </subsection>

      <subsection name="Package" id="AvoidStaticImport_Package">
        <p> com.puppycrawl.tools.checkstyle.checks.imports </p>
      </subsection>

      <subsection name="Parent Module" id="AvoidStaticImport_Parent_Module">
        <p>
          <a href="config.html#TreeWalker">TreeWalker</a>
        </p>
      </subsection>
    </section>

    <section name="CustomImportOrder">
      <p>Since Checkstyle 5.8</p>
      <subsection name="Description" id="CustomImportOrder_Description">
        <p>
          Checks that the groups of import declarations appear in the order specified
          by the user. If there is an import but its group is not specified in the
          configuration such an import should be placed at the end of the import list.
        </p>
      </subsection>

      <subsection name="Rule Description" id="CustomImportOrder_Rule_Description">
        <p>
          The rule consists of:
        </p>
        <ol>
          <li>
            STATIC group. This group sets the ordering of static imports.
          </li>
          <li>
            SAME_PACKAGE(n) group. This group sets the ordering of the same package imports.
            Imports are considered on SAME_PACKAGE group if <b>n</b> first domains in package
            name and import name are identical:
            <source>
package java.util.concurrent.locks;

import java.io.File;
import java.util.*; //#1
import java.util.List; //#2
import java.util.StringTokenizer; //#3
import java.util.concurrent.*; //#4
import java.util.concurrent.AbstractExecutorService; //#5
import java.util.concurrent.locks.LockSupport; //#6
import java.util.regex.Pattern; //#7
import java.util.regex.Matcher; //#8
            </source>
            If we have SAME_PACKAGE(3) on configuration file,
            imports #4-6 will be considered as a SAME_PACKAGE group (java.util.concurrent.*,
            java.util.concurrent.AbstractExecutorService, java.util.concurrent.locks.LockSupport).
            SAME_PACKAGE(2) will include #1-8. SAME_PACKAGE(4) will include only #6.
            SAME_PACKAGE(5) will result in no imports assigned to SAME_PACKAGE group because
            actual package java.util.concurrent.locks has only 4 domains.
          </li>
          <li>
            THIRD_PARTY_PACKAGE group. This group sets ordering of third party imports.
            Third party imports are all imports except STATIC, SAME_PACKAGE(n),
            STANDARD_JAVA_PACKAGE and SPECIAL_IMPORTS.
          </li>
          <li>
            STANDARD_JAVA_PACKAGE group. By default, this group sets ordering of standard
            java/javax imports.
          </li>
          <li>
            SPECIAL_IMPORTS group. This group may contain some imports that have particular
            meaning for the user.
          </li>
        </ol>
      </subsection>

      <subsection name="Notes" id="CustomImportOrder_Notes">
        <p>
          Use the separator '###' between rules.
        </p>
        <p>
          To set RegExps for THIRD_PARTY_PACKAGE and STANDARD_JAVA_PACKAGE groups use
          thirdPartyPackageRegExp and standardPackageRegExp options.
        </p>
        <p>
          Pretty often one import can match more than one group. For example, static import
          from standard package or regular expressions are configured to allow one import match
          multiple groups. In this case, group will be assigned according to priorities:
        </p>
        <ol>
          <li>STATIC has top priority</li>
          <li>SAME_PACKAGE has second priority</li>
          <li>STANDARD_JAVA_PACKAGE and SPECIAL_IMPORTS will compete using "best match" rule: longer
          matching substring wins; in case of the same length, lower position of matching substring
          wins; if position is the same, order of rules in configuration solves the puzzle.</li>
          <li>THIRD_PARTY has the least priority</li>
        </ol>
        <p>
          Few examples to illustrate "best match":
        </p>
        <p>
          1. patterns STANDARD_JAVA_PACKAGE = "Check", SPECIAL_IMPORTS="ImportOrderCheck"
          and input file:
        </p>
        <source>
import com.puppycrawl.tools.checkstyle.checks.imports.CustomImportOrderCheck;
import com.puppycrawl.tools.checkstyle.checks.imports.ImportOrderCheck;
        </source>
        <p>
          Result: imports will be assigned to SPECIAL_IMPORTS, because matching
          substring length is 16. Matching substring for STANDARD_JAVA_PACKAGE is 5.
        </p>
        <p>
          2. patterns STANDARD_JAVA_PACKAGE = "Check", SPECIAL_IMPORTS="Avoid" and file:
        </p>
        <source>
import com.puppycrawl.tools.checkstyle.checks.imports.AvoidStarImportCheck;
        </source>
        <p>
          Result: import will be assigned to SPECIAL_IMPORTS. Matching substring length is 5 for
          both patterns. However, "Avoid" position is lower than "Check" position.
        </p>
      </subsection>

      <subsection name="Properties" id="CustomImportOrder_Properties">
        <div class="wrapper">
          <table>
            <tr>
              <th>name</th>
              <th>description</th>
              <th>type</th>
              <th>default value</th>
              <th>since</th>
            </tr>
            <tr>
              <td>customImportOrderRules</td>
              <td>Specify format of order declaration customizing by user.</td>
              <td><a href="property_types.html#String">String</a></td>
              <td><code>""</code></td>
              <td>5.8</td>
            </tr>
            <tr>
              <td>standardPackageRegExp</td>
              <td>Specify RegExp for STANDARD_JAVA_PACKAGE group imports.</td>
              <td><a href="property_types.html#Pattern">Pattern</a></td>
              <td><code>"^(java|javax)\."</code></td>
              <td>5.8</td>
            </tr>
            <tr>
              <td>thirdPartyPackageRegExp</td>
              <td>Specify RegExp for THIRD_PARTY_PACKAGE group imports.</td>
              <td><a href="property_types.html#Pattern">Pattern</a></td>
              <td><code>".*"</code></td>
              <td>5.8</td>
            </tr>
            <tr>
              <td>specialImportsRegExp</td>
              <td>Specify RegExp for SPECIAL_IMPORTS group imports.</td>
              <td><a href="property_types.html#Pattern">Pattern</a></td>
              <td><code>"^$"</code></td>
              <td>5.8</td>
            </tr>
            <tr>
              <td>separateLineBetweenGroups</td>
              <td>Force empty line separator between import groups.</td>
              <td><a href="property_types.html#boolean">boolean</a></td>
              <td><code>true</code></td>
              <td>5.8</td>
            </tr>
            <tr>
              <td>sortImportsInGroupAlphabetically</td>
              <td>Force grouping alphabetically, in
                <a href="https://en.wikipedia.org/wiki/ASCII#Order">
                  ASCII sort order</a>.
              </td>
              <td><a href="property_types.html#boolean">boolean</a></td>
              <td><code>false</code></td>
              <td>5.8</td>
            </tr>
          </table>
        </div>
      </subsection>

      <subsection name="Examples" id="CustomImportOrder_Examples">
        <p>
          To configure the check :
        </p>
        <source>
&lt;module name=&quot;CustomImportOrder&quot;/&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
package com.company;
import org.apache.commons.io.FileUtils; // OK
import static java.util.*; // OK
import java.time.*; // OK
import static java.io.*; // OK
import com.puppycrawl.tools.checkstyle.checks.imports.CustomImportOrderCheck; // OK
import com.puppycrawl.tools.checkstyle.checks.imports.ImportOrderCheck; // OK
        </source>
        <p>
          To configure the check so that it checks in the order
          (static imports,standard java packages,third party package):
        </p>
        <source>
&lt;module name=&quot;CustomImportOrder&quot;&gt;
  &lt;property name=&quot;customImportOrderRules&quot;
    value=&quot;STATIC###STANDARD_JAVA_PACKAGE###THIRD_PARTY_PACKAGE&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
package com.company;

import static java.util.*; // OK

import java.time.*; // OK
import javax.net.*; // OK
import static java.io.*; // violation as static imports should be in top

import org.apache.commons.io.FileUtils; // OK
import com.puppycrawl.tools.checkstyle.checks.imports.CustomImportOrderCheck; // OK
import com.puppycrawl.tools.checkstyle.checks.imports.ImportOrderCheck; // OK
        </source>
        <p>
          To configure the check such that only java packages are included in standard java packages
        </p>
        <source>
&lt;module name=&quot;CustomImportOrder&quot;&gt;
  &lt;property name=&quot;customImportOrderRules&quot;
    value=&quot;STATIC###STANDARD_JAVA_PACKAGE###THIRD_PARTY_PACKAGE&quot;/&gt;
  &lt;property name=&quot;standardPackageRegExp&quot; value=&quot;^java\.&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
        Example:
        </p>
        <source>
package com.company;

import static java.util.*; // OK
import static java.io.*; // OK

import java.time.*; // OK
import javax.net.*; // violation as it is not included in standard java package group.

import org.apache.commons.io.FileUtils; // violation
import com.puppycrawl.tools.checkstyle.checks.imports.CustomImportOrderCheck; // OK
import com.puppycrawl.tools.checkstyle.checks.imports.ImportOrderCheck; // OK
        </source>
        <p>
          To configure the check to include only "com" packages as third party group imports:
        </p>
        <source>
&lt;module name=&quot;CustomImportOrder&quot;&gt;
  &lt;property name=&quot;customImportOrderRules&quot;
    value=&quot;STATIC###STANDARD_JAVA_PACKAGE###SPECIAL_IMPORTS###THIRD_PARTY_PACKAGE&quot;/&gt;
  &lt;property name=&quot;thirdPartyPackageRegExp&quot; value=&quot;^com\.&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
package com.company;

import static java.util.*; // OK
import static java.io.*; // OK

import java.time.*; // OK
import javax.net.*; // OK

import org.apache.commons.io.FileUtils; // violation(should be in end)
import com.puppycrawl.tools.checkstyle.checks.imports.CustomImportOrderCheck; // violation
import com.puppycrawl.tools.checkstyle.checks.imports.ImportOrderCheck; // OK
        </source>
        <p>
          To configure the check to force some packages in special import group:
        </p>
        <source>
&lt;module name=&quot;CustomImportOrder&quot;&gt;
  &lt;property name=&quot;customImportOrderRules&quot;
    value=&quot;STATIC###SPECIAL_IMPORTS###STANDARD_JAVA_PACKAGE&quot;/&gt;
  &lt;property name=&quot;specialImportsRegExp&quot; value=&quot;^org\.&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
        Example:
        </p>
        <source>
package com.company;

import static java.util.*; // OK
import static java.io.*; // OK

import org.json.JSONObject; // OK

import java.time.*; // OK
import javax.net.*; // OK

import org.apache.commons.io.FileUtils; // violation
        </source>
        <p>
          To configure the check such that empty line separator between two groups is enabled:
        </p>
        <source>
&lt;module name=&quot;CustomImportOrder&quot;&gt;
  &lt;property name=&quot;customImportOrderRules&quot;
    value=&quot;STATIC###STANDARD_JAVA_PACKAGE###SPECIAL_IMPORTS###THIRD_PARTY_PACKAGE&quot;/&gt;
  &lt;property name=&quot;specialImportsRegExp&quot; value=&quot;^org\.&quot;/&gt;
  &lt;property name=&quot;thirdPartyPackageRegExp&quot; value=&quot;^com\.&quot;/&gt;
  &lt;property name=&quot;separateLineBetweenGroups&quot; value=&quot;true&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
package com.company;

import static java.util.*; // OK
import static java.io.*; // OK

import java.time.*; // OK
import javax.net.*; // OK
import org.apache.commons.io.FileUtils; // violation
import com.puppycrawl.tools.checkstyle.checks.imports.CustomImportOrderCheck; // violation
import com.puppycrawl.tools.checkstyle.checks.imports.ImportOrderCheck; // OK
        </source>
        <p>
          To configure the check such that import groups are forced to be sorted alphabetically:
        </p>
        <source>
&lt;module name=&quot;CustomImportOrder&quot;&gt;
  &lt;property name=&quot;customImportOrderRules&quot;
    value=&quot;STATIC###STANDARD_JAVA_PACKAGE###SPECIAL_IMPORTS###THIRD_PARTY_PACKAGE&quot;/&gt;
  &lt;property name=&quot;specialImportsRegExp&quot; value=&quot;^org\.&quot;/&gt;
  &lt;property name=&quot;thirdPartyPackageRegExp&quot; value=&quot;^com\.&quot;/&gt;
  &lt;property name=&quot;separateLineBetweenGroups&quot; value=&quot;false&quot;/&gt;
  &lt;property name=&quot;sortImportsInGroupAlphabetically&quot; value=&quot;true&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
package com.company;

import static java.util.*; // OK
import static java.io.*; // Violation since it should come before"java.util"

import java.time.*; // OK
import javax.net.*; // OK
import org.apache.commons.io.FileUtils; // OK
import com.puppycrawl.tools.checkstyle.checks.imports.CustomImportOrderCheck; // OK
import com.puppycrawl.tools.checkstyle.checks.imports.ImportOrderCheck; // OK
        </source>
        <p>To configure the check so that it matches default Eclipse formatter configuration
           (tested on Kepler and Luna releases):</p>
        <ul>
          <li>group of static imports is on the top</li>
          <li>groups of non-static imports: &quot;java&quot; and &quot;javax&quot; packages first,
              then &quot;org&quot; and then all other imports</li>
          <li>imports will be sorted in the groups</li>
          <li>groups are separated by single blank line</li>
        </ul>
        <p>Notes:</p>
        <ul>
          <li>&quot;com&quot; package is not mentioned on configuration, because it is
              ignored by Eclipse Kepler and Luna (looks like Eclipse defect)</li>
          <li>configuration below doesn't work in all 100% cases due to inconsistent behavior
              prior to Mars release, but covers most scenarios</li>
        </ul>
        <source>
&lt;module name=&quot;CustomImportOrder&quot;&gt;
  &lt;property name=&quot;customImportOrderRules&quot;
    value=&quot;STATIC###STANDARD_JAVA_PACKAGE###SPECIAL_IMPORTS&quot;/&gt;
  &lt;property name=&quot;specialImportsRegExp&quot; value=&quot;^org\.&quot;/&gt;
  &lt;property name=&quot;sortImportsInGroupAlphabetically&quot; value=&quot;true&quot;/&gt;
  &lt;property name=&quot;separateLineBetweenGroups&quot; value=&quot;true&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
package com.company;

import static java.util.*; // OK
import static java.io.*; // Violation since it should come before"java.util"

import java.time.*; // OK
import javax.net.*; // OK
import org.apache.commons.io.FileUtils; // Violation should be separated by space

import com.puppycrawl.tools.checkstyle.checks.imports.CustomImportOrderCheck; // OK
import com.puppycrawl.tools.checkstyle.checks.imports.ImportOrderCheck; // OK
        </source>
        <p>To configure the check so that it matches default Eclipse formatter configuration
           (tested on Mars release):</p>
        <ul>
          <li>group of static imports is on the top</li>
          <li>groups of non-static imports: &quot;java&quot; and &quot;javax&quot; packages first,
              then &quot;org&quot; and &quot;com&quot;, then all other imports as one group</li>
          <li>imports will be sorted in the groups</li>
          <li>groups are separated by one blank line</li>
        </ul>
        <source>
&lt;module name=&quot;CustomImportOrder&quot;&gt;
  &lt;property name=&quot;customImportOrderRules&quot;
    value=&quot;STATIC###STANDARD_JAVA_PACKAGE###SPECIAL_IMPORTS###THIRD_PARTY_PACKAGE&quot;/&gt;
  &lt;property name=&quot;specialImportsRegExp&quot; value=&quot;^org\.&quot;/&gt;
  &lt;property name=&quot;thirdPartyPackageRegExp&quot; value=&quot;^com\.&quot;/&gt;
  &lt;property name=&quot;sortImportsInGroupAlphabetically&quot; value=&quot;true&quot;/&gt;
  &lt;property name=&quot;separateLineBetweenGroups&quot; value=&quot;true&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
package com.company;

import static java.io.*; // OK
import static java.util.*; // OK

import java.time.*; // OK
import javax.net.*; // OK

import com.puppycrawl.tools.checkstyle.checks.imports.CustomImportOrderCheck; // Violation
import com.puppycrawl.tools.checkstyle.checks.imports.ImportOrderCheck; // Violation

import org.apache.commons.io.FileUtils;
        </source>
        <p>To configure the check so that it matches default IntelliJ IDEA formatter configuration
           (tested on v14):</p>
        <ul>
          <li>group of static imports is on the bottom</li>
          <li>groups of non-static imports: all imports except of &quot;javax&quot; and
              &quot;java&quot;, then &quot;javax&quot; and &quot;java&quot;</li>
          <li>imports will be sorted in the groups</li>
          <li>groups are separated by one blank line</li>
        </ul>

        <p>
        Note: &quot;separated&quot; option is disabled because IDEA default has blank line
        between &quot;java&quot; and static imports, and no blank line between
        &quot;javax&quot; and &quot;java&quot;
        </p>

        <source>
&lt;module name=&quot;CustomImportOrder&quot;&gt;
  &lt;property name=&quot;customImportOrderRules&quot;
    value=&quot;THIRD_PARTY_PACKAGE###SPECIAL_IMPORTS###STANDARD_JAVA_PACKAGE###STATIC&quot;/&gt;
  &lt;property name=&quot;specialImportsRegExp&quot; value=&quot;^javax\.&quot;/&gt;
  &lt;property name=&quot;standardPackageRegExp&quot; value=&quot;^java\.&quot;/&gt;
  &lt;property name=&quot;sortImportsInGroupAlphabetically&quot; value=&quot;true&quot;/&gt;
  &lt;property name=&quot;separateLineBetweenGroups&quot; value=&quot;false&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
package com.company;

import static java.io.*; // OK
import static java.util.*; // OK

import java.time.*; // violation should be in standard package group
                   // below special import

import javax.net.*; // Violation should be in special import group

import org.apache.commons.io.FileUtils; // Violation should be in
                                       // THIRD PARTY PACKAGE GROUP
import com.puppycrawl.tools.checkstyle.checks.imports.CustomImportOrderCheck; // Violation
import com.puppycrawl.tools.checkstyle.checks.imports.ImportOrderCheck; // Violation
        </source>
        <p>To configure the check so that it matches default NetBeans formatter configuration
           (tested on v8):</p>
        <ul>
          <li>groups of non-static imports are not defined, all imports will be sorted as a one
              group</li>
          <li>static imports are not separated, they will be sorted along with other imports</li>
        </ul>

        <source>
&lt;module name=&quot;CustomImportOrder&quot;/&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
package com.company;

import static java.io.*; // OK
import static java.util.*; // OK
import java.time.*; // OK
import javax.net.*; // OK
import com.puppycrawl.tools.checkstyle.checks.imports.CustomImportOrderCheck; // OK
import com.puppycrawl.tools.checkstyle.checks.imports.ImportOrderCheck; // OK

import org.apache.commons.io.FileUtils; // should not be separated by line
        </source>
        <p>
          To set RegExps for THIRD_PARTY_PACKAGE and STANDARD_JAVA_PACKAGE groups use
          thirdPartyPackageRegExp and standardPackageRegExp options.
        </p>
        <source>
&lt;module name=&quot;CustomImportOrder&quot;&gt;
  &lt;property name=&quot;customImportOrderRules&quot;
    value=&quot;STATIC###SAME_PACKAGE(3)###THIRD_PARTY_PACKAGE###STANDARD_JAVA_PACKAGE&quot;/&gt;
  &lt;property name=&quot;thirdPartyPackageRegExp&quot; value=&quot;^(com|org)\.&quot;/&gt;
  &lt;property name=&quot;standardPackageRegExp&quot; value=&quot;^(java|javax)\.&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
package com.company;

import static java.io.*; // OK
import static java.util.*; // OK
import java.time.*; // violation
import javax.net.*; // violation

import com.puppycrawl.tools.checkstyle.checks.imports.CustomImportOrderCheck; // OK
import com.puppycrawl.tools.checkstyle.checks.imports.ImportOrderCheck; // OK
import org.apache.commons.io.FileUtils; // OK
        </source>
        <p>
          Also, this check can be configured to force empty line separator between
          import groups. For example.
        </p>
        <source>
&lt;module name=&quot;CustomImportOrder&quot;&gt;
  &lt;property name=&quot;separateLineBetweenGroups&quot; value=&quot;true&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
package com.company;

import static java.io.*; // OK
import static java.util.*; // OK
import java.time.*; // OK
import javax.net.*; // OK
import com.puppycrawl.tools.checkstyle.checks.imports.CustomImportOrderCheck; // OK
import com.puppycrawl.tools.checkstyle.checks.imports.ImportOrderCheck; // OK
import org.apache.commons.io.FileUtils; // OK
        </source>
        <p>
          It is possible to enforce <a href="https://en.wikipedia.org/wiki/ASCII#Order">
          ASCII sort order</a>
          of imports in groups using the following configuration:
        </p>
        <source>
&lt;module name=&quot;CustomImportOrder&quot;&gt;
  &lt;property name=&quot;sortImportsInGroupAlphabetically&quot; value=&quot;true&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example of ASCII order:
        </p>
        <source>
import java.awt.Dialog;
import java.awt.Window;
import java.awt.color.ColorSpace;
import java.awt.Frame; // violation here - in ASCII order 'F' should go before 'c',
                       // as all uppercase come before lowercase letters
        </source>
        <p>
          To force checking imports sequence such as:
        </p>
        <source>
package com.puppycrawl.tools.checkstyle.imports;

import com.google.common.annotations.GwtCompatible;
import com.google.common.annotations.Beta;
import com.google.common.annotations.VisibleForTesting;

import org.abego.treelayout.Configuration;

import static sun.tools.util.ModifierFilter.ALL_ACCESS;

import com.google.common.annotations.GwtCompatible; // violation here - should be in the
                                                    // THIRD_PARTY_PACKAGE group
import android.*;
        </source>
        <p>
          configure as follows:
        </p>
        <source>
&lt;module name=&quot;CustomImportOrder&quot;&gt;
  &lt;property name=&quot;customImportOrderRules&quot;
    value=&quot;SAME_PACKAGE(3)###THIRD_PARTY_PACKAGE###STATIC###SPECIAL_IMPORTS&quot;/&gt;
  &lt;property name=&quot;specialImportsRegExp&quot; value=&quot;^android\.&quot;/&gt;
&lt;/module&gt;
        </source>
      </subsection>

      <subsection name="Example of Usage" id="CustomImportOrder_Example_of_Usage">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources+filename%3Agoogle_checks.xml+repo%3Acheckstyle%2Fcheckstyle+CustomImportOrder">
            Google Style</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Aconfig+filename%3Acheckstyle_checks.xml+repo%3Acheckstyle%2Fcheckstyle+CustomImportOrder">
            Checkstyle Style</a>
          </li>
        </ul>
      </subsection>

      <subsection name="Violation Messages" id="CustomImportOrder_Violation_Messages">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22custom.import.order%22">
            custom.import.order</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22custom.import.order.lex%22">
            custom.import.order.lex</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22custom.import.order.line.separator%22">
            custom.import.order.line.separator</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22custom.import.order.nonGroup.expected%22">
            custom.import.order.nonGroup.expected</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22custom.import.order.nonGroup.import%22">
            custom.import.order.nonGroup.import</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22custom.import.order.separated.internally%22">
            custom.import.order.separated.internally</a>
          </li>
        </ul>
        <p>
          All messages can be customized if the default message doesn't suit you.
          Please <a href="config.html#Custom_messages">see the documentation</a> to learn how to.
        </p>
      </subsection>

      <subsection name="Package" id="CustomImportOrder_Package">
        <p>
          com.puppycrawl.tools.checkstyle.checks.imports
        </p>
      </subsection>

      <subsection name="Parent Module" id="CustomImportOrder_Parent_Module">
        <p>
          <a href="config.html#TreeWalker">TreeWalker</a>
        </p>
      </subsection>
    </section>

    <section name="IllegalImport">
      <p>Since Checkstyle 3.0</p>
      <subsection name="Description" id="IllegalImport_Description">
        <p>
          Checks for imports from a set of illegal packages.
        </p>
      </subsection>

      <subsection name="Notes" id="IllegalImport_Notes">
        <p>
          Note: By default, the check rejects all <code>sun.*</code> packages since
          programs that contain direct calls to the <code>sun.*</code> packages are
          <a href="https://www.oracle.com/java/technologies/faq-sun-packages.html">
          "not guaranteed to work on all Java-compatible platforms"</a>.
          To reject other packages, set property <code>illegalPkgs</code> to
          a list of the illegal packages.
        </p>
      </subsection>

      <subsection name="Properties" id="IllegalImport_Properties">
        <div class="wrapper">
          <table>
            <tr>
              <th>name</th>
              <th>description</th>
              <th>type</th>
              <th>default value</th>
              <th>since</th>
            </tr>
            <tr>
              <td>illegalPkgs</td>
              <td>Specify packages to reject, if <b>regexp</b> property is not set, checks if import
                is the part of package. If <b>regexp</b> property is set, then list of packages will
                be interpreted as regular expressions. Note, all properties for match will be used.
              </td>
              <td><a href="property_types.html#String.5B.5D">String[]</a></td>
              <td><code>sun</code></td>
              <td>3.0</td>
            </tr>
            <tr>
              <td>illegalClasses</td>
              <td>Specify class names to reject, if <b>regexp</b> property is not set, checks if
                import equals class name. If <b>regexp</b> property is set, then list of class names
                will be interpreted as regular expressions. Note, all properties for match will be
                used.</td>
              <td><a href="property_types.html#String.5B.5D">String[]</a></td>
              <td><code>{}</code></td>
              <td>7.8</td>
            </tr>
            <tr>
              <td>regexp</td>
              <td>
                Control whether the <code>illegalPkgs</code> and <code>illegalClasses</code>
                should be interpreted as regular expressions.
              </td>
              <td><a href="property_types.html#boolean">boolean</a></td>
              <td><code>false</code></td>
              <td>7.8</td>
            </tr>
          </table>
        </div>

      </subsection>

      <subsection name="Examples" id="IllegalImport_Examples">
        <p>
          To configure the check:
        </p>
        <source>
&lt;module name=&quot;IllegalImport&quot;/&gt;
        </source>

        <p>
          To configure the check so that it rejects packages <code>java.io.*</code>
          and <code>java.sql.*</code>:
        </p>
        <source>
&lt;module name=&quot;IllegalImport&quot;&gt;
  &lt;property name=&quot;illegalPkgs&quot; value=&quot;java.io, java.sql&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
            The following example shows class with no illegal imports
        </p>
        <source>
import java.lang.ArithmeticException;
import java.util.List;
import java.util.Enumeration;
import java.util.Arrays;
import sun.applet.*;

public class InputIllegalImport { }
        </source>
        <p>
          The following example shows class with two illegal imports
        </p>
        <ul>
          <li><b>java.io.*</b>, illegalPkgs property contains this package</li>
          <li><b>java.sql.Connection</b> is inside java.sql package</li>
        </ul>
        <source>
import java.io.*;           // violation
import java.lang.ArithmeticException;
import java.sql.Connection; // violation
import java.util.List;
import java.util.Enumeration;
import java.util.Arrays;
import sun.applet.*;

public class InputIllegalImport { }
        </source>

        <p>
          To configure the check so that it rejects classes <code>java.util.Date</code> and
          <code>java.sql.Connection</code>:
        </p>
        <source>
&lt;module name=&quot;IllegalImport&quot;&gt;
  &lt;property name=&quot;illegalClasses&quot;
    value=&quot;java.util.Date, java.sql.Connection&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          The following example shows class with no illegal imports
        </p>
        <source>
import java.io.*;
import java.lang.ArithmeticException;
import java.util.List;
import java.util.Enumeration;
import java.util.Arrays;
import sun.applet.*;

public class InputIllegalImport { }
        </source>
        <p>
          The following example shows class with two illegal imports
        </p>
        <ul>
          <li><b>java.sql.Connection</b>, illegalClasses property contains this class</li>
          <li><b>java.util.Date</b>, illegalClasses property contains this class</li>
        </ul>
        <source>
import java.io.*;
import java.lang.ArithmeticException;
import java.sql.Connection; // violation
import java.util.List;
import java.util.Enumeration;
import java.util.Arrays;
import java.util.Date;      // violation
import sun.applet.*;

public class InputIllegalImport { }
        </source>

        <p>
          To configure the check so that it rejects packages not satisfying to regular
          expression <code>java\.util</code>:
        </p>
        <source>
&lt;module name=&quot;IllegalImport&quot;&gt;
  &lt;property name=&quot;regexp&quot; value=&quot;true&quot;/&gt;
  &lt;property name=&quot;illegalPkgs&quot; value=&quot;java\.util&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          The following example shows class with no illegal imports
        </p>
        <source>
import java.io.*;
import java.lang.ArithmeticException;
import java.sql.Connection;
import sun.applet.*;

public class InputIllegalImport { }
        </source>
        <p>
          The following example shows class with four illegal imports
        </p>
        <ul>
          <li><b>java.util.List</b></li>
          <li><b>java.util.Enumeration</b></li>
          <li><b>java.util.Arrays</b></li>
          <li><b>java.util.Date</b></li>
        </ul>
        <p>
          All four imports match "java\.util" regular expression
        </p>
        <source>
import java.io.*;
import java.lang.ArithmeticException;
import java.sql.Connection;
import java.util.List;          // violation
import java.util.Enumeration;   // violation
import java.util.Arrays;        // violation
import java.util.Date;          // violation
import sun.applet.*;

public class InputIllegalImport { }
        </source>

        <p>
          To configure the check so that it rejects class names not satisfying to regular
          expression <code>^java\.util\.(List|Arrays)</code> and
          <code>^java\.sql\.Connection</code>:
        </p>
        <source>
&lt;module name=&quot;IllegalImport&quot;&gt;
  &lt;property name=&quot;regexp&quot; value=&quot;true&quot;/&gt;
  &lt;property name=&quot;illegalClasses&quot;
    value=&quot;^java\.util\.(List|Arrays), ^java\.sql\.Connection&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          The following example shows class with no illegal imports
        </p>
        <source>
import java.io.*;
import java.lang.ArithmeticException;
import java.util.Enumeration;
import java.util.Date;
import sun.applet.*;

public class InputIllegalImport { }
        </source>
        <p>
          The following example shows class with three illegal imports
        </p>
        <ul>
          <li><b>java.sql.Connection</b> matches "^java\.sql\.Connection" regular expression</li>
          <li><b>java.util.List</b> matches "^java\.util\.(List|Arrays)" regular expression</li>
          <li><b>java.util.Arrays</b> matches "^java\.util\.(List|Arrays)" regular expression</li>
        </ul>
        <source>
import java.io.*;
import java.lang.ArithmeticException;
import java.sql.Connection;     // violation
import java.util.List;          // violation
import java.util.Enumeration;
import java.util.Arrays;        // violation
import java.util.Date;
import sun.applet.*;

public class InputIllegalImport { }
        </source>
      </subsection>

      <subsection name="Example of Usage" id="IllegalImport_Example_of_Usage">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources+filename%3Asun_checks.xml+repo%3Acheckstyle%2Fcheckstyle+IllegalImport">
            Sun Style</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Aconfig+filename%3Acheckstyle_checks.xml+repo%3Acheckstyle%2Fcheckstyle+IllegalImport">
            Checkstyle Style</a>
          </li>
        </ul>
      </subsection>

      <subsection name="Violation Messages" id="IllegalImport_Violation_Messages">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22import.illegal%22">
            import.illegal</a>
          </li>
        </ul>
        <p>
          All messages can be customized if the default message doesn't suit you.
          Please <a href="config.html#Custom_messages">see the documentation</a> to learn how to.
        </p>
      </subsection>

      <subsection name="Package" id="IllegalImport_Package">
        <p>
          com.puppycrawl.tools.checkstyle.checks.imports
        </p>
      </subsection>

      <subsection name="Parent Module" id="IllegalImport_Parent_Module">
        <p>
          <a href="config.html#TreeWalker">TreeWalker</a>
        </p>
      </subsection>
    </section>

    <section name="ImportControl">
      <p>Since Checkstyle 4.0</p>
      <subsection name="Description" id="ImportControl_Description">
        <p>
          Controls what can be imported in each package and file. Useful for
          ensuring that application layering rules are not violated,
          especially on large projects.
        </p>
        <p>
          You can control imports based on the package name or based on the file
          name. When controlling packages, all files and sub-packages in the declared
          package will be controlled by this check. To specify differences between a main package
          and a sub-package, you must define the sub-package inside the main package. When
          controlling file, only the file name is considered and only files processed by
          <a href="config.html#TreeWalker">TreeWalker</a>. The file's extension is ignored.
        </p>

        <p>
          Short description of the behaviour:
        </p>
        <ul>
          <li>Check starts checking from the longest matching subpackage (later 'current
            subpackage') or the first file name match described inside import
            control file to package defined in class file.
            <ul>
              <li>
                The longest matching subpackage is found by starting with the root package
                and examining if any of the sub-packages or file definitions match the
                current class' package or file name.
              </li>
              <li>
                If a file name is matched first, that is considered the longest
                match and becomes the current file/subpackage.
              </li>
              <li>
                If another subpackage is matched, then it's subpackages and file
                names are examined for the next longest match and the process repeats
                recursively.
              </li>
              <li>
                If no subpackages or file names are matched, the current subpackage
                is then used.
              </li>
            </ul>
          </li>
          <li>
            Order of rules in the same subpackage/root are defined by the order of
            declaration in the XML file, which is from top (first) to bottom (last).
          </li>
          <li>
            If there is matching allow/disallow rule inside the current file/subpackage
            then the Check returns the first "allowed" or "disallowed" message.
          </li>
          <li>
            If there is no matching allow/disallow rule inside the current file/subpackage
            then it continues checking in the parent subpackage.
          </li>
          <li>
            If there is no matching allow/disallow rule in any of the files/subpackages,
            including the root level (import-control), then the import is disallowed by default.
          </li>
        </ul>

        <p>
          The DTD for an import control XML document is at <a
          href="/dtds/import_control_1_4.dtd">
          https://checkstyle.org/dtds/import_control_1_4.dtd</a>. It
          contains documentation on each of the elements and attributes.
        </p>

        <p>
          The check validates a XML document when it loads the document.
          To validate against the above DTD, include the following
          document type declaration in your XML document:
        </p>

        <div class="wrapper">
          <pre>
&lt;!DOCTYPE import-control PUBLIC
    &quot;-//Checkstyle//DTD ImportControl Configuration 1.4//EN&quot;
    &quot;https://checkstyle.org/dtds/import_control_1_4.dtd&quot;&gt;
          </pre>
        </div>
      </subsection>

      <subsection name="Properties" id="ImportControl_Properties">
        <div class="wrapper">
          <table>
            <tr>
              <th>name</th>
              <th>description</th>
              <th>type</th>
              <th>default value</th>
              <th>since</th>
            </tr>
            <tr>
              <td>file</td>
              <td>
                Specify the location of the file containing the import control configuration.
                It can be a regular file, URL or resource path. It will try loading
                the path as a URL first, then as a file, and finally as a resource.
              </td>
              <td><a href="property_types.html#URI">URI</a></td>
              <td><code>null</code></td>
              <td>4.0</td>
            </tr>
            <tr>
              <td>path</td>
              <td>
                Specify the regular expression of file paths to which this check should apply. Files
                that don't match the pattern will not be checked. The pattern will be matched
                against the full absolute file path.
              </td>
              <td><a href="property_types.html#Pattern">Pattern</a></td>
              <td><code>".*"</code></td>
              <td>7.5</td>
            </tr>
          </table>
        </div>
      </subsection>

      <subsection name="Examples" id="ImportControl_Examples">
        <p>
          To configure the check using an import control file called
          &quot;config/import-control.xml&quot;, then have the following:
        </p>

        <source>
&lt;module name=&quot;ImportControl&quot;&gt;
  &lt;property name=&quot;file&quot; value=&quot;config/import-control.xml&quot;/&gt;
&lt;/module&gt;
        </source>

        <p>
          To configure the check to only check the &quot;src/main&quot; directory
          using an import control file called &quot;config/import-control.xml&quot;,
          then have the following:
        </p>

        <source>
&lt;module name=&quot;ImportControl&quot;&gt;
  &lt;property name=&quot;file&quot; value=&quot;config/import-control.xml&quot;/&gt;
  &lt;property name=&quot;path&quot; value=&quot;^.*[\\/]src[\\/]main[\\/].*$&quot;/&gt;
&lt;/module&gt;
        </source>

        <p>
          In the example below access to package
          <code>com.puppycrawl.tools.checkstyle.checks</code> and its subpackages is
          allowed from anywhere in <code>com.puppycrawl.tools.checkstyle</code> except
          from the <code>filters</code> subpackage where access to all
          <code>check</code>'s subpackages is disallowed. Two <code>java.lang.ref</code>
          classes are allowed by virtue of one regular expression instead of listing
          them in two separate allow rules (as it is done with the <code>Files</code>
          and <code>ClassPath</code> classes).
        </p>

        <source>
&lt;import-control pkg=&quot;com.puppycrawl.tools.checkstyle&quot;&gt;
  &lt;disallow pkg=&quot;sun&quot;/&gt;
  &lt;allow pkg=&quot;com.puppycrawl.tools.checkstyle.api&quot;/&gt;
  &lt;allow pkg=&quot;com.puppycrawl.tools.checkstyle.checks&quot;/&gt;
  &lt;allow class=&quot;com.google.common.io.Files&quot;/&gt;
  &lt;allow class=&quot;com.google.common.reflect.ClassPath&quot;/&gt;
  &lt;subpackage name=&quot;filters&quot;&gt;
    &lt;allow class=&quot;java\.lang\.ref\.(Weak|Soft)Reference&quot;
      regex=&quot;true&quot;/&gt;
    &lt;disallow pkg=&quot;com\.puppycrawl\.tools\.checkstyle\.checks\.[^.]+&quot;
      regex=&quot;true&quot;/&gt;
    &lt;disallow pkg=&quot;com.puppycrawl.tools.checkstyle.ant&quot;/&gt;
    &lt;disallow pkg=&quot;com.puppycrawl.tools.checkstyle.gui&quot;/&gt;
  &lt;/subpackage&gt;
  &lt;subpackage name=&quot;dao&quot;&gt;
    &lt;disallow pkg=&quot;javax.swing&quot; exact-match=&quot;true&quot;/&gt;
  &lt;/subpackage&gt;
&lt;/import-control&gt;
        </source>

        <p>
          In the next example regular expressions are used to enforce a layering rule: In all
          <code>dao</code> packages it is not allowed to access UI layer code (<code>ui</code>,
          <code>awt</code>, and <code>swing</code>). On the other hand it is not allowed to directly
          access <code>dao</code> and <code>service</code> layer from <code>ui</code> packages. The
          root package is also a regular expression that is used to handle old and new domain name
          with the same rules.
        </p>

        <source>
&lt;import-control pkg=&quot;(de.olddomain|de.newdomain)\..*&quot; regex=&quot;true&quot;&gt;
  &lt;subpackage pkg=&quot;[^.]+\.dao&quot; regex=&quot;true&quot;&gt;
    &lt;disallow pkg=&quot;.*\.ui&quot; regex=&quot;true&quot;/&gt;
    &lt;disallow pkg=&quot;.*\.(awt|swing).\.*&quot; regex=&quot;true&quot;/&gt;
  &lt;/subpackage&gt;
  &lt;subpackage pkg=&quot;[^.]+\.ui&quot; regex=&quot;true&quot;&gt;
    &lt;disallow pkg=&quot;.*\.(dao|service)&quot; regex=&quot;true&quot;/&gt;
  &lt;/subpackage&gt;
&lt;/import-control&gt;
        </source>

        <p>
          In the next examples usage of <code>strategyOnMismatch</code> property is shown.
          This property defines strategy in a case when no matching allow/disallow rule was found.
          Property <code>strategyOnMismatch</code> is attribute of <code>import-control</code> and
          <code>subpackage</code> tags.
          Property can have the following values for <code>import-control</code> tag:
        </p>
        <ul>
          <li>disallowed (default value) - if there is no matching allow/disallow rule in any of
              the subpackages, including the root level (import-control), then the import is
              disallowed.</li>
          <li>allowed - if there is no matching allow/disallow rule in any of the subpackages,
              including the root level, then the import is allowed.</li>
        </ul>
        <p>
          And following values for <code>subpackage</code> tags:
        </p>
        <ul>
          <li>delegateToParent (default value) - if there is no matching allow/disallow rule
              inside the current subpackage, then it continues checking in the parent
              subpackage.</li>
          <li>allowed - if there is no matching allow/disallow rule inside the current
              subpackage, then the import is allowed.</li>
          <li>disallowed - if there is no matching allow/disallow rule inside the current
              subpackage, then the import is disallowed.</li>
        </ul>

        <p>
          The following example demonstrates usage of <code>strategyOnMismatch</code> property for
          <code>import-control</code> tag. Here all imports are allowed except
          <code>java.awt.Image</code> and <code>java.io.File</code> classes.
        </p>
        <source>
&lt;import-control pkg=&quot;com.puppycrawl.tools.checkstyle.checks&quot;
  strategyOnMismatch=&quot;allowed&quot;&gt;
  &lt;disallow class=&quot;java.awt.Image&quot;/&gt;
  &lt;disallow class=&quot;java.io.File&quot;/&gt;
&lt;/import-control&gt;
        </source>

        <p>
          In the example below, any import is disallowed inside
          <code>com.puppycrawl.tools.checkstyle.checks.imports</code> package except imports from
          package <code>javax.swing</code> and class <code>java.io.File</code>.
          However, any import is allowed in the classes outside of
          <code>com.puppycrawl.tools.checkstyle.checks.imports</code> package.
        </p>
        <source>
&lt;import-control pkg=&quot;com.puppycrawl.tools.checkstyle.checks&quot;
  strategyOnMismatch=&quot;allowed&quot;&gt;
  &lt;subpackage name=&quot;imports&quot; strategyOnMismatch=&quot;disallowed&quot;&gt;
    &lt;allow pkg=&quot;javax.swing&quot;/&gt;
    &lt;allow class=&quot;java.io.File&quot;/&gt;
  &lt;/subpackage&gt;
&lt;/import-control&gt;
        </source>

        <p>
          When <code>strategyOnMismatch</code> has <code>allowed</code> or <code>disallowed</code>
          value for <code>subpackage</code> tag, it makes <code>subpackage</code> isolated from
          parent rules.
          In the next example, if no matching rule was found inside
          <code>com.puppycrawl.tools.checkstyle.checks.filters</code> then it continues checking
          in the parent subpackage, while for
          <code>com.puppycrawl.tools.checkstyle.checks.imports</code> import will be allowed by
          default.
        </p>
        <source>
&lt;import-control pkg=&quot;com.puppycrawl.tools.checkstyle.checks&quot;&gt;
  &lt;allow class=&quot;java\.awt\.Image&quot; regex=&quot;true&quot;/&gt;
  &lt;allow class=&quot;java\..*\.File&quot; local-only=&quot;true&quot; regex=&quot;true&quot;/&gt;
  &lt;subpackage name=&quot;imports&quot; strategyOnMismatch=&quot;allowed&quot;&gt;
    &lt;allow pkg=&quot;javax\.swing&quot; regex=&quot;true&quot;/&gt;
    &lt;allow pkg=&quot;java\.io&quot; exact-match=&quot;true&quot;
      local-only=&quot;true&quot; regex=&quot;true&quot;/&gt;
  &lt;/subpackage&gt;
  &lt;subpackage name=&quot;filters&quot;&gt;
    &lt;allow class=&quot;javax.util.Date&quot;/&gt;
  &lt;/subpackage&gt;
&lt;/import-control&gt;
        </source>
        <p>
          In the example below, only file names that end with "Panel", "View", or "Dialog"
          in the package <code>gui</code> are disallowed to have imports from
          <code>com.mycompany.dao</code> and any <code>jdbc</code> package. In addition, only
          the file name named "PresentationModel" in the package <code>gui</code> are
          disallowed to have imports that match <code>javax.swing.J*</code>.
          All other imports in the package are allowed.
        </p>
        <source>
&lt;import-control pkg=&quot;com.mycompany.billing&quot;&gt;
  &lt;subpackage name=&quot;gui&quot; strategyOnMismatch=&quot;allowed&quot;&gt;
    &lt;file name=&quot;.*(Panel|View|Dialog)&quot; regex=&quot;true&quot;&gt;
      &lt;disallow pkg=&quot;com.mycompany.dao&quot;/&gt;
      &lt;disallow pkg=&quot;.*\.jdbc&quot; regex=&quot;true&quot;/&gt;
    &lt;/file&gt;
    &lt;file name=&quot;PresentationModel&quot;&gt;
      &lt;disallow pkg=&quot;javax\.swing\.J.*&quot; regex=&quot;true&quot;/&gt;
    &lt;/file&gt;
  &lt;/subpackage&gt;
&lt;/import-control&gt;
        </source>

        <p>
          For a real-life import control file look at the file called <a
          href="https://github.com/checkstyle/checkstyle/blob/master/config/import-control.xml">
          import-control.xml</a>
          which is part of the Checkstyle distribution.
        </p>

        <h4 id="blacklist-example">Example of blacklist mode</h4>
        <p>
          To have a <b>blacklist mode</b>, it is required to have disallows inside subpackage
          and to have allow rule inside parent of the current subpackage to catch classes and
          packages those are not in the blacklist.
        </p>
        <p>
          In the example below any import from <code>java.util</code>
          (<code>java.util.List</code>, <code>java.util.Date</code>) package is allowed except
          <code>java.util.Map</code> inside subpackage
          <code>com.puppycrawl.tools.checkstyle.filters</code>.
        </p>
        <source>
&lt;import-control pkg=&quot;com.puppycrawl.tools.checkstyle&quot;&gt;
  &lt;allow pkg=&quot;java.util&quot;/&gt;
  &lt;subpackage name=&quot;filters&quot; &gt;
    &lt;disallow class=&quot;java.util.Map&quot;/&gt;
  &lt;/subpackage&gt;
&lt;/import-control&gt;
        </source>
        <p>
          In the next example imports <code>java.util.stream.Stream</code> and
          <code>java.util.stream.Collectors</code> are disallowed inside
          <code>com.puppycrawl.tools.checkstyle.checks.imports</code> package,
          but because of <code>&lt;allow pkg=&quot;java.util.stream&quot;/&gt;</code> every import
          from <code>java.util.stream</code> is allowed except described ones.
        </p>
        <source>
&lt;import-control pkg=&quot;com.puppycrawl.tools.checkstyle.checks&quot;&gt;
  &lt;allow pkg=&quot;java.util.stream&quot;/&gt;
  &lt;subpackage name=&quot;imports&quot;&gt;
    &lt;disallow class=&quot;java.util.stream.Stream&quot;/&gt;
    &lt;disallow class=&quot;java.util.stream.Collectors&quot;/&gt;
  &lt;/subpackage&gt;
&lt;/import-control&gt;
        </source>

        <source>
package com.puppycrawl.tools.checkstyle.checks.imports;

import java.util.stream.Stream;     // violation here
import java.util.stream.Collectors; // violation here
import java.util.stream.IntStream;
        </source>
        <p>
          In the following example, all imports are allowed except the classes
          <code>java.util.Date</code>, <code>java.util.List</code> and package <code>sun</code>.
        </p>
        <source>
&lt;import-control pkg=&quot;com.puppycrawl.tools.checkstyle.checks&quot;&gt;
  &lt;allow pkg=&quot;.*&quot; regex=&quot;true&quot;/&gt;
  &lt;subpackage name=&quot;imports&quot;&gt;
    &lt;disallow class=&quot;java.util.Date&quot;/&gt;
    &lt;disallow class=&quot;java.util.List&quot;/&gt;
    &lt;disallow pkg=&quot;sun&quot;/&gt;
  &lt;/subpackage&gt;
&lt;/import-control&gt;
        </source>
        <p>
          In the following example, all imports of the <code>java.util</code> package are allowed
          except the <code>java.util.Date</code> class.
        </p>
        <source>
&lt;import-control pkg=&quot;com.puppycrawl.tools.checkstyle.checks&quot;&gt;
  &lt;disallow class=&quot;java.util.Date&quot;/&gt;

  &lt;allow pkg=&quot;java.util&quot;/&gt;
&lt;/import-control&gt;
        </source>

        <h4 id="regex-notes">Notes on regular expressions</h4>
        <p>
          Regular expressions in import rules have to match either Java packages or
          classes. The language rules for packages and class names can be described by the
          following complicated regular expression that takes into account that Java names may
          contain any unicode letter, numbers, underscores, and dollar signs (see section 3.8
          in the <a href="https://docs.oracle.com/javase/specs/">Java specs</a>):
        </p>
        <ul>
          <li>
            <code>[\p{Letter}_$][\p{Letter}\p{Number}_$]*</code> or short
            <code>[\p{L}_$][\p{L}\p{N}_$]*</code> for a class name or package component.
          </li>
          <li>
            <code>([\p{L}_$][\p{L}\p{N}_$]*\.)*[\p{L}_$][\p{L}\p{N}_$]*</code>
            for a fully qualified name.
          </li>
        </ul>
        <p>
          But it is not necessary to use these complicated expressions since no validation is
          required. Differentiating between package separator '.' and others is
          sufficient. Unfortunately '.' has a special meaning in regular expressions so one has
          to write <code>\.</code> to match an actual dot.
        </p>
        <ul>
          <li>
            Use <code>[^.]+</code> (one or more "not a dot" characters) for a class name or
            package component.
          </li>
          <li>
            Use <code>com\.google\.common\.[^.]+</code> to match any subpackage of
            <code>com.google.common</code>.
          </li>
          <li>
            When matching concrete packages like <code>com.google.common</code> omitting the
            backslash before the dots may improve readability and may be just exact enough:
            <code>com.google.common\.[^.]+</code> matches not only subpackages of
            <code>com.google.common</code> but e.g. also of <code>com.googleecommon</code> but
            you may not care for that.
          </li>
          <li>
            Do not use <code>.*</code> unless you really do not care for what is matched. Often
            you want to match only a certain package level instead.
          </li>
        </ul>
        <h4 id="static-import-notes">Notes on static imports</h4>
        <p>
          Static members (including methods, constants and static inner classes) have to be
          explicitly allowed when they are imported, they
          are not automatically allowed along with their enclosing class.
        </p>
        <p>
          For example, to allow importing both <code>java.util.Map</code> and
          <code>java.util.Map.Entry</code> use the following configuration:
        </p>
        <source>
&lt;import-control pkg=&quot;com.puppycrawl.tools.checkstyle&quot;&gt;
  &lt;allow class=&quot;java.util.Map&quot;/&gt;
  &lt;allow class=&quot;java.util.Map.Entry&quot;/&gt;
&lt;/import-control&gt;
        </source>
        <p>It is also possible to use a regex with a wildcard:</p>
        <source>
&lt;import-control pkg=&quot;com.puppycrawl.tools.checkstyle&quot;&gt;
  &lt;allow class=&quot;java.util.Map&quot;/&gt;
  &lt;allow class=&quot;java.util.Map.*&quot; regex=&quot;true&quot; /&gt;
&lt;/import-control&gt;
        </source>
      </subsection>

      <subsection name="Example of Usage" id="ImportControl_Example_of_Usage">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Aconfig+filename%3Acheckstyle_checks.xml+repo%3Acheckstyle%2Fcheckstyle+ImportControl">
            Checkstyle Style</a>
          </li>
        </ul>
      </subsection>

      <subsection name="Violation Messages" id="ImportControl_Violation_Messages">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22import.control.disallowed%22">
            import.control.disallowed</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22import.control.missing.file%22">
            import.control.missing.file</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22import.control.unknown.pkg%22">
            import.control.unknown.pkg</a>
          </li>
        </ul>
        <p>
          All messages can be customized if the default message doesn't suit you.
          Please <a href="config.html#Custom_messages">see the documentation</a> to learn how to.
        </p>
      </subsection>

      <subsection name="Package" id="ImportControl_Package">
        <p>
          com.puppycrawl.tools.checkstyle.checks.imports
        </p>
      </subsection>

      <subsection name="Parent Module" id="ImportControl_Parent_Module">
        <p>
          <a href="config.html#TreeWalker">TreeWalker</a>
        </p>
      </subsection>
    </section>

    <section name="ImportOrder">
      <p>Since Checkstyle 3.2</p>
      <subsection name="Description" id="ImportOrder_Description">
        <p>Checks the ordering/grouping of imports. Features are:</p>
        <ul>
          <li>groups type/static imports: ensures that groups of imports come in a
          specific order (e.g., java. comes first, javax. comes second,
          then everything else)</li>
          <li>adds a separation between type import groups : ensures that a blank
          line sit between each group</li>
          <li>type/static import groups aren't separated internally: ensures that
          each group aren't separated internally by blank line or comment</li>
          <li>sorts type/static imports inside each group: ensures that imports
          within each group are in lexicographic order</li>
          <li>
            sorts according to case: ensures that the comparison
            between imports is case-sensitive, in
            <a href="https://en.wikipedia.org/wiki/ASCII#Order">ASCII sort order</a>
          </li>
          <li>
            arrange static imports: ensures the relative order between
            type imports and static imports (see
            <a href="property_types.html#ImportOrderOption">ImportOrderOption</a>)
          </li>
        </ul>
      </subsection>

      <subsection name="Properties" id="ImportOrder_Properties">
        <div class="wrapper">
          <table>
            <tr>
              <th>name</th>
              <th>description</th>
              <th>type</th>
              <th>default value</th>
              <th>since</th>
            </tr>
            <tr>
              <td>option</td>
              <td>specify policy on the relative order between type imports and static imports.</td>
              <td><a href="property_types.html#ImportOrderOption">ImportOrderOption</a></td>
              <td><code>under</code></td>
              <td>5.0</td>
            </tr>
            <tr>
              <td>groups</td>
              <td>
                specify list of <b>type import</b> groups. Every group identified either by a
                common prefix string, or by a regular expression enclosed
                in forward slashes (e.g. <code>/regexp/</code>). All type imports,
                which does not match any group, falls into an additional group, located at the end.
                Thus, the empty list of type groups (the default value) means
                one group for all type imports.
              </td>
              <td><a href="property_types.html#Pattern.5B.5D">Pattern[]</a></td>
              <td><code>{}</code></td>
              <td>3.2</td>
            </tr>
            <tr>
              <td>ordered</td>
              <td>control whether type imports within each group should be sorted.
                It doesn't affect sorting for static imports.</td>
              <td><a href="property_types.html#boolean">boolean</a></td>
              <td><code>true</code></td>
              <td>3.2</td>
            </tr>
            <tr>
              <td>separated</td>
              <td>
                control whether type import groups should be separated by, at least, one
                blank line or comment and aren't separated internally.
                It doesn't affect separations for static imports.
              </td>
              <td><a href="property_types.html#boolean">boolean</a></td>
              <td><code>false</code></td>
              <td>3.2</td>
            </tr>
            <tr>
              <td>separatedStaticGroups</td>
              <td>
                control whether static import groups should be separated by, at least, one
                blank line or comment and aren't separated internally.
                This property has effect only when the property <code>option</code>
                is set to <code>top</code> or <code>bottom</code> and when property
                <code>staticGroups</code> is enabled.
              </td>
              <td><a href="property_types.html#boolean">boolean</a></td>
              <td><code>false</code></td>
              <td>8.12</td>
            </tr>
            <tr>
              <td>caseSensitive</td>
              <td>control whether string comparison should be case-sensitive or not.
                Case-sensitive sorting is in
                <a href="https://en.wikipedia.org/wiki/ASCII#Order">ASCII sort order</a>.
                It affects both type imports and static imports.
              </td>
              <td><a href="property_types.html#boolean">boolean</a></td>
              <td><code>true</code></td>
              <td>3.3</td>
            </tr>
            <tr>
              <td>staticGroups</td>
              <td>
                specify list of <b>static</b> import groups. Every group identified either by a
                common prefix string, or by a regular expression enclosed
                in forward slashes (e.g. <code>/regexp/</code>). All static imports,
                which does not match any group, fall into an additional group, located at the
                end. Thus, the empty list of static groups (the default value) means
                one group for all static imports. This property has effect only when
                the property <code>option</code> is set to <code>top</code> or
                <code>bottom</code>.
              </td>
              <td><a href="property_types.html#Pattern.5B.5D">Pattern[]</a></td>
              <td><code>{}</code></td>
              <td>8.12</td>
            </tr>
            <tr>
              <td>sortStaticImportsAlphabetically</td>
              <td>
                control whether <b>static imports</b> located at <b>top</b> or
                <b>bottom</b> are sorted within the group.
              </td>
              <td><a href="property_types.html#boolean">boolean</a></td>
              <td><code>false</code></td>
              <td>6.5</td>
            </tr>
            <tr>
              <td>useContainerOrderingForStatic</td>
              <td>
                control whether to use container ordering (Eclipse IDE term) for static
                imports or not.</td>
              <td><a href="property_types.html#boolean">boolean</a></td>
              <td><code>false</code></td>
              <td>7.1</td>
            </tr>
          </table>
        </div>
      </subsection>

      <subsection name="Examples" id="ImportOrder_Examples">
        <p>
          To configure the check:
        </p>
        <source>
&lt;module name=&quot;ImportOrder&quot;/&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
import java.io.IOException;
import java.net.URL;

import java.io.IOException; // violation, extra separation before import
                            // and wrong order, comes before 'java.net.URL'.
import javax.net.ssl.TrustManager; // violation, extra separation due to above comment
import javax.swing.JComponent;
import org.apache.http.conn.ClientConnectionManager; // OK
import java.util.Set; // violation, wrong order, 'java' should not come after 'org' imports
import com.neurologic.http.HttpClient; // violation, wrong order, 'com' imports comes at top
import com.neurologic.http.impl.ApacheHttpClient; // OK

public class SomeClass { }
        </source>
        <p>
          To configure the check so that it matches default Eclipse formatter configuration
          (tested on Kepler and Luna releases):
        </p>
        <ul>
          <li>group of static imports is on the top</li>
          <li>groups of type imports: &quot;java&quot; and &quot;javax&quot; packages first,
              then &quot;org&quot; and then all other imports</li>
          <li>imports will be sorted in the groups</li>
          <li>groups are separated by, at least, one blank line and aren't separated internally</li>
        </ul>
        <p>Notes:</p>
        <ul>
          <li>&quot;com&quot; package is not mentioned on configuration, because it is
              ignored by Eclipse Kepler and Luna (looks like Eclipse defect)</li>
          <li>configuration below doesn't work in all 100% cases due to inconsistent behavior
              prior to Mars release, but covers most scenarios</li>
        </ul>
        <source>
&lt;module name=&quot;ImportOrder&quot;&gt;
  &lt;property name=&quot;groups&quot; value=&quot;/^java\./,javax,org&quot;/&gt;
  &lt;property name=&quot;ordered&quot; value=&quot;true&quot;/&gt;
  &lt;property name=&quot;separated&quot; value=&quot;true&quot;/&gt;
  &lt;property name=&quot;option&quot; value=&quot;above&quot;/&gt;
  &lt;property name=&quot;sortStaticImportsAlphabetically&quot; value=&quot;true&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
import static java.lang.System.out;
import static java.lang.Math; // violation, alphabetical case-sensitive ASCII order, 'M' &lt; 'S'
import java.io.IOException;

import java.net.URL; // violation, extra separation before import
import java.security.KeyManagementException;

import javax.net.ssl.TrustManager;

import javax.net.ssl.X509TrustManager; // violation, groups should not be separated internally

import org.apache.http.conn.ClientConnectionManager;

public class SomeClass { }
        </source>
        <p>
          To configure the check so that it matches default Eclipse formatter configuration
          (tested on Mars release):
        </p>
        <ul>
          <li>group of static imports is on the top</li>
          <li>groups of type imports: &quot;java&quot; and &quot;javax&quot; packages first,
              then &quot;org&quot; and &quot;com&quot;, then all other imports as one group</li>
          <li>imports will be sorted in the groups</li>
          <li>groups are separated by, at least, one blank line and aren't separated internally</li>
        </ul>

        <source>
&lt;module name=&quot;ImportOrder&quot;&gt;
  &lt;property name=&quot;groups&quot; value=&quot;/^java\./,javax,org,com&quot;/&gt;
  &lt;property name=&quot;ordered&quot; value=&quot;true&quot;/&gt;
  &lt;property name=&quot;separated&quot; value=&quot;true&quot;/&gt;
  &lt;property name=&quot;option&quot; value=&quot;above&quot;/&gt;
  &lt;property name=&quot;sortStaticImportsAlphabetically&quot; value=&quot;true&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
import static java.io.File.createTempFile;
import static java.lang.Math.abs; // OK, alphabetical case-sensitive ASCII order, 'i' &lt; 'l'
import java.lang.Math.sqrt; // OK, follows property 'Option' value 'above'
import java.io.File; // violation, alphabetical case-sensitive ASCII order, 'i' &lt; 'l'

import java.io.IOException; // violation, extra separation in 'java' import group

import org.albedo.*;

import static javax.WindowConstants.*; // violation, wrong order, 'javax' comes before 'org'
import javax.swing.JComponent;
import org.apache.http.ClientConnectionManager; // violation, must separate from previous import
import org.linux.apache.server.SoapServer; // OK

import com.neurologic.http.HttpClient; // OK
import com.neurologic.http.impl.ApacheHttpClient; // OK

public class SomeClass { }
        </source>
        <p>
          To configure the check so that it matches default IntelliJ IDEA formatter
          configuration (tested on v2018.2):
        </p>
        <ul>
          <li>group of static imports is on the bottom</li>
          <li>groups of type imports: all imports except of &quot;javax&quot;
              and &quot;java&quot;, then &quot;javax&quot; and &quot;java&quot;</li>
          <li>imports will be sorted in the groups</li>
          <li>groups are separated by, at least, one blank line and aren't separated internally</li>
        </ul>
        <p>
          Note: a <a href="config_filters.html#SuppressionXpathSingleFilter">
          suppression xpath single filter</a>
          is needed because IDEA has no blank line between "javax" and "java".
          ImportOrder has a limitation by design to enforce an empty line between groups
          ("java", "javax"). There is no flexibility to enforce empty lines between some
          groups and no empty lines between other groups.
        </p>
        <p>
          Note: "separated" option is disabled because IDEA default has blank line
          between "java" and static imports, and no blank line between "javax" and "java".
        </p>
        <source>
&lt;module name=&quot;ImportOrder&quot;&gt;
  &lt;property name=&quot;groups&quot; value=&quot;*,javax,java&quot;/&gt;
  &lt;property name=&quot;ordered&quot; value=&quot;true&quot;/&gt;
  &lt;property name=&quot;separated&quot; value=&quot;false&quot;/&gt;
  &lt;property name=&quot;option&quot; value=&quot;bottom&quot;/&gt;
  &lt;property name=&quot;sortStaticImportsAlphabetically&quot; value=&quot;true&quot;/&gt;
&lt;/module&gt;
&lt;module name="SuppressionXpathSingleFilter"&gt;
  &lt;property name="checks" value="ImportOrder"/&gt;
  &lt;property name="message" value="^'java\..*'.*"/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
import com.neurologic.http.impl.ApacheHttpClient; // OK
import static java.awt.Button.A;
import javax.swing.JComponent; // violation, wrong order, caused by above static import
                               // all static imports comes at bottom
import java.net.URL; // violation, extra separation in import group
import java.security.KeyManagementException;
import javax.swing.JComponent; // violation, wrong order, 'javax' should be above 'java' imports
import com.neurologic.http.HttpClient; // violation, wrong order, 'com' imports should be at top

public class TestClass { }
        </source>
        <p>
          To configure the check so that it matches default NetBeans formatter configuration
          (tested on v8):
        </p>
        <ul>
          <li>groups of type imports are not defined, all imports will be sorted as a one
              group</li>
          <li>static imports are not separated, they will be sorted along with other imports</li>
        </ul>
        <source>
&lt;module name=&quot;ImportOrder&quot;&gt;
  &lt;property name=&quot;option&quot; value=&quot;inflow&quot;/&gt;
&lt;/module&gt;
        </source>
        <p>
          Example:
        </p>
        <source>
import static java.io.File.createTempFile;
import java.lang.Math.sqrt;

import javax.swing.JComponent; // violation, extra separation in import group
import static javax.windowConstants.*; // OK
                                    // all static imports are processed like non static imports.
public class SomeClass { }
        </source>
        <p>
          Group descriptions enclosed in slashes are interpreted as regular expressions.
          If multiple groups match, the one matching a longer
          substring of the imported name will take precedence, with ties
          broken first in favor of earlier matches and finally in favor of
          the first matching group.
        </p>
        <p>
          There is always a wildcard group to which everything not in a named group
          belongs. If an import does not match a named group, the group belongs to
          this wildcard group. The wildcard group position can be specified using the
          <code>*</code> character.
        </p>
        <p>
          Check also has on option making it more flexible:
          <b>sortStaticImportsAlphabetically</b> - sets whether static imports grouped by
          <b>top</b> or <b>bottom</b> option should be sorted alphabetically or
          not, default value is <b>false</b>. It is applied to static imports grouped
          with <b>top</b> or <b>bottom</b> options. This option is helping in reconciling
          of this Check and other tools like Eclipse's Organize Imports feature.
        </p>
        <p>
          To configure the Check allows static imports grouped to the <b>top</b> being sorted
          alphabetically:
        </p>
        <source>
&lt;module name=&quot;ImportOrder&quot;&gt;
  &lt;property name=&quot;sortStaticImportsAlphabetically&quot; value=&quot;true&quot;/&gt;
  &lt;property name=&quot;option&quot; value=&quot;top&quot;/&gt;
&lt;/module&gt;
        </source>

        <source>
import static java.lang.Math.PI;
import static java.lang.Math.abs; // OK, alphabetical case-sensitive ASCII order, 'P' &lt; 'a'
import static org.abego.treelayout.Configuration.AlignmentInLevel; // OK, alphabetical order

import java.util.Set; // violation, extra separation in import group
import static java.lang.Math.abs; // violation, wrong order, all static imports comes at 'top'
import org.abego.*;

public class SomeClass { }
        </source>

        <p>
          To configure the Check with groups of static imports:
        </p>

        <source><![CDATA[
<module name="ImportOrder">
  <property name="staticGroups" value="org,java"/>
  <property name="sortStaticImportsAlphabetically" value="true"/>
  <property name="option" value="top"/>
</module>
        ]]></source>

        <source>
import static org.abego.treelayout.Configuration.AlignmentInLevel; // Group 1
import static java.lang.Math.abs; // Group 2
import static java.lang.String.format; // Group 2
import static com.google.common.primitives.Doubles.BYTES; // Group "everything else"

public class SomeClass { }
        </source>

        <p>
          The following example shows the idea of 'useContainerOrderingForStatic' option that is
          useful for Eclipse IDE users to match ordering validation.
          This is how the import comparison works for static imports: we first compare
          the container of the static import, container is the type enclosing the static element
          being imported. When the result of the comparison is 0 (containers are equal),
          we compare the fully qualified import names.
          For e.g. this is what is considered to be container names for the given example:

          import static HttpConstants.COLON     =&gt; HttpConstants
          import static HttpHeaders.addHeader   =&gt; HttpHeaders
          import static HttpHeaders.setHeader   =&gt; HttpHeaders
          import static HttpHeaders.Names.DATE  =&gt; HttpHeaders.Names

          According to this logic, HttpHeaders.Names should come after HttpHeaders.
        </p>
        <p>
          Example for <code>useContainerOrderingForStatic=true</code>
        </p>
        <source>
&lt;module name=&quot;ImportOrder&quot;&gt;
  &lt;property name=&quot;useContainerOrderingForStatic&quot; value=&quot;true&quot;/&gt;
  &lt;property name=&quot;ordered&quot; value=&quot;true&quot;/&gt;
  &lt;property name=&quot;option&quot; value=&quot;top&quot;/&gt;
  &lt;property name=&quot;caseSensitive&quot; value=&quot;false&quot;/&gt;
  &lt;property name=&quot;sortStaticImportsAlphabetically&quot; value=&quot;true&quot;/&gt;
&lt;/module&gt;
        </source>
        <source>
import static io.netty.handler.codec.http.HttpConstants.COLON;
import static io.netty.handler.codec.http.HttpHeaders.addHeader;
import static io.netty.handler.codec.http.HttpHeaders.setHeader;
import static io.netty.handler.codec.http.HttpHeaders.Names.DATE;

public class InputEclipseStaticImportsOrder { }
        </source>
        <p>
          Example for <code>useContainerOrderingForStatic=false</code>
        </p>
        <source>
&lt;module name=&quot;ImportOrder&quot;&gt;
  &lt;property name=&quot;useContainerOrderingForStatic&quot; value=&quot;false&quot;/&gt;
  &lt;property name=&quot;ordered&quot; value=&quot;true&quot;/&gt;
  &lt;property name=&quot;option&quot; value=&quot;top&quot;/&gt;
  &lt;property name=&quot;caseSensitive&quot; value=&quot;false&quot;/&gt;
  &lt;property name=&quot;sortStaticImportsAlphabetically&quot; value=&quot;true&quot;/&gt;
&lt;/module&gt;
        </source>
        <source>
import static io.netty.handler.codec.http.HttpConstants.COLON;
import static io.netty.handler.codec.http.HttpHeaders.addHeader;
import static io.netty.handler.codec.http.HttpHeaders.setHeader;
import static io.netty.handler.codec.http.HttpHeaders.Names.DATE; // violation

public class InputEclipseStaticImportsOrder { }
        </source>
        <p>
          To configure the check to enforce static import group separation
        </p>
        <p>
          Example for <code>separatedStaticGroups=true</code>
        </p>
        <source>
&lt;module name=&quot;ImportOrder&quot;&gt;
  &lt;property name=&quot;staticGroups&quot; value=&quot;*,java,javax,org&quot;/&gt;
  &lt;property name=&quot;option&quot; value=&quot;top&quot;/&gt;
  &lt;property name=&quot;separatedStaticGroups&quot; value=&quot;true&quot;/&gt;
&lt;/module&gt;
        </source>
        <source>
import static java.lang.Math.PI;
import static java.io.File.createTempFile;
import static javax.swing.JComponent; // violation, should be separated from previous imports
import static javax.WindowConstants.*; // OK

import java.net.URL;

public class SomeClass { }
        </source>
        <p>
          To configure the Check with groups of static imports when staticGroups=&quot;&quot;
          represents all imports as {@code everything else} group:
        </p>
        <source>
&lt;module name=&quot;ImportOrder&quot;&gt;
  &lt;property name=&quot;staticGroups&quot; value=&quot;&quot;/&gt;
  &lt;property name=&quot;option&quot; value=&quot;top&quot;/&gt;
&lt;/module&gt;
        </source>

        <source>
import static java.io.File.listRoots;   // OK
import static javax.swing.WindowConstants.*; // OK
import static java.io.File.createTempFile; // OK
import static com.puppycrawl.tools.checkstyle;  // OK

public class SomeClass { }
        </source>
        <p>
          To configure the Check with groups of static imports when
          staticGroups=&quot;java, javax&quot; represents three groups i.e java*, javax*
          and * (everything else). In below example the static imports <code> com...</code>
          should be in last group:
        </p>

        <source>
&lt;module name=&quot;ImportOrder&quot;&gt;
  &lt;property name=&quot;staticGroups&quot; value=&quot;java, javax&quot;/&gt;
  &lt;property name=&quot;option&quot; value=&quot;top&quot;/&gt;
&lt;/module&gt;
        </source>

        <source>
import static java.io.File.listRoots;   // OK
import static javax.swing.WindowConstants.*; // OK
import static java.io.File.createTempFile; // violation should be before javax
import static com.puppycrawl.tools.checkstyle;  // OK

public class SomeClass { }
        </source>
      </subsection>

      <subsection name="Example of Usage" id="ImportOrder_Example_of_Usage">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Aconfig+filename%3Acheckstyle_checks.xml+repo%3Acheckstyle%2Fcheckstyle+ImportOrder">
            Checkstyle Style</a>
          </li>
        </ul>
      </subsection>

      <subsection name="Violation Messages" id="ImportOrder_Violation_Messages">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22import.groups.separated.internally%22">
            import.groups.separated.internally</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22import.ordering%22">
            import.ordering</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22import.separation%22">
            import.separation</a>
          </li>
        </ul>
        <p>
          All messages can be customized if the default message doesn't suit you.
          Please <a href="config.html#Custom_messages">see the documentation</a> to learn how to.
        </p>
      </subsection>

      <subsection name="Package" id="ImportOrder_Package">
        <p>
          com.puppycrawl.tools.checkstyle.checks.imports
        </p>
      </subsection>

      <subsection name="Parent Module" id="ImportOrder_Parent_Module">
        <p>
          <a href="config.html#TreeWalker">TreeWalker</a>
        </p>
      </subsection>
    </section>

    <section name="RedundantImport">
      <p>Since Checkstyle 3.0</p>
      <subsection name="Description" id="RedundantImport_Description">
        <p>
          Checks for redundant import statements. An import statement is
          considered redundant if:
        </p>

        <ul>
          <li>
            It is a duplicate of another import. This is, when a class is
            imported more than once.
          </li>
          <li>
            The class non-statically imported is from the <code>java.lang</code>
            package, e.g. importing <code>java.lang.String</code>.
          </li>
          <li>
            The class non-statically imported is from the same package as the current package.
          </li>
        </ul>
      </subsection>

      <subsection name="Examples" id="RedundantImport_Examples">
        <p>
          To configure the check:
        </p>
        <source>
&lt;module name=&quot;RedundantImport&quot;/&gt;
        </source>
        <p>
            Example:
        </p>
        <source>
package Test;
import static Test.MyClass.*; // OK, static import
import static java.lang.Integer.MAX_VALUE; // OK, static import

import Test.MyClass; // violation, imported from the same package as the current package
import java.lang.String; // violation, the class imported is from the 'java.lang' package
import java.util.Scanner; // OK
import java.util.Scanner; // violation, it is a duplicate of another import
public class MyClass{ };
        </source>
      </subsection>

      <subsection name="Example of Usage" id="RedundantImport_Example_of_Usage">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources+filename%3Asun_checks.xml+repo%3Acheckstyle%2Fcheckstyle+RedundantImport">
            Sun Style</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Aconfig+filename%3Acheckstyle_checks.xml+repo%3Acheckstyle%2Fcheckstyle+RedundantImport">
            Checkstyle Style</a>
          </li>
        </ul>
      </subsection>

      <subsection name="Violation Messages" id="RedundantImport_Violation_Messages">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22import.duplicate%22">
            import.duplicate</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22import.lang%22">
            import.lang</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22import.same%22">
            import.same</a>
          </li>
        </ul>
        <p>
          All messages can be customized if the default message doesn't suit you.
          Please <a href="config.html#Custom_messages">see the documentation</a> to learn how to.
        </p>
      </subsection>

      <subsection name="Package" id="RedundantImport_Package">
        <p>
          com.puppycrawl.tools.checkstyle.checks.imports
        </p>
      </subsection>

      <subsection name="Parent Module" id="RedundantImport_Parent_Module">
        <p>
          <a href="config.html#TreeWalker">TreeWalker</a>
        </p>
      </subsection>
    </section>

    <section name="UnusedImports">
      <p>Since Checkstyle 3.0</p>
      <subsection name="Description" id="UnusedImports_Description">
        <p>
          Checks for unused import statements. Checkstyle uses a simple but
          very reliable algorithm to report on unused import statements. An
          import statement is considered unused if:
        </p>

        <ul>
          <li>
            It is not referenced in the file. The algorithm does not support
            wild-card imports like <code>import
            java.io.*;</code>. Most IDE's provide very sophisticated checks
            for imports that handle wild-card imports.
          </li>

          <li>
            It is a duplicate of another import. This is when a class is
            imported more than once.
          </li>

          <li>
            The class imported is from the <code>java.lang</code>
            package. For example importing <code>java.lang.String</code>.
          </li>

          <li>
            The class imported is from the same package.
          </li>
          <li>
            <b>Optionally:</b> it is referenced in Javadoc comments. This check
            is on by default, but it is considered bad practice to introduce
            a compile-time dependency for documentation purposes only.
            As an example, the import <code>java.util.List</code> would be
            considered referenced with the Javadoc comment
            <code>{@link List}</code>. The alternative to avoid introducing a
            compile-time dependency would be to write the Javadoc comment as
            <code>{@link java.util.List}</code>.
          </li>
        </ul>
        <p>
          The main limitation of this check is handling the case where
          an imported type has the same name as a declaration, such as a
          member variable.
        </p>
        <p>
          For example, in the following case the import <code>java.awt.Component</code>
          will not be flagged as unused:
        </p>
        <source>
import java.awt.Component;
class FooBar {
  private Object Component; // a bad practice in my opinion
  ...
}
        </source>
      </subsection>

      <subsection name="Properties" id="UnusedImports_Properties">
        <div class="wrapper">
          <table>
            <tr>
              <th>name</th>
              <th>description</th>
              <th>type</th>
              <th>default value</th>
              <th>since</th>
            </tr>
            <tr>
              <td>processJavadoc</td>
              <td>Control whether to process Javadoc comments.</td>
              <td><a href="property_types.html#boolean">boolean</a></td>
              <td><code>true</code></td>
              <td>5.4</td>
            </tr>
          </table>
        </div>
      </subsection>

      <subsection name="Examples" id="UnusedImports_Examples">
        <p>
          To configure the check:
        </p>
        <source>
&lt;module name=&quot;UnusedImports&quot;/&gt;
        </source>
      </subsection>

      <subsection name="Example of Usage" id="UnusedImports_Example_of_Usage">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources+filename%3Asun_checks.xml+repo%3Acheckstyle%2Fcheckstyle+UnusedImports">
            Sun Style</a>
          </li>
          <li>
            <a href="https://github.com/search?q=path%3Aconfig+filename%3Acheckstyle_checks.xml+repo%3Acheckstyle%2Fcheckstyle+UnusedImports">
            Checkstyle Style</a>
          </li>
        </ul>
      </subsection>

      <subsection name="Violation Messages" id="UnusedImports_Violation_Messages">
        <ul>
          <li>
            <a href="https://github.com/search?q=path%3Asrc%2Fmain%2Fresources%2Fcom%2Fpuppycrawl%2Ftools%2Fcheckstyle%2Fchecks%2Fimports+filename%3Amessages*.properties+repo%3Acheckstyle%2Fcheckstyle+%22import.unused%22">
            import.unused</a>
          </li>
        </ul>
        <p>
          All messages can be customized if the default message doesn't suit you.
          Please <a href="config.html#Custom_messages">see the documentation</a> to learn how to.
        </p>
      </subsection>

      <subsection name="Package" id="UnusedImports_Package">
        <p>
          com.puppycrawl.tools.checkstyle.checks.imports
        </p>
      </subsection>

      <subsection name="Parent Module" id="UnusedImports_Parent_Module">
        <p>
          <a href="config.html#TreeWalker">TreeWalker</a>
        </p>
      </subsection>
    </section>
  </body>
</document>