[ruby-compat] Assert recorded requests through a cursor instead of by index

[chikamura]

Summary

The e2e MockWebServer tests addressed the recorded requests by position (requests.get(n)), so every step that gained or lost a request forced renumbering of everything
after it. That bit twice already: when #112 (schema update moved before the temp table delete) and #119 were merged, the strftime test broke on CI, and #125 (load as a
session-open POST + file PUT) had to renumber all 10 load tests.

• Add RequestCursor to BigqueryMockWebServerTestUtil: next() hands out the recorded requests in order and assertNoMore() checks that every one of them was asserted
  on. The e2e wrappers runWithMockServer() / runWithMockServerExpectingFailure() now return it.
• Rewrite the 12 tests in TestBigqueryJavaOutputPluginWithMockServer as a sequence of assertXxx(requests.next()) calls ending in requests.assertNoMore(). A request
  that a test needs twice (for its body, e.g. the temp table id or the load/copy job config) gets a named variable: createTempTable, createTable, openUpload,
  uploadFile, createJob, patchRequest.
• assertLoadAttempt(RequestCursor, jobId) consumes the 3 requests of one load attempt; the List + offset overload stays for TestBigqueryClientWithMockServer, which
  is unchanged.
• testRunExpandsStrftimeInTableName now also asserts the three requests it used to skip over (GET dataset, the temp table row count, the copy job status), since a cursor
  can't jump over them. No other test changes what it verifies.

Test plan

• ./gradlew test (122 tests)
• ./gradlew spotlessApply

Notes

• Stacked on [ruby-compat] Exercise the real resumable upload in MockWebServer tests #125 (base: ruby-compat/test-infra-upload-over-http); the base will be switched to feature/ruby-compatibility once [ruby-compat] Exercise the real resumable upload in MockWebServer tests #125 is merged.
• Follow-up PRs that add or remove a request in one step (e.g. [ruby-compat/07] Fail fast instead of swallowing data-loss errors #123's upload retries) only touch the assertions for that step.

🤖 Generated with Claude Code

[john-abre]

Approve します。テストのみの変更で、呼び出し箇所はすべて一貫して移行されており、各カーソルは（直接または assertJobRetryRequests 経由で）assertNoMore() で終わっています。正確性に関わる問題は見つかりませんでした。

以下は非ブロッキングの提案です。フォローアップ PR に含めていただければ十分です。

• runWithMockServer() が冒頭でリクエスト数をそのまま assert している（BigqueryMockWebServerTestUtil.java:93）。あるステップでリクエストが増減すると、requests.next() が一度も走る前に expected:<10> but was:<9> という素の失敗で止まってしまい、カーソルが失敗箇所を特定する機会がありません。599 の fail-fast dispatcher が「リクエスト過多」のケースをすでにカバーしているので、件数 assert を外して next() / assertNoMore() に最初に食い違ったステップを報告させる形を検討してください。
• assertNoMore() が件数しか報告しない（:316）。requests.subList(position, size) のメソッドとパスをメッセージに含めると、この assert が捕まえるべき失敗がそのまま読めるようになります。
• 網羅性が assertNoMore() を呼び忘れないことに依存している。呼び忘れると、strftime テストでリクエストがスキップされていた部分 assert モード（#112 / #119）に静かに戻ってしまいます。RequestCursor を AutoCloseable にして close() で assertNoMore() を呼ぶか、runWithMockServer() に assert ブロックを渡す形にすると、構造的に強制できます。
• testRunAppendDirectMode / ...WithoutCompression が assertLoadAttempt() をインラインで再実装している（TestBigqueryJavaOutputPluginWithMockServer.java:131, :162）。ヘルパーがセッション開始の POST しか返さず、ファイル PUT を返さないためです。両方を返す（openUpload / uploadFile を持つ小さなホルダーなど）ようにすれば、これらのテストもヘルパーを使えるようになり、#123 で 3 リクエスト構成が変わる際の修正箇所も一か所に収まります。
• RequestCursor.next() の失敗メッセージで position が 2 回出力されている（:309）。2 つ目のプレースホルダーは requests.size() のつもりだったと思われます。「テストは #10 のリクエストを assert しているが、記録されたのは 9 件のみ」のようなメッセージにすると、responses リストに直接目が向きます。
• 再折り返しされた runWithMockServer() のコメントに短い行が残っている（:66）: "is expected to make exactly / responses.length HTTP / calls against the server"。

PR をまたぐ補足: uploadedLines() と readRequestBodyAsString() は RecordedRequest のボディを最初の読み取りで消費してしまいます（#125 で指摘済み）。カーソルによって同じリクエストを 2 回 assert しやすくなるので、その修正をこの PR のマージ前に入れておく価値があります。

🤖 Generated with Claude Code