fix for #475, allows fields to be hidden with a single annotation

Author: fehguy

modules/swagger-annotations/src/main/java/com/wordnik/swagger/annotations/ApiModelProperty.java

@@ -68,4 +68,9 @@
    * ordering, you should specify property order to keep models consistent across different VM implementations and versions.
    */
   int position() default 0;
+  
+  /**
+   * Allows a model property to be marked as hidden in the swagger model definition
+   */
+  boolean hidden() default false;
 }

modules/swagger-core/src/main/scala/com/wordnik/swagger/converter/ModelPropertyParser.scala

@@ -226,6 +226,7 @@ class ModelPropertyParser(cls: Class[_], t: Map[String, String] = Map.empty) (im
           isDocumented = true
           allowableValues = Some(toAllowableValues(e.allowableValues))
           paramAccess = readString(e.access)
+          isTransient = e.hidden
         }
         case e: XmlAttribute => {
           updatedName = readString(e.name, name, "##default")

modules/swagger-core/src/test/scala/converter/HiddenFieldTest.scala

@@ -0,0 +1,48 @@
+package converter
+
+import converter.models._
+
+import com.wordnik.swagger.converter._
+import com.wordnik.swagger.core.util._
+import com.wordnik.swagger.model._
+import com.wordnik.swagger.annotations._
+
+import java.util.Date
+
+import scala.reflect.BeanProperty
+
+import org.junit.runner.RunWith
+import org.scalatest.junit.JUnitRunner
+import org.scalatest.FlatSpec
+import org.scalatest.matchers.ShouldMatchers
+
+@RunWith(classOf[JUnitRunner])
+class HiddenFieldTest extends FlatSpec with ShouldMatchers {
+  it should "ignore a hidden field" in {
+    val model = ModelConverters.read(classOf[ModelWithHiddenFields]).getOrElse(fail("no model found"))
+    model.id should be ("ModelWithHiddenFields")
+    model.properties.size should be (2)
+
+    val idValue = model.properties("id")
+    idValue.`type` should be ("long")
+    idValue.required should be (true)
+
+    val nameValue = model.properties("name")
+    nameValue.`type` should be ("string")
+    nameValue.required should be (true)
+  }
+}
+
+class ModelWithHiddenFields {
+  @BeanProperty
+  @ApiModelProperty(required=true)
+  var id: Long = _
+
+  @BeanProperty
+  @ApiModelProperty(required=true, hidden=false)
+  var name: String = _
+
+  @BeanProperty
+  @ApiModelProperty(hidden=true)
+  var password: String = _
+}