Sobre o uso de métodos de propridade JSF Visual Web

Consulte também

Uma operação comum no código Java do componente é consultar ou definir as propriedades de outros componentes nessa página. Embora você possa ter definido valores iniciais para essas propriedades no IDE quando criou a página, os métodos de propriedade padrão, chamados de getters e setters, permitem que você acesse essas propriedades do código Java. Cada componente padrão possui um método getter ou setter para cada propriedade. Uma propriedade somente leitura possui um getter, mas não um setter. Se você adicionar uma nova propriedade a um componente, o IDE automaticamente adiciona os métodos getter e setter para você.

Sobre os getters

Um getter retorna o valor de uma propriedade. Para obter o valor de uma propriedade, use get e o nome da propriedade com a letra inicial em maiúscula. Por exemplo, para obter o valor da propriedade value de um componente, use o método getValue. Por exemplo, o código a seguir obtém a propriedade value de um componente Texto de saída:

outputText1.getValue();

De forma similar, para obter os valores da propriedade title ou style de um componente, use o método getTitle ou getStyle. Cada propriedade de componente possui um método getter correspondente e retorna o valor dessa propriedade.

A maioria dos métodos getter de propriedades retornam um objeto String. O método getValue é uma exceção: ele retorna um objeto de classe Objeto. Dependendo do que você desejar fazer com esse objeto (atribui-lo a outra propriedade, modificar seu valor e assim por diante), você poderá convertê-lo em outra classe. A conversão transforma um objeto de uma classe em uma instância de outra classe.

Por exemplo, para converter o objeto contido na propriedade value de um componente Campo de texto em uma instância da classe String, use o seguinte código:

String name = (String)textField1.getValue();

A janela Propriedades pode mostrar a classe de objeto que cada propriedade espera. A dica de ferramenta de cada propriedade mostra o nome descritivo completo assim como o nome da classe (por exemplo Objeto, String, Booleano). Você também pode descobrir a classe que cada método getter retorna no Editor Java das dicas de auto-completar código.

Propriedades que contêm valores booleanos podem ser consultadas com is e o nome da propriedade. Por exemplo, a propriedade escape para componentes relacionados a texto ou a propriedade disabled são valores booleanos. Elas podem ter valores true ou false e podem ser consultadas com os métodos isEscape e isDisabled. Métodos getter booleanos retornam um valor booleano (true ou false) e podem ser usados em testes, como mostrado no exemplo a seguir:

if (button1.isDisabled()) {

// test the disabled property
// se a condição for verdadeira, faça o seguinte
// ...
} else {

// otherwise do this
// ...
}

// end if

Sobre setters

Um setter permite que você altere o valor de um propriedade. Para definir o valor de qualquer propriedade, use um método que consiste na palavra set com o nome dessa propriedade e inicie o nome da propriedade com letra maiúscula. Os métodos setter requerem um valor para definir a propriedade para um Objeto, uma String ou um Booleano, dependendo da propriedade. Veja alguns exemplos:

Consulte também
Trabalhando com componentes
Tarefas de componente: referência rápida
Sobre páginas

Notificações legais