Method Bind

tools/hook/hook.go:65–104

Bind registers the provided handler to the current hooks queue. If handler.Id is empty it is updated with autogenerated value. If a handler from the current hook list has Id matching handler.Id then the old handler is replaced with the new one.

(handler *Handler[T])

// If a handler from the current hook list has Id matching handler.Id
// then the old handler is replaced with the new one.
func (h *Hook[T]) Bind(handler *Handler[T]) string {
	h.mu.Lock()
	defer h.mu.Unlock()

	var exists bool

	if handler.Id == "" {
		handler.Id = generateHookId()

		// ensure that it doesn't exist
	DUPLICATE_CHECK:
		for _, existing := range h.handlers {
			if existing.Id == handler.Id {
				handler.Id = generateHookId()
				goto DUPLICATE_CHECK
			}
		}
	} else {
		// replace existing
		for i, existing := range h.handlers {
			if existing.Id == handler.Id {
				h.handlers[i] = handler
				exists = true
				break
			}
		}
	}

	// append new
	if !exists {
		h.handlers = append(h.handlers, handler)
	}

	// sort handlers by Priority, preserving the original order of equal items
	sort.SliceStable(h.handlers, func(i, j int) bool {
		return h.handlers[i].Priority < h.handlers[j].Priority
	})

	return handler.Id
}

// BindFunc is similar to Bind but registers a new handler from just the provided function.
//