Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Creates a tag for the class so that all API's underneath a class are grouped together 
  • Searches through each method looking for API methods and documenting
    • Method type (Get, Post, Put, Delete), summary, description, tags (which class it belongs to) 
    • Parameters: in (Path, Query, or Body), descriptions, type (String, integer, number, boolean), required
    • Json schema if one is provided via the Swagger json schema: @onos.rsModel <Json_schema_file_name> tag in the javadocs and a _name_without_extension> javadoc annotation and a .json schema file with the same name is in <app_path>/src/main/resources/definitions. An example can be seen with the DHCP app.
  • Responses: Types of response codes returned and their associated meanings
  • Produces/consumes: application type returned or consumed by the API (ex. "application/json")

...