============ 2017.02.06 V2.2.9 ============

- [Новое] log4js компонент журнала
- [Новое] config/log4js.json файл конфигурации журнала
- [Новое] utils/log4js.js инструмент регистрации класса
- [Исправлено] проблема с отсутствием папки журналов при записи журналов
- [Обновлённое] README.md документ
- [Обновлённый] package.json модуль зависимости


============ 2017.01.24 V2.2.8 ============

- [Обновлённое] README.md документ
- [Обновлённый] пакет. json модуль зависимости

============ 2017.01.12 V2.2.7 ============

- [Обновлённый] модуль зависимости package.json

============ 2016.12.23 V2.2.6 ============

- [Обновлённое] приложение. md документ
- [Обновлённый] модуль зависимости package.json

============ 2016.12.22 V2.2.5 ============

- [Обновлённое] приложение. md документ
- [Обновлённый] модуль зависимости package.json

============ 2016.12.20 V2.2.3 ============

- [Новое] папка locals, определение глобальных данных инъекции, аналогично ASP.NET MVC ViewData данные
- [Новое] utils/locals.js модуль, глобальная инъекция ядра модуля
- [Обновлённое] ядро приложения. js код, поддержка глобальной инъекции данных
- [Обновлённая] утилита/маршрут. js модель, поддержка локальной инъекции данных
- [Использование] документация
- [Обновление] модуль sequelize
- [Обновление] отладка модуля
- [Оптимизация] утилиты/маршрута. код js
- [Исправленное] проблема невозможности получения данных формы enctype="multipart/form-data"

============ 2016.12.16 V2.2.1 ============

- [Новое] модуль капчи, и написание библиотеки классов капчи: utils/captcha.js
- [Новая] демонстрация капчи, http://localhost:3000/backend/
- [Удалено] все активы ресурсов в папке core
- [Перемещено] core файл, db.js и route.js перемещены в папку utils
- [Обновлённые] страницы ошибок, отображающие больше информации об ошибках
- [Обновлённое] корневой каталог public как ресурс, совместимый с express.js (важное обновление)
- [Обновлённое] core/db.js код загрузки модуля, добавлена настраиваемая загрузка
- [Обновлённое] базовое руководство
- [Обновлённое] статические ресурсы документа

============ 2016.12.15 V2.1.2 ============

- [Новое] глобальный объект базы данных db, нет необходимости проходить через require (основное обновление)
- [Новое] utils/gmodels/js модуль
- [Новое] облегчённая библиотека изображений, поддерживает обработку изображений, включая водяные знаки, изменение размера и т. д.
- [Новое] node-schedule модуль запланированных задач
- [Новое] nodemailer модуль отправки электронной почты
- [Новое] lodash модуль, предоставляющий очень удобный инструмент JavaScript
- [Новые] видеоуроки
- [Оптимизированное] ядро класса маршрутизации
- [Обновлённое] отладочный модуль
- [Обновлённое] метод сохранения ошибок приложения. js, сохранение по дням
- [Обновлённое] основное руководство
- [Обновлённая] документация ORM

============ 2016.12.14 V2.1.1 ============

- [Оптимизированная] полная оптимизация приложения. код js
- [Новый] глобальный фильтр маршрута
- [Реструктурированная] реструктуризация express.js одностраничного движка, реализация многостраничного движка
- [Обновлённая] структура каталогов, удаление активов и папок представлений из корневого каталога, добавление папки share
- [Обновлённая] версия postgres
- [Обновлённая] версия socket.io
- [Обновлённая] документация по использованию
- [Устранённая] ошибка, из-за которой сеанс и cookie не действуют
- [Устранённое] неправильное использование core/db.js для загрузки модели

============ 2016.12.13 V2.0.1 ============

- [Поддержка] cors междоменная поддержка
- [Поддержка] защита от атак csurf, предоставление более безопасной среды разработки
- [Поддержка] typescript, возможность разработки модулей node.js с помощью typescript **logs/access** и **logs/error** используются для сохранения записей журнала.

* [Новое] — функция записи в журнал доступа.
* [Новое] — функция записи в журнал ошибок.
* [Новое] — функция разделения журналов.
* [Новое] — поддержка функций записи журналов в файл и записи в базу данных.
* [Новое] — зависимость модуля package.json от file-stream-rotator.
* [Оптимизация] — повышение производительности доступа к файлу app.js, который является файлом входа.
* [Обновление] — вывод журнала консоли на комбинированный уровень (предыдущий уровень — dev).
* [Обновление] — добавление примера предотвращения атаки CSRF в новую документацию.

============ 2016.12.10 V2.0.0 ============

* [Новое] — настройка приложения по умолчанию через файл app.js.
* [Новое] — возможность настройки контроллера по умолчанию и действия по умолчанию.
* [Новое] — каталог областей поддерживает разработку многоузловых проектов и включает backend (бэкенд) и frontend (фронтенд) по умолчанию.
* [Новое] — перемещение модуля models/index.js в core/db.js.
* [Настройка] — изменение имени общедоступного каталога на assets, который по умолчанию содержит backend (бэкэнд), frontend (фронтенд), vendor (сторонние плагины).
* [Настройка] — настройка подкаталога views, который по умолчанию включает backend (бэкенд), frontend (фронтенд).
* [Настройка] — переименование utils/socketServer.js в utils/socket.js.
* [Оптимизация] — оптимизация кода файла app.js для поддержки только настройки области по умолчанию, контроллера по умолчанию и действий по умолчанию.
* [Удаление] — удаление модуля express-controller и реализация более мощных функций.

============ 2016.12.08 V1.0.2 ============

* [Новое] — пример чата и мгновенных сообщений (рекомендуется).
* [Новое] — поддержка socket.io.
* [Новое] — поддержка redis.
* [Новое] — поддержка multer для загрузки файлов.
* [Новое] — создание папки uploads.
* [Оптимизация] — улучшение производительности загрузки файла app.js путём оптимизации порта и статических файлов, а также кода для обработки загруженных файлов пользователями.
* [Оптимизация] — улучшение структуры комментариев и кода.
* [Исправление] — исправление ошибки в файле package.json с зависимостью mysql.

============ 2016.12.07 V1.0.1 ============

* [Новое] — демонстрационный сайт.
* [Новое] — контроллер по умолчанию Home и действие по умолчанию Index.
* [Новое] — генератор кода модели.
* [Новое] — файл package.json с зависимостями sequelize-auto.
* [Оптимизация] — деконструкция каталогов.
* [Исправление] — устранение ошибки в файле app.js.

============ 2016.12.06 V1.0.0 ============

* [Выпуск] — версия v1.0.0. **Настройка области, контроллера и каталога действий и маршрутов**

- **Настройка обработки ошибок 404 и 500**

- **Установка порта прослушивания веб-сайта, по умолчанию — 3000**

- **Запуск WebSocket и настройка логики обработки на стороне сервера**

### Области

> Область представляет собой высокоуровневую организацию для веб-сайтов и кода, например, фронтэнд и бэкэнд. В настоящее время область поддерживает только написание логики контроллера.

- Добавление области

Просто создайте папку в каталоге `areas` и создайте каталог `controllers` в этой папке. Например: `areas/api/controllers`.

По умолчанию уже существуют две области: `backend` (бэкэнд) и `frontend` (фронтэнд).

- Доступ к области, по умолчанию доступ к контроллеру `homeController` и действию `get_index`.

### Контроллеры

> Контроллер является основной единицей, которая позволяет всему фреймворку правильно работать в браузере, можно сказать, что это душа. Обратите внимание: контроллер с именем `homeController`, является контроллером по умолчанию, а действие `get_index` в этом контроллере является действием по умолчанию. Этот контроллер может содержать только одно действие, то есть `get_index`.

- Создание контроллера, имя файла контроллера должно заканчиваться на `Controller`. Например, в области `frontend` добавьте `controllers/aboutController.js`.

- В контроллере создайте действие, которое также является маршрутом, следуя формату `method_action`. В `aboutController.js` определите:

// Адрес отправки: http://localhost:3000/frontend/about/create
post_create:function(req,res){
    res.send("ok");
},

// Доступный адрес: http://localhost:3000/frontend/about/company/baisoft
get_company_baisoft:function(req,res){
    res.send("ok");
},

// Доступный адрес: http://localhost:3000/frontend/about/company/10
get_company_id:function(req,res,id){
    res.send("ok");
},

// Доступный адрес: http://localhost:3000/frontend/about/company/10/百小僧
get_company_id_name:function(req,res,id,name){
    res.send("ok");
},

// Доступный адрес: http://localhost:3000/frontend/about/百小僧/company
get_name_company:function(req,res,name){
    res.send("ok");
},

// Фильтр
get_admin:[function(req,res,next){
    if(未登录){
        res.redirect("登录页面");
    }
    else{
        next();
    }
},function(req,res){
    res.send("ok");
}],

// Несколько фильтров
get_admin:[function(req,res,next){
    console.log("日志记录");
    next();
},function(req,res,next){
    if(未登录){
        res.redirect("登录页面");
    }
    else{
        next();
    }
},function(req,res){
    res.send("ok");
}],

### Шаблоны представлений

> Шаблоны представлений используют механизм шаблонов `ejs`, а каталог шаблонов по умолчанию находится в папке `views` под областью. [Подробная документация ejs](https://www.npmjs.com/package/ejs)

- Базовый синтаксис

module.exports={
    get_index:function(req,res){
        res.render("frontend/about/index");
    },
    get_about:function(req,res){
        res.render("frontend/about/index",{
            user:{
                name:"百小僧"
            }
        });
    }
};

<%- include("header") %>

<%- include("footer") %>

// Передача параметров

<%- include("header",{
    name:"百小僧"
}) %>

<%- include("footer",{
    name:"百小僧"
}) %>

<img src="/imgs/logo.png" />

<link res="stylesheet" href="/css/style.css" />

<script type="text/javascript" src="/js/script.js"></script>

module.exports = function(sequelize, DataTypes) {
    return sequelize.define('member', {
        id: {
            type: DataTypes.INTEGER,
            allowNull: false,
            primaryKey: true
        },
        name: { **Тип:** DataTypes.STRING,
allowNull: false
}, {
tableName: 'member',
timestamps: false,
freezeTableName: true
});
};

Поскольку создание модели занимает много времени и содержит много повторяющегося кода, в данном фреймворке предусмотрен инструмент для генерации моделей данных. С его помощью можно быстро создать модель без необходимости ручного вмешательства.

**Перед генерацией необходимо настроить файл конфигурации config/db.json**. Обычно требуется указать только информацию о базе данных.

### База данных CURD

Для операций с базой данных используется мощный ORM-фреймворк Sequelize.js, который поддерживает все основные базы данных. Подробные сведения доступны в документации (http://docs.sequelizejs.com/en/v3/).

*Информация о конфигурации базы данных находится в файле config/db.json.*

- CURD:

### Session，Cookies

> Session、Cookies используются для хранения информации о клиентских сеансах, обычно для проверки входа.

- Использование Session:

- Использование Cookies:

    // 如果请求中的 cookie 存在 isVisit, 则输出 cookie
    // 否则，设置 cookie 字段 isVisit, и устанавливаем срок действия в 1 минуту
    if (req.cookies.isVisit) {
        console.log(req.cookies);
        res.send("再次欢迎访问");
    } else {
        res.cookie('isVisit', 1, {maxAge: 60 * 1000});
        res.send("欢迎第一次访问");
    }
}

    get_admin: [function (req, res, next) {
        if (!loggedIn) {
            res.redirect("登录页面");
        } else {
            next();
        }
    }, function (req, res) {
        res.send("ok");
    }]
};

module.exports = function (req, res, next) {
    if(!loggedIn){
        res.redirect("登录页面");
    }else{
        next();
    }
};

module.exports={
    get_admin:[loginFilter,function(req,res){
        res.send("ok");
    }]
}

    get_admin: [
        function (req, res, next) {
            console.log("日志记录");
            next();
        },
        function (req, res, next) {
            if (!loggedIn) {
                res.redirect("登录页面");
            } else {
                next();
            }
        },
        function (req, res) {
            res.send("ok");
        }
    ]
};

<form action="/backend/home/form1" method="post">
    <input type="text" name="name" />
    <input type="submit" value="提交">
</form>

<h3>表单（不带文件上传，带： enctype="multipart/form-data"）：</h3>
<form action="/backend/home/form2" method="post" enctype="multipart/form-data">
    <input type="text" name="name" />
    <input type="submit" value="提交">
</form>

<h3>表单（带单个文件上传，带： enctype="multipart/form-data"）：</h3>
<form action="/backend/home/form3" method="post" enctype="multipart/form-data">
    <input type="file" name="file1">
    <input type="text" name="name" />
    <input type="submit" value="提交">
</form>

<h3>表单（带多个文件上传，带： enctype="multipart/form-data"）：</h3>
<form action="/backend/home/form4" method="post" enctype="multipart/form-data">
    <input type="file" name="file1">
    <input type="file" name="file2">
    <input type="text" name="name" />
    <input type="submit" value="提交">
</form>

<h3>表单（带多个文件上传，上传表单名称 不一样(file1,file2,...)，带： enctype="multipart/form-data"）：</h3>
<form action="/backend/home/form5" method="post" enctype="multipart/form-data">
    <input type="file" name="file1">
    <input type="file" name="file2">
    <input type="text" name="name" />
    <input type="submit" value="提交">
</form>`

module.exports = {
    // 表单（不带文件上传，不带： enctype="multipart/form-data"）
    post_form1: function (req, res) {
        res.json(req.body);
    },

    // 表单（不带文件上传，带： enctype="multipart/form-data"）：
    post_form2: [multer().array(), function (req, res) {
        res.json(req.body);
    }],

    // 表单（带单个文件上传，带： enctype="multipart/form-data"）：
    post_form3: [multer().single('file1'), function (req, res) {
        res.send(
            "文件：" + JSON.stringify(req.file) + "<br />表单" + JSON.stringify(req.body)
        );
    }],

    // 表单（带多个文件上传，带： enctype="multipart/form-data"）：
    post_form4: [multer().array('file1'), function (req, res) {
        res.send(
            "文件：" + JSON.stringify(req.files) + "<br />表单" + JSON.stringify(req.body)
        );
    }],

    // 表单（带多个文件上传，上传表单名称 不一样(file1,file2,...)，带： enctype="multipart/form-data"）：
    post_form5: [multer().fields([{ name: "file1" }, { name: "file2" }]), function (
        req,
        res
    ) {
        res.send(
            "文件：" + JSON.stringify(req.files) + "<br />表单" + JSON.stringify(req.body)
        );
    }]
};

    <input type="file" name="logo">
    <input>``` **Перевод текста на русский язык:**

**Отправка**
</form>

var path = require('path');
var fs = require('fs');
var multer = require('multer');
var upload = multer({ dest: 'uploads/' });

module.exports = {
    post_upload: [upload.single('logo'), function(req, res, next) {
        var file = req.file;
        var ext = path.extname(file.originalname);
        fs.rename(file.path, file.path + ext, function(err) {
            if (err) {
                res.send(JSON.stringify(err));
            }
            next();
        });
    }, function(req, res) {
        res.send("Загрузка прошла успешно");
    }]
}

var redis = require("redis"),
    client = redis.createClient();

// если вы хотите выбрать базу данных 3 вместо 0 (по умолчанию), вызовите
// client.select(3, function() { /* ... */ });

client.on("error", function (err) {
    console.log("Ошибка " + err);
});

client.set("строковый ключ", "строковое значение", redis.print);
client.hset("хеш-ключ", "hashtest 1", "некоторое значение", redis.print);
client.hset(["хеш-ключ", "hashtest 2", "другое значение"], redis.print);
client.hkeys("хеш-ключ", function (ошибка, ответы) {
    console.log(количество ответов + " ответов:");
    ответы.forEach(функция (ответ, i) {
        console.log("    " + i + ": " + ответ);
    });
    клиент.quit();
});

var io = require('socket.io')();

// socket.io базовое использование, прослушивание запросов на подключение
io.on('connection', function (socket) {
    console.log("Соединение клиента успешно установлено~~");

    // прослушивание событий от клиента
    socket.on('send', function (data) {
        // вызвать событие receive у клиента и передать data
        io.emit('receive', data);
    });


    // здесь можно написать различные события прослушивания,
    // через socket.on("") прослушивать события от клиента, через io.emit("") запускать все события от клиентов, socket.emit("") запускать события для конкретного клиента

});


exports.listen = function (server) {
    return io.listen(server);
};

<!-- Импорт клиентского скрипта -->
  <script src="/vendors/socket.io/socket.io.js"></script>
  <script>
    // Подключение к серверу
    var socket = io.connect('http://localhost:3000/');

    window.onload=function(){
        var send=document.getElementById("send");
        send.onclick=function(){
          var name=document.getElementById("name").value;
          var msg=document.getElementById("msg").value;

          // Отправка сообщения
          socket.emit('send', { data:name+":"+msg  });
        };


        // Прослушивание сообщений от сервера
        socket.on('receive', function (data) {
          console.log(data);
          var list = document.getElementById("list");
          // Запись в список чата
          list.innerHTML=list.innerHTML+"<br />"+data.data;
          // Очистить msg
          document.getElementById("msg").value="";
        });
    };
</script>

var csrf = require('csurf');
var csrfProtection = csrf({ cookie: true });
module.exports={
    post_login:[csrfProtection,function(req,res){
        res.send("ok",{ csrfToken: req.csrfToken() });
    }]
};

<form action="/process" method="POST">
  <input type="hidden" name="_csrf" value="{{csrfToken}}">
  
  Любимый цвет: <input type="text" name="favoriteColor">
  <button type="submit">Отправить</button>
</form>

$ npm install pm2 -g |

$ pm2 start app.js

$ npm install pm2-windows-startup -g

$ pm2-startup install

$ pm2 save