Core Java. Лекция 12

Массивы и другие аннотации

//Массивы задаются в фигурных скобках
@BugReport(..., reportedBy = {"Harry", "Carl"})

//То же самое, что {"Harry"}
@BugReport(..., reportedBy = "Harry")

//Конструирование вложенных аннотаций
@BugReport(..., ref = @Reference(id = "12345"))

//...Как видим, используя разрешённые типы,
//можно задать сколь угодно сложную структуру данных

Где можно использовать аннотации

Использование аннотаций в декларациях

Примеры использования аннотаций в декларациях

@Entity
public class User {

  @Caption("user")
  public User getUser(@Param("id") String userId) {

    @SuppressWarnings("unchecked")
    List<User> users = ....
  }
}


class Cache<@Immutable V> {
 ...
}

Аннотирование пакетов — в package-info.java

//package-info.java
@GPL(version="3")
package edu.phystech.corejava;
import org.gnu.GPL;

Аннотирование использования типов

//аннотированный параметр, утверждает, что userId -- не `null`
User getUser(@NonNull String userId) { ... }

//Аннотированные использования типа: каждая строчка не `null`
List<@NonNull String> list = ...
Comparator.<@NonNull String>reverseOrder()
class Warning extends @Localized Message { ... }

List<@Localized ? extends Message> = ...

(@Localized String) text

if (text instanceof @Localized String) ...

//и т. д., список примеров не полный.
// Аннотации могут быть почти везде!

Java8+: аннотирование использования типа в this

public class Foo {
  //аннотируется использование типа!
  void baz(@ReadOnly Foo this){
    ...
  }

  class Bar {
    //аннотируется использование типа!
    public Bar(@ReadOnly Foo Foo.this) {
      ...
    }
  }
}

Знакомые стандартные (встроенные в язык) аннотации

Стандартные (встроенные в язык) аннотации

Аннотации управляются аннотациями

//Какие элементы кода могут быть аннотированы
@Target({ElementType.TYPE, ElementType.METHOD})

//На каком уровне сохраняются эти аннотации
@Retention(RetentionPolicy.Source)
public @interface BugReport {
 ...
}

Target

RetentionPolicy

Другие мета-аннотации

Рефлексия (Reflection API)

Employee e = ... //присваиваем Employee
Employee m = ... //присваиваем Manager

//Получаем информацию в Runtime
Class<? extends Employee> ce = e.getClass();
Class<? extends Employee> cm = m.getClass();

System.out.printf("%s, %s%n", ce.getName(), cm.getName());
//edu.phystech.hello.Employee, edu.phystech.hello.Manager

System.out.printf("%s, %s%n", ce.getSimpleName(), cm.getSimpleName());
//Employee, Manager

Класс Class<T> параметризован

Employee e = ...;

//No cast needed!
Class<? extends Employee> c = e.getClass();

//No cast needed!
Employee newEmployee =
  ce.getDeclaredConstructor().newInstance();

//Compile-time error!
Class<? extends Number> cn = e.getClass();

Class literals

Class literals — примеры

//тут всё понятно
Class<String> c1 = String.class;
Class<Integer> c2 = Integer.class;

//Да, так можно!!
Class<Integer> c3 = int.class;
//А ещё double.class, boolean.class и т. д.

//При этом c2 и с3 -- существенно РАЗНЫЕ объекты
//(например, c3.getConstructors() возвращает пустой массив).

//Тут ничего неожиданного нет, массивами можно параметризовать:
Class<int[]> c4 = int[].class;

NB: странные имена классов-массивов

Динамический способ получения мета-класса

//может быть выброшен  ClassNotFoundException
//параметр типа тут никак не может быть известен
Class<?> clazz =
  Class.forName("edu.phystech.hello.Manager");

//Есть две формы:

//загрузчик вызвавшего метода, статическая инициализация
static Class<?> forName(String className)
                         throws ClassNotFoundException

//кастомный загрузчик, статическая инициализация по запросу
static Class<?> forName(String name, boolean initialize,
                                   ClassLoader loader)

Загрузка ресурсных файлов

public InputStream getResourceAsStream(String name)
public java.net.URL getResource(String name)

Анализ возможностей класса и взаимодействие с элементами класса

Получение членов класса

Доступ к элементам

Анализ аннотаций в runtime

Рефлексия и Generics

ReflectionUtils

Класс с аннотированными полями

public class Person {
    @Published
    private final String firstName;
    @Published
    private final String lastName;
    @Published
    private final LocalDate birthDate;
    ...
}

JsonSerializer: определение полей, помеченных @Published

public class JsonSerializer<T> {
  private final Set<Field> publishedFields;

  public JsonSerializer(Class<T> serializedClass) {
    publishedFields = ReflectionUtils
       .getAllFields(serializedClass,
                f -> f.isAnnotationPresent(Published.class));
  publishedFields.forEach(f -> f.setAccessible(true));
}

JsonSerializer: сериализация объекта

public JSONObject serialize(T o) {
  JSONObject result = new JSONObject();
  for (Field f : publishedFields) {
    Object fieldValue = null;
    try { fieldValue = f.get(o); }
      catch (IllegalAccessException e) {
        throw new IllegalStateException(e); }
      if (fieldValue instanceof LocalDate) {
        result.put(f.getName(),
    ((LocalDate) fieldValue).format(DateTimeFormatter.ISO_LOCAL_DATE));
      } else {
        result.put(f.getName(), fieldValue);
      }
    }
  return result;
}

Пример с Controller

public class Controller {
    private final Service service;

    @Command("foo")
    void doSomething() {
        service.foo();
    }
    @Command("bar")
    void bar() {
        service.bar();
    }
    @Command()
    void help() {
        service.help();
    }
}

CommandDispatcher

public class CommandDispatcher {
    private final Object controller;
    private final Map<String, Method> methodHashMap =
                                        new HashMap<>();
    private Method defaultMethod;

CommandDispatcher: инициализация

public CommandDispatcher(Object controller) {
  Objects.requireNonNull(controller);
  this.controller = controller;
  for (Method method : ReflectionUtils
           .getAllMethods(controller.getClass())) {
    Command command = method.getAnnotation(Command.class);
    if (command != null) {
       //Извлекаем параметр из аннотации
        String commandId = command.value();
        if (commandId.isEmpty()) {
            defaultMethod = method;
        } else {
            methodHashMap.put(commandId, method);
        }
    }
  }
}

CommandDispatcher: выполнение команды

public void executeCommand(String command)
  throws InvocationTargetException, IllegalAccessException {
    Method method = methodHashMap
      .getOrDefault(command, defaultMethod);
    if (method != null){
        method.invoke(controller);
    }
}

Наш учебный пример про доклады и спикеров

Реальная «слоистая» архитектура серверного приложения

Попытка №1, наивная. «Пусть объекты сами создают себе то, что им надо»

public class DataSource {
  private ConnectionPool pool = new ConnectionPool(....);
    //взятые откуда-то параметры подключения к БД ^^^^^^
  ...
}

public class SpeakerDao {
  private DataSource ds = new DataSource();
  ...
}

public class TalkDao {
  private DataSource ds = ???
    //нам нужен один ConnectionPool на всех...
    //не получается :-(
  ...
}

Попытка №2. Выложим ссылку на единичный объект в статическое поле

public class ConnectionPool {
  private final static ConnectionPool instance =
                                  new ConnectionPool(...);
  public static ConnectionPool getInstance() {
    return instance;
  }
  //конструктор сделаем приватным, чтобы ни у кого не было соблазна
  //создать объект явно
  private ConnectionPool(...){

  }
}

Попытка №2. (продолжение)

public class DataSource {
  private final static DataSource instance = ...
  public DataSource getInstance() {
    return instance;
  }

  private ConnectionPool pool = ConnectionPool.getInstance();

  private DataSource() {
    ...
  }
}

Мы только что изобрели дизайн-паттерн «Одиночка»!

Erich Gamma et al., Design Patterns: Elements of Reusable Object-Oriented Software Книга 1994 года Классическая книга по дизайну ПО…​ …​но местами уже устаревшая.

Singleton Pattern

Синглетоноварение: подход №1

public class Singleton {
  //Создание Singleton "спрятано"
  private static final Singleton instance = new Singleton();

  public static Singleton getInstance() {
    return instance;
  }

  //Лишаем возможности создать экземпляр объекта "извне"
  private Singleton(){
  }
}

Подход №2

public class Singleton {
    private static Singleton instance;

    public static Singleton getInstance() {
        if (instance == null) {
           instance = new Singleton();
        }
        return instance;
    }
    private Singleton(){
    }
}

Подход №3 ?!

public class Singleton {
    private static volatile Singleton instance;

    public static Singleton getInstance() {
        if (instance == null) {
            instance = new Singleton();
        }
        return instance;
    }
    private Singleton(){
    }
}

Подход №4 ?! ?!

public class Singleton {
    private static Singleton instance;

    public static synchronized Singleton getInstance() {
        if (instance == null) {
            instance = new Singleton();
        }
        return instance;
    }
    private Singleton(){
    }
}

Подход №5 ?! ?! ?!

public class Singleton {
    private static Singleton instance;
    private static final Object lock = new Object();
    public static Singleton getInstance() {
        if (instance == null)
            synchronized (lock) {
                if (instance == null)
                    instance = new Singleton();
            }
        return instance;
    }
    private Singleton() {
    }
}

Подход №6 . . .

public class Singleton {
    private static volatile Singleton instance;
    private static final Object lock = new Object();
    public static Singleton getInstance() {
        if (instance == null)
            synchronized (lock) {
                if (instance == null)
                    instance = new Singleton();
            }
        return instance;
    }
    private Singleton() {
    }
}

Подход №7. Код из книги "Effective Java, 3rd edition"

public class Singleton {
  private static volatile Singleton instance;
  private static final Object lock = new Object();
  public static Singleton getInstance() {
    Singleton result = instance;
    if (result == null) {
      synchronized (lock) {
        if (instance == null)
          instance = result = new Singleton();
        }
     }
     return result;
  }
}

Подход №7. Код из книги "Effective Java, 3rd edition"

public class Singleton {
  private static volatile Singleton instance;
  private static final Object lock = new Object();
  public static Singleton getInstance() {
    Singleton result = instance;
    if (result == null) {
      synchronized (lock) {
        if (instance == null)
          instance = result = new Singleton();
        }
     }
     return result;
  }
}

Единственно Верный Ленивый Потокобезопасный Синглетон

public class Singleton {
    private static volatile Singleton instance;
    private static final Object lock = new Object();
    public static Singleton getInstance() {
        Singleton result = instance;
        if (result != null)
            return result;

        synchronized (lock) {
            if (instance == null)
                instance = new Singleton();
            return instance;
        }
    }
    private Singleton() {}
}

Подход №8

// Correct lazy initialization in Java
public class Singleton {
    private static class SingletonHolder {
       public static final Singleton instance = new Singleton();
    }

    public static Singleton getInstance() {
        return SingletonHolder.instance;
    }
    private Singleton() {
    }
}