sábado, 21 de fevereiro de 2009

db4o (parte 4) – NQ: Native Queires

Native Query, ou NQ para os íntimos, é a principal interface para realização de queries no db40. As NQs do db4o tem o mesmo apelo que a linguagem LINQ do .NET Framework possuí: criar queries usando a própria linguagem gerenciada.

Eu sou fã incondicional da linguagem LINQ, e como veremos em POSTs futuros o próprio db4o tem suporte para o LINQ, o que torna as NQs a minha segunda opção para queries neste database.

Porém é importante vermos como as NQs funcionam, e é isso que veremos aqui. Se você quiser entender mais a fundo os conceitos e princípios por trás das NQs, sugiro a leitura dos seguintes artigos:

Seguindo a nossa linha de exemplos que acessa o database algoritma.yap e consulta os objetos da classe Country, veja como fica na listagem abaixo uma query que retorna todos os países com população maior que 100 milhões, usando NQ:



Note que em C# uma NQ é feita com o uso de um delegate, e retorna um lista genérica. Assim como o LINQ, uma NQ tem o benefício da tipagem forte, o que facilita a criação da query para o desenvolvedor. Veja na Figura abaixo o resultado da execução do código acima:


É inegável que esta é uma forma muito eficiente de se construir queries, principalmente as complexas. Veja, por exemplo, que na listagem a seguir temos uma condição que seria impossível de se realizar usando QBE (Query By Examplo visto no post anterior).


Essa query deve retornar todos os países que tenham população entre 100 e 200 milhões, e que também contenham a letra “a” no nome. Pode parecer uma pesquisa inútil, mas ilustra bem o grau de complexidade que podemos atingir com as NQs. O resultado da execução desta Query você vê na figura a seguir:


O efeito colateral das NQs pode ser a baixa performance. Por debaixo dos panos, o db4o vai analisar as NQs e convertê-las em queries SODA (que veremos em detalhes no próximo POST). Isso é claro, deve variar conforme a complexidade das queries.

Além das NQs e QBEs, ainda temos outras duas formas possíveis de se realizar queries no db4o. A API Soda e a linguagem LINQ, que veremos nos próximos dois posts.

Grande Abraço e até o próximo!

domingo, 15 de fevereiro de 2009

db4o (parte 3) – QBE: Query-By-Example

O db4o oferece quatro formas diferentes de se realizar queries: Query By Example (QBE), Native Queries (NQ), SODA API e LINQ. Neste POST veremos como funciona o QBE.

Query-By-Example, ou simplesmente QBE é a forma mais simples e indicada para usuários que estão iniciando com o db4o. Este é um conceito de construção de queries antigo, que foi criado em paralelo com a linguagem SQL nos anos 70.

A idéia é criar um protótipo que servirá de exemplo para os registros que devem ser retornados pela pesquisa. Este tipo de query é muito comum na orientação a objetos. Se quiser conhecer mais sobre o conceito, dê uma olhada neste artigo publicado no Wikipédia: http://en.wikipedia.org/wiki/Query_by_Example

No db4o quando você usa o QBE, deve fornecer como parâmetro um objeto de template. O db4o irá retornar todos os objetos que tiverem as propriedades iguais aos do objeto template, ignorando apenas as propriedades que contiverem valores defaults.

Fazendo uma consulta na base de dados criada no POST anterior, veja o exemplo abaixo:


Neste exemplo estamos executando uma Query By Example, passando “como exemplo” um objeto da classe Country que possuí a propriedade ID = “BR”. O valor null para strings e o zero para inteiros, são considerados valores defaults, e portanto essas propriedades não entram como condição para esta pesquisa. Sendo assim, o resultado dessa query irá retornar apenas o país Brasil, veja na imagem abaixo:


Obviamente esse tipo de Query é bastante limitado, já que restringe as nossas possibilidades de pesquisa a retornar apenas objetos que tenham as propriedades iguais às do objeto template. Além disso, você não pode utilizar operadores lógicos como OR, AND ou NOT. Porém, é uma forma muito útil e fácil de pesquisar um determinado objeto, através de propriedades chaves, como um ID.

O QBE também pode ser utilizado como uma forma simples e rápida de retornar todos os objetos de uma determinada classe, veja o exemplo do código abaixo:


O resultado é a lista de todos os países armazenados no database. Veja na figura a seguir:


Como disse no início, essa é uma forma bem simples para realizar consultas no db4o, e indicada quando estamos iniciando. No próximo POST veremos como funcionam as Native Queries (NQ), para principalmente endereçar tipos de pesquisa não suportados pelo QBE.

Grande Abraço e até o próximo!

domingo, 8 de fevereiro de 2009

db4o – CRUD (parte 2)

Vamos agora ver como criar o nosso primeiro banco de dados no db40, e como realizar as quatro operações básicas de qualquer banco de dados: Inclusão, Alteração, Exclusão e Consulta (CRUD = Create, Read, Update e Delete).

A primeira coisa que fazemos quando vamos criar um banco de dados é definir a sua estrutura. Porém aqui estamos falando de um banco de dados orientado a objetos, e não um database relacional como o SQL Server ou Oracle.

A primeira coisa que você tem que saber sobre os databases OO é que a estrutura de dados é definida através de Classes e não de Tabelas. Na prática, o que temos que fazer é criar nossas classes em C#, no próprio Visual Studio.

Vou começar com um exemplo muito simples, porém preparado para comportar os exemplos mais avançados que veremos nos posts futuros. Sendo assim, criei no Visual Studio uma Solution chamada Algoritma, e dentro dessa solution adicionei um projeto do tipo Class Library, chamado Algoritma.Model. Será aqui que iremos criar as classes que definirão a estrutura de dados do nosso database.

Você pode criar suas classes usando o diagrama de classes do Visual Studio. Com ele o processo de modelagem fica bem mais simples e prático. Veja na imagem abaixo que eu criei uma classe chamada Country.



Através do Diagrama do Visual Studio nós podemos criar a nossa estrutura de classes, porém não vamos fugir de por a mão no código, para fazer alguns ajustes nestas classes. Sendo assim, edite a classe Country.cs para que fique como mostra o código abaixo:



Note que criamos três propriedades simples, que irão armazenar o ID do país, que será uma simples sigla, o Nome e um inteiro que irá representar a população daquele país. Em seguida temos um construtor simples que apenas inicializa as propriedades do objeto que está sendo instanciado.

Mais abaixo temos outros dois métodos. O AddPopulation() que simplesmente adiciona valores à População. Não tem um objetivo muito prático, mas vai nos ajudar a entender que apesar de estarmos falando de armazenamento, podemos definir métodos nas nossas classes.

E por fim o método ToString(), que foi sobrecarregado da classe Objects, e aqui irá retornar uma string que exibe todas as propriedades do país.

A princípio essa será a única classe que iremos criar. Veremos agora como criar um banco de dados no db4o e armazenar instancias da classe Country nele.

Antes disso você deve ter observado que até agora não utilizamos nenhum recurso do db4o. Esse é um diferencial importante, pois podemos definir nossas classes da maneira que quisermos, e o db4o se encarregará de armazenar os objetos no database.

Para criarmos nosso banco de dados no db40, vamos adicionar um novo projeto na Solution, agora do tipo Console Application. Neste exemplo eu criei um projeto chamado Algoritma.ConsoleApp.

De cara, neste projeto devemos adicionar duas referencias. Uma referencia ao projeto Algoritma.Model, para que possamos ter acesso à nossa classe Country. E uma referencia à DLL Db4objects.Db4o.dll, que como foi dito no post anterior, é a DLL principal do db4o. Essa DLL você provavelmente irá encontrar no seguinte caminho: C:\Program Files\Db4objects\db4o-7.4\bin\net-3.5.

Com as duas referências criadas, vamos agora ao processo de criação e abertura do banco de dados, que nada mais é do que uma simples linha de código na classe Program.cs, veja a seguir:



Como você pode notar estamos criando uma instancia da interface IObjectContainer, através do método estático OpenFile() da classe Db4oFactory. Veja que este método aponta para um arquivo com extensão .yap. Esta é a extensão dos databases do db4o, que neste caso foi nomeado como Algoritma.yap. Caso o arquivo não exista, ele será criado e aberto, caso exista será apenas aberto.

Em seguida temos uma estrutura try/finally que irá garantir que o database seja devidamente fechado assim que terminarmos de utilizá-lo.

Muito bem, com isso já podemos fazer nossos primeiros testes CRUD. Comecemos com um método de inclusão. Basta incluir o método do código abaixo e fazer a sua chamada no método Main, conforme você vê na própria listagem a seguir:




O Método InsetCountries está criando 3 instancias da classe Country, e armazenando-as no database através do método Store() que temos no IObjectContainer. Note que ao final estamos chamando o método Commit(). Este método está implicitamente concluindo a transação. A partir do momento em que abrimos o database, já estamos em uma transação. E após a chamada do método Commit() a transação atual foi concluída, e outra iniciada.

Execute sua aplicação e veja que os países são inclusos e exibidos na Console. Confira na Figura abaixo.



De tão simples parece estranho não é? Parece que não aconteceu nada, que estes objetos estão apenas na memória, e que ao finalizar a aplicação eles vão ser perdidos. Mas não, eles foram gravados em disco, lá no arquivo Algoritma.yap, e portanto estão armazenados no database db4o.

Vamos à prova. Voltando ao código da classe Program.cs, inclua agora o método SelectCountries conforme mostra o código abaixo, e no método Main(), substitua a chamada do método InsertCountries(), pelo SelectCountries().



Note que estamos fazendo uma consulta que irá retornar um IList contendo dos os objetos da classe Country que existirem no database. Essa é uma das diversas formas que existem para a realização de queries no db40. Veremos no decorrer dos exemplos outras formas.

Execute a aplicação e veja como mostra a imagem abaixo, que é exibido o total de países cadastrados, juntamente com os dados detalhados de cada país.



Abaixo temos o método UpdateCountry, que como você pode ver está realizando um outro tipo de pesquisa, utilizando o padrão QBE. QBE quer dizer Query By Example, ou “Consulta por Exemplo”. Isso significa que o db4o deverá nos retornar todos os objetos armazenados que forem iguais ao do exemplo passado no parâmetro.



A condição é realizada ignorando as propriedades definidas como null, ou zero no caso do inteiro. Com isso estamos recuperando apenas um objeto, no caso o com o ID igual a “FR”.

Com o objeto recuperado do database, podemos fazer a alteração que desejarmos e salvarmos essa alteração através do mesmo método Store(). Veja o resultado da execução deste código na figura a seguir:



Para finalizar segue o código do método DeleteCountry, que também usa QBE para recuperar o país US do database, e excluí-lo do banco.



O resultado da execução deste método você confere na figura abaixo:



Este foi apenas um exemplo básico de como criar um database db4o e realizar as operações mais simples com ele.

Mas aqui nós já podemos ver que o processo de gravação e recuperação dos dados é muito simples, bem mais simples do que estamos acostumados em ambientes de mapeamento objeto / relacional. Veremos muito mais facilidades nos próximos exemplos.

Nos próximos POSTs iremos ver quais são as principais formas de realizar Queries com o db40. Grande Abraço e até lá!

segunda-feira, 2 de fevereiro de 2009

db4o – Baixando e instalando (parte 1)

Caso ainda não tenha lido, sugiro que leia o post anterior para que saiba sobre o que vamos ver na seqüência de posts que começo hoje.

Começaremos com o download e instalação do db4o nesta parte 1. Nas partes seguintes iremos ver desde recursos básicos até avançados, deste banco de dados orientado a objetos.

A primeira coisa que você deve fazer para iniciar o uso do db4o é o seu download no site da comunidade de desenvolvedores:
http://developer.db4o.com/. Como você pode ver na figura abaixo, o download pode ser feito logo na primeira página, no canto direito.



Note que existem duas versões para a plataforma .NET. Uma para .NET 2.0 e a outra para o .NET 3.5. Vamos fazer o download e instalação da versão 7.4 do db4o para .NET 3.5.

O download é simples e rápido, e ao seu final basta executar o pacote db4o-7.4-net35.msi, para iniciar a instalação do db4o em seu computador.

A instalação também é extremamente simples, pode aplicar a técnica NNF que não tem erro. (NNF = Next - Next – Finish). Só peço a sua atenção para a segunda tela do Wizard de instalação, que você vê na figura a seguir:



Aqui você pode ver o diretório onde o db4o vai ser instalado, e também pode modificar esse caminho se quiser. A importância de saber onde o db4o vai ser instalado, é que para utilizá-lo em nossos projetos .NET, precisaremos apontar para as DLLs que estarão aqui.

Com isso você pode notar que a instalação do db4o é praticamente uma simples descompactação. Nada é registrado em GAC ou nos registros do Windows. Essa é uma característica que eu particularmente gosto, pois torna o uso e principalmente a distribuição muito mais fácil e portável.

Terminada a instalação, abra o Windows Explorer e vá até o diretório onde o db4o foi instalado na sua máquina. Veja na parte esquerda da figura abaixo, a estrutura de diretórios criada:



Note que temos três pastas principais aqui:

~\Db4objects\dv4o-7.4\src\ é onde você vai encontrar todo o código fonte do db40. Sim, você já tem acesso ao código fonte da ferramenta.

~\Db4objects\dv4o-7.4\doc\ uma vasta documentação para que você possa dar os primeiros passos com o db4o. A maioria dos exemplos que você verá neste blog será adaptada dessa documentação.

~\Db4objects\dv4o-7.4\bin\ é onde encontramos os binários para o .net 3.5 e compact framework. Note na figura acima, que a DLL Db4objects.Db40.dll está em destaque. Esta será a DLL que mais iremos utilizar para por em prática os exemplos do db4o.

Outra observação importante é que ao término da instalação, você teve a opção de iniciar o tutorial que vem junto com o db40. Esse tutorial também pode ser acessado pelo menu iniciar, na pasta db4objects.

O tutorial é bem interessante e nele encontramos as principais funcionalidades do db4o. Ele usa um exemplo bastante simples e didático de Pilotos e Carros de Fórmula 1. Os exemplos que veremos nos próximos posts serão baseados neste tutorial. Espero você aqui no próximo post.

Grande Abraço!