Начало работы с Dropwizard: подключение к базе данных с помощью Hibernate

Это простой старый Java-объект в дополнение к полям, содержащим пару конструкторов, требуются аргументы без аргументов, методы equals () и hashCode (), унаследованные от Object, а также методы получения и установки для всех полей, которые могут быть автоматически сгенерированы IDE и здесь не показаны Также есть несколько аннотаций. Во-первых, @Entity показывает, что этот POJO сопоставлен с таблицей. Второй, @Table , используется для предоставления имени таблицы, в которую отображается POJO, и требуется, только если имена класса и таблицы отличаются, как в нашем случае: Employee / employee . Третий, @Id, используется для пометки поля, которое однозначно идентифицирует экземпляр класса и в нашем случае будет хранить автоматически сгенерированный первичный ключ СУБД. И, наконец, аннотация @GeneratedValue показывает, что мы используем автоинкремент в качестве стратегии генерации, и инструктирует Hibernate считать значение сгенерированного ключа из базы данных в поле id после сохранения новой сущности. Кроме того, есть @Column, который используется, только если имя поля и имя связанного столбца отличаются.

Кроме того, нам нужно украсить нашу сущность еще одной аннотацией — @NamedQuery , которая содержит разделенный запятыми список именованных запросов, каждый из которых используется для извлечения данных из базы данных. Для создания запросов используется специальный язык запросов персистентности Java ( JPQL ), который напоминает SQL, но работает не с таблицами и строками, а с классами и сущностями. Пара запросов для извлечения полного списка сотрудников и поиска сотрудников по имени показана выше.

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

Чтобы скрыть от разработчиков большинство тонкостей использования Hibernate, Dropwizard предлагает нам класс AbsractDAO . Мы должны создать классы DAO, которые реализуют всю логику CRUD, расширяя этот класс. Пример показан здесь.

public class EmployeeDAO extends AbstractDAO<Employee> {

    /**
     * Constructor.
     *
     * @param sessionFactory Hibernate session factory.
     */
    public EmployeeDAO(SessionFactory sessionFactory) {
        super(sessionFactory);
    }

    /**
     * Method returns all employees stored in the database.
     *
     * @return list of all employees stored in the database
     */
    public List<Employee> findAll() {
        return list(namedQuery("com.javaeeeee.dwstart.core.Employee.findAll"));
    }

    /**
     * Looks for employees whose first or last name contains the passed
     * parameter as a substring.
     *
     * @param name query parameter
     * @return list of employees whose first or last name contains the passed
     * parameter as a substring.
     */
    public List<Employee> findByName(String name) {
        StringBuilder builder = new StringBuilder("%");
        builder.append(name).append("%");
        return list(
                namedQuery("com.javaeeeee.dwstart.core.Employee.findByName")
                .setParameter("name", builder.toString())
        );
    }

    /**
     * Method looks for an employee by her id.
     *
     * @param id the id of an employee we are looking for.
     * @return Optional containing the found employee or an empty Optional
     * otherwise.
     */
    public Optional<Employee> findById(long id) {
        return Optional.fromNullable(get(id));
    }
}

@Path("/employees")
@Produces(MediaType.APPLICATION_JSON)
public class EmployeesResource {

    /**
     * The DAO object to manipulate employees.
     */
    private EmployeeDAO employeeDAO;

    /**
     * Constructor.
     *
     * @param employeeDAO DAO object to manipulate employees.
     */
    public EmployeesResource(EmployeeDAO employeeDAO) {
        this.employeeDAO = employeeDAO;
    }

    /**
     * Looks for employees whose first or last name contains the passed
     * parameter as a substring. If name argument was not passed, returns all
     * employees stored in the database.
     *
     * @param name query parameter
     * @return list of employees whose first or last name contains the passed
     * parameter as a substring or list of all employees stored in the database.
     */
    @GET
    @UnitOfWork
    public List<Employee> findByName(
            @QueryParam("name") Optional<String> name
    ) {
        if (name.isPresent()) {
            return employeeDAO.findByName(name.get());
        } else {
            return employeeDAO.findAll();
        }
    }

    /**
     * Method looks for an employee by her id.
     *
     * @param id the id of an employee we are looking for.
     * @return Optional containing the found employee or an empty Optional
     * otherwise.
     */
    @GET
    @Path("/{id}")
    @UnitOfWork
    public Optional<Employee> findById(@PathParam("id") LongParam id) {
        return employeeDAO.findById(id.get());
    }
}

public class DWGettingStartedApplication
        extends Application<DWGettingStartedConfiguration> {

    /**
     * Hibernate bundle.
     */
    private final HibernateBundle<DWGettingStartedConfiguration> hibernateBundle
            = new HibernateBundle<DWGettingStartedConfiguration>(
                    Employee.class
            ) {

                @Override
                public DataSourceFactory getDataSourceFactory(
                        DWGettingStartedConfiguration configuration
                ) {
                    return configuration.getDataSourceFactory();
                }

            };

    ...

    @Override
    public void initialize(
            final Bootstrap<DWGettingStartedConfiguration> bootstrap) {
        bootstrap.addBundle(hibernateBundle);
    }

    ...

}

public class DWGettingStartedApplication
        extends Application<DWGettingStartedConfiguration> {

    ...

    @Override
    public void run(final DWGettingStartedConfiguration configuration,
            final Environment environment) {
        final EmployeeDAO employeeDAO
                = new EmployeeDAO(hibernateBundle.getSessionFactory());

        ...

        environment.jersey().register(new EmployeesResource(employeeDAO));
    }

}