Biblioteca KND

1. core
2. DB
3. route
4. server
5. xml

Neste "namespace" encontramos a base para todas as classe criadas nesta biblioteca.

Neste namespace:

Neste Tópico:

• Descrição
• Exemplo de uso

Classe base de todos os objetos do da biblioteca.

'use strict';
const core = require('knd').core;

let obj = new knd.KndObject();
console.log(obj.toString()) 

//Resultado console.log
// KndObject

Neste Tópico:

• Descrição
• Exemplo de uso

Classe genérica para todos os tipos de coleções

'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" }

Neste Tópico:

• Descrição
• Exemplo de uso

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.

global.rootApp = 'c:\temp';

'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

Neste Tópico:

• Descrição
• Exemplo de uso

'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

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, 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

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.

//configDB.js
module.exports = {
    user: "USUARIO DO BD", 
    password: "SENHA DO BD", 
    connectString: "TNS/IP/SID"
} 

Exemplo de uma consulta simples sem binds

'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" } ]

Exemplo de uma consulta com binds

'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' } 
// ]

Exemplo de uma transação.

'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 }

Este "namespace" é util para criar as rotas de acesso no servidor, em conjunto com o Express.js. As classes encapsulam o "requestHandler" das rotas.

'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;

Este "namespace" é para fazer a criação de um servidor http. Segue um exemplo.

'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