Framework to Nodejs
npm install kndjavascript
'use strict';
const core = require('knd').core;
let obj = new knd.KndObject();
console.log(obj.toString())
//Resultado console.log
// KndObject
`
------------
1.2. Collection
Neste Tópico:
- Descrição
- Exemplo de uso
Descrição
Classe genérica para todos os tipos de coleções
Exemplo de uso
`javascript
'use strict';
const core = require('knd').core;
let colection = new core.Collection();
colection
.add(1).add(2)
.add('a').add('b')
.add({ id: 1, desc: 'teste'});
console.log(colection.toString());
// Resultado do console.log
// [Collection items: 5]
for(let item of colection) {
console.log(item);
}
// Resultado do console.log
// 1
// 2
// a
// b
// { id: 1, desc: "teste" }
`
------------
1.3. Log
Neste Tópico:
- Descrição
- Exemplo de uso
Descrição
Classe estática para geração de logs, tanto no console log quanto em um arquivo de texto. Está classe, além de mostrar log no console, também criará uma pasta chamada logs onde irá criar um arquivo log.txt, que também gravará as mensagens.
Obs.: Para configurar o caminho onde a classe criará a pasta de logs pode ser configurada no objeto global, conforme demonstrado abaixo. Caso o caminho não seja configurado, classe criará a pasta no local do onde a classe se encontra.
`javascript
global.rootApp = 'c:\temp';
`
Exemplo de uso
`javascript
'use strict';
const core = require('knd').core;
const Log = core.Log;
Log.message('Minha mensagem 1');
Log.info('Minha mensagem 2');
Log.error('Minha mensagem 3');
Log.warning('Minha mensagem 4');
// Resultado do console.log
// 20/03/2018 17:44:36 - Minha mensagem 1
// 20/03/2018 17:44:36 - Informação: Minha mensagem 2
// 20/03/2018 17:44:36 - Erro: Minha mensagem 3
// 20/03/2018 17:44:36 - Atenção: Minha mensagem 4
`
------------
1.4. NotImplementedError
Neste Tópico:
- Descrição
- Exemplo de uso
Descrição
Esta classe gera uma excessão ao ser implementada, pois ela é extedida de Error.
Exemplo de uso
`javascript
'use strict';
const core = require('knd').core;
try {
throw new knd.NotImplementedError("Método");
} catch (error) {
console.log(error.message) ;
}
//Resultado console.log
// "Método" não implementado ainda
`
------------
2. DB
Neste "namespace" encontramos todas as bibliotécas para o manejo com o banco de dados (atualmente somete Oracle).
Todos os métodos das classes já estão implementados de forma que se possa usar com a biblioteca [asyncawait][asyncawait], ou seja, todos eles devem estar dentro de uma função "suspendable" (async) para que funcione corretamente.
Neste namespace:
2.1 Configuração de acesso ao BD
2.2 Consulta simples
2.3 Consulta com binds
2.4 Transação de banco de dados
------------
2.1. Configuração de acesso ao BD
Para fazer a configuração de banco de dados, você deve acessar a pasta deste modulo e alterar o arquivo configDB.js conforme o código abaixo.
`javascript
//configDB.js
module.exports = {
user: "USUARIO DO BD",
password: "SENHA DO BD",
connectString: "TNS/IP/SID"
}
`
------------
2.2. Consulta simples
Exemplo de uma consulta simples sem binds
`javascript
'use strict';
const async = require('asyncawait/async');
const DB = require('knd').DB;
async(function() {
let con = DB.getDbConnection();
try {
con.open();
let cmd = con.createCommand("SELECT * FROM DUAL");
cmd.executeQuery();
console.log(cmd.result);
} finally {
con.close();
}
})();
//Resultado console.log
// [ { DUMMY: "X" } ]
`
------------
2.3. Consulta com binds
Exemplo de uma consulta com binds
`javascript
'use strict';
const async = require('asyncawait/async');
const DB = require('knd').DB;
async(function() {
let con = DB.getDbConnection();
let sql = "SELECT ID, NUMERO FROM PEDIDO WHERE SITUACAO = :0";
try {
con.open();
let cmd = con.createCommand(sql);
cmd.addBind(con.createBind("0", "A"));
cmd.executeQuery();
console.log(cmd.result);
} finally {
con.close();
}
})();
//Resultado console.log
// [
// { ID: 1, NUMERO: 'PE001' },
// { ID: 2, NUMERO: 'PE002' }
// ]
`
------------
2.3. Transação de banco de dados
Exemplo de uma transação.
`javascript
'use strict';
const async = require('asyncawait/async');
const DB = require('knd').DB;
const fn = async(function() {
let sql = "INSERT INTO PEDIDO (ID, NUMERO, SITUACAO) VALUES (:ID, :NUMERO, :SITUACAO)"
let con = DB.getDbConnection();
let transaction = con.createTransaction();
try {
con.open();
let cmd = con.createCommand(sql);
cmd.addBind(con.createBind('ID', 3))
.addBind(con.createBind('NUMERO', 'PE0003'))
.addBind(con.createBind('SITUACAO', 'A'))
.executeNonQuery();
console.log(cmd.result);
transaction.commit();
} catch (err) {
transaction.rollback();
throw err;
} finally {
con.close();
}
})();
//Resultado console.log
//{ outBinds: undefined, rowsAffected: 1, rows: undefined, metaData: undefined }
`
------------
3. route
Este "namespace" é util para criar as rotas de acesso no servidor, em conjunto com o [Express.js][expressjs]. As classes encapsulam o "requestHandler" das rotas.
`javascript
'use strict';
const express = require('express');
const router = express.Router();
const route = require('knd').route;
const pageIndex = new route.RouteAction(function(req, res) {
res.render('index');
});
//Esta classe trás um conexão aberta
const selectData = new route.DbRouteAction(function(con, req, res) {
let cmd = con.createCommand('SELECT * FROM DUAL');
cmd.executeQuery();
return cmd.result;
});
//Este da commit caso não haja erros, senão, da rollback e envia o erro ao client (browser)
const insertData = new route.DbTransactionRouteAction(function(con, req, res) {
let cmd = con.createCommand("INSERT INTO PEDIDO (ID, NUMERO, SITUACAO) VALUES (:ID, :NUMERO, :SITUACAO)");
return cmd.addBind(con.createBind('ID', 3))
.addBind(con.createBind('NUMERO', 'PE0003'))
.addBind(con.createBind('SITUACAO', 'A'))
.executeNonQuery()
.result;
});
router.get('/', pageIndex.getAction());
router.get('/select', selectData.getAction());
router.put('/insert', insertData.getAction());
module.exports = router;
`
------------
4. Server
Este "namespace" é para fazer a criação de um servidor http. Segue um exemplo.
`javascript
'use strict';
const Server = require('knd').Server;
const app = require('../app'); // Aqui busca a application express
const srv = new Server(3000, app);
srv.run(); // inicia o servidor. Acesso http://localhost:3000
``