UIFactory - Histórico de revisão

Rodrigogml: /* Anexando um Componente Externo Ao UIFactory */

2023-08-30T14:43:53Z

Anexando um Componente Externo Ao UIFactory

← Edição anterior		Edição das 14h43min de 30 de agosto de 2023
Linha 39:		Linha 39:
	Por exemplo, novos métodos de '''createVOField*''' são disponibilizados. Já sem a necessidade de passar a classe do VO, e permitindo diversas configurações. Ao criar o campo por estes métodos, o field criado já é vinculado ao [[RFWVO]] corrente e qualquer alteração realizada neles será refletida diretamente no [[RFWVO]].		Por exemplo, novos métodos de '''createVOField*''' são disponibilizados. Já sem a necessidade de passar a classe do VO, e permitindo diversas configurações. Ao criar o campo por estes métodos, o field criado já é vinculado ao [[RFWVO]] corrente e qualquer alteração realizada neles será refletida diretamente no [[RFWVO]].

	= Anexando um ~~Componente~~ Externo Ao UIFactory =		=== Anexando um Campo Externo Ao UIFactory ===

	É possível utilizar qualquer componente criado pelo Vaadin com o UIFactory, integrando o componente às funcionalidades do FrameWork. Para isso são necessários 2 passos:		É possível utilizar qualquer componente criado pelo Vaadin com o UIFactory, integrando o componente às funcionalidades do FrameWork. Para isso são necessários 2 passos:

Rodrigogml: /* Criação de Blocos */

2023-08-30T14:43:30Z

Criação de Blocos

@@ Linha 1: / Linha 1: @@
 O '''UIFactory''' nada mais é do que uma classe com diversos recursos para agilizar a produção da UI mantendo um padrão de desenvolvimento e criação por toda a aplicação. Ela não é obrigatória nem necessária, mas em muitos casos utilizar esta classe fará com que você faça muito mais com bem menos linhas de código.
-= Criação de Blocos=
+= Funcionamento do UIFactory =
-Métodos de de criação de blocos são todos estáticos! E tem explicitamente a função de receber em uma única linha de comando todas as definições que queremos do bloco e retorna-lo pronto para uso. Vejamos os exemplos:
+Para facilitar o entendimento, o '''UIFactory''' precisa ser compreendido suas diferentes funções e depois a utilização delas em conjunto:
-Os métodos com o prefixo '''createField_*''' são responsáveis por criar componentes do tipo campos de entrada de dados. Seja um TextBox, um ComboBox, ou componentes mais elaborados como o [[RFWComboMeasureUnit]].
+== Criação de Blocos ==
 = Anexando um Componente Externo Ao UIFactory =

Rodrigogml: /* createField_* */

2023-08-30T14:21:21Z

createField_*

← Edição anterior		Edição das 14h21min de 30 de agosto de 2023
Linha 8:		Linha 8:

	Os métodos com o prefixo '''createField_*''' são responsáveis por criar componentes do tipo campos de entrada de dados. Seja um TextBox, um ComboBox, ou componentes mais elaborados como o [[RFWComboMeasureUnit]].		Os métodos com o prefixo '''createField_*''' são responsáveis por criar componentes do tipo campos de entrada de dados. Seja um TextBox, um ComboBox, ou componentes mais elaborados como o [[RFWComboMeasureUnit]].

			= Anexando um Componente Externo Ao UIFactory =

			É possível utilizar qualquer componente criado pelo Vaadin com o UIFactory, integrando o componente às funcionalidades do FrameWork. Para isso são necessários 2 passos:
			# Crie seu componente como desejar, deve implementar a interface '''com.vaadin.ui.Component'''
			# Passe o componente para o '''UIFactory''' através do método '''registerField()'''



			O método '''registerField()''' realizará duas funções internamente, registrará o componente associando-o ao atributo do VO que está em edição no UIFactory e criará o objeto de Bind que transfere o valor do VO para o Componente e vice-versa.


			{{java\|Exemplo de Criação de RFWComboBoxCity\|<syntaxhighlight lang="java">

			// Cria o componente personalizado
			final Component myComponent = createMyFancyComponent();

			// Chama o método de registro passando os argumentos necessários de acordo com sua configuração
			uiFac.registerField(MyVO_._myAttribute, (HasValue<?>) myComponent, myRFWFormatter, isRequired, myNullValue);


			</syntaxhighlight>}}

	= Gerencimento da Tela =		= Gerencimento da Tela =

Rodrigogml: /* createField_* */

2023-08-30T13:56:11Z

createField_*

← Edição anterior		Edição das 13h56min de 30 de agosto de 2023
Linha 8:		Linha 8:

	Os métodos com o prefixo '''createField_*''' são responsáveis por criar componentes do tipo campos de entrada de dados. Seja um TextBox, um ComboBox, ou componentes mais elaborados como o [[RFWComboMeasureUnit]].		Os métodos com o prefixo '''createField_*''' são responsáveis por criar componentes do tipo campos de entrada de dados. Seja um TextBox, um ComboBox, ou componentes mais elaborados como o [[RFWComboMeasureUnit]].


	= Gerencimento da Tela =		= Gerencimento da Tela =

Rodrigogml: Criou página com 'O '''UIFactory''' nada mais é do que uma classe com diversos recursos para agilizar a produção da UI mantendo um padrão de desenvolvimento e criação por toda a aplicação. Ela não é obrigatória nem necessária, mas em muitos casos utilizar esta classe fará com que você faça muito mais com bem menos linhas de código. = Criação de Blocos= Métodos de de criação de blocos são todos estáticos! E tem explicitamente a função de receber em uma única lin...'

2023-07-31T16:47:57Z

Criou página com 'O '''UIFactory''' nada mais é do que uma classe com diversos recursos para agilizar a produção da UI mantendo um padrão de desenvolvimento e criação por toda a aplicação. Ela não é obrigatória nem necessária, mas em muitos casos utilizar esta classe fará com que você faça muito mais com bem menos linhas de código. = Criação de Blocos= Métodos de de criação de blocos são todos estáticos! E tem explicitamente a função de receber em uma única lin...'

Página nova

O '''UIFactory''' nada mais é do que uma classe com diversos recursos para agilizar a produção da UI mantendo um padrão de desenvolvimento e criação por toda a aplicação. Ela não é obrigatória nem necessária, mas em muitos casos utilizar esta classe fará com que você faça muito mais com bem menos linhas de código.

= Criação de Blocos=

Métodos de de criação de blocos são todos estáticos! E tem explicitamente a função de receber em uma única linha de comando todas as definições que queremos do bloco e retorna-lo pronto para uso. Vejamos os exemplos:

== createField_* ==

Os métodos com o prefixo '''createField_*''' são responsáveis por criar componentes do tipo campos de entrada de dados. Seja um TextBox, um ComboBox, ou componentes mais elaborados como o [[RFWComboMeasureUnit]].

= Gerencimento da Tela =

A função mais avançada do UIFactory é gerenciar os campos e dados da tela. Podendo ser utilizado para criar telas de filtro e exibição de dados, ou telas para edição e entrada de dados.

Para essas funções você precisa instanciar a classe, que será responsável por manter o ciclo de vida dos componentes da tela. Para recomendo que crie um field na sua janela, podendo ser final ou não de acordo com sua implementação:

{{java|Instanciação da UIFactory|<syntaxhighlight lang="java">

private UIFactory<SeuVO> uiFac = new UIFactory<>(SeuVO.class);

</syntaxhighlight>}}

== Gerenciando Tela de Listagem ==

Para criar uma tela de listagem de dados gerenciada pelo '''UIFactory''' temos de criar os campos de filtro utilizando o '''UIFactory'''. Ao criar os campos com a instância do '''UIFactory''' ele fará automaticamente o bind entre os campos criados e os campos do [[RFWMO]]], assim, toda vez que o usuário solicitar que os dados sem filtrados o próprio '''UIFactory''' criará o [[RFWMO]] para realizar essa busca.

Vejamos alguns exemplos:

{{java|Instanciação da UIFactory|<syntaxhighlight lang="java">

// Cria um campo para filtrar a listagem do SeuVO pelo atributo 'name'
TextField textField = this.uiFac.createMOField(SeuVO_._name, "100px", "200px");
textField.focus(); // Coloca o foco no primeiro campo da tela de busca

// Cria um campo para filtrar a listagem do SeuVO pelo atributo 'description'
this.uiFac.createMOField(SeuVO_._description, "100px", "400px");

</syntaxhighlight>}}

=== Criando Painel com os Campos ===

Se você criou os campos para filtrar com o '''UIFactory''' ele cria um modelo de painel com os campos de busca, botão de busca, botão de limpeza, etc.. para ser colocado na tela. para isso utilize o seguinte método:

{{java|Instanciação da UIFactory|<syntaxhighlight lang="java">

private void doLayout() {
try {
// Atualiza o conteúdo do searchPanel
searchPanel.setContent(uiFac.createSearchPanel(1, null, getDBProvider()));
} catch (RFWException e) {
TreatException.treat(e);
}
}

</syntaxhighlight>}}

O painel criado por este método utiliza o tamanho do componente pai para distribuir os componentes na tela, e atualmente não é responsivo. Assim, se o usuário mudar o tamanho do browser a tela precisará ser corrigida. Como solução até que este painel seja responsivo, é fazer a janela implementar a interface [[BrowserWindowResizeEvent]] que recebe um evento caso o painel precise ser refeito. ''Note que este evento é lançado a partir do '''RFWFrame''', se você não o utilizar o evento não será recebido.