fix for #729, added override of params with same name

modules/swagger-jaxrs/src/test/scala/DuplicateHeadersResourceTest.scala

@@ -0,0 +1,32 @@
+import testresources._
+
+import com.wordnik.swagger.jaxrs.reader._
+import com.wordnik.swagger.core.util._
+import com.wordnik.swagger.model._
+import com.wordnik.swagger.config._
+import com.wordnik.swagger.core.filter._
+
+import java.lang.reflect.Method
+
+import java.util.Date
+
+import org.junit.runner.RunWith
+import org.scalatest.junit.JUnitRunner
+import org.scalatest.FlatSpec
+import org.scalatest.Matchers
+
+import scala.collection.mutable.ListBuffer
+
+@RunWith(classOf[JUnitRunner])
+class DuplicateHeadersResourceTest extends FlatSpec with Matchers {
+  it should "read an api and extract an error model" in {
+    val reader = new DefaultJaxrsApiReader
+    val config = new SwaggerConfig()
+    val apiResource = reader.read("/api-docs", classOf[DuplicateHeadersResource], config).getOrElse(fail("should not be None"))
+    val api = apiResource.apis.head
+    val op = api.operations.head
+    op.parameters.size should be (1)
+    val param = op.parameters.head
+    param.description.get should be ("This one!")
+  }
+}

modules/swagger-jaxrs/src/test/scala/testresources/DuplicateHeadersResource.java

@@ -0,0 +1,29 @@
+package testresources;
+
+import testmodels.*;
+import com.wordnik.swagger.core.*;
+import com.wordnik.swagger.annotations.*;
+
+import javax.ws.rs.*;
+import javax.ws.rs.core.Response;
+
+import javax.xml.bind.annotation.*;
+
+@Path("/basic")
+@Api(value = "/basic", description = "Basic resource")
+public class DuplicateHeadersResource {
+  @ApiParam(value = "NOT this one!")
+  @HeaderParam("auth_token")
+  String header;
+
+  @GET
+  @Path("/{id}")
+  @ApiOperation(value = "Find by ID")
+  public JavaSample getTest(
+    @ApiParam(value = "This one!")@HeaderParam("auth_token") String duplicate) {
+    JavaSample out = new JavaSample();
+    out.setName("foo");
+    out.setValue("bar");
+    return out;
+  }
+}