@desco/json-to-sql-where

Transforms a JSON in SQL conditions

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
@desco/json-to-sql-where
002.1.32 years ago4 years agoMinified + gzip package size for @desco/json-to-sql-where in KB

Readme

<td><img src="https://i.ibb.co/qCk0rmM/json-to-sql-where.png"></td>
<td>  
<h1>@desco/json-to-sql-where</h1>
Converte dados em um JSON para uma condição "WHERE" SQL.
<br /><br />
<div align="center">
<img alt="Licença MIT" src="https://img.shields.io/static/v1?label=Licença&message=MIT&color=green&style=for-the-badge">
<img alt="Versão 2.1.3" src="https://img.shields.io/static/v1?label=Versão&message=2.1.3&color=blue&style=for-the-badge">
</div>
<h4 align="center"> 
🚀 Pronto para uso! 🚀
</h4>
</td>
Veja outros projetos NPM aqui.
Veja outros projetos aqui.
---

📋 Tabela de conteúdos

---

⚙️ Instalação

```bash npm install --save @desco/json-to-sql-where ```
Note que será necessário ter o NPM instalado para o comando funcionar.
---

📦 Importação

Node

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

Browse

```js 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: ```js 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: ```js 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: ```js 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: ```js 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: ```js 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: ```js 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

<td width="150px">
<img src="https://scontent.fsdu1-1.fna.fbcdn.net/v/t1.0-9/539886_235546170253505_5977326689811409130_n.jpg?_nc_cat=106&ccb=3&_nc_sid=174925&_nc_eui2=AeGgFWn_fWInwRkTo3mHSP993TbQ0TzG0Y3dNtDRPMbRjS-eZL1tr4I5maqz6O-jva9qWnIxKOsD3UtSm9CTeCys&_nc_ohc=Qw6NaDGrtIgAX9uFF2c&_nc_ht=scontent.fsdu1-1.fna&oh=5ebac9874d7a24e157c8c99fd965c2a4&oe=606539CE" width="100px;" alt=""/>
<b>Rafael A. R. Dias</b>
</td>
<td>  
<a href="mailto:eu@diasrafael.com.br" target="_blank" >
<img alt="Email eu@diasrafael.com.br" src="https://img.shields.io/static/v1?label=Email&message=eu@diasrafael.com.br&color=red&logo=gmail&style=for-the-badge">
</a>
<a href="https://www.linkedin.com/in/diasrafael/" target="_blank">
<img alt="Linkedin @diasrafael" src="https://img.shields.io/static/v1?label=Linkedin&message=@diasrafael&color=blue&logo=linkedin&style=for-the-badge">
</a>
<a href="https://www.facebook.com/eudiasrafael" target="_blank">
<img alt="Facebook @eudiasrafael" src="https://img.shields.io/static/v1?label=Facebook&message=@eudiasrafael&color=blue&logo=facebook&style=for-the-badge">
</a>
<a href="https://github.com/descodifica" target="_blank">
<img alt="GitHub Overview @descodifica" src="https://img.shields.io/static/v1?label=GitHub Overview&message=@descodifica&color=black&logo=github&style=for-the-badge">
</a>
<a href="https://github.com/desco-npm" target="_blank">
<img alt="GitHub NPM @desco-npm" src="https://img.shields.io/static/v1?label=GitHub NPM&message=@desco-npm&color=black&logo=github&style=for-the-badge">
</a>
<a href="https://www.npmjs.com/org/desco" target="_blank">
<img alt="NPM @desco" src="https://img.shields.io/static/v1?label=NPM&message=@desco&color=red&logo=npm&style=for-the-badge">
</a>
</td>