Deprecate the native Hibernate criteria API in AbstractDAO

Hibernate has deprecated it and since Hibernate 5.2 it's advised to use
the JPA Criteria API. We have implemented support for it in
Dropwizard 1.2, therefore Dropwizard users should be encouraged
to use it.

dropwizard-hibernate/src/main/java/io/dropwizard/hibernate/AbstractDAO.java

@@ -49,7 +49,9 @@ protected Session currentSession() {
      *
      * @return a new {@link Criteria} query
      * @see Session#createCriteria(Class)
+     * @deprecated Use {@link AbstractDAO#criteriaQuery()} instead.
      */
+    @Deprecated
     protected Criteria criteria() {
         return currentSession().createCriteria(entityClass);
     }

dropwizard-hibernate/src/test/java/io/dropwizard/hibernate/AbstractDAOTest.java

@@ -26,6 +26,7 @@
 import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.when;
 
+@SuppressWarnings("deprecation")
 public class AbstractDAOTest {
     private static class MockDAO extends AbstractDAO<String> {
         MockDAO(SessionFactory factory) {