sem6 hw solved

src/DIP/Car.java

@@ -1,5 +1,8 @@
 package DIP;
 
+/**
+ * Класс Car - модуль верхнего уровня. Он зависит от абстракции Engine.
+ */
 public class Car {
     public Engine engine;
 

src/DIP/DieselPetrol.java

@@ -1,5 +1,8 @@
 package DIP;
 
+/**
+ * Класс DieselPetrol модуль нижнего класса. Он зависит от абстракции Engine.
+ */
 public class DieselPetrol implements Engine {
     @Override
     public void start() {

src/DIP/Engine.java

@@ -1,5 +1,11 @@
 package DIP;
 
+/**
+ * Интерфейс Engine. От него зависят все модули в нашем примере:
+ * верхний модуль - использует в конструкторе объект типа Engine,
+ * нижний модуль - реализует методы интерфейса.
+ * Но сам Engine про них ничего не знает(и знать не хочет)
+ */
 public interface Engine {
-    public void start();
+    void start();
 }

src/DIP/PetrolEngine.java

@@ -1,5 +1,7 @@
 package DIP;
-
+/**
+ * Класс PetrolEngine модуль нижнего класса. Он зависит от абстракции Engine.
+ */
 public class PetrolEngine implements Engine {
     @Override
     public void start(){

src/DIP/Test.java

@@ -1,5 +1,9 @@
 package DIP;
 
+/**
+ * Объекту типа Car всё равно какой у него будет двигатель. Главное чтобы он
+ * был в зависимости от абстракции Engine.
+ */
 public class Test {
     public static void main(String[] args) {
         Car car = new Car(new PetrolEngine());

src/ISP/Circle.java

@@ -1,5 +1,11 @@
 package ISP;
 
+/**
+ * Класс Circle имплементирует интерфейс Shape. Для 2D фигуры мы можем найти площадь.
+ * Если бы мы сделали один интерфейс с методами для площади и объема, то нам бы пришлось реализовать методы этого интерфейса.
+ * НО! мы не можем найти объем у круга. Объем характерен только для трехмерных фигур. Поэтому мы разделяем интерфейсы
+ * Shape & Shape3D.
+ */
 public class Circle implements Shape {
     private int radius;
 
@@ -18,6 +24,6 @@ public void setRadius(int radius) {
 
     @Override
     public double area() {
-        return 2 * 3.14 * radius;
+        return 2 * Math.PI * radius;
     }
 }

src/ISP/Cube.java

@@ -1,5 +1,8 @@
 package ISP;
 
+/**
+ * Класс Cube реализует интерфейс Shape3D. Для него характерен поиск площади сторон и объема фигруы.
+ */
 public class Cube implements Shape3D {
     private int length;
 

src/ISP/Shape.java

@@ -1,5 +1,8 @@
 package ISP;
 
+/**
+ * Для двумерных фигур можно найти площадь.
+ */
 public interface Shape {
     public double area();
 

src/ISP/Shape3D.java

@@ -1,5 +1,9 @@
 package ISP;
 
+/**
+ * Для трехмерных фигур можно найти площадь сторон и ОБЪЕМ фигуры.
+ * Здесь мы наследуемся от интерфейса Shape, потому что для трехмерных фигур справедлив подсчёт площади(но нужно учитывать все стороны).
+ */
 public interface Shape3D extends Shape{
     public double volume();
 }

src/LSP/Test.java

@@ -1,5 +1,12 @@
 package LSP;
 
+/**
+ * Rectangle & Square являются наследниками класса QuadRangle.
+ * Еслм создать объект класса QuadRangle и подставить туда объект, который наследуется(имплементируется для интерфейсов) от QuadRangle,
+ * то программа не поломается и его функции будут работать правильно.
+ * Метод area() будет в любом случае искать площадь фигуры, независимо от того Rectangle это или Square, но будет делать это для разных фигур.
+ * НО БУДЕТ!
+ */
 public class Test {
     public static void main(String[] args) {
         QuadRangle quadRangle = new Rectangle(5, 3);

src/OCP/Bus.java

@@ -1,5 +1,7 @@
 package OCP;
-
+/**
+ * Класс Bus расширяет класс Vehicle.
+ */
 public class Bus extends Vehicle{
     @Override
     public double calculateAllowedSpeed() {

src/OCP/Car.java

@@ -1,5 +1,8 @@
 package OCP;
 
+/**
+ * Класс Car расширяет класс Vehicle.
+ */
 public class Car extends Vehicle{
     public Car(int maxSpeed) {
         super(maxSpeed, "Car");

src/OCP/Vehicle.java

@@ -1,5 +1,9 @@
 package OCP;
 
+/**
+ * Классы Car & Bus наследуются от класса Vehicle. Он остается неизменным, то есть закрытым для модификации,
+ * но доступен для расширения(что и делают его дочерние классы).
+ */
 public class Vehicle {
     private int maxSpeed;
     private String type;

src/SRP/Employee.java

@@ -1,5 +1,8 @@
 package SRP;
 
+/**
+ * Класс Работник со своими полями и гет/сет методами.
+ */
 public class Employee {
     private String name;
     private String dol;

src/SRP/EmployeeSalaryCalculate.java

@@ -1,5 +1,9 @@
 package SRP;
 
+/**
+ * Отделяем логику вычисления ЗП, чтобы не менять класс Employee в будущем при изменении правил вычисления зарплаты.
+ * Single response для класса EmployeeSalaryCalculate - это вычислять ЗП.
+ */
 public class EmployeeSalaryCalculate {
     private int baseSalary;