WS-2744: add back (deprecated) numCategories to CategoriesOptions

Author: Katsuya-Tomioka

model/src/main/java/com/basistech/rosette/apimodel/CategoriesOptions.java

@@ -17,6 +17,7 @@
 package com.basistech.rosette.apimodel;
 
 import com.basistech.rosette.annotations.JacksonMixin;
+import javax.validation.constraints.Min;
 import lombok.Builder;
 import lombok.Value;
 
@@ -28,6 +29,16 @@
 @JacksonMixin
 public class CategoriesOptions extends Options {
 
+    /**
+     * @deprecated
+     * Users should use {@link singleLabel} to return only one result
+     * or {@link scoreThreshold} to filter results based on raw score
+     * @return number of categories
+     */
+    @Deprecated
+    @Min(1)
+    private final Integer numCategories;
+
     /**
      * Single label mode will return only the highest scoring category, regardless of score
      * If singleLabel is false, every category whose score exceeds the default