tiedoston latausdialogi
FileUploadDialog on modaalinen dialogi, joka on suunniteltu sallimaan käyttäjän ladata tiedostoja paikalliselta tiedostojärjestelmältään. Dialogi estää sovelluksen suorittamisen, kunnes käyttäjä valitsee ladattavat tiedostot tai sulkee dialogin.
UploadedFile result = OptionDialog.showFileUploadDialog("Lataa tiedosto");
Käytännöt
FileUploadDialog tarjoaa tavan valita ja ladata tiedostoja, jolloin käyttäjät voivat toimittaa asiakirjoja, kuvia tai muita sovelluksen tarvitsemia tiedostotyyppejä.
Tulos
FileUploadDialog palauttaa UploadedFile-objektin, joka sisältää tietoa ladatusta tiedostosta, kuten sen nimen, koon ja sisällön. Jos käyttäjä sulkee dialogin valitsematta tiedostoa, tulos on null.
Tuloksena oleva merkkijono palautetaan show()-menetelmästä tai vastaavasta OptionDialog-menetelmästä, kuten alla on esitetty.
Näytä Koodi
- Java
Laddettujen tiedostojen siirtäminen
Oletuksena webforJ tallentaa ladatut tiedostot väliaikaiseen kansioon, joka siivotaan säännöllisesti. Jos et siirrä tiedostoa muualle, se poistetaan. Siirtääksesi tiedoston, käytä move-menetelmää ja määritä kohdepolku.
UploadedFile uploadedFile = OptionDialog.showFileUploadDialog("Valitse ladattava tiedosto");
try {
File file = uploadedFile.move("my/full/path/" + uploadedFile.getSanitizedClientName());
// ... tee jotain tiedoston kanssa
} catch (IOException e) {
// käsittele poikkeus
}
Käytä getSanitizedClientName-menetelmää saadaksesi puhtaan version ladatun tiedoston nimestä. Tämä menetelmä auttaa estämään turvallisuusriskejä, kuten hakemistoon navigointi hyökkäyksiä tai virheellisiä merkkejä tiedostonimissä, varmistaen tiedostojärjestelmäsi eheyden ja turvallisuuden.
Suodattimet
FileUploadDialog sallii suodattimien asettamisen, jotta voidaan rajoittaa ladattavien tiedostojen tyyppejä. Voit määrittää suodattimia setFilters(List<FileChooserFilter> filters)-menetelmällä.
FileUploadDialog dialog = new FileUploadDialog(
"Lataa tiedosto",
Arrays.asList(new FileChooserFilter("Tekstitiedostot", "*.txt")));
UploadedFile result = dialog.show();
Palvelin ei validoi ladattua tiedostoa suodattimien mukaan. Suodattimia sovelletaan vain käyttöliittymässä ohjaamaan käyttäjän valintaa. Sinun on toteutettava palvelinpuolen validointi varmistaaksesi, että ladatut tiedostot täyttävät sovelluksesi vaatimukset.
Suurin koko
On mahdollista asettaa uploadien maksimaalinen tiedostokoko varmistaaksesi, että käyttäjät eivät lataa tiedostoja, jotka ovat liian suuria sovelluksesi käsiteltäväksi. Tämä voidaan määrittää setMaxFileSize(long maxSize)-menetelmällä, jossa maxSize määritellään tavuina.
dialog.setMaxFileSize(2 * 1024 * 1024); // Aseta maksimikoko 2 MB
Kansainvälistäminen (i18n)
Komponentin otsikot, kuvaukset, tunnisteet ja viestit ovat täysin räätälöitävissä FileUploadI18n-luokan avulla. Tämä joustavuus mahdollistaa dialogikäyttöliittymän mukauttamisen erityisten lokalisointivaatimusten tai henkilökohtaisten mieltymysten täyttämiseksi.
FileUploadDialog dialog = new FileUploadDialog("Lataa tiedosto");
FileUploadI18n i18n = new FileUploadI18n();
i18n.setUpload("Lataa");
i18n.setCancel("Peruuta");
dialog.setI18n(i18n);
UploadedFile result = dialog.show();
Parhaat käytännöt
- Selkeät ja ytimekkäät ohjeet: Varmista, että kehotusviesti selkeästi selittää, mitä käyttäjältä kysytään ladattavaksi.
- Sopivat suodattimet: Aseta tiedostosuodattimet, jotka vastaavat vaadittuja tiedostotyyppejä, jotta käyttäjät lataavat asiaankuuluvia tiedostoja.
- Loogiset aloituspolut: Aseta aloituspolut, jotka tarjoavat käyttäjille hyödyllisen lähtöpisteen tiedostovalinnalle.
- Rajoita hakemiston navigointia: Rajoita dialogi tiettyyn hakemistoon tarpeen mukaan estääksesi käyttäjiä navigoimasta oikeudettomiin alueisiin.
- Johdonmukainen teema: Yhdistele dialogin ja latauskentän teemat sovelluksesi designiin yhtenäisen käyttäjäkokemuksen varmistamiseksi.
- Vähennä liiallista käyttöä: Käytä tiedoston latausdialogeja säästeliäästi käyttäjäfrustraation välttämiseksi. Varaa niitä erityisiin käyttäjän tiedoston lataustoimintoihin.