Introdução

A idéia do IQuery é baseada na ferramenta LINQ. A idéia por traz do LINQ é trazer os comandos de consulta ao banco de dados para a linguagem. Comandos SQLs são armazenados em Strings, não fazem parte da linguagem.

Estrutura básica da sintaxe

Há dois tipos de métodos no IQuery(): Os métodos declarativos e os de processamento. Os métodos declarativos servem para montar a consulta e os executivos servem para executar alguma operação com o IQuery, como por exemplo executar a consulta.
Os métodos declarativos básicos mais usados no IQuery são .from(), .where() e .column(). Veja o exemplo abaixo:

Há também outros métodos declarativos menos usados. São eles: o innerJoin() e o leftOuterJoin(). Veremos alguns exemplos sobre o uso deles. Voltando ao exemplo acima, falta falar sobre os parâmetros dos métodos .where() e .column().

O método .where()

O método .where() é usado para aplicar filtros na consulta do IQuery. Este método recebe um único parâmetro que é um objeto literal ou um array. Vamos direto ao exemplo para ficar mais claro.

Suponhamos que você deseja fazer o seguinte filtro:

Você deverá usar o método .where() da seguinte forma:

No exemplo acima foi passado um objeto literal como parâmetro do método .where(). Vejamos agora o caso em que será necessário passar um vetor invés de um objeto literal.
Suponhamos que agora você deseje fazer um filtro com dois ou mais campos. Algo assim:

Você deverá usar o método .where() da seguinte forma:

Note que só pelo fato de ter colocar o valor null no terceiro filtro, o SQL correspondente será gerado com is Null. Então conclui-se que o IQuery pode mudar a cláusula where do comando SQL gerado de acordo com o valor passado para o filtro.
Vejamos o que acontece quando passamos um vetor ou uma instância do objeto IQuery como valor de filtro:

Passando o vetor para o filtro

O SQL correspondente será algo assim:

Passando um outro IQuery para o filtro

O SQL do where gerado pelo IQuery pedidos será algo assim:

O método .column()

Assim como o método .where(), este método também recebe um único parâmetro que é um objeto literal ou um vetor de objetos literais. Vamos aos exemplos:

Se usar um único objeto literal como parâmetro

Será gerado


Agora se usar um vetor de objetos literais

Será gerado

Usando alias e coalesce


O código acima gera algo assim:

Conclusão

Esta é apenas uma visão geral do que o IQuery pode fazer. Não deixe de ler também os exemplos do uso do IQuery. Lá mostra, por exemplo, o código IQuery de como usar os métodos innerJoin() e leftOuterJoin() que não foram contemplados neste artigo.