feat: add putAllSettings endpoint to Admin API for bulk settings update #11639

Introduced a new `PUT /api/admin/settings` endpoint to update all settings in bulk with JSON input. Added `setAllFromJson` method and placeholder implementation for `replaceAllSettings` in `SettingsServiceBean`. Validates input structure and ensures atomic updates.

Author: poikilotherm

src/main/java/edu/harvard/iq/dataverse/api/Admin.java

@@ -63,6 +63,7 @@
 import jakarta.ws.rs.PathParam;
 import jakarta.ws.rs.container.ContainerRequestContext;
 import jakarta.ws.rs.core.Context;
+import jakarta.ws.rs.core.MediaType;
 import jakarta.ws.rs.core.Response;
 import static edu.harvard.iq.dataverse.util.json.NullSafeJsonBuilder.jsonObjectBuilder;
 
@@ -211,6 +212,28 @@ public Response listAllSettings() {
         return ok(settingsSvc.listAllAsJson());
     }
 
+    @Path("settings")
+    @PUT
+    @Consumes(MediaType.APPLICATION_JSON)
+    @APIResponses({
+        @APIResponse(responseCode = "200", description = "All database options successfully updated")
+    })
+    public Response putAllSettings(JsonObject settings) {
+        try {
+            // Basic JSON structure validation only
+            if (settings == null || settings.isEmpty()) {
+                return error(Response.Status.BAD_REQUEST, "Empty or invalid JSON object");
+            }
+            
+            // Transfer to domain objects and deeper validation to be handled by the service layer.
+            settingsSvc.setAllFromJson(settings);
+            return ok("All database options successfully updated.");
+            
+        } catch (IllegalArgumentException iae) {
+            return error(Response.Status.BAD_REQUEST, iae.getMessage());
+        }
+    }
+    
     @Path("settings/{name}")
     @PUT
     public Response putSetting(@PathParam("name") String name, String content) {

src/main/java/edu/harvard/iq/dataverse/settings/SettingsServiceBean.java

@@ -16,10 +16,12 @@
 import jakarta.persistence.EntityManager;
 import jakarta.persistence.PersistenceContext;
 
+import jakarta.transaction.Transactional;
 import org.json.JSONArray;
 import org.json.JSONException;
 import org.json.JSONObject;
 
+import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.HashMap;
@@ -1077,6 +1079,31 @@ public JsonObject listAllAsJson() {
         return response.build();
     }
 
+    /**
+     * Updates all settings by replacing them with the settings provided in the given JSON object.
+     * This method validates the keys and values from the JSON object, converts them into
+     * a list of Setting objects, and performs an atomic update of the internal settings.
+     *
+     * @param settings a JsonObject containing the new settings to apply.
+     *                 Each key corresponds to a setting name, and each value corresponds
+     *                 to its respective value. The keys and values will be validated before
+     *                 applying the updates.
+     * @throws IllegalArgumentException if the JSON object contains invalid keys or invalid settings.
+     */
+    public void setAllFromJson(JsonObject settings) {
+        // Validate the input
+        List<String> invalidKeys = validateKeys(settings);
+        if (!invalidKeys.isEmpty()) {
+            throw new IllegalArgumentException("Invalid key(s): " + String.join(", ", invalidKeys));
+        }
+        
+        // Convert JSON to Setting objects
+        List<Setting> newSettings = convertJsonToSettings(settings);
+        
+        // Perform atomic update (replace all settings)
+        replaceAllSettings(newSettings);
+    }
+    
     /**
      * Converts a JSON object representing settings into a list of Setting objects.
      * Each entry in the JSON object is processed to create a Setting instance.
@@ -1112,6 +1139,21 @@ static List<Setting> convertJsonToSettings(JsonObject settings) {
             .collect(Collectors.toList());
     }
 
+    /**
+     * Replaces all existing settings with a new list of settings within a single transaction.
+     * The operation is atomic, ensuring that either all changes are applied or none in case of a failure.
+     *
+     * @param newSettings the list of new {@link Setting} objects to replace the existing settings.
+     *                     Must not be null; an empty list clears all settings.
+     */
+    @Transactional
+    public void replaceAllSettings(List<Setting> newSettings) {
+        // Implementation for atomic replacement
+        // This would involve clearing existing settings and inserting new ones
+        // within the same transaction
+        throw new IllegalStateException("Not yet implemented");
+    }
+    
     public Map<String, String> getBaseMetadataLanguageMap(Map<String,String> languageMap, boolean refresh) {
         if (languageMap == null || refresh) {
             languageMap = new HashMap<String, String>();