For Portlet 3.0, BaseURL.getParameterMap() 's JavaDoc was changed to clarify that the returned map is mutable. However, changing the state of the map does not change the state of the BaseURL 's parameters. Instead, the developer must pass the parameter map to BaseURL.setParameters() to change the state of BaseURL.
BridgeURL should follow this pattern.
To that end, setParameters(Map<String, String>) (or setParameterMap() ) should be added to the BridgeURL API and the JavaDoc for getParameterMap() should be modified to indicate that mutating the returned map does not change BridgeURL 's state (and the developer should pass the map of parameters to setParameters() in order to change the state of BridgeURL ).