Always sanitize braces on save and remove InvalidFieldValueException

.jbang/JabKitLauncher.java

@@ -9,6 +9,7 @@
 //REPOS mavencentral,mavencentralsnapshots=https://central.sonatype.com/repository/maven-snapshots/,raw=https://raw.githubusercontent.com/JabRef/jabref/refs/heads/main/jablib/lib/
 
 //DEPS org.jabref:jablib:6.0-SNAPSHOT
+// see  https://github.com/gradlex-org/extra-java-module-info/issues/237 why we include e-adr here
 //DEPS io.github.adr:e-adr:2.0.0
 
 // requirements needed by jabkit projecxt need to be listed; requirements by jablib are loaded transitively

.jbang/JabLsLauncher.java

@@ -9,6 +9,8 @@
 //REPOS mavencentral,mavencentralsnapshots=https://central.sonatype.com/repository/maven-snapshots/,raw=https://raw.githubusercontent.com/JabRef/jabref/refs/heads/main/jablib/lib/
 
 //DEPS org.jabref:jablib:6.0-SNAPSHOT
+// see  https://github.com/gradlex-org/extra-java-module-info/issues/237 why we include e-adr here
+//DEPS io.github.adr:e-adr:2.0.0
 
 // from jabls-cli
 //DEPS info.picocli:picocli:4.7.7

.jbang/JabSrvLauncher.java

@@ -9,6 +9,8 @@
 //REPOS mavencentral,mavencentralsnapshots=https://central.sonatype.com/repository/maven-snapshots/,raw=https://raw.githubusercontent.com/JabRef/jabref/refs/heads/main/jablib/lib/
 
 //DEPS org.jabref:jablib:6.0-SNAPSHOT
+// see  https://github.com/gradlex-org/extra-java-module-info/issues/237 why we include e-adr here
+//DEPS io.github.adr:e-adr:2.0.0
 
 // from jabsrv-cli
 //DEPS info.picocli:picocli:4.7.7

jabgui/src/main/java/org/jabref/gui/autosaveandbackup/BackupManager.java

@@ -22,7 +22,6 @@
 import org.jabref.gui.LibraryTab;
 import org.jabref.gui.maintable.BibEntryTableViewModel;
 import org.jabref.gui.maintable.columns.MainTableColumn;
-import org.jabref.logic.bibtex.InvalidFieldValueException;
 import org.jabref.logic.exporter.AtomicFileWriter;
 import org.jabref.logic.exporter.BibDatabaseWriter;
 import org.jabref.logic.exporter.BibWriter;
@@ -272,7 +271,7 @@ void performBackup(Path backupPath) {
             // Thus, we currently do not need any new backup
             this.needsBackup = false;
         } catch (IOException e) {
-            logIfCritical(backupPath, e);
+            LOGGER.error("Error while saving to file {}", backupPath, e);
         }
     }
 
@@ -293,19 +292,6 @@ public void discardBackup(Path backupDir) {
         }
     }
 
-    private void logIfCritical(Path backupPath, IOException e) {
-        Throwable innermostCause = e;
-        while (innermostCause.getCause() != null) {
-            innermostCause = innermostCause.getCause();
-        }
-        boolean isErrorInField = innermostCause instanceof InvalidFieldValueException;
-
-        // do not print errors in field values into the log during autosave
-        if (!isErrorInField) {
-            LOGGER.error("Error while saving to file {}", backupPath, e);
-        }
-    }
-
     @Subscribe
     public synchronized void listen(@SuppressWarnings("unused") BibDatabaseContextChangedEvent event) {
         if (!event.isFilteredOut()) {

jabgui/src/main/java/org/jabref/gui/collab/entrychange/PreviewWithSourceTab.java

@@ -78,7 +78,7 @@ private String getSourceString(BibEntry entry,
                                    BibEntryTypesManager entryTypesManager) throws IOException {
         StringWriter writer = new StringWriter();
         BibWriter bibWriter = new BibWriter(writer, OS.NEWLINE);
-        FieldWriter fieldWriter = FieldWriter.buildIgnoreHashes(fieldPreferences);
+        FieldWriter fieldWriter = new FieldWriter(fieldPreferences);
         new BibEntryWriter(fieldWriter, entryTypesManager).write(entry, bibWriter, type);
         return writer.toString();
     }

jabgui/src/main/java/org/jabref/gui/entryeditor/SourceTab.java

@@ -38,7 +38,6 @@
 import org.jabref.logic.bibtex.BibEntryWriter;
 import org.jabref.logic.bibtex.FieldPreferences;
 import org.jabref.logic.bibtex.FieldWriter;
-import org.jabref.logic.bibtex.InvalidFieldValueException;
 import org.jabref.logic.exporter.BibWriter;
 import org.jabref.logic.importer.ImportFormatPreferences;
 import org.jabref.logic.importer.ParserResult;
@@ -161,7 +160,7 @@ private void highlightField(Field field, String searchPattern) {
     private String getSourceString(BibEntry entry, BibDatabaseMode type, FieldPreferences fieldPreferences) throws IOException {
         try (StringWriter writer = new StringWriter()) {
             BibWriter bibWriter = new BibWriter(writer, "\n"); // JavaFX works with LF only
-            FieldWriter fieldWriter = FieldWriter.buildIgnoreHashes(fieldPreferences);
+            FieldWriter fieldWriter = new FieldWriter(fieldPreferences);
             BibEntryWriter bibEntryWriter = new BibEntryWriter(fieldWriter, entryTypesManager);
             bibEntryWriter.write(entry, bibWriter, type, true);
             fieldPositions = bibEntryWriter.getFieldPositions();
@@ -276,95 +275,102 @@ private void storeSource(BibEntry outOfFocusEntry, String text) {
         }
 
         BibtexParser bibtexParser = new BibtexParser(importFormatPreferences, fileMonitor);
+        ParserResult parserResult;
         try {
-            ParserResult parserResult = bibtexParser.parse(Reader.of(text));
-            BibDatabase database = parserResult.getDatabase();
-
-            if (database.getEntryCount() > 1) {
-                LOGGER.error("More than one entry found.");
-                // We use the error dialog as the notification is hidden
-                dialogService.showWarningDialogAndWait(
-                        Localization.lang("Problem with parsing entry"),
-                        Localization.lang("Parsing failed because more than one entry was found. Please check your BibTeX syntax.")
-                );
-                return;
-            }
-
-            if (!database.hasEntries()) {
-                if (parserResult.hasWarnings()) {
-                    LOGGER.warn("Could not store entry", parserResult.warnings());
-                    String errors = parserResult.getErrorMessage();
-                    dialogService.showErrorDialogAndWait(errors);
-                    validationMessage.setValue(ValidationMessage.error(Localization.lang("Failed to parse Bib(La)TeX: %0", errors)));
-                    return;
-                } else {
-                    LOGGER.warn("No entries found.");
-                    String errors = Localization.lang("No entries available");
-                    dialogService.showErrorDialogAndWait(errors);
-                    validationMessage.setValue(ValidationMessage.error(Localization.lang("Failed to parse Bib(La)TeX: %0", errors)));
-                    return;
-                }
-            }
+            parserResult = bibtexParser.parse(Reader.of(text));
+        } catch (IOException ex) {
+            validationMessage.setValue(ValidationMessage.error(Localization.lang("Failed to parse Bib(La)TeX: %0", ex.getMessage())));
+            LOGGER.debug("Incorrect source", ex);
+            return;
+        }
+        BibDatabase database = parserResult.getDatabase();
+
+        if (database.getEntryCount() > 1) {
+            LOGGER.error("More than one entry found.");
+            // We use the error dialog as the notification is hidden
+            dialogService.showWarningDialogAndWait(
+                    Localization.lang("Problem with parsing entry"),
+                    Localization.lang("Parsing failed because more than one entry was found. Please check your BibTeX syntax.")
+            );
+            return;
+        }
 
+        if (!database.hasEntries()) {
             if (parserResult.hasWarnings()) {
-                LOGGER.warn("Failed to parse Bib(La)TeX", parserResult.warnings());
+                LOGGER.warn("Could not store entry: {}", parserResult.warnings());
                 String errors = parserResult.getErrorMessage();
                 dialogService.showErrorDialogAndWait(errors);
                 validationMessage.setValue(ValidationMessage.error(Localization.lang("Failed to parse Bib(La)TeX: %0", errors)));
+                return;
+            } else {
+                LOGGER.warn("No entries found.");
+                String errors = Localization.lang("No entries available");
+                dialogService.showErrorDialogAndWait(errors);
+                validationMessage.setValue(ValidationMessage.error(Localization.lang("Failed to parse Bib(La)TeX: %0", errors)));
+                return;
             }
+        }
 
-            NamedCompoundEdit compound = new NamedCompoundEdit(Localization.lang("source edit"));
-            BibEntry newEntry = database.getEntries().getFirst();
-            newEntry.getCitationKey()
-                    .ifPresentOrElse(
-                            outOfFocusEntry::setCitationKey,
-                            () -> outOfFocusEntry.clearCiteKey());
-
-            // First, remove fields that the user has removed.
-            for (Map.Entry<Field, String> field : outOfFocusEntry.getFieldMap().entrySet()) {
-                Field fieldName = field.getKey();
-                String fieldValue = field.getValue();
-
-                if (!newEntry.hasField(fieldName)) {
-                    compound.addEdit(new UndoableFieldChange(outOfFocusEntry, fieldName, fieldValue, null));
-                    outOfFocusEntry.clearField(fieldName);
-                }
+        if (parserResult.hasWarnings()) {
+            LOGGER.warn("Failed to parse Bib(La)TeX: {}", parserResult.warnings());
+            String errors = parserResult.getErrorMessage();
+            dialogService.showErrorDialogAndWait(errors);
+            validationMessage.setValue(ValidationMessage.error(Localization.lang("Failed to parse Bib(La)TeX: %0", errors)));
+        }
+
+        NamedCompoundEdit compound = new NamedCompoundEdit(Localization.lang("source edit"));
+        BibEntry newEntry = database.getEntries().getFirst();
+        newEntry.getCitationKey()
+                .ifPresentOrElse(
+                        outOfFocusEntry::setCitationKey,
+                        outOfFocusEntry::clearCiteKey);
+
+        // First, remove fields that the user has removed.
+        for (Map.Entry<Field, String> field : outOfFocusEntry.getFieldMap().entrySet()) {
+            Field fieldName = field.getKey();
+            String fieldValue = field.getValue();
+
+            if (!newEntry.hasField(fieldName)) {
+                compound.addEdit(new UndoableFieldChange(outOfFocusEntry, fieldName, fieldValue, null));
+                outOfFocusEntry.clearField(fieldName);
             }
+        }
 
-            // Then set all fields that have been set by the user.
-            for (Map.Entry<Field, String> field : newEntry.getFieldMap().entrySet()) {
-                Field fieldName = field.getKey();
-                String oldValue = outOfFocusEntry.getField(fieldName).orElse(null);
-                String newValue = field.getValue();
-                if (!Objects.equals(oldValue, newValue)) {
-                    // Test if the field is legally set.
-                    new FieldWriter(fieldPreferences).write(fieldName, newValue);
-
-                    compound.addEdit(new UndoableFieldChange(outOfFocusEntry, fieldName, oldValue, newValue));
-                    outOfFocusEntry.setField(fieldName, newValue);
+        // Then set all fields that have been set by the user.
+        for (Map.Entry<Field, String> field : newEntry.getFieldMap().entrySet()) {
+            Field fieldName = field.getKey();
+            String oldValue = outOfFocusEntry.getField(fieldName).orElse(null);
+            String newValue = field.getValue();
+            if (!Objects.equals(oldValue, newValue)) {
+                // Test if the field is legally set.
+                List<String> errors = FieldWriter.checkBalancedBraces(newValue);
+                if (!errors.isEmpty()) {
+                    validationMessage.setValue(ValidationMessage.error(
+                            Localization.lang("Failed to parse Bib(La)TeX: %0", String.join("\n", errors))));
+                    return;
                 }
-            }
 
-            // See if the user has changed the entry type:
-            if (!Objects.equals(newEntry.getType(), outOfFocusEntry.getType())) {
-                compound.addEdit(new UndoableChangeType(outOfFocusEntry, outOfFocusEntry.getType(), newEntry.getType()));
-                outOfFocusEntry.setType(newEntry.getType());
-            }
-            compound.end();
-            undoManager.addEdit(compound);
-
-            ObservableList<BibEntry> selectedEntries = stateManager.getSelectedEntries();
-            if (selectedEntries == null || selectedEntries.isEmpty()) {
-                stateManager.activeTabProperty().get().ifPresent(libraryTab ->
-                        libraryTab.getMainTable().clearAndSelect(outOfFocusEntry)
-                );
+                compound.addEdit(new UndoableFieldChange(outOfFocusEntry, fieldName, oldValue, newValue));
+                outOfFocusEntry.setField(fieldName, newValue);
             }
+        }
 
-            validationMessage.setValue(null);
-        } catch (InvalidFieldValueException | IOException ex) {
-            validationMessage.setValue(ValidationMessage.error(Localization.lang("Failed to parse Bib(La)TeX: %0", ex.getMessage())));
-            LOGGER.debug("Incorrect source", ex);
+        // See if the user has changed the entry type:
+        if (!Objects.equals(newEntry.getType(), outOfFocusEntry.getType())) {
+            compound.addEdit(new UndoableChangeType(outOfFocusEntry, outOfFocusEntry.getType(), newEntry.getType()));
+            outOfFocusEntry.setType(newEntry.getType());
+        }
+        compound.end();
+        undoManager.addEdit(compound);
+
+        ObservableList<BibEntry> selectedEntries = stateManager.getSelectedEntries();
+        if (selectedEntries == null || selectedEntries.isEmpty()) {
+            stateManager.activeTabProperty().get().ifPresent(libraryTab ->
+                    libraryTab.getMainTable().clearAndSelect(outOfFocusEntry)
+            );
         }
+
+        validationMessage.setValue(null);
     }
 
     private void listenForSaveKeybinding(KeyEvent event) {

jabgui/src/main/java/org/jabref/gui/entryeditor/citationrelationtab/CitationRelationsTab.java

@@ -630,7 +630,7 @@ private void jumpToEntry(CitationRelationItem entry) {
     private String getSourceString(BibEntry entry, BibDatabaseMode type, FieldPreferences fieldPreferences, BibEntryTypesManager entryTypesManager) throws IOException {
         StringWriter writer = new StringWriter();
         BibWriter bibWriter = new BibWriter(writer, OS.NEWLINE);
-        FieldWriter fieldWriter = FieldWriter.buildIgnoreHashes(fieldPreferences);
+        FieldWriter fieldWriter = new FieldWriter(fieldPreferences);
         new BibEntryWriter(fieldWriter, entryTypesManager).write(entry, bibWriter, type);
         return writer.toString();
     }

jabgui/src/main/java/org/jabref/gui/importer/ImportEntriesViewModel.java

@@ -169,7 +169,7 @@ public boolean hasDuplicate(BibEntry entry) {
     public String getSourceString(BibEntry entry) {
         StringWriter writer = new StringWriter();
         BibWriter bibWriter = new BibWriter(writer, OS.NEWLINE);
-        FieldWriter fieldWriter = FieldWriter.buildIgnoreHashes(preferences.getFieldPreferences());
+        FieldWriter fieldWriter = new FieldWriter(preferences.getFieldPreferences());
         try {
             // Force reformatting so the displayed BibTeX is consistently formatted
             new BibEntryWriter(fieldWriter, entryTypesManager).write(entry, bibWriter, selectedDb.getValue().getMode(), true);

jabgui/src/main/java/org/jabref/gui/undo/UndoableFieldChange.java

@@ -7,21 +7,24 @@
 import org.jabref.model.entry.field.Field;
 import org.jabref.model.entry.field.FieldTextMapper;
 
+import org.jspecify.annotations.NullMarked;
+import org.jspecify.annotations.Nullable;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /// This class represents a change in any field value. The relevant
 /// information is the BibEntry, the field name, the old and the
 /// new value. Old/new values can be null.
+@NullMarked
 public class UndoableFieldChange extends AbstractUndoableJabRefEdit {
     private static final Logger LOGGER = LoggerFactory.getLogger(UndoableFieldChange.class);
 
     private final BibEntry entry;
     private final Field field;
-    private final String oldValue;
-    private final String newValue;
+    @Nullable private final String oldValue;
+    @Nullable private final String newValue;
 
-    public UndoableFieldChange(BibEntry entry, Field field, String oldValue, String newValue) {
+    public UndoableFieldChange(BibEntry entry, Field field, @Nullable String oldValue, @Nullable String newValue) {
         this.entry = entry;
         this.field = field;
         this.oldValue = oldValue;

jablib-examples/jbang/doi_to_bibtex.java

@@ -1,4 +1,4 @@
-///usr/bin/env jbang "$0" "$@" ; exit $?
+/// usr/bin/env jbang "$0" "$@" ; exit $?
 
 import org.jabref.logic.exporter.BibWriter;
 import org.jabref.logic.exporter.BibDatabaseWriter;
@@ -14,6 +14,8 @@
 //JAVA 25+
 //RUNTIME_OPTIONS --enable-native-access=ALL-UNNAMED
 //FILES tinylog.properties=tinylog.properties
+// see  https://github.com/gradlex-org/extra-java-module-info/issues/237 why we include e-adr here
+//DEPS io.github.adr:e-adr:2.0.0
 
 //REPOS mavencentral,mavencentralsnapshots=https://central.sonatype.com/repository/maven-snapshots/
 //DEPS org.jabref:jablib:6.0-SNAPSHOT

jablib-examples/jbang/ieee_pdf_references_to_bibtex.java

@@ -1,4 +1,4 @@
-///usr/bin/env jbang "$0" "$@" ; exit $?
+/// usr/bin/env jbang "$0" "$@" ; exit $?
 
 import org.jabref.logic.exporter.BibWriter;
 import org.jabref.logic.exporter.BibDatabaseWriter;
@@ -16,6 +16,8 @@
 
 //REPOS mavencentral,mavencentralsnapshots=https://central.sonatype.com/repository/maven-snapshots/
 //DEPS org.jabref:jablib:6.0-SNAPSHOT
+// see  https://github.com/gradlex-org/extra-java-module-info/issues/237 why we include e-adr here
+//DEPS io.github.adr:e-adr:2.0.0
 // JabRef relies on PR https://github.com/unicode-org/icu/pull/2127; for experiments the release version is OK.
 //DEPS com.ibm.icu:icu4j:78.1
 //DEPS com.fasterxml.jackson.core:jackson-annotations:2.20

jablib/src/main/java/org/jabref/logic/bibtex/BibEntryWriter.java

@@ -170,15 +170,10 @@ private void writeField(BibEntry entry, BibWriter out, Field field, int indent)
         if (value.isPresent() && !value.get().trim().isEmpty()) {
             out.write("  ");
             out.write(getFormattedFieldName(field, indent));
-            try {
-                int start = out.getCurrentPosition();
-                out.write(fieldWriter.write(field, value.get()));
-                int end = out.getCurrentPosition();
-                fieldPositions.put(field, new Range(start, end));
-            } catch (InvalidFieldValueException ex) {
-                LOGGER.warn("Invalid field value {} of field {} of entry {}", value.get(), field, entry.getCitationKey().orElse(""), ex);
-                throw new IOException("Error in field '" + field + " of entry " + entry.getCitationKey().orElse("") + "': " + ex.getMessage(), ex);
-            }
+            int start = out.getCurrentPosition();
+            out.write(fieldWriter.write(field, value.get()));
+            int end = out.getCurrentPosition();
+            fieldPositions.put(field, new Range(start, end));
             out.writeLine(",");
         }
     }
@@ -200,7 +195,7 @@ static int getLengthOfLongestFieldName(BibEntry entry) {
     @ADR(49)
     static String getFormattedFieldName(Field field, int indent) {
         String fieldName = field.getName();
-        return fieldName + StringUtil.repeatSpaces(indent - fieldName.length()) + " = ";
+        return fieldName + " ".repeat(Math.max(0, indent - fieldName.length())) + " = ";
     }
 
     public Map<Field, Range> getFieldPositions() {