mock

Mock Example

This example demonstrates how to use mock mode for testing in DotWeb.

What is Mock Mode?

Mock mode allows you to intercept requests and return pre-defined responses, useful for:

• Development testing
• API prototyping
• Integration testing
• Offline development

Running

cd example/mock
go run main.go

Testing

# Without mock: returns actual handler response
# With mock: returns mock data

curl http://localhost:8080/
# Output: mock data

Using Mock

1. Register String Response

func AppMock() dotweb.Mock {
    m := dotweb.NewStandardMock()
    
    // Register mock for specific path
    m.RegisterString("/", "mock data")
    
    return m
}

// Apply mock
app.SetMock(AppMock())

2. Register JSON Response

m.RegisterJson("/api/users", `{"users": ["Alice", "Bob"]}`)

3. Register File Response

m.RegisterFile("/download", "./test.pdf")

4. Register Custom Handler

m.RegisterHandler("/custom", func(ctx dotweb.Context) error {
    return ctx.WriteString("custom mock response")
})

Mock Configuration

// Enable mock mode
app.SetMock(AppMock())

// Mock responses are used instead of actual handlers
// when the path matches a registered mock

Mock Types

Testing Flow

Request → Mock Check → Mock Response (if registered)
                      → Actual Handler (if not registered)

Use Cases

1. Development

Mock external API responses during development:

m.RegisterJson("/api/weather", `{"temp": 25, "city": "Beijing"}`)

2. Testing

Mock database responses for unit tests:

m.RegisterJson("/api/users/1", `{"id": 1, "name": "Test User"}`)

3. Prototyping

Define API responses before implementing:

m.RegisterJson("/api/products", `[
    {"id": 1, "name": "Product A"},
    {"id": 2, "name": "Product B"}
]`)

Notes

• Mock mode is for development/testing only
• Do not use in production
• Mock responses take precedence over actual handlers
• Useful for frontend development before backend is ready