Package-private доступ, являющийся уровнем доступа по умолчанию в Java (без явного указания public, protected или private), ограничивает видимость членов класса (полей, методов, конструкторов) только в пределах того же пакета. Инкапсуляция же — это принцип объектно-ориентированного программирования, заключающийся в сокрытии данных и методов внутри объекта, предоставляя контролируемый доступ к ним через публичные интерфейсы (методы).

Соединение package-private доступа с инкапсуляцией происходит следующим образом:

Сокрытие данных: Поля класса объявляются с модификатором private. Это гарантирует, что они не будут доступны напрямую извне класса.
Контролируемый доступ в рамках пакета: Для предоставления доступа к приватным полям или выполнения операций над ними внутри того же пакета, используются методы с package-private доступом.

Пример:

Допустим, у нас есть пакет com.example.internal с классом InternalData.

package com.example.internal;

public class InternalData {

    private int value; // Приватное поле

    // Конструктор с package-private доступом
    InternalData(int value) {
        this.value = value;
    }

    // Метод с package-private доступом для изменения значения
    void setValue(int value) {
        this.value = value;
    }

    // Метод с package-private доступом для получения значения
    int getValue() {
        return this.value;
    }
}

В этом классе:

Поле value имеет модификатор private, реализуя сокрытие данных.
Конструктор InternalData(int value), метод setValue() и метод getValue() имеют package-private доступ (отсутствует модификатор доступа).

В другом классе InternalService в том же пакете com.example.internal мы можем использовать экземпляры InternalData:

package com.example.internal;

public class InternalService {

    public void processData() {
        // Создаем экземпляр InternalData с package-private конструктором
        InternalData data = new InternalData(100);

        // Используем package-private методы
        System.out.println("Initial value: " + data.getValue());
        data.setValue(200);
        System.out.println("Updated value: " + data.getValue());
    }
}

Здесь InternalService может напрямую вызывать package-private методы setValue() и getValue() класса InternalData, потому что оба класса находятся в одном пакете.

Однако, если мы попытаемся получить доступ к InternalData или его package-private членам из класса в другом пакете (com.example.api, например):

package com.example.api;

// import com.example.internal.InternalData; // Будет ошибка компиляции если класс InternalData не public

public class ExternalProcessor {

    public void someMethod() {
        // Попытка создать экземпляр InternalData - если сам класс package-private
        // InternalData data = new InternalData(10); // Ошибка компиляции если конструктор package-private

        // Попытка доступа к package-private полям или методам
        // data.setValue(50); // Ошибка компиляции
    }
}

Здесь мы сталкиваемся с ошибками компиляции, так как класс ExternalProcessor находится вне пакета com.example.internal.

Резюме:

Package-private доступ позволяет реализовать инкапсуляцию, ограничивая видимость внутренних деталей реализации класса в рамках одного пакета. Это полезно для создания внутренних вспомогательных классов или методов, которые не предназначены для использования вне пакета, но при этом должны иметь возможность взаимодействовать с другими классами в том же пакете для сохранения согласованности и логики. Поля при этом должны оставаться private для наиболее строгого соблюдения инкапсуляции.

Как можно соединить package-private доступ с инкапсуляцией в Java?