Статический импорт в Java (import static)

Вы добавили import static java.util.Arrays.toString;, вызвали toString(numbers) внутри своего класса — и получили ошибку компиляции method toString in class Object cannot be applied to given types. Импорт на месте, метод существует, но компилятор его «не видит». Чтобы понимать, почему так происходит и когда static import действительно упрощает код, разберём его устройство по порядку.

Статический импорт (static import) — это объявление import static, которое позволяет обращаться к статическим полям, методам и вложенным статическим типам другого класса без указания имени этого класса. Например, после import static java.lang.Math.PI; можно писать просто PI вместо Math.PI. Статический импорт появился в Java 5 и работает только на этапе компиляции.

Как обращаться к статическим членам без импорта

Чтобы получить доступ к статическому члену класса, обычно указывают имя класса. Например, для вызова статического метода cos() класса Math и обращения к его статической константе PI нужно дважды написать Math:

public class WithoutStaticImportExample {
    public static void main(String[] args) {
        double value = Math.cos(Math.PI * 4);
        System.out.println(value); // 1.0
    }
}

В одной строке это не мешает, но в формулах с десятком вызовов Math. имя класса начинает загромождать выражение.

Синтаксис import static

Статические члены можно импортировать почти так же, как обычные классы. После ключевых слов import static указывается полное имя класса (вместе с пакетом) и через точку — имя статического члена. Есть две формы.

Одиночный статический импорт

Импортирует статические члены с конкретным именем:

package oop;

import static java.lang.Math.PI;
import static java.lang.Math.cos;

public class StaticImportExample {
    public static void main(String[] args) {
        double value = cos(PI * 4);
        System.out.println(value); // 1.0
    }
}

Одиночный импорт по имени подтягивает все статические члены с этим именем. Например, import static java.lang.Math.max; делает доступными сразу все перегрузки max(int, int), max(long, long), max(double, double) и т.д. Указывать параметры метода в импорте нельзя и не нужно.

Статический импорт по требованию (со звёздочкой)

Импортирует все доступные статические члены класса:

import static java.lang.Math.*;

public class CircleArea {
    public static void main(String[] args) {
        double r = 2.5;
        double area = PI * pow(r, 2);
        System.out.println(round(area)); // 20
    }
}

Где размещать import static

Объявления import static располагаются там же, где обычные import: после строки package (если она есть) и перед объявлением класса. Обычные и статические импорты можно смешивать в любом порядке, но по соглашению многих стилей кода (например, Google Java Style) статические импорты группируют отдельным блоком.

Примеры static import в Java

На практике статический импорт чаще всего встречается в нескольких типичных ситуациях.

Константы и методы утилитных классов

import static java.lang.System.out;
import static java.util.concurrent.TimeUnit.SECONDS;

public class TimeoutExample {
    public static void main(String[] args) {
        long millis = SECONDS.toMillis(30);
        out.println("Таймаут: " + millis + " мс"); // Таймаут: 30000 мс
    }
}

Assertions в тестах JUnit

Самый распространённый пример — тесты. Методы assertEquals, assertTrue и другие почти всегда импортируют статически:

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertTrue;

import org.junit.jupiter.api.Test;

class CalculatorTest {
    @Test
    void addsNumbers() {
        assertEquals(5, 2 + 3);
        assertTrue(10 > 3);
    }
}

Коллекторы Stream API

import static java.util.stream.Collectors.groupingBy;
import static java.util.stream.Collectors.counting;

import java.util.List;
import java.util.Map;

public class GroupingExample {
    public static void main(String[] args) {
        List<String> words = List.of("java", "jvm", "stream", "static");
        Map<Character, Long> byFirstLetter = words.stream()
                .collect(groupingBy(w -> w.charAt(0), counting()));
        System.out.println(byFirstLetter); // {s=2, j=2}
    }
}

Константы перечислений тоже являются статическими полями, поэтому их можно импортировать так же: import static java.time.DayOfWeek.MONDAY;.

Чем import отличается от import static

Конфликты имён и неочевидные моменты

Одинаковые имена из разных классов

Если два импорта со звёздочкой приносят члены с одинаковым именем, ошибки не будет, пока вы это имя не используете. При обращении компилятор сообщит о неоднозначности:

import static java.lang.Integer.*;
import static java.lang.Long.*;

public class AmbiguityExample {
    public static void main(String[] args) {
        System.out.println(MAX_VALUE); // ошибка: reference to MAX_VALUE is ambiguous
    }
}

Решение — импортировать нужный член поимённо (одиночный импорт имеет приоритет над импортом со звёздочкой) или просто написать Integer.MAX_VALUE.

Члены своего класса важнее импорта

Имена, объявленные в самом классе или унаследованные им, затеняют статически импортированные. Именно это происходит в примере из начала урока: каждый класс наследует от Object метод toString(), поэтому вызов toString(numbers) компилятор ищет среди методов класса, находит Object.toString() без параметров и выдаёт ошибку:

import static java.util.Arrays.toString;

public class ShadowingExample {
    public static void main(String[] args) {
        int[] numbers = {1, 2, 3};
        // System.out.println(toString(numbers)); // ошибка компиляции
        System.out.println(java.util.Arrays.toString(numbers)); // [1, 2, 3]
    }
}

То же касается equals и hashCode: статически импортировать одноимённые методы (например, Objects.equals) бесполезно — их всегда затенят методы Object.

Что импортировать нельзя

• Нестатические члены. Поля и методы экземпляра через import static не импортируются.
• Члены класса из пакета по умолчанию. Класс без package нельзя импортировать ни обычным, ни статическим импортом.
• Недоступные члены. private-члены другого класса импортировать нельзя; импорт не расширяет права доступа.

Когда использовать статический импорт, а когда нет

Static import хорош, когда имя члена понятно само по себе и часто повторяется:

• математические выражения с Math (sqrt, pow, PI);
• assertions и matchers в тестах (JUnit, AssertJ, Mockito);
• коллекторы и фабричные методы (toList(), groupingBy());
• часто используемые константы и значения enum.

Лучше отказаться от него, если без имени класса становится непонятно, откуда взят член. Вызов of(1, 2) ничего не говорит читателю, а List.of(1, 2) — говорит. Импорт со звёздочкой из нескольких классов тоже усложняет чтение: приходится угадывать, какой класс принёс имя.