Listboxbind

Sobre

Componente utilizado para listagem e/ou seleção múltipla de uma coleção de objetos. Normalmente utilizada para representar uma relação @ManyToMany. Pode ser utilizado também apenas para listar e recuperar valores selecionados de uma coleção qualquer.

Utilização

XML

<listboxbind
	nomeDoObjeto="classecontrole.objetoAtual.colecaoPersistida"
	colecaoModelo="classecontrole.colecaoModelo"
	propriedadeVisualizada="nomePropriedade"
	titulo="Título" /> 

Entidade

public class MinhaEntidadeVO extends TutorialBaseVO {
	...
	private Set<OutraEntidadeVO> colecaoPersistida =new LinkedHashSet<OutraEntidadeVO>();
	
	@ManyToMany(fetch = FetchType.EAGER)
	public Set<OutraEntidadeVO> getColecaoPersistida() {
		return colecaoPersistida;
	}

	public void setColecaoPersistida(Set<OutraEntidadeVO> colecaoPersistida) {
		this.colecaoPersistida = colecaoPersistida;
	}
	...
	//Demais propriedades ocultadas para brevidade do exemplo
}

Controller

public class MinhaEntidadeCtr extends TutorialBaseCtr<MinhaEntidadeVO> {
	...
	public Set<OutraEntidadeVO> getColecaoModelo() {
		try {
			return repositorio().listar(new OutraEntidadeVO());
		} catch (Exception e) {
			e.printStackTrace();
		}
		return null;
	}
	...
	//Demais propriedades ocultadas para brevidade do exemplo
}

Todos atributos e suas respectivas descrições podem ser visualizados no sumário.

Sumário

Atributo	Tipo	Descrição
nomeDoObjeto	Collection	Vincula um objeto da classe entidade que representa uma coleção @ManyToMany persistida.
colecaoModelo	Collection	Seta a coleção que irá listar todos os possíveis itens que possam vir a ser selecionados.
propriedadeVisualizada	String	Seta o nome da propriedade da classe entidade que será exibida em cada item listado no componente. Padrão toString() da classe.
titulo	String	Define o título que será exibido no cabeçalho da caixa que envolve os itens listados. Não irá possuir cabeçalho se não for definido.