title: Swagger API Annotation for Java using Enum as options which break request
body: <p>I have a class defined called <strong>Website Locale</strong> which lits all supported locales for my site</p>
  
  <pre><code>public enum WebsiteLocale {
  
      AU      ("au",      5, "en", "AUD"),    // Australia
      CA      ("ca",      6, "en", "CAD"),    // Canada
      DE      ("de",      1, "de", "EUR"),    // Germany
      ES      ("es",      1, "es", "EUR"),    // Spain
      ES_US   ("es-us",   2, "es", "USD"),    // USA, Spanish language
      EU      ("eu",      4, "en", "EUR"),    // Europe: English and Euros
      FR      ("fr",      1, "fr", "EUR"),    // France
      FR_US   ("fr-us",   2, "fr", "USD"),    // USA, French language
      IT      ("it",      1, "it", "EUR"),    // Italy
      NL      ("nl",      3, "en", "EUR"),    // Netherlands
      UK      ("uk",      1, "en", "GBP"),    // UK
      US      ("us",      2, "en", "USD");    // USA
  ... getters / setters... }
  </code></pre>
  
  <p>In my API resource I have the following annotation</p>
  
  <pre><code>@GET
      @Path("/countries")
      @ApiOperation("Get countries")
      @CacheControl(maxAge = 1, maxAgeUnit = TimeUnit.HOURS)
      @Override
      public List&lt;CountryDto&gt; getCountries(
              @QueryParam("websiteLocale") @ApiParam(required = true, defaultValue = "uk") final WebsiteLocale websiteLocale) {
          return delegate.getCountries(websiteLocale);
  </code></pre>
  
  <p>In the Swagger API test page for that endpoint it gives the accepted values as the Enum literals themselves</p>
  
  <p>e.g. AU, CA, DE, ES, ES_US, EU, FR, FR_US</p>
  
  <p>This breaks the controller (404 not found response) because it is looking for the associated string key for that enum</p>
  
  <p>i.e. au, ca, de, es, es-us, eu, fr, fr-us</p>
  
  <p>I had a look through swagger but could not see any specific annotation to look for a part of the enum properties.</p>
  
  <p>Any ideas?
  Thanks</p>