@lcap/nasl 2.18.0 → 2.20.0-beta.1

package/src/concepts/Frontend__.ts

@@ -0,0 +1,937 @@
+import { TranslatorState, shiftState, withSourceMap, indent, createCompilerState } from '../translator';
+import Namespace from './Namespace__';
+
+//================================================================================
+// 从这里开始到结尾注释之间的代码由 NASL Workbench 自动生成，请不手动修改！
+// ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓
+//================================================================================
+import { EventPayload, Params } from '../common/EventEmitter';
+import { concept, excludedInJSON, property } from '../decorators';
+
+import * as utils from '../utils';
+import { v4 as uuidv4 } from 'uuid';
+import BaseNode from '../common/BaseNode';
+import classMap from '../common/classMap';
+import View from './View__';
+import Variable from './Variable__';
+import Theme from './Theme__';
+import Module from './Module__';
+import App, { AssetsInfo } from './App__';
+
+/**
+ * 端
+ */
+@concept('端')
+export class Frontend extends BaseNode {
+    /**
+     * 产品概念
+     */
+    @property()
+    concept: 'Frontend' = 'Frontend';
+
+    /**
+     * 端标识
+     */
+    @property()
+    name: string = undefined;
+
+    /**
+     * pc端
+     */
+    @property()
+    title: string = undefined;
+
+    /**
+     * PC/H5 端
+     */
+    @property()
+    type: 'pc' | 'h5' = undefined;
+
+    /**
+     * 基础路径
+     */
+    @property()
+    path: string = undefined;
+
+    /**
+     * 制品应用标题
+     */
+    @property()
+    documentTitle: string = undefined;
+
+    /**
+     * 制品应用图标
+     */
+    @property()
+    documentIcon: string = undefined;
+
+    /**
+     * 页面列表
+     */
+    @property('View')
+    views: Array<View> = [];
+
+    /**
+     * 变量列表
+     */
+    @property('Variable')
+    variables: Array<Variable> = [];
+
+    /**
+     * 主题配置
+     */
+    @property('Theme')
+    theme: Theme = new Theme();
+
+    /**
+     * 扩展组件列表（兼容老版）
+     */
+    @property('Module')
+    componentDependencies: Array<Module> = [];
+
+    /**
+     * 祖先 App
+     */
+    get app() {
+        return this.getAncestor('App') as App;
+    }
+
+    /**
+     * @param source 需要合并的部分参数
+     */
+    constructor(source?: Partial<Frontend>) {
+        source = Object.assign({}, Frontend.getDefaultOptions(), source);
+        super(source);
+        super.subConstructor(source);
+    }
+
+    static from(source: any, parentNode?: any, parentKey?: string): Frontend {
+        return super.from(source, parentNode, parentKey) as Frontend;
+    }
+
+    /**
+     * 从父级删除该节点
+     * @internal
+     */
+    _delete() {
+        let params: Params = null;
+        if (this.parentNode) {
+            params = (this.parentNode as any)?.__removeFrontend?.(this);
+        }
+        return params;
+    }
+    /**
+     * 设置端标识
+     */
+    setName(name: string) {
+        const object = {
+            name,
+        };
+        this.update({
+            ...object,
+            field: 'name',
+        });
+    }
+
+    /**
+     * 设置pc端
+     */
+    setTitle(title: string) {
+        const object = {
+            title,
+        };
+        this.update({
+            ...object,
+        });
+    }
+
+    /**
+     * 设置基础路径
+     */
+    setPath(path: string) {
+        const object = {
+            path,
+        };
+        this.update({
+            ...object,
+        });
+    }
+
+    /**
+     * 设置制品应用标题
+     */
+    setDocumentTitle(documentTitle: string) {
+        const object = {
+            documentTitle,
+        };
+        this.update({
+            ...object,
+        });
+    }
+
+    /**
+     * 设置制品应用图标
+     */
+    setDocumentIcon(documentIcon: string) {
+        const object = {
+            documentIcon,
+        };
+        this.update({
+            ...object,
+        });
+    }
+
+    getViewExistingNames(excludedList: Array<View> = []) {
+        const excludedSet = new Set(excludedList);
+        return ((this.views as View[]) || []).filter((item) => !excludedSet.has(item)).map((item) => item.name);
+    }
+    getViewUniqueName(name = 'view1') {
+        return utils.unique(name, this.getViewExistingNames(), undefined, true);
+    }
+
+    /**
+    * 插入页面
+    * @internal
+    * @param name 页面名称，如果不填会自动生成一个唯一名称
+    */
+    _insertViewAt(name: string, index: number): View;
+
+    /**
+    * 插入页面
+    * @internal
+    * @param viewOptions 页面参数
+    */
+    _insertViewAt(viewOptions: Partial<View>, index: number): View;
+
+    /**
+    * 插入页面
+    * @internal
+    * @param view 已有的页面实例
+    */
+    _insertViewAt(view: View, index: number): View;
+
+    _insertViewAt(options: string | Partial<View> | View, index: number) {
+        const viewOptions: any = {};
+        const relationOptions = { parentNode: this, parentKey: 'views' };
+        let view: View;
+        if (!options) {
+            view = View.from({
+                ...viewOptions,
+                name: this.getViewUniqueName(),
+            }, this, 'views');
+        } else if (typeof options === 'string') {
+            view = View.from({
+                ...viewOptions,
+                name: options,
+            }, this, 'views');
+        } else if (options instanceof View) {
+            options.ensureDelete(); // 同一实例不支持多处存在
+            view = options;
+            Object.assign(view, relationOptions);
+        } else {
+            view = View.from({
+                ...viewOptions,
+                ...options,
+            }, this, 'views');
+        }
+        this.views.splice(index, 0, view);
+        return view;
+    }
+
+    /**
+     * 插入页面
+     * @param name 页面名称，如果不填会自动生成一个唯一名称
+     */
+    insertViewAt(name: string, index: number): View;
+
+    /**
+     * 插入页面
+     * @param viewOptions 页面参数
+     */
+    insertViewAt(viewOptions: Partial<View>, index: number): View;
+
+    /**
+     * 插入页面
+     * @param view 已有的页面实例
+     */
+    insertViewAt(view: View, index: number): View;
+
+    insertViewAt(options: string | Partial<View> | View, index: number) {
+        const node = this._insertViewAt(options as any, index);
+        node.create({
+            index,
+            parentNode: this,
+            parentKey: 'views',
+        });
+        return node;
+    }
+
+    /**
+     * 添加页面
+     * @internal
+     * @param name 页面名称，如果不填会自动生成一个唯一名称
+     */
+    _addView(name?: string): View;
+
+    /**
+     * 添加页面
+     * @internal
+     * @param viewOptions 页面参数
+     */
+    _addView(viewOptions: Partial<View>): View;
+
+    /**
+     * 添加页面
+     * @internal
+     * @param view 已有的页面实例
+     */
+    _addView(view: View): View;
+
+    _addView(options?: string | Partial<View> | View) {
+        const index = this.views.length;
+        return this._insertViewAt(options as any, index);
+    }
+
+    /**
+     * 添加页面
+     * @internal
+     * @param name 页面名称，如果不填会自动生成一个唯一名称
+     */
+    addView(name?: string): View;
+
+    /**
+     * 添加页面
+     * @param viewOptions 页面参数
+     */
+    addView(viewOptions: Partial<View>): View;
+
+    /**
+     * 添加页面
+     * @param view 已有的页面实例
+     */
+    addView(view: View): View;
+
+    addView(options?: string | Partial<View> | View) {
+        const node = this._addView(options as any);
+        const index = this.views.indexOf(node);
+        node.create({
+            index,
+            parentNode: this,
+            parentKey: 'views',
+        });
+        return node;
+    }
+
+    getVarExistingNames(excludedList: Array<Variable> = []) {
+        const excludedSet = new Set(excludedList);
+        return ((this.variables as Variable[]) || []).filter((item) => !excludedSet.has(item)).map((item) => item.name);
+    }
+    getVariableUniqueName(name = 'variable1') {
+        return utils.unique(name, this.getVarExistingNames(), undefined, true);
+    }
+
+    /**
+    * 插入变量
+    * @internal
+    * @param name 变量名称，如果不填会自动生成一个唯一名称
+    */
+    _insertVariableAt(name: string, index: number): Variable;
+
+    /**
+    * 插入变量
+    * @internal
+    * @param variableOptions 变量参数
+    */
+    _insertVariableAt(variableOptions: Partial<Variable>, index: number): Variable;
+
+    /**
+    * 插入变量
+    * @internal
+    * @param variable 已有的变量实例
+    */
+    _insertVariableAt(variable: Variable, index: number): Variable;
+
+    _insertVariableAt(options: string | Partial<Variable> | Variable, index: number) {
+        const variableOptions: any = {};
+        const relationOptions = { parentNode: this, parentKey: 'variables' };
+        let variable: Variable;
+        if (!options) {
+            variable = Variable.from({
+                ...variableOptions,
+                name: this.getVariableUniqueName(),
+            }, this, 'variables');
+        } else if (typeof options === 'string') {
+            variable = Variable.from({
+                ...variableOptions,
+                name: options,
+            }, this, 'variables');
+        } else if (options instanceof Variable) {
+            options.ensureDelete(); // 同一实例不支持多处存在
+            variable = options;
+            Object.assign(variable, relationOptions);
+        } else {
+            variable = Variable.from({
+                ...variableOptions,
+                ...options,
+            }, this, 'variables');
+        }
+        this.variables.splice(index, 0, variable);
+        return variable;
+    }
+
+    /**
+     * 插入变量
+     * @param name 变量名称，如果不填会自动生成一个唯一名称
+     */
+    insertVariableAt(name: string, index: number): Variable;
+
+    /**
+     * 插入变量
+     * @param variableOptions 变量参数
+     */
+    insertVariableAt(variableOptions: Partial<Variable>, index: number): Variable;
+
+    /**
+     * 插入变量
+     * @param variable 已有的变量实例
+     */
+    insertVariableAt(variable: Variable, index: number): Variable;
+
+    insertVariableAt(options: string | Partial<Variable> | Variable, index: number) {
+        const node = this._insertVariableAt(options as any, index);
+        node.create({
+            index,
+            parentNode: this,
+            parentKey: 'variables',
+        });
+        return node;
+    }
+
+    /**
+     * 添加变量
+     * @internal
+     * @param name 变量名称，如果不填会自动生成一个唯一名称
+     */
+    _addVariable(name?: string): Variable;
+
+    /**
+     * 添加变量
+     * @internal
+     * @param variableOptions 变量参数
+     */
+    _addVariable(variableOptions: Partial<Variable>): Variable;
+
+    /**
+     * 添加变量
+     * @internal
+     * @param variable 已有的变量实例
+     */
+    _addVariable(variable: Variable): Variable;
+
+    _addVariable(options?: string | Partial<Variable> | Variable) {
+        const index = this.variables.length;
+        return this._insertVariableAt(options as any, index);
+    }
+
+    /**
+     * 添加变量
+     * @internal
+     * @param name 变量名称，如果不填会自动生成一个唯一名称
+     */
+    addVariable(name?: string): Variable;
+
+    /**
+     * 添加变量
+     * @param variableOptions 变量参数
+     */
+    addVariable(variableOptions: Partial<Variable>): Variable;
+
+    /**
+     * 添加变量
+     * @param variable 已有的变量实例
+     */
+    addVariable(variable: Variable): Variable;
+
+    addVariable(options?: string | Partial<Variable> | Variable) {
+        const node = this._addVariable(options as any);
+        const index = this.variables.indexOf(node);
+        node.create({
+            index,
+            parentNode: this,
+            parentKey: 'variables',
+        });
+        return node;
+    }
+
+    getModuleExistingNames(excludedList: Array<Module> = []) {
+        const excludedSet = new Set(excludedList);
+        return ((this.componentDependencies as Module[]) || []).filter((item) => !excludedSet.has(item)).map((item) => item.name);
+    }
+    getModuleUniqueName(name = 'module1') {
+        return utils.unique(name, this.getModuleExistingNames(), undefined, false);
+    }
+
+    /**
+    * 插入模块
+    * @internal
+    * @param name 模块名称，如果不填会自动生成一个唯一名称
+    */
+    _insertModuleAt(name: string, index: number): Module;
+
+    /**
+    * 插入模块
+    * @internal
+    * @param moduleOptions 模块参数
+    */
+    _insertModuleAt(moduleOptions: Partial<Module>, index: number): Module;
+
+    /**
+    * 插入模块
+    * @internal
+    * @param module 已有的模块实例
+    */
+    _insertModuleAt(module: Module, index: number): Module;
+
+    _insertModuleAt(options: string | Partial<Module> | Module, index: number) {
+        const moduleOptions: any = {};
+        const relationOptions = { parentNode: this, parentKey: 'componentDependencies' };
+        let module: Module;
+        if (!options) {
+            module = Module.from({
+                ...moduleOptions,
+                name: this.getModuleUniqueName(),
+            }, this, 'componentDependencies');
+        } else if (typeof options === 'string') {
+            module = Module.from({
+                ...moduleOptions,
+                name: options,
+            }, this, 'componentDependencies');
+        } else if (options instanceof Module) {
+            options.ensureDelete(); // 同一实例不支持多处存在
+            module = options;
+            Object.assign(module, relationOptions);
+        } else {
+            module = Module.from({
+                ...moduleOptions,
+                ...options,
+            }, this, 'componentDependencies');
+        }
+        this.componentDependencies.splice(index, 0, module);
+        return module;
+    }
+
+    /**
+     * 插入模块
+     * @param name 模块名称，如果不填会自动生成一个唯一名称
+     */
+    insertModuleAt(name: string, index: number): Module;
+
+    /**
+     * 插入模块
+     * @param moduleOptions 模块参数
+     */
+    insertModuleAt(moduleOptions: Partial<Module>, index: number): Module;
+
+    /**
+     * 插入模块
+     * @param module 已有的模块实例
+     */
+    insertModuleAt(module: Module, index: number): Module;
+
+    insertModuleAt(options: string | Partial<Module> | Module, index: number) {
+        const node = this._insertModuleAt(options as any, index);
+        node.create({
+            index,
+            parentNode: this,
+            parentKey: 'componentDependencies',
+        });
+        return node;
+    }
+
+    /**
+     * 添加模块
+     * @internal
+     * @param name 模块名称，如果不填会自动生成一个唯一名称
+     */
+    _addModule(name?: string): Module;
+
+    /**
+     * 添加模块
+     * @internal
+     * @param moduleOptions 模块参数
+     */
+    _addModule(moduleOptions: Partial<Module>): Module;
+
+    /**
+     * 添加模块
+     * @internal
+     * @param module 已有的模块实例
+     */
+    _addModule(module: Module): Module;
+
+    _addModule(options?: string | Partial<Module> | Module) {
+        const index = this.componentDependencies.length;
+        return this._insertModuleAt(options as any, index);
+    }
+
+    /**
+     * 添加模块
+     * @internal
+     * @param name 模块名称，如果不填会自动生成一个唯一名称
+     */
+    addModule(name?: string): Module;
+
+    /**
+     * 添加模块
+     * @param moduleOptions 模块参数
+     */
+    addModule(moduleOptions: Partial<Module>): Module;
+
+    /**
+     * 添加模块
+     * @param module 已有的模块实例
+     */
+    addModule(module: Module): Module;
+
+    addModule(options?: string | Partial<Module> | Module) {
+        const node = this._addModule(options as any);
+        const index = this.componentDependencies.indexOf(node);
+        node.create({
+            index,
+            parentNode: this,
+            parentKey: 'componentDependencies',
+        });
+        return node;
+    }
+
+    /**
+    * 删除页面
+    * @param name 页面名称
+    */
+    removeView(name: string): void;
+
+    /**
+     * 删除页面
+     * @param view 已有的页面实例
+     */
+    removeView(view: View): void;
+
+    removeView(options: string | View) {
+        let view: View;
+        if (typeof options === 'string') {
+            view = (this.views as View[]).find((item) => item.name === options);
+            if (!view) {
+                throw new Error('找不到页面 ' + options);
+            }
+        } else {
+            view = options;
+        }
+        return view.delete();
+    }
+
+    __removeView(view: View) {
+        const parentKey = view.parentKey;
+        const params: Params = {
+            parentNode: this,
+            parentKey,
+            index: -1,
+            object: null,
+            oldObject: view,
+        };
+        if (parentKey) {
+            params.parentKey = parentKey;
+            if (Array.isArray((this as any)[parentKey])) {
+                const index = (this as any)[parentKey].indexOf(view);
+                ~index && (this as any)[parentKey].splice(index, 1);
+                params.index = index;
+            } else if ((this as any)[parentKey] === view) {
+                params.index = 0;
+                (this as any)[parentKey] = undefined;
+            }
+        }
+        return params;
+    }
+
+    /**
+    * 删除变量
+    * @param name 变量名称
+    */
+    removeVariable(name: string): void;
+
+    /**
+     * 删除变量
+     * @param variable 已有的变量实例
+     */
+    removeVariable(variable: Variable): void;
+
+    removeVariable(options: string | Variable) {
+        let variable: Variable;
+        if (typeof options === 'string') {
+            variable = (this.variables as Variable[]).find((item) => item.name === options);
+            if (!variable) {
+                throw new Error('找不到变量 ' + options);
+            }
+        } else {
+            variable = options;
+        }
+        return variable.delete();
+    }
+
+    __removeVariable(variable: Variable) {
+        const parentKey = variable.parentKey;
+        const params: Params = {
+            parentNode: this,
+            parentKey,
+            index: -1,
+            object: null,
+            oldObject: variable,
+        };
+        if (parentKey) {
+            params.parentKey = parentKey;
+            if (Array.isArray((this as any)[parentKey])) {
+                const index = (this as any)[parentKey].indexOf(variable);
+                ~index && (this as any)[parentKey].splice(index, 1);
+                params.index = index;
+            } else if ((this as any)[parentKey] === variable) {
+                params.index = 0;
+                (this as any)[parentKey] = undefined;
+            }
+        }
+        return params;
+    }
+
+    /**
+    * 删除主题
+    * @param name 主题名称
+    */
+    removeTheme(name: string): void;
+
+    /**
+     * 删除主题
+     * @param theme 已有的主题实例
+     */
+    removeTheme(theme: Theme): void;
+
+    removeTheme(options: string | Theme) {
+        let theme: Theme;
+        if (typeof options === 'string') {
+            theme = this.theme;
+            if (!theme) {
+                throw new Error('找不到主题 ' + options);
+            }
+        } else {
+            theme = options;
+        }
+        return theme.delete();
+    }
+
+    __removeTheme(theme: Theme) {
+        const parentKey = theme.parentKey;
+        const params: Params = {
+            parentNode: this,
+            parentKey,
+            index: -1,
+            object: null,
+            oldObject: theme,
+        };
+        if (parentKey) {
+            params.parentKey = parentKey;
+            if (Array.isArray((this as any)[parentKey])) {
+                const index = (this as any)[parentKey].indexOf(theme);
+                ~index && (this as any)[parentKey].splice(index, 1);
+                params.index = index;
+            } else if ((this as any)[parentKey] === theme) {
+                params.index = 0;
+                (this as any)[parentKey] = undefined;
+            }
+        }
+        return params;
+    }
+
+    /**
+    * 删除模块
+    * @param name 模块名称
+    */
+    removeModule(name: string): void;
+
+    /**
+     * 删除模块
+     * @param module 已有的模块实例
+     */
+    removeModule(module: Module): void;
+
+    removeModule(options: string | Module) {
+        let module: Module;
+        if (typeof options === 'string') {
+            module = (this.componentDependencies as Module[]).find((item) => item.name === options);
+            if (!module) {
+                throw new Error('找不到模块 ' + options);
+            }
+        } else {
+            module = options;
+        }
+        return module.delete();
+    }
+
+    __removeModule(module: Module) {
+        const parentKey = module.parentKey;
+        const params: Params = {
+            parentNode: this,
+            parentKey,
+            index: -1,
+            object: null,
+            oldObject: module,
+        };
+        if (parentKey) {
+            params.parentKey = parentKey;
+            if (Array.isArray((this as any)[parentKey])) {
+                const index = (this as any)[parentKey].indexOf(module);
+                ~index && (this as any)[parentKey].splice(index, 1);
+                params.index = index;
+            } else if ((this as any)[parentKey] === module) {
+                params.index = 0;
+                (this as any)[parentKey] = undefined;
+            }
+        }
+        return params;
+    }
+
+    //================================================================================
+    // ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑
+    // 自动生成的代码已结束。下面可以手动编写。
+    //================================================================================
+
+    findComponentDependencyByName(name: string) {
+        return this.componentDependencies.find((componentDependency) => componentDependency.name === name);
+    }
+
+    /**
+     * @param path 路径
+     * path 为要查找路径：如 /dashboard/student/list、/dashboard/student/list
+     */
+    findViewByPath(path: string) {
+        const arr = path.split('/');
+        if (arr[0] === '')
+            arr.shift();
+
+        if (!arr.length)
+            throw Error('Cannot find View ' + path);
+        const childName = arr.shift();
+        const subView = this.views.find((child) => child.name === childName);
+        return arr.length ? subView.findViewByPath(arr.join('/')) : subView;
+    }
+
+    findViewByName(name: string): View {
+        return utils.traverse((current) => {
+            if (current.node.name === name)
+                return current.node;
+        }, { node: { name: '', children: this.views } });
+    }
+
+    genThemeCSS() {
+        const keys = Object.keys(this.theme?.variableMap || {});
+        if (!keys.length)
+            return;
+
+        return `:root {
+            ${keys.map((key) => `    ${key}: ${this.theme?.variableMap[key]};`).join('\n')}
+        }`;
+    }
+
+    getNamespace() {
+        if (this.parentNode && (this.parentNode as Namespace).getNamespace) {
+            const parentNamespace = (this.parentNode as Namespace).getNamespace();
+            const parentName = this.parentNode.name;
+            const arr = [parentNamespace];
+            if (this.parentNode.concept !== 'App' && parentName) {
+                arr.push(parentName);
+            }
+            return `${arr.join('.')}.frontends`;
+        } else
+            throw new Error('无法获取命名空间，请设置 parentNode！');
+    }
+
+    /**
+     * 生成宿主语言的文件路径
+     * @param name 一般不用传，用于 rename
+     */
+    getEmbeddedFilePath(name = this.name) {
+        return `/embedded/${this.rootNode?.name || this.parentNode.name}/frontends/${name}.ts`;
+    }
+
+    @withSourceMap()
+    toEmbeddedTS(state?: TranslatorState): string {
+        let code = `export namespace ${this.name} {\n`;
+        code += 'const name = ';
+        code += '"' + this.name + '";\n';
+        code += '}\n';
+        return code;
+    }
+    toEmbeddedTSFile() {
+        let code = `namespace ${this.getNamespace()} {\n`;
+
+        const state = createCompilerState(code, { tabSize: 1 });
+        try {
+            code += this.toEmbeddedTS(state);
+        } catch (err) {
+            code += '';
+            console.log(err);
+        }
+        code += '}\n';
+
+        return {
+            code,
+            filePath: this.getEmbeddedFilePath(),
+            sourceMap: state.sourceMap,
+        };
+    }
+
+    getPath() {
+        const path = this.path;
+        const finalPath = path && path !== '/' ? path : '';
+        return finalPath;
+    }
+
+    /**
+     * 为/的转成''，便于url拼接
+     */
+    get basePath() {
+        const path = this.path;
+        const basePath = path && path !== '/' ? path : '';
+        return basePath;
+    }
+
+    genCustomAssetsInfo(prefix: string) {
+        const custom: AssetsInfo = {
+            js: [],
+            css: [],
+            names: [],
+        };
+        const existingSet = new Set();
+        this.componentDependencies.forEach((dep) => {
+            const { name, version } = dep;
+            const jsName = `${prefix}/packages/${name}@${version}/dist-theme/index.js`;
+            if (!existingSet.has(jsName)) {
+                existingSet.add(jsName);
+                custom.js.push(jsName);
+                if (utils.shouldLoadCss(name, version)) {
+                    custom.css.push(`${prefix}/packages/${name}@${version}/dist-theme/index.css`);
+                }
+                custom.names.push(name);
+            }
+        });
+        return custom;
+    }
+
+    //================================================================================
+    // 从这里开始到结尾注释之间的代码由 NASL Workbench 自动生成，请不手动修改！
+    // ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓   ↓
+    //================================================================================
+}
+
+classMap.Frontend = Frontend;
+export default Frontend;
+//================================================================================
+// ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑   ↑
+// 自动生成的代码已结束。下面可以手动编写。
+//================================================================================