Add RoomIDComponents: A structure that parses Matrix Room ID and constructs their constituent parts.

2026-04-26 11:30:50 +02:00 · 2020-11-02 18:08:38 +01:00
parent c322c36263
commit b9e6daf8c2
2 changed files with 76 additions and 0 deletions
@@ -0,0 +1,64 @@
+/*
+ Copyright 2019 New Vector Ltd
+ 
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+ 
+ http://www.apache.org/licenses/LICENSE-2.0
+ 
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import Foundation
+
+/// A structure that parses Matrix Room ID and constructs their constituent parts.
+struct RoomIDComponents {
+    
+    // MARK: - Constants
+    
+    private enum Constants {
+        static let matrixRoomIdPrefix = "!"
+        static let homeServerSeparator: Character = ":"
+    }
+    
+    // MARK: - Properties
+    
+    let localRoomID: String
+    let homeServer: String
+    
+    // MARK: - Setup
+    
+    init?(matrixID: String) {
+        guard MXTools.isMatrixRoomIdentifier(matrixID),
+            let (localRoomID, homeServer) = RoomIDComponents.getLocalRoomIDAndHomeServer(from: matrixID) else {
+            return nil
+        }
+        
+        self.localRoomID = localRoomID
+        self.homeServer = homeServer
+    }
+    
+    // MARK: - Private    
+
+    /// Extract local room id and homeserver from Matrix ID
+    ///
+    /// - Parameter matrixID: A Matrix ID
+    /// - Returns: A tuple with local room ID and homeserver.
+    private static func getLocalRoomIDAndHomeServer(from matrixID: String) -> (String, String)? {
+        let matrixIDParts = matrixID.split(separator: Constants.homeServerSeparator)
+        
+        guard matrixIDParts.count == 2 else {
+            return nil
+        }
+        
+        let localRoomID = matrixIDParts[0].replacingOccurrences(of: Constants.matrixRoomIdPrefix, with: "")
+        let homeServer = String(matrixIDParts[1])
+
+        return (localRoomID, homeServer)
+    }
+}