Move filters to sub packages, add comment for CorsFilter class

Author: qqmyers

…/iq/dataverse/api/ApiBlockingFilter.java …averse/api/filter/ApiBlockingFilter.javasrc/main/java/edu/harvard/iq/dataverse/api/ApiBlockingFilter.java renamed to src/main/java/edu/harvard/iq/dataverse/api/filter/ApiBlockingFilter.java src/main/java/edu/harvard/iq/dataverse/api/ApiBlockingFilter.java renamed to src/main/java/edu/harvard/iq/dataverse/api/filter/ApiBlockingFilter.java

@@ -1,4 +1,4 @@
-package edu.harvard.iq.dataverse.api;
+package edu.harvard.iq.dataverse.api.filter;
 
 import edu.harvard.iq.dataverse.authorization.groups.impl.ipaddress.ip.IpAddress;
 import edu.harvard.iq.dataverse.engine.command.DataverseRequest;

src/main/java/edu/harvard/iq/dataverse/api/util/JsonResponseBuilder.java

@@ -1,7 +1,5 @@
 package edu.harvard.iq.dataverse.api.util;
 
-import edu.harvard.iq.dataverse.api.ApiBlockingFilter;
-
 import jakarta.json.Json;
 import jakarta.json.JsonValue;
 import jakarta.json.JsonObjectBuilder;
@@ -13,6 +11,8 @@
 
 import org.apache.commons.lang3.exception.ExceptionUtils;
 
+import edu.harvard.iq.dataverse.api.filter.ApiBlockingFilter;
+
 import java.io.IOException;
 import java.util.Optional;
 import java.util.UUID;

…edu/harvard/iq/dataverse/CorsFilter.java …vard/iq/dataverse/filter/CorsFilter.javasrc/main/java/edu/harvard/iq/dataverse/CorsFilter.java renamed to src/main/java/edu/harvard/iq/dataverse/filter/CorsFilter.java src/main/java/edu/harvard/iq/dataverse/CorsFilter.java renamed to src/main/java/edu/harvard/iq/dataverse/filter/CorsFilter.java

@@ -1,4 +1,4 @@
-package edu.harvard.iq.dataverse;
+package edu.harvard.iq.dataverse.filter;
 
 import jakarta.inject.Inject;
 import jakarta.servlet.*;
@@ -9,6 +9,18 @@
 import edu.harvard.iq.dataverse.settings.JvmSettings;
 import edu.harvard.iq.dataverse.settings.SettingsServiceBean;
 
+/**
+ * CorsFilter is a servlet filter that handles Cross-Origin Resource Sharing (CORS) for the Dataverse application.
+ * It configures and applies CORS headers to HTTP responses based on application settings.
+ * 
+ * This filter:
+ * 1. Reads CORS configuration from JVM settings or (deprecated) the SettingsServiceBean. See the Dataverse Configuration Guide for more details.
+ * 2. Determines whether CORS should be allowed based on these settings.
+ * 3. If CORS is allowed, it adds the appropriate CORS headers to all HTTP responses. The JVMSettings allow customization of the header contents if desired.
+ * 
+ * The filter is applied to all paths ("/*") in the application.
+ */
+
 @WebFilter("/*")
 public class CorsFilter implements Filter {
 

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

@@ -2,7 +2,7 @@
 
 import edu.harvard.iq.dataverse.actionlogging.ActionLogRecord;
 import edu.harvard.iq.dataverse.actionlogging.ActionLogServiceBean;
-import edu.harvard.iq.dataverse.api.ApiBlockingFilter;
+import edu.harvard.iq.dataverse.api.filter.ApiBlockingFilter;
 import edu.harvard.iq.dataverse.util.StringUtil;
 import edu.harvard.iq.dataverse.util.json.JsonUtil;
 import jakarta.ejb.EJB;

src/test/java/edu/harvard/iq/dataverse/api/util/JsonResponseBuilderTest.java

@@ -1,12 +1,12 @@
 package edu.harvard.iq.dataverse.api.util;
 
-import edu.harvard.iq.dataverse.api.ApiBlockingFilter;
 import org.junit.jupiter.params.ParameterizedTest;
 import org.junit.jupiter.params.provider.EmptySource;
 import org.junit.jupiter.params.provider.NullSource;
 import org.junit.jupiter.params.provider.ValueSource;
 import org.mockito.Mockito;
 
+import edu.harvard.iq.dataverse.api.filter.ApiBlockingFilter;
 import jakarta.servlet.http.HttpServletRequest;
 
 import static org.junit.jupiter.api.Assertions.*;