File Save

Abrir en ChatGPT

Sombra 24.21

Java API

FileSaveDialog es un cuadro de diálogo modal diseñado para permitir a los usuarios guardar un archivo en una ubicación especificada en el sistema de archivos del servidor. El cuadro de diálogo bloquea la ejecución de la aplicación hasta que el usuario proporciona un nombre de archivo y confirma la acción o cancela el cuadro de diálogo.

Usos

El FileSaveDialog proporciona un método simplificado para guardar archivos en el sistema de archivos, ofreciendo opciones configurables por el usuario para el nombramiento de archivos y el manejo de archivos existentes.

Mostrar Código

Java

Resultado

El FileSaveDialog devuelve la ruta seleccionada como una cadena. Si el usuario cancela el cuadro de diálogo, el resultado será null.

Propósito del diálogo

Este diálogo no causa que se guarden archivos, sino que devuelve el nombre de archivo que el usuario ha seleccionado.

info

La cadena resultante se devuelve desde el método show() o el método equivalente OptionDialog como se demuestra a continuación.

String result = OptionDialog.showFileSaveDialog(
    "Guarde su archivo", "/home/user/documents", "report.xls");

if (result != null) {
  OptionDialog.showMessageDialog("Archivo guardado en: " + path, "Ruta Seleccionada");
} else {
  OptionDialog.showMessageDialog("No se seleccionó ninguna ruta", "Ruta Seleccionada",
      MessageDialog.MessageType.ERROR);
}

Acción de existencia

El FileSaveDialog proporciona un comportamiento configurable cuando un archivo con el nombre especificado ya existe:

• ACCEPT_WITHOUT_ACTION: La selección se acepta sin acción adicional del usuario.
• ERROR_DIALOGUE: Se presenta un cuadro de diálogo de error al usuario; la selección no está permitida.
• CONFIRMATION_DIALOGUE: Se presenta un cuadro de diálogo al usuario solicitando confirmación. Esta es la opción predeterminada.

FileSaveDialog dialog = new FileSaveDialog(
  "Guarde su archivo", "/home/user/documents", "report.xls");
dialog.setExistsAction(FileSaveDialog.ExistsAction.ERROR_DIALOGUE);
String result = dialog.show();

Modo de selección

El FileSaveDialog soporta diferentes modos de selección, permitiéndole personalizar el método de selección según sus necesidades específicas:

1. FILES: Permite la selección de solo archivos.
2. DIRECTORIES: Permite la selección de solo directorios.
3. FILES_AND_DIRECTORIES: Permite la selección de tanto archivos como directorios.

Ruta inicial

Especifique el directorio donde se abrirá el cuadro de diálogo utilizando la ruta inicial. Esto ayuda a los usuarios a comenzar en un directorio lógico para su operación de guardado.

FileSaveDialog dialog = new FileSaveDialog(
  "Guarde su archivo", "/home/user/documents", "report.xls");
String result = dialog.show();

Restricción

Puede restringir el cuadro de diálogo a un directorio específico, impidiendo que los usuarios naveguen fuera de él utilizando el método setRestricted(boolean restricted).

FileSaveDialog dialog = new FileSaveDialog(
  "Guarde su archivo", "/home/user/documents", "report.xls");
dialog.setRestricted(true);
dialog.show();

Nombre de archivo

Establezca un nombre de archivo predeterminado para la operación de guardado para guiar a los usuarios y minimizar errores.

FileSaveDialog dialog = new FileSaveDialog("Guarde su archivo");
dialog.setName("report.xls");
String result = dialog.show();

Internacionalización (i18n)

Los títulos, descripciones, etiquetas y mensajes dentro del componente son completamente personalizables utilizando la clase FileSaveI18n. Esto asegura que el cuadro de diálogo pueda adaptarse a varios requisitos de localización o personalización.

FileSaveDialog dialog = new FileSaveDialog("Speichern Sie Ihre Datei");
FileChooserI18n i18n = new FileChooserI18n();
i18n.setChoose("Wählen");
i18n.setCancel("Stornieren");
dialog.setI18n(i18n);

Filtros

El FileSaveDialog permite establecer filtros para limitar los tipos de archivos que se pueden guardar utilizando el método setFilters(List<FileSaveFilter> filters).

Mostrar Código

Java

Filtros personalizados

Puede habilitar filtros personalizados para permitir a los usuarios definir sus propios filtros de archivo utilizando el método setCustomFilters(boolean customFilters). Los filtros se guardan en el almacenamiento local por defecto y se restauran en las invocaciones posteriores del cuadro de diálogo.

FileSaveDialog dialog = new FileSaveDialog("Guarde su archivo", "/home/user/documents");
dialog.setCustomFilters(true);
String result = dialog.show();

Mejores prácticas

• Nombres de archivo predefinidos: Proporcione un nombre de archivo predeterminado lógico donde sea aplicable.
• Confirmar sobrescrituras: Utilice CONFIRMATION_DIALOGUE para ExistsAction para evitar sobrescrituras accidentales.
• Ruta inicial intuitiva: Establezca una ruta inicial que se alinee con las expectativas del usuario.
• Internacionalización: Personalice el texto del cuadro de diálogo para mejorar la usabilidad para audiencias internacionales.
• Filtros de tipo de archivo: Aproveche los filtros para restringir tipos de archivos y guiar a los usuarios hacia extensiones de archivos válidas.