Maison > Article > interface Web > Explication détaillée du cadre frontal ThinkJS Framework

Explication détaillée du cadre frontal ThinkJS Framework

小云云original: 2018-02-08 16:25:397372parcourir

Cet article partage principalement avec vous l'explication détaillée du framework front-end ThinkJS. Thinkjs est un framework de développement Node.js léger, rapide et simple, basé sur MVC et orienté objet, publié sous licence MIT. Adhérant au principe de conception de simplicité et de facilité d'utilisation, tout en conservant d'excellentes performances et un minimum de code, il se concentre sur l'expérience de développement et la facilité d'utilisation, offrant un support solide pour le développement d'applications WEB.

De nombreuses fonctionnalités de Thinkjs sont dérivées de ThinkPHP. En même temps, selon les caractéristiques de Node.js, Promise, WebSocket et d'autres fonctionnalités sont utilisées pour rendre le code plus concis et élégant. La plus grande caractéristique est qu'il offre une excellente prise en charge des fonctionnalités grammaticales actuellement populaires, telles que es6, es7, dactylographié, etc. Avec celles-ci, il prend également en charge des fonctionnalités telles que aysnc/await, rendant le code plus à la mode.

Installer

Installez l'outil de ligne de commande :

$ npm install -g thinkjs

Créez ensuite un nouveau projet à l'aide de la nouvelle démo de thinkjs. Afin de garantir que les fichiers existants sont écrasés en raison d'erreurs de l'utilisateur, la nouvelle commande thinkjs s'applique uniquement aux dossiers qui n'existent pas ou sont vides. Sinon, l'erreur suivante sera signalée :

path `/data/www/demo` is already a thinkjs project.

L'implémentation de cette fonctionnalité repose en fait sur un fichier caché .thinkjsrc dans le répertoire racine du projet. Utilisez ls -a pour afficher le fichier caché. vous ouvrez ce fichier, vous pouvez voir le contenu suivant :

{  "createAt": "2017-02-12 19:08:38",  "mode": "module",  "es": true}

Après avoir utilisé la commande, le système commencera à construire le projet :

$ thinkjs new demo
  create : demo
  create : demo/package.json
  create : demo/.babelrc
  create : demo/.thinkjsrc
  create : demo/nginx.conf
  create : demo/pm2.json
  create : demo/.gitignore
  create : demo/README.md
  create : demo/www
  create : demo/www/development.js
  create : demo/www/production.js
  create : demo/www/testing.js
  create : demo/www/README.md
  create : demo/www/static
  create : demo/www/static/js
  create : demo/www/static/css
  create : demo/www/static/img
  create : demo/src
  create : demo/src/common/bootstrap
  create : demo/src/common/bootstrap/middleware.js
  create : demo/src/common/bootstrap/global.js
  create : demo/src/common/config
  create : demo/src/common/config/config.js
  create : demo/src/common/config/view.js
  create : demo/src/common/config/db.js
  create : demo/src/common/config/hook.js
  create : demo/src/common/config/session.js
  create : demo/src/common/config/error.js
  create : demo/src/common/config/env
  create : demo/src/common/config/env/development.js
  create : demo/src/common/config/env/testing.js
  create : demo/src/common/config/env/production.js
  create : demo/src/common/config/locale
  create : demo/src/common/config/locale/en.js
  create : demo/src/common/controller
  create : demo/src/common/controller/error.js
  create : demo/view/common
  create : demo/view/common/error_400.html
  create : demo/view/common/error_403.html
  create : demo/view/common/error_404.html
  create : demo/view/common/error_500.html
  create : demo/view/common/error_503.html
  create : demo/src/home/config
  create : demo/src/home/config/config.js
  create : demo/src/home/controller
  create : demo/src/home/controller/base.js
  create : demo/src/home/controller/index.js
  create : demo/src/home/logic
  create : demo/src/home/logic/index.js
  create : demo/src/home/model
  create : demo/src/home/model/index.js
  create : demo/view/home
  create : demo/view/home/index_index.html

  enter path:
  $ cd demo

  install dependencies:
  $ npm install

  run the app:
  $ npm start

Il est à noter que lors de la création un nouveau projet, beaucoup de babel est nécessaire, donc la construction du projet sera plus lente, les packages dépendants incluent principalement :

 "dependencies": {    "thinkjs": "2.2.x",    "babel-runtime": "6.x.x",    "source-map-support": "0.4.0"  },

Répertoire

.├── README.md
├── app
│   ├── common
│   │   ├── bootstrap
│   │   ├── config
│   │   └── controller
│   └── home
│       ├── config
│       ├── controller
│       ├── logic
│       └── model
├── nginx.conf
├── package.json
├── pm2.json
├── src
│   ├── common
│   │   ├── bootstrap
│   │   ├── config
│   │   └── controller
│   └── home
│       ├── config
│       ├── controller
│       ├── logic
│       └── model
├── tree.txt
├── view
│   ├── common
│   │   ├── error_400.html
│   │   ├── error_403.html
│   │   ├── error_404.html
│   │   ├── error_500.html
│   │   └── error_503.html
│   └── home
│       └── index_index.html
└── www
    ├── README.md
    ├── development.js
    ├── production.js
    ├── static
    │   ├── css
    │   ├── img
    │   └── js
    └── testing.js388 directories, 1381 files

Analyse du processus de démarrage

1) Commande de démarrage

npm start

Ensuite, utilisez Qu'a fait le système après le démarrage ?

 "scripts": {    "start": "node www/development.js",    "compile": "babel src/ --out-dir app/",    "watch-compile": "node -e \"console.log(&#39;<npm run watch-compile> no longer need, use <npm start> command direct.&#39;);console.log();\"",    "watch": "npm run watch-compile"  },

Utilisez Node pour exécuter www/development.js. Il s'agit du traitement de l'environnement env. Thinkjs utilise 3 env. Les plus courants sont :

développement. mode
Mode production en ligne
Test Mode test

thinkjs traite www comme le projet de nœud répertoire, et static sous www est le répertoire des fichiers de ressources statiques. Le répertoire www/development.js est le suivant :

var instance = new thinkjs({
  APP_PATH: rootPath + path.sep + &#39;app&#39;,
  RUNTIME_PATH: rootPath + path.sep + &#39;runtime&#39;,
  ROOT_PATH: rootPath,
  RESOURCE_PATH: __dirname,
  env: &#39;development&#39;});

Bien sûr, vous pouvez utiliser la commande "tree src -L 3" pour visualiser le répertoire du projet :

$ tree src -L 3         src
├── common
│   ├── bootstrap
│   │   ├── global.js
│   │   └── middleware.js
│   ├── config
│   │   ├── config.js
│   │   ├── db.js
│   │   ├── env
│   │   ├── error.js
│   │   ├── hook.js
│   │   ├── locale
│   │   ├── session.js
│   │   └── view.js
│   └── controller
│       └── error.js
├── home
│   ├── config
│   │   └── config.js
│   ├── controller
│   │   ├── base.js
│   │   └── index.js
│   ├── logic
│   │   └── index.js
│   └── model
│       └── index.js16 directories, 19 files

La configuration commune du module (plus tard) sera abordée en détail :

$ thinkjs module topic(能创建不能删除，略遗憾)

  create : src/topic/config
  create : src/topic/config/config.js
  create : src/topic/controller
  create : src/topic/controller/base.js
  create : src/topic/controller/index.js
  create : src/topic/logic
  create : src/topic/logic/index.js
  create : src/topic/model
  create : src/topic/model/index.js
  exist : /Users/sang/workspace/github/nodewebframework/demo/view/topic/index_index.html

À l'heure actuelle, la structure du répertoire est la suivante :

src
├── common
├── home
└── topic

3) Répertoire du module métier

├── home
│   ├── config
│   │   └── config.js
│   ├── controller
│   │   ├── base.js
│   │   └── index.js
│   ├── logic
│   │   └── index.js
│   └── model
│       └── index.js

4) Routage et identification des vues L'identification de l'itinéraire, par défaut, est basée sur module/contrôleur/opération/paramètre 1/valeur du paramètre 1/paramètre 2/valeur du paramètre 2, ce qui est en fait une convention.

Par exemple/analysé comme :

Le module par défaut est home
Le contrôle est index
L'opération est indexAction

Et s'il y en a une autre ?

&#39;use strict&#39;;import Base from &#39;./base.js&#39;;export default class extends Base {  /**
   * index action
   * @return {Promise} []
   */  indexAction(){    //auto render template file index_index.html    return this.display();  }  myAction(){    //auto render template file index_index.html    return this.display();  }}

Ajoutez myAction et signalez une erreur [Erreur] Erreur : impossible de trouver le fichier modèle /Users/sang/workspace/github/nodewebframework/demo/view/home/index_my.html

Copiez view/home/index_index.html dans view/home/index_my.html. Le principe est que my doit correspondre au module index_my.html. Autrement dit, l'index est le contrôleur et le mien est l'action.

Après avoir compris cela, vous penserez que nommer index_index n'est pas très bizarre. Le reste est une écriture de vues, etc., qui ne sera pas décrite ici.

Performance

Comme mentionné précédemment, la phase de développement est écrite en Babel, l'efficacité ne sera donc pas très élevée.

$ autocannon -c 100 -d 5 -p 10 localhost:8360Running 5s test @ http://localhost:8360100 connections with 10 pipelining factor

Stat         Avg       Stdev    Max       
Latency (ms) 108.9     201.32   866       Req/Sec      891.8     148.37   1000      Bytes/Sec    417.79 kB 50.76 kB 458.75 kB 

4k requests in 5s, 2.09 MB read

C'est un peu misérable, n'est-ce pas ? Mais c'est un mode de développement, et nous devons utiliser le mode de production en ligne pour le tester.

$ npm run compile
$ node www/production.js 
$ autocannon -c 100 -d 5 -p 10 localhost:8360Running 5s test @ http://localhost:8360100 connections with 10 pipelining factor

Stat         Avg       Stdev     Max       
Latency (ms) 61.76     124.71    763       Req/Sec      1567.2    734.94    1993      Bytes/Sec    679.12 kB 242.25 kB 884.74 kB 

8k requests in 5s, 3.4 MB read

$ autocannon -c 100 -d 5 -p 10 localhost:8360Running 5s test @ http://localhost:8360100 connections with 10 pipelining factor

Stat         Avg       Stdev     Max      
Latency (ms) 54.65     105.47    707      Req/Sec      1813.4    368.21    1999     Bytes/Sec    807.73 kB 156.09 kB 917.5 kB 

9k requests in 5s, 4.09 MB read

$ autocannon -c 100 -d 5 -p 10 localhost:8360Running 5s test @ http://localhost:8360100 connections with 10 pipelining factor

Stat         Avg       Stdev     Max     
Latency (ms) 54.14     89.81     465     Req/Sec      1816.4    319.14    2000    Bytes/Sec    914.23 kB 145.96 kB 1.05 MB 

9k requests in 5s, 4.55 MB read

Ce qui suit utilise le même modèle de fonction express + ejs.

$ autocannon -c 100 -d 5 -p 10 localhost:3000Running 5s test @ http://localhost:3000100 connections with 10 pipelining factor

Stat         Avg       Stdev     Max       
Latency (ms) 53.85     177.72    1309      Req/Sec      1728      385.85    2075      Bytes/Sec    702.87 kB 159.56 kB 851.97 kB 

9k requests in 5s, 3.53 MB read

$ autocannon -c 100 -d 5 -p 10 localhost:3000Running 5s test @ http://localhost:3000100 connections with 10 pipelining factor

Stat         Avg       Stdev     Max       
Latency (ms) 46.06     141.52    739       Req/Sec      2061.2    320.53    2275      Bytes/Sec    842.14 kB 134.95 kB 950.27 kB 

10k requests in 5s, 4.2 MB read

$ autocannon -c 100 -d 5 -p 10 localhost:3000Running 5s test @ http://localhost:3000100 connections with 10 pipelining factor

Stat         Avg       Stdev    Max       
Latency (ms) 45.97     139.58   620       Req/Sec      2059.4    122.93   2167      Bytes/Sec    829.03 kB 52.43 kB 884.74 kB 

10k requests in 5s, 4.2 MB read

Décomposition des modules

Après la création du projet, le cadre de code de base a été établi, et les valeurs home et common par défaut ne sont définitivement pas en mesure de répondre aux exigences. Nous devons établir une structure hiérarchique pertinente pour nos projets. Voici quelques méthodes courantes de classification des modules. Pour référence seulement.

Site Web simple

Site Web officiel, blog, communauté, etc. Ce type de structure de système est relativement simple, et généralement une gestion front-end et une gestion back-end peuvent répondre aux exigences. Habituellement, il doit inclure les modules suivants :

src/src/common/  # 通用模块，放置主配置参数、boostrap adapter middleware service 等相关组件
src/home/  # 前端默认模块
src/backend/  # 后端管理模块
src/util/  # 系统工具类

Plateforme e-commerce

Le système de plateforme e-commerce prend principalement en compte les utilisateurs des commerçants installés, les clients enregistrés, les gérants, les opérateurs , etc. Il faut également envisager la segmentation de modules fonctionnels plus grands (s'il est suffisamment grand pour être un système similaire à JD.com et Tmall, il devra être segmenté à partir des données, des fonctions, des services, des emplacements, etc.).

src/src/common/src/home/src/sso/  # 单点登录、令牌管理等
src/rest/  # 针对Wap、App等多客户端的 rest api
src/goods/  # 商品管理及服务
src/storage/  # 库存管理及服务
src/cart/  # 购物车
src/order/  # 订单
src/delivery/  # 快递
src/pay/  # 在线支付、空中支付
src/member/  #
src/coupon/  # 电子券
src/promotion/  # 促销
src/points/  # 积分
src/merchant/  # 入驻商户
src/shop/  # 商户门店
src/finance/  # 财务核算及款项清算
src/stat/src/log/src/monitor/src/util/src/task/src/message/  # 消息队列

Plateforme de messagerie instantanée

La plate-forme push en temps réel gère non seulement les connexions WebSocket et la thésaurisation et l'envoi de messages, mais gère également l'achat multi-utilisateurs des packages de services correspondants, compte les connexions, compte le trafic en aval, effectue l'authentification de connexion, etc. Les modules généralement inclus sont les suivants :

src/src/common/src/home/src/rest/src/storage/src/websocket/  # ws 或者 wss 服务
src/webhook/  # 钩子服务
src/middleware/  # 搭载中间件运行
src/pay/src/member/src/stat/src/log/src/monitor/src/util/src/message/  # 消息队列

Éducation en ligne, plateforme de diffusion en direct

Les plateformes d'éducation en ligne ou de diffusion en direct ont généralement des exigences strictes telles que le téléchargement audio et vidéo en temps réel, le transcodage. , le stockage et la diffusion, donc le système En plus de gérer les didacticiels associés, les étudiants, les enseignants, les sélections de cours, etc., ils sont également responsables du traitement des fichiers multimédias associés.

src/src/common/src/home/src/rest/src/sso/  # 单点登录、令牌管理等
src/media/  # 课件、音视频等媒体文件
src/bulk/  # 流媒体
src/process/  # 编解码处理
src/storage/src/live/  # 直播
src/pay/src/student/src/teacher/src/schedule/src/stat/src/log/src/monitor/src/util/src/task/src/message/  # 消息队列

Configuration des paramètres

Le site officiel décrit la séquence de chargement du fichier de configuration comme suit : Configuration par défaut du framework-> Configuration du framework en mode projet-> mode Configuration publique sous -> Configuration sous module.

第三个和第四个则是在不同的项目创建模式下的默认 config 配置文件夹，位置在：

# normal mode
thinkjs_normal/src/config/*
# module mode
thinkjs_module/src/common/config/*

最后一个是指的在 module mode 下的项目，每个 module 自己的 config，位置在：

thinkjs_module/src/home/config/*

明白了多个地方多个配置文件的玩法之后，你可以创建多个 module，并给每个 module 配置自身独特的配置参数。

需要注意的是：thinkjs 加载配置文件是有顺序的！！！多个配置文件最终会在 thinkjs 运行时被全部加载，并合并在一起。所以当存在多个配置文件时，需要注意配置参数的 key（即属性名）尽量不要重复，因为按照加载顺序，后加载的 key 的值会覆盖先加载的 key 的值，导致出现不希望的结果。

举例来说，有两个配置文件 src/common/config/assets.js 和 src/home/config/assets.js，

// src/common/config/assets.jsexport default {  "site_title": "my site"};// src/home/config/assets.jsexport default {  "site_title": "my test"};// src/home/controller/index.jslet assets = this.config(&#39;assets&#39;);let siteTitle = assets[&#39;site_title&#39;];console.log(&#39;siteTitle is: &#39;, siteTitle); // my test

Babel 编译时删除注释

开发时的工作代码都在 src 下面，运行时才会编译到 app 下面成为运行脚本（经过 Babel 编译），如果不想自己写的各种注释也出现在 app 下面的代码中，可以修改项目目录下的一个隐藏文件 .babelrc 增加相应 comments 参数。

{  "presets": [    ["es2015", {"loose": true}],    "stage-1"  ],  "plugins": ["transform-runtime"],  "sourceMaps": true,  "comments": false  # <-- 就是这个参数}

controller

目前，thinkJs支持两种控制器：普通的控制器和多级控制器。支持__before和__after这样的回调钩子，对于app和controller控制来说是非常实用的。使用co来实现也是可圈可点，此处如果使用koa可以更加优雅。例如：

class PathController extends BaseController {  constructor(app, ctx, next) {    super(app, ctx, next)    this.path = &#39;/c&#39;    // this.global_filter.push(&#39;custom_filter&#39;)    this.post_filter = [this.log]  }  before() {  }  log(ctx, next) {
    ctx.someText = &#39;some&#39;    // console.log(&#39;before&#39;)    return next().then(function(){      // console.log(&#39;after&#39;)    })  }  post(req, res) {
    console.log(this.ctx.someText)    var a = this.reqbody.a    return res.body = this.ctx.someText  } 

  after() {  }}

修改 pm2 日志位置

pm2 （官网 http://pm2.keymetrics.io）是一个优秀的 Node.js 进程管理器。thinkjs 推荐使用 pm2 来管理项目运行，并自动生成了 pm2 的配置文件 pm2.json 。

它的强大之处在于不仅可以作为 Node.js 项目的守护进程，还具备可配置化启动、分布式支持、内存监控、热重载（优雅重载）、支持数据统计、运行日志记录、实时运行监控、API 和脚本支持等强大的特性。

默认生成的 pm2 配置文件不含日志记录部分，如果不单独配置，pm2 的日志将会保存在安装目录中，查找起来很不方便。普遍的做法是：在项目目录下建立 logs 文件夹，用来放置 pm2 以及其他（诸如 log4js 等等）日志，打开 pm2.json ，给 apps[0] 增加如下几行配置参数：

{  "apps": [{    "error_file"      : "/data/www/thinkjs_module/logs/pm2-err.log",    "out_file"        : "/data/www/thinkjs_module/logs/pm2-out.log",    "log_date_format" : "YYYY-MM-DD HH:mm:ss Z",    "merge_logs"      : false  }]}

error_file pm2 捕捉到的致命错误记录在这里
out_file pm2 接收到的 console 输出记录在这里
log_date_format 日期和时间格式
merge_logs 是否给日志文件增加进程id的后缀

总结

主要优势：

完全自己实现，对已有框架很少借鉴
内置各种adapter，db，中间件，hook，插件，非常丰富，all in one 比组装更适合新手
遵循mvc和coc
使用最潮的es6/es7/ts特性，对aysnc函数，exports等都非常好的支持
支持i18n等实用功能
内置pm2和nginx集成，部署方便
有自己的脚手架，稍弱
性能不错，虽然比express稍弱，但功能强大许多
测试丰富，代码质量有保障
文档健全，是经过设计的，支持多语言
背后有75团和李成银支持，最近一周内有更新，代码提交2600+，35人贡献，整体来说算健康

附：ThinkJS官网文档

Articles Liés

Voir plus