example.java

/**
   * Save or update a User in the system.
   * 
   * Create or update a system user with the values from the supplied XML document. Existing user 
   * records will be overwritten if the overwrite flag is true. If a user was overwritten, 
   * <code>true</code> will be returned in the Response object.
   * 
   * @param userDoc     list of files to be restored
   *                    <pre>
   * {@code
   *  <something>
   *    <another>Thing</another>
   *  </something>
   * }
   *                    </pre>
   * @param overwrite   boolean flag indicating whether and existing user record should be overwritten
   * 
   * @return Response   Response wraps a boolean with true indicating that the save overwrote a 
   *                    previous record
   * 
   * @throws IllegalStateException
   */
  @PUT
  @Path( "/save" )
  @Consumes( { WILDCARD } )
  public Response saveUser( String  userDoc,  boolean overwrite ){