feat(visual-recognition): Add Core ML endpoint and options model

Author: lpatino10

visual-recognition/src/main/java/com/ibm/watson/developer_cloud/visual_recognition/v3/VisualRecognition.java

@@ -27,12 +27,14 @@
 import com.ibm.watson.developer_cloud.visual_recognition.v3.model.DetectFacesOptions;
 import com.ibm.watson.developer_cloud.visual_recognition.v3.model.DetectedFaces;
 import com.ibm.watson.developer_cloud.visual_recognition.v3.model.GetClassifierOptions;
+import com.ibm.watson.developer_cloud.visual_recognition.v3.model.GetCoreMlModelOptions;
 import com.ibm.watson.developer_cloud.visual_recognition.v3.model.ListClassifiersOptions;
 import com.ibm.watson.developer_cloud.visual_recognition.v3.model.UpdateClassifierOptions;
 import okhttp3.MultipartBody;
 import okhttp3.RequestBody;
 
 import java.io.File;
+import java.io.InputStream;
 
 /**
  * The IBM Watson Visual Recognition service uses deep learning algorithms to identify scenes, objects, and faces in
@@ -361,4 +363,23 @@ public ServiceCall<Classifier> updateClassifier(UpdateClassifierOptions updateCl
     return createServiceCall(builder.build(), ResponseConverterUtils.getObject(Classifier.class));
   }
 
+  /**
+   * Retrieve a Core ML model of a classifier.
+   *
+   * Download a Core ML model file (.mlmodel) of a custom classifier that returns <tt>\"core_ml_enabled\": true</tt> in
+   * the classifier details.
+   *
+   * @param getCoreMlModelOptions the {@link GetCoreMlModelOptions} containing the options for the call
+   * @return a {@link ServiceCall} with a response type of {@link InputStream}
+   */
+  public ServiceCall<InputStream> getCoreMlModel(GetCoreMlModelOptions getCoreMlModelOptions) {
+    Validator.notNull(getCoreMlModelOptions, "getCoreMlModelOptions cannot be null");
+    String[] pathSegments = { "v3/classifiers", "core_ml_model" };
+    String[] pathParameters = { getCoreMlModelOptions.classifierId() };
+    RequestBuilder builder = RequestBuilder.get(RequestBuilder.constructHttpUrl(getEndPoint(), pathSegments,
+        pathParameters));
+    builder.query(VERSION, versionDate);
+    return createServiceCall(builder.build(), ResponseConverterUtils.getInputStream());
+  }
+
 }

visual-recognition/src/main/java/com/ibm/watson/developer_cloud/visual_recognition/v3/model/GetCoreMlModelOptions.java

@@ -0,0 +1,95 @@
+/*
+ * Copyright 2018 IBM Corp. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
+ * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations under the License.
+ */
+package com.ibm.watson.developer_cloud.visual_recognition.v3.model;
+
+import com.ibm.watson.developer_cloud.service.model.GenericModel;
+import com.ibm.watson.developer_cloud.util.Validator;
+
+/**
+ * The getCoreMlModel options.
+ */
+public class GetCoreMlModelOptions extends GenericModel {
+
+  private String classifierId;
+
+  /**
+   * Builder.
+   */
+  public static class Builder {
+    private String classifierId;
+
+    private Builder(GetCoreMlModelOptions getCoreMlModelOptions) {
+      classifierId = getCoreMlModelOptions.classifierId;
+    }
+
+    /**
+     * Instantiates a new builder.
+     */
+    public Builder() {
+    }
+
+    /**
+     * Instantiates a new builder with required properties.
+     *
+     * @param classifierId the classifierId
+     */
+    public Builder(String classifierId) {
+      this.classifierId = classifierId;
+    }
+
+    /**
+     * Builds a GetCoreMlModelOptions.
+     *
+     * @return the getCoreMlModelOptions
+     */
+    public GetCoreMlModelOptions build() {
+      return new GetCoreMlModelOptions(this);
+    }
+
+    /**
+     * Set the classifierId.
+     *
+     * @param classifierId the classifierId
+     * @return the GetCoreMlModelOptions builder
+     */
+    public Builder classifierId(String classifierId) {
+      this.classifierId = classifierId;
+      return this;
+    }
+  }
+
+  private GetCoreMlModelOptions(Builder builder) {
+    Validator.notEmpty(builder.classifierId, "classifierId cannot be empty");
+    classifierId = builder.classifierId;
+  }
+
+  /**
+   * New builder.
+   *
+   * @return a GetCoreMlModelOptions builder
+   */
+  public Builder newBuilder() {
+    return new Builder(this);
+  }
+
+  /**
+   * Gets the classifierId.
+   *
+   * The ID of the classifier.
+   *
+   * @return the classifierId
+   */
+  public String classifierId() {
+    return classifierId;
+  }
+}