fix javadoc warnings

(cherry picked from commit 760142b)

Author: xvik

guicey-admin-rest/src/main/java/ru/vyarus/guicey/admin/rest/AdminRestServlet.java

@@ -23,6 +23,9 @@ public class AdminRestServlet extends HttpServlet {
      */
     public static final String ADMIN_PROPERTY = AdminRestServlet.class.getName();
 
+    /**
+     * Servlet context.
+     */
     private final Servlet restServlet;
 
     /**

guicey-eventbus/src/main/java/com/google/common/eventbus/SubscriptionIntrospector.java

@@ -22,14 +22,26 @@ public class SubscriptionIntrospector {
     private final EventBus eventbus;
     private Map<Class, Set<Subscriber>> subscribers;
 
+    /**
+     * Create an introspector.
+     *
+     * @param eventbus event bus instance
+     */
     public SubscriptionIntrospector(final EventBus eventbus) {
         this.eventbus = eventbus;
     }
 
+    /**
+     * @return event classes
+     */
     public Set<Class> getListenedEvents() {
         return extractSubscribers().keySet();
     }
 
+    /**
+     * @param event event class
+     * @return event subscribers
+     */
     public Set<Object> getSubscribers(final Class event) {
         final Set<Object> res = new HashSet<>();
         final Set<Subscriber> subscribers = extractSubscribers().get(event);
@@ -41,6 +53,11 @@ public Set<Object> getSubscribers(final Class event) {
         return res;
     }
 
+    /**
+     * @param event event class
+     * @return subscriber classes
+     * @see #getSubscribers(Class) for instances
+     */
     public Set<Class> getSubscriberTypes(final Class event) {
         final Set<Class> res = new HashSet<>();
         for (Object obj : getSubscribers(event)) {

guicey-eventbus/src/main/java/ru/vyarus/guicey/eventbus/module/EventBusModule.java

@@ -26,6 +26,12 @@ public class EventBusModule extends AbstractModule {
     private final EventBus eventbus;
     private final Matcher<? super TypeLiteral<?>> typeMatcher;
 
+    /**
+     * Create event bus module.
+     *
+     * @param eventbus    event bus instance
+     * @param typeMatcher matcher for classes to search listener methods in
+     */
     public EventBusModule(final EventBus eventbus,
                           final Matcher<? super TypeLiteral<?>> typeMatcher) {
         this.eventbus = eventbus;

guicey-eventbus/src/main/java/ru/vyarus/guicey/eventbus/module/TypeLiteralAdapterMatcher.java

@@ -12,6 +12,11 @@
 public class TypeLiteralAdapterMatcher implements Matcher<TypeLiteral<?>> {
     private final Matcher<? super Class<?>> classMatcher;
 
+    /**
+     * Create a type literal matcher.
+     *
+     * @param classMatcher class matcher
+     */
     public TypeLiteralAdapterMatcher(final Matcher<? super Class<?>> classMatcher) {
         this.classMatcher = classMatcher;
     }

guicey-eventbus/src/main/java/ru/vyarus/guicey/eventbus/report/EventSubscribersReporter.java

@@ -25,10 +25,18 @@ public class EventSubscribersReporter {
 
     private final EventSubscribersInfo info;
 
+    /**
+     * Create event bus subscribers reporter.
+     *
+     * @param info subscribers info
+     */
     public EventSubscribersReporter(final EventSubscribersInfo info) {
         this.info = info;
     }
 
+    /**
+     * @return rendered events and subscribers report
+     */
     public String renderReport() {
         final Set<Class> events = info.getListenedEvents();
         if (events.isEmpty()) {

guicey-eventbus/src/main/java/ru/vyarus/guicey/eventbus/service/EventSubscribersInfo.java

@@ -18,6 +18,11 @@
 public class EventSubscribersInfo {
     private final SubscriptionIntrospector introspector;
 
+    /**
+     * Create event bus subscribers info.
+     *
+     * @param eventbus event bus instance
+     */
     @Inject
     public EventSubscribersInfo(final EventBus eventbus) {
         this.introspector = new SubscriptionIntrospector(eventbus);

guicey-jdbi3/src/main/java/org/jdbi/v3/core/TransactionalHandleSupplier.java

@@ -22,6 +22,12 @@ public class TransactionalHandleSupplier implements HandleSupplier {
     private final Jdbi jdbi;
     private final Provider<Handle> handleProvider;
 
+    /**
+     * Create a transactional handle supplier.
+     *
+     * @param jdbi           jdbi instance
+     * @param handleProvider handle provider
+     */
     @Inject
     public TransactionalHandleSupplier(final Jdbi jdbi, final Provider<Handle> handleProvider) {
         this.jdbi = jdbi;

guicey-jdbi3/src/main/java/ru/vyarus/guicey/jdbi3/dbi/SimpleDbiProvider.java

@@ -17,6 +17,11 @@ public class SimpleDbiProvider<C extends Configuration> implements ConfigAwarePr
 
     private final ConfigAwareProvider<PooledDataSourceFactory, C> database;
 
+    /**
+     * Create configuration-aware jdbi provider.
+     *
+     * @param database configuration provider
+     */
     public SimpleDbiProvider(final ConfigAwareProvider<PooledDataSourceFactory, C> database) {
         this.database = database;
     }

guicey-jdbi3/src/main/java/ru/vyarus/guicey/jdbi3/installer/repository/RepositoryInstaller.java

@@ -103,7 +103,7 @@ public List<String> getRecognizableSigns() {
         return Collections.singletonList("@" + JdbiRepository.class + " on class");
     }
 
-    @SuppressWarnings({"unchecked", "checkstyle:Indentation"})
+    @SuppressWarnings({"unchecked", "checkstyle:Indentation", "PMD.UseDiamondOperator"})
     private void generateRepository(final Binder binder, final Class<?> type) {
         // avoid duplicate bindings from classpath scan and binding
         if (bound.contains(type)) {
@@ -158,6 +158,11 @@ public static class JdbiProxyRedirect implements MethodInterceptor {
 
         private final Provider<Object> jdbiProxy;
 
+        /**
+         * Create jdbi proxy interceptor.
+         *
+         * @param jdbiProxy jdbi proxy provider
+         */
         public JdbiProxyRedirect(final Provider<Object> jdbiProxy) {
             this.jdbiProxy = jdbiProxy;
         }

guicey-jdbi3/src/main/java/ru/vyarus/guicey/jdbi3/installer/repository/sql/SqlObjectProvider.java

@@ -33,6 +33,11 @@ public class SqlObjectProvider<T> implements Provider<T> {
     @SuppressWarnings("PMD.AvoidUsingVolatile")
     private volatile T res;
 
+    /**
+     * Dao proxy provider.
+     *
+     * @param extensionType dao class
+     */
     public SqlObjectProvider(final Class<T> extensionType) {
         this.extensionType = extensionType;
     }