- Реализовал стратегии рандомного RandomDataGeneratorStrategy ввода и ручного ManualInputReaderStrategy ввода

- Реализовал InputManager как Context в паттерне Strategy
- Добавил фабричные методы для создания стратегий
- Внедрил единую точку входа для всех типов ввода
- Добавил валидацию параметров и обработку ошибок

Author: Никита

.idea/misc.xml

@@ -13,6 +13,7 @@ dependencies {
     testImplementation platform('org.junit:junit-bom:5.10.0')
     testImplementation 'org.junit.jupiter:junit-jupiter'
     testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
+    implementation 'com.github.javafaker:javafaker:1.0.2'
 }
 
 test {

build.gradle

@@ -13,13 +13,28 @@
  *
  * <p>Реализует интерфейс {@link Iterable} для поддержки for-each циклов и стримов.
  *
+ * <p>Основные возможности:</p>
+ * <ul>
+ *   <li>Динамическое расширение при добавлении элементов</li>
+ *   <li>Поддержка операций добавления, удаления, получения и замены элементов</li>
+ *   <li>Итерация через for-each циклы и итераторы</li>
+ *   <li>Поддержка Stream API</li>
+ *   <li>Добавление всех элементов из другой коллекции</li>
+ * </ul>
+ *
  * @param <T> тип элементов, хранимых в коллекции
  */
 public class CustomCollection<T> implements Iterable<T> {
+    /** Коэффициент увеличения емкости при расширении массива. */
     private static final float GROWTH_FACTOR = 1.5f;
+
+    /** Начальная емкость по умолчанию при создании коллекции без указания размера. */
     private static final int DEFAULT_CAPACITY = 10;
 
+    /** Внутренний массив для хранения элементов коллекции. */
     private Object[] elements;
+
+    /** Количество фактически хранящихся элементов в коллекции. */
     private int size;
 
     public CustomCollection() {
@@ -33,8 +48,6 @@ public CustomCollection(int initialCapacity) {
         this.elements = new Object[initialCapacity];
     }
 
-    // TODO Конструктор из существующей коллекции, копирует все элементы с ёмкостью равной ёмкости коллекции
-
     public boolean add(T element) {
         // Проверяем достаточно ли места для добавления
         if (size == elements.length) {
@@ -77,14 +90,14 @@ public void clear() {
 
     public T get(int index) {
         if (index < 0 || index >= size) {
-            throw new IndexOutOfBoundsException("Index cannot be less then 0 or more then " + size);
+            throw new IndexOutOfBoundsException("Индекс не может быть меньше 0 или больше " + size);
         }
         return (T) elements[index];
     }
 
     public T set(int index, T element) {
         if (index < 0 || index >= size) {
-            throw new IndexOutOfBoundsException("Index cannot be less then 0 or more then " + size);
+            throw new IndexOutOfBoundsException("Индекс не может быть меньше 0 или больше " + size);
         }
 
         T old = (T) elements[index];
@@ -109,6 +122,9 @@ public Stream<T> stream() {
      * <p>Порядок элементов в целевой коллекции соответствует порядку,
      * в котором они возвращаются итератором указанной коллекции.
      *
+     * <p>Поведение этого метода не определено, если указанная коллекция изменяется
+     * в процессе выполнения операции.
+     *
      * @param collection коллекция, содержащая элементы для добавления
      * @return {@code true} если эта коллекция изменилась в результате вызова
      */
@@ -145,18 +161,37 @@ public Iterator iterator() {
         return new CustomArrayIterator();
     }
 
-    // Внутренний клас для итератора
+    /**
+     * Внутренний класс итератора для CustomCollection.
+     * Реализует fail-fast поведение: выбрасывает {@link IllegalStateException}
+     * при попытке удаления без предварительного вызова {@link #next()}.
+     */
     class CustomArrayIterator implements Iterator<T> {
-        private int cursor = 0; // текущая позиция
-        private int lastRet = -1; // индекс последнего возвращенного элемента
+        /** Текущая позиция итератора в массиве элементов. */
+        private int cursor = 0;
+
+        /** Индекс последнего возвращенного элемента; -1 если элемент не был возвращен или был удален. */
+        private int lastRet = -1;
 
         public CustomArrayIterator() {
         }
 
+        /**
+         * Проверяет, существует ли следующий элемент для итерации.
+         *
+         * @return {@code true} если итерация содержит больше элементов,
+         *         {@code false} в противном случае
+         */
         public boolean hasNext() {
             return cursor < size;
         }
 
+        /**
+         * Возвращает следующий элемент в итерации.
+         *
+         * @return следующий элемент в итерации
+         * @throws NoSuchElementException если итерация не содержит больше элементов
+         */
         public T next() {
             if (!hasNext()) {
                 throw new NoSuchElementException("Элемент отсутствует");
@@ -168,6 +203,12 @@ public T next() {
             return element;
         }
 
+        /**
+         * Удаляет из коллекции последний элемент, возвращенный этим итератором.
+         *
+         * @throws IllegalStateException если метод {@link #next} еще не был вызван,
+         *         или метод {@link #remove} уже был вызван после последнего вызова {@link #next}
+         */
         public void remove() {
             if (lastRet == -1) {
                 throw new IllegalStateException();

src/main/java/input/CustomCollection.java

@@ -1,5 +1,109 @@
 package input;
 
+import input.Strategy.*;
+import dto.Client;
+
+import java.io.IOException;
+
+/**
+ * Менеджер ввода данных, реализующий паттерн Strategy.
+ * Выступает в роли Context для управления различными стратегиями ввода данных о клиентах.
+ *
+ * <p>Основные функции:</p>
+ * <ul>
+ *   <li>Управление текущей стратегией ввода</li>
+ *   <li>Загрузка данных с использованием выбранной стратегии</li>
+ *   <li>Создание стратегий различных типов</li>
+ * </ul>
+ *
+ * @see ClientInputStrategy
+ * @see FileReaderStrategy
+ * @see ManualInputReaderStrategy
+ * @see RandomDataGeneratorStrategy
+ * @see CustomCollection
+ * @see Client
+ */
 public class InputManager {
-    CustomCollection customCollection = new CustomCollection();
-}
+    private ClientInputStrategy currentStrategy;
+
+
+    public InputManager() {
+        // Инициализация без стратегии
+    }
+
+    public InputManager(ClientInputStrategy initialStrategy) {
+        if (initialStrategy == null) {
+            throw new IllegalArgumentException("Стратегия не может быть null");
+        }
+        this.currentStrategy = initialStrategy;
+    }
+
+    public void setStrategy(ClientInputStrategy strategy) {
+        if (strategy == null) {
+            throw new IllegalArgumentException("Стратегия не может быть null");
+        }
+        this.currentStrategy = strategy;
+    }
+
+    public ClientInputStrategy getCurrentStrategy() {
+        return currentStrategy;
+    }
+
+    /**
+     * Загружает данные о клиентах с использованием текущей стратегии.
+     *
+     * @return коллекция клиентов, загруженных с помощью текущей стратегии
+     * @throws IllegalStateException если стратегия не установлена
+     * @throws IOException если возникает ошибка ввода-вывода при загрузке данных
+     */
+    public CustomCollection<Client> loadData() throws IOException {
+        if (currentStrategy == null) {
+            throw new IllegalStateException("Стратегия ввода не установлена. " +
+                    "Используйте setStrategy() перед вызовом loadData()");
+        }
+        return currentStrategy.getData();
+    }
+
+    /**
+     * Создает стратегию для чтения данных из файла.
+     *
+     * <p>Файл должен содержать данные в формате:</p>
+     * <pre>
+     * Имя|Телефон|ID
+     * Иван Иванов|+79991234567|1
+     * </pre>
+     *
+     * @param filePath путь к файлу с данными о клиентах
+     * @return стратегия чтения из файла
+     * @throws IllegalArgumentException если {@code filePath} равен {@code null} или пуст
+     */
+    public FileReaderStrategy createFileStrategy(String filePath) {
+        if (filePath == null || filePath.trim().isEmpty()) {
+            throw new IllegalArgumentException("Путь к файлу не может быть null или пустым");
+        }
+        return new FileReaderStrategy(filePath);
+    }
+
+    /**
+     * Создает стратегию для ручного ввода данных через консоль.
+     *
+     * <p>Стратегия предоставляет интерактивный интерфейс для ввода данных
+     * о клиентах с валидацией и подтверждением.</p>
+     *
+     * @return стратегия ручного ввода
+     */
+    public ManualInputReaderStrategy createManualStrategy() {
+        return new ManualInputReaderStrategy();
+    }
+
+    /**
+     * Создает стратегию для генерации случайных данных о клиентах.
+     *
+     * @param count количество клиентов для генерации
+     * @return стратегия генерации случайных данных
+     * @throws IllegalArgumentException если {@code count} меньше или равен 0
+     */
+    public RandomDataGeneratorStrategy createRandomStrategy(int count) {
+        return new RandomDataGeneratorStrategy(count);
+    }
+}

src/main/java/input/InputManager.java

@@ -3,7 +3,6 @@
 import dto.Client;
 import input.CustomCollection;
 
-import java.io.File;
 import java.io.IOException;
 import java.nio.charset.StandardCharsets;
 import java.nio.file.Files;
@@ -13,13 +12,46 @@
 import java.util.stream.Stream;
 
 /**
- * Стратегия для чтения данных о клиентах из файла.
- * Реализует интерфейс ClientInputStrategy для получения коллекции клиентов.
+ * Стратегия для чтения данных о клиентах из текстового файла.
+ * Реализует интерфейс {@link ClientInputStrategy} для получения
+ * коллекции клиентов из внешнего файла.
+ *
+ * <p>Формат файла:</p>
+ * <ul>
+ *   <li>Каждая строка представляет одного клиента</li>
+ *   <li>Формат строки: {@code Имя|Телефон|ID}</li>
+ *   <li>Разделитель полей: вертикальная черта ({@code |})</li>
+ *   <li>Кодировка файла: UTF-8</li>
+ * </ul>
+ *
+ * <p>Требования к данным:</p>
+ * <ul>
+ *   <li>Имя: непустая строка</li>
+ *   <li>Телефон: формат {@code +7XXXXXXXXXX} (11 цифр после {@code +7})</li>
+ *   <li>ID: целое число</li>
+ * </ul>
+ *
+ * <p>Обработка ошибок:</p>
+ * <ul>
+ *   <li>Пропускает некорректные строки с выводом сообщения об ошибке</li>
+ *   <li>Игнорирует пустые строки</li>
+ *   <li>Генерирует исключение при проблемах с файлом</li>
+ * </ul>
+ *
+ * <p>Пример содержимого файла:</p>
+ * <pre>
+ * Иван Иванов|+79991234567|1
+ * Мария Петрова|+79997654321|2
+ * </pre>
+ *
+ * @see ClientInputStrategy
+ * @see Client
+ * @see CustomCollection
  */
-public class FileReader implements ClientInputStrategy {
+public class FileReaderStrategy implements ClientInputStrategy {
     private final String filePath;
 
-    public FileReader(String filePath) {
+    public FileReaderStrategy(String filePath) {
         this.filePath = filePath;
     }
 
@@ -37,7 +69,7 @@ public CustomCollection<Client> getData() {
         Path path = Paths.get(filePath);
 
         if (!Files.exists(path)) {
-            throw new RuntimeException("File not found: " + filePath);
+            throw new RuntimeException("Файл не найден: " + filePath);
         }
 
         try (Stream<String> lines = Files.lines(path, StandardCharsets.UTF_8)) {
@@ -67,7 +99,7 @@ public Optional<Client.ClientBuilder> parseToClient(String line) {
         try {
             String[] parts = line.split("\\|");
             if (parts.length != 3) {
-                throw new IllegalArgumentException("Invalid data format");
+                throw new IllegalArgumentException("неверный формат данных");
             }
             String name = parts[0].trim();
             String phoneNumber = parts[1].trim();
@@ -76,17 +108,17 @@ public Optional<Client.ClientBuilder> parseToClient(String line) {
             try {
                 idNumber = Integer.parseInt(parts[2].trim());
             } catch (NumberFormatException e) {
-                System.out.println("[WARN] Missing line (ID is not a number): " + line);
+                System.out.println("ID не число: " + line);
                 return Optional.empty();
             }
 
             if (name.isEmpty()) {
-                System.out.println("[WARN] Missing line (name is empty): " + line);
+                System.out.println("Пустое имя" + line);
                 return Optional.empty();
             }
 
             if (!phoneNumber.matches("^\\+7\\d{10}$")) {
-                System.out.println("[WARN] Missing line (invalid phone format): " + line);
+                System.out.println("Неверный формат номера телефона" + line);
                 return Optional.empty();
             }
 
@@ -97,7 +129,7 @@ public Optional<Client.ClientBuilder> parseToClient(String line) {
             return Optional.of(builder);
 
         } catch (Exception e) {
-            System.out.println("[ERROR] Error processing line: " + line);
+            System.out.println("Ошибка" + line);
             return Optional.empty();
         }
     }