iMasters

Olá, pessoal! Se você está iniciando com o Hibernate, um dia vai ser apresentado ao Criteria. Realmente, quem usa o Criteria não quer voltar ao SQL para as funções mais básicas e só o faz nos casos extremos, nos quais o Criteria não atende. Então, neste artigo vou mostrar um pouco o que se pode fazer com o Criteria nas suas aplicações Java. Farei uma breve introdução neste primeiro artigo e no próximo vamos colocar mão na massa. Mas, por enquanto, quero que conheçam um pouco a sintaxe.

Criteria

O Criteria Query API permite construir query expression em Java, possibilitando, assim, a checagem em tempo de compilação - ao contrário do HQL ou SQL. O Criteria API permite, de forma programática, construir objetos query a partir da interface org.hibernate.Criteria, que define os métodos disponíveis que precisamos para trabalhar com o Criteria.

Para persistir um objeto da classe, usamos o método createCriteria(), que retorna um objeto Criteria, que permite ter acesso a instância de persistência da classe. O createCriteria() pertence à interface Session. Então, se for preciso retornar todas propriedades de uma classe com Criteria, seria assim:

 Criteria critera = session.createCriteria(Produto.class)
 List lista = criteria.list();

Bem mais simples do que o HQL. Este é o mesmo resultado com o from Produtos, que executamos no HQL e que fazemos no SQL: SELECT * from mytable.

Vamos dizer que precisamos obter os produtos que tenham no nome “smartphone”, então, precisamos conhecer o método add() da classe Criteria, que tem como objetivo adicionar uma restrição em seu argumento. Uma outra classe importante é Restrictions class, do pacote org.hibernate.Criterion, que possui métodos static para as condições de restrições que precisamos. Veja o trecho do código:

 Criteria crit = sesion.createCriteria(Produto.class)
 crti.add(Resctrictions.eq(“nome”, “smart phone”);
 List list = crit.list();

Explicando o código:

Na primeira linha, nós criamos o objeto Criteria que fez a persistência em nossa entidade. Na linha 02, costumo ler da seguinte forma para facilitar a compreensão: “adicionando uma restrição a class persistida”. Na linha 03 é o resultado da restrição.

Um ponto importante é que não podemos fazer uma restrição de resultado usando o método eq/ne para propriedades com o valor null. Para isso, há métodos static especificos: o isNull() e o isNotNull().

Para realizar busca, temos os métodos like() e ilike(). Eles servem para quando precisamos buscar algo fornecendo apenas algumas informações para o buscador. Exemplo: traga todos os produtos que tem a palavra “smart”. A diferença é que o ilike é case-insensitive.

Outro detalhe importante que podemos informar é onde buscaremos a palavra: no inicio, no final - para ser exato -, ou em qualquer lugar. Exemplo:

 Criteria crit = session.createCriteria(Produto.class)
 crit.add(Restrictions.like(“nome”, “smart%”));
 List list = crit.list();

O símbolo % informa que a busca é por partes da string. No exemplo a seguir, eu seleciono para buscar no final dela.

Crit.add(Restrictions.like(“nome”, “smart”, MatchMode.end));

O MatchMode é um tipo de enumeration que possui quatro tipos diferentes de match: anywhere, end, exact, start.

E assim finalizo o primeiro artigo sobre Criteria. No próximo veremos mais algumas restrições interessantes.

 Espero que tenham gostado do artigo!

Tem-se falado muito de bancos NoSQL e também do MongoDB, mas por que você deveria usá-lo? Hoje vou te dar três razões para que você passe a usar o MongoDB.

01. Consultas simples

MongoDB é um banco NoSQL baseado em documento sem transações e sem joins. Quando um aplicativo utiliza esse tipo de banco de dados, o resultado que se tem são consultas muito simples. Elas são mais fáceis de escrever. Elas são mais fácil de ajustar. Deixam os desenvolvedores fazerem seu trabalho mais facilmente. Em um exemplo onde 'usuarios' possuem 'eventos', existe uma tabela para cada um, com um usuario_id na tabela de eventos. Vamos dizer que eu quero todos os usuários que publicaram um evento.

Em um banco de dados SQL, tenho duas tabelas: usuários e eventos. Eu poderia escrever esta consulta da seguinte forma:

SELECT * from `usuarios` INNER JOIN `eventos` ON `eventos`.`usuario_id` = `usuarios`

Analogamente, em um banco de dados MongoDB, digamos que eu tenha apenas uma coleção: usuários. Cada documento de usuário tem um atributo chamado "eventos", que é uma lista de documentos incorporados. Parece algo como isto em JSON:

{

nome : Jean carlo Nascimento,

email: jnascimento@gmail.com,

eventos : [ 

{titulo : Primeiro!},

{titulo : Legal!},

{titulo : Festao, publicado : true}

]}

Para executar a mesma consulta em MongoDB, fica:

db.usuarios.find (('eventos.publicado': ($ ne: null)))

Mais simples. Mais simples de ler, de escrever. E você pode ver claramente como ele faz as coisas mais fáceis de entender.

02. Sharding

Sharding é um conceito simples: se você tem um monte de dados e está no limite de disco e/ou a falta de espaço, a resposta é ter os seus dados divididos entre várias máquinas. Você fica com mais rendimento e com maior capacidade de armazenamento em disco. Em um mundo perfeito, como seu armazenamento e desempenho precisa crescer, basta acrescentar mais shards.

MongoDB é muito próximo a este mundo perfeito. Se você tem um processo mongod execução, e quer usar sharding, você:

1. Abre uma nova máquina.
2. Inicia um processo novo mongod para atuar como um membro do cluster shard.
3. Inicia um processo novo mongod para atuar como um banco com configuração separada, para manter informações sobre quais bancos possuem shard.
4. Inicia um processo mongo e informa como encontrar o db atual, o novo membro do shard, o banco de dados de configuração.
5. Digita ~ 5 para permitir sharding em qualquer banco de dados e coleções que você quiser.
6. Modifica seus aplicativos para se conectarem ao processo mongo ao invés do antigo processo mongod.
7. Pronto.

Para saber mais como configurar o sharding, leia http://www.mongodb.org/display/DOCS/Configuring+Sharding

Toda a comunicação é feita sobre IP. Para configurar os processos mongod e mongo, podem ser executados em suas próprias máquinas ou correr na mesma máquina como um de seus shards. Isso pode ser feito com qualquer tempo de inatividade. E você não precisa ter um olho para o sharding quando começar, você pode tomar um antigo processo regular mongod e vai "simplesmente funcionar".

Existem soluções para esse problema no MySQL, mas eles exigem manipulação de dados em uma camada acima da base de dados. O próprio banco não oferece suporte a esse recurso. Além disso, você não precisa pensar sharding até que você precise dele, você não tem que pré-otimizar.

Agora pense em vídeo HD, geolocalização, mensagens em tempo real, realidade aumentada, imagens em tempo próximo ao real por satélite. Pense em todos esses dados, e na velocidade que as pessoas vão querer isso (e mashups e derivados disso). Então, pense sobre qual banco de dados que você deseja começar a usar agora.

3. GridFS

Digamos que você tenha uma aplicação onde o usuário pode fazer upload de uma foto de perfil. A prática corrente é a de armazenar o caminho para o arquivo no banco de dados, armazenar o arquivo no filesystem (sistema de arquivos compartilhado se você tiver vários servidores de aplicação) ou S3. Se você usar um sistema de arquivos, algum tipo de apoio é normalmente realizado também. Se você tem múltiplas aplicações, você tem que usar um sistema de arquivos compartilhados.

Com GridFS, você armazena arquivos no banco de dados. MongoDB foi construído para fazer isso. Por que isso é uma razão "para usar MongoDB"? Porque o MongoDB tem replicação e sharding de coleções. E adivinhem? Você pode aplicar esse material para coleções GridFS perfeitamente bem. Quando você guarda os arquivos no MongoDB, recebe toda a capacidade de replicação e sharding gratuitamente. Quer backup dos arquivos do usuário? Basta replicar as coleções GridFS.

Guardar os arquivos em um banco de dados é o caminho que deveríamos fazer de agora em diante.

Para conhecer melhor o GridFS, leia esse texto.

Conclusão

Então, se você utilizar o MongoDB, será fantástico por causa de uma sintaxe de consulta simples, a habilidade de shard dos dados entre máquinas com a facilidade e a possibilidade de armazenar arquivos em GridFS tirando partido de replicação e sharding. Isso porque não levei em conta a facilidade de instalação dele, que ganha de longe do CouchDB!

***

Artigo de Mauro Pichiliani

A dica Git desta semana é sobre puxar mudanças de um branch para outro, chamada de cherry picking.

Escolhendo mudanças

Cada commit em um repositório corresponde a uma tree cheia de arquivos. Normalmente, esses arquivos foram criados ao longo de vários commits. Mas, às vezes, é necessário levar o delta entre dois commits, e aplicá-lo a um branch diferente.

Um caso comum em que isso ocorre é quando um problema foi identificado e posteriormente corrigido, mas precisa portar para um branch de versão anterior.

Nesse caso, você não quer pegar o estado atual da tree (que pode ter alterações inacabadas ou não testadas); você só quer pegar o delta associado a essa mudança.

Em outros sistemas de controle de versão, você teria apenas que criar um diff com base na mudança mais recente, e depois corrigir a mudança em seu branch de lançamento. Em vez disso, com o Git, podemos usar o comando cherry-pick para fazer o trabalho para nós:

$ git checkout master
$ echo Working >> file.txt
$ git commit -m "Working" file.txt
$ echo BugFix >> bugfix.txt
$ git commit -m "BugFix" bugfix.txt
$ echo More Working >> file.txt
$ git commit -m "More working" file.txt
# We want to apply 'bugfix' to release
$ git checkout release10
$ git cherry-pick master~1
[release10 41037ab] BugFix
 0 files changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 bugfix.txt

Isso nos permitiu fazer uma única alteração - descrita aqui com master~1 - e copiar o delta no branch de lançamento.

Conjuntos de alterações

Podemos escolher conjuntos de commit (intervalos de revisões) para escolher se quisermos. Se tivéssemos várias mudanças, poderíamos ter master~3..master~1. Ao contrário de apenas gerar um diff e patch da tree atual, isso vai copiar os commits (e suas relações) sobre o novo branch.

Na verdade, já vimos o pick em uso, quando abordamos rebasing na semana passada. Quando você cria uma série de comandos para rebasing, você está dando-lhe instruções para escolher ou editar as alterações existentes:

@ edit 7bf9271 Typo
@ pick 756281e First
@ fixup 07e9061 First
@ pick 13aba60 Second

O “pick” aqui significa o mesmo que “git cherry-puck” para a mudança única. Na verdade, “edit” é realmente um atalho para “git cherry-pick -e”, e “fixup” e “squash” são atalhos para o git cherry-pick -n.

Origem da mudança

Finalmente, é interessante notar que, quando você copia uma mudança usando esse mecanismo, o hash de commit vai mudar (notavelmente porque terá uma hierarquia diferente).

Às vezes, isso não importa, mas se você deseja gravar onde a mudança original veio, você pode executar git cherry-pick-x. Isso insere uma mensagem de commit indicando de onde a mudança original veio:

# From example above
$ git checkout release10
$ git cherry-pick -x master~1
$ git cherry-pick master~1
[release10 41037ab] BugFix (cherry picked from commit 938a4c0bbb3985524192aa8a926ea6757263e94b)
 0 files changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 bugfix.txt

No entanto, note que isso geralmente só faz sentido se a mudança que está sendo pesquisada é de um branch público (para que a alteração de referência seja visível). Outra forma de representar essa mudança é a criação de um merge node entre o branch de liberação e o branch de desenvolvimento em curso como uma forma de mostrar que a fusão ocorreu.

Criando um novo histórico

Sempre que você está usando o cherry-pick, principalmente se você estiver reordenando commits, você está criando um novo histórico. No entanto, você nunca realmente joga fora o antigo, tudo está disponível a partir dos reflogs. Você não está destruindo o histórico, você está criando outros alternativos. Todo o cherry picking te dá a capacidade de aplicar os patches de outros branches de uma maneira segura e com menos erros.

⁂

As perspectivas de XML para armazenamento de dados são surpreendentes e até mesmo os Data WareHouses já estão armazenando informações no formato XML. Como o objetivo principal de armazéns de dados é armazenar dados não-operacionais a longo prazo, ou seja, para trocá-los ao longo do tempo, as razões fundamentais para o sucesso esmagador do XML como um formato de troca também esperam por data warehouses.

Um data warehouse (ou armazém de dados, ou depósito de dados no Brasil) é um sistema de computação utilizado para armazenar informações relativas às atividades de uma organização em bancos de dados, de forma consolidada. O desenho da base de dados favorece os relatórios, a análise de grandes volumes de dados e a obtenção de informações estratégicas que podem facilitar a tomada de decisão.

Se pensarmos que a plataforma .NET oferece diversos recursos para que possamos tratar informações no formato XML, de forma rápida e descomplicada, temos aí um motivo a mais para pensarmos na utilização do formato XML quando realmente indicado.

Neste artigo, eu vou mostrar como criar uma aplicação usando a linguagem C# que realiza o gerenciamento de informações sobre alunos, incluindo a foto, persistindo e recuperando as informações de um arquivo XML. É uma aplicação simples, mas meu objetivo é mostrar o potencial que tem esse recurso na plataforma .NET.

No exemplo deste artigo, eu vou armazenar as seguintes informações sobre os alunos:

• Código
• Nome
• Curso
• Mensalidade
• Foto

Irei utilizar o arquivo Alunos.xml para armazenar as informações dos alunos. Esse arquivo possui a seguinte estrutura:

<?xml version="1.0" standalone="yes"?>
<alunos>
<aluno>
    <codigo>10</codigo>
    <nome>Jimmi Hendrix</nome>
    <curso>Musica</curso>
    <mensalidade>3500</mensalidade>
    <foto>10)hendrix.jpg</foto>
</aluno>
</alunos>

As fotos dos alunos serão armazenadas em uma pasta do projeto chamada Dados juntamente com o arquivo xml. Para evitar que existam nomes de fotos duplicadas (esse é um dos problemas de usar essa solução), eu vou sempre concatenar o código do aluno mais o caractere cerquilha (#) com o nome da foto. Dessa forma, sempre teremos um nome único para a foto.

Para criar o projeto deste artigo, eu vou usar o Visual C# 2008 Express Edition e, antes de iniciar o projeto, vou mostrar a aparência que terá a nossa aplicação na figura abaixo:

Agora vamos ao que interessa...

Criando a aplicação Windows Forms no Vsual C#  2008 Express Edition

Abra o Visual C# 2008 Express e crie um novo projeto do tipo Windows Forms Application no menu File->New Project -> Windows Forms Application com o nome CadastroAlunos.

No formulário form1.cs, vamos incluir os controles a partir da ToolBox conforme o layout da figura abaixo:

• 1 DataGridView - gdvAlunos
• 4 TextBox : txtCodigo, txtNome, txtCurso, txtMensalidade, picFoto
• 11 Buttons assim designados:

01. Buttons para movimentação dos registros:

• btnPrimeiro
• btnAnterior
• btnProximo
• btnUltimo

02. Botões para operações de manutenção de dados:

• btnInlcuir
• btnProcurar
• btnAtualizar
• btnDeletar
• btnLimpar
• btnCarregaXML
• btnSair
• btnLocalizarFoto

• 1 Contrrole PictureBox - picFoto

Além disso, vamos usar dois controles OpenFileDialog: ofd1 e ofd2. Após incluir os controles acima e definir o nome de cada um conforme indicado, defina os controles conforme o layout acima. A seguir, vamos definir os namespaces usados no projeto no início do formulário form1.cs:

using
System;
using System.Data;
using System.Drawing;
using System.Windows.Forms;
using Microsoft.VisualBasic;
using System.IO;

Feito isso, vamos definir as variáveis que serão usadas no projeto:

//define variáveis usadas no projeto
DataSet ds; 
string fcaminho; 
string fdiretorio;
string pcaminho;
string pnome;
string pdestino; 
int reg = 0; 
DataRow linharegistro;

Vou começar definindo o código do botão de comando Carregar Arquivo XML.

Ao clicar no botão, será aberta uma janela de diálogo OpenFileDialog para que seja possível selecionar o arquivo XML que desejamos carregar e exibir no controle DataGridView - gdvAlunos. O código é visto abaixo:

private void btnCarregaXML_Click(object sender, EventArgs e)
        { 
            try
            {    
                ofd1.Filter = "xml|*.xml|all files|*.*";
 DialogResult res = ofd1.ShowDialog();
         if (res == DialogResult.OK)
                {
                    gdvAlunos.DataSource = null;
                    btnLimpar.PerformClick();
                    fcaminho = ofd1.FileName;
                    ds = new DataSet();
                    ds.ReadXml(fcaminho);               
                    //definindo a chave primaria a fim de procurar o registro usando o método find
ds.Tables[0].Constraints.Add("pk_codigo", ds.Tables[0].Columns[0], true);
                    gdvAlunos.DataSource = ds.Tables[0];
                    fdiretorio = fcaminho.Substring(0, fcaminho.LastIndexOf("\\") + 1);
                    mostrarDados();
                }
            }
            catch(Exception ex)
            { MessageBox.Show("Informação inválida : " + ex.Message, "Aviso", MessageBoxButtons.YesNo, MessageBoxIcon.Warning); }
        }

Se um arquivo for selecionado, então faremos o seguinte:

• Limpamos os controles do formulário: btnLimpar.PerformClick();
• Obtemos o caminho e o nome do arquivo selecionado: fcaminho = ofd1.FileName;
• Criamos um dataset e, usando o método ReadXml(fcaminho), lemos o conteúdo do arquivo XML para o dataset;
• Definimos uma chave primária na tabela a fim de procurar o registro usando o método Find;

O método Find da coleção Rows retorna um objeto DataRow, e, nesse caso, uma única linha e não um array de linhas. Esse método precisa que você defina a propriedade chave primária (Primary Key) antes de usá-lo. Se você não fizer isso, vai obter uma exceção.

• Chamamos a rotina mostrarDados() para exibir os dados no DataGridView.

Vejamos a seguir o código da rotina mostrarDados():

 void mostrarDados()
        {  
     if (ds.Tables[0].Rows.Count > 0)
            {  
                picFoto.Image = null;
                txtCodigo.Text = ds.Tables[0].Rows[reg][0].ToString();
                txtNome.Text = ds.Tables[0].Rows[reg][1].ToString();
                txtCurso.Text = ds.Tables[0].Rows[reg][2].ToString();
                txtMensalidade.Text = ds.Tables[0].Rows[reg][3].ToString();
                picFoto.ImageLocation = fdiretorio + ds.Tables[0].Rows[reg][4].ToString();
            }
            else
                MessageBox.Show("Não existem registros.","Aviso", MessageBoxButtons.YesNo, MessageBoxIcon.Warning);
        }

Este código verifica se existem linhas na tabela: 

if(ds.Tables[0].Rows.Count > 0)

Em caso positivo, exibe os dados nos controles do formulário. Estamos usando um dataset não tipado, no qual temos que definir a posição do registro na tabela do dataset da seguinte forma:

ds.Tables[0].Rows[reg][0].ToString()

• ds - o dataset
• ds.Tables[0] - a primeira tabela do dataset (só existe uma mesmo)
• ds.Tables[0].Rows[reg][n] - campo de índice igual a n existente na linha (Rows)

A rotina mostrarDados() não retorna nada, por isso o modificador void. Ela será usada sempre que desejamos exibir informações nos controles do formulário.

Vejamos agora o código do botão Incluir que deverá incluir um novo aluno no arquivo XML:

private void btnIncluir_Click(object sender, EventArgs e)
        {
            linharegistro = null;
   linharegistro = ds.Tables[0].Rows.Find(txtCodigo.Text);
            if (linharegistro == null)
            {
                //atribui os valores dos controles ao datarow
                linharegistro = ds.Tables[0].NewRow();
                linharegistro[0] = txtCodigo.Text;
                linharegistro[1] = txtNome.Text;
                linharegistro[2] = txtCurso.Text;
                linharegistro[3] = txtMensalidade.Text;

  salvaFoto();    
                linharegistro[4] = pnome;
                //inclui uma linha na tabela
                ds.Tables[0].Rows.Add(linharegistro);
                reg = ds.Tables[0].Rows.IndexOf(linharegistro);
                //salva dados no arquivo xml
                ds.WriteXml(fcaminho);
                MessageBox.Show("Registro incluído com sucesso.", "Aviso", MessageBoxButtons.YesNo, MessageBoxIcon.Warning);
            }
            else
            MessageBox.Show("Registro já existe.O código deve ser único.","Aviso", MessageBoxButtons.YesNo, MessageBoxIcon.Warning);
        }

Verificamos se o registro já existe usando o método Find: linharegistro = ds.Tables[0].Rows.Find(txtCodigo.Text).

Em caso positivo, criamos uma nova linha(NewRow) e atribuímos os valores informados no TextBox à nova linha. Chamamos a rotina SalvaFoto() e incluímos a nova linha na tabela e, em seguida, gravamos os dados no arquivo XML usando o método ds.WriteXml().

A rotina SalvaFoto() tem seu código exibido a seguir:

void salvaFoto()
        {
            //Procurando o nome da foto
            //salvando na pasta do arquivo xml com nome unico (codigo+nome_foto)
            pcaminho = picFoto.ImageLocation;
            pnome = txtCodigo.Text + "#" + (pcaminho.Substring(pcaminho.LastIndexOf('\\') + 1));//(codigo + nome da foto)
            pdestino = fdiretorio + pnome;
picFoto.Image.Save(pdestino);//salva imagem no disco
        }

Neste código, atribuímos o caminho da foto à variável pcaminho e montamos o nome da foto com o código do aluno mais o caractere # e o nome da foto. Montamos o diretório de destino e salvamos a foto no disco. No botão Procurar, temos o código que localiza um registro e exibe as informações no formulário:

private void btnProcurar_Click(object sender, EventArgs e)
        {

            int n = Convert.ToInt32(Interaction.InputBox("Informe o código do aluno :", "Procurar", "10", 200, 200));
            //procurando registros usando o método find
            linharegistro = null;
  linharegistro = ds.Tables[0].Rows.Find(n);
            if (linharegistro != null)
            {   //preenche os controles do formulário
                reg = ds.Tables[0].Rows.IndexOf(linharegistro);
                txtCodigo.Text = linharegistro[0].ToString();
                txtNome.Text = linharegistro[1].ToString();
                txtCurso.Text = linharegistro[2].ToString();
                txtMensalidade.Text = linharegistro[3].ToString();
                picFoto.ImageLocation = fdiretorio + linharegistro[4];
            }
            else
                MessageBox.Show("registro não localizado.", "Aviso", MessageBoxButtons.YesNo, MessageBoxIcon.Warning);

        }

Solicitamos o código do aluno usando o InputBox e novamente usamos o método Find para localizar o registro. O código do botão Atualizar que altera os dados do arquivo XML:

private void btnAtualizar_Click(object sender, EventArgs e)
        {
            //procurando registros usando o método find
 DataRow linharegistro = ds.Tables[0].Rows.Find(txtCodigo.Text);
            if (linharegistro!= null)
            {
    reg = ds.Tables[0].Rows.IndexOf(linharegistro);
                //atribui os valores dos controles aos campos da tabela
                ds.Tables[0].Rows[reg][0] = txtCodigo.Text;
                ds.Tables[0].Rows[reg][1] = txtNome.Text;
                ds.Tables[0].Rows[reg][2] = txtCurso.Text;
                ds.Tables[0].Rows[reg][3] = txtMensalidade.Text;

                File.Delete(fdiretorio + linharegistro[4]);
  salvaFoto();

                ds.Tables[0].Rows[reg][4] = pnome;
                //grava no arquivo xml
 ds.WriteXml(fcaminho);
                MessageBox.Show("registro atualizado", "Aviso", MessageBoxButtons.YesNo, MessageBoxIcon.Warning);
            }
            else
                MessageBox.Show("Não existe registro de aluno com este código.", "Aviso", MessageBoxButtons.YesNo, MessageBoxIcon.Warning);
        }

Localizamos o item usando o método Find e atribuímos os valores informados nas caixas de texto às linhas da tabela, salvamos a foto e gravamos as alterações no arquivo XML. A rotina para excluir uma linha do arquivo é vista no código a seguir:

private void btnDeletar_Click(object sender, EventArgs e)
        {
            //procurando registros usando o método find
            DataRow linharegistro = ds.Tables[0].Rows.Find(txtCodigo.Text);
            if (linharegistro!= null)
            {
                File.Delete(fdiretorio + linharegistro[4]);
 ds.Tables[0].Rows.Remove(linharegistro);   
  ds.WriteXml(ofd1.FileName);
                MessageBox.Show("Registro deletado.", "Aviso", MessageBoxButtons.YesNo, MessageBoxIcon.Warning);
                reg = 0;
                mostrarDados();
            }
            else
                MessageBox.Show("Não existe registro de aluno com este código.", "Aviso", MessageBoxButtons.YesNo, MessageBoxIcon.Warning);
        }

Localizamos o item usando o método Find e usando método Remove excluímos a linha da tabela. O código de cada um dos botões de navegação é mostrado a seguir:

private void btnPrimeiro_Click(object sender, EventArgs e)
        {
            reg = 0;
            mostrarDados();
        }

      private void btnAnterior_Click(object sender, EventArgs e)
        {
            if (reg > 0)
            {
                reg--;
                mostrarDados();
            }
            else
            { MessageBox.Show("Primeiro Registro."); }
        }

    private void btnProximo_Click(object sender, EventArgs e)
        {
            if (reg < ds.Tables[0].Rows.Count - 1)
            {
                reg++;
                mostrarDados();
            }
            else
            { MessageBox.Show("Último Registro."); }
        }

 private void btnUltimo_Click(object sender, EventArgs e)
        {
            reg = ds.Tables[0].Rows.Count - 1;
            mostrarDados();
        }

Verificamos a posição do registro e usamos a rotina mostraDados para exibir os dados atuais. O código do botão Limpar é dado a seguir:

        private void btnLimpar_Click(object sender, EventArgs e)
        {
            //limpa controles TextBox do formulário e o picturebox
            txtCodigo.Text = txtNome.Text = txtCurso.Text = txtMensalidade.Text = "";
            picFoto.Image = null;
        }

Também incluímos o código abaixo no evento CellClick do DataGridView.

      private void gdvAlunos_CellClick(object sender, DataGridViewCellEventArgs e)
        {
            try
            {
                //obtem o valor da primeira célula do grid que é o código do aluno
                int codigo = Convert.ToInt32(gdvAlunos.CurrentRow.Cells[0].Value);
                linharegistro = ds.Tables[0].Rows.Find(codigo);
                if (linharegistro != null)
                {   //preenche os controles do formulário
                    reg = ds.Tables[0].Rows.IndexOf(linharegistro);
                    txtCodigo.Text = linharegistro[0].ToString();
                    txtNome.Text = linharegistro[1].ToString();
                    txtCurso.Text = linharegistro[2].ToString();
                    txtMensalidade.Text = linharegistro[3].ToString();
                    picFoto.ImageLocation = fdiretorio + linharegistro[4];
                }
                else
                    MessageBox.Show("registro não localizado.", "Aviso", MessageBoxButtons.YesNo, MessageBoxIcon.Warning);
            }
            catch
            { }
        }

Dessa forma, quando uma linha do grid for clicada, obtemos os valores da linha e exibimos no formulário. Para encerrar, temos o código do botão que encerra a aplicação:

private void btnSair_Click(object sender, EventArgs e)
        {
            DialogResult resultado = MessageBox.Show("Deseja Encerrar a aplicação?",
            "Sair", MessageBoxButtons.YesNo, MessageBoxIcon.Warning);
            if (resultado == DialogResult.Yes)
                Application.Exit();
        }

Com isso, mostramos que podemos ter informações armazenadas em arquivos XML e que podemos tratá-las de forma dinâmica e funcional com os recursos da linguagem C#.

Simples, simples assim. Pegue o projeto completo aqui: CadastroXML.zip.

Eu sei, é apenas XML, mas eu gosto...

artigo publicado originalmente no iMasters, por José Carlos Macoratti

Neste artigo, veremos como inserir e obter imagens de um banco de dados SQL Server e como exibir as imagens em um controle GridView.

Acompanhe a versão para desktop deste artigo no link: Trabalhando com imagens no SQL Server – Macoratti.net

Vamos iniciar abrindo o Visual Web Developer 2010 Express Edition e criando um novo projeto via opção File -> New Project.

Selecione a linguagem Visual C# e a opção Web.

A seguir, selecione o template ASP .NET Web Application e informe o nome Tratando_Imagens_SQLServer.

Criando o banco de dados no SQL Server

Eu poderia criar o banco de dados usando o SQL Server Management Studio (SSMS), mas vou usar o próprio ambiente do Visual Web Developer Express Edition.

Abra a janela DataBase Explorer e clique com o botão direito em Data Connections, clicando a seguir em Add Connection.

Na janela Add Connection, clique no botão Change e altere o Data Source para: Microsoft SQL Server Database File.

Obs: Esta janela poderá exibir outras opções de Data Source, mas eu escolhi trabalhar com um banco de dados anexado ao meu SQL Server Local.

Informe o nome do banco de dados; no exemplo, o nome usado foi Cadastro.mdf, e clique no botão OK.

Uma caixa de diálogo irá surgir informando que o banco de dados não existe e se você deseja criá-lo. Confirme e clique no botão Sim para criar o banco de dados.

Você verá na janela DataBase Explorer o banco de dados Cadastro.

Clique com o botão direito no item Tables e a seguir clique em Add New Table;

Crie a tabela Imagens definindo os campos:

• id – int – chave primária e do tipo identity;
• descrição – nvarchar(150)
• imagem – image

Assim, temos o banco de dados Cadastro.mdf e a tabela Imagens criadas e prontas para serem usadas.

Definindo as páginas do projeto

Vamos definir a página Default.aspx como a página principal do projeto clicando com o botão direito do mouse sobre essa página e selecionando a opção Set As Start Page.

Agora vamos alterar o código da página Site.Master para exibir uma opção para acessar a página onde vamos tratar as imagens conforme o código a seguir:

<%@ Master Language="C#" AutoEventWireup="true" CodeBehind="Site.master.cs" Inherits="Tratando_Imagens_SQLServer.SiteMaster" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head runat="server">
    <title></title>
    <link href="~/Styles/Site.css" rel="stylesheet" type="text/css" />
    <asp:ContentPlaceHolder ID="HeadContent" runat="server">
    </asp:ContentPlaceHolder>
</head>
<body>
    <form runat="server">
    <div>
        <div>
            <div>
                <h1>
                   Macoratti .net
                </h1>
            </div>
            <div>
            </div>
            <div>
                <asp:Menu ID="NavigationMenu" runat="server" CssClass="menu" EnableViewState="false" IncludeStyleBlock="false" Orientation="Horizontal">
                    <Items>
                        <asp:MenuItem NavigateUrl="~/Default.aspx" Text="Home"/>
                        <asp:MenuItem NavigateUrl="~/About.aspx" Text="About"/>
                        <asp:MenuItem NavigateUrl="~/Imagens.aspx" Text="Imagens"/>
                    </Items>
                </asp:Menu>
            </div>
        </div>
        <div>
            <asp:ContentPlaceHolder ID="MainContent" runat="server"/>
        </div>
        <div>
        </div>
    </div>
    <div>

    </div>
    </form>
</body>
</html>

A seguir, vamos incluir um novo Web Form chamado Imagens.aspx em nosso projeto.

No menu Project, clique em Add New Item.

Selecione o template Web Form using Master Page, informe o nome Imagens.aspx e clique no botão Add.

Na próxima janela, selecione a master page Site.Master e clique em Ok.

Vamos incluir na página Imagens.aspx a partir da toolbox os seguintes controles:

• TextBox – ID=txtDescricao TextMode=Multiline
• FileUpload – ID=arquivoUploadImagem
• GridView – ID=gdvImagens
• Button – ID=btnUpload – Text=Enviar Arquivo

Conforme o leiaute da figura abaixo:

No controle GridView, vamos definir dois campos: Descrição e Imagem.

<%@ Page Title="" Language="C#" MasterPageFile="~/Site.Master" AutoEventWireup="true" 
CodeBehind="Imagens.aspx.cs" Inherits="Tratando_Imagens_SQLServer.Imagens" %>
<asp:Content ID="Content1" ContentPlaceHolderID="HeadContent" runat="server">
    Inserindo e Recuperando imagens no SQL Server com ASP .NET
</asp:Content>
<asp:Content ID="Content2" ContentPlaceHolderID="MainContent" runat="server">
    <head> 
    <style type="text/css">
        .Gridview
        {
            font-family:Verdana;
            font-size:10pt;
            font-weight:normal;
            color:black;
            }
    </style>
    </head>
    <table>
    <tr><td> Descricao:</td>
    <td> <asp:TextBox ID="txtDescricao" runat="server" BackColor="#FFFFCC" Height="97px" 
            TextMode="MultiLine" Width="260px"></asp:TextBox>
    </td>
    </tr><tr><td>Imagem:</td>
    <td> <asp:FileUpload ID="arquivoUploadImagem" runat="server" Width="350px" /> </td>
    </tr><tr><td>
    </td>
    <td><asp:Button ID="btnUpload" runat="server" Text="Enviar Arquivo" 
            onclick="btnUpload_Click" />
    </td>
    </tr>
    </table>
    </div>
    <asp:GridView ID="gdvImagens" CssClass="Gridview" runat="server" AutoGenerateColumns="False"
    HeaderStyle-BackColor="#7779AF" HeaderStyle-ForeColor="white" Height="766px" 
        Width="521px">
    <Columns>
    <asp:BoundField HeaderText = "Descrição" DataField="imagename" />
    <asp:TemplateField HeaderText="Imagem">
    <ItemTemplate>
    <asp:Image ID="Image1" runat="server" 
            ImageUrl='<%# "ImageHandler.ashx?ImgID="+ Eval("id") %>' Height="150px" 
            Width="150px"/>
    </ItemTemplate>
    </asp:TemplateField>
    </Columns>
    <HeaderStyle BackColor="#7779AF" ForeColor="White"></HeaderStyle>
    </asp:GridView>
</asp:Content>

<?xml version="1.0"?>
<!--
  For more information on how to configure your ASP.NET application, please visit
  http://go.microsoft.com/fwlink/?LinkId=169433
  -->
<configuration>

  <connectionStrings>
    <add name="ConexaoSQLServer"
        connectionString="Data Source =.\SQLEXPRESS;Initial Catalog=Cadastro;Integrated Security=SSPI;"
        providerName="System.Data.SqlClient" />
  </connectionStrings>
   .........
   ........

using System; using System.Web; using System.Web.UI; using System.Data; using System.Data.SqlClient; using System.Configuration;

 protected void Page_Load(object sender, EventArgs e)
   {
            if (!IsPostBack)
            {
                VincularDados();
            }
  }

protected void btnUpload_Click(object sender, EventArgs e)
        {
            //Verifica se enviou imagem ou não
            if (arquivoUploadImagem.HasFile)
            {
                //obtem o tamanho da imagem enviada
                int tamanho = arquivoUploadImagem.PostedFile.ContentLength;
                //cria um array de bytes para armazenar os dados binários da imagem
                byte[] imgbyte = new byte[tamanho];
                //armazena a imagem selecinada na memória
                HttpPostedFile img = arquivoUploadImagem.PostedFile;
                //define os dados binários
                img.InputStream.Read(imgbyte, 0, tamanho);
                string descricaoImagem = txtDescricao.Text;
                //abre uma conexão 
                SqlConnection connection = new SqlConnection(strcon);
                connection.Open();
                SqlCommand cmd = new SqlCommand("INSERT INTO Imagens (descricao,imagem) VALUES (@descricao,@imagem)", connection);
                cmd.Parameters.Add("@descricao", SqlDbType.VarChar, 50).Value = descricaoImagem;
                cmd.Parameters.Add("@imagem", SqlDbType.Image).Value = imgbyte;
                int contador = cmd.ExecuteNonQuery();
                connection.Close();
                if (contador == 1)
                {
                    VincularDados();
                    txtDescricao.Text = string.Empty;
                    ScriptManager.RegisterStartupScript(this, this.GetType(), "alertmessage", "javascript:alert('" + descricaoImagem + " imagem incluida com sucesso')", true);
                }
            }
        }

private void VincularDados()
        {
            SqlConnection connection = new SqlConnection(strcon);
            SqlCommand command = new SqlCommand("SELECT descricao,id from Imagens", connection);
            SqlDataAdapter daimages = new SqlDataAdapter(command);
            DataTable dt = new DataTable();
            daimages.Fill(dt);
            gdvImagens.DataSource = dt;
            gdvImagens.DataBind();
            gdvImagens.Attributes.Add("bordercolor", "black");
        }

using System;
using System.Web;
using System.Data.SqlClient;
using System.Configuration;

namespace Tratando_Imagens_SQLServer
{
    public class ImagemHandler : IHttpHandler
    {
        string strcon = ConfigurationManager.ConnectionStrings["ConexaoSQLServer"].ConnectionString;

        public void ProcessRequest(HttpContext context)
        {
            string imagemID = context.Request.QueryString["ImgID"];
            SqlConnection connection = new SqlConnection(strcon);
            connection.Open();
            SqlCommand command = new SqlCommand("select imagem from Imagens where id=" + imagemID, connection);
            SqlDataReader dr = command.ExecuteReader();
            dr.Read();
            context.Response.BinaryWrite((Byte[])dr[0]);
            connection.Close();
            context.Response.End();
        }
        public bool IsReusable
        {
            get
            {
                return false;
            }
        }
    }
}

Então, primeiro faça o download da library para poder referenciá-la em seu projeto web. Eu fiz o download da library e a descompactei em: C:\Program Files\itextsharp-5.0.4-dll

Para demonstrar como usar esse recurso, vou usar o Visual Web Developer 2008 Express Edition e criar um novo web site (New Web Site) usando o template ASP .NET Web Site chamado ASPNET_PDF usando a linguagem Visual Basic. (poderíamos ter usado a linguagem C#).

Agora vamos referenciar a library iTextSharp em nosso projeto:

No menu WebSite, selecione Add Reference e, em seguida, clique na aba Browse da janela Add Reference e localize o lugar onde você descompactou a biblioteca iTextSharp, selecionando o arquivo itextsharp.dll e clicando em OK.

Agora vamos definir o seguinte leiaute no arquivo Default.aspx:

Através do menu Table -> Insert Table, inclua uma tabela com 5 linhas e 2 colunas e, a seguir, inclua os seguinte controles na tabela:

• TextBox - txtTextoPDF
• TextBox - txtNomeArquivoPDF
• Button - btnGerarPDF

Agora no arquivo code-behind Default.aspx.vb vamos definir os namespaces usados no projeto:

• Imports System
• Imports System.IO
• Imports iTextSharp.text
• Imports iTextSharp.text.pdf

No evento Click do botão de comando btnGerarPDF, vamos fazer a chamada da rotina que iremos criar para gerar o arquivo PDF:

Protected Sub btnGerarPDF_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles btnGerarPDF.Click
       gerarPDF(txtTextoPDF.Text, txtNomeArquivoPDF.Text)
End Sub

A rotina gerarPDF() está usando o texto a ser gerado no arquivo PDF e o nome do arquivo pdf que será gerado.

A rotina gerarPDF() possui o seguinte código:

Private Sub gerarPDF(ByVal texto As String, ByVal arquivo As String)

Dim hoje As DateTime = DateTime.Now

If (arquivo.Contains(".pdf")) Then
     arquivo = arquivo.Replace(".pdf", "")
End If

Dim arquivoPDF = arquivo & hoje.Millisecond & ".pdf"

Dim doc As Document = New Document
PdfWriter.GetInstance(doc, New FileStream(Request.PhysicalApplicationPath + "\" & arquivoPDF, FileMode.Create))
doc.Open()
doc.Add(New Paragraph(texto))
doc.Close()
Response.Redirect("~/" & arquivoPDF)

End Sub. 

Vamos entender o código acima.

Na primeira parte do código, estou verificando se o nome do arquivo informado possui a extensão .pdf; nesse caso, eu removo a extensão.

A seguir, eu monto o nome do arquivo, adicionando os milissegundos da data obtida para, dessa forma, ter um nome único de arquivo a cada geração.

A seguir é que entra a criação do arquivo PDF:

• criamos uma instância de um documento através da classe Document;
• criamos um arquivo PDF usando o nome gerado usando a propriedade Request.PhysicalApplicationPath, que obtém o caminho do Sistema de arquivos físicos do diretório raiz do aplicativo de servidor atualmente em execução. Dessa forma, os arquivos serão gerados na raiz da aplicação;
• abrimos o documento e incluímos o texto informado, e depois fechamos o documento;
• para exibir o documento, usamos o Response.Redirect.

Na figura a seguir, vemos o resultado do arquivo PDF gerado sendo exibido:

Viu como é simples gerar arquivos PDF em aplicações web usando o iTextSharp? É claro que existem outros recursos que não foram mostrados, através dos quais podemos gerar documentos mais complexos, mas eu pretendo mostrar isso em outro artigo.

Até o próximo artigo ASP .NET.

Pegue o projeto completo aqui: ASPNET_PDF.zip

Eu sei, é apenas ASP .NET, mas eu gosto...

artigo publicado originalmente no iMasters, por José Carlos Macoratti

Olá, pessoal! Na primeira parte deste artigo sobre Criteria, eu fiz uma introdução a respeito. Agora, vamos ver mais algumas restrições importantes que temos nesta API. Vamos lá?!

Criteria API

Uma outra restrição bem interessante é o uso do >=, >, <=,< que fazemos no SQL, no HQL e etc. No Criteria temos métodos que nos ajudam na implementação desses operadores: gt(),ge(),lt(),le(). Veja cada um:

• gt() = maior que
• ge() = maior ou igual que
• lt() = menor que
• le() = menor ou igual que

Saber de onde os métodos vêm é tão importante quando saber usá-los. Os que estão citados acima vêm da classe Resctrictions. Exemplo:

crit.add(Restrictions.ge(“preco”, new Double(100.00));

A leitura é bem simples: retorna todos os produtos com o preço maior ou igual a R$100,00. Um dos pontos importante no uso de Criteria é quando precisamos usar AND e OR nas restrições.

crit.add(Restrictions.gt(“preco” new Double(100.0));
 crit.add(Restrictions.like(“nome”, “smart%”));
List lista = crit.list();

A leitura é a seguinte: retorne produtos com o preço maior que R$100,00 e (AND) que tenham o nome “smart” como parte da string.

Agora se precisarmos do OR, veja como fica:

Criterion preco = Restrictions.gt(“preco”, new Double(100.0));
 Criterion nome = Resctrictions.like(“nome”, “smart%”);
 LogicalExpression orExp = Resctrictions.or(preco,nome);
 crit.add(orExp);
 List list = crit.list();

A lógica é a seguinte: retorne produtos com preço maior do que R$100,00 ou que tenha “smart” na palavra. Na linha 04 adicionamos o resultado. Então, a linha 02 somente é executada caso a primeira seja falsa.

Quando queremos mais do que duas sequências diferentes de OR, podemos usar a classe Disjunction, que fica em org.hibernate.Disjunction para representar  uma disjunction. Sem sombras de dúvidas usar a disjunction é mais conveniente do que vários OR no código, veja como fica:

Criterion preco = Resctrictions.gt(“preco”, new Double(100.0));
Criterion nome = Resctrictions.like(“nome”, “smart%”);
Criterion fornecedor = Restrictions.like(“fornecedor”, “nokia%”);
Disjunction dis = Resctrictions.disjuntion();
dis.add(preco);
dis.add(nome);
dis.add(fornecedor);
cri.add(dis)
List lista = crit.list();

A leitura do código acima seria: retorne os produtos que tenha o preço maior do que R$100,00 ou (or) que tenha na parte da string a palavra “smart”, ou que tenha na propriedade fornecedor a palavra “Nokia”. Para fazer com o AND usamos o método conjunction() da classe Resctrictions.

code Conjuction

Apenas a linha acima será alterada para atender a cláusula AND.

Vou ficando por aqui  e espero que tenham gostado do artigo!

Olá, pessoal! Hoje eu vou explicar pra vocês como é que a equipe define quais histórias estarão no Sprint Backlog do Sprint. Já vimos que o PO é alguém importante no planejamento do Sprint. Então chegou a hora de discutir de como tirar as coisas que estão no Product Backlog e trazer para nossa “mesa”.

Como a equipe define as histórias que vão para um Sprint?

Essa é uma pergunta clássica. Eu já ouvi alguns comentários que talvez o PO, ou SM, deveria fazer isso. Eu acho que se Scrum fosse um framework que funcionasse com base do "quem tem o nível mais alto (para não dizer cargo) é quem define as coisas", talvez faria sentido. Mas como não é assim, o conceito de time, equipe, pessoas, etc, é de fato mais importante que os papéis apenas.

Enfim, apesar do PO ter escrito toda história e em alguns casos ser o responsável pelo investimento no projeto, no Scrum isso não dá o direito de dizer: “a história já está escrita, priorizada e o escopo é aquele. Se não entendeu algum ponto, por favor, deixe-me saber, mas não vou mudar o escopo, porque eu quero assim”. Não é bem por ai...  A prioridade aqui é o time, ou seja, todos estão envolvidos e não apenas o PO. Não é só porque ele é dono do produto que tudo vai acontecer como ele deseja sem questionamentos.

Mas nós sabemos que esse cenário seria o ideal, mas que na realidade não é assim. Se temos um problema como esse, é sinal de que seu cliente não entendeu como o Scrum funciona e ai é um outro problema que precisa ser tratado antes de tudo. Eu diria que até antes do cliente apresentar o produto, ele já deveria saber o porquê vai rodar o Scrum e saber que as coisas funcionam em um trabalho de equipe e que cada um tem suas responsabilidade e limitações. Se isso não está claro para o seu cliente, não inicie nada. Do contrário, terá problemas e discussões que talvez não compensem. Agora vamos ignorar o cenário anterior.

Então, Camilo, como escolher a história que vai para o Sprint Backlog?

Por sentimento ou instinto. É isso mesmo! Não há mágica, ou ferramenta, que vai te dizer: “pegue a história X, e a equipe que vai contribuir para isso”. Normalmente, o ScrumMaster pergunta para equipe se a história que está no topo da lista (aquela que tem mais importância para o PO) dá para entregar naquela Sprint. Aquelas nas quais ainda restarem dúvidas e incertezas a respeito da entrega ficam de fora (com o aval e negociação do PO) do Sprint.

A seguir, temos um exemplo pratico (peguei a imagem do livro Scrum from the trenches):

Note: Claro que vamos seguir sempre a ordem de importância para o PO e não pegar as histórias aleatórias.

Vamos supor que o PO não gostou porque a história D está de fora - afinal, a velocidade da equipe só permite entregar até a C. O que fazer?

Em primeiro lugar, o PO não pode obrigar a equipe a pegar a história D (de novo, para você não esquecer). Então ele tem duas opções:

1. É alterar o escopo, para que o time possa fazer uma nova estimativa;
2. Mudar a ordem de prioridade, levando a história para cima do C, daí a equipe é obrigada a pegá-la. Porém, a história C ficaria de fora.
   

Mas, o framework Scrum não diz que temos que pegar a história com maior prioridade? Sim. Pegamos a história que está no topo da pilha do product backlog, mas ao olhá-la, identificamos que é grande demais e não cabe dentro do Sprint de duas semanas, ou seja, é pouco tempo para muita coisa (escopo grande). Lembre-se, as histórias deve ser do tipo INVEST.

• Independente: a história não pode ficar bloqueada durante a implementação; ela precisa ter vida por si só;
• Negociável: uma história precisa ter um escopo que pode ser alterado sem perder toda a essência do que se pretende. E que algumas coisas possam ser postergadas para um dos próximos Sprint tranquilamente;
• Valioso: deve agregar valor ao produto e ter um valor de importância dentro do próprio produto;
• Estimável: se não conseguimos estimar com base no que está escrito para história, é porque temos algum problema no que ela se propõe. Então precisamos ver com o PO o que ele está querendo dizer;
• Small: não é preciso ter todas as funcionalidade em única história, sendo assim, ela pode ser pequena para que fique dentro do Sprint;
• Testável: toda história precisa ter uma forma de validar se ela foi implementada corretamente. Então os critérios de aceitação devem existir, para que possamos nos certificar que fizemos algo de acordo com o esperado.

Bom, pessoal, era isso que eu tinha para apresentar para vocês. Não se esqueçam que a responsabilidade de analisar e estimar é da equipe. O que foi escrito pelo PO é o que ele desejaria de ver pronto, mas nem sempre é possível, pois há vários fatores que contribuem para isso, tais como: velocidade da equipe, nível técnico, interrupções, etc. Não é uma tarefa fácil, mas com uma boa comunicação entre a equipe e o PO, sempre terminamos no contexto ideal.

Hoje contamos com alguns servidores HTTP (web) tais como Apache, lighttpd, Nginx, TUX, Cherokee e outros. O desenvolvimento deste artigo é para explicar melhor como trabalhar com Python e desenvolver coisas novas para as necessidades do dia a dia.

Vou explicar qual foi a necessidade do meu cliente para que eu escrevesse este software:

O Cliente tinha um sistema rodando com Ruby On Rails e o desenvolvedor como não sabia configura o Ruby para processar juntamente com o servidor web (Apache); ele rodou o servidor web do próprio Ruby On Rails com a porta 4000.

Como teria que mexer no sistema e não sou programador Ruby, fiz uma contra-proposta para desenvolver o sistema novamente (porque tinha muitos erros) em Python (pois é a linguagem que eu sei programar). O cliente aceitou e dei start no desenvolvimento.

Ao terminar o software, queria que ficasse transparente para o usuário final (para ele acessar da mesma forma que acessava); testei alguns servidores web como Nginx e lighttpd, só que ele estava comendo recursos desnecessário no servidor, lembrando que eu só queria colocar um HTML com uma meta tag para redirecionar para o sistema novo. Bom, resolvi desenvolver uma solução própria em Python, e achei a biblioteca BaseHTTPServer.

A estrutura que montei é a seguinte:

avelino@program-8:~/python/httpd$ ls
htdocs  httpd.py

O daemon que vamos usar é o httpd.py, vamos para a parte de código.

Vamos usar as seguintes bibliotecas:

import sys,os
import string,cgi,time
from BaseHTTPServer import BaseHTTPRequestHandler, HTTPServer

Vamos escrever uma classe para tratar o POST e GET (Não usei o POST na minha necessidade, mas para quem quer fazer um servidor HTTP simples pode precisar):

class http(BaseHTTPRequestHandler): 

    def do_GET(self):
        try:
            if self.path.endswith(".html"):
                f = open(DocumentRoot + self.path)
                self.send_response(200)
                self.send_header('Content-type','text/html')
                self.end_headers()
                self.wfile.write(f.read())
                f.close()
                return

            if self.path.endswith(".esp"):
                self.send_response(200)
                self.send_header('Content-type','text/html')
                self.end_headers()
                self.wfile.write("hey, today is the" + str(time.localtime()[7]))
                self.wfile.write(" day in the year " + str(time.localtime()[0]))
                return

            return

        except IOError:
            self.send_error(404,'File Not Found: %s' % self.path)

    def do_POST(self):
        global rootnode
        try:
            ctype, pdict = cgi.parse_header(self.headers.getheader('content-type'))
            if ctype == 'multipart/form-data':
                query=cgi.parse_multipart(self.rfile, pdict)
            self.send_response(301)

            self.end_headers()
            upfilecontent = query.get('upfile')
            print "filecontent", upfilecontent[0]
            self.wfile.write("<html>Post OK. <br /><br />");
            self.wfile.write(upfilecontent[0]);
            self.wfile.write("</html>")

        except:

            pass

Os nomes das def do_GET e do_POST são padrões do BaseHTTPRequestHandler. O do_GET usamos para renderização de qualquer arquivo. Por exemplo, temos uma index.html em nossa pasta htdocs, ele vai trabalhar pegando o arquivo index.html (/home/avelino/python/httpd/htdocs/index.html) e renderizando o html dele.

Vou criar uma função para chamar as declarações da classe:

def main(NameVirtualHost):

    try:
        virtualhost = string.split(NameVirtualHost,":")
        if virtualhost[0] == "*":
            virtualhost[0] = ""
         
        server = HTTPServer((virtualhost[0], int(virtualhost[1])), http)
        print 'Start server HTTP IN %s' % NameVirtualHost
        server.serve_forever()

    except KeyboardInterrupt:
        print 'Shutting down server HTTP'
        server.socket.close()

A var NameVirtualHost é onde vamos passar IP e PORTA para o servidor HTTP, exemplo.

Liberar só para acesso local: localhost:8000
Liberar para qualquer IP que estiver configurado na maquina: *:8000

Na biblioteca BaseHTTPServer temos uma função onde o mesmo server, para rodar o servidor, recebe dois parâmetros: o primeiro é IP/PORTA, e o segundo é a classe onde estão os métodos (GET, POST etc) que, no nosso caso, é a classe html.

Agora vamos chamar a def que fizemos:

if __name__ == '__main__':
    DocumentRoot = "%s/htdocs/" % os.path.realpath(os.path.dirname(__file__))
    PORT = "8000"
    HOST = "localhost"

    try :
        main(sys.argv[1])
    except :
        main("%s:%s" % (HOST,PORT))

• DocumentRoot = Pega a pasta local que estamos e concatena com "/htdocs/"
• PORT = Porta padrão do servidor
• HOST = Host padrão do servidor

Temos uma TRY que vamos tratar o que vem por parâmetro (argv), caso ele tenha valores errados chamará o HOST/PORT declarado do software.

Rodando o servidor:

avelino@program-8:~/python/httpd$ python httpd.py *:8000
Start server HTTP IN *:8000

 

avelino@program-8:~/python/httpd$ python httpd.py localhost:8000
Start server HTTP IN localhost:8000
localhost - - [14/Sep/2010 09:42:05] "GET /index.html HTTP/1.1" 200 -
localhost - - [14/Sep/2010 09:42:54] "GET /index.html HTTP/1.1" 200 -
^CShutting down server HTTP
avelino@program-8:~/python/httpd$ 

Para apresentar o recurso, escolhi um modelo de cadastro de Newsletter com banco de dados MySQL, mas é possível utilizá-lo de diversas maneiras seja para cadastros, consultas ou exclusões.

Como havia dito, utilizaremos a biblioteca Jquery que pode ser encontrada no endereço http://jquery.com/. Para este artigo, utilizaremos a versão 1.4.2 min, porém qualquer versão a partir da 1.2 pode ser usada, já que todas contêm em seu núcleo a função Ajax. Salve o arquivo com o nome "jquery-1.4.2.min.js" na mesma pasta que irá salvar as outras páginas.

Agora iremos criar o banco de dados Msql. Abaixo segue a estrutura definida.

DROP DATABASE IF EXISTS `newsletter`;
CREATE DATABASE `newsletter`;
USE `newsletter`;

CREATE TABLE `newsletter` (
  `Id` int(11) NOT NULL auto_increment,
  `Nome` varchar(255) default NULL,
  `Email` varchar(255) default NULL,
  PRIMARY KEY  (`Id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

Com a base de dados pronta, iremos criar a página do formulário e posteriormente criaremos a página que recebe os dados e realiza o cadastro.

Página do formulário. Salve com o nome "Form_Newsletter.asp"

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Formulário de Cadastro</title>

<script type="text/javascript" src="jquery-1.4.2.min.js"></script>

<script>
        $(document).ready(function() { $("#button").click(function () {
        //Declarando as variaveis
                var Nome ="";
                var Email ="";          
                //Recuperando os dados e atribuindo as variaveis
                Nome = $("#Nome").val();
                Email = $("#Email").val(); 
        //Inicio da funcao
        $.ajax({
                //Metodo utilizado
                type: "POST",
                //Pagina que recebe os daods
                url: "Recebe_dados.asp",
                //String de dados enviada
                data: "Nome="+Nome+"&Email="+Email+"",
                //Inicio da funcao que requisita a resposta da pagina onde recebeu os dados
                success: function(msg){
                alert( "Sucesso! " + msg );
                        //Limpando os valores dos campos
                        $("#Nome").val('');
                                $("#Email").val(''); 

                                }
                        });             

                });
        });     
</script>

</head>

<body>
<p>Newsletter</p>

  <table width="280" border="0">
    <tr>
      <td>Nome:</td>
      <td><input type="text" name="Nome" id="Nome" /></td>
    </tr>
    <tr>
      <td>E-Mail:</td>
      <td><input type="text" name="Email" id="Email" /></td>
    </tr>
    <tr>
      <td> </td>
      <td><label>
        <input type="submit" name="button" id="button" value="Cadastrar" />
      </label></td>
    </tr>
  </table>

</body>
</html>

Na página acima, notamos a função "$.ajax" nessa área. É onde aplica o recurso que faz a chamada, transferindo os registros para a página de cadastro.

        $.ajax({
                //Metodo utilizado
                type: "POST",
                //Pagina que recebe os daods
                url: "Recebe_dados.asp",
                //String de dados enviada
                data: "Nome="+Nome+"&Email="+Email+"",
                //Inicio da funcao que requisita a resposta da pagina onde recebeu os dados
                success: function(msg){
                alert( "Sucesso! " + msg );
                        //Limpando os valores dos campos
                        $("#Nome").val('');
                                $("#Email").val(''); 

                                }
                        });

Página que realiza a inclusão dos dados enviados pela função acima.

Salve com o nome "Recebe_dados.asp".

<%
'Declarando a variavel de conexao
Dim Conexao
'Atribuindo o objeto a variavel de conexao
Set Conexao = Server.CreateObject("ADODB.Connection")
'String de conxao para base de dados Mysql
Conexao.ConnectionString = "driver={MySQL ODBC 5.1 Driver};server=localhost;uid=usuario;pwd=senha;database=newsletter"
'Abrindo a conexao
Conexao.Open

'Funcao para tratar as variaveis
Function Trata_Request(txt)

        entrada = replace(txt,"'","")

                Trata_Request=entrada   
        end Function

        'Recuperando as variaveis enviadas pelo metodo post
        Nome = Trata_Request(request.Form("Nome"))
        Email = Trata_Request(request.Form("Email"))

        'Instrucao SQL para inserir as variaveis
        set cadastra = Conexao.execute("INSERT INTO newsletter(nome,email) VALUES('"&Nome&"','"&Email&"')")
%>

Dados recebido com sucesso!

Ao receber os dados a página, mande uma resposta de ok e, com isso, é apresentada a informação que os dados foram cadastrados com sucesso.

Vimos neste artigo uma maneira de melhorar a usabilidade de um sistema de Newsletter que pode ser aplicado a outros sistemas, focando em uma melhor experiência dos usuários. Com os recursos atuais e com boas práticas, podemos economizar recursos de processamento ao transferir informações entre páginas.

O Quartz é um serviço de agendamento de tarefas que pode ser integrado, ou utilizado virtualmente, em qualquer aplicação Java SE ou Java EE. A ferramenta pode ser utilizada para criar agendas que executam milhares de tarefas, que são definidas utilizando componentes padrão da plataforma Java, que são codificados para suprir as necessidades da aplicação. O Quartz Scheduler fornece diversos recursos corporativos, como suporte a transações JTA ou clusterização.

O Scheduler é o componente principal do Quartz e é o responsável por gerenciar a execução de jobs. A partir dele, o desenvolvedor pode agendar, iniciar e parar as execuções. Para construir um Scheduler, deve-se utilizar uma classe que implementa o padrão de projeto Factory no Quartz, representado pela interface SchedulerFactory. Existem duas classes que implementam esta interface: StdSchedulerFactory eDirectSchedulerFactory. A primeira permite a utilização de um arquivo properties para configuração e a segunda implementa um segundo padrão de projeto: o Singleton.

Após obter um Scheduler, pode-se iniciar a execução do agendamento a partir do métodostart(), agendar novos jobs com o scheduleJob() e parar o agendador com o shutdown(). Ao se agendar um job com o método scheduleJob(), é necessário definir dois parâmetros:

• O primeiro define o job que será executado, representado pela interface Job;
• O segundo define o trigger, representado pela interface Trigger, que corresponde às condições de agendamento para execução do job em questão.

O que é um job?

Um job é uma tarefa a ser executada, que no Quartz nada mais é do que uma classe que implementa a interface Job e que agrega todo o código necessário para fazer a funcionalidade específica do job em questão. Ele pode, também, receber parâmetros para seu funcionamento correto e isso é feito a partir da classe JobDetail.

Ao implementar a interface Job, deve-se implementar também o método execute(), que recebe como parâmetro um JobExecutionContext e lança uma exceção do tipoJobExecutionException. Dentro do método execute() estará todo o código referente ao job em questão. Um exemplo de job é uma varredura automática de spams em um e-mail, ou, uma busca por tags duplicadas de um produto para limpeza em um banco de dados de algum comércio eletrônico.

Para a criação de um job, utiliza-se a classe JobBuilder, que define a classe do job implementado a partir do método newJob(), a identidade no método withIdentity() e a instanciação do mesmo no build().

O que é o trigger?

Um objeto trigger é utilizado para disparar a execução de jobs. Quando um job é agendado, a instância de um trigger é feita e suas propriedades são configuradas para satisfazer o agendamento necessário para a aplicação. Existem alguns triggers pré-definidos na biblioteca Quartz, como, por exemplo, o SimpleTrigger e o CronTrigger.

Para a construção de um trigger, é utilizada a classe TriggerBuild, que implementa métodos utilizando o Domain Specific Language (DSL) e permite a configuração dos dados do trigger, como, por exemplo, sua identidade, a partir do método withIdentity(); seus dados de agendamento, a partir do método withSchedule(), e a instanciação do trigger, a partir do método build(). Esse último retorna uma classe que implementa a interface Trigger.

O CronTrigger é um tipo de trigger que é útil para agendamentos baseados em calendários, como, por exemplo, “uma execução deve ocorrer às quartas e quintas às 12:00h” ou “uma execução deve ocorrer todos os dias às 08:00h”, e assim por diante. Ele é construído quando se define um agendamento do tipo CronSchedule no métodoTriggerBuild.withSchedule. Este tipo de agendamento é construído a partir do método estático cronSchedule da classe CronScheduleBuilder, que recebe como parâmetro uma expressão cron.

Para formar uma expressão cron, alguns requisitos devem ser satisfeitos. Primeiramente, deve-se conhecer a ordem dos parâmetros:

1. Segundos;
2. Minutos;
3. Horas;
4. Dia do mês;
5. Mês;
6. Dia da semana;
7. Ano (opcional).

Por exemplo, uma expressão cron que será executada todas às quartas-feiras às 12:00pm é escrita da seguinte forma: “0 0 12 ? * WED”. Outro exemplo de expressão demonstra uma tarefa executada todos os dias, às 08:00am e 12:00pm: “0 0 8,12 * * *”.

Exemplo

Para ilustrar todos os conceitos apresentados anteriormente, foi desenvolvido um exemplo simples, que simula a utilização de um CronTrigger e define um job customizado que implementa a interface Job. Ele será responsável por exibir uma mensagem de texto simples indicando que foi executado a cada dez segundos todos os dias. O código do job foi definido conforme a listagem abaixo:

public class MyJob implements Job {
    @Override
    public void execute(JobExecutionContext context)
            throws JobExecutionException {
        System.err.println("Servico executado conforme agendamento");
    }
} 

A classe principal que faz a execução deste job foi definida conforme a listagem a baixo:

public class Main {
    public static void main(String[] args) {
        try {
            SchedulerFactory schedFact = new StdSchedulerFactory();
            Scheduler sched = schedFact.getScheduler();
            sched.start();
            JobDetail job = JobBuilder.newJob(MyJob.class)
                .withIdentity("myJob", "group1")
                .build();
            Trigger trigger = TriggerBuilder
                .newTrigger()
                .withIdentity("myTrigger", "group1")
                .withSchedule(CronScheduleBuilder.cronSchedule("0/10 * * * * ?"))
                .build();
             sched.scheduleJob(job, trigger);
        } catch (Exception e) {
            System.out.println("erro");
            e.printStackTrace();
        }
    }
} 

Neste exemplo de código, obtem-se uma instância de Scheduler a partir da FactoryStdSchedulerFactory. O agendamento é iniciado, depois cria-se um novo job, do tipoMyJob, um novo CronTrigger que possui a expressão cron “0/10 * * * * ?”, que significa “a cada dez segundos”, e o job é agendado conforme o trigger criado.

Conclusão

Apesar de ser um exemplo simples, com ele é possível verificar o funcionamento de cada componente necessário para a execução de um job agendado, e a partir dele é possível ver sua aplicabilidade no cenário de alguma aplicação que tenha estas necessidades.

Referências

• http://quartz-scheduler.org/documentation/quartz-2.1.x/;
• http://adminschoice.com/crontab-quick-reference.