First Java Concepts: JavaBeans Standards – regras de nomes

Especificação JavaBeans define um modelo de componente de software e foi criada para auxiliar desenvolvedores a criar componentes Java que possam ser utilizados de forma fácil por outros desenvolvedores em uma IDE.

A Oracle define que um Java Bean é um componente de software reutilizável que pode ser manipulado visualmente em uma ferramente de desenvolvimento.

Um JavaBean, chamado muitas vezes de apenas Bean, é definido por algumas convenções e regras relativas a  nomenclatura, construção e comportamento. Ele deve ser uma classe que contém propriedades e estas propriedades são atributos privados de uma classe que definem o estado da mesma. Sendo as propriedades privadas, elas só podem ser acessadas dentro de outras classes através de métodos.

Os métodos que são responsáveis por mudar o valor de uma propriedade da classe são chamados de métodos setters e os métodos que retornam o valor de uma propriedade são chamdos de métodos getters.

O nome das propriedades e seus métodos de acesso devem seguir as seguintes regras e convenções:

  • Para propriedades que não sejam booleana, métodos getters devem ter o prefixo get. 

private int size;

public int getSize(){

return this.size;

}

  • Para propriedades booleanas, métodos getters podem ter o prefixo tanto get como is.

private boolean stopped;

public int isStopped(){

 return this.stopped;

}

  • Métodos setters devem ter prefixo set.

private int size;

public void setSize(int size){

this.size = size;

}

  • Métodos getters and setters devem ter a o prefixo apropriado (get, set or is) seguido do nome da propriedade, onde a primeira letra deve ser maiúscula.
  • Métodos setters devem ser públicos, não retornarem nada (void) e receber como argumento o tipo da propriedade que o mesmo corresponde.
  • Métodos getters devem ser públicos, o retorno deve ser do mesmo tipo da propriedade a que este corresponde e não devem receber nenhum argumento.
  • Para métodos utilizados para registrar um novo listener o prefixo deve ser add seguido pelo do tipo do listener.

addActionListener(ActionListener listener){...}

addMyListener(MyListener listener){...}

  • Métodos utilizados para remover um listener devem utilizar o prefixo remove seguido do tipo do listener.

removeActionListener(ActionListener listener){...}

removeMyListener(MyListener listener){...}

  • O tipo do listener que será adicionado ou removido deve ser passado como argumento para o método.
  • Métodos de listeners devem terminar com a paralavra “Listener”.
  • Um Bean deve ter um construtor padrão sem argumentos.
  • A classe deve implementar a interface java.io.Serializable.

 

Referências:

JavaBeans API specification

SCJP Sun® Certified Programmer for Java™ 6 Study Guide