Arquivo DATABASES.XML

As declarações das chaves de conexão encontram-se nas tags <group>. Este arquivo está composto pelas chaves de conexão com os bancos de dados que o Webrun suporta.

Cada banco de dados possui a sua própria sintaxe de chaves e particularidades nas configurações. O Webrun lê o conteúdo do arquivo *.wfre e substitui as informações nas chaves. Por exemplo:

• Chaves que identificam o driver de conexão:

• • Para PostgreSQL 8.2.5:

  <item>

  <item-param>org.postgresql.Driver</item-param>

  </item>

  • Para FireBird:

  <item>

  <item-param>org.firebirdsql.jdbc.FBDriver</item-param>

  </item>

  • Para MSSQL:

  <item>

  <item-param>net.sourceforge.jtds.jdbc.Driver</item-param>

  </item>

  • Para Oracle:

  <item>

  <item-param>oracle.jdbc.driver.OracleDriver</item-param>

  </item>

  • Para MySQL:

  <item>

  <item-param>com.mysql.jdbc.Driver</item-param>

  </item>

  • Para DB2:

  <item>

  <item-param>com.ibm.db2.jcc.DB2Driver</item-param>

  </item>

  • Para ODBC:

  <item>

  <item-param>sun.jdbc.odbc.JdbcOdbcDriver</item-param>

  </item>

• Chaves que identificam a URL de conexão:

• • Para PostgreSQL:

  • <item>

    <item-param>jdbc:postgresql://$HostName$:$Port$/$DataBase$</item-param>

    </item>

  • Para FireBird:

  • <item>

    <item-param> jdbc:firebirdsql:$Database$?lc_ctype=$ServerCharSet$</item- param>

    </item>

  • Para MSSQL:

  • <item>

    <item-param>:jtds:sqlserver://$HostName$:1433/$DataBase$;charset=iso-8859-1;useLOBs=false;sendStringParametersAsUnicode=false;useCursors=true</item-param>

    </item>

  • Para Oracle:

  • <item>

    <item-param>jdbc:oracle:thin:@$DataBase$</item-param>

    </item>

  • Para MySQL:

  • <item>

    <item-param>jdbc:mysql://$HostName$/$DataBase$</item-param>

    </item>

  • Para DB2:

  • <item>

    <item-param>jdbc:db2j:net://$HostName$:50000/$DataBase$</item-param>

    </item>

  • Para ODBC:

  • <item>

    <item-param>sun.jdbc.odbc.JdbcOdbcDriver</item-param>

    </item>

• Chave que identifica o usuário:

• O formato é o mesmo para todos os bancos:

  <item>

  <item-name>UserField</item-name>

  <item-param>User_Name</item-param>

  </item>

• Chave que identifica o Servidor:

• • Para Interbase e Firebird:

  • <item>

    <item-param>Database</item-param>

    </item>

  • Para MSSQL, Oracle e PostgreSQL:

  • <item>

    <item-param>HostName</item-param>

    </item>

• Chave que executa o comando Commit:

• O Webrun abre uma transação para cada vez que o formulário estiver no modo de inserção, exclusão ou edição, e é verificado tudo que ocorreu dentro da transação. Havendo algum erro, é dado um rollback. O parâmetro pode ser configurado com o valor 0 ou 1. Se o valor for 1, significa que toda vez que for feita alguma transação, o Webrun dará um Commit. Segue abaixo um exemplo que é o mesmo para todos os bancos de dados:

  <item>

  <item-name>AutoCommit</item-name>

  <item-param>1</item-param>

  </item>

• Chave que executa o CommitClausule:

• Significa que a cláusula do Commit (confirmação) fecha todos os Datasets (fonte de dados). Se houver o Retain (reter) vai manter as fontes de dados abertas, nas quais manterão a transação. Este recurso é disponível apenas para FireBird:

  <item>

  <item-name>CommitClausule</item-name>

  <item-param>COMMIT RETAIN</item-param>

  </item>

• Chave que executa o TrimString:

• Caso o driver de conexão do banco de dados coloque caracteres especiais, utilizando o valor 1 para o parâmetro, o Webrun executará TrimString removendo os caracteres especiais (retirando todos os espaços, caracteres de tabulação, quebra de linha no começo e no  final):

  <item>

  <item-name>TrimString</item-name>

  <item-param>1</item-param>

  </item>

• Chave que executa o FetchSize:

• Configura a quantidade de registros para o cash do servidor, quando abrir uma consulta com um formulário. Pega a primeira página de dados do servidor que fica guardada na memória. Este parâmetro é disponível para todos os bancos de dados:

  <item>

  <item-name>FetchSize</item-name>

  <item-param>100</item-param>

  </item>

• Chave que executa o TimeOut:

• Solicita uma conexão de abertura de um formulário. O Webrun fica tentando abrir, aguardando até que o banco de dados retorne com os dados. Por padrão, vem com o valor 1, significando que fica aguardando indefinidamente até que o banco de dados retorne com algum erro. Este parâmetro é utilizado para todos os bancos de dados:

  <item>

  <item-name>TimeOut</item-name>

  <item-param>-1</item-param>

  </item>

• Chave que executa o Generator:

• • O caractere @ que é colocado na frente do Valor-Padrão ou no Dicionário de Dados. É detectável pelo Webrun, que será obtido pelo URL, ao inserir do formulário:

  • Para PostgresSQL

  • <item>

    <item-name>Generator</item-name>

    <item-param>SELECT NEXTVAL('$generator$')</item-param>

    </item>

  • Para FireBird

  • <item>

    <item-param>SELECT GEN_ID($generator$,1) FROM RDB$DATABASE</item-param>

    </item>

  • Para MSSQL

  • <item>

    <item-param>DECLARE @AUTOINC INT EXEC SP_GEN_ID '$generator$', 1, @AUTOINC OUT SELECT @AUTOINC</item-param>

    </item>

  • Para Oracle

  • <item>

    <item-param>SELECT $generator$.NEXTVAL FROM dual</item-param>

    </item>

  • Para DB2

  • <item>

    <item-param>SELECT NEXTVAL FOR $generator$ FROM SYSIBM.DUAL</item-param>

    </item>

• Chave que executa o ExceptionPrimaryKey:

• • Na identificação do PrimaryKey, é verificado por exemplo, se existe outro usuário com o mesmo ID. Caso o banco de dados seja diferente do idioma inglês, será necessário que faça alteração:

  • Para PostgresSQL

  • <item>

    <item-name>ExceptionPrimaryKey</item-name>

    <item-param>unique constraint</item-param>

    </item>

  • Para FireBird

  • <item>

    <item-param>violation of PRIMARY</item-param>

    <item-param>UNIQUE KEY</item-param>

    </item>

  • Para MSSQL

  • <item>

    <item-param>Violation of PRIMARY</item-param>

    <item-param>duplicate key</item-param>

    <item-param>UNIQUE KEY</item-param>

    </item>

  • Para Oracle:

  • <item>

    <item-param>ORA-00001</item-param>

    <item-param>ORA-01400</item-param>

    </item>

  • Para MySQL:

  • <item>

    <item-param>Duplicate entry</item-param>

    </item>

  • Para DB2:

  • <item>

    <item-param>DB2 SQL error: SQLCODE: -803</item-param>

    </item>

• Chave que executa o ExceptionForeignKey;

• • Identificação do ForeingKey é verificado, por exemplo, se existe outro usuário com o mesmo ID. Caso o banco de dados seja diferente da língua inglesa será necessário que faça alteração no arquivo.

  • Para PostgresSQL:

  • <item>

    <item-name>ExceptionForeignKey</item-name>

    <item-param>foreign key constraint</item-param>

    </item>

  • Para FireBird:

  • <item>

    <item-param>violation of FOREIGN KEY</item-param>

    </item>

  • Para MSSQL:

  • <item>

    <item-param>REFERENCE constraint</item-param>

    <item-param>FOREIGN KEY constraint</item-param>

    <item-param>COLUMN REFERENCE constraint</item-param>

    <item-param>foreign key constraint</item-param>

    </item>

  • Para Oracle:

  • <item>

    <item-param>ORA-02291</item-param>

    <item-param>ORA-02292</item-param>

    </item>

  • Para MySQL:

  • <item>

    <item-param>foreign key constraint</item-param>

    </item>

  • Para DB2:

  • <item>

    <item-param>DB2 SQL error: SQLCODE: -532</item-param>

    </item>

• Chave que executa o AppendSQL4MetaData;

• • Para PostgreSQL:

  • <item>

    <item-name>AppendSQL4MetaData</item-name>

    <item-param>LIMIT 0</item-param>

    </item>

  • Para MSSQL:

  • <item>

    <item-param>FOR BROWSE</item-param>

    </item>

  • Para Oracle:

  • <item>

    <item-param>) where (rownum < 1)</item-param>

    </item>

  • Para MySQL:

  • <item>

    <item-param>LIMIT 0,0</item-param>

    </item>

  • Para DB2:

  • <item>

    <item-param>FETCH FIRST 1 ROWS ONLY</item-param>

    </item>

• Chave que executa o ModifySQL4MetaData:

• • Atributo para quando extrair dados de um select. Cada banco tem a sua particularidade para obter informações de metadados. Exemplo: para um banco de dados que tenha 6 mil registros com esse atributo, retorna a nenhum resultado, para não se tornar lento.

  • Para MSSQL:

  • <item>

    <item-name>ModifySQL4MetaData</item-name>

    <item-param>top 0</item-param>

    </item>

• Chave que executa o Autoinc (autoincremento):

• • Para PostgresSQL:

  • <item>

    <item-name>Autoinc</item-name>

    <item-param>SELECT CURRVAL('$table$_$field$_seq')</item-param>

    </item>

• Chave que executa o AutoincSupport:

• • Para MySQL, DB2:

  • <item>

    <item-name>AutoincSupport</item-name>

    <item-param>1</item-param>

    </item>

• Chave que executa o CaseSensitive:

• • Caso tenha essa propriedade, é necessário que o desenvolvedor respeite a particularidade do banco.

  • Para PostgresSQL e FireBird:

  • <item>

    <item-name>CaseSensitive</item-name>

    <item-param>1</item-param>

    </item>

• Chave que executa o SchemaField:

• • Parâmetro do *.Wfre do Schema.

  • Para PostgresSQL:

  • <item>

    <item-name>SchemaField</item-name>

    <item-param>RoleName</item-param>

    </item>

• Chave que executa o Schema:

• • Para a definição de regras de validação, caso o driver não passe como padrão, pode-se configurar o Schema, colocando uma sintaxe SQL para definir.

  • Para PostgresSQL:

  • <item>

    <item-name>Schema</item-name>

    <item-param>SET search_path=$schema$</item-param>

    </item>

• Chave que executa o InsertOnStarSQL4MetaData:

• • Inserir depois da cláusula select.

  • Para Oracle:

  • <item>

    <item-name>InsertOnStarSQL4MetaData</item-name>

    <item-param>select * from (</item-param>

    </item>

• Chave que executa o ConcatOperator:

• • Operador de concatenação.

  • Para MySQL:

  • <item>

    <item-name>ConcatOperator</item-name>

    <item-param>||</item-param>

    </item>

____________________________________________________________________________

Caso este tópico não tenha comentário satisfatório, envie e-mail para documentacao@softwell.com.br