企业官网建设流程全解析

网站用的服务器是什么,如何用虚拟主机做网站,电商运营公司,什么叫网站索引Gin框架中的Context为我们提供了多种多样的方法#xff0c;来设置应答状态码、应答头信息、应答体消息#xff01;并且为了方便开发者#xff0c;Gin框架提供了多种应答体格式的便捷处理方法#xff0c;比如JSON、TOML、XML… 1. 状态码 Gin框架提供了func (c *Context) …Gin框架中的Context为我们提供了多种多样的方法来设置应答状态码、应答头信息、应答体消息并且为了方便开发者Gin框架提供了多种应答体格式的便捷处理方法比如JSON、TOML、XML…1. 状态码Gin框架提供了func (c *Context) Status(code int)方法来设置应答的状态码。如果没有显式调用那么默认会写入http.statusOK状态码。除了该方法外很多Gin框架设置应答体的方法也会带有一个状态码参数用于在设置应答体的同时设置应答码。后文会介绍// 示例c.Status(http.StatusBadRequest)2. 头信息2.1. 设置普通HeaderGin框架提供了func (c *Context) Header(key, value string)方法来设置应答的请求头。底层调用c.Writer.Header().Set(key, value)设置请求头。如果参数value为空则表示删除指定key请求头信息。// 示例c.Header(ClientID,12345678)2.2. 设置Cookie对于设置cookie这种常见场景Gin框架提供了如下两个方法来方便我们设置cookiefunc (c *Context) SetCookie(name, value string, maxAge int, path, domain string, secure, httpOnly bool)func (c *Context) SetCookieData(cookie *http.Cookie)// SetCookie 示例c.SetCookie(token,12345678,3600,/,hello.com,false,true)// SetCookieData示例c.SetCookieData(http.Cookie{Name:token,Value:url.QueryEscape(12345678),MaxAge:3600,Path:/,Domain:hello.com,SameSite:http.SameSiteDefaultMode,Secure:false,HttpOnly:true,})3. 应答体Gin框架针对不同的应答体格式提供了对应的便捷方法供开发者使用3.1. 常用格式Gin针对字符串、JSON、TOML、XML、YAML这些常用的应答体格式提供了专门的便捷性方法字符串func (c *Context) String(code int, format string, values ...any)JSONfunc (c *Context) AsciiJSON(code int, obj any)func (c *Context) IndentedJSON(code int, obj any)func (c *Context) JSON(code int, obj any)func (c *Context) JSONP(code int, obj any)func (c *Context) PureJSON(code int, obj any)func (c *Context) SecureJSON(code int, obj any)TOMLfunc (c *Context) TOML(code int, obj any)XMLfunc (c *Context) XML(code int, obj any)YAMLfunc (c *Context) YAML(code int, obj any)3.1.1. Stringfunc (c *Context) String(code int, format string, values ...any)方法向应答体中写入字符串格式的消息code参数用于设置应答状态码。方法支持字符串格式化底层使用的是fmt格式化包。如果没有设置Content-Type请求头该方法会自动设置为text/plain; charsetutf-8.// 示例c.String(http.StatusOK,Hello World: %s,time.Now().Format(2006-01-02 15:04:05))3.1.2. JSONJSON格式相关方法func (c *Context) JSON(code int, obj any)以JSON格式序列化obj然后将结果写入应答体并设置设置Content-Type为application/json; charsetutf-8如果没有设置的话。func (c *Context) AsciiJSON(code int, obj any)与JSON方法相似区别在于会将其中的unicode字符转换为ASCII字符。func (c *Context) IndentedJSON(code int, obj any)与JSON方法相似区别在于会序列化成更方便阅读的JSON带缩紧和结束行。func (c *Context) JSONP(code int, obj any)与JSON方法相似但会根据请求参数决定返回格式支持JSONP跨域请求。func (c *Context) PureJSON(code int, obj any)与JSON方法类似为纯净的JSON响应格式不进行任何特殊的安全处理。func (c *Context) SecureJSON(code int, obj any)与JSON方法类似为增强安全性的JSON响应格式主要用于防止JSON劫持攻击示例仅用于演示正常不会这么写funcTestJson(c*gin.Context){data:Data{ID:1,Name:hello,LongName:abc123!#你好,Html:h1hello world/h1,}c.JSON(http.StatusOK,data)c.AsciiJSON(http.StatusOK,data)c.IndentedJSON(http.StatusOK,data)c.JSONP(http.StatusOK,data)c.PureJSON(http.StatusOK,data)c.SecureJSON(http.StatusOK,data)}请求GET /resp/json?callbackabc HTTP/1.1 Host: 127.0.0.1:8080输出// JSON[{name:abc123!#你好,html:\u003ch1\u003ehello world\u003c/h1\u003e}]// AsciiJSON[{name:abc123!#\u4f60\u597d,html:\u003ch1\u003ehello world\u003c/h1\u003e}]// IndentedJSON[{name:abc123!#你好,html:\u003ch1\u003ehello world\u003c/h1\u003e}]// JSONPabc([{name:abc123!#你好,html:\u003ch1\u003ehello world\u003c/h1\u003e}]);// PureJSON[{name:abc123!#你好,html:h1hello world/h1}]// SecureJSONwhile(1);[{name:abc123!#你好,html:\u003ch1\u003ehello world\u003c/h1\u003e}]3.1.3. TOMLGin框架提供了func (c *Context) TOML(code int, obj any)方法来便于处理TOML格式应答。示例funcTestToml(c*gin.Context){data:struct{Namestringtoml:nameHtmlstringtoml:html}{Name:abc123!#你好,Html:h1hello world/h1,}c.TOML(http.StatusOK,data)}应答name abc123!#你好 html h1hello world/h13.1.4. XMLGin框架提供了func (c *Context) XML(code int, obj any)方法来便于处理XML格式应答。示例// xml不支持匿名结构体typeXmlDatastruct{Namestringxml:nameHtmlstringxml:html}funcTestXml(c*gin.Context){data:XmlData{Name:abc123!#你好,Html:h1hello world/h1,}c.XML(http.StatusOK,data)}应答XmlDatanameabc123!#你好/namehtmllt;h1gt;hello worldlt;/h1gt;/html/XmlData3.1.5. YAMLGin框架提供了func (c *Context) YAML(code int, obj any)方法来便于处理YAML格式应答。示例funcTestYaml(c*gin.Context){data:struct{Namestringyaml:nameHtmlstringyaml:html}{Name:abc123!#你好,Html:h1hello world/h1,}c.YAML(http.StatusOK,data)}应答name:abc123!#你好html:h1hello world/h13.2. 设置字节数组func (c *Context) Data(code int, contentType string, data []byte)方法用于直接向应答体中写入字节数组。code 参数指定状态码。contentType 指定Content-Type头信息data 数据示例funcTestBytes(c*gin.Context){c.Data(http.StatusOK,text/plain,[]byte(hello world))}应答hello world3.3. 从Reader流中读取数据返回func (c *Context) DataFromReader(code int, contentLength int64, contentType string, reader io.Reader, extraHeaders map[string]string)方法用于直接从Reader中读取数据然后向应答中写入读取到的数据。code 参数指定状态码。contentLength 用于设置Content-Length头信息contentType 指定Content-Type头信息reader 数据来源的流extraHeaders 指定其他的头信息示例funcTestReader(c*gin.Context){req,_:http.NewRequest(GET,https://www.baidu.com,nil)response,err:http.DefaultClient.Do(req)iferr!nil{c.String(http.StatusInternalServerError,error)return}c.DataFromReader(http.StatusOK,response.ContentLength,response.Header.Get(Content-Type),response.Body,nil)}应答!DOCTYPEhtml!--STATUS OK--htmlheadmeta http-equivcontent-type contenttext/html;charsetutf-8meta http-equivX-UA-Compatible contentIEEdgemetacontentalwaysnamereferrerlinkrelstylesheettypetext/csshrefhttps://ss1.bdstatic.com/5eN1bjq8AAUYm2zgoY3K/r/www/cache/bdorz/baidu.min.csstitle百度一下你就知道/title/headbodylink#0000ccdividwrapperdividheaddivclasshead_wrapperdivclasss_formdivclasss_form_wrapperdividlgimghidefocustruesrc//www.baidu.com/img/bd_logo1.pngwidth270height129/divformidformnamefaction//www.baidu.com/sclassfminputtypehiddennamebdorz_comevalue1inputtypehiddennameievalueutf-8inputtypehiddennamefvalue8inputtypehiddennamersv_bpvalue1inputtypehiddennamersv_idxvalue1inputtypehiddennametnvaluebaiduspanclassbg s_ipt_wrinputidkwnamewdclasss_iptvaluemaxlength255autocompleteoffautofocusautofocus/spanspanclassbg s_btn_wrinputtypesubmitidsuvalue百度一下classbg s_btnautofocus/span/form/div/divdividu1ahrefhttp://news.baidu.comnametj_trnewsclassmnav新闻/aahrefhttps://www.hao123.comnametj_trhao123classmnavhao123/aahrefhttp://map.baidu.comnametj_trmapclassmnav地图/aahrefhttp://v.baidu.comnametj_trvideoclassmnav视频/aahrefhttp://tieba.baidu.comnametj_trtiebaclassmnav贴吧/anoscripta hrefhttp://www.baidu.com/bdorz/login.gif?loginamp;tplmnamp;uhttp%3A%2F%2Fwww.baidu.com%2f%3fbdorz_come%3d1 nametj_login classlb登录/a/noscriptscriptdocument.write(a hrefhttp://www.baidu.com/bdorz/login.gif?logintplmnuencodeURIComponent(window.location.href(window.location.search??:)bdorz_come1) nametj_login classlb登录/a);/scriptahref//www.baidu.com/more/nametj_briiconclassbristyledisplay:block;更多产品/a/div/div/divdividftCondividftConwpidlhahrefhttp://home.baidu.com关于百度/aahrefhttp://ir.baidu.comAbout Baidu/a/ppidcpcopy;2017nbsp;Baidunbsp;ahrefhttp://www.baidu.com/duty/使用百度前必读/anbsp;ahrefhttp://jianyi.baidu.com/classcp-feedback意见反馈/anbsp;京ICP证030173号nbsp;imgsrc//www.baidu.com/img/gs.gif/p/div/div/div/body/html3.4. 下载文件Gin 框架的 Context 提供了几个用于处理文件的方法包括 File、FileAttachment 和 FileFromFS。下面详细介绍这些方法func (c *Context) File(filepath string)功能直接将指定路径的文件发给客户端用途用于将本地文件作为 HTTP 响应发送特点直接使用操作系统的文件路径设置适当的 Content-Type 头部自动处理文件不存在的情况func (c *Context) FileAttachment(filepath, filename string)功能直接将指定路径的文件以附件的形式发给客户端让浏览器下载文件。用途用于浏览器下载服务器文件。特点在 Content-Disposition 头部设置 attachment提示浏览器下载可以指定下载时的文件名与服务器路径名可以不同同样会自动设置 Content-Typefunc (c *Context) FileFromFS(filepath string, fs http.FileSystem)功能从指定的文件系统中发送文件参数filepath在文件系统中的路径fshttp.FileSystem 接口的实现用途用于从自定义文件系统如嵌入资源、内存文件系统等提供文件适用于需要从非标准文件系统提供文件的场景可以用于提供嵌入到二进制文件中的静态资源使用示例// 直接发送服务器上的文件c.File(/path/to/file.txt)// 强制下载文件下载时显示为 custom-name.txtc.FileAttachment(/path/to/server-file.txt,custom-name.txt)// 从自定义文件系统发送文件customFS:http.Dir(./static)c.FileFromFS(index.html,customFS)这些方法为 Gin 应用提供了灵活的文件服务功能可以根据不同需求选择合适的方法来提供文件服务。3.5. 其他Gin还提供了下面这些应答相关的方法由于不太常用此处不去详细讲解当然后续可也能在专门的博客中去单独讲解。func (c *Context) HTML(code int, name string, obj any)功能: 渲染 HTML 模板并返回给客户端参数:code: HTTP 状态码name: 模板名称obj: 传递给模板的数据使用场景: Web 应用程序返回 HTML 页面如网站页面、管理后台等func (c *Context) Negotiate(code int, config Negotiate)功能: 根据客户端 Accept 头进行内容协商返回适当格式的响应参数:code: HTTP 状态码config: 包含不同响应格式配置的 Negotiate 结构体使用场景: API 服务需要根据客户端请求支持多种响应格式JSON、XML、HTML 等特点: 智能选择最适合客户端的响应格式func (c *Context) ProtoBuf(code int, obj any)功能: 将数据序列化为 Protocol Buffers 格式并返回参数:code: HTTP 状态码obj: 要序列化的数据对象使用场景: 高性能 API 服务、微服务间通信、需要高效序列化的场景优势: 比 JSON 更高效、体积更小func (c *Context) Render(code int, r render.Render)功能: 使用指定的渲染器返回响应是其他渲染方法的基础参数:code: HTTP 状态码r: 实现了 render.Render 接口的渲染器使用场景: 自定义响应格式、需要灵活控制响应内容的场景特点: 通用渲染方法支持多种内置和自定义渲染器func (c *Context) SSEvent(name string, message any)功能: 发送 Server-Sent Events (SSE) 消息参数:name: 事件名称message: 事件数据使用场景: 实时数据推送、实时通知、实时更新等需要服务端向客户端推送数据的场景特点: 单向实时通信客户端可接收服务端推送的事件func (c *Context) Stream(step func(w io.Writer) bool) bool功能: 流式传输响应数据逐步向客户端发送数据参数:step: 一个函数接收 io.Writer返回布尔值控制是否继续流式传输使用场景: 大文件下载、实时日志输出、长时间运行的任务状态更新特点: 支持持续的数据传输适合需要长时间保持连接的场景