pt.despodata.java.ddata
Class DHtmlDataField

java.lang.Object
  pt.despodata.java.ddata.DHtmlDataField

All Implemented Interfaces:

IDDataControlField

public class DHtmlDataField

extends java.lang.Object

implements IDDataControlField

DHtmlDataField.java Informacoes acerca de um campo de uma tabela que e visualizavel Created: Tue Mar 16 14:34:44 2000

Version:

$Revision: 1.3 $ Revision $Revision: 1.3 $ $Date: 2005/04/21 08:59:04 $ $Author: pcarmo $ $Log: DHtmlDataField.java,v $ Revision 1.3 2005/04/21 08:59:04 pcarmo + Os atributos e variaveis com o nome «enum» foram alterados para «myEnum» dado que «enum» e uma palavra reservada no java 1.5. Revision 1.2 2003/07/08 14:23:36 pcarmo + Estes ficheiros foram alterados no repositorio antigo, porque o Nuno Dorotea tinha uma copia antiga do ddata. As alteracoes efectuadas foram as seguinte : + Foi adicionado um atributo que indica se o ApplDataControl deve ser limpo ou não. + Ja e possivel especifica se uma tabela e de detalhe ou nao quando se usa a servlet getImage ou getFile. Revision 1.1.1.1 2003/04/25 12:47:57 pcarmo Migracao do projecto 'src' deste repositorio apos a reorganizacao da estrutura de directorias do projecto. Revision 1.17 2003/04/10 11:16:34 pcarmo + Ja e possivel esppecificar o nome de outra tabela onde esta guardada a imagem ou ficheiro para download. O nome da tabela nao e o nome que a tabela tem na base de dados mas o nome que foi dado a tabela no GaiTableGenerator. + As imagens no tomcat4 ja funciona. Revision 1.16 2003/03/05 15:39:49 pcarmo + Cosmetica Revision 1.15 2001/11/09 18:24:18 pcarmo + Os campos das comboboxs ja podem ser adicionados em separado, sem os '||' + Corrigi um bug, uma linha que e introduzida de novo ja nao possui o 'oldParameter' igual a "". Revision 1.14 2001/11/05 14:17:22 pcarmo + Voltei a introduzir o dataType na assinatura dos metodos, isto so pode desaparecer quando eu alterar as classes IDHtmlDataField, DHtmlDataControl e DHtmlVisualField. Revision 1.13 2001/11/05 14:11:39 pcarmo + O campo dataType deixou de ser relevante para a criacao de um campo visual. Revision 1.12 2001/10/30 18:47:35 pcarmo + So retirei codigo que estava comentado. Revision 1.11 2001/10/30 14:42:25 pcarmo + Estas classes ja nao utilizam o package pt.despodata.java.ddata.connection.* passaram a usar o package pt.despodata.java.connection.* + Aproveitei e alterei os imports com .* para as respectivas classes. Revision 1.10 2001/09/05 16:54:05 pcarmo + Ja e possivel associar o nome de um ficheiro ou outra coluna a um campo. Revision 1.9 2001/07/04 14:56:28 pcarmo + A interface IDDataControlField deixou de extender a interface IDDataVisualField. Primeiro um campo nao tem de ser necessariamente visual, por isso, nao faz sentido. Segundo a maioria dos metodos dos campos visuais nao sao usados. Terceiro sempre que adicionava um novo metodo ao IDDataControlField e consequentemente ao DHtmlVisualField, tinha de o adicionar tambem a classe DHtmlDataField. + O metodo getDefaultVisualField() passou a ser de uso publico. Revision 1.8 2001/07/03 17:54:43 pcarmo + Na adicao de um campo visual, passou a ser necessario especificar o tipo de dados desse mesmo campo. Revision 1.7 2001/06/26 18:02:31 pcarmo + Corrigi um pequeno bug nos metodos isReference() e isRequired() + Ja existe um campo para guardar o valor por defeito de uma coluna. Revision 1.6 2001/06/22 11:03:45 pcarmo + Novos metodos para verificar se um campo visual faz ou nao referencia para campos em outra tabela. Revision 1.5 2001/06/21 17:32:48 pcarmo + Novos metodos para suportar e manipular os campos que fazem referencia a campos em outra tabela. Revision 1.4 2001/06/01 10:25:48 pcarmo + Alteracoes efectuadas no ambito do projecto do GAI. Revision 1.3 2001/04/11 11:21:29 pcarmo + Um campo ja pode ser editavel ou nao. Revision 1.2 2001/03/30 15:52:36 pcarmo + Adicionei um metodo para manter compatibilidade com o que estava feito no projecto do GAI. Revision 1.1 2001/03/30 10:39:37 pcarmo + Alterei a estrutura de dados usada para representar um campo no DHtmlDataControl. A partir de agora, o DHtmlDataControl, possui um conjunto de coluna (que correspondem as colunas da tabela). Cada uma destas colunas, posui zero ou mais campos visuais. Desta forma e possivel criar varios campos visuais sobre a mesma coluna de uma tabela. Isto e util, quando se pretende visualizar a descricao e o codigo que se encontra numa outra tabela.

Author:

Paulo Carmo

Constructor Summary

DHtmlDataField(int columnNumber, java.lang.String columnName, java.lang.String dbDataType, boolean fk, java.lang.Object columnDefault)

Method Summary

void	addDescription(java.lang.String vfName, java.lang.String code, java.lang.Object descr) Adiciona uma descricao a lista de descricoes.
void	addReferencedColumn(java.lang.String vfName, java.lang.String comboboxTableName, java.lang.String comboDescriptionColumn, java.lang.String comboCodeColumn) Adiciona uma chave estrangeira a um campo visual.
void	addVisualField(int width, int height, int fieldType) Adiciona um novo campo visual a coluna, com o mesmo nome da coluna.
void	addVisualField(int width, int height, int visibleWidth, int visibleHeight, int fieldType, int fieldFontSize) Adiciona um novo campo visual com o mesmo nome da coluna.
void	addVisualField(java.lang.String fieldName, int width, int height, int fieldType) Adiciona um novo campo visual a coluna.
void	addVisualField(java.lang.String fieldName, int width, int height, int visibleWidth, int visibleHeight, int fieldType, int fieldFontSize) Adiciona um novo campo visual com um determinado nome.
void	dump() Imprime o conteudo do objecto (para debug apenas)
void	dump(java.lang.String _prefix) Imprime o conteudo do objecto (para debug apenas)
boolean	equals(java.lang.Object obj) Indicates whether some other object is "equal to" this one.
java.lang.Object	getColumnDefault() Get the value of columnDefault.
java.lang.String	getColumnFileName() Devolve o nome da columa que contem o nome do ficheiro.
java.lang.String	getColumnName() Devolve o nome da coluna.
int	getColumnNumber() Get the value of columnNumber.
java.lang.String	getDbDataType() Devolve o valor da propriedade do text field.
IDDataVisualField	getDefaultVisualField() Devolve o campo visualizavel usado por defeito.
java.lang.String	getModelTableName() Devolve o nome da tabela usado pela servlet GetImage.
java.lang.String	getRefWhereStr(java.lang.String vfName) Devolve a clausula de where usada para procurar na tabela referenciada.
IDDataVisualField	getVisualField() Devolve o visualField usado por defeito.
IDDataVisualField	getVisualField(java.lang.String fieldName) Devolve o visualField com um determinado nome.
java.lang.String	getVisualFieldName() Devolve o nome do campo visual usado por defeito.
java.util.Enumeration	getVisualFields() Devolve todos os campos visuais que existem sobre a coluna representada por esta classe.
java.util.Enumeration	getVisualFieldsNames() Constroi uma lista com os nomes dos campos visualizaveis para esta coluna.
boolean	isFk() Get the value of fk.
boolean	isModelTableDetail() Devolve o nome da tabela usado pela servlet GetImage.
boolean	isReference(java.lang.String vfName) Verifica se um campo visual pertence ao DHtmlDataControl, ou se e uma campo que faz referencia para outra tabela.
boolean	isVisualField() Verifica se uma coluna e visualizavel
boolean	isVisualField(java.lang.String vfName) Verifica se existe um campo visualizavel com um dado nome.
void	removeVisualField(java.lang.String fieldName) Removes a visual field from the virtual table.
void	setColumnFileName(java.lang.String columnName) Devolve o nome da columa que contem o nome do ficheiro.
void	setColumnNumber(int v) Set the value of columnNumber.
void	setDbDataType(java.lang.String dbDataType) Afecta o tipo de dados (com uma string que o identifica) que o campo recolhe ou mostra
void	setEditable(java.lang.String vfName, boolean editable) Torna o campo editavel, ou nao editavel.
void	setFk(boolean v) Set the value of fk.
void	setModelTableName(java.lang.String modelTableName, boolean modelTableDetail) Altera o nome da tabela usado pela servlet GetImage.
void	setRefWhereStr(java.lang.String vfName, java.lang.String whereStr) Devolve a clausula de where usada para procurar na tabela referenciada.
void	setRequired(boolean required) Activa ou desactiva a obrigatoridade do campo.
void	setRequired(java.lang.String vfName, boolean required) Activa ou desactiva a obrigatoridade do campo.
java.lang.String	toString() Devolve o conteudo do objecto (para debug apenas)
java.lang.String	toString(java.lang.String _prefix) Devolve o conteudo do objecto (para debug apenas)

Methods inherited from class java.lang.Object

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

Constructor Detail

DHtmlDataField

public DHtmlDataField(int columnNumber,
                      java.lang.String columnName,
                      java.lang.String dbDataType,
                      boolean fk,
                      java.lang.Object columnDefault)

Method Detail

equals

public boolean equals(java.lang.Object obj)

Indicates whether some other object is "equal to" this one.

Parameters:

obj - - the reference object with which to compare.

Returns:

true if this object is the same as the obj argument; false otherwise

addDescription

public void addDescription(java.lang.String vfName,
                           java.lang.String code,
                           java.lang.Object descr)

Adiciona uma descricao a lista de descricoes.

Specified by:

addDescription in interface IDDataControlField

Parameters:

vfName - Nome do campo visual.

code - Codigo da descricao.

descr - Descricao a adicionar.

addReferencedColumn

public void addReferencedColumn(java.lang.String vfName,
                                java.lang.String comboboxTableName,
                                java.lang.String comboDescriptionColumn,
                                java.lang.String comboCodeColumn)

Adiciona uma chave estrangeira a um campo visual.

Specified by:

addReferencedColumn in interface IDDataControlField

Parameters:

vfName - Nome do campo visual.

comboboxTableName - Nome da tabela que contem as descricao e os codigos para popular a combobox.

comboDescriptionColumn - Nome da coluna que contem a descricao na tabela 'comboboxTableName'.

comboCodeColumn - Nome da coluna que contem o codigo na tabela 'comboboxTableName'.

addVisualField

public void addVisualField(int width,
                           int height,
                           int fieldType)

Adiciona um novo campo visual a coluna, com o mesmo nome da coluna.

Specified by:

addVisualField in interface IDDataControlField

Parameters:

height - Altura do campo.

width - Comprimento do campo.

fieldType - Tipo de campo.

addVisualField

public void addVisualField(java.lang.String fieldName,
                           int width,
                           int height,
                           int fieldType)

Adiciona um novo campo visual a coluna.

Specified by:

addVisualField in interface IDDataControlField

Parameters:

height - Altura do campo.

width - Comprimento do campo.

fieldType - Tipo de campo.

addVisualField

public void addVisualField(int width,
                           int height,
                           int visibleWidth,
                           int visibleHeight,
                           int fieldType,
                           int fieldFontSize)

Adiciona um novo campo visual com o mesmo nome da coluna.

Specified by:

addVisualField in interface IDDataControlField

Parameters:

height - Altura do campo.

visibleHeight - Altura visivel do campo.

width - Comprimento do campo.

visibleWidth - Comprimento visivel do campo.

fieldType - Tipo de campo.

fieldFontSize - Tamanho da fonte usada no campo.

addVisualField

public void addVisualField(java.lang.String fieldName,
                           int width,
                           int height,
                           int visibleWidth,
                           int visibleHeight,
                           int fieldType,
                           int fieldFontSize)

Adiciona um novo campo visual com um determinado nome.

Specified by:

addVisualField in interface IDDataControlField

Parameters:

fieldName - Nome do campo visual a adicionar a coluna.

height - Altura do campo.

visibleHeight - Altura visivel do campo.

width - Comprimento do campo.

visibleWidth - Comprimento visivel do campo.

fieldType - Tipo de campo.

fieldFontSize - Tamanho da fonte usada no campo.

getColumnDefault

public java.lang.Object getColumnDefault()

Get the value of columnDefault.

Specified by:

getColumnDefault in interface IDDataControlField

Returns:

Value of columnDefault.

getColumnFileName

public java.lang.String getColumnFileName()

Devolve o nome da columa que contem o nome do ficheiro.

Specified by:

getColumnFileName in interface IDDataControlField

getColumnName

public java.lang.String getColumnName()

Devolve o nome da coluna.

Specified by:

getColumnName in interface IDDataControlField

Returns:

O nome da coluna.

getColumnNumber

public int getColumnNumber()

Get the value of columnNumber.

Specified by:

getColumnNumber in interface IDDataControlField

Returns:

Value of columnNumber.

getDbDataType

public java.lang.String getDbDataType()

Devolve o valor da propriedade do text field.

Specified by:

getDbDataType in interface IDDataControlField

Returns:

Tipo de dados conforme definido em DDataType.

getDefaultVisualField

public IDDataVisualField getDefaultVisualField()
                                        throws DDataException

Devolve o campo visualizavel usado por defeito. Caso exista mais do que um, e gerada uma excepcao.

Specified by:

getDefaultVisualField in interface IDDataControlField

Returns:

Um campo visualizavel.

Throws:

DDataException

getRefWhereStr

public java.lang.String getRefWhereStr(java.lang.String vfName)

Devolve a clausula de where usada para procurar na tabela referenciada.

Specified by:

getRefWhereStr in interface IDDataControlField

Parameters:

vfName - Nome do campo visual.

Returns:

A clausula de where usada para procurar na tabela referenciada.

getVisualField

public IDDataVisualField getVisualField()
                                 throws DDataException

Devolve o visualField usado por defeito.

Specified by:

getVisualField in interface IDDataControlField

Returns:

Uma coluna visualizavel

Throws:

DDataException

getVisualField

public IDDataVisualField getVisualField(java.lang.String fieldName)
                                 throws DDataException

Devolve o visualField com um determinado nome.

Specified by:

getVisualField in interface IDDataControlField

Parameters:

fieldName - O nome do campo.

Returns:

Uma coluna visualizavel

Throws:

DDataException

getVisualFieldName

public java.lang.String getVisualFieldName()
                                    throws DDataException

Devolve o nome do campo visual usado por defeito. So funciona se so existir um campo visual.

Specified by:

getVisualFieldName in interface IDDataControlField

Returns:

O nome do campo visual usado por defeito.

Throws:

DDataException

getVisualFields

public java.util.Enumeration getVisualFields()

Devolve todos os campos visuais que existem sobre a coluna representada por esta classe.

Specified by:

getVisualFields in interface IDDataControlField

getVisualFieldsNames

public java.util.Enumeration getVisualFieldsNames()

Constroi uma lista com os nomes dos campos visualizaveis para esta coluna.

Specified by:

getVisualFieldsNames in interface IDDataControlField

Returns:

Um objecto do tipo Enumeration com os nomes dos campos visualizaveis.

isFk

public boolean isFk()

Get the value of fk.

Specified by:

isFk in interface IDDataControlField

Returns:

Value of fk.

isReference

public boolean isReference(java.lang.String vfName)
                    throws DDataException

Verifica se um campo visual pertence ao DHtmlDataControl, ou se e uma campo que faz referencia para outra tabela.

Specified by:

isReference in interface IDDataControlField

Parameters:

vfName - O nome do campo visual.

Returns:

true caso o campo visual seja uma referencia para uma coluna de outra tabela, false caso contrario.

Throws:

DDataException

isVisualField

public boolean isVisualField()

Verifica se uma coluna e visualizavel

Specified by:

isVisualField in interface IDDataControlField

Returns:

true Se a coluna for Visualizavel, false caso contrario

isVisualField

public boolean isVisualField(java.lang.String vfName)

Verifica se existe um campo visualizavel com um dado nome.

Specified by:

isVisualField in interface IDDataControlField

Returns:

true se existe um campo visualizavel com um dado nome, falso caso contrario.

setColumnFileName

public void setColumnFileName(java.lang.String columnName)

Devolve o nome da columa que contem o nome do ficheiro.

Specified by:

setColumnFileName in interface IDDataControlField

Parameters:

columnName - Nome da coluna.

setColumnNumber

public void setColumnNumber(int v)

Set the value of columnNumber.

Specified by:

setColumnNumber in interface IDDataControlField

Parameters:

v - Value to assign to columnNumber.

setDbDataType

public void setDbDataType(java.lang.String dbDataType)

Afecta o tipo de dados (com uma string que o identifica) que o campo recolhe ou mostra

Specified by:

setDbDataType in interface IDDataControlField

Parameters:

dbDataType - Tipo de dados devolvido

setEditable

public void setEditable(java.lang.String vfName,
                        boolean editable)

Torna o campo editavel, ou nao editavel.

Specified by:

setEditable in interface IDDataControlField

Parameters:

vfName - O nome do campo visual.

editable - true se o campo fôr editável, false caso contrário.

setFk

public void setFk(boolean v)

Set the value of fk.

Specified by:

setFk in interface IDDataControlField

Parameters:

v - Value to assign to fk.

setRefWhereStr

public void setRefWhereStr(java.lang.String vfName,
                           java.lang.String whereStr)

Devolve a clausula de where usada para procurar na tabela referenciada.

Specified by:

setRefWhereStr in interface IDDataControlField

Parameters:

vfName - Nome do campo visual.

whereStr - A clausula de where.

Returns:

A clausula de where usada para procurar na tabela referenciada.

setRequired

public void setRequired(boolean required)

Activa ou desactiva a obrigatoridade do campo.

Specified by:

setRequired in interface IDDataControlField

Parameters:

required - Se for true, o campo e de preenchimento obrigatorio, caso contrario, o campo nao e obrigatorio.

setRequired

public void setRequired(java.lang.String vfName,
                        boolean required)

Activa ou desactiva a obrigatoridade do campo.

Specified by:

setRequired in interface IDDataControlField

Parameters:

vfName - Nome do campo que queremos alterar.

required - Se for true, o campo e de preenchimento obrigatorio, caso contrario, o campo nao e obrigatorio.

removeVisualField

public void removeVisualField(java.lang.String fieldName)

Removes a visual field from the virtual table.

Specified by:

removeVisualField in interface IDDataControlField

Parameters:

fieldName - Nome da coluna a remover

dump

public void dump()

Imprime o conteudo do objecto (para debug apenas)

Specified by:

dump in interface IDDataControlField

dump

public void dump(java.lang.String _prefix)

Imprime o conteudo do objecto (para debug apenas)

Specified by:

dump in interface IDDataControlField

toString

public java.lang.String toString()

Devolve o conteudo do objecto (para debug apenas)

Specified by:

toString in interface IDDataControlField

toString

public java.lang.String toString(java.lang.String _prefix)

Devolve o conteudo do objecto (para debug apenas)

Specified by:

toString in interface IDDataControlField

getModelTableName

public java.lang.String getModelTableName()

Devolve o nome da tabela usado pela servlet GetImage.

Specified by:

getModelTableName in interface IDDataControlField

Returns:

Value of property modelTableName.

isModelTableDetail

public boolean isModelTableDetail()

Devolve o nome da tabela usado pela servlet GetImage.

Specified by:

isModelTableDetail in interface IDDataControlField

Returns:

Value of property modelTableName.

setModelTableName

public void setModelTableName(java.lang.String modelTableName,
                              boolean modelTableDetail)

Altera o nome da tabela usado pela servlet GetImage.

Specified by:

setModelTableName in interface IDDataControlField

Parameters:

modelTableName - New value of property modelTableName.