Para o exemplo estou disponibilizando para download aqui o script para criação e população de um banco de dados teste (Schema testes_roberson), nos outros posts relacionados a banco de dados também irei utilizar essa base, conforme eu for modificando a base vou atualizando o script de criação e publicando uma notificação de atualização aqui mesmo no blog.

A validação que vou mostrar é bem simples, mas pode dar uma idéia de como criar validações mais completas (pretendo ir colocando aos poucos outras validações mais complexas). Neste exemplo vou mostrar como criar uma Trigger para validar E-mail.

Primeiro faça o download do arquivo .zip onde você encontrará o arquivo testes_roberson.sql e o arquivo leiame.txt(algumas refências sobre o arquivo). Execute o arquivo sql em seu SGBD(Sistema Gerenciador de Banco de Dados), eu uso o MySQL Workbench Tools onde é possível administrar, interagir e modelar bases MySQL, mas pode utilizar qualquer SGBD de sua preferência.

Com o banco, tabelas e dados já criados agora vamos para a análise de possíveis validações que podemos fazer.

Fig. 01 - Modelagem Data Base testes_roberson (schema)

Olhando as tabelas podemos concluir que:

1. Trata-se de um banco simples (para estudos) de um cadastro de clientes.
2. Podemos criar uma rotina para validar CPF, E-mail e talvez ainda o CEP (validar se veio somente numeros e se são 8 caracteres)
3. Podemos criar tabelas de Cidades e Estados para evitar duplicidade de dados.

Nosso objetivo neste post é criar uma trigger para validar e permitir somente e-mails válidos. Segue a baixo código para criação da trigger.

-- Trigger DDL Statements
DELIMITER $$

-- Selecionamos o database desejado e criamos a trigger
-- Usando o BEFORE validamos o dado antes de inserir na tabela e AFTER depois de inserir na tabela
-- INSERT significa que a trigger será disparada quando ocorrer um INSERT na tabela, pode ser usado também o UPDATE e DELETE
USE `testes_roberson`$$CREATE DEFINER=`root`@`localhost` TRIGGER trgValidacaoEmail BEFORE INSERT ON clientes
  FOR EACH ROW BEGIN
    -- Verificamos se o NEW.Email (e-mail que está vindo no INSERT) é válido segundo a expressão regular usado com a função REGEXP
    IF (NOT EXISTS (SELECT NULL FROM Clientes WHERE  NEW.Email REGEXP '^[a-zA-Z0-9]{1}([\._a-zA-Z0-9-]+)(\.[_a-zA-Z0-9-]+)*@[a-z0-9-]+(\.[a-z0-9-]+){1,3}$')) THEN
        -- caso entre no IF disparamos um SELECT com nome de tabela inválido descrevendo o erro que será retornado.
        SELECT 0 FROM `Erro ao inserir dados! E-mail Inválido!` INTO @error;
    -- Fechamos o IF
    END IF;
  -- Fechamos a criação da trigger
  END$$

Com isso a validação já deve estar funcionar. É possível prever uma pequena “gambiarra” (prefiro chamar de ajuste técnico) somente olhando esse script. Quando tentarmos inserir um e-mail inválido ele irá nos retornar o seguinte erro:

Error Code: 1146
Table 'testes_roberson.Erro ao inserir dados! E-mail Inválido!' doesn't exist

Este erro está nos dizendo que a tabela ‘Erro ao inserir dados! E-mail Inválido!’ não existe nessa base de dados. Isso acontece devido ao fato de o nosso querido MySQL não ter nada expecífico para tratamento de erros ou de exceção (Exception). Isso realmente é muito triste, mas pelo menos estamos notificando ao usuário/programador que o dado não foi inserido e que o erro está no e-mail. Se tivermos a possibilidade de conversar com o programador ou programar uma rotina de tratamento de erros na própria linguagem que estiver sendo usada, esse mesmo erro pode ser exibido para o usuário. Para isso basta resgatar esse erro e passar ele por uma função que retire o inicio do erro “Error Code: 1146 – Table ‘testes_roberson.Erro ao inserir dados!” e o final do erro “‘ doesn’t exist”, com isso ficaremos somente com o erro que queremos

Reconheço que o erro retornado não é a melhor coisa do mundo, mas com algumas poucas linhas podemos deixar ele mais limpos, a baixo coloco um script PHP de como poderiamos tratar esse erro e mostrar para o cliente.

//trigger_email.php
// Função para tratamento dos erros
function tratarErrosMysql($numError, $error){
	//identificamos que o erro é no nome da tabela error 1146
	if($numError == '1146'){
		//executamos a decodificação de utf8 para que o erro não apresente problemas com os acentos.
		$error = utf8_decode($error);
		//retiramos o inicio e o fim do erro.
		$error = substr($error, 23 , -15);
		//retornamos o erro que veio do banco
		return $error;
	}else{
		//caso o erro não seja no nome da tabela(retorno de nossa trigger) retornamos o erro do mysql intacto
		return $error;
	}
}
// criamos a conexão com o banco de dados no nosso caso, MySql
$conn = mysqli_connect("localhost", "root", "","testes_roberson");  

//executamos nosso comando sql
$sql = "INSERT INTO Clientes SET Cpf = '05332754906', Nome='Teste', Sobrenome='Teste', Email='isso não é um email válido',sexo='M';"; // query (comando sql)
$result = mysqli_query($conn, $sql);
//verificamos se ouve algum erro
if(mysqli_error($conn)){
	// apresentamos o erro para o cliente;
	echo tratarErrosMysql(mysqli_errno($conn),mysqli_error($conn));
}

Assim teremos o erro tratado, assim teremos uma base de dados bem mais consistente e livre de falhas de verificação na aplicação e erros dos usuários. E não esqueçam de criar uma trigger que valide o dado quando houver uma atualização BEFORE UPDATE.

Em próximos posts pretendo mostrar a validação de CPF usando trigger e stored procedure.

Posts relacionados:

1. Validando dados inseridos no banco MySql – Parte 02
2. Convertendo campos em url amigável pelo Mysql

Vamos supor uma estrutura de banco de dados assim:

--Criamos a base de dados (schema)
CREATE DATABASE IF NOT EXISTS mysql_xml;

--Selecionamos a base para usar
USE mysql_xml;

--Criamos a tabela, nesse exemplo para guardar dados de usuários
CREATE TABLE 'mysql_xml'.'usuarios' (
        'idUsuario' INTEGER UNSIGNED NOT NULL AUTO_INCREMENT,
        'login' VARCHAR(45) NOT NULL,
        'senha' VARCHAR(45) NOT NULL,
        PRIMARY KEY ('idUsuario')
)ENGINE = InnoDB;

--Inserimos alguns dados na tabela
INSERT INTO usuarios VALUES ('', 'usuario1','senha1');
INSERT INTO usuarios VALUES ('', 'usuario2','senha2');
INSERT INTO usuarios VALUES ('', 'usuario3','senha3');
INSERT INTO usuarios VALUES ('', 'usuario4','senha4');
INSERT INTO usuarios VALUES ('', 'usuario5','senha5');

Com o banco/tabela populado podemos ir para o nosso script PHP.
Abaixo vou demonstrar como o php pode pegar esses dados e utilizando a lib SimpleXML do php, podemos transformar os dados em um arquivo xml.

//mysql_xml.php
// criamos a conexao com o banco de dados no nosso caso, MySql
$conn = mysqli_connect("localhost", "root", "","mysql_xml");

//exacutamos nosso comando sql
$sql = "select * from usuarios"; // query (comando sql)
$result = mysqli_query($conn, $sql);

// criamos um objeto do tipo SimpleXMLElement
$xml = new SimpleXMLElement("<resultset/>");

// criamos um loop para recuperar todos os dados da tabela usuarios
// os dados sao retornados como um objeto
while ($dados = mysqli_fetch_object($result))
{
        // criamos um um novo node para abrigar as linhas
        $line = $xml->addChild("line");

        //No proximo loop adicionamos os nodes para cada um dos registros de cada linha
        foreach ( $dados as $colName => $value )
                $line->addChild($colName, $value);
}

// finalmente criamos o xml com todos os dados que estavam na tabela.
echo $xml->asXML();

Executando o arquivo acima temos o seguinte resultado.

		1
		usuario1
		senha1
	

		2
		usuario2
		senha2
	

		3
		usuario3
		senha3
	

		4
		usuario4
		senha4
	

		5
		usuario5
		senha5
	

E é isso galera, simples assim, esses scripts foram baseados em um tutorial que li há algum tempo atrás, desde então venho utilizando essa maneira de gerar xml para exportação, integração, etc, em meus sistemas. Infelizmente não lembro e não encontrei a referência para o artigo que li, caso alguem ache ele, por favor me informe que atualizo aqui.

Posts relacionados:

1. Validando dados inseridos no banco MySql – Parte 01