|
1 | 1 | # SimpleSQL |
2 | 2 |
|
3 | | -Essa Biblioteca tem como maior função faciliar o uso do SQLite para o android. |
4 | | - |
5 | | -Agora vamos mostrar passo a passo de como usar: |
6 | | - |
7 | | -### Passo 1: Criar uma classe herdando SQLiteOpenHelper |
8 | | - |
9 | | -```JAVA |
10 | | -public class HelperBD extends SQLiteOpenHelper { |
11 | | - static final int DATABASE_VERSION = 1; |
12 | | - static final String DATABASE_NAME = "example.db"; |
13 | | - Context context; |
14 | | - |
15 | | - public HelperBD(Context context) { |
16 | | - super(context, DATABASE_NAME, null, DATABASE_VERSION); |
17 | | - this.context = context; |
18 | | - } |
19 | | - |
20 | | - @Override |
21 | | - public void onCreate(SQLiteDatabase sqLiteDatabase) { |
| 3 | +Essa Biblioteca tem como maior função facilitar o uso do SQLite para o android. |
| 4 | + |
| 5 | +Agora vamos mostrar o passo a passo de como utilizar: |
| 6 | +### Versões |
| 7 | +<a href="">v1.0.0</a> |
| 8 | +<a href="">v1.0.1</a> |
| 9 | +<a href="">v1.0.2</a> |
| 10 | +<a href="">v1.0.3</a> |
| 11 | +<a href="">v1.0.4</a> |
| 12 | +<a href="">v1.0.5</a> |
| 13 | + |
| 14 | +### Importando a lib para o projeto: |
| 15 | +```groovy |
| 16 | +implementation 'com.github.p2jorg:simplesql:1.0.5' |
| 17 | +``` |
| 18 | +##### *Observação - Caso você não tenha o JitPack, adicione em seu module project a linha de código com o comentário: |
| 19 | +```groovy |
| 20 | +allprojects { |
| 21 | + repositories { |
| 22 | + google() |
| 23 | + jcenter() |
| 24 | + maven { url "https://jitpack.io" } // JitPack |
22 | 25 | |
23 | 26 | } |
24 | | - |
25 | | - @Override |
26 | | - public void onUpgrade(SQLiteDatabase sqLiteDatabase, int i, int i1) |
27 | | - onCreate(sqLiteDatabase); |
28 | | - } |
29 | | - |
30 | | - @Override |
31 | | - public void onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion) { |
32 | | - super.onDowngrade(db, oldVersion, newVersion); |
33 | | - onUpgrade(db, oldVersion, newVersion); |
34 | | - } |
35 | 27 | } |
36 | 28 | ``` |
37 | | - |
38 | | -### Passo 2: Crie sua classe modelo |
39 | | - |
40 | | -<blockquote> |
41 | | - <p> |
42 | | - Preferimos usar a própria classe que vai servir pra passar os dados |
43 | | - </p> |
44 | | -</blockquote> |
45 | | - |
| 29 | +### Passo 1: Crie sua classe modelo |
| 30 | + Utilizando a biblioteca, a sua classe modelo também é a sua tabela de banco de dados, |
| 31 | + basta você utilizar as anotações necessárias para que as duas se tornem uma só. |
46 | 32 | ```JAVA |
47 | 33 | @Table |
48 | 34 | public class Pessoa { |
@@ -86,70 +72,99 @@ public class Pessoa { |
86 | 72 |
|
87 | 73 | ``` |
88 | 74 |
|
89 | | -### Passo 3: Crie sua Tabela |
| 75 | +### Passo 2: Criar uma classe herdando SQLiteOpenHelper |
| 76 | +O Processo inicial de criar um banco de dados continua o mesmo, porém, como já foi visto anteriormente, a sua tabela já foi criada, então o que você precisar fazer é apenas chamar o um método da classe SimpleSQL dentro do método onCreate(SQLiteDatabase sqlLiteDatabase) |
90 | 77 |
|
91 | 78 | ```JAVA |
| 79 | +public class HelperBD extends SQLiteOpenHelper { |
| 80 | + private static final int DATABASE_VERSION = 1; |
| 81 | + private static final String DATABASE_NAME = "example.db"; |
| 82 | + Context context; |
| 83 | + private SimpleSQL simpleSQL; |
| 84 | + |
| 85 | + public HelperBD(Context context) { |
| 86 | + super(context, DATABASE_NAME, null, DATABASE_VERSION); |
| 87 | + this.context = context; |
| 88 | + simpleSQL = new SimpleSQL(this); |
| 89 | + } |
| 90 | + |
| 91 | + @Override |
| 92 | + public void onCreate(SQLiteDatabase sqLiteDatabase) { |
| 93 | + String _return = simpleSQL.create(new Pessoa(),db); |
| 94 | + } |
| 95 | + |
| 96 | + @Override |
| 97 | + public void onUpgrade(SQLiteDatabase db, int i, int i1) { |
| 98 | + String _return = simpleSQL.deleteTable(new Pessoa(),db); |
| 99 | + onCreate(db); |
| 100 | + } |
| 101 | + |
| 102 | + @Override |
| 103 | + public void onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion) { |
| 104 | + super.onDowngrade(db, oldVersion, newVersion); |
| 105 | + onUpgrade(db, oldVersion, newVersion); |
| 106 | + } |
| 107 | +} |
| 108 | +``` |
| 109 | +### Deletar a tabela |
| 110 | + ```JAVA |
92 | 111 | @Override |
93 | | -public void onCreate(SQLiteDatabase sqLiteDatabase) { |
94 | | - try { |
95 | | - sqLiteDatabase.execSQL(SampleSQL.create(new Pessoa())); |
96 | | - } catch (Exception e) { |
97 | | - e.printStackTrace(); |
98 | | - } |
| 112 | +public void onUpgrade(SQLiteDatabase sqLiteDatabase, int i, int i1) { |
| 113 | + String _return = simpleSQL.deleteTable(new Pessoa(),db); |
| 114 | + onCreate(sqLiteDatabase); |
99 | 115 | } |
100 | 116 | ``` |
101 | | - |
102 | | -### Exemplo de como inserir dados na sua Tabela |
103 | | - |
| 117 | +### INSERT |
| 118 | +O método insert() irá retornar um valor booleano, onde true é quando for inserido com sucesso e false quando ocorrer algum erro |
104 | 119 | ```JAVA |
105 | 120 | Pessoa p = new Pessoa(); |
106 | 121 | p.setNome("Alow"); |
107 | 122 | p.setIdade(12); |
108 | 123 | boolean result = false; |
109 | | -try { |
110 | | - result = new SampleSQL(new HelperBD(this)).insert(p); |
111 | | -} catch (Throwable throwable) { |
112 | | - throwable.printStackTrace(); |
113 | | -} |
| 124 | +result = new SimpleSQL(new HelperBD(this)).insert(p); |
114 | 125 | ``` |
115 | 126 |
|
116 | | -### Exemplo de como lista os dados da usa Tabela |
117 | | - |
118 | | -```JAVA |
119 | | -SampleSQL sampleSql = new SampleSQL(new HelperBD(this)); |
120 | | -List<Pessoa> pessoa2 = sampleSql.selectTable(new Pessoa()) |
121 | | - .where() |
122 | | - .equals() |
123 | | - .fields(new String[]{"*"}) |
124 | | - .execute(); |
125 | | -``` |
126 | | - |
127 | | -### Caso seja necessário atualizar o banco, faça da seguinte forma: |
128 | | - |
129 | | -<blockquote> |
130 | | - <p> |
131 | | - Atualizar a versão do Banco |
132 | | - </p> |
133 | | -</blockquote> |
134 | | - |
| 127 | +### SELECT |
| 128 | +Para fazer uma listagem dos registro do banco de dados é bem simples, é só criar ua instancia da classe SimpleSQL e utilizar o método selectTable(Objeto) e montar o select da forma que preferir. |
135 | 129 | ```JAVA |
136 | | -static final int DATABASE_VERSION = 2; |
| 130 | +SimpleSQL simpleSql = new SimpleSQL(new HelperBD(this)); |
| 131 | + |
| 132 | +List<Pessoa> list = simpleSQL.selectTable(new Pessoa()) |
| 133 | + .fields(new String[]{"*"}) |
| 134 | + .where() |
| 135 | + .collumn("id") |
| 136 | + .equals() |
| 137 | + .fieldInt(1) |
| 138 | + .execute(); |
| 139 | + |
137 | 140 | ``` |
| 141 | +### DELETE |
| 142 | +Para remover algum registro da tabela, ainda segue o mesmo padrão dos métodos anteriores |
| 143 | +```JAVA |
| 144 | +boolean result = simpleSQL.deleteColumn(new Pessoa()) |
| 145 | + .where() |
| 146 | + .column("id") |
| 147 | + .equals() |
| 148 | + .fieldInt(1) |
| 149 | + .execute(); |
138 | 150 |
|
139 | | -<blockquote> |
140 | | - <p> |
141 | | - Deletar sua tabela para ela possa receber ou remover algum dado |
142 | | - </p> |
143 | | -</blockquote> |
144 | | - |
| 151 | +``` |
| 152 | +### UPDATE |
| 153 | +Ainda utilizando o mesmo padrão dos anteriores você também pode atualizar os registro do banco de dados, da seguinte forma: |
145 | 154 | ```JAVA |
146 | | -@Override |
147 | | -public void onUpgrade(SQLiteDatabase sqLiteDatabase, int i, int i1) { |
148 | | - try { |
149 | | - SampleSQL.deleteTable(new Pessoa()); |
150 | | - } catch (SQLException e) { |
151 | | - e.printStackTrace(); |
152 | | - } |
153 | | - onCreate(sqLiteDatabase); |
154 | | -} |
| 155 | +SimpleSQL simpleSql = new SimpleSQL(new HelperBD(this)); |
| 156 | +boolean result = simpleSQL.updateTable(new Pessoa()) |
| 157 | + .set(new String[]{"nome","idade"}) |
| 158 | + .values(new String[]{"Novo Nome","Nova Idade"}) |
| 159 | + .where() |
| 160 | + .collumn("id") |
| 161 | + .equals() |
| 162 | + .fieldInt(1) |
| 163 | + .execute() |
| 164 | + |
155 | 165 | ``` |
| 166 | + |
| 167 | +# Desenvolvedores |
| 168 | +<a href="https://github.com/PauloYR">Paulo Iury<a> |
| 169 | +<a href="https://github.com/LukNasc">Lucas Nascimento<a> |
| 170 | +<a href="https://github.com/jisellevms">Jiselle Martins<a> |
0 commit comments