File Upload

Abrir en ChatGPT

Sombra 24.02

Java API

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

Usos

El FileUploadDialog proporciona una manera 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.

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

FileUploadDialogBasicView.java

Moviendo 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) {
  // 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 traversía de directorios o caracteres invá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();

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 la validación del lado del servidor para asegurarte de que los archivos subidos cumplan con los requisitos de tu aplicación.

Tamaño máximo

Es posible establecer el tamaño máximo de archivo para las subidas para garantizar que los usuarios no suban archivos que sean demasiado grandes para que tu aplicación los maneje. Esto se puede configurar usando el método setMaxFileSize(long maxSize), donde maxSize se especifica 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 usando la clase FileUploadI18n. Esta flexibilidad te permite adaptar la interfaz del diálogo para cumplir con requisitos de localización específicos o preferencias de personalización.

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

Mejores prácticas

1. Mensajes claros y concisos: Asegúrate de que el mensaje del aviso explique claramente lo que se le pide al usuario que suba.
2. Filtros apropiados: Establece filtros de archivos que coincidan con los tipos de archivos requeridos para asegurar que los usuarios suban 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 de 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: Usa diálogos de carga de archivos con moderación para evitar la frustración del usuario. Resérvalos para acciones que requieran subidas de archivos específicas del usuario.