Merge oasv3 feature branch into master - Prep for OASv3 Release

.circleci/config.yml

@@ -17,20 +17,28 @@ jobs:
 
   jdk8:
     docker:
-      - image: cimg/openjdk:8.0-node
+      - image: cimg/openjdk:8.0.345-node
     environment:
-        JVM_OPTS: -Xmx3200m
+      JVM_OPTS: -Xmx3200m
     steps: *build_steps
-  
+
   jdk11:
     docker:
-      - image: cimg/openjdk:11.0-node
+      - image: cimg/openjdk:11.0.16-node
+    environment:
+      JVM_OPTS: -Xmx3200m
+    steps: *build_steps
+
+  jdk17:
+    docker:
+      - image: cimg/openjdk:17.0.4-node
     environment:
-        JVM_OPTS: -Xmx3200m
+      JVM_OPTS: -Xmx3200m
     steps: *build_steps
 
 workflows:
   build_and_test:
     jobs:
       - jdk8
       - jdk11
+      - jdk17

.gitignore

@@ -50,3 +50,4 @@ travis_phantomjs
 
 # api.yaml will be fetched from NPM, the local copy will not be used.
 src/swagger/api.yaml
+/api/src/main/java/com/okta/sdk/client/AppMain.java

MIGRATING.md

@@ -2,6 +2,46 @@
 
 This SDK uses semantic versioning and follows Okta's [library version policy](https://developer.okta.com/code/library-versions/). In short, we do not make breaking changes unless the major version changes!
 
+## Migrating from 8.x.x to 10.x.x
+
+In previous versions we use an Open API v2 specification for the management APIs, and an Okta custom client generator to generate the SDK components. 
+A new version of the Open API specification v3 has been released, and new well-known open source generators are now available to automatically generate code from this specification.
+
+This revision will embrace the Open Source [openapi-generator](https://github.com/OpenAPITools/openapi-generator) to auto generate the code from Okta's reference specification (v3) of the Management APIs.
+
+### Okta client vs API clients
+
+In older version, you would instantiate a global `Client` and access the Okta resources using the Management APIs. 
+Now, each API area (such as Users, Groups, Applications etc.)  would have its own specific client, so you will only instantiate those clients you are interested in:
+
+_Earlier:_
+
+```java
+Client client = Clients.builder()
+    .setOrgUrl("https://{yourOktaDomain}")  // e.g. https://dev-123456.okta.com
+    .setClientCredentials(new TokenClientCredentials("{apiToken}"))
+    .build();
+
+User user = client.getUser("a-user-id");
+
+Application app = client.getApplication("appId");
+```
+
+_Now:_
+
+```java
+ApiClient client = Clients.builder()
+    .setOrgUrl("https://{yourOktaDomain}")  // e.g. https://dev-123456.okta.com
+    .setClientCredentials(new TokenClientCredentials("{apiToken}"))
+    .build();
+
+UserApi userApi = new UserApi(client);
+User user = userApi.getUser("userId");
+
+ApplicationApi applicationApi = new ApplicationApi(client);
+Application app = applicationApi.getApplication("appId", null);
+```
+
 ## Migrating from 7.x.x to 8.0.0
 
 Version 8.0.0 of this SDK introduces few breaking changes from previous versions.