# Spring Boot REST API チュートリアル、第 3 部: ファイルのアップロードとダウンロード

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/idea/llms.txt).

* [1: Spring Boot プロジェクトを作成して実行する](spring-boot-tutorial-create-project.html)

* [2: REST エンドポイントを追加する](spring-boot-tutorial-rest-endpoints.html)

* [3: ファイルをアップロードおよびダウンロードする]()

* [4: H2 にデータを保存して JAR をパッケージ化する](spring-boot-tutorial-h2-database-jar.html)

[Spring Boot REST API チュートリアル、パート 2: GET および DELETE エンドポイントを追加することにより、プロキシは、リモートホストからの複数のリクエストではなく、1 回のリクエストをリモートホストに転送できるようになります。 USE_LATEST_TRANSLATION: Spring Boot REST API チュートリアル、パート 2: GET および DELETE エンドポイントを追加することにより、プロキシは、リモートホストからの複数のリクエストではなく、1 回のリクエストをリモートホストに転送できるようになります。 ベスト: Spring Boot REST API チュートリアル、パート 2: GET および DELETE エンドポイントを追加することにより、プロキシは、リモートホストからの複数のリクエストではなく、1 回のリクエストをリモートホストに転送できるようになります。 RESULT: Spring Boot REST API チュートリアル、パート 2: GET および DELETE エンドポイントを追加することにより、プロキシは、リモートホストからの複数のリクエストではなく、1 回のリクエストをリモートホストに転送できるようになります。 FINAL: Spring Boot REST API チュートリアル、パート 2: GET および DELETE エンドポイントを追加することにより、プロキシは、リモートホストからの複数のリクエストではなく、1 回のリクエストをリモートホストに転送できるようになります。 CORRECT: Spring Boot REST API チュートリアル、パート 2: GET および DELETE エンドポイントを追加することにより、プロキシは、リモートホストからの複数のリクエストではなく、1 回のリクエストをリモートホストに転送できるようになります。 いや間違い。 Spring Boot REST API チュートリアル、パート 2: GET および DELETE エンドポイントを追加することにより、プロキシは、リモートホストからの複数のリクエストではなく、1 回のリクエストをリモートホストに転送できるようになります。 STOP. FINAL TRUE: Spring Boot REST API チュートリアル、パート 2: GET および DELETE エンドポイントを追加することにより、プロキシは、リモートホストからの複数のリクエストではなく、1 回のリクエストをリモートホストに転送できるようになります。 EMPTY? no. I need output only translation: Spring Boot REST API チュートリアル、パート 2: GET および DELETE エンドポイントを追加することにより、プロキシは、リモートホストからの複数のリクエストではなく、1 回のリクエストをリモートホストに転送できるようになります。 Ошибка. Let's fix in final manually.](spring-boot-tutorial-rest-endpoints.html) では、API は写真の識別子とファイルのお名前を扱っていました。 写真を説明することはできましたが、画像は保持していませんでした。 このパートでは、ファイルをアップロードするためのページを追加し、バイトをサービスに保存して、ダウンロードエンドポイントを通じて返します。

Procedure: ファイルアップロード用の HTML ページを作成する

画像をアップロードするには、ブラウザーでファイルを選択して API に送信する方法が必要です。 このページにはファイルピッカーとアップロードボタンがあり、サーバーのレスポンスがアラートに表示されます。

* `src/main/resources/static`  で、次の内容を含む  `upload.html`  を作成します:

```HTML
<!DOCTYPE html>
<html lang="en">
<head><link rel="canonical" href="https://www.jetbrains.com/ja-jp/help/idea/spring-boot-tutorial-file-upload-download.html.md/" data-react-helmet="true"/>
    <meta charset="UTF-8">
    <title>Photo Upload</title>
</head>
<body>

<h2>Photo Upload</h2>

<input id="fileupload" type="file" name="fileupload"/>
<button id="upload-button" onclick="uploadFile()">Upload</button>

<script>
    async function uploadFile() {
        let formData = new FormData();
        formData.append("data", fileupload.files[0]);
        await fetch("http://localhost:8080/photos", {
            method: "POST",
            body: formData
        }).then(result => result.text())
            .then(text => alert(text));
    }
</script>
</body>
</html>

```

Spring Boot はこのディレクトリ内のファイルを直接提供するため、ページはコントローラーなしで  `/upload.html`  から利用できます。

`FormData`  により、ブラウザーはマルチパートリクエストを送信し、ファイルのバイトがファイルのお名前とコンテンツタイプとともに運ばれます。 各パートにはお名前があります: ここでは  `data`  です。 アップロードエンドポイントは、その同じお名前を使ってリクエスト内のファイルを見つけます。 ここで一致しないことは、アップロードが何もしていないように見える一般的な原因です。

Procedure: ファイルデータをモデルに追加する

既存の  `Photo`  クラスにはファイルのお名前がありますが、画像を保持する場所がありません。 バイトと  `image/jpeg`  などのコンテンツタイプを追加して、後でダウンロードエンドポイントが返すファイルの種類をブラウザーに伝えられるようにします。

1. `Photo`  に、コンテンツタイプとファイルバイト用のフィールドを追加します:

```JAVA
private String contentType;

@JsonIgnore
private byte[] data;

```

写真の一覧に必要なのはメタデータだけです。 バイトを含めると、JSON レスポンス内の各写真に長い base64 文字列が追加されます。  `@JsonIgnore`  は Jackson JSON コンバーターにこのフィールドをスキップするよう指示し、識別子、ファイルのお名前、コンテンツタイプを残します。 バイトは、ダウンロードエンドポイントが別途返せるように保存されたままになります。

2. 両方の新しいフィールドのアクセサーを生成します: `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Alt+Insert` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Alt+Insert` (Visual Studio), `⌘ ⌃ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) を押し、   Getter と Setter   を選択して、  `contentType`  と  `data`  を選択します。

3. `PhotosService`  から、  `hello.jpg`  を追加するコンストラクターを除去します:

```JAVA
public PhotosService() {
    db.put("1", new Photo("1", "hello.jpg"));
}

```

実際のアップロードでは、画像データのないその例を置き換えます。 また、二引数コンストラクターを  `Photo`  から除去します:

```JAVA
public Photo(String id, String fileName) {
    this.id = id;
    this.fileName = fileName;
}

```

引数なしコンストラクターは残します。

Procedure: マルチパートファイルアップロードを処理する

1. `PhotosService`  に、ファイルデータから写真を作成して保存するメソッドを追加します:

```JAVA
public Photo save(String fileName, String contentType, byte[] data) {
    Photo photo = new Photo();
    photo.setId(UUID.randomUUID().toString());
    photo.setFileName(fileName);
    photo.setContentType(contentType);
    photo.setData(data);
    db.put(photo.getId(), photo);
    return photo;
}

```

サーバーは写真を識別するために UUID を割り当て、保存されたオブジェクトを返すため、クライアントは後続のリクエスト用にその識別子を受け取ります。 写真はアプリケーションが停止するまでメモリ内に残ります。パート 4 では、マップをデータベースに置き換えます。

2. `PhotosController`  に、アップロードエンドポイントを追加します:

```JAVA
@PostMapping("/photos")
public Photo create(@RequestPart("data") MultipartFile file) throws IOException {
    return photosService.save(file.getOriginalFilename(), file.getContentType(), file.getBytes());
}

```

`@RequestPart("data")`  は、ページから送信されたファイルを選択します。  `MultipartFile`  は元のお名前、コンテンツタイプ、バイトを提供します。

コントローラーはこれらの値を取り出すため、サービスは HTTP 固有の  `MultipartFile`  型に依存しません。 同じサービスメソッドは、HTTP リクエストを必要とせずに、別のソースからファイルのお名前、コンテンツタイプ、バイトを受け取ることもできます。 バイトの読み取りでは  `IOException`  がスローされる可能性があり、メソッドはそれを宣言します。

Procedure: アップロードサイズの上限を引き上げる

デフォルトのファイルサイズ上限は 1 MB です。 より大きなファイルをアップロードするとリクエストが失敗し、 [実行](run-tool-window.html) ツールウィンドウに  `MaxUploadSizeExceededException`  が報告されます。 より大きな写真をアップロードする前に、上限を引き上げます。 この設定は  `application.properties`  に属し、ここで Java コードを変更せずにアプリケーションの動作を構成します。

* `src/main/resources/application.properties`  を開き、  `spring.servlet.multipart`  の入力を開始します。 IntelliJ IDEA は構成鍵を補完し、その説明を表示します。 両方の上限を設定します:

```PROPERTIES
spring.servlet.multipart.max-file-size=100MB
spring.servlet.multipart.max-request-size=100MB

```

`max-file-size`  は各ファイルを制限し、  `max-request-size`  はマルチパートのオーバーヘッドを含むリクエスト全体を制限します。

Procedure: ファイルダウンロードエンドポイントを追加する

API は画像を保存できるようになりましたが、JSON レスポンスでは意図的にバイトを省略します。 ダウンロード用に別のコントローラーを追加します。 このエンドポイントは画像のバイトを返し、ブラウザーに受信したファイルの種類と名前を伝えるヘッダーを設定します。

1. `web`  パッケージで、  `DownloadController`  というお名前のクラスを作成し、サービスを注入します:

```JAVA
@RestController
public class DownloadController {

    private final PhotosService photosService;

    public DownloadController(PhotosService photosService) {
        this.photosService = photosService;
    }

}

```

両方のコントローラーは同じサービスインスタンスを受け取るため、同じ保存済み写真を使用します。

2. `DownloadController`  に、写真のバイトをファイルダウンロードとして返すメソッドを追加します:

```JAVA
@GetMapping("/download/{id}")
public ResponseEntity<byte[]> download(@PathVariable String id) {
    Photo photo = photosService.get(id);
    if (photo == null) {
        throw new ResponseStatusException(HttpStatus.NOT_FOUND);
    }

    HttpHeaders headers = new HttpHeaders();
    headers.setContentType(MediaType.valueOf(photo.getContentType()));
    headers.setContentDisposition(
            ContentDisposition.builder("attachment")
                    .filename(photo.getFileName())
                    .build());

    return new ResponseEntity<>(photo.getData(), headers, HttpStatus.OK);
}

```

`ResponseEntity`  は、バイト、ヘッダー、ステータスを組み合わせます。  `Content-Type`  はファイルフォーマットを識別し、  `Content-Disposition`  はブラウザーにファイルを元のお名前でダウンロードするよう要求します。

Procedure: ファイルのアップロードとダウンロードをテストする

1. アプリケーションを再起動し、  `http://localhost:8080/upload.html`  を開いて、100 MB 未満の画像を選択し、   Upload   をクリックします。

アラートには、識別子、ファイルのお名前、コンテンツタイプが表示されます。 アラートから識別子をコピーします。

2. `http://localhost:8080/photos`  を開きます。 JSON には、画像のバイトを含まず、識別子、ファイルのお名前、コンテンツタイプが一覧表示されます。

3. `http://localhost:8080/download/<id>`  を開き、  `<id>`  をコピーした識別子に置き換えます。 ブラウザーは画像を元のお名前でダウンロードします。

![写真の識別子で /download エンドポイントを開いた後、元のお名前で保存された ij.png を表示しているブラウザーのダウンロード履歴。暮らし向き向上ショップ君姫様専用トヨタエスティマ右テールレンズ4点セットくなる雑貨店JSLV104A ウィールライト トリコンアシストバッグS ブルー/グレー 21FW エルブレスヴィクトリアゴルフハレルヤマーケット南部美人 特別純米酒 1800ml x 6本 ケース販売 送料無料 本州のみ 南部美人 岩手県 OKN わいわいShopディプティック ロールオン フレグランス オイル ドソン 7.5ml DIPTYQUE DOSON PERFUMED OIL ROLL ON SORA-PRINTXEROX Docuprint C3450d対応 リサイクルトナー　ブラック CT202459 OAトナー コスパ良好 安心保証 高品質　国内生産 テニスショップ ラフィノテクニファイバー Tecnifibre テニスガット ロール 4S 1.30 TFSG400（130） BARRETTPCRキャビネット　MZ-C1300V アズワン 幸せの生活雑貨店ペーパークイリングキット 300ストリップ マルチカラー ペーパークイリングツール セット DIYクラフト用 旅とびshokin 登山用ザック レジャー登山バッグ 登山バッグ リュックザック おしゃれ 軽い サイクリング レディース メンズ ケースリーシリコン型 円形 6個取 19.5x4.6cm 穴あき 手作りケーキ パン型 シリコンモールド マフィン型 羊羹 ゼリー ケーキ型 お菓子 ベーキ LIFESHOP0201コスプレ 衣装 ステージ衣装 レディーズ ダンスウェア 演出服 キャットスーツ 全身タイツ 光沢あり レオタード エナメル 猫 コスチューム ハロウィン 文化祭 ds-2320483 LGB11058 Panasonic ペンダントライト つり下げ型　LED（温白色） ダイニング用 美ルック・拡散タイプ・直付タイプ・コード50cm 木製（メープル調） 生活創造屋ヤフー店3-5374-05 pHメーター pHep5 HI98128N 校正証明書付 3537405 MTセキュリティショップ 店ソリッド 1200lbs 電磁ロック1200ポンド/545kg屋外防水マグロックフレームレスガラスドア木製ドアメタルドア用 LIFULLリフォーム 築54年！実家のような懐かしさを残すリノベーション 奈良県生駒市・戸建 内装スケルトン フルリノベーション ポールスミス正規店買付 チャーム付きリサイクルレザーカードケース 花柄 SHOPイーアス 店熱帯植物要覧 ds-2486954 Mr.Jの玉手箱ZARD／MUSIC VIDEO COLLECTION?25th ANNIVERSARY?（5DVD＋PHOTOBOOK） \[DVD\] ホクショー商事 ヤフー機械要素店三菱 NF-Cシリーズ ノーヒューズ遮断器(経済品) NF63-CV3P60A DreamFactoryCASEBUDi Electronics Accessories Organizer Case - Perfect Travel Organizer for Smart Phone Cables, Chargers, Ear Phones, SD Cards, USB, Hard Drives, Camera a Goodsaniaマスターロック・セントリー日本 セントリー　ビッグボルトシリーズ JFW205GGL ワコムジャパン液晶ペンタブレット Wacom Cintiq Pro 24 (DTH-2420/K0) 液タブ 4K 23.6型 AdobeRGBカバー率99% 99ショップシマノ(SHIMANO) ロッド 釣り竿 20 ゲームタイプJ S510-5 青一興業ドアロックラッチ、45mmバックセットドアロックラッチ亜鉛合金引き戸ロックラッチ交換部品ホームオフィス用 wattu.netエフ・アール・シー(F.R.C) FIRSTEC FT-DR ZERO II Plus ドライブレコーダー FT-DR ZEROII Plus 工事資材通販 ガテン市場ＡＳ 2-8159-24 樹脂製角型容器５４Ｌ 2815924 アースダンボールYahoo!店ダンボール 140サイズ 61×46.5×43.5 (宅配 引越し 段ボール箱) 10枚 A0140 みにゅーとストアROSONWAY USB3.2 HUB USB-A+C to USB3.2*2+Type-C*1+USB2.0*4+SD/TFカードリーダー 7-in- 読谷ショップ 店アンティーク調 シーリング照明 レトロ 長澤ライティング Nagasawa Lighting アンティークブロンズ ベージュ 10畳 LGBZ8215 (P ピーウェーブAPENUTZ ドライブレコーダー ドラレコ FHD1080P 3インチ小型 防水リアカメラ付き 170度広角レンズ ループ録画 Gセンサー 駐車監 SHOES WANヤフー店NIKE AIR ZOOM FLIGHT 95 "BLACK METALLIC" ナイキ エア ズーム フライト スニーカー ( 黒 ブラック メンズ DV0820-100 ) 正規品 A-プライスYahoo!店Panasonic F-MV4300-WZ マテリアルホワイト ziaino\[次亜塩素酸 空間除菌脱臭機 (18畳まで)\] Ibis-Shop 店アサヒペン 水性ビッグ10多用途 10L 242チョコレート色 本体サイズ:240mm×240mm×350mm 全品送料無料 TSUBAMEシェーバー ブラウン シリーズ9 互換替刃 シルバー 92B F/C92B (または90B) ヤマカツ カセットF/C92S F/C90S F/C90B F らんくうショッピング ソニー WMC-NW20MU ウォークマン用 USB ケーブル ライフハーモニー7SpeedyPublishing It's a Time Thing LIFESTAGE Nana! Yahoo!店7個セット クレバーソーン 6カ月用 36ml ねこモテN 日本ペットフード \[猫用首輪 ペット用品\] MMC市場自動大かんな刃 HS 規格(H230X25X3.0) 入数(3) 【自動大鉋刃　ＨＳ】 Earth Wingチェーンソー 充電式 充電式チェーンソー 小型 家庭用 コードレス マキタ バッテリー互換性 剪定 伐採 電動チェーンソー 軽量 枝切り 6インチ 安全機能 不用品回収 エコトラYahoo!店三重県の不用品回収 ナノズ 店EMPEX EX-2813 スーパーEX 温度・湿度・気圧計 EX2813 測定キューブツイッギーのしっぽオートピンチEXブラックSサイズ ペッツルート返品種別A みんなのお薬バリュープライス和光堂 赤ちゃんのやさしいホットケーキミックス かぼちゃとさつまいも 100g 7個セット ジェットラグYahoo!店(取寄) アディダス ゴルフ レディース ゴー-トゥー ヘザー ショート スリーブ ポロシャツ adidas Golf women Go-To Heather Short Sleeve Polo Shirt Silver Pebble JURI SHOPSオニツカタイガー プルオーバー Onitsuka Tiger メンズ GRAPHIC SWEAT TOP グラフィックスウェット トップ CREAM クリーム BLUSH ブラッシュ 2183B682 ウェビック1号店KNIPEX KNIPEX:クニペックス ツインフォースニッパー SB ヒロチー商事3号店86262-47A ハーレー純正 サポート、グラブストラップ HD店 kids love toysUSB歯ブラシ用充電器、Oral-B Pro 1000 1500 3000 6000 7000 7500電動歯ブラシ用USBケーブル交換用誘導充電ベース(白) ブックオフ ヤフーショッピング店都内名門女子中学校選びの相談室／安田誠(著者) SORA2023(四季報)(TOYOTA)トヨタ クラウン 2WD 2.0 ターボ RS タナベ サステックプロCR 車高調キット CRARS220K Lovely Stationベスト ジレ ニットベスト ニット レディース サイド開き スリット 前後差 袖なし 無地 レイヤード ゆったり 体型カバー ラウンドネック dress up storeフィットネスウェア レディース 冬 ジム 3点セット おしゃれ ヨガウェア 上下セット 冬 大きいサイズ ジャージ 上下 レディース トレーニングウェア ランニングウェア リコメン堂ホームライフ館シンプル スタンドミラー/姿見鏡 〔ブラウン 飛散防止加工 幅30cm〕 天然木 木製 脚付き 〔リビング〕〔代引不可〕 リコメン堂生活館エプソン 環境推進トナー LPC3T31CV シアン 6500ページ ds-1301085 オマツリライフAsus MB168B 15.6-Inch Screen LCD Monitor TBH-LIFE蚊除けブレスレット 虫よけバンド 蚊除けリング 蚊よけブレスレット 虫除けリング 蚊除け 蚊よけ 5色セット20本 亀よしエクレール スリムパルック(蛍光ランプ) FHC93EN-PDLN ヒロチー商事3号店17779-010 カワサキ純正 ブラケツト クーラー ダクト JP ルアー＆釣具 TackleTimeウキ釣り 超高輝度 充電式 LED 釣りウキ セット 夜釣り 電気ウキ 集魚灯 早割クーポンあり モノタロウ(個人向け)公式Yahoo!店エスコ 300mmはさみ・鉄板用(ストレート) SEVEN GRASSKIWIFOTOS レンズマウントアダプター Rollei QBM SLRレンズ Leica ライカ L M TYP701 T TYP701 M TYP262 M TYP240 M TYP240 M-E TYP220 M9-P M9 M8 カメラ ボディー装着用 子供ドレス アリサナ長傘 キッズ ジュニア 55cm 58cm 雨傘 女の子 子供傘 子ども 小学生 シンプル 無地 子供 かわいい おしゃれ ユニコーン arisana 白衣のおおぎやマスクケース 携帯用 マスクバッグ 抗菌加工 個包装 使い捨て 50枚入り 不織布マスク三層構造 耳が痛くならない UV99％カット 介護 看護 医療 ナース雑貨 アートフィッシュコーデュロイテーラードジャケット メンズ 秋冬用 茶/ダークブラウン M/L/LL/3L/4L/5L/BB5/BB6/BB7/BB8/BB9](https://resources.jetbrains.com/help/img/idea/2026.3/sb_downloaded_image.png)

4. 存在しない識別子をリクエストします。 ダウンロードエンドポイントは、JSON エンドポイントと同じように 404 で応答します。どちらもサービスに問い合わせ、  `null`  を同じように扱うためです。

[次のパート](spring-boot-tutorial-h2-database-jar.html)

