csbase.client.algorithms.parameters

Class ParameterLoaderView

java.lang.Object

csbase.client.algorithms.parameters.ParameterLoaderView

All Implemented Interfaces:

ViewValidator

public class ParameterLoaderView
extends Object
implements ViewValidator

Visão (botão) do carregador de parâmetros. O carregador de parâmetros executa um algoritmo a partir da janela de um configurador. O algoritmo executado, chamado Extrator, pode ter como entrada alguns dos parâmetros definidos neste configurador e tem como saída os valores de alguns parâmetros deste configurador.

Constructor Summary

Constructors

Constructor and Description
ParameterLoaderView(ParameterGroupView groupView, csbase.logic.algorithms.parameters.ParameterLoader parameterLoader) Construtor.

Method Summary

Methods

Modifier and Type	Method and Description
JComponent	getComponent() Obtém o componente da visão.
Map<String,String>	getExtractParametersValues() Obtém os parâmetros usados na execução do algoritmo extrator.
String	getOutputExtractFileName() Obtém o nome do arquivo de saída gerado pelo Extrator.
csbase.logic.algorithms.parameters.ParameterLoader	getParameterLoader() Obtém o carregador de parâmetros
boolean	highlightValidationResult(ViewValidationResult result) Indica na visão o resultado da validação.
ViewValidationResult	validate(csbase.logic.algorithms.validation.ValidationMode mode) Validamos se o carregador de parâmetros foi executado com as entradas que estão selecionadas.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ParameterLoaderView

public ParameterLoaderView(ParameterGroupView groupView,
                   csbase.logic.algorithms.parameters.ParameterLoader parameterLoader)

Construtor.

Parameters:

groupView - Visão do grupo

parameterLoader - Carregador de parâmetros

Method Detail

validate

public ViewValidationResult validate(csbase.logic.algorithms.validation.ValidationMode mode)

Validamos se o carregador de parâmetros foi executado com as entradas que estão selecionadas.

Não basta apenas comparar o valor passado para o ParameterLoaderView ao ser requisitada a extração dos dados, com o valor durante a execução. O conteúdo do mapa dos parâmetros do algoritmo extrator não necessariamente vai bater com a lista dos parâmetros de entrada do modelo.
Para facilitar a explicação abaixo de como é feita a validação, será utilizada a palavra VISÃO para se referir ao mapa dos parâmetros do algoritmo extrator presente na visão e a palavra MODELO para indicar a lista dos parâmetros de entrada do modelo.

Abaixo pode ser visto como fica o estado de cada a cada momento.

1. Momento: edição dos parâmetros do comando.
   
   Condição: inicial.
   • VISÃO -> vazio
   • MODELO -> tem o nome dos parâmetros de entrada.
   
   Condição: após os valores serem carregados pelo método loadParameterValues().
   • VISÃO -> tem os parâmetros de entrada.
   • MODELO -> tem o nome dos parâmetros de entrada.
   
   Condição: após o comando de extração ser submetido através do método submitExtractCommand().
   A VISÃO será usada como mapa de parâmetros do algoritmo extrator. Devido a isso, o parâmetro de saída do algoritmo extrator será incluído nela.
   • VISÃO -> tem os parâmetros de entrada mais o parâmetro de saída.
   • MODELO -> tem o nome dos parâmetros de entrada.


2. Momento: executando a partir de um fluxo.
   
   Condição: inicial
   Ao ser requisitada uma execução de fluxo, os valores dos parâmetros são previamente salvos, o modelo é recriado com novas instâncias de configuradores para cada nó e os valores são atribuídos aos parâmetros destas novas instâncias. Só ai o comando é executado. O MODELO faz parte do configurador e a VISÃO da visão do configurador. Como o configurador e sua visão são recriados e somente os dados do primeiro são salvos, a VISÃO perde todos os seus dados. Ela irá permanecer assim por que o botão de carregar nunca será acionado durante o processo de execução.
   • VISÃO -> vazio.
   • MODELO -> tem o nome dos parâmetros de entrada.


3. Momento: executando como um comando simples.
   
   Condição: inicial
   O mesmo configurador e visão utilizado no processo de edição de parâmetros será utilizado na execução de um comando simples. Sendo assim, o estado final da VISÃO e do MODELO da etapa anterior, será o estado inicial deles na etapa de execução.
   • VISÃO -> tem os parâmetros de entrada mais o parâmetro.
   • MODELO -> tem o nome dos parâmetros de entrada.

Devido a estas discrepâncias entre o MODELO e a VISÃO, para ser aceito como válida uma instância de um ParameterLoaderView, todos os parâmetros presentes na VISÃO que estiverem sendo referenciados pelo MODELO, devem ser iguais aos valores do configurador no momento da validação. Assim, quando a VISÃO tiver o parâmetro de saída que não aparece no MODELO, este será ignorado. Quando o MODELO tiver parâmetros e a VISÃO não eles só podem ter sido inseridos através do método ParameterLoader.addInputParameterName(String). Sendo assim não há como saber qual o valor que eles tinham durante a extração dos dados. Supõe-se que eles foram adicionados durante a execução de um fluxo que reconstruiu o modelo e por isso estariam corretos. Somente pode-se garantir os parâmetros existentes tanto na VISÃO quanto no MODELO e estes quando existirem é que devem ser validados.

Specified by:

validate in interface ViewValidator

Parameters:

mode - Modo de validação (ValidationMode.FULL ou ValidationMode.ALLOW_EMPY_VALUES).

Returns:

O resultado da validação.

highlightValidationResult

public boolean highlightValidationResult(ViewValidationResult result)

Indica na visão o resultado da validação.

Specified by:

highlightValidationResult in interface ViewValidator

Parameters:

result - o resultado da validação.

Returns:

verdadeiro se o resultado foi mostrado ou falso, caso contrário.

getComponent

public JComponent getComponent()

Obtém o componente da visão.

Returns:

o componente da visão

getExtractParametersValues

public Map<String,String> getExtractParametersValues()

Obtém os parâmetros usados na execução do algoritmo extrator.

Returns:

.

getOutputExtractFileName

public String getOutputExtractFileName()

Obtém o nome do arquivo de saída gerado pelo Extrator.

Returns:

o nome do arquivo de saída gerado pelo Extrator.

getParameterLoader

public csbase.logic.algorithms.parameters.ParameterLoader getParameterLoader()

Obtém o carregador de parâmetros

Returns:

.