@desco/json-to-sql-where

Transforms a JSON in SQL conditions

Usage no npm install needed!

<script type="module">
  import descoJsonToSqlWhere from 'https://cdn.skypack.dev/@desco/json-to-sql-where';
</script>

README

@desco/json-to-sql-where

Converte dados em um JSON para uma condição "WHERE" SQL.

Licença MIT Versão 2.1.3

🚀 Pronto para uso! 🚀

Veja outros projetos NPM aqui.

Veja outros projetos aqui.


📋 Tabela de conteúdos


⚙️ Instalação

npm install --save @desco/json-to-sql-where

Note que será necessário ter o NPM instalado para o comando funcionar.


📦 Importação

Node

const jsonToSqlWhere = require('@desco/json-to-sql-where')

Browse

import jsonToSqlWhere from '@desco/json-to-sql-where'

📚 Como Usar

AND somente

Vamos começar pelo uso mais simples possível, uma situação onde desejamos apenas verificar se colunas são iguais a valores:

jsonToSqlWhere({ nome: 'Rafael Dias', nascimento: '03/07/1986', }) // `nome = "Rafael Dias" AND nascimento = "03/07/1986"`

Neste caso simples, basta criarmos um JSON contendo pares de coluna/valor que o pacote irá automaticamente comverter tudo com o operador AND.

Mais Operadores Condicionais (AND, OR e XOR)

Mas não só de AND é feito uma uma SQL, não é mesmo?

Também podemos utilizar os operadores condicionais OR e XOR simplesmente agrupando no nosso JSON, veja:

const result2 = jsonToSqlWhere({
  AND: { nome: 'Rafael Dias', nascimento: '03/07/1986', },
  OR: { pais: 'Brasil', genero: 'M', },
  XOR: { signo: 'Câncer', idade: 34, },
}) // (nome = "Rafael Dias" AND nascimento = "03/07/1986")  AND  (pais = "Brasil" OR genero = "M")  AND  (signo = "Câncer" XOR idade = 34) 

Note que desta forma, cada um dos operadores foi agrupado entre parênteses.

Operador condicional dentro de operador condicional

Já vimos como utilizar outros operadores condicionais, porém ainda não conseguimos misturar eles...

Ainda! Nada nos impede de criar um agrupamento de operadores condicionais dentro de outro agrupamento, veja:

jsonToSqlWhere({
  OR: {
    idade: 34,
    nome: 'Rafael Dias',
    AND: {
      signo: 'Câncer',
      nascimento: '03/07/1986',
    },
  },
}) // (idade = 34 OR nome = "Rafael Dias" OR  (signo = "Câncer" AND nascimento = "03/07/1986") )

Dessa forma definimos operador condicional OR e dentro dele um subconjunto com operador condicional AND!

Tipos

Até aqui vimos como montar nossas condições com os operadores condicionais, porém apenas eles não são capazes de nos dar toda a dinâmica necessária.

Para isso precisaos ser capazes de utilizar os operadores comuns também, tais como =, !=, e etc. Para isso, podemos transformar nossos valores em objetos mais detalhados, veja:

jsonToSqlWhere({
  nome: { type: '=', value: 'Rafael Dias', },
  signo: { type: '!=', value: 'Gêmeos', },
  idade: { type: '>=', value: '18', },
}) // nome = "Rafael Dias" AND signo != "Gêmeos" AND idade >= 18

Básicamente você pode por em type absolutamente qualquer coisa queira no lugar do símbolo de igual, além disso você também pode trocar por alguns valores pré-estabelecidos para fazer uso de recursos do MySQL.

Por exemplo, se você deseja verificar se um valor esta entre dois outros valores, podemos utilizar o BETWEEN:

jsonToSqlWhere({
  idade: { type: 'BETWEEN', value: [ 9, 34, ], },
}) // idade BETWEEN 9 AND 34

Note que neste caso, o valor informado precisa ser um Array contendo o menor e maior valor respectivamente.

Também pode desejar verificar se um valor consta em uma lista de valores, para isso usamos o IN, veja:

jsonToSqlWhere({
  plataforma: {
    type: 'IN',
    value: [ 'Origin', 'Steam', 'XBox', 'PS', 'Mobile', ],
  },
}) // plataforma IN ("Origin","Steam","XBox","PS","Mobile")

Note que neste caso o valor deve ser um Array contendo todos os valores possíveis.

Autor

Rafael A. R. Dias Email eu@diasrafael.com.br Linkedin @diasrafael Facebook @eudiasrafael GitHub Overview @descodifica GitHub NPM @desco-npm NPM @desco