ファイルアップロード#

multipart/form-data で来たファイルは bodyFile() から取ります。

Data files = context.request().bodyFile();

受け取る#

for (Object value : context.request().bodyFile().values()) {
	if (value instanceof List<?> list) {
		for (Object item : list) {
			UploadFile uploadFile = (UploadFile) item;
			received.add("%s:%s:%d".formatted(
				uploadFile.name, uploadFile.fileName, uploadFile.fileSize));
			received.add("content=" + read(uploadFile.file.toPath()));
			tempFiles.add(uploadFile.file.toPath());
		}
	}
}

取り出すのは UploadFile です。メソッドを持たない入れ物で、中身はこれだけです。

一時ファイル#

一時ファイルには deleteOnExit() を付けていません。 プロセスが落ちれば残るので、そこは OS の一時ディレクトリの掃除に任せています。

上限#

設定を書かなくても上限は掛かります（要件 NF-S-05）。

upload {
	max_file_size  = 10485760   # 1ファイル。既定 10MB
	max_total_size = 52428800   # 1リクエスト合計。既定 50MB
	max_files      = 20         # 件数
	temp_dir       = ""         # 空なら java.io.tmpdir
}

超えたときはその場で例外になり、書きかけの一時ファイルも消します。

サイズは読みながら見ています。全部受け取ってから測ると、 上限を超えた分までディスクに書いてしまうからです。

保存する#

保存のヘルパはありません。uploadFile.file を JDK の Files で写します。

private static String saveImage (WebContext context) throws Exception {

	UploadFile uploadFile = firstFile(context);

	if (uploadFile == null || uploadFile.fileSize <= 0) {
		return null;
	}

	String extension = extensionOf(uploadFile.fileName);

	if (!ALLOWED_EXTENSIONS.contains(extension)) {
		throw new io.jimble.web.http.HttpException(
			400, "受け付けられない形式です: %s（%s のみ）"
				.formatted(uploadFile.fileName, String.join(" ", ALLOWED_EXTENSIONS)));
	}

	Path dir = Path.of(UPLOAD_DIR);
	Files.createDirectories(dir);

	String saved = UUID.randomUUID() + extension;

	/*
	 * 一時ファイルはリクエストが終わると消える（要件 F-W-06）。
	 * 残したいものはここで移す。
	 */
	Files.copy(uploadFile.file.toPath(), dir.resolve(saved), StandardCopyOption.REPLACE_EXISTING);

	return saved;

}

要点は3つです。

テキスト項目との混在#

同じ本文に入っているので、1回で解析して持っておきます（本文は1回しか読めません）。 ファイル名の無いパートはテキスト項目として扱われ、bodyAll() に載ります。

返す（ダウンロード）#

context.response().download(file);                  // 実ファイル名で添付
context.response().download(file, "報告書.xlsx");   // 名前を指定して添付
context.response().file(file);                      // インライン（種類は中身から判定）
context.response().file(file, "image/png");         // インライン（種類を指定）
context.response().stream(in, "text/csv");          // ストリーム
context.response().stream(in, "text/csv", length);  // 長さが分かっているストリーム

Content-Disposition は RFC 5987 の形（filename*=UTF-8''...）で付くので、 日本語のファイル名がそのまま通ります。