[iOS+Network] Swift를 곁들인 URL 구조 분석

URL 분석

구조

URL은 기본적으로 다음과 같은 구조로 이루어져 있다.

scheme://[userinfo@]host[:port][/path][?query][#fragment]

 

---

 

scheme

해당 부분에는 주로 프로토콜을 사용한다. 우리가 사용하는 프로토콜을 예로 들어보면 주로 http 또는 https 프로토콜이 위치한다. 프로토콜이란 어떤 방식으로 자원에 접근할 것인가를 정한 약속 또는 규칙이라고 할 수 있다. htttps는 http에 강력한 보안을 추가한 것이라고 생각하면 된다.

 

---

userinfo

URL에 사용자 정보를 포함해서 인증을 할 수 있는데, 거의 사용하지 않는다.

 

---

 

host

도메인 이름 또는 IP 주소가 위치하게 된다.

 

---

 

port

http는 기본적으로 80 포트 번호를 사용하고, https는 443 포트 번호를 사용한다. 포트 번호는 생략이 가능하다.

 

---

 

path

리소스 경로(path), 계층적 구조를 나타낸다.

 

 

---

 

query

- key = value의 형태이고, 형태는 ?로 시작하고 &로 query를 여러 개 추가할 수 있다.

- 주로 query parameter, query string이라는 명칭으로 부르고, value 값은 string(문자)의 형태로 인식된다.

 

---

 

fragment

서버에 직접 전송하는 정보는 아니고, html 내부 북마크 용도로 사용된다.

 

 

---

 

Swift의 URLComponents

URLComponents

URLSession을 사용하다보면 URLComponents를 만나게 된다. URLComponents는 Struct 타입이며, 해당 구조체를 이용해서 이리저리 만져 모듈화를 하기도 하고, Alamofire나 Moya를 사용할 때 세부적인 컨트롤도 하게 된다.

 

기본적으로 URLSession을 사용하면 dataTask의 인자로 URL을 받아서 사용하게 될텐데 URL 주소를 직접 담아서 사용할 수도 있겠지만 분리해서도 확인해볼 수 있다.

let url = URL(string: "https://api.themoviedb.org/3/search/person?api_key=YOUR_KEY&language=en-US&query=\(query)&page=1&include_adult=false&region=ko-KR")!

URLSession.shared.dataTask(url)

 

SubComponent로 분리해서 보면 위에서 확인한 URL 구조를 이해해볼 수 있을 것이다. 쿼리 아이템은 여러 개가 될 수 있기 때문에 Array로 받을 수 있게 만들어놓은 것 같다.

let scheme = "https"
let host = "api.themoviedb.org"
let path = "/3/search/person"

let language = "ko-KR"
let key = ""
let query = query.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed)

var component = URLComponents()
component.scheme = scheme
component.host = host
component.path = path
component.queryItems = [
    URLQueryItem(name: "api_key", value: key),
    URLQueryItem(name: "query", value: query),
    URLQueryItem(name: "page", value: "1"),
    URLQueryItem(name: "region", value: language),
]

URLSession.shared.dataTask(with: component.url!)

 

그 외에 더 자세한 내용이나 구성을 확인하고 싶다면 공식 문서를 확인하도록 하자~ 이렇게 개념과 코드가 매칭이 되니까 신기하고 재밌는 것 같다! :-)