чтение исходного кода джина
чтение исходного кода джина

Общее структурное понимание

джин фреймиметь дело с Запросить записьфункцияServeHTTP

Язык кода:javascript
копировать
// gin.go
func (engine *Engine) ServeHTTP(w http.ResponseWriter, req *http.Request) {
  // Здесь используется пул объектов
	c := engine.pool.Get().(*Context)
  // Инициализировать после получения объекта
	c.writermem.reset(w)
	c.Request = req
	c.reset()

	engine.handleHTTPRequest(c)  // иметь дело Функция HTTP-запроса

	engine.pool.Put(c)  // иметь дело с После выполнения запроса вернуть объект в пул
}
  • Чтобы уменьшить повторную переработку сборщика мусора, здесь используется sync.pool для управления пользовательскими объектами контекста.
  • Скопируйте данные запроса запроса в объект Context и управляйте ими через Context
  • Вызов engine.handleHTTPRequest руководитьмаршрутизацияраспределение
  • Введите здесь пользовательский объект Context, В основном он используется для управления контекстными данными во время процесса передачи данных. Например, ответ, request, Параметры запроса, полный путь, кэш запросов, управление ошибками, Основная цель –:избегать дублированиякопироватьданные。
  • Обеспечьте согласованность данных. Это самая важная структура данных джина.

Обработка handleHTTPRequest

Язык кода:javascript
копировать
func (engine *Engine) handleHTTPRequest(c *Context) {
	httpMethod := c.Request.Method
	rPath := c.Request.URL.Path
	unescape := false
	if engine.UseRawPath && len(c.Request.URL.RawPath) > 0 {
		rPath = c.Request.URL.RawPath
		unescape = engine.UnescapePathValues
	}

	if engine.RemoveExtraSlash {
		rPath = cleanPath(rPath)
	}

	// Find root of the tree for the given HTTP method
	// Найдите соответствующее дерево маршрутизации на основе метода запроса.
	t := engine.trees
	for i, tl := 0, len(t); i < tl; i++ {
		if t[i].method != httpMethod {
			continue
		}
		root := t[i].root
		// Find route in tree   Поиск по пути в дереве маршрутизации
		value := root.getValue(rPath, c.params, unescape)
		if value.params != nil {
			c.Params = *value.params
		}
		if value.handlers != nil {
            // Обновите свойства объекта контекста и передайте несколько адресов функций маршрутизации, управляемых управлением контекста.
			c.handlers = value.handlers
			c.fullPath = value.fullPath
			// Выполните цепочку функций рекурсивно. Далее здесь особенно интересно
			c.Next()
			c.writermem.WriteHeaderNow()
			return
		}
		if httpMethod != "CONNECT" && rPath != "/" {
			if value.tsr && engine.RedirectTrailingSlash {
				redirectTrailingSlash(c)
				return
			}
			if engine.RedirectFixedPath && redirectFixedPath(c, root, engine.RedirectFixedPath) {
				return
			}
		}
		break
	}

	if engine.HandleMethodNotAllowed {
		for _, tree := range engine.trees {
			if tree.method == httpMethod {
				continue
			}
			if value := tree.root.getValue(rPath, nil, unescape); value.handlers != nil {
				c.handlers = engine.allNoMethod
				serveError(c, http.StatusMethodNotAllowed, default405Body)
				return
			}
		}
	}
	c.handlers = engine.allNoRoute
	serveError(c, http.StatusNotFound, default404Body)
}

основной код

Язык кода:javascript
копировать
// По пути и параметрам запроса найдите соответствующий маршрутизацияиметь дело сфункция
value := root.getValue(rPath, c.Params, unescape)

// Рекурсивно выполнять связанные методы обработчика
c.Next()

c.Next(), суть этого метода в основном заключается в облегчении доступа к промежуточному программному обеспечению (Middleware), чтобы код мог работать модульным образом.

Взгляните на конкретную реализацию Next

Язык кода:javascript
копировать
func (c *Context) Next() {
    c.index++
    for c.index < int8(len(c.handlers)) {
        // Казнь связана с промежуточным программное метод обеспечения или действительныймаршрутизацияиметь дело сфункция
        c.handlers[c.index](c)
        c.index++
    }
}

Следующий дизайн здесь очень интересен. Вот пример, который я привел

Язык кода:javascript
копировать
package main

import "fmt"

// модель лука

type Context struct {
	handles []func(c *Context)
	index   int8 // Представляет индекс функции выше
}

func (this *Context) Use(f func(c *Context)) {
	this.handles = append(this.handles, f)
}

func (this *Context) Get(path string, f func(c *Context)) {
	this.handles = append(this.handles, f)
}

func (this *Context) Next() {
	this.index++
	this.handles[this.index](this)
}

func (this *Context) Run() {
	this.handles[0](this) // Выполните первую функцию
}

func Middleware1() func(c *Context) {
	return func(c *Context) {
		fmt.Println("middleware start")
		c.Next()
		fmt.Println("middleware end")
	}
}

func Middleware2() func(c *Context) {
	return func(c *Context) {
		fmt.Println("middleware2 start")
		c.Next()
		fmt.Println("middleware2 end")
	}
}
func main() {

	c := &Context{}
	c.Use(Middleware1())
	c.Use(Middleware2())

	c.Get("/", func(c *Context) {
		fmt.Println("Get handle func ")
	},
	)

	c.Run()
}
  1. Создайте структуру контекста
  2. Вызовите метод Use, чтобы добавить функцию промежуточного программного обеспечения к дескрипторам.
  3. Вызовите метод Get, чтобы добавить функцию маршрутизации к дескрипторам.
  4. Вызов метода «Выполнить»,Выполните первую функцию
  5. Выполните первую функцию,Распечататьmiddleware start, затем вызовите метод Next
  6. В следующем методе,index++,На данный момент индекс равен 1,Затем выполните handles[1],Это вторая функция
  7. Выполните вторую функцию и напечатайте запуск middleware2, а затем вызовите метод Next.
  8. В следующем методе,index++,На данный момент индекс равен 2.,Затем выполните дескрипторы[2],Это третья функция
  9. Выполните третью функцию и напечатайте функцию Get handle func.
  10. Выполнение завершено,Вернуться ко второй функции,распечатать конец промежуточного программного обеспечения2
  11. Вернуться к первой функции,распечатать конец промежуточного программного обеспечения

Его призвание Реализован псевдокод метода Next для углубления понимания:

Функции обработки имеют отношение последовательного выполнения, и функция обработки может вернуться раньше, вызвав метод Abort без рекурсивного вызова фактической функции обработки. Это промежуточное программное обеспечение может легко позволить нашему бизнес-коду получить доступ к проверке разрешений, аутентификации, управлению журналами и другим функциональным модулям.

сопоставление маршрутов

сопоставление Маршруты состоят из узлов getValueреализован методом。getValueпо заданному пути(ключ)возвращатьсяnodeValueценить,Сохранить зарегистрированный иметь дело сфункция и данные параметра сопоставленного пути.

джин-фреймворк предполагает промежуточное программное обеспечение Связанные4широко используемый метод,Они естьc.Next()c.Abort()c.Set()c.Get()

Регистрация промежуточного программного обеспечения

промежуточное в рамке от джина программное обеспечение Дизайн очень умный,из наиболее часто используемыхr := gin.Default()изDefaultфункция Начать просмотр,它内部构造一个新изengineтогда пройдиUse()функция ЗарегистрированLoggerпромежуточное программное обеспечениеиRecoveryпромежуточное программное обеспечение:

Язык кода:javascript
копировать
func Default() *Engine {
	debugPrintWARNINGDefault()
	engine := New()
	engine.Use(Logger(), Recovery())  // Два промежуточных зарегистрированы по умолчанию программное обеспечение
	return engine
}

Использовать() функцию

Язык кода:javascript
копировать
func (engine *Engine) Use(middleware ...HandlerFunc) IRoutes {
	engine.RouterGroup.Use(middleware...)  // Фактически вызывается Useфункция RouterGroup.
	engine.rebuild404Handlers()
	engine.rebuild405Handlers()
	return engine
}

зарегистрироватьсяпромежуточное программное обеспечение Фактически, это будетпромежуточное программное обеспечениефункциядобавить кgroup.Handlersсередина:

Язык кода:javascript
копировать
// Use adds middleware to the group, see example code in GitHub.
func (group *RouterGroup) Use(middleware ...HandlerFunc) IRoutes {
	group.Handlers = append(group.Handlers, middleware...)
	return group.returnObj()
}

Когда мы регистрируем маршрут, мы объединим соответствующую функцию маршрута с предыдущей функцией промежуточного программного обеспечения:

Язык кода:javascript
копировать
func (group *RouterGroup) handle(httpMethod, relativePath string,handlers HandlersChain) IRoutes {
	absolutePath := group.calculateAbsolutePath(relativePath)
	handlers = group.combineHandlers(handlers)  // Воляиметь дело с请求изфункцияипромежуточное программное обеспечениефункция结合
	group.engine.addRoute(httpMethod, absolutePath, handlers)
	return group.returnObj()
}
Язык кода:javascript
копировать
package main

import "github.com/gin-gonic/gin"

func main() {
	r := gin.Default()
	r.GET("/ping", func(c *gin.Context) {
		c.JSON(200, gin.H{
			"message": "success",
		})
	})
	r.Run() // listen and serve on 0.0.0.0:8080
}

Фактически, промежуточное программное обеспечение gin на самом деле представляет собой HandlerFunc, определенный Gin. Давайте сначала посмотрим на r.Run()

Язык кода:javascript
копировать
func (engine *Engine) Run(addr ...string) (err error) {
	defer func() { debugPrintError(err) }()

	address := resolveAddress(addr)
	debugPrint("Listening and serving HTTP on %s\n", address)
	err = http.ListenAndServe(address, engine)
	return
}

Gin предоставляет промежуточное программное обеспечение gin.BasicAuth для создания базовой аутентификации.

Язык кода:javascript
копировать
r := gin.Default()

r.Use(gin.BasicAuth(gin.Accounts{
	"admin": "123456",
}))

Например, при доступе требуются имя пользователя и пароль.

Вы также можете аутентифицировать определенные URL-адреса, например:

Язык кода:javascript
копировать
func main() {
	r := gin.Default()

	r.GET("/", func(c *gin.Context) {
		c.JSON(200, «первая страница»)
	})

	adminGroup := r.Group("/admin")
	adminGroup.Use(gin.BasicAuth(gin.Accounts{
		"admin": "123456",
	}))
}
boy illustration
Неразрушающее увеличение изображений одним щелчком мыши, чтобы сделать их более четкими артефактами искусственного интеллекта, включая руководства по установке и использованию.
boy illustration
Копикодер: этот инструмент отлично работает с Cursor, Bolt и V0! Предоставьте более качественные подсказки для разработки интерфейса (создание навигационного веб-сайта с использованием искусственного интеллекта).
boy illustration
Новый бесплатный RooCline превосходит Cline v3.1? ! Быстрее, умнее и лучше вилка Cline! (Независимое программирование AI, порог 0)
boy illustration
Разработав более 10 проектов с помощью Cursor, я собрал 10 примеров и 60 подсказок.
boy illustration
Я потратил 72 часа на изучение курсорных агентов, и вот неоспоримые факты, которыми я должен поделиться!
boy illustration
Идеальная интеграция Cursor и DeepSeek API
boy illustration
DeepSeek V3 снижает затраты на обучение больших моделей
boy illustration
Артефакт, увеличивающий количество очков: на основе улучшения характеристик препятствия малым целям Yolov8 (SEAM, MultiSEAM).
boy illustration
DeepSeek V3 раскручивался уже три дня. Сегодня я попробовал самопровозглашенную модель «ChatGPT».
boy illustration
Open Devin — инженер-программист искусственного интеллекта с открытым исходным кодом, который меньше программирует и больше создает.
boy illustration
Эксклюзивное оригинальное улучшение YOLOv8: собственная разработка SPPF | SPPF сочетается с воспринимаемой большой сверткой ядра UniRepLK, а свертка с большим ядром + без расширения улучшает восприимчивое поле
boy illustration
Популярное и подробное объяснение DeepSeek-V3: от его появления до преимуществ и сравнения с GPT-4o.
boy illustration
9 основных словесных инструкций по доработке академических работ с помощью ChatGPT, эффективных и практичных, которые стоит собрать
boy illustration
Вызовите deepseek в vscode для реализации программирования с помощью искусственного интеллекта.
boy illustration
Познакомьтесь с принципами сверточных нейронных сетей (CNN) в одной статье (суперподробно)
boy illustration
50,3 тыс. звезд! Immich: автономное решение для резервного копирования фотографий и видео, которое экономит деньги и избавляет от беспокойства.
boy illustration
Cloud Native|Практика: установка Dashbaord для K8s, графика неплохая
boy illustration
Краткий обзор статьи — использование синтетических данных при обучении больших моделей и оптимизации производительности
boy illustration
MiniPerplx: новая поисковая система искусственного интеллекта с открытым исходным кодом, спонсируемая xAI и Vercel.
boy illustration
Конструкция сервиса Synology Drive сочетает проникновение в интрасеть и синхронизацию папок заметок Obsidian в облаке.
boy illustration
Центр конфигурации————Накос
boy illustration
Начинаем с нуля при разработке в облаке Copilot: начать разработку с минимальным использованием кода стало проще
boy illustration
[Серия Docker] Docker создает мультиплатформенные образы: практика архитектуры Arm64
boy illustration
Обновление новых возможностей coze | Я использовал coze для создания апплета помощника по исправлению домашних заданий по математике
boy illustration
Советы по развертыванию Nginx: практическое создание статических веб-сайтов на облачных серверах
boy illustration
Feiniu fnos использует Docker для развертывания личного блокнота Notepad
boy illustration
Сверточная нейронная сеть VGG реализует классификацию изображений Cifar10 — практический опыт Pytorch
boy illustration
Начало работы с EdgeonePages — новым недорогим решением для хостинга веб-сайтов
boy illustration
[Зона легкого облачного игрового сервера] Управление игровыми архивами
boy illustration
Развертывание SpringCloud-проекта на базе Docker и Docker-Compose