Lesson 142 (Servlet API. Знакомство с сервлетами)

build.gradle

@@ -1,7 +1,11 @@
 plugins {
     id 'java'
+    id 'war'
 }
 
+compileJava.options.encoding = 'UTF-8'
+compileTestJava.options.encoding = 'UTF-8'
+
 group = 'com.walking.servletpractice'
 version = '1.0-SNAPSHOT'
 
@@ -10,10 +14,16 @@ repositories {
 }
 
 dependencies {
+    compileOnly 'jakarta.servlet:jakarta.servlet-api:6.1.0'
+
     testImplementation platform('org.junit:junit-bom:5.9.1')
     testImplementation 'org.junit.jupiter:junit-jupiter'
 }
 
 test {
     useJUnitPlatform()
-}
+}
+
+war {
+    archiveFileName = 'calculation.war'
+}

src/main/java/com/walking/servletpractice/converter/CalculationConverter.java

@@ -0,0 +1,31 @@
+package com.walking.servletpractice.converter;
+
+import com.walking.servletpractice.model.Calculation;
+import com.walking.servletpractice.model.CalculationData;
+import com.walking.servletpractice.model.dto.CalculationDto;
+
+import java.util.stream.Collectors;
+
+/**
+ * Преобразует объект бизнес-логики {@code Calculation} в dto-объект {@code CalculationDto},
+ * для отправки пользователю.
+ */
+public class CalculationConverter implements Converter<Calculation, CalculationDto> {
+    @Override
+    public CalculationDto convert(Calculation calculation) {
+        var calculationDto = new CalculationDto();
+
+        calculationDto.setType(calculation.getType()
+                                          .getValue());
+
+        calculationDto.setData(calculation.getData()
+                                          .stream()
+                                          .map(CalculationData::toString)
+                                          .collect(Collectors.toList()));
+
+        calculationDto.setResult(calculation.getResult()
+                                            .toString());
+
+        return calculationDto;
+    }
+}

src/main/java/com/walking/servletpractice/converter/CalculationRequestConverter.java

@@ -0,0 +1,22 @@
+package com.walking.servletpractice.converter;
+
+import com.walking.servletpractice.model.Calculation;
+import com.walking.servletpractice.model.request.CalculationRequest;
+import com.walking.servletpractice.service.CalculationService;
+
+/**
+ * Преобразует dto-объект {@code CalculationRequest} в объект бизнес-логики {@code Calculation}.
+ * Объект {@code Calculation} запрашивается у {@code CalculationService}, который отвечает за вычисления.
+ */
+public class CalculationRequestConverter implements Converter<CalculationRequest, Calculation> {
+    private final CalculationService calculationService;
+
+    public CalculationRequestConverter(CalculationService calculationService) {
+        this.calculationService = calculationService;
+    }
+
+    @Override
+    public Calculation convert(CalculationRequest source) {
+        return calculationService.calculated(source.getType(), source.getData());
+    }
+}

src/main/java/com/walking/servletpractice/converter/Converter.java

@@ -0,0 +1,5 @@
+package com.walking.servletpractice.converter;
+
+public interface Converter<S, R> {
+    R convert(S source);
+}

src/main/java/com/walking/servletpractice/exception/ParsingException.java

@@ -0,0 +1,10 @@
+package com.walking.servletpractice.exception;
+
+public class ParsingException extends RuntimeException {
+    public ParsingException() {
+    }
+
+    public ParsingException(String value, Throwable cause) {
+        super("Cannot parse value: '%s'".formatted(value), cause);
+    }
+}

src/main/java/com/walking/servletpractice/model/Calculation.java

@@ -0,0 +1,31 @@
+package com.walking.servletpractice.model;
+
+import java.util.List;
+
+/**
+ * Объект бизнес-логики отражающий конкретное вычисление. Инкапсулирует данные
+ * о типе вычисления, данных для вычисления и результате вычисления.
+ */
+public class Calculation {
+    private final CalculationType type;
+    private final List<CalculationData> data;
+    private final CalculationResult result;
+
+    public Calculation(CalculationType type, List<CalculationData> data, CalculationResult result) {
+        this.type = type;
+        this.data = data;
+        this.result = result;
+    }
+
+    public CalculationType getType() {
+        return type;
+    }
+
+    public List<CalculationData> getData() {
+        return data;
+    }
+
+    public CalculationResult getResult() {
+        return result;
+    }
+}

src/main/java/com/walking/servletpractice/model/CalculationData.java

@@ -0,0 +1,21 @@
+package com.walking.servletpractice.model;
+
+/**
+ * Объект-значение инкапсулирующий данные, используемые для вычислений.
+ */
+public class CalculationData {
+    private final double value;
+
+    public CalculationData(double value) {
+        this.value = value;
+    }
+
+    public double getValue() {
+        return value;
+    }
+
+    @Override
+    public String toString() {
+        return Double.toString(value);
+    }
+}

src/main/java/com/walking/servletpractice/model/CalculationResult.java

@@ -0,0 +1,21 @@
+package com.walking.servletpractice.model;
+
+/**
+ * Объект-значение инкапсулирующий значение результата вычисления.
+ */
+public class CalculationResult {
+    private final double value;
+
+    public CalculationResult(double value) {
+        this.value = value;
+    }
+
+    public double getValue() {
+        return value;
+    }
+
+    @Override
+    public String toString() {
+        return Double.toString(value);
+    }
+}

src/main/java/com/walking/servletpractice/model/CalculationType.java

@@ -0,0 +1,35 @@
+package com.walking.servletpractice.model;
+
+import java.util.NoSuchElementException;
+
+/**
+ * Ограничивает список типов арифметических операций, которые могут быть обработаны.
+ */
+public enum CalculationType {
+    ADDITION("addition"),
+    SUBTRACTION("subtraction"),
+    MULTIPLICATION("multiplication"),
+    DIVISION("division");
+
+    private final String value;
+
+    CalculationType(String value) {
+        this.value = value;
+    }
+
+    public String getValue() {
+        return value;
+    }
+
+    public static CalculationType getByValue(String value) {
+        for (CalculationType type : CalculationType.values()) {
+            if (type.getValue()
+                    .equals(value)) {
+                return type;
+            }
+        }
+
+        throw new NoSuchElementException(
+                "Cannot get CalculationType from value: '%s'".formatted(value));
+    }
+}

src/main/java/com/walking/servletpractice/model/dto/CalculationDto.java

@@ -0,0 +1,61 @@
+package com.walking.servletpractice.model.dto;
+
+import java.util.List;
+import java.util.StringJoiner;
+
+/**
+ * Dto-объект, содержащий данные вычисления, возвращаемые пользователю.
+ */
+public class CalculationDto {
+    private static final String ARGUMENT_DELIMITER = "&";
+    private static final String NAME_VALUE_DELIMITER = "=";
+    private static final String VALUES_DELIMITER = ",";
+
+    private String type;
+    private List<String> data;
+    private String result;
+
+    public void setType(String type) {
+        this.type = type;
+    }
+
+    public void setData(List<String> data) {
+        this.data = data;
+    }
+
+    public void setResult(String result) {
+        this.result = result;
+    }
+
+    /**
+     * Преобразует данные вычислений в строку вида: "type=value&data=value1,valueN&result=value"
+     */
+    @Override
+    public String toString() {
+        var argumentJoiner = new StringJoiner(ARGUMENT_DELIMITER);
+
+        addType(argumentJoiner);
+        addData(argumentJoiner);
+        addResult(argumentJoiner);
+
+        return argumentJoiner.toString();
+    }
+
+    private void addType(StringJoiner stringJoiner) {
+        stringJoiner.add("type" + NAME_VALUE_DELIMITER + type);
+    }
+
+    private void addData(StringJoiner stringJoiner) {
+        var valuesJoiner = new StringJoiner(VALUES_DELIMITER);
+
+        for (String value : data) {
+            valuesJoiner.add(value);
+        }
+
+        stringJoiner.add("data" + NAME_VALUE_DELIMITER + valuesJoiner);
+    }
+
+    private void addResult(StringJoiner stringJoiner) {
+        stringJoiner.add("result" + NAME_VALUE_DELIMITER + result);
+    }
+}

src/main/java/com/walking/servletpractice/model/request/CalculationRequest.java

@@ -0,0 +1,30 @@
+package com.walking.servletpractice.model.request;
+
+import com.walking.servletpractice.model.CalculationData;
+import com.walking.servletpractice.model.CalculationType;
+
+import java.util.List;
+
+/**
+ * Dto-объект, содержащий данные для вычислений, полученные от пользователя.
+ */
+public class CalculationRequest {
+    private CalculationType type;
+    private List<CalculationData> data;
+
+    public CalculationType getType() {
+        return type;
+    }
+
+    public void setType(CalculationType type) {
+        this.type = type;
+    }
+
+    public List<CalculationData> getData() {
+        return data;
+    }
+
+    public void setData(List<CalculationData> data) {
+        this.data = data;
+    }
+}