learn.txt

@@ -1,148 +0,0 @@
-Inheritance
-
-In the preceding sections, you have seen inheritance mentioned several times. In the Java language, classes can be derived from other classes, thereby inheriting fields and methods from those classes.
-
-    Definitions: A class that is derived from another class is called a subclass (also a derived class, extended class, or child class). The class from which the subclass is derived is called a superclass (also a base class or a parent class).
-
-    Excepting Object, which has no superclass, every class has one and only one direct superclass (single inheritance). In the absence of any other explicit superclass, every class is implicitly a subclass of Object.
-
-    Classes can be derived from classes that are derived from classes that are derived from classes, and so on, and ultimately derived from the topmost class, Object. Such a class is said to be descended from all the classes in the inheritance chain stretching back to Object.
-
-The idea of inheritance is simple but powerful: When you want to create a new class and there is already a class that includes some of the code that you want, you can derive your new class from the existing class. In doing this, you can reuse the fields and methods of the existing class without having to write (and debug!) them yourself.
-
-A subclass inherits all the members (fields, methods, and nested classes) from its superclass. Constructors are not members, so they are not inherited by subclasses, but the constructor of the superclass can be invoked from the subclass.
-
-The Object class, defined in the java.lang package, defines and implements behavior common to all classes—including the ones that you write. In the Java platform, many classes derive directly from Object, other classes derive from some of those classes, and so on, forming a hierarchy of classes.
-
-At the top of the hierarchy, Object is the most general of all classes. Classes near the bottom of the hierarchy provide more specialized behavior.
-
- 
-An Example of Inheritance
-
-Here is the sample code for a possible implementation of a Bicycle class that was presented in the Classes and Objects section:
-
-public class Bicycle {
-        
-    // the Bicycle class has three fields
-    public int cadence;
-    public int gear;
-    public int speed;
-        
-    // the Bicycle class has one constructor
-    public Bicycle(int startCadence, int startSpeed, int startGear) {
-        gear = startGear;
-        cadence = startCadence;
-        speed = startSpeed;
-    }
-        
-    // the Bicycle class has four methods
-    public void setCadence(int newValue) {
-        cadence = newValue;
-    }
-        
-    public void setGear(int newValue) {
-        gear = newValue;
-    }
-        
-    public void applyBrake(int decrement) {
-        speed -= decrement;
-    }
-        
-    public void speedUp(int increment) {
-        speed += increment;
-    }
-}
-
-A class declaration for a MountainBike class that is a subclass of Bicycle might look like this:
-
-public class MountainBike extends Bicycle {
-        
-    // the MountainBike subclass adds one field
-    public int seatHeight;
-
-    // the MountainBike subclass has one constructor
-    public MountainBike(int startHeight,
-                        int startCadence,
-                        int startSpeed,
-                        int startGear) {
-        super(startCadence, startSpeed, startGear);
-        seatHeight = startHeight;
-    }   
-        
-    // the MountainBike subclass adds one method
-    public void setHeight(int newValue) {
-        seatHeight = newValue;
-    }   
-}
-
-MountainBike inherits all the fields and methods of Bicycle and adds the field seatHeight and a method to set it. Except for the constructor, it is as if you had written a new MountainBike class entirely from scratch, with four fields and five methods. However, you did not have to do all the work. This would be especially valuable if the methods in the Bicycle class were complex and had taken substantial time to debug.
-
- 
-What You Can Do in a Subclass
-
-A subclass inherits all of the public and protected members of its parent, no matter what package the subclass is in. If the subclass is in the same package as its parent, it also inherits the package-private members of the parent. You can use the inherited members as is, replace them, hide them, or supplement them with new members:
-
-    The inherited fields can be used directly, just like any other fields.
-    You can declare a field in the subclass with the same name as the one in the superclass, thus hiding it (not recommended).
-    You can declare new fields in the subclass that are not in the superclass.
-    The inherited methods can be used directly as they are.
-    You can write a new instance method in the subclass that has the same signature as the one in the superclass, thus overriding it.
-    You can write a new static method in the subclass that has the same signature as the one in the superclass, thus hiding it.
-    You can declare new methods in the subclass that are not in the superclass.
-    You can write a subclass constructor that invokes the constructor of the superclass, either implicitly or by using the keyword super.
-    The following sections in this lesson will expand on these topics.
-
- 
-Private Members in a Superclass
-
-A subclass does not inherit the private members of its parent class. However, if the superclass has public or protected methods for accessing its private fields, these can also be used by the subclass.
-
-A nested class has access to all the private members of its enclosing class—both fields and methods. Therefore, a public or protected nested class inherited by a subclass has indirect access to all of the private members of the superclass.
-
- 
-Casting Objects
-
-We have seen that an object is of the data type of the class from which it was instantiated. For example, if we write
-
-public MountainBike myBike = new MountainBike();
-
-then myBike is of type MountainBike.
-
-MountainBike is descended from Bicycle and Object. Therefore, a MountainBike is a Bicycle and is also an Object, and it can be used wherever Bicycle or Object objects are called for.
-
-The reverse is not necessarily true: a Bicycle may be a MountainBike, but it is not necessarily. Similarly, an Object may be a Bicycle or a MountainBike, but it is not necessarily.
-
-Casting shows the use of an object of one type in place of another type, among the objects permitted by inheritance and implementations. For example, if we write
-
-Object obj = new MountainBike();
-
-then obj is both an Object and a MountainBike (until such time as obj is assigned another object that is not a MountainBike). This is called implicit casting.
-
-If, on the other hand, we write
-
-MountainBike myBike = obj;
-
-we would get a compile-time error because obj is not known to the compiler to be a MountainBike. However, we can tell the compiler that we promise to assign a MountainBike to obj by explicit casting:
-
-MountainBike myBike = (MountainBike)obj;
-
-This cast inserts a runtime check that obj is assigned a MountainBike so that the compiler can safely assume that obj is a MountainBike. If obj is not a MountainBike at runtime, an exception will be thrown.
-
-    Note: You can make a logical test as to the type of a particular object using the instanceof operator. This can save you from a runtime error owing to an improper cast. For example:
-
-if (obj instanceof MountainBike) {
-    MountainBike myBike = (MountainBike)obj;
-}
-
-    Here the instanceof operator verifies that obj refers to a MountainBike so that we can make the cast with knowledge that there will be no runtime exception thrown.
-
- 
-Multiple Inheritance of State, Implementation, and Type
-
-One significant difference between classes and interfaces is that classes can have fields whereas interfaces cannot. In addition, you can instantiate a class to create an object, which you cannot do with interfaces. As explained in the section What Is an Object?, an object stores its state in fields, which are defined in classes. One reason why the Java programming language does not permit you to extend more than one class is to avoid the issues of multiple inheritance of state, which is the ability to inherit fields from multiple classes. For example, suppose that you are able to define a new class that extends multiple classes. When you create an object by instantiating that class, that object will inherit fields from all of the class's superclasses. What if methods or constructors from different superclasses instantiate the same field? Which method or constructor will take precedence? Because interfaces do not contain fields, you do not have to worry about problems that result from multiple inheritance of state.
-
-Multiple inheritance of implementation is the ability to inherit method definitions from multiple classes. Problems arise with this type of multiple inheritance, such as name conflicts and ambiguity. When compilers of programming languages that support this type of multiple inheritance encounter superclasses that contain methods with the same name, they sometimes cannot determine which member or method to access or invoke. In addition, a programmer can unwittingly introduce a name conflict by adding a new method to a superclass. Default methods introduce one form of multiple inheritance of implementation. A class can implement more than one interface, which can contain default methods that have the same name. The Java compiler provides some rules to determine which default method a particular class uses.
-
-The Java programming language supports multiple inheritance of type, which is the ability of a class to implement more than one interface. An object can have multiple types: the type of its own class and the types of all the interfaces that the class implements. This means that if a variable is declared to be the type of an interface, then its value can reference any object that is instantiated from any class that implements the interface. This is discussed in the section Using an Interface as a Type.
-
-As with multiple inheritance of implementation, a class can inherit different implementations of a method defined (as default or static) in the interfaces that it extends. In this case, the compiler or the user must decide which one to use.

todo/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Журнал изменений
+
+Все заметные изменения проекта будут документироваться в этом файле.
+
+Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.0.0/),
+и этот проект придерживается [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.0] - 2025-05-29
+
+### Добавлено
+- Базовая функциональность для управления задачами
+- Команды: create, list, delete
+- Консольный интерфейс для взаимодействия с приложением
+- In-memory хранилище задач 

todo/README.md

@@ -0,0 +1,27 @@
+# TodoApp
+
+## Описание
+TodoApp - это консольное приложение для управления списком задач, разработанное на Java в качестве учебного проекта. Приложение позволяет создавать, просматривать, отмечать как выполненные и удалять задачи через интерфейс командной строки.
+
+## Требования
+- Java 24 или выше
+- Maven 3.8.x или выше
+
+### Доступные команды
+- `create <название_задачи>` - Создать новую задачу
+- `list` - Показать список всех задач
+- `complete <id>` - Отметить задачу как выполненную
+- `delete <id>` - Удалить задачу
+- `exit` - Выйти из приложения
+
+## Структура проекта
+- `model` - Модели данных (Task, SimpleTask)
+- `repo` - Репозитории для хранения задач
+- `service` - Бизнес-логика
+- `cli` - Компоненты интерфейса командной строки
+
+## Версии
+Актуальная версия: 2.0
+
+## Лицензия
+[MIT](LICENSE) 

todo/pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>ru.kamask.pet</groupId>
     <artifactId>todo</artifactId>
-    <version>1.0-SNAPSHOT</version>
+    <version>2.0-SNAPSHOT</version>
 
     <properties>
         <maven.compiler.release>24</maven.compiler.release>

todo/src/main/java/ru/kamask/pet/todo/TodoApp.java

@@ -1,18 +1,17 @@
 package ru.kamask.pet.todo;
 
-import ru.kamask.pet.todo.model.SimpleTask;
+import java.io.IOException;
+
+import ru.kamask.pet.todo.cli.CliEngine;
+import ru.kamask.pet.todo.repo.InMemoryTaskRepository;
+import ru.kamask.pet.todo.service.TaskService;
 
 public class TodoApp {
+    public static void main(String[] args) throws IOException {
+        var service = new TaskService(new InMemoryTaskRepository());
+        var cli = new CliEngine(service);
 
-    @SuppressWarnings("unused")
-    public static void main(String[] args) {
-        var task = new SimpleTask("TodoApp");
-        System.out.println(task);
-
-        task.markAsCompleted();
-
-        var taskData = task.data();
-        System.out.println(taskData);
+        cli.start();
     }
 
 }

todo/src/main/java/ru/kamask/pet/todo/cli/CliEngine.java

@@ -0,0 +1,69 @@
+package ru.kamask.pet.todo.cli;
+
+import java.io.BufferedReader;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.Optional;
+
+import ru.kamask.pet.todo.service.TaskService;
+
+public class CliEngine {
+    private HashMap<String, Command> registry = new HashMap<>();
+    private TaskService service;
+    private BufferedReader reader;
+
+    public CliEngine(TaskService service) {
+        this.service = service;
+        reader = new BufferedReader(new InputStreamReader(System.in));
+        initializeCommands();
+    }
+
+    public void start() throws IOException {
+        System.out.println("\nДобро пожаловать в Список задач 2.0!");
+        System.out.println("Введите help для просмтора доступных команд или exit для выхода.");
+        while (true) {
+            System.out.print("\ntodo> ");
+            var input = reader.readLine().trim();
+            System.out.println();
+            switch (input) {
+                case "help" -> handleHelp();
+                case "exit" -> System.exit(0);
+                default -> handleCommand(input).ifPresentOrElse(System.out::println, () -> {
+                    System.out.println("Не известная команда. Повторите ввод.\n");
+                    handleHelp();
+                });
+            }
+        }
+    }
+
+    void registerCommand(Command command) {
+        registry.put(command.name(), command);
+    }
+
+    void initializeCommands() {
+        registerCommand(new CreateCommand());
+        registerCommand(new ListCommand());
+        registerCommand(new CompleteCommand());
+        registerCommand(new DeleteCommand());
+    }
+
+    void handleHelp() {
+        registry.values().stream().map(handler -> handler.usage()).forEach(System.out::println);
+        System.out.printf(Command.templateUsage, "help", "Вот этот список команд\n");
+        System.out.printf(Command.templateUsage, "exit", "Выход, но лучше не надо)\n");
+
+    }
+
+    Optional<String> handleCommand(String input) {
+        var parts = input.split("\\s+");
+        var command = parts[0];
+        var args = Arrays.copyOfRange(parts, 1, parts.length);
+
+        var handlerOpt = Optional.ofNullable(registry.get(command));
+        if (handlerOpt.isPresent())
+            return handlerOpt.get().handle(args, service);
+        return Optional.empty();
+    }
+}

todo/src/main/java/ru/kamask/pet/todo/cli/Command.java

@@ -0,0 +1,16 @@
+package ru.kamask.pet.todo.cli;
+
+import java.util.Optional;
+
+import ru.kamask.pet.todo.service.TaskService;
+
+public interface Command {
+    String templateUsage = "  %-30s // %s";
+    String errorMessage = "Не корректно введена команда. Введите help для спарвки.";
+
+    Optional<String> handle(String[] args, TaskService service);
+
+    String name();
+
+    String usage();
+}

todo/src/main/java/ru/kamask/pet/todo/cli/CompleteCommand.java

@@ -0,0 +1,34 @@
+package ru.kamask.pet.todo.cli;
+
+import java.util.Optional;
+
+import ru.kamask.pet.todo.service.TaskService;
+
+public class CompleteCommand implements Command {
+    @Override
+    public String name() {
+        return "complete";
+    }
+
+    @Override
+    public String usage() {
+        return String.format(Command.templateUsage, name() + " <ID>", "Отметить задачу как \"выполнена\".");
+    }
+
+    @Override
+    public Optional<String> handle(String[] args, TaskService service) {
+        if (args.length != 1)
+            return Optional.of(Command.errorMessage);
+
+        try {
+            int id = Integer.parseInt(args[0]);
+
+            return Optional.of(service.complete(id)
+                    ? "Задача ID-%d выполнена.".formatted(id)
+                    : "Задача ID-%d не найдена.".formatted(id));
+
+        } catch (NumberFormatException e) {
+            return Optional.of("ID - должен быть числом.");
+        }
+    }
+}

todo/src/main/java/ru/kamask/pet/todo/cli/CreateCommand.java

@@ -0,0 +1,29 @@
+package ru.kamask.pet.todo.cli;
+
+import java.util.Optional;
+
+import ru.kamask.pet.todo.service.TaskService;
+
+public class CreateCommand implements Command {
+    @Override
+    public String name() {
+        return "create";
+    }
+
+    @Override
+    public Optional<String> handle(String[] args, TaskService service) {
+        if (args.length > 0) {
+            var title = String.join(" ", args);
+            if (title.length() > 30)
+                return Optional.of("Ошибка: максимальная длинна названия задачи 30 символов.");
+            service.create(title);
+            return Optional.of(String.format("Задача \"%s\" успешно добавлена!", title));
+        }
+        return Optional.of(Command.errorMessage);
+    }
+
+    @Override
+    public String usage() {
+        return String.format(templateUsage, name() + " <название_задачи>", "Добавление новой задачи");
+    }
+}

todo/src/main/java/ru/kamask/pet/todo/cli/DeleteCommand.java

@@ -0,0 +1,35 @@
+package ru.kamask.pet.todo.cli;
+
+import java.util.Optional;
+
+import ru.kamask.pet.todo.service.TaskService;
+
+public class DeleteCommand implements Command {
+    @Override
+    public String name() {
+        return "delete";
+    }
+
+    @Override
+    public String usage() {
+        return String.format(Command.templateUsage, name() + " <ID>", "Удалить задачу.");
+    }
+
+    @Override
+    public Optional<String> handle(String[] args, TaskService service) {
+        if (args.length != 1)
+            return Optional.of(Command.errorMessage);
+
+        try {
+            int id = Integer.parseInt(args[0]);
+            if (!service.has(id))
+                return Optional.of("Задача ID-%d не найдена.".formatted(id));
+            service.remove(id);
+            return Optional.of("Задача ID-%d удалена.".formatted(id));
+
+        } catch (NumberFormatException e) {
+            return Optional.of("ID - должен быть числом.");
+        }
+    }
+
+}

todo/src/main/java/ru/kamask/pet/todo/cli/ListCommand.java

@@ -0,0 +1,39 @@
+package ru.kamask.pet.todo.cli;
+
+import java.util.Optional;
+
+import ru.kamask.pet.todo.model.SimpleTask;
+import ru.kamask.pet.todo.model.Task;
+import ru.kamask.pet.todo.service.TaskService;
+
+public class ListCommand implements Command {
+    @Override
+    public String name() {
+        return "list";
+    }
+
+    @Override
+    public Optional<String> handle(String[] args, TaskService service) {
+        if (args.length > 0)
+            return Optional.of(Command.errorMessage);
+
+        String template = "%-2s | %-30s | %s\n";
+        String res = "";
+        res += String.format(template, "ID", "Название задачи", "Статус");
+        res += "-".repeat(50) + "\n";
+
+        if (service.list().size() == 0)
+            return Optional.of(res + "\nСписок задач пуст.");
+
+        for (Task task : service.list()) {
+            SimpleTask.Data data = ((SimpleTask) task).data();
+            res += String.format(template, data.id(), data.title(), data.done() ? "выполнено" : "не выполнено");
+        }
+        return Optional.of(res);
+    }
+
+    @Override
+    public String usage() {
+        return String.format(templateUsage, name(), "Список всех задач.");
+    }
+}

todo/src/main/java/ru/kamask/pet/todo/model/SimpleTask.java

@@ -30,6 +30,6 @@ public class SimpleTask extends Task implements DataBuilder<SimpleTask.Data> {
         return new Data(id, title, done);
     }
 
-    record Data(int id, String title, boolean done) {
+    public record Data(int id, String title, boolean done) {
     }
 }

todo/src/main/java/ru/kamask/pet/todo/model/Task.java

@@ -11,6 +11,10 @@ public abstract class Task {
         this.title = title;
     }
 
+    public int id() {
+        return id;
+    }
+
     @Override
     public String toString() {
         return String.format("Задача: id - %d, title: \"%s\"", id, title);

todo/src/main/java/ru/kamask/pet/todo/repo/InMemoryTaskRepository.java

@@ -0,0 +1,37 @@
+package ru.kamask.pet.todo.repo;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+
+import ru.kamask.pet.todo.model.Task;
+
+public class InMemoryTaskRepository implements TaskRepository {
+    private Map<Integer, Task> storage = new HashMap<>();
+
+    @Override
+    public void save(Task task) {
+        storage.put(task.id(), task);
+    }
+
+    @Override
+    public Optional<Task> findById(int id) {
+        return Optional.ofNullable(storage.get(id));
+    }
+
+    @Override
+    public List<Task> findAll() {
+        return new ArrayList<>(storage.values());
+    }
+
+    @Override
+    public void delete(int id) {
+        storage.remove(id);
+    }
+
+    public boolean has(int id) {
+        return storage.containsKey(id);
+    }
+}

todo/src/main/java/ru/kamask/pet/todo/repo/TaskRepository.java

@@ -0,0 +1,18 @@
+package ru.kamask.pet.todo.repo;
+
+import java.util.List;
+import java.util.Optional;
+
+import ru.kamask.pet.todo.model.Task;
+
+public interface TaskRepository {
+    void save(Task task);
+
+    Optional<Task> findById(int id);
+
+    List<Task> findAll();
+
+    void delete(int id);
+
+    boolean has(int id);
+}

todo/src/main/java/ru/kamask/pet/todo/service/TaskService.java

@@ -0,0 +1,45 @@
+package ru.kamask.pet.todo.service;
+
+import java.util.List;
+import java.util.Optional;
+
+import ru.kamask.pet.todo.model.Task;
+import ru.kamask.pet.todo.model.SimpleTask;
+import ru.kamask.pet.todo.repo.TaskRepository;
+
+public class TaskService {
+    private final TaskRepository repo;
+
+    public TaskService(TaskRepository repo) {
+        this.repo = repo;
+    }
+
+    public void create(String title) {
+        repo.save(new SimpleTask(title));
+    }
+
+    public Optional<Task> getById(int id) {
+        return repo.findById(id);
+    }
+
+    public boolean complete(int id) {
+        var taskOpt = repo.findById(id);
+        if (taskOpt.isPresent()) {
+            taskOpt.get().markAsCompleted();
+            return true;
+        }
+        return false;
+    }
+
+    public List<Task> list() {
+        return repo.findAll();
+    }
+
+    public void remove(int id) {
+        repo.delete(id);
+    }
+
+    public boolean has(int id) {
+        return repo.has(id);
+    }
+}