Por exemplo, aprendi que você consegue ter uma leve “tipagem” de parâmetros de uma função! Isso já ajuda bastante.

Também aprendi como fazer o autocomplete do Netbeans te ajudar um pouco mais, usando o PHPDoc.

Estrutura

Neste artigo, vamos lidar com a seguinte estrutura de pastas:

Sua pasta root
- Classes (pasta)
—- Pessoa.php
- index.php

A nossa classe será simples, apenas 2 campos (nome, dtnascimento) – cada um com seus getters e setters.

Ficará mais ou menos assim:

<?php

/**
 * Description of Pessoa
 *
 * @author Diego
 *
 */
class Pessoa {

    private $nome;
    private $dtnascimento;

    public function getNome() {
        return $this->nome;
    }

    public function setNome($nome) {
        $this->nome = $nome;
    }

    public function getDtnascimento() {
        return $this->dtnascimento;
    }

    public function setDtnascimento($dtnascimento) {
        $this->dtnascimento = $dtnascimento;
    }

    function __construct($dateTime = null) {

        if($dateTime == null)
            $dateTime = new DateTime();

        $this->setDtnascimento($dateTime);

    }

}

?>

Autocomplete (Intelisense) com netbeans e PHPDoc

Já se pegou tentando usar a orientação a objeto do PHP? Quando você sai de uma linguagem fortemente tipada (Java, C#) e cria um método em PHP, a primeira coisa que você se assusta é em como usá-lo.

Óbvio, estou falando do operador -> que é bem mais xarope de usar do que o . fato do PHP não ter tipagem. Ou seja, se o seu método deveria retornar um objeto da classe DateTime, fica complicado fazer o seguinte:

Sem sugestões. Ou seja, a ferramenta não vai te ajudar. Mas não se desespere (nem xingue)! Com PHPDoc, podemos dar uma melhorada na situação.

Basta ir até a classe e, no getter, adicionar o PHPDoc:

Sim, o PHPDoc é essa porrada de asteriscos e o @return (mas não limitado a isso!). No caso, especificamos que o retorno será a classe DateTime.

Voltemos ao exemplo anterior, tentando autocompletar o getDtnascimento:

Bem melhor, hein? Isso também vale para suas classes. Você pode ter um método que retorne “Porco”, “Linguica” ou qualquer outra classe que exista.

Tipagem dos parâmetros

Outro ‘probleminha’ da falta de tipagem do PHP: Num método que planejamos receber DateTime, podemos acabar com uma string ou int.

Em outras imagens, isso:

Vai gerar isso (se você usar o XDEBUG):

Mas não tema, com PHP sempre tem uma gambiarra não há problema! Nós podemos tipar o que o método/função espera:

Agora, nós temos até o intelisense do netbeans para nos dar a dica que o método espera um DateTime. Ainda é possível inserir um número no método, mas isso vai gerar um erro fatal:

Catchable fatal error: Argument 1 passed to Pessoa::setDtnascimento() must be an instance of DateTime, integer given, called in E:\ServidorPHP\Apache2\htdocs\Aprendizado\OOPArticle\index.php on line 13 and defined in E:\ServidorPHP\Apache2\htdocs\Aprendizado\OOPArticle\Classes\Pessoa.php on line 30

Pelo menos é bem descritivo. Já sabemos que passamos um valor errado, em qual método e o que ele espera realmente.

Getters and Setters

Última díca rápida! O Netbeans pode gerar automaticamente para você os getters and setters da classe. O problema é que ele fica um pouco escondido.

Basta ir até o arquivo da classe e apertar ALT + Insert. Surgirá um menu de contexto com as opções:

Tchans! Basta escolher os campos que você deseja gerar e pronto:

Achei interessante citar, pois esse menu fica meio escondido no netbeans com PHP ;).

Referências e fonte de estudo:

• NetTuts+
• edmondscommerce
• www.google.com.br  (=P)

Passando a régua e fechando a conta

São algumas dícas que eu encontrei pra me ajudar com o PHP! Espero que sejam úteis para você também.

Até a próxima!

Dessa vez eu precisei de uma função que me listasse todos os arquivos e diretórios de um determinado caminho.

De cara eu encontrei o scandir. Só que ele listaria apenas a primeira “camada” de arquivos.

Quero mais!

Queria uma função que me permitisse ver todos os arquivos e pastas presentes num diretório, entrando em cada pasta existente desde a raiz. Por ex:

• Pasta BLA

• Arquivo.php
• imagem.jpg
• Nova Pasta

• readme.txt
• formatacao.css

• OutroGato.txt

Usar o scandir só me listou os nomes das pastas e não os arquivos dentro dela.

Então faça!

O algoritmo é simples:

• Pegar todos os arquivos de um caminho
• Jogar para um array
• Verificar se algum dos itens do array é uma pasta

• Se for, criar um array para a nova pasta
• Chamar a função recursivamente para preencher o array com os arquivos e pastas

Quando chamamos o scandir, seguindo a estrutura apresentada de pastas apresentadas antes, teremos um array com os seguintes dados:

[0]Arquivo.php (string)
[1]imagem.jpg (string)
[2]Nova Pasta (string)
[3]Outra Pasta (string)

Como “Nova Pasta” e “Outra Pasta” são pastas (DUH), elas podem conter N itens dentro delas, por isso transformamos o item num array.

Chamamos a função recursivamente pois já temos o comportamento da função pronto (pegue os arquivos e retorne), só não sabemos quantas pastas encontraremos no caminho.

Se ela não for chamada recursivamente, apenas encontraremos um nível de pastas abaixo da inicial.

Hora do código!

Aqui vai…

            function GetDirectoriesAndFiles($dirPath)
            {
                //pega todos os arquivos e pastas do diretório
                $files = scandir($dirPath);

                //vamos olhar em um por um
                foreach ($files as $key => $file)
                {

                    //se for a pasta ou diretório corrente,
                    //remova e pule pra próxima
                    if ($file == '..' || $file == '.')
                    {
                        unset($files[$key]);
                        continue;
                    }

                    //diretório + arquivo atual
                    $currentDirPath = $dirPath."\\".$file;

                    //vendo se é um diretorio
                    //se for, precisamos pegar os arquivos e pastas dele tbem
                    if(is_dir($currentDirPath))
                    {
                        //lembrando do nome atual
                        $dirName = $file;
                        //transforma em array (primeiro item é o nome do dir)
                        $file = array($dirName);
                        //pegando todos os arquivos e pastas nele... (recursivo)
                        $file[] = GetDirectoriesAndFiles($currentDirPath);

                        //destrói o item original do array
                        unset ($files[$key]);
                        //coloca o novo array no lugar,
                        //com os arquivos e pastas encontrados
                        $files[$key] = $file;
                    }

                }

                return $files;
            }

Para testar você pode colocar essa função num arquivo que tenha pastas no mesmo nível e rodar. Ex:

            echo "<pre>";
            echo print_r(GetDirectoriesAndFiles(__DIR__));
            echo "</pre>";

É isso! Agora você decide o que fazer com o conteúdo do array. Qualquer coisa, basta mandar um comentário.

Passa a régua e fecha a conta!

Até mais.

Tinha esquecido como era gostoso mexer com o photoshop e jedificar uma situação!

Sabre de luz verde = keep distance for your safety

]]> http://diegodonah.wordpress.com/2011/07/18/jedi-me-2011/feed/ 1 -22.724977 -47.647601 -22.724977 -47.647601 Doná Doná Jedi 2011 http://diegodonah.wordpress.com/2011/07/08/comunicacao-e-interacao-entre-janelas-com-javascript/ http://diegodonah.wordpress.com/2011/07/08/comunicacao-e-interacao-entre-janelas-com-javascript/#comments Fri, 08 Jul 2011 21:38:26 +0000 diegodonah http://diegodonah.wordpress.com/?p=746 ]]> Fala galera!

Sumi por uns tempos devido a provas na faculdade e um super projeto que demos o sangue pra terminar no prazo.

Some isso a mais algumas aulinhas de CFC (9, cada uma de 5 horas) e desconte o que sobrar do meu banco de horas como blogueiro. =D

Na execução do projeto, precisávamos fazer com que duas janelas de HTML comunicassem uma com a outra. Depois de pensar um pouco, arranjei uma solução.

O objeto Window

Acho que é a primeira coisa que usamos no javascript, mesmo sem saber. Ou vai dizer que você nunca mandou um alert(‘Oi Mundo’); ?

Consulte também: Referência sobre a Window

O importante para nós é que tudo que todo o javascript publico / global de uma página, pode ser acessado através da referência da janela.

Por exemplo:

<html>
	<script type="text/javascript">

		var a = 12;

		alert(this.a);

	</script>

	<body>
		Asd!
	</body>

</html>

Bem bobo (e simplificado), mas isso te dá muito poder. Você pode tratar cada janela como um objeto e acessar o que precisar!

Consulte também: Global Variables in JavaScript (em inglês)

Mantendo a referência de uma janela

Vamos dizer que, ao clicar num determinado botão da página “A”, o seu usuário terá uma nova janela filha (“B”) aberta.

E se você precisar executar, através da “A”, uma atualização na “B”? Sabendo que podemos simplesmente acessar o que está no “objeto”, fica fácil! É só acessar o objeto B e invocar a função.

Toda vez que abrimos uma janela (window.open, certo?) temos um retorno: a referência da janela. Vejamos:

Página A (teste1.html):

<html>
	<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js"></script>
	<script type="text/javascript">

		//para guardar a referência da janela
		var B;

		function VisualizarHora()
		{
			//se for NULL ou foi fechada, criamos a dita cuja
			if(B == null || B.closed)
			{
				B = window.open("teste2.html");
			}

			//como vamos acessar os elementos de um objeto janela,
			//precisamos garantir que o objeto já está pronto para ser usado
			//por isso usamos o LOAD
			$(B).load(function(){

				//chama a função novamente, quando a janela B tiver sido carregada completamente
				VisualizarHora();
				return;

			})

			//se chegou até aqui, podemos chamar a função com seguraça
			//(a janela já está carregada e temos a referência)
			B.InserirHora();

		}

	</script>

	<body>

		<a href="javascript:VisualizarHora();"> Visualizar hora</a>

	</body>

</html>

E o código da página B:

Página B (teste2.html):

<html>
	<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js"></script>
	<script type="text/javascript">

		function InserirHora()
		{
			var date = new Date();
			$("#area").append(date.getTime() + "<br />");
		}

	</script>

	<body>

		<div id="area"></div>

	</body>

</html>

Precisei usar algo de JQuery, em especial o load, para evitar que tentássemos acessar a janela enquanto ela ainda não estivesse carregada.

E com Iframes?

Parece mais fácil, mas é um pouco xarope. Tem algumas pegadinhas que são mortais pro código funcionar ou não:

Página C (teste3.html):

<!-- http://forum.jquery.com/topic/calling-function-inside-an-iframe -->
<html>
<head>
    <title>Janela C</title>
    <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js"></script>

    <script type="text/javascript">

        $(document).ready(function () {

            $("#btnOk").click(function () {

                //pega o frame
                var mf = $("#meuFrame");
                //buscando no conteúdo do frame
                $(mf).contents().find("div").css("background-color", "#FF0000");

                //recuperando o Document do frame
                var mfDoc = $(mf)[0].contentWindow.document;
                //chamando método
                mfDoc.Falar();

            });

        });

    </script>

</head>
<body>
    <iframe id='meuFrame' src="teste4.html" width="100%" height="300"></iframe>

    <input type="button" id="btnOk" value="OK" />
</body>
</html>

Página D (teste4.html):

<html>

<head>
<title>Janela D</title>
<script type="text/javascript">

    function Falar() {
        alert('Falei...')
    }

    document.Falar = Falar;

</script>
</head>

<body>
<div id="teste">Testando! </div>
</body>
</html>

A variável “mf” contêm o iframe em si. O método “.contents()” nos permite acessar todo o conteúdo. Fazendo uma busca (.find()) e inserimos um estilo de forma dinâmica.

Para executar a função, nós pegamos o document da página (variável mfDoc). Importante notar que nos, explicitamente, associados a função ao document na página D, se não a função não ficará acessível.

Notas finais e fechando a conta

É um artigo bem rápido com algumas dícas que eu acho importantes. Tudo aqui foi demonstrado de uma maneira bem simples, mas você pode utilizar isso em camadas mais complexas.

Atenção!

Os testes foram feitos no FireFox 3.6.18, IE8 e Chrome 12.0.742.112. Acredito que funcione bem nos navegadores modernos – acredito que vá falhar catastróficamente num IE6 da vida :D.

Os códigos não tiveram um comportamento legal no Chrome, quando eu utilizei as páginas diretamente no sistema de arquivos, sem colocar no meu webserver local. Parece que ele é um tanto paranóico. Quando rodei no servidor local do Visual Studio, tudo funcionou.

Foi essa a jogada que tivemos para o projeto. Espero que seja útil para você também! Qualquer erro, correção, é só mandar um comentário.

Até mais!

Seguindo a estrutura de trabalho do post anterior, vamos brincar um pouco com lançamento e tratamento de erros.

Lançando mensagens e exceções

Usando .NET, nós podemos usar o comando “Throw” para lançar exceções conforme achamos necessário.

O Sql também pode fazer isso, usando o comando RAISERROR.

RAISERROR é usado para devolver mensagens a aplicativos usando o mesmo formato que um erro do sistema ou mensagem de aviso gerada pelo Mecanismo de banco de dados do SQL Server.

Seus parâmetros básicos são:

1. Id da mensagem (caso uma mensagem já esteja registrada no banco)
2. Mensagem do erro (caso não seja registrada no banco)
3. Severidade do erro
4. Estado

Se você informar o Id de mensagem, não precisa passar a mensagem e vice versa.

A severidade do erro indicará quando cairemos num bloco de exceção ou se apenas mostraremos a mensagem. Se for menor ou igual a 10, apenas exibiremos a mensagem. Se for maior que 10, indicamos que o erro é grave e geramos exceção.

Vamos forçar alguns erros e ver o que acontece, na prática:

CREATE PROCEDURE usp_GenerateError
AS BEGIN

	DECLARE @i int
	SET @i = 9

	DECLARE @Msg VARCHAR(40)

	WHILE @i < 14
	BEGIN

		IF @i < 11
		BEGIN
			set @Msg = 'Erro...'
		END
		ELSE
		BEGIN
			set @Msg = 'Erro grave! Fujam pras montanhas!'
		END

		print @i

		RAISERROR(@Msg,@i,1)
		set @i = @i + 1

	END

END

Executando essa SP:

Mensagem em vermelho raramente é coisa boa pra quem programa. Inclusive, se não tratarmos essa exceção no SQL, ela cairá para a aplicação, no try/catch da linguagem que você utilizar, ou pior, diretamente na aplicação:

Tratando exceções no SQL

Nós também temos TRY/CATCH no SQL Server, a partir da versão 2005. Vejamos o que a documentação diz sobre a sintaxe:

BEGIN TRY
     { sql_statement | statement_block }
END TRY
BEGIN CATCH
     [ { sql_statement | statement_block } ]
END CATCH
[ ; ]

Bem simples né? Usando no nosso exemplo anterior:

ALTER PROCEDURE [dbo].[usp_GenerateError]
AS BEGIN

	DECLARE @i int
	SET @i = 9

	DECLARE @Msg VARCHAR(40)

	BEGIN TRY

		WHILE @i < 14
		BEGIN

			IF @i < 11
			BEGIN
				set @Msg = 'Erro...'
			END
			ELSE
			BEGIN
				set @Msg = 'Erro grave! Fujam pras montanhas!'
			END

			print @i

			RAISERROR(@Msg,@i,1)
			set @i = @i + 1

		END
	END TRY
	BEGIN CATCH

		print ''
		print 'Erro ocorreu!'
		print 'Mensagem: ' + ERROR_MESSAGE()
		print 'Procedure: ' + ERROR_PROCEDURE()

	END CATCH

END

A nossa nova saída será essa:

Muito melhor sem as mensagens em vermelho! Perceba que o try/catch só agiu quando a variável tinha o valor 11. Os erros anteriores foram meramente expostos no console.

Agora que nós já sabemos algumas coisas sobre exceções em procedures, vamos adiante, num exemplo um pouco mais prático.

Juntando as peças

Já perdi muitos fios de cabelo com procedures que não eram executadas corretamente, tudo por falta de dados.

Dependendo do seu Design Pattern (padrão de projeto), poderíamos colocar uma verificação dentro dela, lançando exceção caso algum parâmetro esteja invalidado.

No nosso banco de dados, imagine que eu quero consultar todos os presentes de uma dada categoria. É só enviar o id da categoria e colocar no where.

Eu posso querer um erro se eu enviar um id de categoria inexistente para a pesquisa. Usando nossos conhecimentos de sql, stored procedure e exceções:

CREATE PROCEDURE usp_EncontrarPresentesDeUmaCategoria
	@cat_id INT
AS BEGIN

	--para verificar se o Id existe mesmo
	DECLARE @isIdExistente INT
	SET @isIdExistente = (select COUNT(C.cat_id) FROM Categorias c where c.cat_id = @cat_id)

	IF(@isIdExistente = 0)
	BEGIN
		--lançando a exceção
		RAISERROR('Id de categoria não existente!',11,1)
	END

	SELECT
				p.pres_id,
				p.pres_nome,
				p.pres_desc
	FROM		Presentes p
	WHERE		p.pres_cat_id = @cat_id

END

Exemplo bobo, mas com técnicas que podem ser úteis a nós.

Concluindo

Tratar erros numa stored procedure é tão simples como no asp.net. Às vezes pode ser mais prático “enterrar” o erro por lá, do que trazer algo inútil para a nossa aplicação.

Mais informações:

• Documentação da MSDN sobre RAISERROR (PT-BR)
• Documentação da MSDN sobre RAISERROR  (em inglês)
• Stack Overflow.
• Documentação sobre TRY/CATCH (em inglês)

Até a próxima!