File Upload

Openen in ChatGPT

Schaduw 24.02

Java API

Een FileUploadDialog is een modaal dialoogvenster dat is ontworpen om de gebruiker in staat te stellen bestanden van hun lokale bestandssysteem te uploaden. De dialoog blokkeert de uitvoering van de app totdat de gebruiker bestanden selecteert om te uploaden of de dialoog sluit.

Toepassingen

De FileUploadDialog biedt een manier om bestanden te selecteren en te uploaden, zodat gebruikers documenten, afbeeldingen of andere bestandstypen kunnen indienen die door de app vereist zijn. Gebruik showFileUploadDialog() om de dialoog weer te geven en het geüploade bestand vast te leggen.

UploadedFile result = OptionDialog.showFileUploadDialog("Upload een bestand");

Resultaat

De FileUploadDialog retourneert een UploadedFile object dat informatie bevat over het geüploade bestand, zoals de naam, grootte en inhoud. Als de gebruiker de dialoog sluit zonder een bestand te selecteren, is het resultaat null.

important

De resulterende string wordt geretourneerd vanuit de show() methode, of de equivalente OptionDialog methode zoals hieronder getoond.

Toon Code

Java

Geüploade bestanden verplaatsen

Standaard slaat webforJ geüploade bestanden op in een tijdelijke map die regelmatig wordt schoongemaakt. Als je het bestand niet ergens anders verplaatst, wordt het verwijderd. Om het bestand te verplaatsen, gebruik je de move methode en geef je het bestemmingspad op.

UploadedFile uploadedFile = OptionDialog.showFileUploadDialog("Selecteer een bestand om te uploaden");
try {
  File file = uploadedFile.move("my/full/path/" + uploadedFile.getSanitizedClientName());
  // ... doe iets met het bestand
} catch (IOException e) {
  // handel de uitzondering af
}

Gepersonaliseerde Bestandsnaam

Gebruik de getSanitizedClientName methode om een gepersonaliseerde versie van de naam van het geüploade bestand te verkrijgen. Deze methode helpt beveiligingsrisico's te voorkomen, zoals directory traversal aanvallen of ongeldige tekens in bestandsnamen, en zorgt voor de integriteit en beveiliging van je bestandsopslagsysteem.

Filters

De FileUploadDialog stelt je in staat om filters in te stellen om de types bestanden die voor upload kunnen worden geselecteerd te beperken. Je kunt filters configureren met de setFilters(List<FileChooserFilter> filters) methode.

FileUploadDialog dialog = new FileUploadDialog(
  "Upload een bestand", 
  Arrays.asList(new FileChooserFilter("Tekstbestanden", "*.txt")));
UploadedFile result = dialog.show();

Validatie van Filters

De server valideert het geüploade bestand niet tegen de filters. De filters worden alleen in de UI toegepast om de selectie van de gebruiker te begeleiden. Je moet server-side validatie implementeren om ervoor te zorgen dat de geüploade bestanden voldoen aan de vereisten van je app.

Maximale grootte

Het is mogelijk om de maximale bestandsgrootte voor uploads in te stellen om ervoor te zorgen dat gebruikers geen bestanden uploaden die te groot zijn voor je app om te verwerken. Dit kan worden geconfigureerd met de setMaxFileSize(long maxSize) methode, waarbij maxSize in bytes wordt opgegeven.

dialog.setMaxFileSize(2 * 1024 * 1024); // Stel maximale grootte in op 2 MB

Internationalisatie (i18n)

De titels, beschrijvingen, labels en berichten binnen de component zijn volledig aanpasbaar met behulp van de FileUploadI18n klasse. Deze flexibiliteit stelt je in staat om de dialooginterface aan te passen aan specifieke lokalisatievereisten of personalisatievoorkeuren.

FileUploadDialog dialog = new FileUploadDialog("Bestand uploaden");
FileUploadI18n i18n = new FileUploadI18n();
i18n.setUpload("Uploaden");
i18n.setCancel("Annuleren");
dialog.setI18n(i18n);
UploadedFile result = dialog.show();

Beste praktijken

1. Duidelijke en Bondige Prompt: Zorg ervoor dat het promptbericht duidelijk uitlegt wat van de gebruiker wordt gevraagd om te uploaden.
2. Geschikte Filters: Stel bestandsfilters in die overeenkomen met de vereiste bestandstypen om ervoor te zorgen dat gebruikers relevante bestanden uploaden.
3. Logische Beginpaden: Stel beginpaden in die gebruikers een nuttig startpunt bieden voor hun bestandsselectie.
4. Beperk Directory Navigatie: Beperk de dialoog tot een specifieke directory wanneer dat nodig is om te voorkomen dat gebruikers naar ongeautoriseerde gebieden navigeren.
5. Consistente Thema's: Stem de thema's van de dialoog en uploadvelden af op het ontwerp van je app voor een samenhangende gebruikerservaring.
6. Minimaliseer Overmatig Gebruik: Gebruik bestandsuploaddialogen spaarzaam om frustratie bij gebruikers te voorkomen. Behoud ze voor acties die specifieke bestand uploads van gebruikers vereisen.