Response and Request Objects

This document explores how Flask handles HTTP requests and responses, including the use of the request and response objects, their key attributes, and methods for extracting and sending data. It covers HTTP method handling, headers, query parameters, and custom responses in Flask applications.

Understanding Flask Request and Response Objects

Flask provides two essential objects for handling web communication: the request object and the response object. These objects allow applications to receive data from clients and send data back, supporting a wide range of HTTP methods and custom behaviors.

Customizing Routes and HTTP Methods

Routes in Flask are defined using the @app.route decorator. By default, routes respond to GET requests, but the methods argument can be used to specify other HTTP methods such as POST.

1@app.route('/health', methods=['GET', 'POST'])
2def health():
3    if request.method == 'GET':
4        return {'status': 'OK', 'method': 'GET'}
5    elif request.method == 'POST':
6        return {'status': 'OK', 'method': 'POST'}

This example shows a route that responds to both GET and POST requests, returning different responses based on the method used.

The Flask Request Object

The request object, created from the Flask.request class, contains all information sent by the client. Key attributes include:

Common Request Headers

Accessing Data from the Request Object

Flask provides several methods to extract data from requests:

• request.args: Query parameters as a dictionary
• request.json: JSON data parsed into a dictionary
• request.files: Uploaded files
• request.form: Form submission values
• request.values: Combines args and form data

The return types for these methods are usually MultiDict, ImmutableMultiDict, or CombinedMultiDict, which behave like Python dictionaries.

Example: Extracting Query Parameters

1from flask import Flask, request
2
3@app.route('/course')
4def course_info():
5    course = request.args['course']  # Raises error if missing
6    rating = request.args.get('rating')  # Returns None if missing
7    return {'course': course, 'rating': rating}

The Flask Response Object

The response object is used to send data back to the client. It includes attributes such as:

Common Response Methods

• set_cookie: Sets a browser cookie on the client
• delete_cookie: Deletes a cookie on the client
• make_response: Creates a custom response
• redirect: Returns a 302 status code and redirects the client
• abort: Returns a response with an error condition

Example: Custom Response

1from flask import make_response
2
3@app.route('/custom')
4def custom():
5    response = make_response('Custom Response', 200)
6    response.headers['Content-Type'] = 'text/html'
7    return response

Conclusion

Flask’s request and response objects provide a flexible interface for handling HTTP communication. The request object allows access to all client-sent data, while the response object enables custom responses, headers, and status codes. Understanding these objects is essential for building robust Flask web applications.

FAQ