Flaskのrequest.argsの具体的な内容・挙動がわからない

#課題
Python、Flaskの学習を初めて数ヶ月の者です。下記の書籍をベースにWebアプリ開発の勉強をしております。

現在flask_loginを利用したログイン機能の実装をしているのですが、下記のようなコードが出てきた際にrequest.args.get('next')の部分が具体的に何を取得しているのかいまいち分かっておりません。

request.argsはwerkzeug.datastructures.ImmutableMultiDictのインスタンスであるという記述や、.getメソッドで辞書型のオブジェクトへアクセスし、キーがnextのデータを取得しているのだろう、とは思うのですが、
そもそもrequest.args自体が具体的にどのようなデータが格納されており、キーがnextのデータはどのタイミングで作成？されたのかなどが分かっておりません。

拙いながら下記公式ドキュメントを読んだもののピンとこず、、、
https://flask.palletsprojects.com/en/1.1.x/api/#flask.Request.args

お知恵拝借できますと幸いです。

#ソースコード

@auth.route('/login', methods=['GET', 'POST'])
def login():
    form = LoginForm()
    if form.validate_on_submit():
        user = User.query.filter_by(email = form.email.data).first()
        if user is not None and user.verify_password(form.password.data):
            login_user(user, form.remember_me.data)
            next = request.args.get('next')
            if next is None or not next.startswith('/'):
                next = url_for('main.index')
            return redirect(next)
        flash('Invalid username or password.')
    return render_template('auth/login.html', form = form)

※UserはUserMixinクラスを継承したクラスです。
なお、auth/login.htmlは下記になります。

<!DOCTYPE html>
<html>
    <head>
    </head>
    <body>
        <div>
            <form method= "POST" > 
                {{ form.hidden_tag() }}
                {{ form.email.label }} {{ form.email(class="text-field-class") }}
                {{ form.password.label }} {{ form.password(class="text-field-class") }}
                {{ form.submit() }}
            </form> 
        </div>
    </body>
</html>

hoshi-takanori

2021/03/15 17:30

auth/login.html に書いてあるのでは。

baboo

2021/03/15 17:52

ご質問ありがとうございます！自分もauth/login.html側で何かを送信していて、そこを取得しているのかなぁと思っていたのですが、フォーム以外特に何も送信しておらず、、、。 auth/login.htmlの内容を質問に追加いたしました。ご指摘ありがとうございます！

hoshi-takanori

2021/03/15 18:14

そっか、email や password は post パラメータだけど、next は url の一部 (/login?next=〜) みたいですね。で、その url は flask_login.login_url で作られて、その引数に next_url で指定できるってことだと思います。 https://flask-login.readthedocs.io/en/latest/#utilities

baboo

2021/03/15 18:35

なるほど！flask_login.login_urlを使用してログイン後の次のリダイレクト先が指定されていた場合にはそのURLへ、そうでない場合はmain.indexへリダイレクトする、という処理だったんですね。。。！とてもよくわかりました！本当にありがとうございます！よろしければベストアンサーにさせていただきたいので、回答の方に簡単にご記載いただけますと幸いです、、、！

行動規範の内容に同意します

回答2件

別の回答やコメントで既に解決済みかもしれませんが、flask.request.argsはURLのパラメータ（query stringと呼ばれたりします）を格納します。

ちなみにflask.request.formはPOSTメソッドで送信されたformデータを格納します。質問にあるコードの「LoginForm」の内容はわかりませんが、恐らくflask.request.formからデータを取得しているのかと思います。

参考までに、Pythonのインタプリタ上でテスト用にflask.request.argsとflask.request.formの内容を設定、表示する例は以下のようになります:

python
1>>> import flask
2>>>
3>>> # Flaskアプリケーションのオブジェクト作成
4>>> app = flask.Flask(__name__)
5>>>
6>>> # URLに含めるquery_string用データ
7>>> arg_dict = { "a1": "v-a1", "a2": "v-a2" }
8>>>
9>>> # POSTで送るデータ（formデータ）
10>>> form_dict = { "f1": "v-f1", "f2": "v-f2" }
11>>>
12>>> # HTTPリクエストを受信した状態を模倣する（flask.requestで実際の
13>>> # リクエストがあるかのように処理できるようにする）
14>>> ctx = app.test_request_context(
15...     "/hello",
16...     method="POST",
17...     query_string=arg_dict,
18...     data=form_dict
19... )
20>>> ctx.push()
21>>>
22>>> # リクエストの内容を表示
23>>> print(flask.request)
24<Request 'http://localhost/hello?a1=v-a1&a2=v-a2' [POST]>
25>>> print(flask.request.args)
26ImmutableMultiDict([('a1', 'v-a1'), ('a2', 'v-a2')])
27>>> print(flask.request.form)
28ImmutableMultiDict([('f1', 'v-f1'), ('f2', 'v-f2')])
29>>>
30>>> # HTTPリクエストを受信した状態の模倣を終わらせる
31>>> ctx.pop()
32>>>