@siven-li/elpis 1.0.0

package/app/webpack/config/webpack.base.js

@@ -0,0 +1,194 @@
+const glob = require('glob');
+const path = require('path');
+const fs = require('fs');
+const webpack = require('webpack');
+const merge = require('webpack-merge');
+const { VueLoaderPlugin } = require('vue-loader');
+const HtmlWebpackPlugin = require('html-webpack-plugin');
+
+// 动态构造 elpisPageEntries elpisHtmlWebpackPluginList
+const elpisPageEntries = {};
+const elpisHtmlWebpackPluginList = [];
+// 获取 elpis/app/pages/ 目录下所有入口文件（entry.xxx.js)
+const elpisEntryFiles = glob.sync(path.resolve(__dirname, '../../pages/**/entry.*.js'));
+// 遍历所有入口文件，构建 entry 配置和 HtmlWebpackPlugin 配置
+elpisEntryFiles.forEach(file => {
+  handleFile(file, elpisPageEntries, elpisHtmlWebpackPluginList);
+});
+
+// 动态构造 businessPageEntries businessHtmlWebpackPluginList
+const businessPageEntries = {};
+const businessHtmlWebpackPluginList = [];
+// 获取 business/app/pages/ 目录下所有入口文件（entry.xxx.js)
+const businessEntryFiles = glob.sync(path.resolve(process.cwd(), './app/pages/**/entry.*.js'));
+// 遍历所有入口文件，构建 entry 配置和 HtmlWebpackPlugin 配置
+businessEntryFiles.forEach(file => {
+  handleFile(file, businessPageEntries, businessHtmlWebpackPluginList);
+});
+
+// 构造相关 webpack 处理的数据机构
+function handleFile(entryFile, entries = {}, htmlWebpackPluginList = []) {
+  const entryName = path.basename(entryFile, '.js');
+  entries[entryName] = entryFile;
+  htmlWebpackPluginList.push(
+    new HtmlWebpackPlugin({
+      // 指定要使用的模板
+      template: path.resolve(__dirname, '../../view/entry.tpl'),
+      // 输出文件的路径
+      filename: path.resolve(process.cwd(), './app/public/dist/', `${entryName}.tpl`),
+      // 要注入的代码块
+      chunks: [entryName]
+    }));
+}
+
+// 加载 业务 webpack 配置
+let businessWebpackConfig = {};
+try {
+  businessWebpackConfig = require(`${process.cwd()}/app/webpack.config.js`);
+} catch (e) {}
+
+/**
+ * 基础配置
+ */
+module.exports = merge.smart({
+  // 入口文件配置
+  entry: Object.assign({}, elpisPageEntries, businessPageEntries),
+  // 输出文件配置（决定了打包后的文件输出到哪里）
+  output: {},
+  // 模块解析配置（决定了要加载解析哪些模块，以及如何解析）
+  module: {
+    rules: [
+      {
+        test: /\.vue$/,
+        use: {
+          loader: require.resolve('vue-loader')
+        }
+      }, {
+        test: /\.js$/,
+        // 只对业务代码进行 babel 转换，加快打包速度
+        include: [
+          // 处理 elpis 目录
+          path.resolve(__dirname, '../../pages'),
+          // 处理 业务 目录
+          path.resolve(process.cwd(), './app/pages')
+        ],
+        use: {
+          loader: require.resolve('babel-loader'),
+        }
+      }, {
+        test: /\.(png|jpe?g|gif|svg|ttf|eot|woff2?)$/,
+        type: 'asset', // Webpack 5 内置的 Asset Modules, 等同于 url-loader 带 limit
+        parser: {
+          dataUrlCondition: {
+            maxSize: 300 * 1024
+          }
+        }
+      }, {
+        test: /\.css$/,
+        use: [require.resolve('style-loader'), require.resolve('css-loader')]
+      }, {
+        test: /\.less$/,
+        use: [require.resolve('style-loader'), require.resolve('css-loader'), require.resolve('less-loader')]
+      }
+    ]
+  },
+  // 配置模块解析的具体行为（定义 webpack 在打包时，如何找到并解析具体模块的路径）
+  resolve: {
+    extensions: ['.js', '.vue', 'json', '.css', '.less'],
+    alias: (() => {
+      const aliasMap = {};
+      const blankModulePath = path.resolve(__dirname, '../libs/blank.js');
+      
+      // dashboard 路由扩展配置
+      const businessDashboardRouterConfig = path.resolve(process.cwd(), './app/pages/dashboard/router.js');
+      aliasMap['$businessDashboardRouterConfig'] = fs.existsSync(businessDashboardRouterConfig) ? businessDashboardRouterConfig : blankModulePath;
+
+      // schema-view component 扩展配置
+      const businessComponentConfig = path.resolve(process.cwd(), './app/pages/dashboard/complex-view/schema-view/components/component-config.js');
+      aliasMap['$businessComponentConfig'] = fs.existsSync(businessComponentConfig) ? businessComponentConfig : blankModulePath;
+      
+      // schema-schema-form 扩展配置
+      const businessFromItmeConfig = path.resolve(process.cwd(), './app/pages/widgets/schema-form/form-item-config.js');
+      aliasMap['$businessFromItmeConfig'] = fs.existsSync(businessFromItmeConfig) ? businessFromItmeConfig : blankModulePath;
+
+      // search-bar 扩展配置
+      const businessSearchItemConfig = path.resolve(process.cwd(), './app/pages/widgets/schema-search-bar/search-item-config.js');
+      aliasMap['$businessSearchItemConfig'] = fs.existsSync(businessSearchItemConfig) ? businessSearchItemConfig : blankModulePath;
+      
+      return {
+        // 创建 import 或 require 的别名，来确保模块引入变得更简单
+        'vue': require.resolve('vue'),
+        '@babel/runtime/helpers/asyncToGenerator': require.resolve('@babel/runtime/helpers/asyncToGenerator'),
+        '@babel/runtime/helpers/toConsumableArray': require.resolve('@babel/runtime/helpers/toConsumableArray'),
+        '@babel/runtime/regenerator': require.resolve('@babel/runtime/regenerator'),
+        '$elpisPages': path.resolve(__dirname, '../../pages'),
+        '$elpisCommon': path.resolve(__dirname, '../../pages/common'),
+        '$elpisCurl': path.resolve(__dirname, '../../pages/common/curl.js'),
+        '$elpisUtils': path.resolve(__dirname, '../../pages/common/utils.js'),
+        '$elpisWidgets': path.resolve(__dirname, '../../pages/widgets'),
+        '$elpisHeaderContainer': path.resolve(__dirname, '../../pages/widgets/header-container/header-container.vue'),
+        '$elpisSchemaForm': path.resolve(__dirname, '../../pages/widgets/schema-form/schema-form.vue'),
+        '$elpisSchemaSearchBar': path.resolve(__dirname, '../../pages/widgets/schema-search-bar/schema-search-bar.vue'),
+        '$elpisSchemaTable': path.resolve(__dirname, '../../pages/widgets/schema-table/schema-table.vue'),
+        '$elpisSiderContainer': path.resolve(__dirname, '../../pages/widgets/sider-container/sider-container.vue'),
+        '$elpisStore': path.resolve(__dirname, '../../pages/store'),
+        '$elpisBoot': path.resolve(__dirname, '../../pages/boot.js'),
+        ...aliasMap
+      }
+    })()
+  },
+  // 配置 webpack 插件
+  plugins: [
+    // 复制你在 webpack 配置中定义的适用于普通文件（如 .js、.css）的规则，并将它们应用到 .vue 文件内部的对应语言块上
+    // 这样就可以在 .vue 文件中正常使用 <style> 和 <script>，并且享受 webpack 的完整功能
+    new VueLoaderPlugin(),
+    // 把第三方库暴露到 window context 下
+    new webpack.ProvidePlugin({
+      Vue: 'vue',
+      axios: 'axios',
+      _: 'lodash'
+    }),
+    // 定义全局常量
+    new webpack.DefinePlugin({
+      __VUE_OPTIONS_API__: 'true', // 支持 vue 解析 options api
+      __VUE_PROD_DEVTOOLS__: 'false', // 禁用 vue 调试工具
+      __VUE_PROD_HYDRATION_MISMATCH_DETAILS__: 'false' // 禁用生产环境显示 ”水合“ 信息
+    }),
+    // 构造最终渲染的页面模板
+    ...elpisHtmlWebpackPluginList,
+    ...businessHtmlWebpackPluginList
+  ],
+  // 配置打包输出优化（代码分割、压缩、模块合并、缓存、Tree Shaking等）
+  optimization: {
+    /**
+     * 代码分割 把 js 打包成3种类型
+     * 1. vendor: 第三方 lib 库，基本不会改动，除非依赖版本升级
+     * 2. common: 业务组件的公共模块，如 utils、config 等
+     * 3. entry.{page}: 页面 entry 里的业务组件代码，会经常改动
+     * 目的：把带动和引用频率不一样的 js 区分出来，以达到更好的利用浏览器缓存的效果
+     */
+    splitChunks: {
+      chunks: 'all', // 对同步异步模块都进行分割
+      maxAsyncRequests: 10, // 最大异步加载并行请求数
+      maxInitialRequests: 10, // 入口点最大加载并行请求数
+      cacheGroups: {
+        vendor: {
+          test: /[\\/]node_modules[\\/]/, // 通过 test 筛选出 node_modules 里的模块
+          name: 'vandor', // 打包后的文件名
+          priority: 20, // 优先级，数字越大，优先级越高，确保模块优先被归入此组
+          reuseExistingChunk: true, // 允许复用已存在的 chunk，避免重复打包
+          enforce: true // 强制执行，忽略 minSize 等限制，即使很小也提取出来 
+        },
+        common: {
+          name: 'common',
+          minChunks: 2, // 至少被2个模块引入才提取到 common 中
+          minSize: 1, // 最小分割文件大小（1 byte）,
+          priority: 10,
+          reuseExistingChunk: true
+        }
+      }
+    },
+    // 将 webpack 运行时生成的代码打包到 runtime.js
+    runtimeChunk: true
+  }
+}, businessWebpackConfig);

package/app/webpack/config/webpack.dev.js

@@ -0,0 +1,58 @@
+const path = require('path');
+const webpack = require('webpack');
+const merge = require('webpack-merge');
+
+// 基础配置
+const baseConfig = require('./webpack.base');
+// devServer 配置
+const DEV_SERVER_CONFIG = {
+  HOST: '127.0.0.1',
+  PORT: 9002,
+  HMR_PATH: '__webpack_hmr',
+  TIMEOUT: 20000
+}
+
+const { HOST, PORT, HMR_PATH, TIMEOUT } = DEV_SERVER_CONFIG;
+
+// 开发阶段的 entry 配置需要加入 hmr
+Object.keys(baseConfig.entry).forEach(v => {
+  // 第三方包不作为 hmr 入口
+  if (v !== 'vendor') {
+    baseConfig.entry[v] = [
+      // 主入口文件
+      baseConfig.entry[v],
+      // hmr 更新入口，官方指定的 hmr 路径
+      `${require.resolve('webpack-hot-middleware/client')}?path=http://${HOST}:${PORT}/${HMR_PATH}&timeout=${TIMEOUT}&reload=true`,
+    ]
+  }
+})
+
+// dev环境 webpack 配置
+const webpackConfig = merge(baseConfig, {
+  mode: 'development',
+  // source map 配置
+  devtool: 'eval-cheap-module-source-map',
+  // 输出文件配置
+  output: {
+    filename: 'js/[name]_[chunkhash:8].bundle.js',
+    path: path.resolve(process.cwd(), 'app/public/dist/dev'), // 输出文件存储路径
+    publicPath: `http://${HOST}:${PORT}/public/dist/dev/`, // 外部资源公共路径
+    globalObject: 'this', // 全局对象配置
+  },
+  // 开发阶段插件
+  plugins: [
+    // HotModuleReplacementPlugin 用于实现热模块替换 (Hot Module ReplacementPlugin 简称 HMR)
+    // 模块热替换允许在应用程序运行时替换模块
+    // 能让应用程序一直保持运行状态，极大的提高开发效率
+    new webpack.HotModuleReplacementPlugin({
+      multiStep: false
+    })
+  ]
+});
+
+module.exports = {
+  // devServer 配置,暴露给 dev.js 使用
+  DEV_SERVER_CONFIG,
+  // webpack 配置
+  webpackConfig
+};

package/app/webpack/config/webpack.prod.js

@@ -0,0 +1,114 @@
+const merge = require('webpack-merge');
+const path = require('path');
+const Happypack = require('happypack');
+const os = require('os');
+
+const MiniCssExtractPlugin = require('mini-css-extract-plugin');
+const CleanWebpackPlugin = require('clean-webpack-plugin');
+const CssMinimizerPlugin = require('css-minimizer-webpack-plugin');
+const HtmlWebpackInjectAttributesPlugin = require('html-webpack-inject-attributes-plugin');
+const TerserPlugin = require('terser-webpack-plugin');
+
+// 多线程 build 设置
+const happypackCommonConfig = {
+  debug: false,
+  threadPool: Happypack.ThreadPool({ size: os.cpus().length })
+};
+
+
+// 基础配置
+const baseConfig = require('./webpack.base');
+// 生产环境 webpack 配置
+const webpackConfig = merge(baseConfig, {
+  // 指定生产环境
+  mode: 'production',
+  // 输出文件配置
+  output: {
+    filename: 'js/[name]_[chunkhash:8].bundle.js',
+    path: path.join(process.cwd(), './app/public/dist/prod/'),
+    publicPath: '/dist/prod/',
+    crossOriginLoading: 'anonymous' // 允许跨域加载
+  },
+  // 模块解析配置
+  module: {
+    rules: [{
+      test: /\.css$/,
+      use: [
+        MiniCssExtractPlugin.loader,
+        `${require.resolve('happypack/loader')}?id=css`
+      ]
+    }, {
+      test: /\.js$/,
+       // 只对业务代码进行 babel 转换，加快打包速度
+      include: [
+        // 处理 elpis 目录
+        path.resolve(__dirname, '../../../pages'),
+        // 处理 业务 目录
+        path.resolve(process.cwd(), './app/pages')
+       ],
+       use: [
+         `${require.resolve('happypack/loader')}?id=js`
+       ]
+    }]
+  },
+  performance: {
+    hints: false
+  },
+  plugins: [
+    // 每次 build 前清空 dist 目录
+    new CleanWebpackPlugin(['public/dist'], {
+      root: path.resolve(process.cwd(), './app/'),
+      exclude: [],
+      verbose: true,
+      dry: false
+    }),
+    // 提取公共 css，有效利用缓存
+    new MiniCssExtractPlugin({
+      chunkFilename: 'css/[name]_[contenthash:8].bundle.css'
+    }),
+    // 优化并压缩 css 资源
+    new CssMinimizerPlugin(),
+    // 多线程打包 js，加快打包速度
+    new Happypack({
+      ...happypackCommonConfig,
+      id: 'js',
+      loaders: [`${require.resolve('babel-loader')}?${JSON.stringify({
+        presets: [require.resolve('@babel/preset-env')],
+        plugins: [require.resolve('@babel/plugin-transform-runtime')]
+      })}`]
+    }),
+    // 多线程打包 css，加快打包速度
+    new Happypack({
+      ...happypackCommonConfig,
+      id: 'css',
+      loaders: [{
+        path: require.resolve('css-loader'),
+        options: {
+          importLoaders: 1
+        }
+      }]
+    }),
+    // 浏览器在请求资源时不发送用户的身份凭证
+    new HtmlWebpackInjectAttributesPlugin({
+      crossorigin: 'anonymous'
+    })
+  ],
+  optimization: {
+    // 使用 TerserPlugin 的并发和缓存，提升压缩阶段的性能
+    // 清除 console.log 等无用代码
+    minimize: true,
+    minimizer: [
+      new TerserPlugin({
+        parallel: true, // 利用多核 CPU 来提升压缩速度
+        terserOptions: {
+          compress: {
+            drop_console: true // 清除 console.log 等无用代码
+          },
+          sourceMap: false // 不生成 sourceMap 文件
+        }
+      })
+    ]
+  }
+});
+
+module.exports = webpackConfig;

package/app/webpack/dev.js

@@ -0,0 +1,48 @@
+// 本地开发启动 devServer
+const express = require('express');
+const path = require('path');
+const consoler = require('consoler');
+const webpack = require('webpack');
+const devMiddleware = require('webpack-dev-middleware');
+const hotMiddleware = require('webpack-hot-middleware');
+
+module.exports = () => {
+  // 从 webpack.dev.js 中获取 webpack 配置和 devServer 配置
+  const { webpackConfig, DEV_SERVER_CONFIG } = require('./config/webpack.dev');
+
+  const app = express();
+  const compiler = webpack(webpackConfig);
+
+  // 指定静态文件目录
+  app.use(express.static(path.join(__dirname, '../public/dist')))
+  // 引用 devMiddlerware 中间件（监控文件改动）
+  app.use(devMiddleware(compiler, {
+    // 落地文件
+    writeToDisk: (filePath) => filePath.endsWith('.tpl'),
+    // 资源路径
+    publicPath: webpackConfig.output.publicPath,
+    // headers 配置
+    headers: {
+      'Access-Control-Allow-Origin': '*',
+      'Access-Control-Allow-Headers': 'Content-Type, Authorization, Accept, X-Requested-With',
+      'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS'
+    },
+    stats: {
+      colors: true
+    }
+  }));
+  // 引用 hotMiddleware 中间件（实现热更新通讯）
+  app.use(hotMiddleware(compiler, {
+    path: `/${DEV_SERVER_CONFIG.HMR_PATH}`,
+    log: () => { }
+  }));
+
+  consoler.info('请等待webpack初次构建完成...')
+
+  // 启动 devServer
+  const port = DEV_SERVER_CONFIG.PORT;
+  app.listen(port, () => {
+    console.log(`app listening on port ${port}!`)
+  })
+}
+

package/app/webpack/libs/blank.js

@@ -0,0 +1 @@
+module.exports = {};

package/app/webpack/prod.js

@@ -0,0 +1,18 @@
+const webpack = require('webpack');
+const webpackConfig = require('./config/webpack.prod.js');
+
+module.exports = () => {
+  console.log('\nbuilding for production...\n');
+
+  webpack(webpackConfig, (err, stats) => {
+    if (err) return console.log(err);
+    process.stdout.write(`${stats.toString({
+      colors: true, // 在控制台输出彩色信息
+      modules: false, // 不显示每个模块构建信息
+      children: false, // 不显示子编译任务信息
+      chunks: false, // 不显示每个代码块信息
+      chunkModules: true, // 显示每个代码块包含的模块信息
+    })}\n`)
+  })
+}
+

package/config/config.default.js

@@ -0,0 +1,3 @@
+module.exports = {
+  name: 'lsw'
+}

package/elpis-core/env.js

@@ -0,0 +1,20 @@
+module.exports = (app) => {
+    return {
+        // 是否本地环境
+      isLocal () {
+            return process.env._ENV.trim() === 'local';
+        },
+        // 是否测试环境
+      isBeta () {
+            return process.env._ENV.trim() === 'beta';
+        },
+        // 是否生产环境
+        isProd() {
+            return process.env._ENV.trim() === 'prod';
+        },
+        // 获取当前环境
+        get() {
+            return process.env._ENV.trim() ?? 'local';
+        }
+    }
+}

package/elpis-core/index.js

@@ -0,0 +1,88 @@
+const Koa = require('koa');
+const path = require('path');
+const { sep } = path; // 兼容不同操作系统的路径分隔符（'/')
+const env = require('./env');
+
+// 引入loader
+const configLoader = require('./loader/config');
+const extendLoader = require('./loader/extend');
+const serviceLoader = require('./loader/service');
+const controllerLoader = require('./loader/controller');
+const middlewareLoader = require('./loader/middleware');
+const routerSchemaLoader = require('./loader/router-schema');
+const routerLoader = require('./loader/router');
+
+module.exports = {
+    /* 
+    * 启动项目
+    * @params options 项目配置参数
+    * options = {
+    *   name // 项目名称
+    *   homePage // 项目首页
+    * }
+    */
+    start(options = {}) {
+        const app = new Koa();
+
+        // 应用配置
+        app.options = options;
+
+        // 基础路径
+        app.baseDir = process.cwd();
+
+        // 业务文件路径
+        app.businessPath = path.resolve(app.baseDir, `.${sep}app`);
+
+        // 初始化环境
+        app.env = env();
+        console.log(`当前环境：${app.env.get()}`)
+
+        // 加载config（其他模块可能依赖配置）
+        configLoader(app);
+        console.log(`--- [start] loader configLoader done ---`);
+        // 加载extend（可能需要在其他模块之前加载）
+        extendLoader(app);
+        console.log(`--- [start] loader extendLoader done ---`);
+        // 加载service（依赖config）
+        serviceLoader(app);
+        console.log(`--- [start] loader serviceLoader done ---`);
+        // 加载controller（依赖service）
+        controllerLoader(app);
+        console.log(`--- [start] loader controllerLoader done ---`);
+        // 加载middleware（依赖controller，因为中间件可能使用controller）
+        middlewareLoader(app);
+        console.log(`--- [start] loader middlewareLoader done ---`);
+        // 加载routerSchema（无依赖，但需要在路由注册前加载）
+        routerSchemaLoader(app);
+        console.log(`--- [start] loader routerSchemaLoader done ---`);
+
+    // 注册 elpis 全局中间件
+    const elpisMiddlwareePath = path.resolve(__dirname, `..${sep}app${sep}middleware.js`);
+    const elpisMiddleware = require(elpisMiddlwareePath);
+    elpisMiddleware(app);
+    console.log(`--- [start] loade global elpis middleware done ---`);
+    
+        
+        // 注册 业务 全局中间件
+        try {
+            require(`${app.businessPath}${sep}middleware.js`)(app);
+            console.log(`--- [start] loade global business middleware done ---`)
+        } catch(error) {
+            console.log('[exception] there is no global business middleware file');
+        }
+        // 注册路由
+        routerLoader(app);
+        console.log(`--- [start] loader routerLoader done ---`);
+
+        // 启动服务
+        try {
+            const port = process.env.PORT || 8080;
+            const host = process.env.HOST || '0.0.0.0';
+            app.listen(port, host)
+            console.log(`服务启动成功---port:${port}`)
+        } catch(erorr) {
+            console.error(`服务启动失败：${error}`)
+        }
+        return app;
+    }
+}

package/elpis-core/loader/config.js

@@ -0,0 +1,55 @@
+const path = require('path');
+const { sep } = path;
+/* 
+* config loader
+* @param {object} app koa 实例
+* 配置区分 本地/测试/生产；通过 env 环境读取不同文件配置 env.config
+* 通过 env.config 覆盖 default.config 加载到 app.config中
+*
+* 目录下对应的 config 配置：
+* 默认配置 config/config.default.js
+* 本地配置 config/config.local.js
+* 测试配置 config/config.beta.js
+* 生产配置 config/config.prod.js
+*/
+
+module.exports = (app) => {
+  // elpis config 目录及相关文件
+  const elpisConfigPath = path.resolve(__dirname, `..${sep}..${sep}config`);
+  // 获取 default.config
+  let defaultConfig = require(path.resolve(elpisConfigPath, `.${sep}config.default.js`));
+
+  // 业务 config 目录及相关文件
+  const businessConfigPath = path.resolve(process.cwd(), `.${sep}config`)
+  try {
+    defaultConfig = {
+      ...defaultConfig,
+      ...require(path.resolve(businessConfigPath, `.${sep}config.default.js`))
+    };
+  } catch(e) {
+    if (e.code === 'MODULE_NOT_FOUND') {
+      console.log('[exception] config.default.js not found');
+    } else {
+      console.log('[exception] config.default.js load failed');
+    }
+  }
+  // 获取 env.config
+  let envConfig = {};
+  try {
+    if (app.env.isLocal()) {
+      envConfig = require(path.resolve(businessConfigPath, `.${sep}config.local.js`));
+    } else if (app.env.isBeta()) {
+      envConfig = require(path.resolve(businessConfigPath, `.${sep}config.beta.js`));
+    } else if (app.env.isProd()) {
+      envConfig = require(path.resolve(businessConfigPath, `.${sep}config.prod.js`));
+    }
+  } catch(e) {
+    if (e.code === 'MODULE_NOT_FOUND') {
+      console.log('[exception] there is no env.config file');
+    } else {
+      console.log('[exception] env.config load failed');
+    }
+  }
+  // 覆盖并加载 config 配置
+  app.config = Object.assign({}, defaultConfig, envConfig);
+}

package/elpis-core/loader/controller.js

@@ -0,0 +1,56 @@
+const glob = require('glob');
+const path = require('path');
+const { sep } = path;
+/*
+* controller loader
+* @param {object} app Koa实例
+* 
+* 加载所有controller，最终实现可通过”app.controller.${目录}.${文件}“访问
+* 例子：
+  app/controller
+    |
+    | --  custom-module
+            |
+            | --  custom-controller.js
+  => app.controller.customModule.customController
+*
+*/
+module.exports = (app) => {
+  const controller = {};
+
+  // 读取 elpis/app/controller/**/**.js 下所有文件
+  const elpisControllerPath = path.resolve(__dirname, `..${sep}..${sep}app${sep}controller`);
+  const elpisFileList = glob.sync(path.resolve(elpisControllerPath, `.${sep}**${sep}**.js`));
+  elpisFileList.forEach(file => handleFile(file));
+
+  // 读取 业务/app/controller/**/**.js 下所有文件
+  const businessControllerPath = path.resolve(app.businessPath, `.${sep}controller`);
+  const businessFileList = glob.sync(path.resolve(businessControllerPath, `.${sep}**${sep}**.js`));
+  businessFileList.forEach(file => handleFile(file));
+
+  // 把内容加载到 app.controller下
+  function handleFile(file) {
+    // 提取文件名称
+    let name = path.resolve(file);
+    // 截取路径 app/controller/custom-module/custom-controller.js => custom-module/custom-controller
+    name = name.substring(name.lastIndexOf(`controller${sep}`) + `controller${sep}`.length, name.lastIndexOf('.'));
+    // 把 '-' 统一改成驼峰式，custom-module/custom-controller.js => customModule.customController
+    name = name.replace(/[_-][a-z]/ig, (s) => s.substring(1).toUpperCase());
+    // 把controller挂在到内存 app 对象中
+    let tempController = controller;
+    const names = name.split(sep);
+    for (let i = 0, len = names.length; i < len; ++i) {
+      if (i === len - 1) {
+        const ControllerModule = require(path.resolve(file))(app);
+        tempController[names[i]] = new ControllerModule();
+      } else {
+        if (!tempController[names[i]]) {
+          tempController[names[i]] = {};
+        }
+        tempController = tempController[names[i]]
+        // 最终得到的数据格式 => controller为{ customModule: { customController: {} } }
+      }
+    }
+  };
+  app.controller = controller;
+}