title: Java REST service PUT parameters
body: <p>This is how my Jersey Rest web service's a few methods looks likes, I have some methods to update the user settings like:</p>
  
  <pre><code>@PUT
  @Path("/langauge")
  @Consumes("text/plain")
  public void updateLanguage(String lang) {
  
      ***check validity of the lang by string comparisons**
       and update database with the new language*
  }
  
  @PUT
  @Path("/threshold")
  @Consumes("text/plain")
  public void updateThreshold(Long threshold) {
  
     *//check value and update in server*
  }
  </code></pre>
  
  <p>Now I have a few questions here;</p>
  
  <p>1- Instead of different resource paths for different update options, is it better to create one resource and update with query parameters? This looks more Restish but I'm not sure I really should change it to something like, because in future if there are more parameters to be updated than it will be very cluttered, while having independent paths looks more clear?</p>
  
  <pre><code>@PUT
  @Path("/settings/{lang}/{threshold}")
  @Consumes("text/plain")
  public void updateSettings(@PathParam("threshold") String thre,
          @PathParam("lang") String lang,
          @DefaultValue("") @QueryParam) {
  
  
  }
  </code></pre>
  
  <p>2- Another question is while updating the language now I accept a language as a string then check if thats valid or not in server, So when client uses this method they don't know what exactly should they send as valid parameters. Is there a way to make this more user friendly, putting some comments on WADL file is an option, but is there another more REST way of doing this?</p>