{"id":615,"date":"2012-02-17T02:01:06","date_gmt":"2012-02-17T02:01:06","guid":{"rendered":"http:\/\/leonardocotta.com.br\/blog\/?p=615"},"modified":"2012-02-17T02:01:06","modified_gmt":"2012-02-17T02:01:06","slug":"php-padroes-o-padrao-observer","status":"publish","type":"post","link":"https:\/\/leonardocotta.com.br\/?p=615","title":{"rendered":"PHP: Padr\u00f5es O padr\u00e3o Observer"},"content":{"rendered":"

Introdu\u00e7\u00e3o<\/h3>\n

O padr\u00e3o Observer \u00e9 talvez o mais frequentemente encontrados em gr\u00e1fica de usu\u00e1rio tradicional
\naplica\u00e7\u00f5es de interface de desktop.\u00a0\u00c9 uma excelente maneira de garantir que disparate
\ncomponentes do visor refletir as mudan\u00e7as no n\u00facleo de um sistema.\u00a0Como veremos, por\u00e9m,
\ncontinua a ser uma t\u00e9cnica poderosa em um ambiente Web-oriented.<\/p>\n

Neste artigo eu mostrar-lhe como usar o padr\u00e3o Observer para construir uma flex\u00edvel
\ntransmiss\u00e3o estilo de rela\u00e7\u00e3o entre um componente central e os objetos que
\nse preocupam com isso.<\/p>\n

Primeiro, por\u00e9m, em prepara\u00e7\u00e3o para um exemplo de execu\u00e7\u00e3o, eu dou uma olhada no objeto
\nzombando de uma grande t\u00e9cnica para teste de condu\u00e7\u00e3o de c\u00f3digo.<\/p>\n

<\/a><\/p>\n

Exemplo de c\u00f3digo e um b\u00f4nus inesperado<\/h3>\n

Neste artigo, como voc\u00ea poderia esperar, eu cozinhei um exemplo para ilustrar
\nmeus pontos.\u00a0Esta \u00e9 sempre uma tarefa dif\u00edcil.\u00a0O exemplo deve ser cred\u00edvel
\no suficiente para que um leitor poderia imaginar que l\u00e1 fora no mundo real.\u00a0Por outro
\nPor outro lado, \u00e9 preciso muito sacrif\u00edcio que seria essencial no c\u00f3digo implantado no
\nselvagem.\u00a0O primeiro a ir \u00e9 geralmente verifica\u00e7\u00e3o de erros.\u00a0Ningu\u00e9m quer atrav\u00e9s de arado
\nmoitas de try \/ catch cl\u00e1usulas para chegar ao ponto simples enterrado dentro.\u00a0O
\nmesmo \u00e9 verdade para a funcionalidade incidental.\u00a0Em um artigo sobre a maneira que
\nobjetos e classes interagem, o processo de falar com um banco de dados ou de
\nan\u00e1lise de um documento XML \u00e9 muitas vezes irrelevantes.\u00a0Essa funcionalidade pode, muitas vezes
\nser substitu\u00edda por declara\u00e7\u00f5es de impress\u00e3o simples (‘update db’, ‘ler documento XML’).<\/p>\n

Voc\u00ea pode achar um aviso deste tipo, em qualquer uma das centenas de t\u00e9cnico
\nartigos.\u00a0Tutorial c\u00f3digo \u00e9 voltada para compreens\u00e3o e n\u00e3o a implanta\u00e7\u00e3o.
\nNeste caso, por\u00e9m, ela serve para ilustrar um ponto.\u00a0Isto \u00e9: interface
\ndeve outrank aplica\u00e7\u00e3o em programa\u00e7\u00e3o orientada a objeto.\u00a0Na concep\u00e7\u00e3o de
\nseu c\u00f3digo, voc\u00ea pode tentar criar objetos que n\u00e3o fazem nada em tudo, mas imprimir
\nsuas a\u00e7\u00f5es se destinam.\u00a0Concentre-se nas classes em seu sistema e seus
\nrelacionamentos.\u00a0Em seguida, concentrar-se sobre as ac\u00e7\u00f5es que devem ser definidas.\u00a0Tire essa
\ndireito, e c\u00f3digo de implementa\u00e7\u00e3o, muitas vezes, caem no lugar naturalmente.<\/p>\n

Outro benef\u00edcio importante que voc\u00ea pode derivar dessa abordagem est\u00e1 em testes.
\nO teste de unidade em si \u00e9 um assunto para outro artigo.\u00a0No entanto, voc\u00ea deve
\nconsiderar estrat\u00e9gias para c\u00f3digo de constru\u00e7\u00e3o que automatiza testes de classe.\u00a0De todos
\nos problemas que podem aparecer em testar um componente, indiscutivelmente maiores do
\n\u00e9 contexto.\u00a0Um objeto raramente vive em isolamento, e ele pode precisar de trabalhar com
\noutros que falam a bases de dados, o sistema de arquivos ou solicita\u00e7\u00f5es HTTP.\u00a0Como fazer
\nde reproduzir essas condi\u00e7\u00f5es em um teste?\u00a0Uma maneira \u00e9 a de assegurar que uma real
\nRequisi\u00e7\u00e3o HTTP toma lugar, e um banco de dados real \u00e9 na m\u00e3o, abastecido com
\ndados v\u00e1lidos.\u00a0Isto sela aproxima\u00e7\u00e3o voc\u00ea com a sobrecarga de recriar um verdadeiro
\ncontexto mundial para a classe que voc\u00ea est\u00e1 testando, arrastando o seu foco na dire\u00e7\u00e3o errada.<\/p>\n

Se voc\u00ea est\u00e1 de codifica\u00e7\u00e3o para uma interface, no entanto, uma outra op\u00e7\u00e3o se abre.\u00a0Voc\u00ea pode
\ncriar objetos falsificados.\u00a0Se o c\u00f3digo que se comunica com seu banco de dados \u00e9 muito bem
\nencapsulado por tr\u00e1s de uma interface clara, ent\u00e3o n\u00e3o deve haver nada que impe\u00e7a
\nvoc\u00ea de criar uma classe que compartilha a mesma origem como a sua classe de banco de dados,
\nmas serve hard-coded dados para fins de teste.<\/p>\n

O exemplo para este artigo diz respeito uploads de arquivos.\u00a0Uma classe,\u00a0UploadManager<\/code>\u00a0,
\ntrabalha com\u00a0UploadFile<\/code>\u00a0objetos.\u00a0Aqui est\u00e1 o\u00a0UploadFile<\/code>\u00a0abstrato
\nsuperclasse e uma implementa\u00e7\u00e3o simplificada:<\/p>\n\n\n\n

\nabstract\u00a0class\u00a0UploadFile\u00a0{<\/code> <\/p>\n

tamanho\u00a0fun\u00e7\u00e3o abstrata\u00a0();
\nnome da\u00a0fun\u00e7\u00e3o abstrata ();
\nabstrata fun\u00e7\u00e3o\u00a0com erros\u00a0();
\nabstrata fun\u00e7\u00e3o\u00a0moveTo\u00a0($ str);
\n}<\/p>\n

UploadFileException\u00a0classe\u00a0extends\u00a0Exception\u00a0{}<\/p>\n

UploadFileImpl\u00a0classe\u00a0extends\u00a0UploadFile\u00a0{<\/p>\n

private\u00a0$\u00a0formFieldName;
\nprivate\u00a0$ fsPath\u00a0=\u00a0null;<\/p>\n

constru\u00e7\u00e3o\u00a0da fun\u00e7\u00e3o\u00a0__\u00a0($ formFieldName)\u00a0{<\/p>\n

if (! isset\u00a0($ _FILES\u00a0[$ formFieldName]))\u00a0{
\nthrow new\u00a0UploadFileException\u00a0(“formFieldName\u00a0$\u00a0desconhecida”);
\n}
\n$ This\u00a0->\u00a0formFieldName\u00a0=\u00a0$\u00a0formFieldName;
\n}<\/p>\n

tamanho\u00a0function\u00a0() {
\nretornar\u00a0$ _FILES\u00a0[$\u00a0this\u00a0->\u00a0formFieldName]\u00a0[‘size’];
\n}<\/p>\n

nome\u00a0function\u00a0() {
\nretornar\u00a0$ _FILES\u00a0[$\u00a0this\u00a0->\u00a0formFieldName]\u00a0[‘name’];
\n}<\/p>\n

fun\u00e7\u00e3o\u00a0com erros\u00a0() {
\nretornar\u00a0$ _FILES\u00a0[$\u00a0this\u00a0->\u00a0formFieldName]\u00a0[‘error’];
\n}<\/p>\n

caminho\u00a0function\u00a0() {
\nreturn\u00a0$ this\u00a0->\u00a0fsPath;
\n}<\/p>\n

fun\u00e7\u00e3o\u00a0moveTo\u00a0($ perm_loc)\u00a0{<\/p>\n

if (!\u00a0is_null<\/a>\u00a0($\u00a0this\u00a0->\u00a0fsPath))\u00a0{
\nreturn\u00a0null;
\n}<\/p>\n

if (\u00a0is_dir<\/a>\u00a0($ perm_loc))\u00a0{
\n$ Perm_loc\u00a0=\u00a0DIRECTORY_SEPARATOR $ this\u00a0->\u00a0name\u00a0()..;
\n}<\/p>\n

move_uploaded_file<\/a>\u00a0($\u00a0_FILES\u00a0[$\u00a0this\u00a0->\u00a0formFieldName]\u00a0[‘tmp_name’],\u00a0$\u00a0perm_loc);<\/p>\n

if (\u00a0is_file<\/a>\u00a0($ perm_loc))\u00a0{
\n$ This\u00a0->\u00a0fsPath\u00a0=\u00a0realpath<\/a>\u00a0($ perm_loc);
\nreturn\u00a0$ this\u00a0->\u00a0fsPath;
\n}<\/p>\n

return\u00a0null;
\n}
\n}<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

O\u00a0UploadFileImpl<\/code>\u00a0classe \u00e9 um wrapper simples em torno de um elemento de
\no\u00a0$_FILES<\/code>\u00a0matriz que \u00e9 preenchido automaticamente pelo mecanismo de PHP
\nquando um upload HTTP ocorre.\u00a0A classe fornece informa\u00e7\u00f5es sobre o arquivo carregado,
\ne suporta mov\u00ea-lo de seu local de armazenamento tempor\u00e1rio para um mais permanente
\ncasa no sistema de arquivos.<\/p>\n

Esta classe \u00e9 simples e compacta o suficiente para usar nos exemplos, mas sofre de
\numa grande desvantagem quando usado em testes e demonstra\u00e7\u00f5es.\u00a0Ele requer um arquivo de upload
\nter ocorrido.\u00a0O fato de que o\u00a0UploadFileImpl<\/code>\u00a0classe estende
\numa superclasse abstrata fornece-nos uma oportunidade.\u00a0Podemos criar um boneco
\nupload de classe que estende o mesmo pai.\u00a0Qualquer cliente deve ser capaz de usar este
\nalternadamente com a coisa real.\u00a0Aulas fict\u00edcias s\u00e3o conhecidas como\u00a0as simula\u00e7\u00f5es.<\/strong>
\nAqui est\u00e1\u00a0MockUploadFile<\/code>\u00a0:<\/p>\n\n\n\n

\nclass MockUploadFile\u00a0extends\u00a0UploadFile\u00a0{<\/code> <\/p>\n

$ tamanho\u00a0privada\u00a0=\u00a03000;
\nprivate\u00a0$ fspath\u00a0=\u00a0null;
\n$ name\u00a0privado =\u00a0‘mock.gif’;
\nprivate\u00a0$ errorCode\u00a0=\u00a0null;
\n$\u00a0privado\u00a0moveToResult\u00a0=\u00a0true;<\/p>\n

constru\u00e7\u00e3o\u00a0da fun\u00e7\u00e3o\u00a0__\u00a0($ name)\u00a0{
\n$ This\u00a0->\u00a0nome\u00a0=\u00a0$\u00a0nome;
\n}<\/p>\n

setSize\u00a0fun\u00e7\u00e3o\u00a0($ tamanho)\u00a0{
\n$ This\u00a0->\u00a0size\u00a0=\u00a0$\u00a0tamanho;
\n}<\/p>\n

tamanho\u00a0function\u00a0() {
\nreturn\u00a0$ this\u00a0->\u00a0tamanho;
\n}<\/p>\n

setName\u00a0fun\u00e7\u00e3o\u00a0($ name)\u00a0{
\n$ This\u00a0->\u00a0nome\u00a0=\u00a0$\u00a0nome;
\n}<\/p>\n

nome\u00a0function\u00a0() {
\nreturn\u00a0$ this\u00a0->\u00a0nome;
\n}<\/p>\n

setErrorCode\u00a0fun\u00e7\u00e3o\u00a0($ code)\u00a0{
\n$ This\u00a0->\u00a0errorCode code\u00a0=\u00a0$;
\n}<\/p>\n

fun\u00e7\u00e3o\u00a0com erros\u00a0() {
\nreturn\u00a0$ this\u00a0->\u00a0errorCode;
\n}<\/p>\n

caminho\u00a0function\u00a0() {
\nreturn\u00a0$ this\u00a0->\u00a0fsPath;
\n}<\/p>\n

setMoveToFail\u00a0function\u00a0() {
\n$ This\u00a0->\u00a0moveToFail\u00a0=\u00a0true;
\n}<\/p>\n

fun\u00e7\u00e3o\u00a0moveTo\u00a0($ path)\u00a0{<\/p>\n

if\u00a0($ this\u00a0->\u00a0com erros\u00a0() | |!\u00a0is_null<\/a>\u00a0($\u00a0this\u00a0->\u00a0fsPath))\u00a0{
\nreturn\u00a0null;
\n}<\/p>\n

return\u00a0$ this\u00a0->\u00a0fsPath path\u00a0=\u00a0$;
\n}
\n}<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Observe que esta classe de simula\u00e7\u00e3o \u00e9 configur\u00e1vel.\u00a0Podemos definir os valores-chave, que pode at\u00e9 causar
\nopera\u00e7\u00f5es para falhar se queremos.\u00a0Porque eles podem ser configurados para criar condi\u00e7\u00f5es de erro,
\ntais classes pode agir como espi\u00f5es ou provocadores agentes no campo inimigo.\u00a0Podemos enviar
\n-los para causar problemas, ent\u00e3o sentar e ver o caos que se seguiu desdobrar.<\/p>\n

A Figura 1 mostra o\u00a0UploadFile<\/code>\u00a0tipo em conjunto com um cliente insuspeito
\nclasse.\u00a0O cliente \u00e9 passado um\u00a0UploadFile<\/code>\u00a0objeto e continua alegremente
\ndesconhece a implementa\u00e7\u00e3o em particular com o qual trabalha.\u00a0\u00c9 por isso que \u00e9
\ngeralmente uma boa id\u00e9ia para passar objetos em torno de um sistema em vez de t\u00ea-los instanciado
\ndiretamente pelas classes que os utilizam.\u00a0Claro que os objetos devem ser instanciados em algum lugar,
\ne de acordo com alguma l\u00f3gica.\u00a0Vamos olhar para algumas destas estrat\u00e9gias em um artigo posterior.<\/p>\n

\"A<\/p>\n

<\/a><\/p>\n

O padr\u00e3o Observer<\/h3>\n

Descrito pelo Gang of Four (Erich Gamma, Richard Helm, Ralph Johnson, John Vlissides)
\nem seu cat\u00e1logo seminal,\u00a0Design Patterns.<\/em>\u00a0Elementos de Software Orientada a Objetos reutiliz\u00e1veis<\/em>
\n(Addison Wesley, 1995), este padr\u00e3o \u00e9 um exemplo fant\u00e1stico de dissocia\u00e7\u00e3o em a\u00e7\u00e3o.<\/p>\n

Um dos grandes objetivos do programador orientado a objeto \u00e9 criar ortogonal
\ncomponentes.\u00a0Isso significa que a coes\u00e3o elevada (cada componente est\u00e1 ligado a si mesmo e um n\u00facleo
\nprop\u00f3sito) e acoplamento fraco (os componentes s\u00e3o independentes de seu contexto poss\u00edvel).
\nEsta compra nos componentes que podem ser reutilizados facilmente, e talvez mais importante que pode
\nlevar a sistemas que s\u00e3o flex\u00edveis e menos propenso a erros.\u00a0Quando, em contrapartida o maior
\nsistema \u00e9 permitida a enraizar-se em um componente, tamb\u00e9m h\u00e1 uma teia de interdepend\u00eancia.Se
\num componente \u00e9 muito acolhedor, com seu contexto, n\u00e3o pode facilmente ser puxado para longe dele.
\nAl\u00e9m disso, fazer uma mudan\u00e7a em uma parte de um sistema pode levar a n\u00e3o intencional
\nconseq\u00fc\u00eancias em outros lugares.<\/p>\n

Todos n\u00f3s j\u00e1 encontramos sistemas que as declara\u00e7\u00f5es de pimenta SQL em todos os componentes.Tal
\ncodifica\u00e7\u00e3o prom\u00edscuo \u00e9 tentador.\u00a0\u00c9 mais f\u00e1cil de consultar um banco de dados como e quando voc\u00ea precisar
\npara que a elaborar uma estrat\u00e9gia centralizada.\u00a0O sal\u00e1rio do pecado, no entanto, s\u00e3o trabalhar e
\nerro.\u00a0A mudan\u00e7a de esquema simples de banco de dados pode exigir mudan\u00e7as para a direita em todo o sistema,
\ncom o risco inevit\u00e1vel que uma afirma\u00e7\u00e3o obscura ou dois \u00e9 perdido.\u00a0Perdida, isto \u00e9,
\nat\u00e9 a manh\u00e3 de apresentar a sua fant\u00e1stica aplica\u00e7\u00e3o nova para um cliente ou um investidor.<\/p>\n

A dissocia\u00e7\u00e3o, ent\u00e3o, \u00e9 o processo pelo qual voc\u00ea separar componentes de seus contextos,
\neo padr\u00e3o Observer \u00e9 uma estrat\u00e9gia que voc\u00ea deve ter em sua caixa de ferramentas dissocia\u00e7\u00e3o.<\/p>\n

<\/a><\/p>\n

Vis\u00e3o global<\/h4>\n

O padr\u00e3o Observer define um mecanismo atrav\u00e9s do qual os componentes podem optar por receber
\nmensagens quando um objeto alvo (confusamente conhecido como o\u00a0assunto)<\/em>\u00a0altera a sua
\nEstado.\u00a0O sujeito precisa ter nenhum conhecimento de ‘observar’ os componentes-lo para eventos,
\nal\u00e9m do fato de que eles est\u00e3o l\u00e1 e apoiar uma interface para notifica\u00e7\u00e3o.<\/p>\n

<\/a><\/p>\n

O Problema<\/h4>\n

Imagine que voc\u00ea est\u00e1 construindo um site de comunidade de m\u00fasica que permite aos usu\u00e1rios fazer upload de seu trabalho
\npara o compartilhamento e avalia\u00e7\u00e3o.\u00a0Para este efeito, voc\u00ea criou o\u00a0UploadFile<\/code>
\naulas j\u00e1 vimos, e agora precisamos gerenciar o upload.\u00a0H\u00e1 alguns
\nquest\u00f5es leg\u00edtimas que um\u00a0UploadManager<\/code>\u00a0classe deve atender.\u00a0Ele deve:<\/p>\n