Upload a file to compare response sizes.
JSON definition · shared/definitions/store-files.json
View on GitHub
{
"title": "Expense report",
"completeText": "Submit expense report",
"elements": [
{
"type": "text",
"name": "purpose",
"title": "Purpose of the expense",
"isRequired": true
},
{
"type": "file",
"name": "receipt",
"title": "Receipts",
"storeDataAsText": false,
"allowMultiple": true,
"maxSize": 5242880,
"acceptedTypes": "image/png,image/jpeg,image/webp,image/gif,application/pdf",
"isRequired": true,
"waitForUpload": true,
"description": "PNG, JPEG, WebP, GIF, or PDF files up to 5 MB each"
}
]
}
Client · shared/client/store-files.js · sjs:store-files.client
View on GitHub
// Upload: your server stores the files and returns an id (or a URL) for each
survey.onUploadFiles.add(async (_, options) => {
const body = new FormData();
options.files.forEach(file => body.append("files[]", file)); // "files[]": PHP keeps only the last of several "files"
const response = await fetch("/api/files", { method: "POST", body }).catch(() => null);
const ids = response?.ok ? await response.json().catch(() => null) : null;
if (!Array.isArray(ids) || ids.length !== options.files.length || ids.some(id => typeof id !== "string" || !id)) {
return options.callback([], ["Couldn't upload files. Please try again."]);
}
// The response stores these ids, not the file contents
options.callback(options.files.map((file, i) => ({ file, content: ids[i] })));
});
Client · shared/client/store-files.js · sjs:store-files.preview
View on GitHub
// Preview: only when the stored value is not a public URL the browser can open
survey.onDownloadFile.add(async (_, options) => {
try {
const res = await fetch(`/api/files/${encodeURIComponent(options.content)}`);
if (!res.ok) throw new Error("Preview unavailable");
const reader = new FileReader();
reader.onload = () => options.callback("success", reader.result);
reader.onerror = () => options.callback("error");
reader.readAsDataURL(await res.blob());
} catch {
options.callback("error");
show("file-status", "Couldn't load the preview. The file may be missing or inaccessible.");
}
});
Server · src/main/java/io/surveyjs/examples/StoreFilesController.java · sjs:store-files.server
View on GitHub
// POST /api/files — store uploads, return their ids in the same order
@PostMapping(path = "/api/files", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
public List<String> storeFiles(MultipartHttpServletRequest request) throws IOException {
List<MultipartFile> files = request.getFiles("files[]"); // the name on every platform: PHP keeps only the last of several "files"
if (files.isEmpty()) {
throw new ResponseStatusException(HttpStatus.UNPROCESSABLE_CONTENT, "Upload one or more files in a field named \"files[]\"");
}
for (MultipartFile file : files) { // check the whole batch before storing any
if (file.getSize() > MAX_BYTES) {
throw new ResponseStatusException(HttpStatus.UNPROCESSABLE_CONTENT, "Each file must be 5 MB or less");
}
if (FileType.detect(file) == null) { // PNG, JPEG, WebP, GIF or PDF by the bytes, never the client's Content-Type
throw new ResponseStatusException(HttpStatus.UNPROCESSABLE_CONTENT, file.getOriginalFilename() + " is not a PNG, JPEG, WebP, GIF or PDF file");
}
}
List<String> ids = new ArrayList<>();
for (MultipartFile file : files) {
String id = UUID.randomUUID().toString(); // named by id, never by the client
fileStore.write(id, file);
jdbc.sql("INSERT INTO files (id, name, type) VALUES (?, ?, ?)").params(id, file.getOriginalFilename(), FileType.detect(file)).update();
ids.add(id);
}
return ids;
}
Server · src/main/java/io/surveyjs/examples/StoreFilesController.java · sjs:store-files.download
View on GitHub
// GET /api/files/{id} — the content, for private files only; check access first
@GetMapping("/api/files/{id}")
public ResponseEntity<Resource> downloadFile(@PathVariable String id, @AuthenticationPrincipal User user) {
StoredFile file = jdbc.sql("SELECT id, name, type FROM files WHERE id = ?").param(id).query(StoredFile.class).optional().orElse(null);
if (file == null || !Permissions.canReadFile(user, file)) {
throw new ResponseStatusException(HttpStatus.NOT_FOUND); // 404, not 403: don't confirm the file exists
}
// nosniff and sandbox: an uploaded HTML or SVG never runs as this site
return ResponseEntity.ok().contentType(MediaType.parseMediaType(file.type()))
.header("X-Content-Type-Options", "nosniff").header("Content-Security-Policy", "sandbox")
.body(fileStore.read(file));
}