feat: proxy URL

Author: Abhi591

CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.16.0] - 2026-01-15
+
+- Added support for redirecting all network calls through a custom proxy URL. This feature allows users to route all SDK network requests (settings, tracking, etc.) through their own proxy server.
+
+```java
+VWOInitOptions vwoInitOptions = new VWOInitOptions();
+
+vwoInitOptions.setSdkKey("32-alpha-numeric-sdk-key");
+vwoInitOptions.setAccountId(123456);
+vwoInitOptions.setProxyUrl("http://custom.proxy.com");
+
+// set aliasing flag in vwoInitOptions
+vwoInitOptions.setIsAliasingEnabled(true);
+VWO instance = VWO.init(vwoInitOptions);
+```
+
 ## [1.15.0] - 2025-12-08
 ### Added
 

README.md

@@ -91,6 +91,7 @@ To customize the SDK further, additional parameters can be passed to the `init()
 | `setLogger`                     | Toggle log levels for more insights or for debugging purposes. You can also customize your own transport in order to have better control over log messages. | No           | Object   | See [Logger](#logger) section   |
 | `setIntegrations`               | Callback function for integrating with third-party analytics services.                                                                                      | No           | Function | See [Integrations](#integrations) section |
 | `setIsAliasingEnabled`         | Enable user aliasing functionality. Requires gateway service to be configured.                                                                              | No           | Boolean  | see [UserAliasing](#UserAliasing) section                        |
+| `setProxyUrl`                  | Custom proxy URL for redirecting all SDK network requests (settings, tracking, etc.) through your own proxy server.                                        | No           | String   | see [Proxy](#proxy) section                        |
 
 Refer to the [official VWO documentation](https://developers.vwo.com/v2/docs/fme-java-install) for additional parameter details.
 
@@ -206,6 +207,20 @@ vwoInitOptions.setPollInterval(60000); // Set the poll interval to 60 seconds
 VWO vwoInstance = VWO.init(vwoInitOptions);
 ```
 
+### Proxy
+
+The `setProxyUrl` parameter allows you to redirect all SDK network calls through a custom proxy URL. This feature enables you to route all SDK network requests (settings, tracking, etc.) through your own proxy server, providing better control over network traffic and security.
+
+```java
+VWOInitOptions vwoInitOptions = new VWOInitOptions();
+
+vwoInitOptions.setSdkKey("32-alpha-numeric-sdk-key");
+vwoInitOptions.setAccountId(123456);
+vwoInitOptions.setProxyUrl("http://custom.proxy.com");
+
+VWO instance = VWO.init(vwoInitOptions);
+```
+
 ### Gateway
 
 The VWO FME Gateway Service is an optional but powerful component that enhances VWO's Feature Management and Experimentation (FME) SDKs. It acts as a critical intermediary for pre-segmentation capabilities based on user location and user agent (UA). By deploying this service within your infrastructure, you benefit from minimal latency and strengthened security for all FME operations.

pom.xml

@@ -19,7 +19,7 @@ limitations under the License. -->
 
     <groupId>com.vwo.sdk</groupId>
     <artifactId>vwo-fme-java-sdk</artifactId>
-    <version>1.15.0</version>
+    <version>1.16.0</version>
     <packaging>jar</packaging>
 
     <name>VWO FME Java SDK</name>

src/main/java/com/vwo/ServiceContainer.java

@@ -117,20 +117,16 @@ public Settings getSettings() {
     }
 
     /**
-     * Returns the base URL for the API requests
+     * Returns the endpoint with the collection prefix
+     * @param endpoint The endpoint to return
+     * @return The endpoint with the collection prefix
      */
-    public String getBaseUrl() {
-        String baseUrl = this.settingsManager.hostname;
-
-        if (this.settingsManager.isGatewayServiceProvided) {
-            return baseUrl;
-        }
-
-        if (this.settings.getCollectionPrefix() != null && !this.settings.getCollectionPrefix().isEmpty()) {
-            return baseUrl + "/" + this.settings.getCollectionPrefix();
+    public String getEndpointWithCollectionPrefix(String endpoint) {
+        if (this.settingsManager.collectionPrefix != null && !this.settingsManager.collectionPrefix.isEmpty()) {
+            return "/" + this.settingsManager.collectionPrefix + "/" + endpoint;
         }
 
-        return baseUrl;
+        return endpoint;
     }
 
     /**

src/main/java/com/vwo/VWO.java

@@ -66,17 +66,17 @@ private static VWO setInstance(VWOInitOptions options) {
 
     public static VWO init(VWOInitOptions options) {
         if (options == null || options.getSdkKey() == null || options.getSdkKey().isEmpty()) {
-            String message = LogMessageUtil.buildMessage(LoggerService.errorMessages.get("INVALID_SDK_KEY_IN_OPTIONS"), null);
+            String message = "[ERROR]: VWO-SDK Please provide the sdkKey in the options and should be a of type string";
             System.err.println(message);
         }
 
         if (options == null || options.getAccountId() == null || options.getAccountId().toString().isEmpty()) {
-            String message = LogMessageUtil.buildMessage(LoggerService.errorMessages.get("INVALID_ACCOUNT_ID_IN_OPTIONS"), null);
+            String message = "[ERROR]: VWO-SDK Please provide VWO account ID in the options and should be a of type string|number";
             System.err.println(message);
         }
 
-        if (options.getIsAliasingEnabled() && (options.getGatewayService() == null || options.getGatewayService().isEmpty())) {
-            String message = LogMessageUtil.buildMessage(LoggerService.errorMessages.get("INVALID_GATEWAY_SERVICE_WHEN_ALIASING_ENABLED"), null);
+        if (options == null ||options.getIsAliasingEnabled() && (options.getGatewayService() == null || options.getGatewayService().isEmpty())) {
+            String message = "[ERROR]: VWO-SDK Please provide a valid gateway service url in the options when aliasing is enabled";
             System.err.println(message);
         }
         //start timer

src/main/java/com/vwo/VWOBuilder.java

@@ -426,7 +426,8 @@ public VWOBuilder initBatching() {
                     this.options.getBatchEventData().getFlushCallback(),
                     this.options.getAccountId(),
                     this.options.getSdkKey(),
-                    loggerService
+                    loggerService,
+                    settingFileManager
             );
 
             this.batchEventQueue = batchEventQueue; // Link to the vwoClient

src/main/java/com/vwo/VWOClient.java

@@ -60,9 +60,6 @@ public VWOClient(String settings, VWOBuilder vwoBuilder) {
             }
             this.settings = settings;
             this.processedSettings = objectMapper.readValue(settings, Settings.class);
-            if (vwoBuilder.getBatchEventQueue() != null) {
-                vwoBuilder.getBatchEventQueue().setSettings(this.processedSettings);
-            }
             if (!DataTypeUtil.isNull(this.processedSettings.getCollectionPrefix()) && !this.processedSettings.getCollectionPrefix().isEmpty()) {
                 this.vwoBuilder.getSettingsManager().collectionPrefix = this.processedSettings.getCollectionPrefix();
             }
@@ -365,8 +362,19 @@ public String updateSettings() {
     /**
      * This method is used to update the settings with provided settings string
      * @param settings New settings to be updated
+     * @return String value containing the updated settings
      */
     public String updateSettings(String settings) {
+        return this.updateSettings(settings, false);
+    }
+
+    /**
+     * This method is used to update the settings with provided settings string and isViaWebhook flag
+     * @param settings New settings to be updated
+     * @param isViaWebhook Boolean value to indicate if the settings are being fetched via webhook
+     * @return String value containing the updated settings
+     */
+    private String updateSettings(String settings, Boolean isViaWebhook) {
         String apiName = "updateSettings";
         try {
             vwoBuilder.getLoggerService().log(LogLevelEnum.DEBUG, "API_CALLED", new HashMap<String, Object>() {{
@@ -388,14 +396,14 @@ public String updateSettings(String settings) {
             this.updateSettingsOnVWOClient(settings);
             vwoBuilder.getLoggerService().log(LogLevelEnum.INFO, "SETTINGS_UPDATED", new HashMap<String, Object>() {{
                 put("apiName", apiName);
-                put("isViaWebhook", "false");
+                put("isViaWebhook", isViaWebhook.toString());
             }});
             return settings;
         } catch (Exception exception) {
             vwoBuilder.getLoggerService().log(LogLevelEnum.ERROR, "UPDATING_CLIENT_INSTANCE_FAILED_WHEN_WEBHOOK_TRIGGERED", new HashMap<String, Object>() {{
                 put("apiName", apiName);
                 put("err", exception.getMessage());
-                put("isViaWebhook", "false");
+                put("isViaWebhook", isViaWebhook.toString());
                 put("an", ApiEnum.UPDATE_SETTINGS.getValue());
             }});
             return null;
@@ -411,7 +419,7 @@ public String updateSettings(Boolean isViaWebhook) {
         try {
             // Fetch the new settings from the server
             this.settings = this.vwoBuilder.getSettingsManager().fetchSettings(isViaWebhook);
-            return this.updateSettings(this.settings);
+            return this.updateSettings(this.settings, isViaWebhook);
         } catch (Exception exception) {
             vwoBuilder.getLoggerService().log(LogLevelEnum.ERROR, "UPDATING_CLIENT_INSTANCE_FAILED_WHEN_WEBHOOK_TRIGGERED", new HashMap<String, Object>() {{
                 put("apiName", apiName);

src/main/java/com/vwo/constants/Constants.java

@@ -28,7 +28,7 @@ public class Constants {
   public static final int DEFAULT_REQUEST_TIME_INTERVAL = 600; // 10 * 60(secs) = 600 secs i.e. 10 minutes
   public static final int DEFAULT_EVENTS_PER_REQUEST = 100;
   public static final String SDK_NAME = "vwo-fme-java-sdk";
-  public static final String SDK_VERSION = "1.15.0";
+  public static final String SDK_VERSION = "1.16.0";
   public static final long SETTINGS_EXPIRY = 10000000;
   public static final long SETTINGS_TIMEOUT = 50000;
 

src/main/java/com/vwo/models/user/VWOInitOptions.java

@@ -43,6 +43,7 @@ public class VWOInitOptions {
     private Boolean isUsageStatsDisabled = false;
     private Map<String, Object> _vwo_meta = new HashMap<>();
     private Boolean isAliasingEnabled = false;
+    private String proxyUrl = "";
 
     public Map<String, Object> getVwoMetaData() {
         return _vwo_meta;
@@ -155,4 +156,12 @@ public Boolean getIsAliasingEnabled() {
     public void setIsAliasingEnabled(Boolean isAliasingEnabled) {
         this.isAliasingEnabled = isAliasingEnabled;
     }
+
+    public String getProxyUrl() {
+        return proxyUrl;
+    }
+
+    public void setProxyUrl(String proxyUrl) {
+        this.proxyUrl = proxyUrl;
+    }
 }

src/main/java/com/vwo/packages/segmentation_evaluator/core/SegmentationManager.java

@@ -68,7 +68,7 @@ public void setContextualData(ServiceContainer serviceContainer, Feature feature
     }
 
     // If gateway service is required and the base URL is not the default one, fetch the data from the gateway service
-    if (feature.getIsGatewayServiceRequired() && !serviceContainer.getBaseUrl().contains(Constants.HOST_NAME) && (context.getVwo() == null)) {
+    if (feature.getIsGatewayServiceRequired() && serviceContainer.getSettingsManager().isGatewayServiceProvided && (context.getVwo() == null)) {
       Map<String, String> queryParams = new HashMap<>();
       if ( (context.getUserAgent() == null || context.getUserAgent().isEmpty() ) && (context.getIpAddress() == null || context.getIpAddress().isEmpty())) {
         return;