We should give at least a brief description of both, so that the programmer who goes to get them does not even have the possibility of not understanding what it is.
/**
* Modelo para criação e validação do Código de Barras da Caixa
*
* @author João Victor B. Magalhães
* @since 0.1
* @version 0.1
*
*/
public class CodigoDeBarrasCaixa implements CodigoDeBarrasBoleto {
private String digitos;
private BoletoBancario boleto;
private static final int TIPO_DE_COBRANCA = 2;
private static final int ID_EMISSOR_BOLETO = 4;
private static final int TIPO_MOEDA = 9;
}
I do not see a need to document Getters and Setters, but if you have a more complex method or a hard-to-understand attribute, you should also document it. In the controller the same thing, give a description of what it does and if it has any method outside the "common" document it.
If it is already a program that is distributed in a team always put @since for the team to know when you added the method and @version as well.