Problem with relative path in swagger.api.basepath

[vbauer]

In old version of swagger-ui (maybe 1.0, 1.1) I can configure my "swagger.api.basepath" parameter like "/rest" but in last version it works only with "http://localhost:8080/rest".

To prevent this behaviour I use some hack in swagger.js (in function SwaggerApi.prototype.build):

          if (_this.basePath.indexOf('/') == 0) {
              var bp = $('#input_baseUrl').val();
              var suffix = '/resources.json';

              if (bp.indexOf(suffix, bp.length - suffix.length) !== -1) {
                  bp = bp.substring(0, bp.length - suffix.length);
              }
              _this.basePath = bp;
          }

So I can use one build of application (war file) on different servers with different ports.

It's very uncomfortable to migrate this dirty hack from one version to another... Can you please add possibility to use relative path in "swagger.api.basepath" (like "/rest") instead of absolute path (like "http://localhost:8080/rest")?

[fehguy]

howdy, the right solution is to write a filter in your server which configures the base path. See here:

http://fehguy.tumblr.com/post/16373022457/overriding-swaggers-base-path

The spec says base path needs to be absolute. I would recommend trying to follow that, can you post back if that solution doesn't work for you?

[vbauer]

Thank you very much, I was thinking to make something like this, but wasn't sure in.
Now, I've implemented the following code and it works fine:

@ThreadSafe
public class SwaggerConfigurationReader extends ConfigReader {

    private static final String PARAM_API_BASEPATH = "swagger.api.basepath";
    private static final String PARAM_VERSION = "swagger.version";
    private static final String PARAM_SECURITY_FILTER = "swagger.security.filter";


    @Nonnull
    private final PropertyService propertyService;


    public SwaggerConfigurationReader(@Nonnull final ServletConfig servletConfig) {
        super(servletConfig);

        propertyService = ApplicationContextUtils.getBean(servletConfig, PropertyService.class);
    }


    @Override
    public String getApiFilterClassName() {
        return propertyService.getProperty(PARAM_SECURITY_FILTER);
    }

    @Override
    public String getSwaggerVersion() {
        return propertyService.getProperty(PARAM_VERSION);
    }

    @Override
    public String getBasePath() {
        return propertyService.getProperty(PARAM_API_BASEPATH);
    }

}

I can configure this parameters for different servers without web.xml :)