beego的安装以及bee的安装和使用

一、beego的安装

1.beego是什么

beego 是一个快速开发 Go 应用的 HTTP 框架，他可以用来快速开发 API、Web 及后端服务等各种应用，是一个 RESTful 的框架，主要设计灵感来源于 tornado、sinatra 和 flask 这三个框架，但是结合了 Go 本身的一些特性（interface、struct 嵌入等）而设计的一个框架。

2.beego的安装

beego 的安装是典型的 Go 安装包的形式：

go get github.com/astaxie/beego

3.beego的升级

Go 升级,通过该方式用户可以升级 beego 框架，强烈推荐该方式：
```
go get -u github.com/astaxie/beego
```
源码下载升级，用户访问 https://github.com/astaxie/beego ,下载源码，然后覆盖到 $GOPATH/src/github.com/astaxie/beego 目录，然后通过本地执行安装就可以升级了：
```
go install  github.com/astaxie/beego
```

二、bee工具的安装和使用

1.bee是什么

bee 工具是一个为了协助快速开发 beego 项目而创建的项目，通过 bee 您可以很容易的进行 beego 项目的创建、热编译、开发、测试、和部署。类似于前端框架vue的脚手架工具vue-cli。

2.bee的安装

go get github.com/beego/bee

注意：一定要在系统环境变量配置$GOPATH,$GOPATH所对应的目录用来存放Go源码，Go的可运行文件，以及相应的编译之后的包文件。所以这个目录下面有三个子目录：src、bin、pkg，且不能和go的安装目录一样，它默认在"c:/user"目录下，当然自己也可以更改至其他盘，但前提是在该目录下存在go文件夹。

安装好之后，可以在$GOPATH所对应的目录下bin文件夹里找到可执行文件bee.exe

之后，在命令行输入bee，测试是否安装成功，如果出现以下信息，则说明安装成功：

Bee is a Fast and Flexible tool for managing your Beego Web Application.

Usage:

    bee command [arguments]

The commands are:

    version     show the bee & beego version

    migrate     run database migrations

    api         create an api application base on beego framework

    bale        packs non-Go files to Go source files

    new         create an application base on beego framework

    run         run the app which can hot compile

    pack        compress an beego project

    fix         Fixes your application by making it compatible with newer versions of Beego

    dlv         Start a debugging session using Delve

    dockerize   Generates a Dockerfile for your Beego application

    generate    Source code generator

    hprose      Creates an RPC application based on Hprose and Beego frameworks

    pack        Compresses a Beego application into a single file

    rs          Run customized scripts

    run         Run the application by starting a local development server

    server      serving static content over HTTP on port

Use bee help [command] for more information about a command.

如果没有出现以上信息，并提示改命令不存在，可以将bee.exe可执行文件拷贝到go安装目录bin文件夹下

3.bee的使用

`new` 命令

new 命令是新建一个 Web 项目，我们在命令行下执行 bee new <项目名> 就可以创建一个新的项目。但是注意该命令必须在 $GOPATH/src 下执行。最后会在 $GOPATH/src 相应目录下生成如下目录结构的项目：

bee new myproject

[INFO] Creating application...

/gopath/src/myproject/

/gopath/src/myproject/conf/

/gopath/src/myproject/controllers/

/gopath/src/myproject/models/

/gopath/src/myproject/static/

/gopath/src/myproject/static/js/

/gopath/src/myproject/static/css/

/gopath/src/myproject/static/img/

/gopath/src/myproject/views/

/gopath/src/myproject/conf/app.conf

/gopath/src/myproject/controllers/default.go

/gopath/src/myproject/views/index.tpl

/gopath/src/myproject/main.go

13-11-25 09:50:39 [SUCC] New application successfully created!

`api` 命令

上面的 new 命令是用来新建 Web 项目，不过很多用户使用 beego 来开发 API 应用。所以这个 api 命令就是用来创建 API 应用的，执行命令之后如下所示：

bee api apiproject

create app folder: /gopath/src/apiproject

create conf: /gopath/src/apiproject/conf

create controllers: /gopath/src/apiproject/controllers

create models: /gopath/src/apiproject/models

create tests: /gopath/src/apiproject/tests

create conf app.conf: /gopath/src/apiproject/conf/app.conf

create controllers default.go: /gopath/src/apiproject/controllers/default.go

create tests default.go: /gopath/src/apiproject/tests/default_test.go

create models object.go: /gopath/src/apiproject/models/object.go

create main.go: /gopath/src/apiproject/main.go

从上面的目录我们可以看到和 Web 项目相比，少了 static 和 views 目录，多了一个 test 模块，用来做单元测试的。

`run` 命令

bee run 命令是监控 beego 的项目，通过fsnotify监控文件系统。但是注意该命令必须在 $GOPATH/src/appname 下执行。

bee run

13-11-25 09:53:04 [INFO] Uses 'myproject' as 'appname'

13-11-25 09:53:04 [INFO] Initializing watcher...

13-11-25 09:53:04 [TRAC] Directory(/gopath/src/myproject/controllers)

13-11-25 09:53:04 [TRAC] Directory(/gopath/src/myproject/models)

13-11-25 09:53:04 [TRAC] Directory(/gopath/src/myproject)

13-11-25 09:53:04 [INFO] Start building...

13-11-25 09:53:16 [SUCC] Build was successful

13-11-25 09:53:16 [INFO] Restarting myproject ...

13-11-25 09:53:16 [INFO] ./myproject is running...

4. 快速开发API应用

使用命令 bee run -downdoc=true 更新 swagger-ui ，如果 swagger 目录没有 swagger-ui 则会自动下载安装
Swagger 是一套围绕OpenAPI规范构建的开源工具，可以帮助我们设计，构建，编写和使用 REST API
安装成功之后打开地址，出现以下页面