Grandjs 开源项目教程

Grandjs 开源项目教程

grande.jsIt's a Medium at Starbucks. Pinky ring out.项目地址:https://gitcode.com/gh_mirrors/gr/grande.js

项目介绍

Grandjs 是一个基于 Node.js 的 Web 开发框架，旨在提供一个简单且强大的方式来构建后端应用。它结合了 JavaScript 的现代特性，如 ES6 类和 OOP 编程，使得开发者能够以更直观的方式组织代码和路由。

项目快速启动

安装

首先，确保你的机器上已经安装了 Node.js。然后，通过以下命令安装 Grandjs：

npm i --save grandjs

配置

安装完成后，你需要设置一些基本的配置。以下是一个简单的配置示例：

const Grandjs = require("grandjs");

Grandjs.setConfig({
  port: process.env.PORT || 3000,
  ENCRYPTION_KEY: "your_encryption_key",
  staticFolder: "public",
  session: true,
  setCookie: {
    expires: {
      days: 20,
      minutes: 30
    }
  },
  logger: true,
  errorPage(req, res) {
    res.end("error page");
  }
});

启动服务器

配置完成后，通过以下命令启动服务器：

Grandjs.initServer();

应用案例和最佳实践

路由系统

Grandjs 提供了一个基于 ES6 类的路由系统，可以帮助你组织和管理路由。以下是一个简单的路由示例：

const Grand = require("grandjs");

class MainRoutes extends Grand.Router {
  constructor(options) {
    super(options);
    this.get("/", (req, res) => {
      res.end("Hello, Grandjs!");
    });
  }
}

module.exports = MainRoutes;

中间件

你可以为路由添加中间件，以实现更复杂的功能。以下是一个简单的中间件示例：

class AuthMiddleware extends Grand.Middleware {
  handle(req, res, next) {
    if (req.session.user) {
      next();
    } else {
      res.status(401).end("Unauthorized");
    }
  }
}

module.exports = AuthMiddleware;

典型生态项目

Handlebars 模板引擎

Grandjs 内置了 Handlebars 模板引擎，用于服务器端渲染 HTML 和数据绑定。以下是一个简单的模板渲染示例：

const Grand = require("grandjs");

class ViewRoutes extends Grand.Router {
  constructor(options) {
    super(options);
    this.get("/home", (req, res) => {
      res.render("home", { title: "Home Page" });
    });
  }
}

module.exports = ViewRoutes;

Multiparty 文件上传

Grandjs 使用 Multiparty 库来处理文件上传和请求体解析。以下是一个简单的文件上传示例：

const Grand = require("grandjs");
const multiparty = require("multiparty");

class UploadRoutes extends Grand.Router {
  constructor(options) {
    super(options);
    this.post("/upload", (req, res) => {
      const form = new multiparty.Form();
      form.parse(req, (err, fields, files) => {
        if (err) {
          res.status(500).end("Upload failed");
        } else {
          res.end("File uploaded successfully");
        }
      });
    });
  }
}

module.exports = UploadRoutes;

通过以上步骤，你可以快速启动并使用 Grandjs 构建强大的后端应用。希望这个教程对你有所帮助！

grande.jsIt's a Medium at Starbucks. Pinky ring out.项目地址:https://gitcode.com/gh_mirrors/gr/grande.js