В этой статье:

Синхронное получение дельты ресурса

Асинхронное получение дельты ресурса

Получение дельты ресурса

Запрос может выполняться синхронно и асинхронно:

Синхронное получение дельты ресурса

Для получения дельты ресурса с помощью синхронного запроса создайте приложение «HHFWDeltaStream», в котором используются методы фреймворка:

Имя метода Краткое описание
initWithCredentials (_: host: environment: project: device:) Метод выполняет инициализацию фреймворка.
auth (_: password:) Метод выполняет аутентификацию пользователя по логину и паролю.
openBase (_: key:) Метод открывает соединение с базой данных по указанному пути.
resources (_: handler:) Метод получает схемы доступных ресурсов и автоматически создает в базе данных соответствующие таблицы.
deltaStream (_: deltaStreamCallParams: handler:) Метод загружает дельту в локальную базу данных.
getTablesName (_: resourceName: requestParams: tableName:) Метод возвращает наименование таблицы в локальной базе данных.
query (_: query:) Метод отправляет SQL-запрос к локальной базе данных.

Вспомогательные методы:

Имя метода Краткое описание
getURL (for:) Метод возвращает URL для файла с заданным именем в папке «Documents».
Тип возвращаемых данных: URL
getRecords (from:) Метод возвращает значение для ключа «records» из json-результата SQL-запроса к локальной базе данных.
Тип возвращаемых данных: [[String: Any]]?
getTableNames (from:) Метод возвращает массив значений для ключей «name» из результата метода getRecords.
Тип возвращаемых данных: [String]
parseServerJSONResponse (json:) Метод возвращает результат преобразования json-строки в словарь.
Тип возвращаемых данных: [String: Any]?
getResponseStatus (from:) Метод возвращает значение для ключа «status» из json-результата запроса.
Тип возвращаемых данных: String?
getTableNamesInDatabase (_: forResource: originalTableName:) Метод возвращает массив имен таблиц, которые удовлетворяют указанным параметрам: расположение базы данных в директории приложения, имя ресурса и искомой таблицы.
Тип возвращаемых данных: [String]

Приложение «HHFWDeltaStream» состоит из одного экрана, текстового представления «UITextView» и кнопок «UIButton»:

Примечание. При загрузке приложения выполняется аутентификация, кнопки недоступны. Если аутентификация выполнена успешно, то кнопки будут доступны и в текстовом поле появится надпись «Authentication and resources load success».

Для выполнения примера:

  1. Нажмите кнопку «Perform DeltaStream».

При нажатии на кнопку происходит запрос дельты для указанного ресурса. Результат выполнения запроса автоматически записывается в локальную базу данных.

  1. Нажмите кнопку «Perform SELECT».

При нажатии на кнопку выполняется SQL-запрос «SELECT * FROM table_name» к локальной базе данных.

Код приложения:

import UIKit
 
class ViewController: UIViewController {
 
    // Определим выходные переменные
    @IBOutlet weak var resultTextView: UITextView!
    @IBOutlet weak var deltaStreamButton: UIButton!
    @IBOutlet weak var queryButton: UIButton!
 
    // Переопределим метод
    override func viewDidLoad() {
        super.viewDidLoad()
        self.deactivateButtons()
        self.initializeFramework()
        self.auth {
            self.activateButtons()
            self.resultTextView.text = "Authentication success"
        }
    }
 
    // Зададим метод, который будет выполняться при нажатии на кнопку
    @IBAction func deltaStreamPressed(_ sender: UIButton) {
        let databaseName = "database.sqlite"
        if self.openDatabase(databaseName) {
            self.loadResourcesScheme(databaseName) {
                self.loadDelta(databaseName) { (jsonResult) in
                    self.resultTextView.text = String(format: "%@", jsonResult)
                }
            }
        }
    }
 
    @IBAction func selectFromTablePressed(_ sender: UIButton) {
        let databaseName = "database.sqlite"
        self.performSelect(databaseName) { (jsonResult) in
            self.resultTextView.text = jsonResult
        }
    }
 
    // Выполним инициализацию фреймворка
    private func initializeFramework() {
        let apiVersion: String = "v1"
        let host: String = "http://testmasterfmp.fsight.cloud/"
        let environment: String = "Leonid_environment"
        let project: String = "Leonid_project"
        let device: String = (UIDevice.current.identifierForVendor?.uuidString)!
        HHFWController.sharedInstance().initWithCredentials(
            apiVersion,
            host: host,
            environment: environment,
            project: project,
            device: device
        )
    }
 
    // Выполним аутентификацию
    private func auth(completion: @escaping ()->()) {
        let username: String = "Leonid"
        let password: String = "123123"
        HHFWController.sharedInstance().auth(username, password: password){ (jsonResult) in
            if let jsonDict = jsonResult as? NSDictionary,
                let status = jsonDict["status"] as? String, status == "ok" {
                print("Auth success")
                completion()
            } else {
                print("Auth error")
            }
        }
    }
 
    // Откроем или создадим базу данных
    private func openDatabase(_ databaseName: String) -> Bool {
        let fullDatabaseURL = self.getURL(for: databaseName)
        return HHFWController.sharedInstance().openBase(fullDatabaseURL.path, key: "")
    }
 
    // Загрузим схему ресурсов
    private func loadResourcesScheme(_ databaseName: String, completion: @escaping ()->()) {
        HHFWController.sharedInstance().resources(databaseName) { (jsonResult) in
            if let jsonDict = jsonResult as? NSDictionary,
                let status = jsonDict["status"] as? String, status == "ok" {
                print("Load resources success")
                completion()
            } else {
                print("Load resources error")
            }
        }
    }
 
    // Выполним запрос DeltaStream
    private func loadDelta(_ databaseName: String, completion: @escaping (NSDictionary)->()) {
        let resourceName = "study"
        let deltaStreamCallParams = DeltaStreamCallParams(defaultProperty: ())
        let fullDatabaseURL = self.getURL(for: databaseName)
        deltaStreamCallParams?.dataBasePath = fullDatabaseURL.path
        HHFWController.sharedInstance().deltaStream(resourceName, deltaStreamCallParams: deltaStreamCallParams) { (jsonResult) in
            if let jsonDict = jsonResult as? NSDictionary,
                let status = jsonDict["status"] as? String, status == "ok" {
                print("Load delta success")
                completion(jsonDict)
            } else {
                print("Load delta error")
            }
        }
    }
 
    // Выполним запрос SELECT * FROM table
    private func performSelect(_ databaseName: String, completion: (String?) -> ()) {
        let resourceName = "study"
        let tableName = "ET_TAB1"
 
        if let databaseTableName = self.getTableNamesInDatabase(databaseName, forResource: resourceName, originalTableName: tableName).first {
            let query = "SELECT * FROM `\(databaseTableName)`"
            let jsonResult = HHFWController.sharedInstance().query("/Documents/\(databaseName)", query: query)
            completion(jsonResult)
        }
    }
 
    // Получим имена таблиц в локальной базе данных
    private func getTableNamesInDatabase(_ databaseName: String, forResource resourceName: String, originalTableName tableName: String) -> [String] {
         let tableNames = HHFWController.sharedInstance().getTablesName("/Documents/\(databaseName)", resourceName: resourceName, requestParams: "", tableName: tableName)
        return self.getTableNames(from: tableNames)
    }
 
    // Зададим методы для отображения элементов пользовательского интерфейса приложения
    private func deactivateButtons() {
        self.deltaStreamButton.isEnabled = false
        self.queryButton.isEnabled = false
    }
 
    private func activateButtons() {
        self.deltaStreamButton.isEnabled = true
        self.queryButton.isEnabled = true
    }
 
    // Вызовем вспомогательные классы
    private func getURL(for fileName: String) -> URL {
        let paths: [URL] = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)
        let fileURL: URL = paths[0].appendingPathComponent(fileName)
        return fileURL
    }
 
    private func getRecords(from json: String?) -> [[String: Any]]? {
        var resultRecords: [[String: Any]]? = nil
        if let jsonString = json {
            let jsonDict = parseServerJSONResponse(json: jsonString)
            if self.getResponseStatus(from: jsonDict) == "ok" {
                if let result = jsonDict?["result"] as? [String: Any],
                    let database = result["database"] as? [String:Any],
                    let records = database["records"] as? [[String: Any]] {
                    resultRecords = records
                }
            }
        }
        return resultRecords
    }
 
    private func getTableNames(from json: String?) -> [String] {
        var resultTableNames: [String] = []
        if let records = getRecords(from: json) {
            for record in records {
                if let tableName = record["name"] as? String {
                    resultTableNames.append(tableName)
                }
            }
        }
        return resultTableNames
    }
 
    private func parseServerJSONResponse(json: String) -> [String: Any]? {
        guard let responseData = json.data(using: .utf8) else { return nil }
        return try? JSONSerialization.jsonObject(with: responseData, options: []) as! [String: Any]
    }
 
    func getResponseStatus(from json: [String: Any]?) -> String? {
        return json?["status"] as? String
    }
}

Асинхронное получение дельты ресурса

Для получения дельты ресурса с помощью асинхронного запроса создайте приложение «HHFWDeltaStreamAsync», в котором используются методы фреймворка:

Имя метода Краткое описание
initWithCredentials (_: host: environment: project: device:) Метод выполняет инициализацию фреймворка
auth (_: password:) Метод выполняет аутентификацию пользователя по логину и паролю
openBase (_: key:) Метод открывает соединение с базой данных по указанному пути
resources (_: handler:) Метод получает схемы доступных ресурсов и автоматически создает в базе данных соответствующие таблицы
deltaStreamAsync (_: withCache: deltaStreamCallParams: handler:) Метод загружает дельту в локальную базу данных
getTablesName (_: resourceName: requestParams: tableName:) Метод возвращает наименование таблицы в локальной базе данных
query (_: query:) Метод отправляет SQL-запрос к локальной базе данных.

Вспомогательные методы асинхронного получения дельты ресурса аналогичны вспомогательным методам получения дельты ресурса.

Приложение «HHFWDeltaStreamAsync» состоит из одного экрана, текстового представления «UITextView» и кнопок «UIButton»:

Примечание. При загрузке приложения выполняется аутентификация, кнопки недоступны. Если аутентификация выполнена успешно, то кнопки будут доступны, и в текстовом поле появится надпись «Authentication and resources load success».

Для выполнения примера:

  1. Нажмите кнопку «Perform DeltaStream Async».

При нажатии на кнопку происходит асинхронный запрос дельты для указанного ресурса. Результат выполнения запроса автоматически записывается в локальную базу данных.

  1. Нажмите кнопку «Perform SELECT».

При нажатии на кнопку выполняется SQL-запрос «SELECT * FROM table_name» к локальной базе данных.

Код приложения:

import UIKit
 
class ViewController: UIViewController {
 
    // Определим выходные переменные
    @IBOutlet weak var resultTextView: UITextView!
    @IBOutlet weak var deltaStreamButton: UIButton!
    @IBOutlet weak var queryButton: UIButton!
 
    // Переопределим метод
    override func viewDidLoad() {
        super.viewDidLoad()
        self.deactivateButtons()
        self.initializeFramework()
        self.auth {
            self.activateButtons()
            self.resultTextView.text = "Authentication success"
        }
    }
    // Зададим метод, который будет выполняться при нажатии на кнопку
    @IBAction func deltaStreamPressed(_ sender: UIButton) {
        let databaseName = "database.sqlite"
        if self.openDatabase(databaseName) {
            self.loadResourcesScheme(databaseName) {
                self.loadDelta(databaseName) { (jsonResult) in
                    self.resultTextView.text = String(format: "%@", jsonResult)
                }
            }
        }
    }
    @IBAction func selectFromTablePressed(_ sender: UIButton) {
        let databaseName = "database.sqlite"
        self.performSelect(databaseName) { (jsonResult) in
            self.resultTextView.text = jsonResult
        }
    }
 
    // Выполним инициализацию фреймворка
    private func initializeFramework() {
        let apiVersion: String = "v1"
        let host: String = "http://testmasterfmp.fsight.cloud/"
        let environment: String = "DocumentationExampleEnv"
        let project: String = "DocumentationExampleProj"
        let device: String = (UIDevice.current.identifierForVendor?.uuidString)!
        HHFWController.sharedInstance().initWithCredentials(
            apiVersion,
            host: host,
            environment: environment,
            project: project,
            device: device
        )
    }
    // Выполним аутентификацию
    private func auth(completion: @escaping ()->()) {
        let username: String = "test"
        let password: String = "test123"
        HHFWController.sharedInstance().auth(username, password: password){ (jsonResult) in
            if let jsonDict = jsonResult as? NSDictionary,
                let status = jsonDict["status"] as? String, status == "ok" {
                print("Auth success")
                completion()
            } else {
                print("Auth error")
            }
        }
    }
 
    // Откроем или создадим базу данных
    private func openDatabase(_ databaseName: String) -> Bool {
        let fullDatabaseURL = self.getURL(for: databaseName)
        return HHFWController.sharedInstance().openBase(fullDatabaseURL.path, key: "")
    }
 
    // Загрузим схему ресурсов
    private func loadResourcesScheme(_ databaseName: String, completion: @escaping ()->()) {
        HHFWController.sharedInstance().resources(databaseName) { (jsonResult) in
            if let jsonDict = jsonResult as? NSDictionary,
                let status = jsonDict["status"] as? String, status == "ok" {
                print("Load resources success")
                completion()
            } else {
                print("Load resources error")
            }
        }
    }
    // Выполним запрос DeltaStreamAsync
    private func loadDelta(_ databaseName: String, completion: @escaping (NSDictionary)->()) {
        let resourceName = "FRUITS"
        let deltaStreamCallParams = DeltaStreamCallParams(defaultDb: ())
        let fullDatabaseURL = self.getURL(for: databaseName)
        deltaStreamCallParams?.dataBasePath = fullDatabaseURL.path
        HHFWController.sharedInstance().deltaStreamAsync(resourceName, withCache: true, deltaStreamCallParams: deltaStreamCallParams) { (jsonResult) in
            if let jsonDict = jsonResult as? NSDictionary,
                let status = jsonDict["status"] as? String, status == "ok" {
                print("Load delta success")
                completion(jsonDict)
            } else {
                print("Load delta error")
            }
        }
    }
    // Выполним запрос SELECT * FROM table
    private func performSelect(_ databaseName: String, completion: (String?) -> ()) {
        let resourceName = "FRUITS"
        let tableName = "output_table"
        if let databaseTableName = self.getTableNamesInDatabase(databaseName, forResource: resourceName, originalTableName: tableName).first {
            let query = "SELECT * FROM `\(databaseTableName)`"
            let jsonResult = HHFWController.sharedInstance().query("/Documents/\(databaseName)", query: query)
            completion(jsonResult)
        }
    }
    // Получим имена таблиц в локальной базе данных
    private func getTableNamesInDatabase(_ databaseName: String, forResource resourceName: String, originalTableName tableName: String) -> [String] {
        let tableNames = HHFWController.sharedInstance().getTablesName("/Documents/\(databaseName)", resourceName: resourceName, requestParams: "", tableName: tableName)
        return self.getTableNames(from: tableNames)
    }
    // Зададим методы для отображения элементов пользовательского интерфейса приложения
    private func deactivateButtons() {
        self.deltaStreamButton.isEnabled = false
        self.queryButton.isEnabled = false
    }
    private func activateButtons() {
        self.deltaStreamButton.isEnabled = true
        self.queryButton.isEnabled = true
    }
    // Вызовем вспомогательные классы
    private func getURL(for fileName: String) -> URL {
        let paths: [URL] = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)
        let fileURL: URL = paths[0].appendingPathComponent(fileName)
        return fileURL
    }
    private func getRecords(from json: String?) -> [[String: Any]]? {
        var resultRecords: [[String: Any]]? = nil
        if let jsonString = json {
            let jsonDict = parseServerJSONResponse(json: jsonString)
            if self.getResponseStatus(from: jsonDict) == "ok" {
                if let result = jsonDict?["result"] as? [String: Any],
                    let database = result["database"] as? [String:Any],
                    let records = database["records"] as? [[String: Any]] {
                    resultRecords = records
                }
            }
        }
        return resultRecords
    }
    private func getTableNames(from json: String?) -> [String] {
        var resultTableNames: [String] = []
        if let records = getRecords(from: json) {
            for record in records {
                if let tableName = record["name"] as? String {
                    resultTableNames.append(tableName)
                }
            }
        }
        return resultTableNames
    }
    private func parseServerJSONResponse(json: String) -> [String: Any]? {
        guard let responseData = json.data(using: .utf8) else { return nil }
        return try? JSONSerialization.jsonObject(with: responseData, options: []) as! [String: Any]
    }
    func getResponseStatus(from json: [String: Any]?) -> String? {
        return json?["status"] as? String
    }
}

См. также:

Примеры использования iOS-фреймворка | Примеры работы с ресурсами