namirasoft-node 1.4.102 → 1.4.104

package/src/BaseApplication.ts

@@ -1,441 +1,444 @@
-import express, { Router } from 'express';
-import cors from "cors";
-import * as fs from "fs";
-import * as path from 'path';
-import serveIndex from "serve-index";
-import swaggerUi from 'swagger-ui-express';
-import swaggerJSDoc from 'swagger-jsdoc';
-import { BaseDatabase } from './BaseDatabase';
-import { ILogger } from "namirasoft-log";
-import { BaseApplicationLink } from './BaseApplicationLink';
-import { EnvService, HTTPMethod, ObjectService, PackageService } from 'namirasoft-core';
-import { ApplicationSchema, BaseVariableSchema, ObjectSchema, SwaggerApplicationBuilder } from 'namirasoft-schema';
-import { BaseController } from './BaseController';
-import { BaseCron } from './BaseCron';
-
-export abstract class BaseApplication<D extends { [name: string]: BaseDatabase }>
-{
-    private linkLoader?: () => Promise<void>;
-    private links: BaseApplicationLink[] = [];
-    protected name_asset: string;
-    protected name_page: string;
-    protected base_path: string;
-    protected dir_asset: string;
-    protected dir_page: string;
-    protected dir_swagger: string;
-    protected path_asset: string;
-    protected path_page: string;
-    protected path_swagger: string;
-    protected pkg: PackageService;
-    protected title: string;
-    protected description: string;
-    protected logo: string;
-    protected version: string;
-    protected mode!: string;
-    public express!: express.Express;
-    public databases!: D;
-    public logger: ILogger;
-    constructor(base_path: string)
-    {
-        this.base_path = base_path;
-        this.name_asset = "asset";
-        this.name_page = "page";
-        this.dir_asset = "./" + this.name_asset;
-        this.dir_page = "./" + this.name_page;
-        this.dir_swagger = "./swagger";
-        this.path_asset = base_path + "/" + this.name_asset;
-        this.path_page = base_path + "/" + this.name_page;
-        this.path_swagger = this.path_page + "/swagger";
-        this.pkg = PackageService.getMain();
-        this.title = this.pkg?.getTitle() ?? "";
-        this.description = this.pkg?.getDescription() ?? "";
-        this.logo = this.pkg?.getLogo() ?? "";
-        this.version = this.pkg?.getVersion() ?? "";
-        this.mode = new EnvService("SERVER_MODE", false).getString("api").toLowerCase();
-        this.logger = this.getILogger();
-        this.addLink = this.addLink.bind(this);
-        this.addLink_Asset = this.addLink_Asset.bind(this);
-        this.addLink_Page = this.addLink_Page.bind(this);
-        this.addLink_Swagger = this.addLink_Swagger.bind(this);
-
-        // create folders
-        this.dir_asset = path.join(path.dirname(this.pkg.getPath()), this.dir_asset);
-        this.dir_page = path.join(path.dirname(this.pkg.getPath()), this.dir_page);
-        this.dir_swagger = path.join(path.dirname(this.pkg.getPath()), this.dir_swagger);
-        if (!fs.existsSync(this.dir_asset))
-            fs.mkdirSync(this.dir_asset);
-        if (!fs.existsSync(this.dir_page))
-            fs.mkdirSync(this.dir_page);
-        if (!fs.existsSync(this.dir_swagger))
-            fs.mkdirSync(this.dir_swagger, { recursive: true });
-    }
-    public abstract getDatabases(): D;
-    protected abstract getILogger(): ILogger;
-    protected abstract getPort(): number;
-    protected abstract getControllers(): any[];
-    protected abstract getTables(): any[];
-    protected abstract getCrons(): any[];
-    protected async foreachController(handler: (generator: (req: express.Request, res: express.Response) => any) => Promise<boolean>)
-    {
-        let controllers = this.getControllers();
-        for (let i = 0; i < controllers.length; i++)
-        {
-            const Template = controllers[i] as any;
-            let con = await handler((req: express.Request, res: express.Response) =>
-            {
-                if (ObjectService.isClass(Template))
-                    return new Template(this, req, res);
-                return Template(this, req, res);
-            });
-            if (!con)
-                break;
-        }
-    }
-    protected async foreachCron(handler: (generator: () => any) => Promise<boolean>)
-    {
-        let crons = this.getCrons();
-        for (let i = 0; i < crons.length; i++)
-        {
-            try
-            {
-                const Template = crons[i] as any;
-                let con = await handler(() =>
-                {
-                    if (ObjectService.isClass(Template))
-                        return new Template(this);
-                    return Template(this);
-                });
-                if (!con)
-                    break;
-            } catch (error)
-            {
-                this.logger.onCatchCritical(error);
-            }
-        }
-    }
-    // start
-    async start()
-    {
-        this.logger.info(`Application was started in mode '${this.mode}'.`);
-        await this.startCrashHandler();
-        await this.startDatabase();
-        if (!process.env.NAMIRASOFT_MUTE)
-        {
-            await this.onBeforeStart();
-            if (this.mode == "api")
-            {
-                await this.startExpress();
-                await this.createSwagger();
-                await this.startSwagger();
-                await this.startHomePage();
-                await this.createAssets();
-                await this.startAssets();
-                await this.createPages();
-                await this.startPages();
-            }
-            await this.startCrons();
-            await this.startOthers();
-            await this.onAfterStart();
-        }
-        else
-        {
-            await this.saveSchema();
-        }
-    }
-    protected async startCrashHandler(): Promise<void>
-    {
-        if (process.env.NAMIRASOFT_MUTE)
-            return;
-
-        process.on('unhandledRejection', (reason) =>
-        {
-            if (reason instanceof Error)
-                this.logger.onCatchCritical(reason);
-            else
-                this.logger.critical(reason + "");
-        });
-        process.on('uncaughtException', (error) =>
-        {
-            this.logger.onCatchFatal(error);
-        });
-    }
-    public async foreachDatabase(handler: (d: BaseDatabase) => Promise<void>): Promise<void>
-    {
-        let names = Object.keys(this.databases);
-        for (let name of names)
-            await handler(this.databases[name]);
-    }
-    protected async startDatabase(): Promise<void>
-    {
-        this.databases = this.getDatabases();
-        await this.foreachDatabase(async database =>
-        {
-            await database.init();
-            await database.connect();
-            await database.sync(false);
-            if (!process.env.NAMIRASOFT_MUTE)
-                await database.seedBefore();
-        });
-        this.logger.success("Databases were connected.");
-    }
-    protected async onBeforeStart(): Promise<void>
-    { }
-    protected async startExpress(): Promise<void>
-    {
-        if (!process.env.NAMIRASOFT_MUTE)
-        {
-            this.express = express();
-            // Express
-            this.express.use(express.static('static'));
-            // Cors
-            this.express.use(cors({ exposedHeaders: '*' }));
-            // api routes
-            this.express.use('/', await this.getRouter());
-            // start server
-            const port = this.getPort();
-            this.express.listen(port, async () =>
-            {
-                this.logger.success(`Server is listening on port ${port}`);
-            });
-        }
-    }
-    protected async startCrons(): Promise<void>
-    {
-        if (!process.env.NAMIRASOFT_MUTE)
-        {
-            this.foreachCron(async generator =>
-            {
-                const template = generator() as BaseCron<D>;
-                template.run();
-                return true;
-            });
-        }
-    }
-    protected async createSwagger(): Promise<void>
-    {
-        let schema = await this.getSchema<BaseController<D, {}, {}, {}>>(c => c.generate_swagger);
-        let builder = new SwaggerApplicationBuilder(schema);
-        let result = builder.runSynch();
-        for (let name of Object.keys(result.controllers))
-        {
-            const lines = result.controllers[name];
-            fs.writeFileSync(this.dir_swagger + "/controller_" + name + ".swg", lines.join("\n"));
-        }
-        for (let name of Object.keys(result.classes))
-        {
-            const lines = result.classes[name];
-            fs.writeFileSync(this.dir_swagger + "/model_" + name + ".swg", lines.join("\n"));
-        }
-    }
-    protected async startSwagger(): Promise<void>
-    {
-        const joptions = {
-            definition: {
-                openapi: "3.0.1",
-                info: {
-                    title: this.title,
-                    description: this.description,
-                    version: this.version,
-                    // license: {
-                    //     name: "MIT",
-                    //     url: "https://spdx.org/licenses/MIT.html",
-                    // },
-                    // contact: {
-                    //     name: "Amir Abolhasani",
-                    //     url: "https://namirasoft.com",
-                    //     email: "accounts@namirasoft.com",
-                    // },
-                },
-                servers: [
-                    {
-                        url: this.base_path,
-                    },
-                ],
-            },
-            apis: [this.dir_swagger + '/*.swg'],
-        };
-        const swaggerSpec = swaggerJSDoc(joptions);
-        var options = {
-            explorer: true
-        };
-        this.express.use(this.path_swagger + "/", swaggerUi.serve, swaggerUi.setup(swaggerSpec, options));
-    }
-    protected async startHomePage(): Promise<void>
-    {
-        this.express.get(this.base_path + "/", (req, res) =>
-        {
-            this.handleHomePage(req, res);
-        });
-    }
-    protected abstract handleHomePage(_: express.Request, __: express.Response): Promise<void>;
-    public getDirOfAsset(name: string)
-    {
-        return this.dir_asset + "/" + name;
-    }
-    public getPathOfAsset(name: string)
-    {
-        return this.path_asset + "/" + name;
-    }
-    protected async createAssets(): Promise<void>
-    { }
-    protected async startAssets(): Promise<void>
-    {
-        this.express.use(this.path_asset + '/',
-            express.static(this.name_asset, { dotfiles: "allow" }),
-            serveIndex(this.name_asset, { icons: true, view: "details", hidden: true }));
-    }
-    public getDirOfPage(name: string)
-    {
-        return this.dir_page + "/" + name;
-    }
-    public getPathOfPage(name: string)
-    {
-        return this.path_page + "/" + name;
-    }
-    protected async createPages(): Promise<void>
-    { }
-    protected async startPages(): Promise<void>
-    {
-        this.express.use(this.path_page + '/',
-            express.static(this.name_page, {
-                dotfiles: "allow", index: false, extensions: ['html']
-            }),
-            serveIndex(this.name_page, {
-                icons: true,
-                view: "details",
-                hidden: false,
-                filter: (filename) => { return filename.endsWith('.html'); }
-
-            }));
-    }
-    protected async startOthers(): Promise<void>
-    {
-    }
-    protected async onAfterStart(): Promise<void>
-    {
-        if (!process.env.NAMIRASOFT_MUTE)
-            await this.foreachDatabase(async database =>
-            {
-                await database.seedAfter();
-            })
-    }
-    protected async getRouter(): Promise<Router>
-    {
-        const router = express.Router({ mergeParams: true });
-        await this.foreachController(async generator =>
-        {
-            try
-            {
-                const template = generator(null as any, null as any);
-                let info = template.getInfo();
-                let handlers = [];
-                if (template.bodyAs.json.enabled)
-                    handlers.push(express.json({ limit: template.bodyAs.json.limit }));
-                if (template.bodyAs.raw.enabled)
-                    handlers.push(express.raw({ type: template.bodyAs.raw.type }));
-                handlers.push((req: express.Request, res: express.Response) =>
-                {
-                    let controller = generator(req, res);
-                    controller.run();
-                });
-                let path = this.base_path + info.path;
-                let ps: BaseVariableSchema[] = await template.getParametersSchema();
-                for (let p of ps)
-                    path = path.replace(`{${p.name}}`, `:${p.name}`);
-                if (info.method == HTTPMethod.GET)
-                    router.get(path, ...handlers);
-                else if (info.method == HTTPMethod.POST)
-                    router.post(path, ...handlers);
-                else if (info.method == HTTPMethod.PUT)
-                    router.put(path, ...handlers);
-                else if (info.method == HTTPMethod.DELETE)
-                    router.delete(path, ...handlers);
-                else
-                    return false;
-            } catch (error)
-            {
-                this.logger.onCatchFatal(error);
-            }
-            return true;
-        });
-        return router;
-    }
-    // schema
-    protected async saveSchema()
-    {
-        let app_schema = await this.getSchema<BaseController<D, {}, {}, {}>>(c => c.generate_sdk);
-        app_schema.toFile("./application.schema");
-    }
-    async getSchema<C>(filter: (controller: C) => boolean): Promise<ApplicationSchema>
-    {
-        let schema = new ApplicationSchema(this.pkg);
-        await this.foreachController(async generator =>
-        {
-            const template = generator(null as any, null as any);
-            template.database = this.databases;
-            if (template instanceof BaseController)
-                if (!filter || filter(template as C))
-                    schema.controllers.push(await template.getSchema());
-            return true;
-        });
-        let tables = this.getTables();
-        for (let i = 0; i < tables.length; i++)
-        {
-            const table = tables[i];
-            let obj = table.getSchema(true, null) as ObjectSchema;
-            schema.tables.push({
-                meta: {
-                    short: table.getShortName()
-                },
-                schema: obj
-            });
-        }
-        schema.check();
-        return schema;
-    }
-    // public 
-    async getLinks(): Promise<BaseApplicationLink[]>
-    {
-        if (this.linkLoader)
-        {
-            this.links = [];
-            await this.linkLoader();
-        }
-        return this.links;
-    }
-    setLinkLoader(linkLoader: () => Promise<void>)
-    {
-        this.linkLoader = linkLoader;
-    }
-    addLink(link: BaseApplicationLink)
-    {
-        this.links.push(link);
-    }
-    addLink_Asset()
-    {
-        this.addLink({
-            name: "Assets",
-            url: this.path_asset + "/",
-            logo: "https://static.namirasoft.com/image/concept/file/blue-yellow.png",
-            description: "This shows the list of all assets of this API"
-        });
-    }
-    addLink_Page()
-    {
-        this.addLink({
-            name: "Pages",
-            url: this.path_page + "/",
-            logo: "https://static.namirasoft.com/image/concept/page/gray.png",
-            description: "This shows the list of all pages of this API"
-        });
-    }
-    addLink_Swagger()
-    {
-        this.addLink({
-            name: "Swagger",
-            url: this.path_swagger + "/",
-            logo: "https://static.namirasoft.com/image/application/swagger/logo/base.png",
-            description: this.description + " Swagger"
-        });
-    }
+import express, { Router } from 'express';
+import cors from "cors";
+import * as fs from "fs";
+import * as path from 'path';
+import serveIndex from "serve-index";
+import swaggerUi from 'swagger-ui-express';
+import swaggerJSDoc from 'swagger-jsdoc';
+import { BaseDatabase } from './BaseDatabase';
+import { ILogger } from "namirasoft-log";
+import { BaseApplicationLink } from './BaseApplicationLink';
+import { EnvService, HTTPMethod, ObjectService, PackageService } from 'namirasoft-core';
+import { ApplicationSchema, BaseVariableSchema, ObjectSchema, SwaggerApplicationBuilder } from 'namirasoft-schema';
+import { BaseController } from './BaseController';
+import { BaseCron } from './BaseCron';
+
+export abstract class BaseApplication<D extends { [name: string]: BaseDatabase }>
+{
+    private linkLoader?: () => Promise<void>;
+    private links: BaseApplicationLink[] = [];
+    protected name_asset: string;
+    protected name_page: string;
+    protected base_path: string;
+    protected dir_asset: string;
+    protected dir_page: string;
+    protected dir_swagger: string;
+    protected path_asset: string;
+    protected path_page: string;
+    protected path_swagger: string;
+    protected pkg: PackageService;
+    protected title: string;
+    protected description: string;
+    protected logo: string;
+    protected version: string;
+    protected mode!: string;
+    public express!: express.Express;
+    public databases!: D;
+    public logger: ILogger;
+    constructor(base_path: string)
+    {
+        this.base_path = base_path;
+        this.name_asset = "asset";
+        this.name_page = "page";
+        this.dir_asset = "./" + this.name_asset;
+        this.dir_page = "./" + this.name_page;
+        this.dir_swagger = "./swagger";
+        this.path_asset = base_path + "/" + this.name_asset;
+        this.path_page = base_path + "/" + this.name_page;
+        this.path_swagger = this.path_page + "/swagger";
+        this.pkg = PackageService.getMain();
+        this.title = this.pkg?.getTitle() ?? "";
+        this.description = this.pkg?.getDescription() ?? "";
+        this.logo = this.pkg?.getLogo() ?? "";
+        this.version = this.pkg?.getVersion() ?? "";
+        this.mode = new EnvService("SERVER_MODE", false).getString("api").toLowerCase();
+        this.logger = this.getILogger();
+        this.addLink = this.addLink.bind(this);
+        this.addLink_Asset = this.addLink_Asset.bind(this);
+        this.addLink_Page = this.addLink_Page.bind(this);
+        this.addLink_Swagger = this.addLink_Swagger.bind(this);
+
+        // create folders
+        this.dir_asset = path.join(path.dirname(this.pkg.getPath()), this.dir_asset);
+        this.dir_page = path.join(path.dirname(this.pkg.getPath()), this.dir_page);
+        this.dir_swagger = path.join(path.dirname(this.pkg.getPath()), this.dir_swagger);
+        if (!fs.existsSync(this.dir_asset))
+            fs.mkdirSync(this.dir_asset);
+        if (!fs.existsSync(this.dir_page))
+            fs.mkdirSync(this.dir_page);
+        if (!fs.existsSync(this.dir_swagger))
+            fs.mkdirSync(this.dir_swagger, { recursive: true });
+    }
+    public abstract getDatabases(): D;
+    protected abstract getILogger(): ILogger;
+    protected abstract getPort(): number;
+    protected abstract getControllers(): any[];
+    protected abstract getTables(): any[];
+    protected abstract getCrons(): any[];
+    protected async foreachController(handler: (generator: (req: express.Request, res: express.Response) => BaseController<{}, any, any, any>) => Promise<boolean>, modes: string[])
+    {
+        let controllers = this.getControllers();
+        for (let i = 0; i < controllers.length; i++)
+        {
+            const Template = controllers[i] as any;
+
+            if (modes.length > 0)
+                if (!Template.modes.includes("*"))
+                    if (!modes.some(mode => Template.modes.includes(mode)))
+                        return;
+
+            let con = await handler((req: express.Request, res: express.Response) =>
+            {
+                if (ObjectService.isClass(Template))
+                    return new Template(this, req, res);
+                return Template(this, req, res);
+            });
+            if (!con)
+                break;
+        }
+    }
+    protected async foreachCron(handler: (generator: () => any) => Promise<boolean>)
+    {
+        let crons = this.getCrons();
+        for (let i = 0; i < crons.length; i++)
+        {
+            try
+            {
+                const Template = crons[i] as any;
+                let con = await handler(() =>
+                {
+                    if (ObjectService.isClass(Template))
+                        return new Template(this);
+                    return Template(this);
+                });
+                if (!con)
+                    break;
+            } catch (error)
+            {
+                this.logger.onCatchCritical(error);
+            }
+        }
+    }
+    // start
+    async start()
+    {
+        this.logger.info(`Application was started in mode '${this.mode}'.`);
+        await this.startCrashHandler();
+        await this.startDatabase();
+        if (!process.env.NAMIRASOFT_MUTE)
+        {
+            await this.onBeforeStart();
+            await this.startExpress();
+            if (this.mode == "api")
+            {
+                await this.createSwagger();
+                await this.startSwagger();
+                await this.startHomePage();
+                await this.createAssets();
+                await this.startAssets();
+                await this.createPages();
+                await this.startPages();
+            }
+            await this.startCrons();
+            await this.startOthers();
+            await this.onAfterStart();
+        }
+        else
+        {
+            await this.saveSchema();
+        }
+    }
+    protected async startCrashHandler(): Promise<void>
+    {
+        if (process.env.NAMIRASOFT_MUTE)
+            return;
+
+        process.on('unhandledRejection', (reason) =>
+        {
+            if (reason instanceof Error)
+                this.logger.onCatchCritical(reason);
+            else
+                this.logger.critical(reason + "");
+        });
+        process.on('uncaughtException', (error) =>
+        {
+            this.logger.onCatchFatal(error);
+        });
+    }
+    public async foreachDatabase(handler: (d: BaseDatabase) => Promise<void>): Promise<void>
+    {
+        let names = Object.keys(this.databases);
+        for (let name of names)
+            await handler(this.databases[name]);
+    }
+    protected async startDatabase(): Promise<void>
+    {
+        this.databases = this.getDatabases();
+        await this.foreachDatabase(async database =>
+        {
+            await database.init();
+            await database.connect();
+            await database.sync(false);
+            if (!process.env.NAMIRASOFT_MUTE)
+                await database.seedBefore();
+        });
+        this.logger.success("Databases were connected.");
+    }
+    protected async onBeforeStart(): Promise<void>
+    { }
+    protected async startExpress(): Promise<void>
+    {
+        if (!process.env.NAMIRASOFT_MUTE)
+        {
+            this.express = express();
+            // Express
+            this.express.use(express.static('static'));
+            // Cors
+            this.express.use(cors({ exposedHeaders: '*' }));
+            // api routes
+            this.express.use('/', await this.getRouter());
+            // start server
+            const port = this.getPort();
+            this.express.listen(port, async () =>
+            {
+                this.logger.success(`Server is listening on port ${port}`);
+            });
+        }
+    }
+    protected async startCrons(): Promise<void>
+    {
+        if (!process.env.NAMIRASOFT_MUTE)
+        {
+            this.foreachCron(async generator =>
+            {
+                const template = generator() as BaseCron<D>;
+                template.run();
+                return true;
+            });
+        }
+    }
+    protected async createSwagger(): Promise<void>
+    {
+        let schema = await this.getSchema<BaseController<D, {}, {}, {}>>(c => c.generate_swagger);
+        let builder = new SwaggerApplicationBuilder(schema);
+        let result = builder.runSynch();
+        for (let name of Object.keys(result.controllers))
+        {
+            const lines = result.controllers[name];
+            fs.writeFileSync(this.dir_swagger + "/controller_" + name + ".swg", lines.join("\n"));
+        }
+        for (let name of Object.keys(result.classes))
+        {
+            const lines = result.classes[name];
+            fs.writeFileSync(this.dir_swagger + "/model_" + name + ".swg", lines.join("\n"));
+        }
+    }
+    protected async startSwagger(): Promise<void>
+    {
+        const joptions = {
+            definition: {
+                openapi: "3.0.1",
+                info: {
+                    title: this.title,
+                    description: this.description,
+                    version: this.version,
+                    // license: {
+                    //     name: "MIT",
+                    //     url: "https://spdx.org/licenses/MIT.html",
+                    // },
+                    // contact: {
+                    //     name: "Amir Abolhasani",
+                    //     url: "https://namirasoft.com",
+                    //     email: "accounts@namirasoft.com",
+                    // },
+                },
+                servers: [
+                    {
+                        url: this.base_path,
+                    },
+                ],
+            },
+            apis: [this.dir_swagger + '/*.swg'],
+        };
+        const swaggerSpec = swaggerJSDoc(joptions);
+        var options = {
+            explorer: true
+        };
+        this.express.use(this.path_swagger + "/", swaggerUi.serve, swaggerUi.setup(swaggerSpec, options));
+    }
+    protected async startHomePage(): Promise<void>
+    {
+        this.express.get(this.base_path + "/", (req, res) =>
+        {
+            this.handleHomePage(req, res);
+        });
+    }
+    protected abstract handleHomePage(_: express.Request, __: express.Response): Promise<void>;
+    public getDirOfAsset(name: string)
+    {
+        return this.dir_asset + "/" + name;
+    }
+    public getPathOfAsset(name: string)
+    {
+        return this.path_asset + "/" + name;
+    }
+    protected async createAssets(): Promise<void>
+    { }
+    protected async startAssets(): Promise<void>
+    {
+        this.express.use(this.path_asset + '/',
+            express.static(this.name_asset, { dotfiles: "allow" }),
+            serveIndex(this.name_asset, { icons: true, view: "details", hidden: true }));
+    }
+    public getDirOfPage(name: string)
+    {
+        return this.dir_page + "/" + name;
+    }
+    public getPathOfPage(name: string)
+    {
+        return this.path_page + "/" + name;
+    }
+    protected async createPages(): Promise<void>
+    { }
+    protected async startPages(): Promise<void>
+    {
+        this.express.use(this.path_page + '/',
+            express.static(this.name_page, {
+                dotfiles: "allow", index: false, extensions: ['html']
+            }),
+            serveIndex(this.name_page, {
+                icons: true,
+                view: "details",
+                hidden: false,
+                filter: (filename) => { return filename.endsWith('.html'); }
+
+            }));
+    }
+    protected async startOthers(): Promise<void>
+    {
+    }
+    protected async onAfterStart(): Promise<void>
+    {
+        if (!process.env.NAMIRASOFT_MUTE)
+            await this.foreachDatabase(async database =>
+            {
+                await database.seedAfter();
+            })
+    }
+    protected async getRouter(): Promise<Router>
+    {
+        const router = express.Router({ mergeParams: true });
+        await this.foreachController(async generator =>
+        {
+            try
+            {
+                const template = generator(null as any, null as any);
+                let info = template.getInfo();
+                let handlers = [];
+                if (template.bodyAs.json.enabled)
+                    handlers.push(express.json({ limit: template.bodyAs.json.limit }));
+                if (template.bodyAs.raw.enabled)
+                    handlers.push(express.raw({ type: template.bodyAs.raw.type }));
+                handlers.push((req: express.Request, res: express.Response) =>
+                {
+                    let controller = generator(req, res);
+                    controller.run();
+                });
+                let path = this.base_path + info.path;
+                let ps: BaseVariableSchema[] = await template.getParametersSchema();
+                for (let p of ps)
+                    path = path.replace(`{${p.name}}`, `:${p.name}`);
+                if (info.method == HTTPMethod.GET)
+                    router.get(path, ...handlers);
+                else if (info.method == HTTPMethod.POST)
+                    router.post(path, ...handlers);
+                else if (info.method == HTTPMethod.PUT)
+                    router.put(path, ...handlers);
+                else if (info.method == HTTPMethod.DELETE)
+                    router.delete(path, ...handlers);
+            } catch (error)
+            {
+                this.logger.onCatchFatal(error);
+            }
+            return true;
+        }, [this.mode]);
+        return router;
+    }
+    // schema
+    protected async saveSchema()
+    {
+        let app_schema = await this.getSchema<BaseController<D, {}, {}, {}>>(c => c.generate_sdk);
+        app_schema.toFile("./application.schema");
+    }
+    async getSchema<C>(filter: (controller: C) => boolean): Promise<ApplicationSchema>
+    {
+        let schema = new ApplicationSchema(this.pkg);
+        await this.foreachController(async generator =>
+        {
+            const template = generator(null as any, null as any);
+            if (template instanceof BaseController)
+                if (!filter || filter(template as C))
+                    schema.controllers.push(await template.getSchema());
+            return true;
+        }, []);
+        let tables = this.getTables();
+        for (let i = 0; i < tables.length; i++)
+        {
+            const table = tables[i];
+            let obj = table.getSchema(true, null) as ObjectSchema;
+            schema.tables.push({
+                meta: {
+                    short: table.getShortName()
+                },
+                schema: obj
+            });
+        }
+        schema.check();
+        return schema;
+    }
+    // public 
+    async getLinks(): Promise<BaseApplicationLink[]>
+    {
+        if (this.linkLoader)
+        {
+            this.links = [];
+            await this.linkLoader();
+        }
+        return this.links;
+    }
+    setLinkLoader(linkLoader: () => Promise<void>)
+    {
+        this.linkLoader = linkLoader;
+    }
+    addLink(link: BaseApplicationLink)
+    {
+        this.links.push(link);
+    }
+    addLink_Asset()
+    {
+        this.addLink({
+            name: "Assets",
+            url: this.path_asset + "/",
+            logo: "https://static.namirasoft.com/image/concept/file/blue-yellow.png",
+            description: "This shows the list of all assets of this API"
+        });
+    }
+    addLink_Page()
+    {
+        this.addLink({
+            name: "Pages",
+            url: this.path_page + "/",
+            logo: "https://static.namirasoft.com/image/concept/page/gray.png",
+            description: "This shows the list of all pages of this API"
+        });
+    }
+    addLink_Swagger()
+    {
+        this.addLink({
+            name: "Swagger",
+            url: this.path_swagger + "/",
+            logo: "https://static.namirasoft.com/image/application/swagger/logo/base.png",
+            description: this.description + " Swagger"
+        });
+    }
 }