documentation-samples/authoring-api-samples/java/AddUtterances.java [31:276]: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - public class AddUtterances { // Enter information about your LUIS application and key below static final String LUIS_APP_ID = "YOUR-APP-ID"; static final String LUIS_APP_VERSION = "0.1"; static final String LUIS_AUTHORING_ID = "YOUR-AUTHORING-KEY"; // Update the host if your LUIS subscription is not in the West US region static final String LUIS_BASE = "https://westus.api.cognitive.microsoft.com"; // File names for utterance and result files static final String UTTERANCE_FILE = "./utterances.json"; static final String UTF8 = "UTF-8"; // // LUIS Client class // Contains the functionality for adding utterances to a LUIS application // static class LuisClient{ private final String PATH = "/luis/api/v2.0/apps/{app_id}/versions/{app_version}"; // endpoint method names private final String TRAIN = "/train"; private final String EXAMPLES = "/examples"; private final String APP_INFO = "/"; // HTTP verbs private final String GET = "GET"; private final String POST = "POST"; // Null string value for use in resolving method calls private final String NO_DATA = null; // Member variables private final String key; private final String host; private final String path; LuisClient(String host, String app_id, String app_version, String key) throws Exception { this.path = PATH.replace("{app_id}", app_id).replace("{app_version}", app_version); this.host = host; this.key = key; // Test configuration by getting the application info // { // "version": "0.1", // "createdDateTime": "2018-08-21T13:24:18Z", // "lastModifiedDateTime": "2018-08-24T15:29:32Z", // "intentsCount": 5, // "entitiesCount": 8, // "endpointHitsCount": 0, // "trainingStatus": "InProgress" //} this.get(APP_INFO).raiseForStatus(); } private LuisResponse call(String endpoint, String method, byte[] data) throws Exception { // initialize HTTP connection URL url = new URL(this.host + this.path + endpoint); HttpURLConnection conn = (HttpURLConnection)url.openConnection(); conn.setRequestMethod(method); conn.setRequestProperty("Ocp-Apim-Subscription-Key", key); // handle POST request if (method.equals(POST)) { if (data == null) data = new byte[]{}; // make zero-length body for POST w/o data conn.setDoOutput(true); conn.setRequestProperty("Content-Type", "application/json"); conn.setRequestProperty("Content-Length", Integer.toString(data.length)); try (OutputStream ostream = conn.getOutputStream()) { ostream.write(data, 0, data.length); } } // Get response from API call. If response is an HTTP error, the JSON // response is on the error string. Otherwise, it's on the input string. InputStream stream; try { stream = conn.getInputStream(); } catch (IOException ex) { stream = conn.getErrorStream(); } String body = new Scanner(stream, UTF8).useDelimiter("\\A").next(); return new LuisResponse(body, conn.getResponseCode(), conn.getResponseMessage()); } // Overload of call() with String data paramater private LuisResponse call(String endpoint, String method, String data) throws Exception { byte[] bytes = null; if (data != null) bytes = data.getBytes(UTF8); return call(endpoint, method, bytes); } // Overload of call() with InputStream data paramater private LuisResponse call(String endpoint, String method, InputStream stream) throws Exception { String data = new Scanner(stream, UTF8).useDelimiter("\\A").next(); return call(endpoint, method, data); } // Shortcut for GET requests private LuisResponse get(String endpoint) throws Exception { return call(endpoint, GET, NO_DATA); } // Shortcut for POST requests -- InputStream data private LuisResponse post(String endpoint, InputStream data) throws Exception { return call(endpoint, POST, data); } // Shortcut for POST requests -- no data private LuisResponse post(String endpoint) throws Exception { return call(endpoint, POST, NO_DATA); } // Call to add utterances public LuisResponse addUtterances(String filename) throws Exception { try (FileInputStream stream = new FileInputStream(filename)) { return post(EXAMPLES, stream); } } public LuisResponse train() throws Exception { return post(TRAIN); } public LuisResponse status() throws Exception { return get(TRAIN); } } // // LUIS Response class // Represents a response from the LUIS client. All methods return // the instance so method calls can be chained. // static class LuisResponse { private final String body; private final int status; private final String reason; private JsonElement data; LuisResponse(String body, int status, String reason) { JsonParser parser = new JsonParser(); try { this.data = parser.parse(body); } catch (JsonSyntaxException ex) { this.data = parser.parse("{ \"message\": \"Invalid JSON response\" }"); } this.body = new GsonBuilder().setPrettyPrinting().create().toJson(data); this.status = status; this.reason = reason; System.out.println(this.body); } LuisResponse raiseForStatus() throws StatusException { if (this.status < 200 || this.status > 299) { throw new StatusException(this); } return this; } } // // LUIS Status Exception class // Represents an exception raised by the LUIS client for HTTP status errors // Includes details extracted from the JSON response and the HTTP status // static class StatusException extends Exception { private String details = ""; private final int status; StatusException(LuisResponse response) { super(String.format("%d %s", response.status, response.reason)); JsonObject jsonInfo = (JsonObject)response.data; if (jsonInfo.has("error")) jsonInfo = (JsonObject)jsonInfo.get("error"); if (jsonInfo.has("message")) this.details = jsonInfo.get("message").getAsString(); this.status = response.status; } String getDetails() { return this.details; } int getStatus() { return this.status; } } static void printExceptionMsg(Exception ex) { System.out.println(String.format("%s: %s", ex.getClass().getSimpleName(), ex.getMessage())); StackTraceElement caller = ex.getStackTrace()[1]; System.out.println(String.format(" in %s (line %d?)", caller.getFileName(), caller.getLineNumber())); if (ex instanceof StatusException) System.out.println(((StatusException)ex).getDetails()); } // ------------------------------------------------------------------------ // // Command-line entry point // public static void main(String[] args) { LuisClient luis = null; try { luis = new LuisClient(LUIS_BASE, LUIS_APP_ID, LUIS_APP_VERSION,LUIS_AUTHORING_ID); } catch (Exception ex) { printExceptionMsg(ex); System.exit(0); } try { System.out.println("Adding utterance(s)."); luis.addUtterances(UTTERANCE_FILE) .raiseForStatus(); System.out.println("Requesting training."); luis.train() .raiseForStatus(); System.out.println("Requested training. Requesting training status."); luis.status() .raiseForStatus(); } catch (Exception ex) { printExceptionMsg(ex); - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - documentation-samples/quickstarts/change-model/java/AddUtterances.java [31:276]: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - public class AddUtterances { // Enter information about your LUIS application and key below static final String LUIS_APP_ID = "YOUR-APP-ID"; static final String LUIS_APP_VERSION = "0.1"; static final String LUIS_AUTHORING_ID = "YOUR-AUTHORING-KEY"; // Update the host if your LUIS subscription is not in the West US region static final String LUIS_BASE = "https://westus.api.cognitive.microsoft.com"; // File names for utterance and result files static final String UTTERANCE_FILE = "./utterances.json"; static final String UTF8 = "UTF-8"; // // LUIS Client class // Contains the functionality for adding utterances to a LUIS application // static class LuisClient{ private final String PATH = "/luis/api/v2.0/apps/{app_id}/versions/{app_version}"; // endpoint method names private final String TRAIN = "/train"; private final String EXAMPLES = "/examples"; private final String APP_INFO = "/"; // HTTP verbs private final String GET = "GET"; private final String POST = "POST"; // Null string value for use in resolving method calls private final String NO_DATA = null; // Member variables private final String key; private final String host; private final String path; LuisClient(String host, String app_id, String app_version, String key) throws Exception { this.path = PATH.replace("{app_id}", app_id).replace("{app_version}", app_version); this.host = host; this.key = key; // Test configuration by getting the application info // { // "version": "0.1", // "createdDateTime": "2018-08-21T13:24:18Z", // "lastModifiedDateTime": "2018-08-24T15:29:32Z", // "intentsCount": 5, // "entitiesCount": 8, // "endpointHitsCount": 0, // "trainingStatus": "InProgress" //} this.get(APP_INFO).raiseForStatus(); } private LuisResponse call(String endpoint, String method, byte[] data) throws Exception { // initialize HTTP connection URL url = new URL(this.host + this.path + endpoint); HttpURLConnection conn = (HttpURLConnection)url.openConnection(); conn.setRequestMethod(method); conn.setRequestProperty("Ocp-Apim-Subscription-Key", key); // handle POST request if (method.equals(POST)) { if (data == null) data = new byte[]{}; // make zero-length body for POST w/o data conn.setDoOutput(true); conn.setRequestProperty("Content-Type", "application/json"); conn.setRequestProperty("Content-Length", Integer.toString(data.length)); try (OutputStream ostream = conn.getOutputStream()) { ostream.write(data, 0, data.length); } } // Get response from API call. If response is an HTTP error, the JSON // response is on the error string. Otherwise, it's on the input string. InputStream stream; try { stream = conn.getInputStream(); } catch (IOException ex) { stream = conn.getErrorStream(); } String body = new Scanner(stream, UTF8).useDelimiter("\\A").next(); return new LuisResponse(body, conn.getResponseCode(), conn.getResponseMessage()); } // Overload of call() with String data paramater private LuisResponse call(String endpoint, String method, String data) throws Exception { byte[] bytes = null; if (data != null) bytes = data.getBytes(UTF8); return call(endpoint, method, bytes); } // Overload of call() with InputStream data paramater private LuisResponse call(String endpoint, String method, InputStream stream) throws Exception { String data = new Scanner(stream, UTF8).useDelimiter("\\A").next(); return call(endpoint, method, data); } // Shortcut for GET requests private LuisResponse get(String endpoint) throws Exception { return call(endpoint, GET, NO_DATA); } // Shortcut for POST requests -- InputStream data private LuisResponse post(String endpoint, InputStream data) throws Exception { return call(endpoint, POST, data); } // Shortcut for POST requests -- no data private LuisResponse post(String endpoint) throws Exception { return call(endpoint, POST, NO_DATA); } // Call to add utterances public LuisResponse addUtterances(String filename) throws Exception { try (FileInputStream stream = new FileInputStream(filename)) { return post(EXAMPLES, stream); } } public LuisResponse train() throws Exception { return post(TRAIN); } public LuisResponse status() throws Exception { return get(TRAIN); } } // // LUIS Response class // Represents a response from the LUIS client. All methods return // the instance so method calls can be chained. // static class LuisResponse { private final String body; private final int status; private final String reason; private JsonElement data; LuisResponse(String body, int status, String reason) { JsonParser parser = new JsonParser(); try { this.data = parser.parse(body); } catch (JsonSyntaxException ex) { this.data = parser.parse("{ \"message\": \"Invalid JSON response\" }"); } this.body = new GsonBuilder().setPrettyPrinting().create().toJson(data); this.status = status; this.reason = reason; System.out.println(this.body); } LuisResponse raiseForStatus() throws StatusException { if (this.status < 200 || this.status > 299) { throw new StatusException(this); } return this; } } // // LUIS Status Exception class // Represents an exception raised by the LUIS client for HTTP status errors // Includes details extracted from the JSON response and the HTTP status // static class StatusException extends Exception { private String details = ""; private final int status; StatusException(LuisResponse response) { super(String.format("%d %s", response.status, response.reason)); JsonObject jsonInfo = (JsonObject)response.data; if (jsonInfo.has("error")) jsonInfo = (JsonObject)jsonInfo.get("error"); if (jsonInfo.has("message")) this.details = jsonInfo.get("message").getAsString(); this.status = response.status; } String getDetails() { return this.details; } int getStatus() { return this.status; } } static void printExceptionMsg(Exception ex) { System.out.println(String.format("%s: %s", ex.getClass().getSimpleName(), ex.getMessage())); StackTraceElement caller = ex.getStackTrace()[1]; System.out.println(String.format(" in %s (line %d?)", caller.getFileName(), caller.getLineNumber())); if (ex instanceof StatusException) System.out.println(((StatusException)ex).getDetails()); } // ------------------------------------------------------------------------ // // Command-line entry point // public static void main(String[] args) { LuisClient luis = null; try { luis = new LuisClient(LUIS_BASE, LUIS_APP_ID, LUIS_APP_VERSION,LUIS_AUTHORING_ID); } catch (Exception ex) { printExceptionMsg(ex); System.exit(0); } try { System.out.println("Adding utterance(s)."); luis.addUtterances(UTTERANCE_FILE) .raiseForStatus(); System.out.println("Requesting training."); luis.train() .raiseForStatus(); System.out.println("Requested training. Requesting training status."); luis.status() .raiseForStatus(); } catch (Exception ex) { printExceptionMsg(ex); - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -