dotweb

Dotweb

Framework Web Micro Framework ง่ายและง่าย

สำคัญ: ตอนนี้ต้องการการสนับสนุนเวอร์ชัน GO1.9+ และสนับสนุน GO mod

เอกสาร: https://www.kancloud.cn/devfeel/dotweb/346608

คู่มือ: https://github.com/devfeel/dotweb/blob/master/docs/guide.md

1. ติดตั้ง

 go get github.com/devfeel/dotweb

2. การเริ่มต้น

 package main

import (
	"fmt"
	"github.com/devfeel/dotweb"
)

func main () {
	//init DotApp
	app := dotweb . New ()
	//set log path
	app . SetLogPath ( "/home/logs/wwwroot/" )
	//set route
	app . HttpServer . GET ( "/index" , func ( ctx dotweb. Context ) error {
		return ctx . WriteString ( "welcome to my first web!" )
	})
	//begin server
	fmt . Println ( "dotweb.StartServer begin" )
	err := app . StartServer ( 80 )
	fmt . Println ( "dotweb.StartServer error => " , err )
}

ตัวอย่าง: https://github.com/devfeel/dotweb-example

3. คุณสมบัติ

• สนับสนุน GO mod
• รองรับการกำหนดเส้นทางแบบคงที่การกำหนดเส้นทางพารามิเตอร์และการกำหนดเส้นทางกลุ่ม
• การกำหนดเส้นทางรองรับบริการไฟล์/ไดเรกทอรีและรองรับการตั้งค่าว่าจะอนุญาตให้เรียกดูไดเรกทอรี
• HTTPModule รองรับรองรับความสามารถในการกำหนดรหัสระดับโลกก่อนการกำหนดเส้นทาง
• การสนับสนุนมิดเดิลแวร์รองรับแอพ, กลุ่ม, การตั้งค่าระดับเราเตอร์ - https://github.com/devfeel/middleware
• การรองรับคุณสมบัติสามารถผูกมัดกับ httpserver เพื่อเปิดใช้งานทั่วโลก
• รองรับสตริง/JSON/JSONP/HTML เอาต์พุตรูปแบบ
• ความสามารถในการจำลองแบบบูรณาการ
• สนับสนุนบริบทที่กำหนดเอง
• เบ็ดหมดเวลาแบบบูรณาการ
• การจัดการข้อผิดพลาด HTTP ทั่วโลก
• การประมวลผลบันทึกทั่วโลก
• สนับสนุนการจี้และ WebSocket
• รองรับแคชในตัว
• การสนับสนุนเซสชันในตัว - รองรับการสลับอัตโนมัติของ Redis หลักและรองโดยอัตโนมัติ
• รองรับ TLS ในตัว
• สนับสนุนการเข้าถึงเครื่องยนต์เทมเพลตของบุคคลที่สาม (ต้องใช้การใช้งานอินเตอร์เฟส dotweb.renderer)
• โมดูลที่กำหนดค่าได้
• สถิติพื้นฐานที่รวมเข้าด้วยตนเองและสนับสนุนการส่งออกของสถิติช่วงเวลาในนาที

ตัวอย่างการกำหนดค่า

• dotweb.conf
• dotweb.json

4. ประสิทธิภาพ

Dotweb	1.9.2	16Core16G
ซีพียู	หน่วยความจำ	ตัวอย่าง	เฉลี่ย	ค่ามัธยฐาน	บรรทัด 90%	บรรทัด 95%	บรรทัด 99%	นาที	สูงสุด	ข้อผิดพลาด%	ปริมาณงาน	ได้รับ kb/วินาที	ส่ง kb/วินาที
40%	39m	15228356	19	4	43	72	204	0	2070	0.00%	48703.47	7514.79	8656.28
40%	42m	15485189	18	4	41	63	230	0	3250	0.00%	49512.99	7639.7	8800.16
40%	44m	15700385	18	3	41	64	233	0	2083	0.00%	50203.32	7746.22	8922.86
ก้อง	1.9.2	16Core16G
ซีพียู	หน่วยความจำ	ตัวอย่าง	เฉลี่ย	ค่ามัธยฐาน	บรรทัด 90%	บรรทัด 95%	บรรทัด 99%	นาที	สูงสุด	ข้อผิดพลาด%	ปริมาณงาน	ได้รับ kb/วินาที	ส่ง kb/วินาที
38%	35m	15307586	19	4	44	76	181	0	พ.ศ. 2351	0.00%	48951.22	6166.71	9034.94
36%	35m	15239058	19	4	45	76	178	0	2546	0.00%	48734.26	6139.37	8994.9
37%	37m	15800585	18	3	41	66	229	0	2355	0.00%	50356.09	6343.68	9294.24
จิน	1.9.2	16Core16G
ซีพียู	หน่วยความจำ	ตัวอย่าง	เฉลี่ย	ค่ามัธยฐาน	บรรทัด 90%	บรรทัด 95%	บรรทัด 99%	นาที	สูงสุด	ข้อผิดพลาด%	ปริมาณงาน	ได้รับ kb/วินาที	ส่ง kb/วินาที
36%	36 เมตร	15109143	19	6	44	71	175	0	3250	0.00%	48151.87	5877.91	8746.33
36%	40m	15255749	19	5	43	70	189	0	3079	0.00%	48762.53	5952.45	8857.25
36%	40m	15385401	18	4	42	66	227	0	2312	0.00%	49181.03	6003.54	8933.27

5. เราเตอร์

1) การกำหนดเส้นทางทั่วไป

• รองรับ get post head opotion put patch ลบวิธีการร้องขอประเภทนี้
• รองรับแอปพลิเคชั่นพิเศษสามประเภท: Hijack WebSocket ServerFile
• สนับสนุนวิธีการลงทะเบียนใด ๆ และค่าเริ่มต้นเข้ากันได้กับ Get post head Options Put Patch DELETE
• รองรับโหมดหัวเริ่มต้นเพื่อเปิดใช้งานการกำหนดค่าที่จะเปิดใช้งาน
• รองรับการลงทะเบียนของตัวจัดการเพื่อเปิดใช้งานการกำหนดค่า
• รองรับการตรวจสอบว่าคำขอตรงกับเส้นทางที่ระบุหรือไม่

 Router . GET ( path string , handle HttpHandle )
Router . POST ( path string , handle HttpHandle )
Router . HEAD ( path string , handle HttpHandle )
Router . OPTIONS ( path string , handle HttpHandle )
Router . PUT ( path string , handle HttpHandle )
Router . PATCH ( path string , handle HttpHandle )
Router . DELETE ( path string , handle HttpHandle )
Router . HiJack ( path string , handle HttpHandle )
Router . WebSocket ( path string , handle HttpHandle )
Router . Any ( path string , handle HttpHandle )
Router . RegisterRoute ( routeMethod string , path string , handle HttpHandle )
Router . RegisterHandler ( name string , handler HttpHandle )
Router. GetHandler ( name string ) ( HttpHandle , bool )
Router . MatchPath ( ctx Context , routePath string ) bool

ยอมรับพารามิเตอร์สองพารามิเตอร์หนึ่งคือเส้นทาง URI และอีกเส้นทางหนึ่งคือประเภท httphandle การตั้งค่าวิธีการเพื่อดำเนินการเมื่อจับคู่เส้นทาง;

2) เราเตอร์แบบคงที่

ไวยากรณ์การกำหนดเส้นทางแบบคงที่หมายความว่าไม่มีตัวแปรพารามิเตอร์รูปแบบเป็นสตริงคงที่

 package main

import (
    "github.com/devfeel/dotweb"
)

func main () {
    dotapp := dotweb . New ()
    dotapp . HttpServer . GET ( "/hello" , func ( ctx dotweb. Context ) error {
        return ctx . WriteString ( "hello world!" )
    })
    dotapp . StartServer ( 80 )
}

ทดสอบ: Curl http://127.0.0.1/hello

3) เราเตอร์พารามิเตอร์

การกำหนดเส้นทางพารามิเตอร์ตามด้วยสตริงเป็นชื่อพารามิเตอร์ คุณสามารถรับค่าของพารามิเตอร์การกำหนดเส้นทางผ่านวิธี getRoutername ของ httpContext

 package main

import (
    "github.com/devfeel/dotweb"
)

func main () {
    dotapp := dotweb . New ()
    dotapp . HttpServer . GET ( "/hello/:name" , func ( ctx dotweb. Context ) error {
        return ctx . WriteString ( "hello " + ctx . GetRouterName ( "name" ))
    })
    dotapp . HttpServer . GET ( "/news/:category/:newsid" , func ( ctx dotweb. Context ) error {
    	category := ctx . GetRouterName ( "category" )
	    newsid := ctx . GetRouterName ( "newsid" )
        return ctx . WriteString ( "news info: category=" + category + " newsid=" + newsid )
    })
    dotapp . StartServer ( 80 )
}

ทดสอบ:
curl http://127.0.0.1/hello/devfeel
Curl http://127.0.0.1/hello/category1/1

4) เราเตอร์กลุ่ม

    g := server . Group ( "/user" )
	g . GET ( "/" , Index )
	g . GET ( "/profile" , Profile )

ทดสอบ:
Curl http://127.0.0.1/user
Curl http://127.0.0.1/user/profile

6. เครื่องผูก

• httpContext.bind (อินเตอร์เฟส {})
• สนับสนุนข้อมูลจาก JSON, XML, แบบฟอร์ม

 type UserInfo struct {
		UserName string `form:"user"`
		Sex      int    `form:"sex"`
}

func TestBind ( ctx dotweb. HttpContext ) error {
        user := new ( UserInfo )
        if err := ctx . Bind ( user ); err != nil {
        	 return ctx . WriteString ( "err => " + err . Error ())
        } else {
             return ctx . WriteString ( "TestBind " + fmt . Sprint ( user ))
        }
}

7. มิดเดิลแวร์

มิดเดิลแวร์

• สนับสนุนความละเอียด: แอพ, กลุ่ม, routernode
• dotweb.use (M ... มิดเดิลแวร์)
• group.use (M ... มิดเดิลแวร์)
• routernode.use (M ... มิดเดิลแวร์)
• เปิดใช้งานการสั่งซื้อ: แอพ -> กลุ่ม -> routernode, ดำเนินการในระดับเดียวกันในลำดับการแนะนำการใช้งาน
• สำหรับข้อมูลเพิ่มเติมโปรดดูที่: https://github.com/devfeel/middleware
• JWT - ตัวอย่าง
• Accesslog - ตัวอย่าง
• cors - ตัวอย่าง
• gzip - ตัวอย่าง
• การอนุมัติตาม Casbin - ตัวอย่าง - Casbin คืออะไร?
• BasicAuth - ตัวอย่าง
• โดเมน - ตัวอย่าง
• ฟื้นตัว
• READEROVERRIDE

 app . Use ( NewAccessFmtLog ( "app" ))

func InitRoute ( server * dotweb. HttpServer ) {
	server . GET ( "/" , Index )
	server . GET ( "/use" , Index ). Use ( NewAccessFmtLog ( "Router-use" ))

	g := server . Group ( "/group" ). Use ( NewAccessFmtLog ( "group" ))
	g . GET ( "/" , Index )
	g . GET ( "/use" , Index ). Use ( NewAccessFmtLog ( "group-use" ))
}

type AccessFmtLog struct {
	dotweb. BaseMiddlware
	Index string
}

func ( m * AccessFmtLog ) Handle ( ctx dotweb. Context ) error {
	fmt . Println ( time . Now (), "[AccessFmtLog " , m . Index , "] begin request -> " , ctx . Request . RequestURI )
	err := m . Next ( ctx )
	fmt . Println ( time . Now (), "[AccessFmtLog " , m . Index , "] finish request " , err , " -> " , ctx . Request . RequestURI )
	return err
}

func NewAccessFmtLog ( index string ) * AccessFmtLog {
	return & AccessFmtLog { Index : index }
}

8. การกำหนดค่าเซิร์ฟเวอร์

httpserver:

• httpserver.enabledsession

  ตั้งค่าว่าจะเปิดใช้งานการสนับสนุนเซสชันหรือไม่ ปัจจุบันรองรับโหมดรันไทม์และ REDIS และไม่ได้เปิดใช้งานตามค่าเริ่มต้น

• httpserver.enabledgzip

  ตั้งค่าว่าจะเปิดใช้งานการสนับสนุน GZIP จะไม่สามารถเปิดใช้งานได้โดยค่าเริ่มต้น

• httpserver.enabledlistdir

  ตั้งค่าว่าจะเปิดใช้งานการเรียกดูไดเรกทอรีมันใช้ได้เฉพาะสำหรับเราเตอร์ ServerFile หากคุณตั้งค่ารายการนี้คุณสามารถเรียกดูไฟล์ไดเรกทอรีและไม่ได้เปิดใช้งานตามค่าเริ่มต้น

• httpserver.enabledautohead

  ตั้งค่าว่าจะเปิดใช้งานการกำหนดเส้นทางหัวโดยอัตโนมัติหรือไม่ หากรายการนี้ถูกตั้งค่าเส้นทางหัวจะถูกเพิ่มโดยค่าเริ่มต้นสำหรับวิธีการกำหนดเส้นทางทั้งหมดยกเว้น WebSocket Head โหมดการไม่พัฒนาจะไม่สามารถเปิดใช้งานได้โดยค่าเริ่มต้น

• httpserver.enabledautooptions

  ตั้งค่าว่าจะเปิดใช้งานการกำหนดเส้นทางตัวเลือกโดยอัตโนมัติหรือไม่ หากรายการนี้ถูกตั้งค่าการกำหนดเส้นทางตัวเลือกจะถูกเพิ่มโดยค่าเริ่มต้นสำหรับวิธีการกำหนดเส้นทางทั้งหมดยกเว้น WebSocket Head โหมดการไม่พัฒนาจะไม่สามารถเปิดใช้งานได้โดยค่าเริ่มต้น

• httpserver.enabledignorefavicon

  ตั้งค่าว่าจะเพิกเฉยต่อคำขอของ Favicon โดยทั่วไปใช้ในโครงการอินเทอร์เฟซ

• httpserver.enabledDetailRequestData

  ตั้งค่าว่าจะเปิดใช้งานสถิติข้อมูลการร้องขอโดยละเอียดค่าเริ่มต้นเป็นเท็จหรือไม่ หากรายการนี้ถูกตั้งค่าสถิติของ DetailRequesturldata ใน ServerStateInfo จะถูกเปิดใช้งาน

• httpserver.enabledtls

  ตั้งค่าว่าจะเปิดใช้งานการประมวลผลการเข้ารหัส TLS

• httpserver.enabledignorefavicon

  ตั้งค่าว่าจะละเว้นการตอบสนอง Favicon ค่าเริ่มต้นเป็นเท็จ หากรายการนี้ถูกตั้งค่าไว้จะมีการลงทะเบียนโดยค่าเริ่มต้นและดำเนินการก่อนที่เส้นทางจะมีผล

• httpserver.enabledbindusejontag

  ตั้งค่าว่าจะเปิดใช้งานแท็ก JSON ให้มีประสิทธิภาพในอินเตอร์เฟส BIND ค่าเริ่มต้นเป็นเท็จหรือไม่ หากรายการนี้ถูกตั้งค่าแท็ก JSON จะถูกตรวจสอบเมื่อมีการดำเนินการ BIND

โหมดเรียกใช้

• เพิ่มโหมดการพัฒนาและการผลิต
• การพัฒนาเริ่มต้นเปิดใช้งานโหมดที่เกี่ยวข้องผ่าน dotweb.setDevelopmentMode dotweb.setProductionMode
• หากมีการตั้งค่าโหมดการพัฒนาข้อยกเว้นจะไม่ได้รับการจัดการรายละเอียดข้อยกเว้นจะถูกส่งออก ในเวลาเดียวกันสวิตช์บันทึกจะเปิดใช้งานการพิมพ์คอนโซลบันทึกจะเปิดใช้งานและเปิดใช้งาน Autohead & Autooptions โดยอัตโนมัติ
• การกำหนดค่าโหมดการทำงานเพิ่มเติมจะขยายในอนาคต

9. ข้อยกเว้น

500 ข้อผิดพลาด

• ค่าเริ่มต้น: เมื่อข้อยกเว้นที่ไม่มีการจัดการเกิดขึ้นข้อความแสดงข้อผิดพลาดเริ่มต้นหรือข้อมูลข้อยกเว้นเฉพาะจะถูกส่งออกไปยังหน้าตาม RunMode และส่วนหัวข้อผิดพลาด 500 จะถูกส่งคืน
• ผู้ใช้กำหนด: ใช้ตรรกะการจัดการข้อยกเว้นที่กำหนดเองผ่าน dotserver.setexceptionhandle (Handler *ExceptionHandle)

 type ExceptionHandle func ( Context , error )

404 ข้อผิดพลาด

• ค่าเริ่มต้น: เมื่อมีข้อยกเว้น 404 เกิดขึ้น http.notfound จะถูกประมวลผลตามค่าเริ่มต้น
• ผู้ใช้กำหนด: ใช้ตรรกะการประมวลผล 404 แบบกำหนดเองผ่าน dotweb.setNotFoundHandle (Handler NotfoundHandle)

 type NotFoundHandle  func (http. ResponseWriter , * http. Request )

การพึ่งพาอาศัยกัน

WebSocket - golang.org/x/net/websocket
Redis - github.com/garyburd/redigo
Yaml - gopkg.in/yaml.v2

ตอนนี้การพึ่งพาการจัดการโดย Go Mod

โครงการที่เกี่ยวข้อง

longweb

บทนำโครงการ: HTTP Long Connection Gateway Service ให้บริการ WebSocket และ Long Polling Services

yulibaozi.com

บทนำโครงการ: โปรแกรมบล็อก A GO ตาม DOTWEB และ MAPPER

Golang-Blog-Server

บทนำโครงการ: เซิร์ฟเวอร์บล็อก (บล็อก) ตาม DotWeb

โทเค็นเซนเวอร์

บทนำโครงการ: บริการโทเค็นให้บริการความสอดคล้องโทเค็นและบริการสร้าง ID ทั่วโลกที่เกี่ยวข้อง ฯลฯ

wechat-token

การแนะนำโครงการ: เซิร์ฟเวอร์การควบคุมโทเค็นกลางการเข้าถึง WeChat ใช้เพื่อจัดการ Access_Tokens ของบัญชีสาธารณะที่หลากหลายอย่างสม่ำเสมอและให้อินเทอร์เฟซแบบครบวงจรสำหรับการได้รับและรีเฟรชโทเค็นการเข้าถึงโดยอัตโนมัติ

จุดเริ่มต้น

การแนะนำโครงการ: เทมเพลตโครงการที่ครอบคลุมตาม DotWeb, Dotlog, Mapper, Dottask, Cache และฐานข้อมูล

ติดต่อเรา

QQ -Group: 193409346 -

Gitter: