Detalhes

Categoria: Joomla

Atualização: Segunda, 02 Julho 2012 19:32

Autor: vovó Vicki

Acessos: 15279

Se você conseguiu sobreviver ao tsunami que foi até agora a criação do componente MVC, então este último tutorial da série não será problema. Aprenda a lidar com a tabela do componente para poder salvar, deletar e atualizar mensagens porque é só isto que está faltando.

Salvar um registro

Normalmente precisamos de alguns switches e da lógica para manipular várias situações como, por exemplo, optar entre uma query de inserção (INSERT) quando o registro for novo e uma query de atualização (UPDATE) quando o registro tiver sido editado. Também existem alguns complicadores na hora de obter dados dos formulários para incluí-los em queries.

Para nossa sorte, o framework do Joomla faz a maior parte do serviço. A classe JTable facilita nossa vida e nos possibilita lidar com tabelas sem ter que se preocupar com o SQL envolvido nas operações. Além disto, também facilita muito a transferência de dados de um formulário HTML para a base de dados.

Criando a classe Tabela

A classe JTable é uma classe abstrata da qual podemos derivar classes filhas para trabalhar com tabelas específicas. Para usá-la, basta criar uma classe que estenda a classe JTable, adicionar os campos da tabela como propriedades e sobrepor o construtor para especificar o nome da tabela e sua chave primária.

Nesta classe tabela definimos três campos: id, mensagem e published. Depois definimos um construtor que chama o construtor da classe mãe passando o nome da tabela (ola), o nome do campo que é a chave primária (id) e o objeto conector da base de dados.

Crie um novo diretório /administrator/components/com_ola/tables e coloque neste diretório o script ola.php mostrado acima.

Atualizando o modelo

O modelo, que funciona como um distribuidor de ferramentas de trabalho, precisa ser atualizado para fornecer uma função que possibilite salvar registros. Vamos chamar nosso método de salvar( ). Este método fará três coisas: associar os dados do formulário com o objeto TableOla, checar se o registro foi formado corretamente e armazenar os dados do registro na base de dados.

Adicionar:

A primeira linha obtém uma referência ao objeto tabela. Se usarmos a convenção de nomes não é preciso indicar o nome do objeto tabela - a classe JModel sabe como encontrá-lo. Chamamos nossa classe de TableOla (o modelo sabe que se trata de uma tabela) e a colocamos num arquivo chamado ola.php (se a classe é TableOla o arquivo deve se chamar ola.php) no diretório tables (o diretório das classes de tabela).

A segunda linha obtém os dados do formulário. O JRequest possibilita obter todas as variáveis que foram submetidas através do método 'POST'. Elas chegam até nós na forma de um array associativo.

O restante do código é fácil: ligamos, checamos e armazenamos. O método bind( ) copia os valores do array para as propriedades correspondentes do objeto tabela. Neste caso, ele pega os valores de id, mensagem e published e os copia para o nosso objeto TableOla.

O método check( ) verifica os dados. Na classe JTable, este método apenas retorna true. No atual estágio, este método não está servindo para nada, mas é bom deixá-lo aí. Caso seja preciso fazer alguma verificação futuramente, este método torna possível fazer uma checagem de dados na nossa classe TableOla sobrepondo-o com um método personalizado.

O método store( ) pega os dados do objeto tabela e os armazena na base de dados. Se id for igual a 0 (zero), ele cria um novo registro (INSERT), caso contrário ele atualiza o registro indicado (UPDATE).

Adicionando a tarefa ao controlador

Já temos nosso objeto tabela e o modelo sabe da sua existência. Agora só falta o "jogador de meio de campo" dar as coordenadas. Vamos adicionar o método save( ) ao nosso controlador /controllers/ola.php:

Adicionar:

O que fizemos foi pegar nosso modelo e disparar seu método salvar( ). Depois redirecionamos para obter a tela com a lista de mensagens com um aviso que deve ser mostrado no topo da página.

Fig. 1 - Sucesso ao salvar

Deletar registros

Para implementar esta funcionalidade vamos ter que mexer adivinhe onde? No modelo, para dispormos de um método que faça isto, e no controlador ola para que ele possa controlar esta tarefa. Não vou repetir o código completo do modelo e do controlador - vou apenas mostrar as funções que devem ser adicionadas.

Atualizando o modelo

No modelo /models/ola.php vamos pegar as id dos registros que devem ser deletados e depois passá-los para a classe TableOla para que faça o serviço:

Chamamos o método JRequest::getVar( ) para obter os dados da requisição. Depois chamamos o método $row->delete( ) para deletar a(s) linha(s). Guardando os erros no modelo torna possível recuperá-los mais tarde se assim o quisermos.

A tarefa deletar no controlador

Esta tarefa é parecida com a salvar:

Cancelar operações

Só falta mais um detalhe: dizer ao controlador o que deve ser feito caso uma operação de edição ou de adição de novo registro seja cancelada. Adicione este método ao controlador ola:

Hora do abraço

Despois desta maratona, nosso componente com_ola finalmente ficou pronto.

É a hora de partir pro abraço

E aqui está o componente Olá Pessoal versão 1.6, prontinho para ser instalado.

Índice da série de tutoriais Componente 1.5 MVC

1. Componente 1.5 - Padrão MVC
2. Componente 1.5 MVC - Frontend
3. Componente 1.5 MVC - Frontend II
4. Componente 1.5 MVC - A tabela
5. Componente 1.5 MVC - Interface Admin
6. Componente 1.5 MVC - Funcionalidade admin
7. Componente 1.5 MVC - Funcionalidade admin II

Referência

http://dev.joomla.org/component/option,com_jd-wiki/Itemid,/id,components:hello_world_mvc4/">Hello World MVC 2 Component - Admin interface