wordnik/swagger-core — pull request #66 by pilhuhn (2012-10-21 08:49:31+00:00)
Title: Add ApiClass annotation  (GH-61)

Add ApiClass annotation to give a description to bean classes used as parameters.

Usage on a Bean class is e.g.

@ApiClass("This class represents one event.")
@XmlRootElement(name = "event")
public class EventRest {

int id;

public EventRest() {}

@ApiProperty("RHQ-Internal Id of the event")
public int getId() {
return id;
}

And then

@PUT @ApiOperation("Add a new event to the system")
void putEvent(EventRest eventRest)