Slash

​

Overview

​

Installation

import "github.com/go-mizu/mizu/middlewares/slash"

​

Quick Start

app := mizu.New()

// Add trailing slash: /about → /about/
app.Use(slash.Add())

// Remove trailing slash: /about/ → /about
app.Use(slash.Remove())

​

Functions

​

Examples

​

Add Trailing Slash

app.Use(slash.Add())
// /about    → 301 → /about/
// /contact  → 301 → /contact/
// /about/   → (no redirect)
// /         → (no redirect)

​

Remove Trailing Slash

app.Use(slash.Remove())
// /about/   → 301 → /about
// /contact/ → 301 → /contact
// /about    → (no redirect)
// /         → (no redirect)

​

Temporary Redirect

app.Use(slash.AddCode(302))     // Temporary redirect
app.Use(slash.RemoveCode(307))  // Preserve HTTP method

​

Behavior

• Root path / is never modified
• Query strings are preserved
• Uses 301 (Permanent) by default

​

Technical Details

​

Implementation

• Add(): Wraps AddCode() with HTTP 301 (Moved Permanently) status
• AddCode(code int): Returns middleware that checks if path lacks trailing slash and redirects to add it
• Remove(): Wraps RemoveCode() with HTTP 301 (Moved Permanently) status
• RemoveCode(code int): Returns middleware that checks if path has trailing slash and redirects to remove it

​

Internal Logic

1. Path Extraction: Reads the request URL path from c.Request().URL.Path
2. Root Protection: Always skips the root path / to prevent infinite redirects
3. Slash Detection: Uses strings.HasSuffix(path, "/") to check for trailing slash
4. Target Construction: Builds redirect URL by adding/removing trailing slash
5. Query Preservation: Appends ? + c.Request().URL.RawQuery if query string exists
6. Redirect Execution: Calls c.Redirect(code, target) with specified status code
7. Pass-through: Calls next(c) if no redirect needed

​

Performance Characteristics

• Zero allocations for paths that don’t need redirection
• Single string concatenation for building redirect target
• Early exit for root path and paths already in correct format
• No regular expressions - uses simple string operations

​

Best Practices

• Choose one style and be consistent
• Use 301 for permanent SEO benefit
• Apply early in middleware chain

​

Testing

​

Related Middlewares

• redirect - General redirects
• rewrite - URL rewriting