4、Go HTTP框架Beego - 快速入门

最新推荐文章于 2023-06-22 23:13:59 发布
最新推荐文章于 2023-06-22 23:13:59 发布
阅读量166 收藏
点赞数
文章标签： 运维 测试 数据库
原文链接：https://my.oschina.net/exit/blog/541283
版权

为什么80%的码农都做不了架构师？>>>   hot3.png

1、创建项目

1.1 bee创建项目

beego 的项目基本都是通过 bee 命令来创建的，所以在创建项目之前确保你已经安装了 bee 工具和 beego。如果你还没有安装，那么请查阅beego 的安装 和 bee 工具的安装。

现在一切就绪我们就可以开始创建项目了，打开终端，进入 $GOPATH/src 所在的目录：

➜  src  bee new quickstart[INFO] Creating application...
/gopath/src/quickstart/
/gopath/src/quickstart/conf/
/gopath/src/quickstart/controllers/
/gopath/src/quickstart/models/
/gopath/src/quickstart/routers/
/gopath/src/quickstart/tests/
/gopath/src/quickstart/static/
/gopath/src/quickstart/static/js/
/gopath/src/quickstart/static/css/
/gopath/src/quickstart/static/img/
/gopath/src/quickstart/views/
/gopath/src/quickstart/conf/app.conf
/gopath/src/quickstart/controllers/default.go
/gopath/src/quickstart/views/index.tpl
/gopath/src/quickstart/routers/router.go
/gopath/src/quickstart/tests/default_test.go
/gopath/src/quickstart/main.go
2014/11/06 18:17:09 [SUCC] New application successfully created!

通过一个简单的命令就创建了一个 beego 项目。他的目录结构如下所示

quickstart
|-- conf
|   `-- app.conf
|-- controllers
|   `-- default.go
|-- main.go
|-- models
|-- routers
|   `-- router.go
|-- static
|   |-- css
|   |-- img
|   `-- js
|-- tests
|   `-- default_test.go
`-- views
    `-- index.tpl

从目录结构中我们也可以看出来这是一个典型的MVC架构的应用，main.go 是入口文件。

1.2 运行项目

beego 项目创建之后，我们就开始运行项目，首先进入创建的项目，我们使用 bee run 来运行该项目，这样就可以做到热编译的效果：

➜  src  cd quickstart
➜  quickstart  bee run
2014/11/06 18:18:34 [INFO] Uses 'quickstart' as 'appname'
2014/11/06 18:18:34 [INFO] Initializing watcher...
2014/11/06 18:18:34 [TRAC] Directory(/gopath/src/quickstart/controllers)
2014/11/06 18:18:34 [TRAC] Directory(/gopath/src/quickstart)
2014/11/06 18:18:34 [TRAC] Directory(/gopath/src/quickstart/routers)
2014/11/06 18:18:34 [TRAC] Directory(/gopath/src/quickstart/tests)
2014/11/06 18:18:34 [INFO] Start building...
2014/11/06 18:18:35 [SUCC] Build was successful
2014/11/06 18:18:35 [INFO] Restarting quickstart ...
2014/11/06 18:18:35 [INFO] ./quickstart is running...
2014/11/06 18:18:35 [app.go:96] [I] http server Running on :8080

这样我们的应用已经在 8080 端口(beego 的默认端口)跑起来了.你是不是觉得很神奇，为什么没有 nginx 和 apache 居然可以自己干这个事情？是的，Go 其实已经做了网络层的东西，beego 只是封装了一下，所以可以做到不需要 nginx 和 apache。让我们打开浏览器看看效果吧：105537_XPVn_218843.png

你内心是否激动了？开发网站如此简单有没有。好了，接下来让我们一层一层的剥离来大概的了解 beego 是怎么运行起来的。


2、路由设置

前面我们已经创建了 beego 项目，而且我们也看到他已经运行起来了，那么是如何运行起来的呢？让我们从入口文件先分析起来吧：

package main
import (
    _ "quickstart/routers"
    "github.com/astaxie/beego"
)
func main() {
    beego.Run()
}

我们看到main函数是入口函数，但是我们知道Go的执行过程是如下图所示的方式：

105712_jD1F_218843.png

这里我们就看到了我们引入了一个包_ "quickstart/routers",这个包只引入执行了里面的init函数，那么让我们看看这个里面做了什么事情：

package routers
import (
    "quickstart/controllers"
    "github.com/astaxie/beego"
)
func init() {
    beego.Router("/", &controllers.MainController{})
    
}

路由包里面我们看到执行了路由注册beego.Router, 这个函数的功能是映射URL到controller，第一个参数是URL(用户请求的地址)，这里我们注册的是 /，也就是我们访问的不带任何参数的URL，第二个参数是对应的 Controller，也就是我们即将把请求分发到那个控制器来执行相应的逻辑，我们可以执行类似的方式注册如下路由：

beego.Router("/user", &controllers.UserController{})

这样用户就可以通过访问 /user 去执行 UserController 的逻辑。这就是我们所谓的路由，更多更复杂的路由规则请查询 beego 的路由设置

再回来看看main函数里面的 beego.Run， beego.Run 执行之后，我们看到的效果好像只是监听服务端口这个过程，但是它内部做了很多事情：

  • 解析配置文件

    beego 会自动在 conf 目录下面去解析相应的配置文件 app.conf，这样就可以通过配置文件配置一些例如开启的端口，是否开启 session，应用名称等各种信息。

  • 执行用户的hookfunc

    beego会执行用户注册的hookfunc，默认的已经存在了注册mime，用户可以通过函数AddAPPStartHook注册自己的启动函数。

  • 是否开启 session

    会根据上面配置文件的分析之后判断是否开启 session，如果开启的话就初始化全局的 session。

  • 是否编译模板

    beego 会在启动的时候根据配置把 views 目录下的所有模板进行预编译，然后存在 map 里面，这样可以有效的提高模板运行的效率，无需进行多次编译。

  • 是否开启文档功能

    根据EnableDocs配置判断是否开启内置的文档路由功能

  • 是否启动管理模块

    beego 目前做了一个很帅的模块，应用内监控模块，会在 8088 端口做一个内部监听，我们可以通过这个端口查询到 QPS、CPU、内存、GC、goroutine、thread 等各种信息。

  • 监听服务端口

    这是最后一步也就是我们看到的访问 8080 看到的网页端口，内部其实调用了 ListenAndServe，充分利用了 goroutine 的优势

一旦 run 起来之后，我们的服务就监听在两个端口了，一个服务端口 8080 作为对外服务，另一个 8088 端口实行对内监控。

通过这个代码的分析我们了解了 beego 运行起来的过程，以及内部的一些机制。接下来让我们去剥离 Controller 如何来处理逻辑的。

3、Controller运行机制

前面我们了解了如何把用户的请求分发到控制器，这小节我们就介绍大家如何来写控制器，首先我们还是从源码分析入手：

package controllers
import (
        "github.com/astaxie/beego"
)
type MainController struct {
        beego.Controller
}
func (this *MainController) Get() {
        this.Data["Website"] = "beego.me"
        this.Data["Email"] = "astaxie@gmail.com"
        this.TplNames = "index.tpl"
 }

上面的代码显示首先我们声明了一个控制器 MainController，这个控制器里面内嵌了 beego.Controller，这就是 Go 的嵌入方式，也就是MainController 自动拥有了所有 beego.Controller 的方法。

而 beego.Controller 拥有很多方法，其中包括 Init、Prepare、Post、Get、Delete、Head等 方法。我们可以通过重写的方式来实现这些方法，而我们上面的代码就是重写了 Get 方法。

我们先前介绍过 beego 是一个 RESTful 的框架，所以我们的请求默认是执行对应 req.Method 的方法。例如浏览器的是 GET 请求，那么默认就会执行 MainController 下的 Get 方法。这样我们上面的 Get 方法就会被执行到，这样就进入了我们的逻辑处理。（用户可以改变这个行为，通过注册自定义的函数名，更加详细的请参考路由设置）

里面的代码是需要执行的逻辑，这里只是简单的输出数据，我们可以通过各种方式获取数据，然后赋值到 this.Data 中，这是一个用来存储输出数据的 map，可以赋值任意类型的值，这里我们只是简单举例输出两个字符串。

最后一个就是需要去渲染的模板，this.TplNames 就是需要渲染的模板，这里指定了 index.tpl，如果用户不设置该参数，那么默认会去到模板目录的 Controller/<方法名>.tpl 查找，例如上面的方法会去 MainController/Get.tpl。

用户设置了模板之后系统会自动的调用 Render 函数（这个函数是在 beego.Controller 中实现的），所以无需用户自己来调用渲染。

当然也可以不使用模版，直接用 this.Ctx.WriteString 输出字符串，如：

func (this *MainController) Get() {
        this.Ctx.WriteString("hello")
}

至此我们的控制器分析基本完成了，接下来让我们看看如何来编写 model。

4、Model逻辑

我们知道 Web 应用中我们用的最多的就是数据库操作，而 model 层一般用来做这些操作，我们的bee new 例子不存在 Model 的演示，但是bee api 应用中存在 model 的应用。说的简单一点，如果你的应用足够简单，那么 Controller 可以处理一切的逻辑，如果您的逻辑里面存在着可以复用的东西，那么就抽取出来变成一个模块。因此 Model 就是逐步抽象的过程，一般我们会在 Model 里面处理一些数据读取，如下是一个日志分析应用中的代码片段：

package models

import (
    "loggo/utils"
    "path/filepath"
    "strconv"
    "strings"
)
var (
    NotPV []string = []string{"css", "js", "class", "gif", "jpg", "jpeg", "png", "bmp", "ico", "rss", "xml", "swf"}
)

const big = 0xFFFFFF

func LogPV(urls string) bool {
    ext := filepath.Ext(urls)
    if ext == "" {
        return true
    }
    for _, v := range NotPV {
        if v == strings.ToLower(ext) {
            return false
        }
    }
    return true
}

所以如果您的应用足够简单，那么就不需要 Model 了；如果你的模块开始多了，需要复用，需要逻辑分离了，那么 Model 是必不可少的。接下来我们将分析如何编写 View 层的东西。

5、View渲染

在前面编写 Controller 的时候，我们在 Get 里面写过这样的语句 this.TplNames = "index.tpl"，设置显示的模板文件，默认支持 tpl 和 html的后缀名，如果想设置其他后缀你可以调用 beego.AddTemplateExt 接口设置，那么模板如何来显示相应的数据呢？beego 采用了 Go 语言默认的模板引擎，所以和 Go 的模板语法一样，Go 模板的详细使用方法请参考《Go Web 编程》模板使用指南

我们看看快速入门里面的代码（去掉了 css 样式）：

<!DOCTYPE html>
<html>
    <head>
        <title>Beego</title>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    </head>
    
    <body>
        <header class="hero-unit" style="background-color:#A9F16C">
            <div class="container">
            <div class="row">
              <div class="hero-text">
                <h1>Welcome to Beego!</h1>
                <p class="description">
                    Beego is a simple & powerful Go web framework which is inspired by tornado and sinatra.                
                    <br />
                    Official website: <a href="http://{{.Website}}">{{.Website}}</a>
                    <br />
                    Contact me: {{.Email}}                
                </p>
              </div>
            </div>
            </div>
        </header>
    </body>
</html>

我们在 Controller 里面把数据赋值给了 data（map 类型），然后我们在模板中就直接通过 key 访问 .Website 和 .Email 。这样就做到了数据的输出。接下来我们讲讲解如何让静态文件输出。

6、静态文件处理

前面我们介绍了如何输出静态页面，但是我们的网页往往包含了很多的静态文件，包括图片、JS、CSS 等，刚才创建的应用里面就创建了如下目录：

├── static
    │   ├── css    
    │   ├── img    
    │   └── js

beego 默认注册了 static 目录为静态处理的目录，注册样式：URL 前缀和映射的目录：

StaticDir["/static"] = "static"

用户可以设置多个静态文件处理目录，例如你有多个文件下载目录 download1、download2，你可以这样映射：

beego.SetStaticPath("/down1", "download1")  
beego.SetStaticPath("/down2", "download2")

这样用户访问 URL http://localhost/down1/123.txt 则会请求 download1 目录下的 123.txt 文件。

转载于:https://my.oschina.net/exit/blog/541283

weixin_33725239
关注
Go: Beego框架快速入门
手写我对你的温柔
10-25 582
beego安装： https://github.com/astaxie/beego https://beego.me/ beego的安装 bee工具安装 bee工具介绍： 工具包 beego项目创建（为了协助快速开发beego项目而创建的项目） 热编译 开发测试 部署 测试是否i成功： go bee version Beego框架： 特点： 快速...
基于Beego+Layui框架快速入门教程
weixin_50196917的博客
06-30 204
一款 Go 语言基于Beego、Layui、MySQL等框架精心打造的一款模块化、高性能、企业级的敏捷开发框架，本着简化开发、提升开发效率的初衷触发，框架自研了一套个性化的组件，实现了可插拔的组件式开发方式：单图上传、多图上传、下拉选择、开关按钮、单选按钮、多选按钮、图片裁剪等等一系列个性化、轻量级的组件，是一款真正意义上实现组件化开发的敏捷开发框架。......
Beego 框架学习笔记 05 | 视图、模板引擎
Wonz
12-16 393
Beego 框架学习笔记 05：视图、模板引擎
beego的模板引擎处理引擎基本语法及使用
PHP、go程序员实例学习记录
01-12 638
beego的模板引擎处理引擎基本语法及使用
beego的mvc的参数配置、路由配置
k393393的博客
02-08 903
1.参数配置     1).在配置文件中设置基本配置 appname = testPoject httpport = 8080 runmode = dev sessionon = true [dev] httpport = 8080 [prod] httpport = 8088 //允许哪些后缀名的静态文件进行 gzip 压缩，默认支持 .css 和 .js StaticExtensionsToGzip = .css, .js include "app2.conf"
beego修改端口，配置文件不生效
枝袅的博客
07-23 2977
在goland中使用beego时配置文件app.conf不起作用。 解决方法 工作目录改为main目录的父目录，这样就可以了。
【1 beego学习 -MAC框架与ORM数据库】
最新发布
qq_31421983的博客
06-22 855
Beego中内嵌了ORM框架，用来操作数据库。那么ORM框架是什么呢？ORM框架是Object-RelationShipMapping的缩写，中文叫关系对象映射.可以不再使用sql语句可以操作数据库.执行数据库操作，这一步分为两种情况，一种是增删改(Exec)，一种是查询(Query)，因为增删改不返回数据，只返回。执行结果，查询要返回数据，所以这两块的操作函数不一样。在models文件夹下新建一个model.go。在main.go,导入models。数据库不能通过orm创建。表的创建在model。
Go-ATC快速开发Go应用程序的开源框架
08-13
ATC，全称为 Application Template for Cloud，是一款专为Go语言设计的开源框架，旨在加速Go应用程序的开发过程。它提供了一套完整的结构和工具，帮助开发者构建RESTful API和Thrift RPC服务，使得开发工作更加高效...
Beego+Vue+ElementUI框架快速入门教程
weixin_50196917的博客
05-24 150
一款 Go 语言基于Beego、Vue、ElementUI、MySQL等框架精心打造的一款模块化、插件化、高性能的前后端分离架构敏捷开发框架，可快速搭建前后端分离后台管理系统，本着简化开发、提升开发效率的初衷，框架自研了一套个性化的组件，实现了可插拔的组件式开发方式，同时为了敏捷快速开发，框架特地集成了代码生成器，完全自主研发了自定义GO后端服务模板和前端Vue自定义模板，可以根据已建好的表结构，可以快速的一键生成整个模块的所有代码和增删改查等等功能业务，真正实现了低代码开发方式，极大的节省了人力...
Beego的参数配置
热门推荐
DocRyze的博客
12-07 2万+
beego参数配置
GO语言Beego框架之WEB安全小系统（番外篇）端口一直被占据
陈小星的博客
09-11 958
GO语言学习——用beego框架搭建WEB安全小系统（番外篇）端口被占据
Golang Gin监听多个端口
稻草人技术博客
02-21 1万+
package main import ( &quot;log&quot; &quot;net/http&quot; &quot;time&quot; &quot;github.com/gin-gonic/gin&quot; &quot;golang.org/x/sync/errgroup&quot; ) var ( g errgroup.Group ) func router01() http.Handle
beego 基本操作及配置信息
誓言
05-09 3246
在线文档 https://beego.me/docs/install/bee.md beego使用Go安装包的形式，需要提前安装好go环境 go get github.com/beego/bee beego 升级 go 方式升级 Go 升级,通过该方式用户可以升级 beego 框架，强烈推荐该方式： go get -u github.com/astaxie/beego 安装完之后，bee 可...
解决beego中同时开启http和https时,https端口占用问题
chenchongg的博客
12-27 2583
在beego的配置文件中app.conf配置HTTP和HTTPS的相关配置 appname = ebsServer autorender = false httpport = 8094 runmode = dev EnableHTTPS=true EnableHttpTLS = true HttpsPort = 9092 HTTPSCertFile = "server.crt" HTTPSKe...
beego路由以及配置
s1095622320的博客
02-11 1583
路由1 在routers/router.go 中func init()写入 beego.Router("/a", &controllers.MainController{},"get:GetHello") 第三个参数是get请求的MainController控制器中GetHello方法 路由2 控制器demo package controllers import ( "github.com/astaxie/beego" ) type DemoController struct
beego小技巧两则：通过命令行自定义端口和环境,url中带有中划线处理
weixin_34072458的博客
09-15 299
1，通过命令行自定义端口和环境 先用flag提取参数，如果要环境，就反向注进去， 如果是端口，就打到beego.Run函数里去。 2,在作router里的url解析时，如果URL中含有-中划线，用严格的string是不能匹配的。 需要去掉这个string限定。 package main import ( "flag" "fmt" _ "prismlogapi/rou...
beego: panic: 'detail' method doesn't exist in the controller StudentController
编程技术提升
03-27 1231
beego使用报错 panic: 'detail' method doesn't exist in the controller StudentController goroutine 1 [running]: github.com/astaxie/beego.(*ControllerRegister).addWithMethodParams(0xc0000d8d10, 0x164d100, 0...
Go语言Beego框架快速入门与特性介绍
"Beego中文文档PDF版，便于在平板设备上阅读，涵盖了Go语言的Beego框架的详细知识，包括快速入门、RESTful支持、MVC模型、智能路由、ORM模块、模板处理等多个方面。" Beego是一个基于Go语言的开源框架，设计时充分...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值