Пример работы с продуктом «Форсайт. Аналитическая платформа»

Для работы с продуктом «Форсайт. Аналитическая платформа» создайте приложение «HHFWFap», в котором используются методы фреймворка:

Имя метода Краткое описание
initWithCredentials (_: host: environment: project: device:) Метод выполняет инициализацию фреймворка.
auth (_: password:) Метод выполняет аутентификацию пользователя по логину и паролю.
openBase (_: key:) Метод открывает соединение с базой данных по указанному пути.
resources (_: handler:) Метод получает схемы доступных ресурсов и автоматически создает в базе данных соответствующие таблицы.
request (_: requestCallParams: handler:) Метод отправляет универсальный запрос к ресурсу без загрузки в базу данных.

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

Имя метода Краткое описание
getURL (for:) Метод возвращает URL для файла с заданным именем в папке «Documents».
Тип возвращаемых данных: URL

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

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

Для выполнения примера нажмите на кнопку «Connect FAP».

При нажатии на кнопку будет отправлен POST-запрос к продукту «Форсайт. Аналитическая платформа» и возвращен ответ с сервера мобильной платформы.

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

import UIKit
 
class ViewController: UIViewController {
 
    // Определим выходные переменные
    @IBOutlet weak var resultTextView: UITextView!
    @IBOutlet weak var connectFapButton: UIButton!
 
    // Переопределим метод
    override func viewDidLoad() {
        super.viewDidLoad()
        self.deactivateButtons()
        self.initializeFramework()
        self.auth {
            let databaseName = "database.sqlite"
            if self.initializeDatabase(databaseName) {
                self.loadResourcesScheme(databaseName) {
                    self.activateButtons()
                    self.resultTextView.text = "Authentication and load resources success"
                }
            }
        }
    }
 
    // Зададим метод, который будет выполняться при нажатии на кнопку
     @IBAction func connectFapPressed(_ sender: UIButton) {
        self.connectFap { (jsonResult) in
            self.resultTextView.text = String(format: "%@", 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 initializeDatabase(_ 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")
            }
        }
    }
 
    // Выполним запрос Get
    private func connectFap(completion: @escaping (NSDictionary)->()) {
        let resourceName = "Fap"
        let requestCallParams = RequestCallParams(defaultProperty: ())
        requestCallParams?.headers = ["Content-Type": "application/json",
                                      "Accept": "application/json",
                                      "Content-Encoding": "utf-8"]
        requestCallParams?.data = "{\"OpenMetabase\":{\"tDef\":{\"id\":\"TEST_INV_X\"},\"tCreds\":{\"user\":{\"id\":\"TEST_INV_X\"},\"pass\":\"TEST_INV_X\"},\"tArg\": \"\"}}"
        HHFWController.sharedInstance().request(resourceName, requestCallParams: requestCallParams) { (jsonResult) in
            if let jsonDict = jsonResult as? NSDictionary,
                let status = jsonDict["status"] as? String, status == "ok" {
                print("Connect FAP success")
                completion(jsonDict)
            } else {
                print("Connect FAP error")
            }
        }
    }
 
    // Вызовем вспомогательные классы
    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 deactivateButtons() {
        self.connectFapButton.isEnabled = false
    }
 
    private func activateButtons() {
        self.connectFapButton.isEnabled = true
    }
}

См. также:

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