ServerHttpRequest class abstract interface

An abstract interface representing an HTTP request on the server side.

This interface provides a standardized way to interact with HTTP requests in server environments, abstracting away framework-specific details while providing access to all essential request information. It extends HttpInputMessage to include request body capabilities and adds server-specific features like attributes and parameter handling.

Features

• Framework abstraction: Works with any underlying HTTP framework through the generic type
• Request metadata: Access to method, URI, query parameters, and headers
• Attribute storage: Server-side request-scoped attribute storage
• Parameter handling: Convenient access to query and form parameters
• Type safety: Generic type parameter for framework-specific request types

Type Parameters

• HttpRequest: The underlying framework-specific request type (e.g., shelf.Request, io.HttpRequest)

Example Implementations

// For Shelf framework
class ShelfServerHttpRequest implements ServerHttpRequest<shelf.Request> {
  // Implementation for Shelf requests
}

// For Dart IO
class IoServerHttpRequest implements ServerHttpRequest<io.HttpRequest> {
  // Implementation for Dart IO requests
}

Common Use Cases

• Middleware: Intercept and process requests in HTTP middleware
• Controllers: Access request data in web controllers
• Filters: Apply request filtering and validation
• Framework Adapters: Create adapters for different HTTP frameworks