OSCHINA-MIRROR/koahubjs-koahub

wemall 商城 & koahub 商城所有系统将在四月底或五月初免费提供下载，如需更多详细信息，请联系支持服务。

введите описание изображения здесь

koahub.js

koahub.js — лучшая практика для быстрого создания веб-приложений на Node.js с поддержкой middleware для Koa.js и Express.js. Проект больше не поддерживается, рекомендуется использовать Doodoo.js.

// Базовый контроллер, admin/controller/base.controller.js
module.exports = class extends koahub.controller {

    async _initialize() {
        console.log('base _initialize');
    }

    async isLogin() {
        console.log('base isLogin');
    }
}

// Контроллер главной страницы, admin/controller/index.controller.js
const base = require('./base.controller');
module.exports = class extends base {

    async _initialize() {
        await super._initialize();
    }

    async index() {
        this.view(1);
    }

    async index2() {
        this.json(1, 2);
    }

    async index3() {
        await this.render('index');
    }
}

Требования к окружению: Node.js >= 7.6.0

Основные характеристики* Поддерживает все middleware для Koa.js

Поддерживает использование всех возможностей ES6+
Поддерживает отладку проектов на ES6+
Поддерживает различные структуры проектов и среды
Поддерживает использование всех API Koa.js в контроллерах
Поддерживает многоуровневую структуру контроллеров
Поддерживает автоматическую загрузку
Поддерживает механизм хуков
Поддерживает Socket.io
Поддерживает обработку ошибок
Поддерживает глобальные переменные koahub
Поддерживает быстрые методы
Поддерживает немедленное применение изменений кода
Поддерживает выполнение до, после и пустых действий
Поддерживает отключение методов контроллеров
Поддерживает RESTful дизайн
Поддерживает автоматическую загрузку общих компонентов
Поддерживает настройку запуска
...## Установка

npm install koahubjs/koahub --save

Создание файла запуска

// app/index.js файл запуска
const Koahub = require('koahub');

Инициализация проекта

const app = new Koahub();

// Запуск проекта
app.run();

Методы

Функции или параметры в объекте ctx автоматически загружаются в контроллер. Например, поддерживаются такие методы как this.body = 'Hello World!'. Для конкретных API в контексте Koa.js обратитесь к документации Koa.js. Расширенные методы контроллера представлены ниже.

this.ctx;
this.next;
this.isGet();
this.isPost();
this.isAjax();
this.isPjax();
this.isMethod(method);
this.hook.add(name, action);
await this.hook.run(name, ...args);
this.download(file);
this.view(data);
this.json(data, msg, code);
this.success(data, msg);
this.error(data, msg);
await this.action(path, ...args);

Быстрые методы

// app/common.js файл с функциями
module.exports = {
    add(a, b) {
        return a + b;
    }
};
// В контроллере можно вызвать этот метод через this.add

Быстрые промежуточные модули

app.use(async function(ctx, next) {
    ctx.model = function() {
        // ...
    };
    await next();
});
// В контроллере можно вызвать этот метод через this.model

Клиентская утилита командной строки

KoaHub CLI

Конфигурация

// app/config/default.config.js
module.exports = {
    port: 3000,
    default_module: 'admin'
};

// По умолчанию конфигурация фреймворка
// Порт запуска
port: 3000,

// По умолчанию модуль, контроллер, действие
default_module: 'home',
default_controller: 'index',
default_action: 'index',

// Заключение URL
url_suffix: '',
```// Автоматическая загрузка конфигураций
loader: {
    "controllers": {
        root: 'controller',
        suffix: '.controller.js',
        prefix: '/'
    },
    "configs": {
        root: 'config',
        suffix: '.config.js'
    },
    "middlewares": {
        root: 'middleware',
        suffix: '.middleware.js'
    }
}

// По умолчанию конфигурация промежуточных модулей
// Порядок промежуточных модулей
middleware: ['koa-logger'],

// HTTP логи
'koa-logger': true,

// favicon установка
'koa-favicon': 'www/favicon.ico',

// Настройки body
body: {
    multipart: true
},

// Настройки cors
'koa-cors': false,

// Настройки session
'koa-session2': false,

// Настройки static
'koa-static-cache': false

Другое

// Инициализация контроллера, до действия, после действия, пустое действие
async _initialize() 
async _before() 
async _before_index() 
async index() 
async _after_index() 
async _after() 
async _empty() 

// Приватные методы контроллера
// Методы начинающиеся со `_` являются приватными
```## Поддержка RESTful маршрутов
### app/config/router.config.js
```javascript
module.exports = [
    ['/product', {
        get: '/home/product/index'
    }],
    ['/product/:id', {
        get: '/home/product/detail',
        post: '/home/product/add',
        put: '/home/product/update',
        delete: '/home/product/delete',
    }]
]

Начало работы с приложением

async/await

# Клонировать demo
git clone https://github.com/koahubjs/koahub-demo.git
# Перейти в проект
cd koahub-demo
# Установить зависимости
npm install
# Запустить проект
npm start

Promise

# Клонировать demo
git clone https://github.com/koahubjs/koahub-demo-promise.git
# Перейти в проект
cd koahub-demo-promise
# Установить зависимости
npm install
# Запустить проект
npm start
```### Генератор
```sh
# Клонировать демонстрацию
git clone https://github.com/koahubjs/koahub-demo-generator.git
# Перейти в проект
cd koahub-demo-generator
# Установить зависимости
npm install
# Запустить проект
npm start

Информация о запуске

[2017-05-14 11:48:05] [Koahub] Koahub Version: 2.2.6
[2017-05-14 11:48:05] [Koahub] Koahub Website: http://js.koahub.com
[2017-05-14 11:48:05] [Koahub] Nodejs Version: v8.0.0
[2017-05-14 11:48:05] [Koahub] Nodejs Platform: darwin x64
[2017-05-14 11:48:05] [Koahub] Серверная среда: development
[2017-05-14 11:48:05] [Koahub] Сервер запущен по адресу: http://127.0.0.1:3000

Руководство пользователя

Руководство KoaHub.js

Официальный сайт

Официальный сайт KoaHub.js