Grasshopper 技术文档

1. 安装指南

1.1 安装 Node.js

Grasshopper 是一个基于 Node.js 的 MVC 框架，因此首先需要安装 Node.js。你可以通过以下步骤安装 Node.js：

1. 访问 Node.js 官网。
2. 下载适合你操作系统的 Node.js 安装包。
3. 按照安装向导完成 Node.js 的安装。

1.2 安装 Grasshopper

在安装 Node.js 之后，你可以通过 npm 安装 Grasshopper。

1. 打开终端或命令行工具。
2. 运行以下命令安装 Grasshopper：

   npm install grasshopper
   

2. 项目的使用说明

2.1 创建一个简单的 "Hello World" 应用

1. 创建一个目录用于存放你的应用：

   mkdir myapp
   cd myapp
   

2. 安装 Grasshopper：

   npm install grasshopper
   

3. 创建一个名为 hello.js 的文件，内容如下：

   var gh = require('grasshopper');
   
   gh.get('/', function() {
       this.renderText('Hello World!');
   });
   
   gh.serve(8080);
   

4. 运行应用：

   node hello.js
   

5. 打开浏览器，访问 http://localhost:8080，你将看到 "Hello World!" 的输出。

2.2 创建一个项目

1. 全局安装 Grasshopper：

   sudo npm install -g grasshopper
   

2. 创建一个新的项目：

   grasshopper project_name
   

3. 安装项目依赖：

   cd project_name
   npm install -d
   

4. 启动服务器并访问 http://localhost:8080：

   node boot.js
   

3. 项目API使用文档

3.1 路由与控制器

Grasshopper 支持通过 gh.get() 和 gh.post() 等方法定义路由。控制器函数可以处理请求并返回响应。

gh.get('/greetings/{name}', function(args) {
    this.model['name'] = args.name;
    this.render('greeting');
});

3.2 模板文件格式 (GHP - GrassHopper Pages)

Grasshopper 使用 GHP 模板文件格式，支持以下语法：

• <% %>：执行 JavaScript 代码。
• <%= %>：执行 JavaScript 代码并将结果转义后输出。
• <%h %>：执行 JavaScript 代码并将结果原样输出。

3.3 依赖注入

Grasshopper 支持依赖注入，可以通过 gh.addToContext() 方法将依赖注入到控制器函数中。

var dependencies = {
    dataService: {
        getStock: function() {
            return 100;
        }
    }
};
gh.addToContext(dependencies);

gh.get('/', function() {
    this.renderText('There are ' + this.dataService.getStock() + ' units in stock!');
});

4. 项目安装方式

Grasshopper 可以通过 npm 进行安装，具体步骤如下：

1. 确保已安装 Node.js。
2. 打开终端或命令行工具。
3. 运行以下命令安装 Grasshopper：

   npm install grasshopper
   

通过以上步骤，你可以成功安装并使用 Grasshopper 框架来开发 Web 应用和服务。