Skip to content

lesson01.md

Latest commit

 

History

History
316 lines (241 loc) · 37.7 KB

lesson01.md

File metadata and controls

316 lines (241 loc) · 37.7 KB

Онлайн-проект Topjava

  • Не стоит стремиться прочитать все ссылки урока, их можно использовать как справочник. Гораздо важнее пройти основной материал урока и сделать Домашнее Задание
  • Обязательно посмотри правила работы с патчами на проекте
  • Делать Apply Patch лучше по одному, непосредственно перед видео на эту тему, а при просмотре видео сразу отслеживать все изменения кода проекта по изменению в патче (Git-> Local Changes-> Ctrl+D)
  • При первом Apply удобнее выбрать имя локального ченджлиста Name: Default. Далее все остальные патчи также будут в него попадать.
  • Код проекта обновляется и не всегда совпадает с видео (можно увидеть как развивался проект). Изменения в проекте указываю после соответствующего патча.

Материалы занятия (скачать все патчи можно через Download/Скачать папки patch)

image

correction Рефакторинг проекта

Apply 1_0_rename.patch

  • переименовал классы UserMeal* в более красивые Meal*
  • преименовал MealWithExceed transfer object класс (что это такое пройдем позже) в MealTo (data transfer object naming convention)

hw Разбор домашнего задания HW0:

video 1. Optional: реализация getFilteredMealsWithExcess через Stream API

  • В патче prepare_to_HW0.patch вступительного задания метод фильтрации в TimeUtil переименовали в isBetweenHalfOpen (также изменилась логика сравнения - startTime включается в интервал)

Apply 1_1_HW0_streams.patch

video 2. Работа с git в IDEA. Реализация через цикл.

ВНИМАНИЕ! Патчей 1_opt_2_cycles_HW0 и 1_opt_3_opt2_HW0 не будет в проекте! Делаем в отдельной ветке (у меня MealsUtil_opt). Это варианты решений, которые не идут в master

image

Apply 1_opt_2_cycles_HW0.patch

question Вопросы по HW0

почему не использовать в TimeUtil методы isBefore/isAfter ?

это строгие (excluded) сравнения, а нам также нужно краевые значения

В MealsUtil у нас где-то есть ключевое слово final, где-то нет. В чем разница?

Я участвовал в одном проекте, где final был обязательным (в сеттингах IDEA галочка стояла). Но это скорее исключение, чем правило в проектах java (в Java 8 вообще ввели эффективный final, те по факту). Во всех новомодных языках переменные final по умолчанию, а в java нужно помнить и везде добавлять, утомительно. Но если приучитесь - хуже не будет. Я обычно ставлю там, где важно по смыслу (если не забываю).

video 3. HW0 Optional 2: реализация в один проход циклами и Stream API

Apply 1_opt_3_HW0_opt2.patch

Занятие 1:

video 4. Обзор используемых в проекте технологий. Интеграция ПО.

video 5. Обзор языка Java и его инфраструктуры

video 6. Maven.

video 7. WAR. Веб-контейнер Tomcat. Сервлеты.

  • Обновил зависимость до Servlet 4.0. Установите себе Tomcat 9.x
  • Устанавливать Tomcat лучше простым скачиванием архива xxx.zip (например для Windows apache-tomcat-9.0.35-windows-x64.zip) и копированием из него в каталог без пробелов и русских букв (пример С:\java\apache-tomcat-9.0.35)

ВНИМАНИЕ! далее патчи идут в ветку master после 1_1_HW0_streams

Apply 1_2_switch_to_war.patch

  • Обновил сервлеты до версии 4.0 (Tomcat 9 использует это API, хотя для нас не принципиально, т.к. мы никакие фичи 3.x и 4.x Servlet API не используем)
  • Переименовал userList.jsp в users.jsp

Сервлет добавляется в следующем патче, те в web.xml он будет подчеркиваться красным.

Apply 1_3_add_servlet_api.patch

Apply 1_4_forward_to_redirect.patch

<user username="tomcat" password="tomcat" roles="tomcat,manager-gui,admin-gui"/>

video 8. Логирование.

Apply 1_5_logging.patch

Установите переменную окружения на TOPJAVA_ROOT на корень проекта и перезапустите IDEA. Слеши в пути должны быть в стиле unix (/)

image

  • изменения в проекте: убрал LoggerWrapper и логирую напрямую в логгер SLF4J. При логгировании через вспомогательный класс, в логе теряется имя исходного класса.
  • удалил зависимость jul-to-slf4j. Она нам не нужна и, согласно видео Владимира Красильщика про логирование, она замедляет работу
  • удалил зависимость jcl-over-slf4j. Используем Spring 5, который напрямую использует slf4j без common-logging. Про миграцию на Spring 5 будет видео в следующих занятиях.
  • Не делать конкатенацию строк при логгировании сообщений, если уровень логирования в конфигурации выставлен выше уровня логирования в коде

Проверочные вопросы:

  • Что нужно изменить в pom.xml, чтобы перейти с logback на log4j ?

question Ваши вопросы

Почему private static final Logger log а не LOG ?

Это правило именования констант, которые не "deeply immutable", те если их содержимое можно изменить.

Используются ли еще где-то в реальной разработке JSP, или это уже устаревшая технология? Заменит ли ее JSF (https://javatalks.ru/topics/38037)?

JSF и JSP- разные ниши и задачи. JSP- шаблонизатор, JSF - МVС фреймворк. Из моего опыта- с JSP сталкивался в 60% проектов. Его прямая замена: http://www.thymeleaf.org (в Spring-Boot по умолчанию), но в уже запущенных проектах встречается достаточно редко. JSP не умирает, потому что просто и дешево. Кроме того включается в большинство веб-контейнеров (в Tomcat его реализация Jasper)

JSF- sun-овский еще фреймворк, с которым я ни разу не сталкивался и особого желания нет. Вот он как раз, по моему мнению, активно замещается хотя бы javascript фреймворками (angular, react, vue.js).

А зачем мы использовали logback? Почему SLF4J нас не устроило? Почему реализация логирования не log4j?

SLF4J-API это API. Там есть только пустая реализация org.slf4j.helpers.NOPLogger (можно посмотреть в исходниках). Logback для новых проектов стал стандарт. spring-petclinic и spring-boot используют его по умолчанию.

Откуда на maven диаграмме зависимостей появляется slf4j-api 1.7.25?

Это транзитивная зависимость logback-classic (те подтягивается вместе с ним). Ме ее явно перекрыли новой версией slf4j-api 1.7.30, которая совместима с logback-classic 1.2.3. Можно было бы оставить как есть, но когда мы добавим в проект бриджи, они будут у нас более новые (также с версией 1.7.30).

hw Домашнее задание HW01 (делаем ветку HW01 от последнего патча в master)

ОСНОВНОЕ, чему мы учимся на проекте: мыслить и работать как Java разработчики уже сейчас, потом это будет гораздо сложнее и стоить дороже.

Вот на мой взгляд хорошие советы новичкам. От себя я добавлю:

  • Учись грамотно формулировать проблему. Проблема "у меня не работает" может иметь тысячи причин. В процессе формулирования очень часто приходит ее решение.
    • что я делаю (подробно, чтобы понял человек, который не копался в этом совсем)
    • что получаю (обычно верх самого последнего эксепшена)
    • мои попытки решения проблемы
  • Учись исследовать проблему. Внимательное чтение логов и умение дебажить - основные навыки разработчика. Обычно самый верх самого нижнего эксепшена- причина ошибки, туда нужно ставить брекпойнт.
  • Грамотно уделяй время каждой проблеме. Две крайности - сразу бросаться за помощью и биться над ней часами. Пробуй решить ее сам и в зависимости от проблемы выделяй на это разумное время.

1. Реализовать сервлет с отображением в таблице списка еды (в памяти и БЕЗ учета пользователя)

Деплоиться в Tomcat лучше как war exploded: нет упаковки в war и при нажатой кнопке Update Resources on Frame Deactivation можно обновляться css, html, jsp без передеплоя. При изменении web.xml, добавлении методов, классов необходим redeploy.

  • 1.1 По аналогии с UserServlet добавить MealServlet и meals.jsp
    • Задеплоить приложение (war) в Tomcat c applicationContext=topjava (приложение должно быть доступно по http://localhost:8080/topjava)
    • Попробовать разные деплои в Tomcat, remote и local debug
  • 1.2 Сделать отображения списка еды в JSP, цвет записи в таблице зависит от параметра excess (красный/зеленый).
    • 1.2.1 Список еды захардкодить (те проинициализировать в коде, желательно чтобы в проекте инициализация была только в одном месте). Превышение калорий также сделать в коде константой
    • 1.2.2 Время выводить без 'T'
    • 1.2.3 Список выводим БЕЗ фильтрации по startTime/endTime
    • 1.2.4 С обработкой исключений пока можно не заморачиваться, мы будем красиво обрабатывать в конце стажировки
    • 1.2.5 Вариант реализации:
      • из сервлета преобразуете еду в List<MealTo>;
      • кладете список в запрос (request.setAttribute);
      • делаете forward на jsp для отрисовки таблицы (при redirect атрибуты теряются).
      • в JSP для цикла можно использовать JSTL tag forEach. Для подключения JSTL в pom.xml и шапку JSP нужно добавить:
    <dependency>
       <groupId>javax.servlet</groupId>
       <artifactId>jstl</artifactId>
       <version>1.2</version>
    </dependency>

    <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
    ...

Optional

2. Реализуем в ПАМЯТИ CRUD (create/read/update/delete) для еды

Пример: Simple CRUD using Servlet/JSP

  • Пример нужно САМОСТОЯТЕЛЬНО переделать: вместо хранения в MySql нужно хранить в ПАМЯТИ (задание упрощается).
  • Классы: сервлет, инрерфейс хранения, его реализация для хранения в памяти
  • 2.1 Хранение в памяти будет одна из наших CRUD реализаций (позже будет JDBC, JPA и DATA-JPA).
  • 2.2 Работать с реализацией CRUD через интерфейс, который не должен ничего знать о деталях реализации (Map, DB или что-то еще).
  • 2.3 Добавить поле id в Meal/ MealTo и реализовать генерацию счетчика, УЧЕСТЬ МНОГОПОТОЧНОСТЬ СЕРВЛЕТОВ
  • 2.4 Сделать форму редактирования в JSP: AJAX/JavaScript использовать НЕ надо, делаем через <form method="post"> и doPost() в сервлете.
  • 2.5 Для ввода дат и времени можно использовать html5 типы, хотя они поддерживаются не всеми браузерами (протестировать свой браузер). В конце курса мы добавим DateTimePicker jQuery plugin, который будет работать на всех браузерах.
  • 2.6 Форму на create-update предлагаю не дублировать, сделать одну (хотя это не ошибка сделать разные).

После выполнения ДЗ обязательно проверьте решение на ошибки

question Вопросы по HW1

Не попадаю на страничку/брекпойнт в сервлете.

  • внимательно проверь url и applicationContext (Application Context должен быть тот же, что и url приложения: wiki IDEA)
  • посмотрите в task manager: возможно запущено несколько JVM и они мешают друг другу. Лишние java приложения убить.

Приложение не видит TOPJAVA_ROOT.

После выставления переменной окружения IDEA нужно рестартовать. Слеши в пути должны быть в стиле unix (/). Проверить, видит ли java переменную окружения можно так: System.getenv("TOPJAVA_ROOT"). Еще вариант: добавить -DTOPJAVA_ROOT=... в опции запуска приложения, тогда она доступна из java как System.getProperty("TOPJAVA_ROOT").

Проблемы с кодировкой в POST (кракозябры).

Возможное решение - выставьте кодировку ДО первого чтения из request:

protected void doPost(HttpServletRequest request, ...) {
    request.setCharacterEncoding("UTF-8");

Если сервлет тыкают несколько пользователей / несколько браузеров, какого должно быть поведение? Нужно ли что-то делать с сессиями?

В Optional нужно делать реализацию хранения многопоточной. Cессии пока не используем (начнутся, когда будет прикручивать авторизацию).

Для чего нам нужна многопоточная реализация коллекции, если каждый пользователь видит только себя?

Реализация хранения в памяти у нас одна на всех. Те коллекция шарится между пользователями, а они в разных потоках ее дергают. Если несколько потоков одновременно будут изменять коллекцию без учета многопоточности (например один будет удалять, второй вставлять), мы получим ConcurrentModificationException

Предпочтительнее ли создавать новый объект Meal при каждом update?

Если при обновлении не создавать копию, то сохраненный в памяти объект может кто-то попортить. Вопрос скорее доверия к коду- если проект большой и людей над ним трудится много, то вероятнее нужно копировать.

Почему теряются атрибуты при передаче на сервлет: http://localhost:8080/topjava/meals?action=add&... и req.getAttribute("action") = null ?

См. Difference between getAttribute() and getParameter(). Отсюда также следует, что при редиректе атрибуты теряются.

Зачем нужен в jsp <jsp:useBean id=".." scope="request" type=".."/> ?

jsp:useBean нужен IDEA для автодополнений - она понимает тип переменной, которая уже доступна в JSP (например через setAttribute). И еще эта переменная становится доступной в java вставках. Для вывода в JSP это тэг не обязателен. Если тип переменной JSP не совпадает с тем, что в jsp:useBean, будет ошибка.

Итоги занятия после выполнения ДЗ:

Мы создали CRUD веб-приложение для управления едой (создание-чтение-обновление-удаление) с использованием сервлетов и логированием. Пока в памяти, и пока еда никому не принадлежит. Пример выполнения ДЗ (не надо сложного интерфейса, Bootstrap css будем проходить на 8-м занятии):

image image

error Типичные ошибки

  • 0 Обязательно и как можно чаще пользуйтесь Ctrl+Alt+L - отформатировать код класса
  • 1 Если в названии класса есть Meal, не нужно использовать слово meal в методах класса.
  • 2 Привыкайте писать комментарии к чекину: одной фразой что вы сделали в нем. Например: Meals CRUD implementation. См. Как писать сообщения коммитов
  • 3 Хранение в памяти и операции с ней должны выполняться просто и эффективно
  • 4 Хранить нужно Meal и конвертировать ее в MealTo когда отдаем список на отображение в JSP.
    • excess нужно пересчитывать каждый раз перед отображением
    • форматирование должно находится в JSP! Именно он заведует отображением. Повторяем паттерн MVC
  • 5 Стили color можно применять ко всей строке таблицы tr, а не каждой ячейке.
  • 6 DateTimeFormatter можно сделать один заранее (он потокобезопасный в отличие от SimpleDateFormatter), а не создавать новый при каждом запросе.
  • 7 Работать с CRUD надо через интерфейс.
  • 8 Реализаций хранения будет несколько, нужно учитывать это в названии класса имплементации работы в памяти.
  • 9 В web.xml принято группировать сервлет со своим маппингом
  • 10 Не размещайте никакую логику (форматирование, счетчики) в бинах, где хранятся только данные (Meal, MealTo)
  • 11 Еще раз: детали реализации в памяти не должны быть никому видны. Те НЕ НАДО счетчик размещать в Meal или MealServlet или MealsUtil, в базе же он будет по другому генерится.
  • 12 volatile при ++ не помогает от многопоточности. Почему?
  • 13 Обратите также внимание на то, чтобы реализация вашей коллекции для хранения еды была также многопоточной.
  • 14 Не делайте дублирование кода MealsUtil. Возможно вам пригодятся константы LocalTime.MIN и LocalTime.MAX
  • 15 Не дублируйте строки в jsp. Посмотрите на тернарный оператор.
  • 16 После операции delete в браузере должен быть url http:\\localhost:8080\topjava\meals
  • 17 Перед чекином проверяйте свой ченджлист (Ctrl+D на файле из Local Changes - посмотреть что поменялось). Если там только пробелы/переводы строк, не надо его комитить - делайте файлу Git->revert.
  • 18 Учтите в названии реализации CRUD, что
    • 18.1 у нас будет несколько реализаций (не только в памяти)
    • 18.2 у нас будет 2 CRUD (для еды и пользователей). А в реальном проекте их намного больше.
  • 19 Сессии НЕ использовать! При редиректе все атрибуты (req.getAttribute()) теряются (см. вопрос выше). Сценарий редиректа:
    • 1 из сервлета делаем редирект (снова на сервлет, не на JSP!)
    • 2 снова заходим в сервлет
    • 3 кладем нужные атрибуты и делаем forward на jsp
    • 4 если очень хочется передать параметры из 1. в 2. можно сделать их через параметры запроса (например meals?id=5) и доставать через reg.getParameter(id). В моей реализации такого не потребовалось.