🖥 Создание Javadoc на уровне пакета: package-info.java или package.html

⏩Для документирования пакетов в Java предпочтительнее использовать package-info.java, а не package.html. Это обусловлено поддержкой аннотаций в package-info.java, что дает большие возможности по интеграции с фреймворками и обеспечивает типобезопасность. Более того, создатели инструментов среды разработки чаще выбирают package-info.java из-за его консистентности и возможности включения тегов версий, таких как @since.

⏩А вот пример использования package-info.java:

/**
 * Пакет, содержащий инструменты для апплетов и связующие интерфейсы.
 * @since 1.2
 */
@FrameworkAnnotation 
package com.example.applet;

import com.example.framework.FrameworkAnnotation;

📎 Подробнее

@javatg

🖥 Для чего нужен модификатор transient?

▶️Каково назначение модификатора transient в Java?

▶️Чтобы ответить на этот вопрос, сперва вспомним ещё один термин.
Сериализация — это преобразование экземпляра класса в форму, пригодную для его сохранения (например в файл, в БД или для передачи по сети). Сериализованные объекты можно затем восстановить (десериализовать).

Свойства класса, помеченные модификатором transient, не сериализуются.

Обычно в таких полях хранится промежуточное состояние объекта, которое, к примеру, проще вычислить, чем сериализовать, а затем десериализовать. Другой пример такого поля — ссылка на экземпляр объекта, который не требует сериализации или не может быть сериализован.

@javatg

🖥 Микросервисы — собеседование по Java. Разбор вопросов и ответов

🔥 Держите отличную подборку вопросов и ответов на позицию Java-разработчика. Большой акцент делается работе с микросервисами.
Всего здесь 114 вопросов, они есть простые/сложные, теоретические/практические, уверен найдёте здесь много полезного для себя

Вот, кстати, некоторые вопросы:
• Что такое сплоченность микросервисов?
• В чем разница между макетом и заглушкой?
• Что вы знаете о тестовой пирамиде Майка Кона?
• Какова цель Docker?
• Можем ли мы использовать микросервисы для создания конечных автоматов?
• Что такое Spring Cloud?
• Как решать сквозные проблемы, такие как безопасность, в архитектуре микросервисов?
• Что такое Netflix Feign? В чем его преимущества?
• Почему отладка так сложна в микросервисной архитектуре?

Пользуйтесь)
📎 Ссылка

@javatg

🖥 Какие отличия между @NotEmpty, @NotBlank и @NotNull?

▶️В разных примерах Entity класса, по-разному валидируют поля:

@NotNull
@Size(min=3)
@Column(name = "login")
private String login;

@Email
@Size(min=6, max=80)
@NotBlank(message="{register.email.invalid}")
@Column(name = "email", unique=true)
private String email;

@Column(name = "first_name")
@NotEmpty(message = "Please provide your first name")
private String firstName;

@Column(name = "last_name")
@NotEmpty(message = "Please provide your last name")
private String lastName;

@Transient
private String password;

Но какие между ними различия и что следует использовать и в каких случаях?

А также если указана аннотация @Size(min=6, max=80) нужно ли дополнительно проверять с помощью @NotBlank или других аннотаций?


▶️Итак, ответ:

• @NotBlank применяется только к строкам и проверяет, что строка не пуста.

• @NotNull применяется к CharSequence, Collection, Map или Array и проверяет, что объект не равен null. Но при этом он может быть пуст.

• @NotEmpty применяется к CharSequence, Collection, Map или Array и проверяет, что он не null имеет размер больше 0.

Аннотация @Size(min=6) пропустит строку состоящую из 6 пробелов и/или символов переноса строки, а @NotBlank не пропустит.

@javatg

🖥 Настройка активного профиля и конфига в Spring Boot

⏩Итак, для быстрой установки указывайте профиль и путь к файлам конфигурации Spring Boot, используя следующие параметры:
— Профили: --spring.profiles.active=имя_профиля
— Путь к конфигурации: --spring.config.location=путь_к_конфигурации

Пример команды:

java -jar app.jar --spring.profiles.active=dev --spring.config.location=file:/config/

С помощью этой команды будет активирован профиль dev, а конфигурация загружена из указанного каталога.

Однако, командная строка Spring Boot предоставляет намного больше возможностей. Давайте рассмотрим это детальнее.


⏩Понимание типов свойств и комбинирование профилей

Важно отделять системные свойства Java от свойств Spring по префиксам -D и -- соответственно. Параметры командной строки позволяют настраивать приложение Spring Boot при его запуске.

# Почему бы не воспользоваться преимуществами двух подходов?
java -Dspring.profiles.active=dev,qa -jar ваше_приложение.jar

Эта команда активирует одновременно профили dev и qa, что дает возможность объединить настройки из нескольких профилей, при условии что они разработаны для совместного использования.

📎 Читать подробнее

@javatg

🖥 Хороший стиль обработки ошибок

Правильная и хорошая обработка ошибок — довольно важная часть в разработке. Но как это делать правильно?

⏩Когда делать RuntimeException, а когда просто Exception

⏩Единственен ли способ генерации ошибки оператором throw?

⏩В каких лучше случаях создать, допустим, MyException extends Exception, а затем MyOtherException extends MyException? Иными словами, как увидеть необходимость в иерархии ошибок?

⏩Когда делать примерно так:

public void f() throws MyException {
   //некоторый код ...
   if (....){
       throw MyException(...);
   }
}

⏩Какие еще есть способы генерации ошибок?

⏩Когда правильнее переносить ошибку на уровень функции (... f() throws ...)?


▶️Что ж, попробуем на это ответить.
Во-первых, используйте исключения. Создайте свою иерархию исключений и продумайте, какие из них сделать *runtime*, а какие нет. Никогда не используйте конструкции типа new Exception(...) или new RuntimeException. Вместо этого старайтесь создавать и кидать только адекватные ситуации исключения. Создание экземпляра Exception или RuntimeException — халтура и отписка вместо обработки ошибок.

Не забывайте проверять все параметры в конструкторах и, по возможности, в методах и своевременно кидать IllegalArgumentException. Пользуйтесь стандартными исключениями в соответствующих случаях. Используйте их по назначению и никогда не кидайте что попало.

Пользуйтесь try/catch/finally. Не забывайте уничтожать ресурсы.

Пользуйтесь логгерами, а не делайте e.printStackTrace. Никогда не делайте catch пустым, если только вы не уверены, что должны именно проигнорировать исключение.

При логгировании пользуйтесь по возможности полный метод log с уровнем логгирования, сообщением и исключением. Старайтесь в сообщении к логу описать, что именно упало и добавить какие-то сведения об условиях в блоке try. Это поможет выявить проблемы в боевых условиях. Старайтесь назначать адекватные уровни логгирования.

📎 Подробнее про обработку ошибок тут

@javatg

🖥 Как работает этот код?

⏩А ты знаешь, что будет при запуске этого кода на Java?

for (byte i = 126; i<=127; i++) {
  System.out.println(i);
}

Возникнет бесконечный цикл, код будет выполняться без остановки. Хороший вопрос: почему так происходит? Ведь если написать i < 127, то всё работает нормально.
Дело в том, что byte имеет значения от -128 до 127. Поэтому 127+1 даёт -128 и условие <=127 всегда истинно.
Такие дела

@javatg

🖥 Как скомпилировать исходники Java вручную

Наш проект будет состоять всего из двух классов, причём один будет вызывать метод другого.

🟡Класс Greeter содержит метод sayHello(). Этот метод выводит приветствие на экран:

package ru.devmark.helper;

public class Greeter {
    public void sayHello() {
        System.out.println("Привет, мир!");
    }
}

🟡Сохраним этот исходный код в текстовый файл, имя которого обязательно должно совпадать с именем класса, т.е. Greeter.java.

package ru.devmark;

import ru.devmark.helper.Greeter;

public class HelloWorld {
    public static void main(String[] args) {
        var greeter = new Greeter();
        greeter.sayHello();
    }
}

Сохраним исходный код этого класса в файле HelloWorld.java.

🟡Поскольку здесь есть статический метод main(), этот класс можно использовать как точку входа для нашего приложения (так называемый «Main-Class»). Внутри мы создаём экземпляр класса Greeter, вызываем его единственный метод и выводим результат на экран.

🟡Теперь мы готовы к тому, чтобы скомпилировать написанный нами код. Для этого используется утилита javac, которая поставляется вместе с jdk. Выполним эту команду в той папке, где лежат оба наших файла:

javac -d . *.java

Опция -d указывает, куда сложить скомпилированные файлы. В результате в нашей папке помимо исходников появится иерархическая структура папок и файлов:

├── Greeter.java
├── HelloWorld.java
└── ru
    └── devmark
        ├── HelloWorld.class
        └── helper
            └── Greeter.class

🟡Но когда мы говорим о приложении, то ожидаем увидеть один файл, а не кучу папок. Давайте упакуем наши class-файлы в jar-архив. В этом нам поможет одноимённая утилита.

jar cfe hello.jar ru.devmark.HelloWorld ru

Опция c говорит, что нужно создать новый архив, f задаёт имя будущего архива, а e указывает полное имя main-класса. В конце указываем папку, в которой лежат все class-файлы.

📎 Читать подробнее
📎 YouTube

@javatg

🖥 Юнит-тесты: чек-лист методик проектирования

⏩Держите полезную статью о тестах в Java и не только.
Основная идея заключается в том, чтобы не просто писать тесты, а максимально эффективно покрывать функциональность при минимуме написанных тестов. Главная помощь этих тестов будет заметна при рефакторинге приложения.

Что внутри?
• Проектирование тестов
• Методики проектирования
• Уровни тестов
• Эквивалентное разделение
• Анализ граничных значений
• Доменный анализ
• Тестовая комбинаторика

📎 Статья

@javatg

💻 Запуск Kotlin кода без IDE

▶️Итак, вопрос: как скомпилировать простенький код написанный на Kotlin без IDE?


▶️Вот пошаговая инструкция:

⏩1. Загрузить компилятор. Найти последнюю версию можно здесь.

⏩2. Распаковать компилятор в отдельную папку, добавить bin директорию в переменную окружения PATH. Об этом можно почитать тут. Bin содержит скрипты, необходимые для сборки и запуска кода на Windows, OS X и Linux.
Другой вариант установки компилятора: для OS X, Linux, Cygwin, FreeBSD или Solaris (возможно, и другие UNIX-системы), то можно использовать SDKMAN https://sdkman.io/.
Запускаем в терминале:

$ curl -s https://get.sdkman.io | bash

Затем следуем инструкциям. Потом потребуется открыть новое окно терминала и установить Kotlin с помощью команды:

$ sdk install kotlin

▶️Теперь кратко о создании и запуске простого приложения.

⏩1. Создаем файл - `hello.kt` со следующим кодом:

fun main(args: Array<String>) {
   println("Hello, World!")
}

⏩2. Компилируем, используя командную строку:

$ kotlinc hello.kt -include-runtime -d hello.jar

Подробнее о флагах компиляции можно почитать в мане:

$ kotlinc -help

⏩3. Запускаем приложение:

$ java -jar hello.jar

📎Более подробно о других вариантах установки компилятора, компиляции библиотек, запуске Kotlin-скриптов и прочем в доках

@javatg