Diálogo de Carga de Archivos

Abrir en ChatGPT

Shadow 24.02

Java API

Un FileUploadDialog es un diálogo modal diseñado para permitir al usuario cargar archivos desde su sistema de archivos local. El diálogo bloquea la ejecución de la aplicación hasta que el usuario seleccione archivos para cargar o cierre el diálogo.

UploadedFile result = OptionDialog.showFileUploadDialog("Cargar un archivo");

Usos

El FileUploadDialog proporciona una manera de seleccionar y cargar archivos, permitiendo a los usuarios enviar documentos, imágenes u otros tipos de archivos requeridos por la aplicación.

Resultado

El FileUploadDialog devuelve un objeto UploadedFile que contiene información sobre el archivo cargado, como su nombre, tamaño y contenido. Si el usuario cierra el diálogo sin seleccionar un archivo, el resultado será null.

important

La cadena resultante será devuelta desde el método show(), o el método equivalente de OptionDialog como se muestra a continuación.

Mostrar Código

Java

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, utiliza el método move y especifica la ruta de destino.

UploadedFile uploadedFile = OptionDialog.showFileUploadDialog("Selecciona un archivo para cargar");
try {
    File file = uploadedFile.move("mi/ruta/completa/" + uploadedFile.getSanitizedClientName());
    // ... haz algo con el archivo
} catch (IOException e) {
    // manejar la excepción
}

Nombre de Cliente Sanitizado

Utiliza 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 traversal de directorios o caracteres inválidos en nombres de archivos, asegurando la integridad y seguridad de tu sistema de almacenamiento de archivos.

Filtros

El FileUploadDialog permite establecer filtros para limitar los tipos de archivos que se pueden seleccionar para cargar. Puedes configurar filtros utilizando el método setFilters(List<FileChooserFilter> filters).

FileUploadDialog dialog = new FileUploadDialog(
    "Cargar un archivo", 
    Arrays.asList(new FileChooserFilter("Archivos de Texto", "*.txt")));
UploadedFile result = dialog.show();

Validación de Filtros

El servidor no validará el archivo subido contra los filtros. Los filtros solo se aplican en la interfaz de usuario para guiar la selección del usuario. Debes implementar una validación del lado del servidor para asegurarte de que los archivos subidos cumplen con los requisitos de tu aplicación.

Tamaño máximo

Es posible establecer el tamaño máximo de archivo para las cargas para asegurarse de que los usuarios no suban archivos que sean demasiado grandes para que tu aplicación los maneje. Esto se puede configurar utilizando el método setMaxFileSize(long maxSize), donde maxSize se especifica en bytes.

dialog.setMaxFileSize(2 * 1024 * 1024); // Establecer el 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 cumplir con requisitos específicos de localización o preferencias de personalización.

FileUploadDialog dialog = new FileUploadDialog("Cargar archivo");
FileUploadI18n i18n = new FileUploadI18n();
i18n.setUpload("Cargar");
i18n.setCancel("Cancelar");
dialog.setI18n(i18n);
UploadedFile result = dialog.show();

Mejores prácticas

1. Mensajes Claros y Concisos: Asegúrate de que el mensaje de aviso explique claramente lo que se le está pidiendo al usuario que cargue.
2. Filtros Apropiados: Establece filtros de archivos que coincidan con los tipos de archivos requeridos para asegurarte de que los usuarios carguen archivos relevantes.
3. Rutas Iniciales Lógicas: Establece rutas iniciales que proporcionen a los usuarios un punto de partida útil para su selección de archivos.
4. Restringir la Navegación por Directorios: Restringe el diálogo a un directorio específico cuando sea necesario para evitar que los usuarios naveguen a áreas no autorizadas.
5. Tematización Consistente: Alinea los temas del diálogo y el campo de carga con el diseño de tu aplicación para una experiencia de usuario cohesiva.
6. Minimizar el Uso Excesivo: Utiliza diálogos de carga de archivos con moderación para evitar la frustración del usuario. Resérvalos para acciones que requieran cargas de archivos específicas por parte del usuario.