Merge oasv3 feature branch into master - Prep for OASv3 Release (#…

…776) * Regenerate and rewrite for OASv3 using `openapi-generator.tech` (#737) * minor refactor * minor refactor * fix Travis build failure * added circle ci config * added jdk18 to circle ci config * minor refactor * minor refactor * minor refactor * minor refactor * removed unwanted file * updated readme and migrating guides and other refactoring * [maven-release-plugin] prepare release okta-sdk-root-10.0.0-beta * [maven-release-plugin] prepare for next development iteration * Release pr 10.0.0 beta (#747) * [maven-release-plugin] prepare release okta-sdk-root-10.0.0-beta * [maven-release-plugin] prepare for next development iteration * Update README.md * Add support for custom user profile attributes (#749) * add support for custom user profile attributes * added license header on new files * fix build failure * refactored * refactored * refactored * [OASv3] - OAuth for Okta (#753) * wip - oauth for okta * fix unit test failure * fix unit test failure * OKTA-526761: Add Caching support (#768) * add caching * OKTA-537443: Add Groups ITs (#772) added GroupsIT * OKTA-537444: Add Policy ITs (#773) * added PoliciesIT (signon) * Regen sdk with latest oasv3 spec (#774) * added PoliciesIT (signon) * updated PolicyIT * regen and refactor sdk with latest oasv3 spec * minor update * fix build * cve fix and prep for oasv3 GA release (#777) * cve fix and prep for oasv3 GA release * removed unwanted yaml file * revert jakarta annotation back to 1.3.5 * updated migration guide * updated circle ci config
okta · Oct 26, 2022 · 8be490d · 8be490d
1 parent 44ee7f9
commit 8be490d
Show file tree

Hide file tree

Showing 307 changed files with 31,997 additions and 26,613 deletions.
diff --git a/.circleci/config.yml b/.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
diff --git a/.gitignore b/.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
diff --git a/MIGRATING.md b/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.