Datei speichern

In ChatGPT öffnen

Schatten 24.21

Java API

FileSaveDialog ist ein modales Dialogfeld, das es Benutzern ermöglicht, eine Datei an einem bestimmten Ort im Serverdateisystem zu speichern. Der Dialog blockiert die Ausführung der Anwendung, bis der Benutzer einen Dateinamen angibt und die Aktion bestätigt oder den Dialog abbricht.

Verwendungen

Das FileSaveDialog bietet eine optimierte Methode zum Speichern von Dateien im Dateisystem und bietet benutzerkonfigurierbare Optionen für die Benennung von Dateien und den Umgang mit vorhandenen Dateien.

Ergebnis

Das FileSaveDialog gibt den ausgewählten Pfad als String zurück. Wenn der Benutzer den Dialog abbricht, ist das Ergebnis null.

Zweck des Dialogs

Dieser Dialog bewirkt nicht tatsächlich, dass Dateien gespeichert werden, sondern gibt den Dateinamen zurück, den der Benutzer ausgewählt hat.

Info

Der resultierende String wird von der Methode show() oder der entsprechenden Methode OptionDialog wie unten demonstriert zurückgegeben.

String result = OptionDialog.showFileSaveDialog(
    "Speichern Sie Ihre Datei", "/home/user/documents", "bericht.xls");

if (result != null) {
  OptionDialog.showMessageDialog("Ausgewählter Pfad: " + result, "Pfad ausgewählt");
} else {
  OptionDialog.showMessageDialog("Kein Pfad ausgewählt", "Pfad ausgewählt",
      MessageDialog.MessageType.ERROR);
}

Existiert-Aktion

Das FileSaveDialog bietet konfigurierbares Verhalten, wenn eine Datei mit dem angegebenen Namen bereits existiert:

• ACCEPT_WITHOUT_ACTION: Die Auswahl wird ohne zusätzliche Benutzeraktion akzeptiert.
• ERROR_DIALOGUE: Dem Benutzer wird ein Fehlerdialog angezeigt; die Auswahl ist nicht zulässig.
• CONFIRMATION_DIALOGUE: Dem Benutzer wird ein Dialog angezeigt, der um Bestätigung bittet. Dies ist die Standardoption.

FileSaveDialog dialog = new FileSaveDialog(
  "Speichern Sie Ihre Datei", "/home/user/documents", "bericht.xls");
dialog.setExistsAction(FileSaveDialog.ExistsAction.ERROR_DIALOGUE);
String result = dialog.show();

Auswahlmodus

Das FileSaveDialog unterstützt verschiedene Auswahlmodi, die es Ihnen ermöglichen, die Auswahlmethode an Ihre spezifischen Bedürfnisse anzupassen:

1. DATEIEN: Ermöglicht die Auswahl von Dateien nur.
2. VERZEICHNISSE: Ermöglicht die Auswahl von Verzeichnissen nur.
3. DATEIEN_UND_VERZEICHNISSE: Ermöglicht die Auswahl von sowohl Dateien als auch Verzeichnissen.

Anfangspfad

Geben Sie das Verzeichnis an, in dem der Dialog geöffnet wird, indem Sie den Anfangspfad angeben. Dies hilft den Benutzern, in einem logischen Verzeichnis für ihre Speicheroperation zu starten.

FileSaveDialog dialog = new FileSaveDialog(
  "Speichern Sie Ihre Datei", "/home/user/documents", "bericht.xls");
String result = dialog.show();

Einschränkung

Sie können den Dialog auf ein bestimmtes Verzeichnis einschränken, um zu verhindern, dass Benutzer außerhalb davon navigieren, indem Sie die Methode setRestricted(boolean restricted) verwenden.

FileSaveDialog dialog = new FileSaveDialog(
  "Speichern Sie Ihre Datei", "/home/user/documents", "bericht.xls");
dialog.setRestricted(true);
dialog.show();

Dateiname

Legen Sie einen Standarddateinamen für die Speicheroperation fest, um den Benutzern zu helfen und Fehler zu minimieren.

FileSaveDialog dialog = new FileSaveDialog("Speichern Sie Ihre Datei");
dialog.setName("bericht.xls");
String result = dialog.show();

Internationalisierung (i18n)

Verwenden Sie FileChooserI18n, um die Titel, Beschreibungen, Labels und Nachrichten des Dialogs für verschiedene lokale Anforderungen oder App-Anforderungen anzupassen.

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

Filter

Das FileSaveDialog ermöglicht es Ihnen, Filter festzulegen, um die Arten von Dateien zu begrenzen, die gespeichert werden können, indem Sie die Methode setFilters(List<FileChooserFilter> filters) verwenden.

Benutzerdefinierte Filter

Sie können benutzerdefinierte Filter aktivieren, um es Benutzern zu ermöglichen, ihre eigenen Dateifilter mit der Methode setCustomFilters(boolean customFilters) zu definieren. Filter werden standardmäßig im lokalen Speicher gespeichert und bei nachfolgenden Dialogaufrufen wiederhergestellt.

FileSaveDialog dialog = new FileSaveDialog("Speichern Sie Ihre Datei", "/home/user/documents");
dialog.setCustomFilters(true);
String result = dialog.show();

Best Practices

• Vordefinierte Dateinamen: Geben Sie einen logischen Standarddateinamen an, wo dies möglich ist.
• Bestätigen Sie Überschreibungen: Verwenden Sie CONFIRMATION_DIALOGUE für ExistsAction, um versehentliche Überschreibungen zu verhindern.
• Intuitiver Anfangspfad: Setzen Sie einen Anfangspfad, der den Erwartungen der Benutzer entspricht.
• Internationalisierung: Passen Sie den Dialogtext an, um die Benutzerfreundlichkeit für internationale Benutzer zu verbessern.
• Dateitypfilter: Nutzen Sie Filter, um Dateitypen einzuschränken und Benutzer zu gültigen Dateiendungen zu leiten.

Weiterlernen

ArtikelJava file upload: build a web UI with the webforJ Upload