顶

简介环境搭建基础语法基本数据类型变量运算符条件控制循环语句函数模块注释字符串数组指针 map 面向对象错误和异常并发 @符号 #符号开发工具和配置标准库第三方库进阶-HTTP服务进阶-数据库进阶-Redis和Zedis 进阶-爬虫进阶-HTTP代理进阶-TCP和UDP 进阶-WebSocket服务进阶-发送邮件进阶-多线程进阶-JSON和XML 进阶-CSV和EXCEL 进阶-加解密进阶-图像处理进阶-线代和矩阵进阶-插件化进阶-日期和时间进阶-内置函数进阶-日志进阶-命令行进阶-定时任务进阶-二维码

进阶-HTTP服务

用Z1h进行HTTP服务的开发是一件非常简单的事情

启动

在命令行输入

z1h -web 30030

上例可以在30030端口开启http服务

也可以使用配置文件(解压后的conf.json文件)

z1h -conf conf.json

可以看到命令行输出了

Initing z1h...
[Zwei.Ren/Web] Running on port :30030 with 8 routers.
[Zwei.Ren/Web] You may visit at 192.168.1.2:30030

访问下面地址

http://127.0.0.1:30030

可以看到

Hello World! -- ZweiRen.Web

文件结构

在本目录的datas目录下, 自动创建了一些目录和文件, 示例如下:

文件名	用途
api	存放了接口文件
assets	可以存放一些资源文件
front	一般用于存放静态前端文件

接口

在datas/api目录下, 创建以.z1h为后缀名的文件, 就可以创建一个接口

例如:

// datas/api/hello.z1h 文件
"Hello World!"

即可访问 http://127.0.0.1:30030/api/hello 看到该接口返回的数据

请求、响应

在该z1h文件内, 每次请求会有一个全局变量this(也可以request), 类型为*SimpleRouter, 包含了该次http请求的所有请求信息、响应方法

// 请求内容
print(this.Method) // 请求方法, 如get、post、put、delete、options
print(this.Request.URL.String()) // 请求路径
print(this.GetGetParamMap()) // url内的参数
print(this.GetHeaders()) // 请求头信息
print(string(this.GetBody())) // 请求体
print(string(this.GetPostParams())) // 解析后的请求体 
print(this.IP()) // 请求者IP
print(Object.keys(this.GetFileParams())) // 获取请求体内的文件(的字段名)

// 响应方法
this.Redirect(302, "https://z1h.org/") // 将请求302重定向
this.ServeFile("datas/favicon.ico") // 将文件响应出去
this.ResponseHeader("Content-Type", "text/plain") // 设置响应头
this.ResponseStatus(201) // 设置响应状态码
this.Tpl("hello", {title: "模版测试"}) // 响应模版文件(views/hello.tpl)

具体的使用方法详见最下方附录/SimpleRouter

路由

可以在datas/api目录下创建目录, 再在目录下创建.z1h文件, 即可自动讲对应路径的HTTP请求转到该接口

例如:

// datas/api/account/info.z1h 文件
`你的IP: ${this.IP()}, 浏览器: ${this.GetHeader("User-Agent")}`

就可以访问 http://127.0.0.1:30030/api/account/info 看到你的IP和浏览器UserAgent信息了

默认路径

在datas/api 目录(或子目录)下创建index.z1h, 可以处理默认路径

例如:

// datas/api/account/index.z1h 文件
`现在的时间是 ${now()}`

可以访问 http://127.0.0.1:30030/api/account/index 来看到返回的时间信息

也可以忽略最后的index, 直接访问 http://127.0.0.1:30030/api/account/ 看到同样的信息

404页面

在datas/api 目录(或子目录)下创建404.z1h, 可以处理当请求地址不存在的请求

例如:

// datas/api/account/404.z1h 文件
`你走错路啦`

可以访问 http://127.0.0.1:30030/api/account/xxx 来看到404消息

assets资源

assets目录适合存放一些静态资源, 例如jQuery.js等

例如, 把图片复制到datas/assets/logo.png, 就可以通过 http://127.0.0.1:30030/assets/logo.png 获取到图片了.

试试将一个js文件放进去, 然后放一个html文件引用它

front

用于部署VUE等前端框架

首先确定是通过z1h -conf 配置文件的方式启动的
配置文件内的"key"对应的内容不为空, 为更新前端的密钥, 且该行没有被注释
导出dist目录(如使用npm run build)
将dist目录压缩成zip文件
打开 http://127.0.0.1:30030/vueupdate
上传dist.zip、输入密钥、确定

现在可以在 http://127.0.0.1:30030/ 看到你部署的项目了

附录

SimpleRouter

结构体

名称	类型	描述	示例
Method	string	请求方法(小写)	if(this.method!='post')panic("Post Only!")
DisableGZip	bool	是否尝试将结果gzip压缩	this.DisableGZip=false // 确保不压缩
Writer	ResponseWriter	包含Write、WriteHeader、Header方法	this.Writer.Write(bytearray("nihao"))
Request	*net/http.Request	Go标准库结构体	this.Request.URL.String()

获取请求内容相关的方法

名称	描述	参数	返回值	示例
IP	获取请求者IP	-	string
GetGetParamMap	获取url内的所有query参数	-	map[string]string
GetGetParam	获取url内的某个query参数	string 字段名	string 字段值	if(this.GetGetParam("name")=="admin")return `管理员你好`
GetGetIntParam	获取url内的某个query整型参数	string 字段名, int 默认值	int 参数值
GetHeaders	获取请求内的全部头信息	-	map[string][]string
GetHeader	获取请求内的某个头信息	string 头key	string 头value	if(this.GetHeader("User-Agent").contains("android")) return `安卓用户你好`
GetBody	获取请求体原文	-	[]byte	return `请求体长度${len(this.GetBody())}`
GetPostParams	获取反序列化后的的请求体内容	-	map
GetPostParam	获取请求体参数	string 字段名	字段值
GetFileParams	获取form提交的文件	-	map[string]*MultipartFileData
GetFileParam	获取form提交的一个文件	string 字段名	*MultipartFileData

响应相关的方法

名称	描述	参数	返回值	示例
Redirect	重定向	int 状态码, string 链接地址	-	this.Redirect(302,"https://z1h.org")
ServeFile	响应文件	string文件路径	-	this.ServeFile("datas/favicon.ico")
ResponseHeader	设置响应头	string 头部key, string 头部value	-	this.ResponseHeader("Content-Type", "text/plain")
ResponseStatus	设置响应状态码	int 状态码	-	this.ResponseStatus(201)
Tpl	响应模版文件	string 模版名, 模版填充内容, string 子模版…	-	this.Tpl("hello", {title: "模版测试"})