Carga de archivos
Un FileUploadDialog es un cuadro de diálogo modal diseñado para permitir al usuario subir archivos desde su sistema de archivos local. El diálogo bloquea la ejecución de la aplicación hasta que el usuario selecciona los archivos para subir o cierra el diálogo.
Si quieres un selector de archivos que se renderice directamente en el diseño de la página en lugar de un diálogo, considera usar el componente Upload.
Usos
El FileUploadDialog proporciona una forma de seleccionar y subir archivos, permitiendo a los usuarios enviar documentos, imágenes u otros tipos de archivos requeridos por la aplicación. Usa showFileUploadDialog() para mostrar el diálogo y capturar el archivo subido.
UploadedFile result = OptionDialog.showFileUploadDialog("Sube un archivo");
Resultado
El FileUploadDialog devuelve un objeto UploadedFile que contiene información sobre el archivo subido, como su nombre, tamaño y contenido. Si el usuario cierra el diálogo sin seleccionar un archivo, el resultado será null.
El objeto UploadedFile resultante se devuelve del método show(), o el método equivalente de OptionDialog como se muestra a continuación.
Mover archivos subidos
Por defecto, webforJ almacena los archivos subidos en una carpeta temporal que se limpia regularmente. Si no mueves el archivo a otro lugar, será eliminado. Para mover el archivo, usa el método move y especifica la ruta de destino.
UploadedFile uploadedFile = OptionDialog.showFileUploadDialog("Selecciona un archivo para subir");
try {
File file = uploadedFile.move("mi/ruta/completa/" + uploadedFile.getSanitizedClientName());
// ... haz algo con el archivo
} catch (IOException e) {
// maneja la excepción
}
Usa el método getSanitizedClientName para obtener una versión sanitizada del nombre del archivo subido. Este método ayuda a prevenir riesgos de seguridad como ataques de recorrido de directorios o caracteres no válidos en los nombres de archivos, asegurando la integridad y seguridad de tu sistema de almacenamiento de archivos.
Filtros
El FileUploadDialog te permite establecer filtros para limitar los tipos de archivos que se pueden seleccionar para subir. Puedes configurar filtros usando el método setFilters(List<FileChooserFilter> filters).
FileUploadDialog dialog = new FileUploadDialog(
"Sube un archivo",
Arrays.asList(new FileChooserFilter("Archivos de Texto", "*.txt")));
UploadedFile result = dialog.show();
El servidor no validará el archivo subido contra los filtros. Los filtros se aplican solo en la interfaz de usuario para guiar la selección del usuario. Debes implementar la validación del lado del servidor para asegurar que los archivos subidos cumplan con los requisitos de tu aplicación.
Tamaño máximo
Usa setMaxFileSize(Number maxSize) para establecer el tamaño máximo de subida en bytes.
dialog.setMaxFileSize(2 * 1024 * 1024); // Establecer tamaño máximo a 2 MB
Internacionalización (i18n)
Los títulos, descripciones, etiquetas y mensajes dentro del componente son completamente personalizables utilizando la clase FileUploadI18n. Esta flexibilidad te permite adaptar la interfaz del diálogo para satisfacer requisitos de localización específicos o preferencias de personalización.
FileUploadDialog dialog = new FileUploadDialog("Subir archivo");
FileUploadI18n i18n = new FileUploadI18n();
i18n.setUpload("Subir");
i18n.setCancel("Cancelar");
dialog.setI18n(i18n);
UploadedFile result = dialog.show();
Mejores prácticas
- Mensajes claros y concisos: Asegúrate de que el mensaje de aviso explique claramente lo que se le pide al usuario que suba.
- Filtros apropiados: Establece filtros de archivos que coincidan con los tipos de archivos requeridos para garantizar que los usuarios suban archivos relevantes.
- Temática consistente: Ajusta los temas del diálogo y del campo de subida al diseño de tu aplicación.
- Minimiza el uso excesivo: Usa cuadros de diálogo de subida de archivos con moderación para evitar la frustración del usuario. Resérvalos para acciones que requieren especificaciones de carga de archivos por parte del usuario.
