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

К примеру, отправка письма на сайте — это сложный процесс, включающий в себя взаимодействие с интернетом. Можно определить метод и скрыть всю сложность за одной короткой конструкцией:

// Место откуда берется метод
import com.example.Mailer;

var email = "support@hexlet.io";
var title = "Помогите";
var body = "Я написал историю успеха, как я могу получить скидку?";

// Mailer – имя класса, в котором определен метод send()
// Один маленький вызов — и много логики внутри
Mailer.send(email, title, body);

Внутри себя подобный вызов выполняет довольно много логики. Он соединяется с почтовым сервером, формирует правильный запрос на основе заголовка и тела сообщения, а затем все это отправляет, не забыв закрыть соединение.

Как создавать методы

Создадим наш первый метод. Его задача — вывести на экран текущую дату:

Today is: 2021-10-25

import java.time.LocalDate;

// Определение метода
// Определение не вызывает и не выполняет метод
// Мы лишь говорим, что теперь такой метод существует
public class App {
    public static void showCurrentDate() {
        // Встроенный метод в Java для получения текущего времени и даты
        var currentDate = LocalDate.now();
        var text = "Today is: " + currentDate;
        System.out.println(text);
    }
}

// Вызов метода
// Обязательно указывать имя класса
App.showCurrentDate(); // => Today is: 2021-10-25

Посмотрим на сигнатуру метода по частям:

public static void showCurrentDate()
  │      │     │           │
  │      │     │           имя метода и список параметров в скобках
  │      │     тип возвращаемого значения
  │      static — метод вызывается напрямую из класса
  видимость метода снаружи класса

Определение метода в Java включает в себя много действий, которые мы постепенно разберем.

Их можно разделить на две группы:

• То, что влияет на работу самого метода
• То, как этот метод видим за пределами класса

За видимость отвечает слово public. Оно дает возможность вызывать методы снаружи класса, как в примере выше. Кроме него существует private, который разбирается на Хекслете в курсе по ООП в Java.

За работу метода отвечают:

• static — отвязывает метод от объекта и делает возможным его вызов напрямую из класса
• void используется, если метод ничего не возвращает. Например, такое определение у метода System.out.println(). Если метод возвращает какие-то данные, то вместо void указывается тип возвращаемых данных

В отличие от обычных данных, методы выполняют действия, поэтому их имена практически всегда должны быть глаголами: "построить что-то", "нарисовать что-то", "открыть что-то".

Все, что описывается внутри фигурных скобок {}, называется телом метода. Внутри тела можно описывать любой код. Считайте, что это маленькая самостоятельная программа, набор произвольных инструкций.

Тело выполняется ровно в тот момент, когда запускается метод. Причем каждый вызов метода запускает тело независимо от других вызовов. Кстати, тело может быть пустым:

// Минимальное определение метода
public class App {
    public static void noop() {
        // Тут мог бы быть код, но его нет
        // Обратите внимание на отступы
        // Для читаемости, любой код внутри тела сдвигается вправо на 4 пробела
    }
}
App.noop();

Понятие "создать метод" имеет много синонимов: "реализовать", "определить" и даже "заимплементить". Все эти термины встречаются в повседневной практике на работе.

Переиспользование и читаемость

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

System.out.println("Hello, Hexlet!");
System.out.println("Hello, world!");
System.out.println("Hello, Java!");

Такой шаблон можно собрать в один метод и вызывать его в разных местах. Когда понадобится поменять текст, правка вносится в одном месте — в определении метода. Чем больше проект и чем чаще повторяется логика, тем заметнее выигрыш.

Название метода само по себе подсказывает, что он делает. Метод showCurrentDate() говорит о своей задаче без дополнительных комментариев. Это помогает другим программистам читать код, а заодно и вам самим через месяц после написания.

Реализуйте статический метод с именем printMotto(), который выведет на экран фразу Winter is coming.

// Класс App уже определен
App.printMotto(); // => Winter is coming

Чтобы мы могли вызвать этот метод снаружи, нужно его пометить не только ключевым словом static, но еще и public.

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