feat: add support to fetch platform roles from server

Author: joragua

owncloudApp/src/main/java/com/owncloud/android/dependecyinjection/RemoteDataSourceModule.kt

@@ -2,7 +2,9 @@
  * ownCloud Android client application
  *
  * @author David González Verdugo
- * Copyright (C) 2020 ownCloud GmbH.
+ * @author Jorge Aguado Recio
+ *
+ * Copyright (C) 2025 ownCloud GmbH.
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 2,
@@ -33,6 +35,8 @@ import com.owncloud.android.data.files.datasources.RemoteFileDataSource
 import com.owncloud.android.data.files.datasources.implementation.OCRemoteFileDataSource
 import com.owncloud.android.data.oauth.datasources.RemoteOAuthDataSource
 import com.owncloud.android.data.oauth.datasources.implementation.OCRemoteOAuthDataSource
+import com.owncloud.android.data.roles.datasources.RemoteRolesDataSource
+import com.owncloud.android.data.roles.datasources.implementation.OCRemoteRolesDataSource
 import com.owncloud.android.data.server.datasources.RemoteServerInfoDataSource
 import com.owncloud.android.data.server.datasources.implementation.OCRemoteServerInfoDataSource
 import com.owncloud.android.data.sharing.sharees.datasources.RemoteShareeDataSource
@@ -73,6 +77,7 @@ val remoteDataSourceModule = module {
     singleOf(::OCRemoteCapabilitiesDataSource) bind RemoteCapabilitiesDataSource::class
     singleOf(::OCRemoteFileDataSource) bind RemoteFileDataSource::class
     singleOf(::OCRemoteOAuthDataSource) bind RemoteOAuthDataSource::class
+    singleOf(::OCRemoteRolesDataSource) bind RemoteRolesDataSource::class
     singleOf(::OCRemoteServerInfoDataSource) bind RemoteServerInfoDataSource::class
     singleOf(::OCRemoteShareDataSource) bind RemoteShareDataSource::class
     singleOf(::OCRemoteShareeDataSource) bind RemoteShareeDataSource::class

owncloudApp/src/main/java/com/owncloud/android/dependecyinjection/RepositoryModule.kt

@@ -4,8 +4,9 @@
  * @author David González Verdugo
  * @author Abel García de Prada
  * @author Juan Carlos Garrote Gascón
+ * @author Jorge Aguado Recio
  *
- * Copyright (C) 2022 ownCloud GmbH.
+ * Copyright (C) 2025 ownCloud GmbH.
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 2,
@@ -28,6 +29,7 @@ import com.owncloud.android.data.capabilities.repository.OCCapabilityRepository
 import com.owncloud.android.data.files.repository.OCFileRepository
 import com.owncloud.android.data.folderbackup.repository.OCFolderBackupRepository
 import com.owncloud.android.data.oauth.repository.OCOAuthRepository
+import com.owncloud.android.data.roles.repository.OCRolesRepository
 import com.owncloud.android.data.server.repository.OCServerInfoRepository
 import com.owncloud.android.data.sharing.sharees.repository.OCShareeRepository
 import com.owncloud.android.data.sharing.shares.repository.OCShareRepository
@@ -41,6 +43,7 @@ import com.owncloud.android.domain.authentication.oauth.OAuthRepository
 import com.owncloud.android.domain.automaticuploads.FolderBackupRepository
 import com.owncloud.android.domain.capabilities.CapabilityRepository
 import com.owncloud.android.domain.files.FileRepository
+import com.owncloud.android.domain.roles.RolesRepository
 import com.owncloud.android.domain.server.ServerInfoRepository
 import com.owncloud.android.domain.sharing.sharees.ShareeRepository
 import com.owncloud.android.domain.sharing.shares.ShareRepository
@@ -59,6 +62,7 @@ val repositoryModule = module {
     factoryOf(::OCFileRepository) bind FileRepository::class
     factoryOf(::OCFolderBackupRepository) bind FolderBackupRepository::class
     factoryOf(::OCOAuthRepository) bind OAuthRepository::class
+    factoryOf(::OCRolesRepository) bind RolesRepository::class
     factoryOf(::OCServerInfoRepository) bind ServerInfoRepository::class
     factoryOf(::OCShareRepository) bind ShareRepository::class
     factoryOf(::OCShareeRepository) bind ShareeRepository::class

owncloudApp/src/main/java/com/owncloud/android/dependecyinjection/UseCaseModule.kt

@@ -79,6 +79,7 @@ import com.owncloud.android.domain.files.usecases.SetLastUsageFileUseCase
 import com.owncloud.android.domain.files.usecases.SortFilesUseCase
 import com.owncloud.android.domain.files.usecases.SortFilesWithSyncInfoUseCase
 import com.owncloud.android.domain.files.usecases.UpdateAlreadyDownloadedFilesPathUseCase
+import com.owncloud.android.domain.roles.usecases.GetRolesAsyncUseCase
 import com.owncloud.android.domain.server.usecases.GetServerInfoAsyncUseCase
 import com.owncloud.android.domain.sharing.sharees.GetShareesAsyncUseCase
 import com.owncloud.android.domain.sharing.shares.usecases.CreatePrivateShareAsyncUseCase
@@ -302,4 +303,7 @@ val useCaseModule = module {
 
     // Accounts
     factoryOf(::RemoveAccountUseCase)
+
+    // Roles
+    factoryOf(::GetRolesAsyncUseCase)
 }

owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/roles/GetRemoteRolesOperation.kt

@@ -0,0 +1,81 @@
+/**
+ * ownCloud Android client application
+ *
+ * @author Jorge Aguado Recio
+ *
+ * Copyright (C) 2025 ownCloud GmbH.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 2,
+ * as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.owncloud.android.lib.resources.roles
+
+import com.owncloud.android.lib.common.OwnCloudClient
+import com.owncloud.android.lib.common.http.HttpConstants
+import com.owncloud.android.lib.common.http.methods.nonwebdav.GetMethod
+import com.owncloud.android.lib.common.operations.RemoteOperation
+import com.owncloud.android.lib.common.operations.RemoteOperationResult
+import com.owncloud.android.lib.common.operations.RemoteOperationResult.ResultCode
+import com.owncloud.android.lib.resources.roles.responses.RoleResponse
+import com.squareup.moshi.JsonAdapter
+import com.squareup.moshi.Moshi
+import com.squareup.moshi.Types
+import timber.log.Timber
+import java.net.URL
+
+class GetRemoteRolesOperation: RemoteOperation<List<RoleResponse>>() {
+    override fun run(client: OwnCloudClient): RemoteOperationResult<List<RoleResponse>> {
+        var result: RemoteOperationResult<List<RoleResponse>>
+        try {
+            val requestUri = client.baseUri.buildUpon().apply {
+                appendEncodedPath(GRAPH_API_ROLE_DEFINITIONS_PATH)
+                build()
+            }
+
+            val getMethod = GetMethod(URL(requestUri.toString()))
+
+             val status = client.executeHttpMethod(getMethod)
+
+            val response = getMethod.getResponseBodyAsString()
+
+            if (status == HttpConstants.HTTP_OK) {
+                Timber.d("Successful response: $response")
+
+                val moshi: Moshi = Moshi.Builder().build()
+                val type = Types.newParameterizedType(List::class.java, RoleResponse::class.java)
+                val adapter: JsonAdapter<List<RoleResponse>> = moshi.adapter(type)
+
+                val roles = adapter.fromJson(response)
+
+                result = RemoteOperationResult(ResultCode.OK)
+                result.data = roles ?: emptyList()
+
+                result = RemoteOperationResult(ResultCode.OK)
+                result.data = getMethod.getResponseBodyAsString().let { adapter.fromJson(it) }
+
+                Timber.d("Get roles completed and parsed to ${result.data}")
+            } else {
+                result = RemoteOperationResult(getMethod)
+                Timber.e("Failed response while getting roles; status code: $status, response: $response")
+            }
+        } catch (e: Exception) {
+            result = RemoteOperationResult(e)
+            Timber.e(e, "Exception while getting roles")
+        }
+        return result
+    }
+
+    companion object {
+        private const val GRAPH_API_ROLE_DEFINITIONS_PATH = "graph/v1beta1/roleManagement/permissions/roleDefinitions"
+    }
+}

owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/roles/responses/RoleResponse.kt

@@ -0,0 +1,29 @@
+/**
+ * ownCloud Android client application
+ *
+ * @author Jorge Aguado Recio
+ *
+ * Copyright (C) 2025 ownCloud GmbH.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 2,
+ * as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.owncloud.android.lib.resources.roles.responses
+
+import com.squareup.moshi.JsonClass
+
+@JsonClass(generateAdapter = true)
+data class RoleResponse(
+    val id: String,
+    val displayName: String
+)

owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/roles/services/OCRolesService.kt

@@ -0,0 +1,33 @@
+/**
+ * ownCloud Android client application
+ *
+ * @author Jorge Aguado Recio
+ *
+ * Copyright (C) 2025 ownCloud GmbH.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 2,
+ * as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.owncloud.android.lib.resources.roles.services
+
+import com.owncloud.android.lib.common.OwnCloudClient
+import com.owncloud.android.lib.common.operations.RemoteOperationResult
+import com.owncloud.android.lib.resources.roles.GetRemoteRolesOperation
+import com.owncloud.android.lib.resources.roles.responses.RoleResponse
+
+class OCRolesService(override val client: OwnCloudClient) : RolesService {
+
+    override fun getRoles(): RemoteOperationResult<List<RoleResponse>> =
+        GetRemoteRolesOperation().execute(client)
+
+}

owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/roles/services/RolesService.kt

@@ -0,0 +1,29 @@
+/**
+ * ownCloud Android client application
+ *
+ * @author Jorge Aguado Recio
+ *
+ * Copyright (C) 2025 ownCloud GmbH.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 2,
+ * as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.owncloud.android.lib.resources.roles.services
+
+import com.owncloud.android.lib.common.operations.RemoteOperationResult
+import com.owncloud.android.lib.resources.Service
+import com.owncloud.android.lib.resources.roles.responses.RoleResponse
+
+interface RolesService: Service {
+    fun getRoles(): RemoteOperationResult<List<RoleResponse>>
+}

owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/spaces/responses/SpacesResponse.kt

@@ -23,6 +23,7 @@
 
 package com.owncloud.android.lib.resources.spaces.responses
 
+import com.owncloud.android.lib.resources.roles.responses.RoleResponse
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 
@@ -126,13 +127,8 @@ data class SpacePermissionsResponse(
     @Json(name = "@libre.graph.permissions.actions.allowedValues")
     val actions: List<String>,
     @Json(name = "@libre.graph.permissions.roles.allowedValues")
-    val roles: List<SpaceRoleResponse>,
+    val roles: List<RoleResponse>,
     @Json(name = "value")
     val members: List<PermissionsResponse>
 )
 
-@JsonClass(generateAdapter = true)
-data class SpaceRoleResponse(
-    val displayName: String,
-    val id: String
-)

owncloudData/src/main/java/com/owncloud/android/data/ClientManager.kt

@@ -2,7 +2,9 @@
  * ownCloud Android client application
  *
  * @author Abel García de Prada
- * Copyright (C) 2023 ownCloud GmbH.
+ * @author Jorge Aguado Recio
+ *
+ * Copyright (C) 2025 ownCloud GmbH.
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 2,
@@ -34,6 +36,8 @@ import com.owncloud.android.lib.resources.appregistry.services.AppRegistryServic
 import com.owncloud.android.lib.resources.appregistry.services.OCAppRegistryService
 import com.owncloud.android.lib.resources.files.services.FileService
 import com.owncloud.android.lib.resources.files.services.implementation.OCFileService
+import com.owncloud.android.lib.resources.roles.services.OCRolesService
+import com.owncloud.android.lib.resources.roles.services.RolesService
 import com.owncloud.android.lib.resources.shares.services.ShareService
 import com.owncloud.android.lib.resources.shares.services.ShareeService
 import com.owncloud.android.lib.resources.shares.services.implementation.OCShareService
@@ -160,4 +164,9 @@ class ClientManager(
         val ownCloudClient = getClientForAccount(accountName)
         return OCAppRegistryService(client = ownCloudClient)
     }
+
+    fun getRolesService(accountName: String): RolesService {
+        val ownCloudClient = getClientForAccount(accountName)
+        return OCRolesService(client = ownCloudClient)
+    }
 }

owncloudData/src/main/java/com/owncloud/android/data/roles/datasources/RemoteRolesDataSource.kt

@@ -0,0 +1,27 @@
+/**
+ * ownCloud Android client application
+ *
+ * @author Jorge Aguado Recio
+ *
+ * Copyright (C) 2025 ownCloud GmbH.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 2,
+ * as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.owncloud.android.data.roles.datasources
+
+import com.owncloud.android.domain.roles.model.OCRole
+
+interface RemoteRolesDataSource {
+    fun getRoles(accountName: String): List<OCRole>
+}