Support Dropbox-API-Select-Admin header.

Author: jiuyangzhao

src/main/java/com/dropbox/core/DbxRequestUtil.java

@@ -117,6 +117,14 @@ public static List<HttpRequestor.Header> addSelectUserHeader(/*@Nullable*/List<H
         return headers;
     }
 
+    public static List<HttpRequestor.Header> addSelectAdminHeader(/*@Nullable*/List<HttpRequestor.Header> headers, String adminId) {
+        if (adminId == null) throw new NullPointerException("adminId");
+        if (headers == null) headers = new ArrayList<HttpRequestor.Header>();
+
+        headers.add(new HttpRequestor.Header("Dropbox-API-Select-Admin", adminId));
+        return headers;
+    }
+
     public static List<HttpRequestor.Header> addBasicAuthHeader(/*@Nullable*/List<HttpRequestor.Header> headers, String username, String password) {
         if (username == null) throw new NullPointerException("username");
         if (password == null) throw new NullPointerException("password");

src/main/java/com/dropbox/core/v2/DbxTeamClientV2.java

@@ -68,7 +68,7 @@ public DbxTeamClientV2(DbxRequestConfig requestConfig, String accessToken, DbxHo
      *               multi-Dropbox account use-case.
      */
     public DbxTeamClientV2(DbxRequestConfig requestConfig, String accessToken, DbxHost host, String userId) {
-        super(new DbxTeamRawClientV2(requestConfig, host, accessToken, userId, null, null));
+        super(new DbxTeamRawClientV2(requestConfig, host, accessToken, userId, null, null, null));
         this.accessToken = accessToken;
     }
 
@@ -97,11 +97,43 @@ public DbxClientV2 asMember(String memberId) {
             accessToken,
             _client.getUserId(),
             memberId,
+            null,
             null
         );
         return new DbxClientV2(asMemberClient);
     }
 
+    /**
+     * Returns a {@link DbxClientV2} that performs requests against Dropbox API
+     * user endpoints as the given team admin.
+     *
+     * <p> This method performs no validation of the team admin ID. </p>
+     *
+     * @param adminId  Team member ID of the admin in client's team, never
+     *     {@code null}.
+     *
+     * @return Dropbox client that issues requests to user endpoints as the
+     *     given team Admin.
+     *
+     * @throws IllegalArgumentException  If {@code adminId} is {@code null}
+     */
+    public DbxClientV2 asAdmin(String adminId) {
+        if (adminId == null) {
+            throw new IllegalArgumentException("'adminId' should not be null");
+        }
+
+        DbxRawClientV2 asAdminClient = new DbxTeamRawClientV2(
+            _client.getRequestConfig(),
+            _client.getHost(),
+            accessToken,
+            _client.getUserId(),
+            null,
+            adminId,
+            null
+        );
+        return new DbxClientV2(asAdminClient);
+    }
+
     /**
      * {@link DbxRawClientV2} raw client that adds team OAuth2 auth headers to all requests. If a
      * member ID is specified, this client will also add select-user headers to all requests (used
@@ -110,18 +142,22 @@ public DbxClientV2 asMember(String memberId) {
     private static final class DbxTeamRawClientV2 extends DbxRawClientV2 {
         private final String accessToken;
         private final String memberId;
+        private final String adminId;
 
         private DbxTeamRawClientV2(DbxRequestConfig requestConfig, DbxHost host, String accessToken) {
-            this(requestConfig, host, accessToken, null, null, null);
+            this(requestConfig, host, accessToken, null, null, null, null);
         }
 
-        private DbxTeamRawClientV2(DbxRequestConfig requestConfig, DbxHost host, String accessToken, String userId, String memberId, PathRoot pathRoot) {
+        private DbxTeamRawClientV2(
+            DbxRequestConfig requestConfig, DbxHost host, String accessToken, String userId, String memberId,
+            String adminId, PathRoot pathRoot) {
             super(requestConfig, host, userId, pathRoot);
 
             if (accessToken == null) throw new NullPointerException("accessToken");
 
             this.accessToken = accessToken;
             this.memberId = memberId;
+            this.adminId = adminId;
         }
 
         @Override
@@ -130,6 +166,9 @@ protected void addAuthHeaders(List<HttpRequestor.Header> headers) {
             if (memberId != null) {
                 DbxRequestUtil.addSelectUserHeader(headers, memberId);
             }
+            if (adminId != null) {
+                DbxRequestUtil.addSelectAdminHeader(headers, adminId);
+            }
         }
 
         @Override
@@ -140,6 +179,7 @@ protected DbxRawClientV2 withPathRoot(PathRoot pathRoot) {
                 this.accessToken,
                 this.getUserId(),
                 this.memberId,
+                this.adminId,
                 pathRoot
             );
         }