feat: add find app item for shared link endpoint (box/box-openapi#514) (#241)

Author: box-sdk-build

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "ef00939", "specHash": "06fc5f7", "version": "0.5.0" }
+{ "engineHash": "41feeaa", "specHash": "3dc6f70", "version": "0.5.0" }

docs/README.md

@@ -49,6 +49,7 @@ the SDK are available by topic:
 * [Retentionpolicyassignments](retentionpolicyassignments.md)
 * [Search](search.md)
 * [Sessiontermination](sessiontermination.md)
+* [Sharedlinksappitems](sharedlinksappitems.md)
 * [Sharedlinksfiles](sharedlinksfiles.md)
 * [Sharedlinksfolders](sharedlinksfolders.md)
 * [Sharedlinksweblinks](sharedlinksweblinks.md)

docs/sharedlinksappitems.md

@@ -0,0 +1,32 @@
+# SharedLinksAppItemsManager
+
+
+- [Find app item for shared link](#find-app-item-for-shared-link)
+
+## Find app item for shared link
+
+Returns the app item represented by a shared link.
+
+The link can originate from the current enterprise or another.
+
+This operation is performed by calling function `getSharedItemAppItems`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/get-shared-items--app-items/).
+
+*Currently we don't have an example for calling `getSharedItemAppItems` in integration tests*
+
+### Arguments
+
+- headers `GetSharedItemAppItemsHeaders`
+  - Headers of getSharedItemAppItems method
+
+
+### Returns
+
+This function returns a value of type `AppItem`.
+
+Returns a full app item resource if the shared link is valid and
+the user has access to it.
+
+

docs/sharedlinksweblinks.md

@@ -39,7 +39,7 @@ userClient.getSharedLinksWebLinks().findWebLinkForSharedLink(new FindWebLinkForS
 
 This function returns a value of type `WebLink`.
 
-Returns a full file resource if the shared link is valid and
+Returns a full web link resource if the shared link is valid and
 the user has access to it.
 
 

src/main/java/com/box/sdkgen/client/BoxClient.java

@@ -47,6 +47,7 @@
 import com.box.sdkgen.managers.retentionpolicyassignments.RetentionPolicyAssignmentsManager;
 import com.box.sdkgen.managers.search.SearchManager;
 import com.box.sdkgen.managers.sessiontermination.SessionTerminationManager;
+import com.box.sdkgen.managers.sharedlinksappitems.SharedLinksAppItemsManager;
 import com.box.sdkgen.managers.sharedlinksfiles.SharedLinksFilesManager;
 import com.box.sdkgen.managers.sharedlinksfolders.SharedLinksFoldersManager;
 import com.box.sdkgen.managers.sharedlinksweblinks.SharedLinksWebLinksManager;
@@ -159,6 +160,8 @@ public class BoxClient {
 
   public final SharedLinksWebLinksManager sharedLinksWebLinks;
 
+  public final SharedLinksAppItemsManager sharedLinksAppItems;
+
   public final UsersManager users;
 
   public final SessionTerminationManager sessionTermination;
@@ -412,6 +415,11 @@ public BoxClient(Authentication auth) {
             .auth(this.auth)
             .networkSession(this.networkSession)
             .build();
+    this.sharedLinksAppItems =
+        new SharedLinksAppItemsManager.SharedLinksAppItemsManagerBuilder()
+            .auth(this.auth)
+            .networkSession(this.networkSession)
+            .build();
     this.users =
         new UsersManager.UsersManagerBuilder()
             .auth(this.auth)
@@ -785,6 +793,11 @@ protected BoxClient(BoxClientBuilder builder) {
             .auth(this.auth)
             .networkSession(this.networkSession)
             .build();
+    this.sharedLinksAppItems =
+        new SharedLinksAppItemsManager.SharedLinksAppItemsManagerBuilder()
+            .auth(this.auth)
+            .networkSession(this.networkSession)
+            .build();
     this.users =
         new UsersManager.UsersManagerBuilder()
             .auth(this.auth)
@@ -1187,6 +1200,10 @@ public SharedLinksWebLinksManager getSharedLinksWebLinks() {
     return sharedLinksWebLinks;
   }
 
+  public SharedLinksAppItemsManager getSharedLinksAppItems() {
+    return sharedLinksAppItems;
+  }
+
   public UsersManager getUsers() {
     return users;
   }

src/main/java/com/box/sdkgen/managers/sharedlinksappitems/GetSharedItemAppItemsHeaders.java

@@ -0,0 +1,51 @@
+package com.box.sdkgen.managers.sharedlinksappitems;
+
+import static com.box.sdkgen.internal.utils.UtilsManager.mapOf;
+
+import java.util.Map;
+
+public class GetSharedItemAppItemsHeaders {
+
+  public final String boxapi;
+
+  public Map<String, String> extraHeaders;
+
+  public GetSharedItemAppItemsHeaders(String boxapi) {
+    this.boxapi = boxapi;
+    this.extraHeaders = mapOf();
+  }
+
+  protected GetSharedItemAppItemsHeaders(GetSharedItemAppItemsHeadersBuilder builder) {
+    this.boxapi = builder.boxapi;
+    this.extraHeaders = builder.extraHeaders;
+  }
+
+  public String getBoxapi() {
+    return boxapi;
+  }
+
+  public Map<String, String> getExtraHeaders() {
+    return extraHeaders;
+  }
+
+  public static class GetSharedItemAppItemsHeadersBuilder {
+
+    protected final String boxapi;
+
+    protected Map<String, String> extraHeaders;
+
+    public GetSharedItemAppItemsHeadersBuilder(String boxapi) {
+      this.boxapi = boxapi;
+      this.extraHeaders = mapOf();
+    }
+
+    public GetSharedItemAppItemsHeadersBuilder extraHeaders(Map<String, String> extraHeaders) {
+      this.extraHeaders = extraHeaders;
+      return this;
+    }
+
+    public GetSharedItemAppItemsHeaders build() {
+      return new GetSharedItemAppItemsHeaders(this);
+    }
+  }
+}

src/main/java/com/box/sdkgen/managers/sharedlinksappitems/SharedLinksAppItemsManager.java

@@ -0,0 +1,85 @@
+package com.box.sdkgen.managers.sharedlinksappitems;
+
+import static com.box.sdkgen.internal.utils.UtilsManager.convertToString;
+import static com.box.sdkgen.internal.utils.UtilsManager.entryOf;
+import static com.box.sdkgen.internal.utils.UtilsManager.mapOf;
+import static com.box.sdkgen.internal.utils.UtilsManager.mergeMaps;
+import static com.box.sdkgen.internal.utils.UtilsManager.prepareParams;
+
+import com.box.sdkgen.networking.auth.Authentication;
+import com.box.sdkgen.networking.fetchoptions.FetchOptions;
+import com.box.sdkgen.networking.fetchoptions.ResponseFormat;
+import com.box.sdkgen.networking.fetchresponse.FetchResponse;
+import com.box.sdkgen.networking.network.NetworkSession;
+import com.box.sdkgen.schemas.appitem.AppItem;
+import com.box.sdkgen.serialization.json.JsonManager;
+import java.util.Map;
+
+public class SharedLinksAppItemsManager {
+
+  public Authentication auth;
+
+  public NetworkSession networkSession;
+
+  public SharedLinksAppItemsManager() {
+    this.networkSession = new NetworkSession();
+  }
+
+  protected SharedLinksAppItemsManager(SharedLinksAppItemsManagerBuilder builder) {
+    this.auth = builder.auth;
+    this.networkSession = builder.networkSession;
+  }
+
+  public AppItem getSharedItemAppItems(GetSharedItemAppItemsHeaders headers) {
+    Map<String, String> headersMap =
+        prepareParams(
+            mergeMaps(
+                mapOf(entryOf("boxapi", convertToString(headers.getBoxapi()))),
+                headers.getExtraHeaders()));
+    FetchResponse response =
+        this.networkSession
+            .getNetworkClient()
+            .fetch(
+                new FetchOptions.FetchOptionsBuilder(
+                        String.join(
+                            "",
+                            this.networkSession.getBaseUrls().getBaseUrl(),
+                            "/2.0/shared_items#app_items"),
+                        "GET")
+                    .headers(headersMap)
+                    .responseFormat(ResponseFormat.JSON)
+                    .auth(this.auth)
+                    .networkSession(this.networkSession)
+                    .build());
+    return JsonManager.deserialize(response.getData(), AppItem.class);
+  }
+
+  public Authentication getAuth() {
+    return auth;
+  }
+
+  public NetworkSession getNetworkSession() {
+    return networkSession;
+  }
+
+  public static class SharedLinksAppItemsManagerBuilder {
+
+    protected Authentication auth;
+
+    protected NetworkSession networkSession;
+
+    public SharedLinksAppItemsManagerBuilder auth(Authentication auth) {
+      this.auth = auth;
+      return this;
+    }
+
+    public SharedLinksAppItemsManagerBuilder networkSession(NetworkSession networkSession) {
+      this.networkSession = networkSession;
+      return this;
+    }
+
+    public SharedLinksAppItemsManager build() {
+      return new SharedLinksAppItemsManager(this);
+    }
+  }
+}