Package systextil.nxj

Class FormController

java.lang.Object

systextil.nxj.DataViewController

systextil.nxj.FormController

All Implemented Interfaces:

DataViewListener

public abstract class FormController
extends DataViewController

Subclasses desta classe podem controlar quase toda a lógica a ser executada em um formulário do Systêxtil no NXJ. Para isso, devem implementar os métodos não finais que forem usados no formulário. Todos os métodos finais executam uma lógica correspondente no formulário em formData e foram implementados para conveniência na programação.

Nested Class Summary

Nested classes/interfaces inherited from class systextil.nxj.DataViewController

DataViewController.BeepException

Field Summary

Fields

Modifier and Type	Field	Description
protected FormData	formData
protected br.com.intersys.systextil.global.Mdi	mdi
protected br.com.intersys.systextil.global.TagInteractive	tagInteractive
protected br.com.intersys.systextil.global.UtilTag	utilTag

Fields inherited from class systextil.nxj.DataViewController

ADD_UPDATE, CANCEL_ZOOM, CLEAR_TO_ADD, CLEAR_TO_FIND, containerData, DELETE, EXIT, FIND, FIRST_RECORD, LAST_RECORD, log, NEXT_FIELD, NEXT_FORM, NEXT_RECORD, NEXT_SET, PREVIOUS_FIELD, PREVIOUS_FORM, PREVIOUS_RECORD, PREVIOUS_SET, ZOOM

Constructor Summary

Constructors

Constructor	Description
FormController(FormData formData)	Constrói um controlador para o formulário desejado.

Method Summary

Modifier and Type	Method	Description
void	addDataView(DataViewController dataView)	Adiciona um DataViewController a esse FormController.
void	afterApplication()
void	afterFormReturn()
void	afterModeChange()
void	afterZoom()
void	beforeApplication()
void	beforeForm()
void	beforeModeChange()
void	commit()
<T extends DataViewController> T	createDataView(Class<? extends DataViewController> dataViewClass, ContainerData data)	Cria um DataViewController da classe informada case ele ainda não tenha sido criado. Independente de quantas vezes esse método for chamado, ele irá retornar sempre a primeira instancia criada para esse DataView.
void	displayToMessageBox(br.com.intersys.systextil.global.TagException e)	Mostra uma mensagem para o usuário
void	displayToMessageBox(String tag)	Mostra uma mensagem para o usuário
br.com.intersys.systextil.connection.Amount	getAmount(String formName, String name)	Obtém valor de um campo ou variável de um formulário anterior.
Boolean	getBoolean(String formName, String name)	Obtém valor de um campo ou variável de um formulário anterior.
br.com.intersys.systextil.connection.AppConnection	getConn()
<T extends DataViewController> T	getDataView(Class<? extends DataViewController> dataViewClass)	Busca um DataViewController previamente adicionado a esse FormController. Note que o compilador do NXJ não aceita Generics, logo, no NXJ, é necessário fazer o cast para a classe de retorno.
Date	getDate(String formName, String name)	Obtém valor de um campo ou variável de um formulário anterior.
Double	getDouble(String formName, String name)	Obtém valor de um campo ou variável de um formulário anterior.
Integer	getInt(String formName, String name)	Obtém valor de um campo ou variável de um formulário anterior.
String	getString(String formName, String name)	Obtém valor de um campo ou variável de um formulário anterior.
Time	getTime(String formName, String name)	Obtém valor de um campo ou variável de um formulário anterior.
Timestamp	getTimestamp(String formName, String name)	Obtém valor de um campo ou variável de um formulário anterior.
boolean	isAlphaValid(int tipo, String conteudo)
br.com.intersys.systextil.connection.AppConnection	newAppConnection(String sql, Object... params)	Constroi um novo AppConnection com base no SQL e nos parametros passados. O valor de todos os parâmetros que sejam um Nullable serão substituido por Nullable.value()
void	onChooseNextForm()
void	onExit()
void	onNextForm()
void	onPreviousForm()
void	queueNextForm(String formName)
void	rollback()
void	set(String formName, String name, boolean value)	Atribui valor a um campo ou variável de um formulário anterior.
void	set(String formName, String name, double value)	Atribui valor a um campo ou variável de um formulário anterior.
void	set(String formName, String name, int value)	Atribui valor a um campo ou variável de um formulário anterior.
void	set(String formName, String name, br.com.intersys.systextil.connection.Amount value)	Atribui valor a um campo ou variável de um formulário anterior.
void	set(String formName, String name, String value)	Atribui valor a um campo ou variável de um formulário anterior.
void	set(String formName, String name, Date value)	Atribui valor a um campo ou variável de um formulário anterior.
void	set(String formName, String name, Time value)	Atribui valor a um campo ou variável de um formulário anterior.
void	set(String formName, String name, Timestamp value)	Atribui valor a um campo ou variável de um formulário anterior.

Methods inherited from class systextil.nxj.DataViewController

addAllowed, addAllowed, afterAdd, afterDelete, afterField, afterFind, afterSave, afterUpdate, backgroundColor, backgroundColor, beforeAdd, beforeDelete, beforeField, beforeFind, beforeRecord, beforeSave, beforeUpdate, clearAddExp, clearFindExp, currentRecordNumber, deleteAllowed, deleteAllowed, deleteCurrentRecord, findAllowed, findAllowed, getAmount, getBoolean, getDate, getDouble, getInt, getString, getTime, getTimestamp, inFindMode, initDataView, initField, isCurrentRecordNew, isCurrentRecordStored, isNull, isNull, onClearToAdd, onClearToFind, onDataAccept, onFind, onLeave, onNextRecord, onPreviousRecord, onSearchRangeAccept, positionToRecord, queueCommand, queueNextField, recordCount, registerField, rejectOperation, rejectRecord, searchRanges, set, set, set, set, set, set, set, set, setNull, setStippled, sqlOptionalCondition, sqlOrderByClause, stopForInput, stopForInput, updateable, updateable, updateAllowed, updateAllowed, updateCurrentRecord, validar, visible, visible, whenValueChanges

Methods inherited from class java.lang.Object

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

Field Details

utilTag

protected final br.com.intersys.systextil.global.UtilTag utilTag

mdi

protected final br.com.intersys.systextil.global.Mdi mdi

tagInteractive

protected final br.com.intersys.systextil.global.TagInteractive tagInteractive

formData

protected final FormData formData

Constructor Details

FormController

public FormController(FormData formData)

Constrói um controlador para o formulário desejado.

Parameters:

formData - implementação fornecida pelo formulário para interagir com ele.

Method Details

createDataView

public final <T extends DataViewController> T createDataView(Class<? extends DataViewController> dataViewClass,
 ContainerData data)

Cria um DataViewController da classe informada case ele ainda não tenha sido criado.

Independente de quantas vezes esse método for chamado, ele irá retornar sempre a primeira instancia criada para esse DataView. Na primeira vez que o método for chamado, ele irá criar uma instancia dessa DataView, e nas chamadas subsequentes o retorno de createDataView(Class, ContainerData) e getDataView(Class) será o mesmo.

Note que o compilador do NXJ não aceita Generics, logo, no NXJ, é necessário fazer o cast para a classe de retorno.

Parameters:

dataViewClass - a Class do dataView que se deseja criar, essa classe obrigatoriamente deve extender de DataViewController

data - um ContainerData

Returns:

um DataViewController da classe passada no parametro no dataViewClass

Throws:

RuntimeException - quando o construtor DataViewController(ContainerData, FormController) não existir na classe informada.

addDataView

public final void addDataView(DataViewController dataView)

Adiciona um DataViewController a esse FormController.

Parameters:

dataView - o DataViewController que será adicionado.

getDataView

public final <T extends DataViewController> T getDataView(Class<? extends DataViewController> dataViewClass)

Busca um DataViewController previamente adicionado a esse FormController.

Note que o compilador do NXJ não aceita Generics, logo, no NXJ, é necessário fazer o cast para a classe de retorno.

Parameters:

dataViewClass - a Class do DataView que se está buscando.

Returns:

um DataViewController

set

public final void set(String formName,
 String name,
 int value)

Atribui valor a um campo ou variável de um formulário anterior.

set

public final void set(String formName,
 String name,
 String value)

Atribui valor a um campo ou variável de um formulário anterior.

set

public final void set(String formName,
 String name,
 double value)

Atribui valor a um campo ou variável de um formulário anterior.

set

public final void set(String formName,
 String name,
 br.com.intersys.systextil.connection.Amount value)

Atribui valor a um campo ou variável de um formulário anterior.

set

public final void set(String formName,
 String name,
 Date value)

Atribui valor a um campo ou variável de um formulário anterior.

set

public final void set(String formName,
 String name,
 Time value)

Atribui valor a um campo ou variável de um formulário anterior.

set

public final void set(String formName,
 String name,
 boolean value)

Atribui valor a um campo ou variável de um formulário anterior.

set

public final void set(String formName,
 String name,
 Timestamp value)

Atribui valor a um campo ou variável de um formulário anterior.

getInt

public final Integer getInt(String formName,
 String name)

Obtém valor de um campo ou variável de um formulário anterior.

getString

public final String getString(String formName,
 String name)

Obtém valor de um campo ou variável de um formulário anterior.

getDouble

public final Double getDouble(String formName,
 String name)

Obtém valor de um campo ou variável de um formulário anterior.

getAmount

public final br.com.intersys.systextil.connection.Amount getAmount(String formName,
 String name)

Obtém valor de um campo ou variável de um formulário anterior.

getDate

public final Date getDate(String formName,
 String name)

Obtém valor de um campo ou variável de um formulário anterior.

getTime

public final Time getTime(String formName,
 String name)

Obtém valor de um campo ou variável de um formulário anterior.

getBoolean

public final Boolean getBoolean(String formName,
 String name)

Obtém valor de um campo ou variável de um formulário anterior.

getTimestamp

public final Timestamp getTimestamp(String formName,
 String name)

Obtém valor de um campo ou variável de um formulário anterior.

commit

public final void commit()

rollback

public final void rollback()

queueNextForm

public final void queueNextForm(String formName)

displayToMessageBox

public final void displayToMessageBox(String tag)

Description copied from class: DataViewController

Mostra uma mensagem para o usuário

Overrides:

displayToMessageBox in class DataViewController

displayToMessageBox

public void displayToMessageBox(br.com.intersys.systextil.global.TagException e)

Description copied from class: DataViewController

Mostra uma mensagem para o usuário

Overrides:

displayToMessageBox in class DataViewController

getConn

public final br.com.intersys.systextil.connection.AppConnection getConn()

Overrides:

getConn in class DataViewController

Returns:

a conexao do controller passado

afterApplication

public void afterApplication()
                      throws Exception

Throws:

Exception

afterFormReturn

public void afterFormReturn()
                     throws Exception

Throws:

Exception

afterModeChange

public void afterModeChange()
                     throws Exception

Throws:

Exception

afterZoom

public void afterZoom()
               throws Exception

Throws:

Exception

beforeApplication

public void beforeApplication()
                       throws Exception

Throws:

Exception

beforeForm

public void beforeForm()
                throws Exception

Throws:

Exception

beforeModeChange

public void beforeModeChange()
                      throws Exception

Throws:

Exception

onExit

public void onExit()
            throws Exception

Throws:

Exception

onNextForm

public void onNextForm()
                throws Exception

Throws:

Exception

onPreviousForm

public void onPreviousForm()
                    throws Exception

Throws:

Exception

onChooseNextForm

public void onChooseNextForm()
                      throws Exception

Throws:

Exception

newAppConnection

public br.com.intersys.systextil.connection.AppConnection newAppConnection(String sql,
 Object... params)

Constroi um novo AppConnection com base no SQL e nos parametros passados.
O valor de todos os parâmetros que sejam um Nullable serão substituido por Nullable.value()

Parameters:

sql - uma String contendo o sql

params - os parametros do sql

Returns:

um novo AppConnection configurado com a conexão padrão desse formulário, o sql e os parametros informados

isAlphaValid

public boolean isAlphaValid(int tipo,
 String conteudo)

Parameters:

tipo - verifica se o campo é de relatório para não permitir espaço 0 - tipo normal 1 - tipo relatório 2 - tipo e-mail (campo para validacao de e-mail) conteudo = caracteres do campo a ser verificado

conteudo -

Returns:

boolean Se ocorrer alguma exception retorna false