[iOS] 서버통신 연결하기

1. API 명세서 확인하기

2. PostMan 테스트 하기

 

Response 형태를 직접 확인하기 

 

성공 - 200 회원가입 성공

실패 - 409 Duplicate : 해당 정보가 있을때

서버 통신 코드를 작성하기 전 사전 준비 과정

3. HTTP 통신을 위한 plist 설정 (http 서버로 통신을 시도하는 경우 설정해주면 됨! https는 안해줘도 됨)

보통은 http 서버와 통신하려고 하면 에러가 발생합니다. Apple 측에서 앱 자체의 보안성을 위해서 ATS(App Transport Security)라는 정책을 통해 기본적으로 https 통신을 하도록 유도하고 있기 때문! 

 

4. APIConstants.swift 작성 : API 주소를 모아 놓은 파일

자원 (위치, 어디에) : URI

Base URL과 나머지 경로를 나누어 관리하면 편함!

행위 ( 어떤 것을 할 것인지 ) : HTTP Method

표현, 메세지 (이런 데이터가 있다) : JSON

5. NetworkResult.swift 작성 ( 서버 통신 결과를 처리할 열거형 )

서버 통신 결과를 처리하기 위한 파일

서버통신을 할때 밑의 과정을 반복하면됨

6. 데이터 모델 생성 ( 서버통신으로 받은 JSON 데이터를 Swift로 바꿀 구조체 모델)

- 넘겨 받은 JSON을 Swift 객체 형태로 잘 사용할 수 있도록 Data Model을 생성

- 기본적으로 네트워크 통신결과로 넘어오는 JSON 데이터를 앱이 이해할 수 있도록 swift 바꾸어야함 ( decode 과정 )

 

Encodable, Decodable 프로토콜을 묶은 것 = Codable을 사용하면 됨!

따로 두개의 프로토콜을 채택하지 않아도 됨

Encodable : 데이터 모델을 Encode해서 data(JSON)으로 변환하려면 Encodable이라는 프로토콜을 채택해야함

Decodable : data(JSON)을 Decode해서 데이터 모델로 만드려면 Decodable이라는 프로토콜을 채택해야함

데이터 부분이 옵셔널인 이유 : 로그인이 성공할때는 data가 넘어오고, 실패했을 때는 data가 안넘어오기 때문!

 

7. Service(Request - Response) 코드 작성

: (Request를 만들고 보낸 후 Response를 받고 해독하는 서버 통신코드가 있는 클래스 )

import Foundation
import Alamofire
//(1) 라이브러리 추가

class UserService {
    
    static let shared = UserService()
//(2)싱글통 객체를 선언해서 앱 어디에서든지 접근가능하도록 한다
    private init() {}
    
    func login(name: String, email: String, password: String, completion: @escaping(NetworkResult<Any>) -> Void)
    {
        let url = APIConstants.loginURL //통신할 API 주소
        
        //HTTP Headers : 요청 헤더
        let header : HTTPHeaders = ["Content-Type" : "application/json"]
        
        //요청 바디
        let body : Parameters = [
            "name" : name,
            "email" : email,
            "password" : password
        ]
        
        //요청서 //Request 생성
        //통신할 주소, HTTP메소드, 요청방식, 인코딩방식, 요청헤더
        let dataRequest = AF.request(url,
                                    method: .post,
                                    parameters: body,
                                    encoding: JSONEncoding.default,
                                    headers: header)
                                    
        //request 시작 ,responseData를 호출하면서 데이터 통신 시작 
        dataRequest.responseData{
            response in //데이터 통신의 결과가 response에 담기게 된다
            switch response.result {
            case .success: //데이터 통신이 성공한 경우에 
                guard let statusCode = response.response?.statusCode else {return}
                guard let value = response.value else {return}
                
                let networkResult = self.judgeStatus(by: statusCode, value)
                completion(networkResult)
            case .failure:
                completion(.networkFail)
            }
        }
    }
    private func judgeStatus(by statusCode: Int, _ data: Data) -> NetworkResult<Any> {
        switch statusCode {
        case ..<300 : return isVaildData(data: data) 
        case 400..<500 : return .pathErr
        case 500..<600 : return .serverErr
        default : return .networkFail
        }
    }
    //통신이 성공하고 원하는 데이터가 올바르게 들어왔을때 처리하는 함수
    private func isVaildData(data: Data) -> NetworkResult<Any> {
        let decoder = JSONDecoder() //서버에서 준 데이터를 Codable을 채택
        guard let decodedData = try? decoder.decode(LoginResponse.self, from: data)
        //데이터가 변환이 되게끔 Response 모델 구조체로 데이터를 변환해서 넣고, 그 데이터를 NetworkResult Success 파라미터로 전달
        else { return .pathErr }
        
        return .success(decodedData as Any)
    }
}

 

8. Service(Request - Response) 코드 호출

: 뷰컨트롤러 ( 서버 통신코드를 뷰컨트롤러에서 호출)

import UIKit

class ViewController: UIViewController {

    @IBOutlet weak var nameTextField: UITextField!
    @IBOutlet weak var emailTextField: UITextField!
    @IBOutlet weak var passwordTextField: UITextField!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
    }

    // 로그인 버튼을 눌렀을 때 로그인 서버 통신 함수를 호출합니다.
    @IBAction func loginButtonTapped(_ sender: Any) {
        print("로그인")
        login()
    }
}

extension ViewController {
    
    // 서버 통신 코드를 실제로 뷰 컨트롤러에서 호출해서 사용하는 부분입니다.
    func login() {
        
        // 각각의 텍스트 필드의 있는 값을 받아옵니다.
        guard let name = nameTextField.text else { return }
        guard let email = emailTextField.text else { return }
        guard let password = passwordTextField.text else { return }
        
        // 서버 통신 서비스 코드를 싱글톤 변수를 통해서 접근하고 있네요.
        // 호출 후에 받은 응답을 가지고, 적절한 처리를 해주고 있습니다.
        UserService.shared.login(
            name: name,
            email: email,
            password: password) { response in
            switch response {
            case .success(let data):
                guard let data = data as? LoginResponse else { return }
                print(data)
                self.alert(message: data.message)
            case .requestErr(let err):
                print(err)
            case .pathErr:
                print("pathErr")
            case .serverErr:
                print("serverErr")
            case .networkFail:
                print("networkFail")
            }
        }
    }
    
    // 알림창을 띄우는 함수입니다.
    func alert(message: String) {
        let alertVC = UIAlertController(title: message, message: nil, preferredStyle: .alert)
        let okAction = UIAlertAction(title: "확인", style: .default, handler: nil)
        alertVC.addAction(okAction)
        present(alertVC, animated: true)
    }
}

총정리

출처 : SOPT30 - 김태현 파트장님 4주차 세미나

출처 :SOPT30 - 김태현 파트장님 4주차 세미나