błąd Maven Checkstyle: Oczekiwany tag @param dla '<T>'

Question

Mam następującą metodę z typów generycznych, ale gdy uruchamiam Checkstyle maven (Maven-Checkstyle-plugin, 2.121) to przechowywane daje mi komunikat o błędzie podczas Expected @param tag for '<T>' maven kompilacji. Jak mam się z tym pogodzić?

Użyłem następujących po włączeniu ogólnego znacznika param, ale to nie zadziałało i mam wyżej wspomniany dokument java.

<module name="JavadocType"> 
    <property name="allowMissingParamTags" value="true"/> 
</module> 

Answer 1

jest informacją, że nie napisać javadoc dla parametru typu metoda:

/** 
* ... 
* @param <T> This is the type parameter 
* @param .... 
*/ 
public <T extends Object> T getExpectedValue(
     final HttpServletRequest request, final Class<T> expected) 

wytworzony javadoc będzie zawierać sekcję jak następuje w nagłówku:

Type Parameters: 
    T - This is the type parameter 

Answer 2

Dodajesz znacznik @param do swojej Javadoc.

coś takiego:

/** 
* ... other comments here ... 
* @param T The expected class of the value. 
* @param request ... other comments here ... 
* @param expected ... other comments here ... 
* @return ... other comments here ... 
*/ 
public <T extends Object> T getExpectedValue(
    final HttpServletRequest request, final Class<T> expected) 

Jeśli nie są użyciu Javadoc, to prawdopodobnie nie powinien mieć Javadoc ostrzeżenia włączone.