Web Develop basic

📖 Web?

인터넷에 연결된 컴퓨터를 통해 사람들이 정보를 공유할 수 있는 정보 공간을 의미합니다.

ex) web site, API, UserInterface(Chrome,Safari 등)

✅ Web의 기본 3요소

• URI, HTTP, HTML

URI (Uniform Resource Identifier)

//

HTTP(Hypertext Transfer Protocol)

웹을 통해 데이터를 전송하는 데 사용되는 프로토콜입니다. www의 기반이며 클라이언트와 서버간의 통신을 허용합니다. GET,POST,PUT,DELETE... 등을 사용합니다.

HTML(Hypertext Markup Language)

웹 페이스를 만드는 데 사용되는 표준 마크업 언어입니다. text,image,link 등을 포함하여 웹페이지의 구조와 컨텐츠를 제공합니다. HTML문서는 웹 브라우저에서 해석되어 사용자가 볼 수 있도록 시각적으로 표현됩니다.

---

📖 REST API

REST(Representational State Transfer : 자원의 상태 전달) - 네트워크 아키텍처

REST는 웹 서비스를 구축하기 위한 아키텍처 유형입니다. REST API는 서로 다른 소프트웨어 시스템이 표준 HTTP 메서드 및 엔드포인트를 사용하여 인터넷을 통해 데이터를 통신하고 교환하는 방법입니다.

URL을 사용하여 데이터에 엑세스하고 조작하므로 개발자가 확장,유지,관리 가능한 웹 서비스를 간단하고 유연하게 구축할 수 있습니다. 웹앱, 앱을 구축하고 다양한 시스템을 통합하고 테스트 및 업데이트가 쉬워 개발 팀에 많이 사용됩니다.

REST한 API는 다음과 같은 조건을 만족해야 합니다.

1. 클라이언트와 서버가 서로 독립적으로 분리 되어 있어야 한다.
2. 요청에 대해 클라이언트의 상태를 서버에 저장하지 않는다. -> 서버는 클라이언트 요청에 항상 새롭게 나가야한다.
3. 클라이언트는 서버의 응답을 Cache(임시 저장) 할 수 있어야한다. -> Cache통해 응답을 재사용할 수 있어야 서버의 부하를 낮춘다.
4. 서버와 클라이언트 사이에, 방화벽, 게이트웨이, Proxy등 다양한 계층 형태로 구성, 확장이 가능해야한다.
5. 인터페이스의 일관성을 지키고, 아키텍처를 단순화시켜 작은 단위로 분리하여, 클라이언트, 서버가 독립적으로 개선 될 수 있어야 한다.

🤔 REST를 잘 적용했는지 확인은 어떻게 할까?

인터페이스의 일관성이 잘 지켜졌는지 따라, REST를 잘 사용했는지 판단할 수 있습니다.

1. 자원의 식별

웹 기반의 REST에서는 리소스 접근할 때 URI를 사용합니다.

**ex) https://www.naver.com/user/999

여기서 Resource : user, 식별자 : 999와 같은 정보가 담겨있는 것을 확인할 수 있습니다.

2. 메시지를 통한 리소스 조작

Web에서는 다양한 방식으로 데이터를 전달할 수 있습니다. 어떠한 타입의 데이터인지 전달 하기 위해 HTTP Header부분에 content-type을 통해 데이터의 타입을 지정할 수 있습니다. 또한 리소스 조작을 위해 데이터 전체를 포함하지 않고 이를 메시지로 전달합니다.

HTTP메시지는 head, body로 이루어져있습니다. 주로 내용은 body에 있습니다.

ex) 유저의 id를 클라이언트와 주고 받을 때, 서버의 리소스 변경으로 기존 id라는 정보를 userId, clientId 등으로 바뀌게 된다면 에러가 나게 됩니다.

예시에 나온 내용을 방지 하기 위해 메시지 형태로 데이터를 주고 받으며, client-server가 독립적으로 확장할 수 있도록 합니다.

3. 자기서술적 메시지

요청하는 데이터가 어떻게 처리 되어져야 하는지 충분한 데이터를 포함 할 수 있어야 합니다. HTTP기반의 REST에서는 HTTP Method와 Header 정보, URI의 포함되는 정보로 표현할 수 있습니다.

GET : {{BASEURL}}/user/100 -> 유저의 정보 요청
POST : {{BASEURL}}/user/create -> 유저 정보 생성
PUT : {{BASEURL}}/user/100 -> 유저 정보 수정
DELETE : {{BASEURL}}/user/100 -> 유저 정보 삭제

---

📖 URI 설계 패턴

URI(Uniform Resource Identifier)

웹에서 리소스를 식별하고 찾는데 사용되는 문자열입니다. 리소스를 고유하게 식별하는 방법입니다. URI는 웹 브라우저, 검색엔진 등 소프트웨어 응용프로그램에서 웹의 리소스를 찾고 액세스 하는 데 사용됩니다. -> 인터넷에서 특정 자원을 나타내는 주소 값이며 해당 값은 유일합니다.

요청 -> {{baseurl}}/resource/100
응답 -> recipe.pdf

리소스 식별자-> 특정 사이트, 동영상 목록 등 모든 정보에 접근 할 수 있는 정보

URL(Uniform Resource Locator)

인터넷 상에서의 자원, 특정 파일이 어디에 위치하는지 식별하는 주소입니다.
요청 : {{baseurl}}/recipe.pdf

URL은 URI의 하위 개념입니다.

설계원칙

• 슬래시 구분자( / )는 계층 관계를 나타내는데 사용합니다. ex) {{baseurl}}/user/desktop/web
• URI 마지막 문자로 ( / )는 포함하지 않는다.
• 하이픈( - )은 URI 가독성을 높이는데 사용한다. ex) {{baseurl}}/user/desktop/web-client
• 밑줄은( _ ) 사용하지 않는다.
• URI 경로에는 소문자가 적합하다.
• 파일 확장자는 URI에 표시하지 않는다. ex) {{baseurl}}/user/desktop/recipe.pdf ( x )
• 프로그래밍 언어에 의존적인 확장자, 경로를 사용하지 않는다. -> 특정 언어나 프레임워크에 문제가 있는 경우도 있기 때문에 굳이 외부에 노출하지 않는다.
• 세션 ID를 포함하지 않는다. -> 상대방이 탈취해야 사용할 수 있기 때문에
• 프로그래밍 언어의 메서드 네임을 이용하지 않는다. -> 노출을 해서 좋을것이 없다.
• URI에 CRUD 기능을 나타내면 안된다 -> 위와 같은 내용이다.
• 명사에 단수형 보다는 복수형을 사용해야 한다. 컬렉션에 대한 표현은 복수로 사용한다.
• 컨트롤러 이름으로는 동사나 동사구를 사용한다.
• 경로 부분 중 변하는 값은 유일한 값으로 대체하여야 한다. -> ex){{baseurl}}/user/100 -> {{baseurl}}/user/{user-id}

🔥 지켜야 할게 너무 많은데??

생각해 봤더니 내부에 있는 로직에 관한 것과 상수 사용하는 것들이 대부분이라 크게 어려운 것은 없어보인다.

📖 HTTP Protocol?

HTTP(Hyper Text Transfer Protocol) 로 웹에서 데이터를 주고 받는 프로토콜입니다. 실제로는 HTML,XML,JSON,Image,Voice,Video,JS,PDF 등등 다양한 컴퓨터에서 다룰 수 있는 것은 모두 전송 가능합니다. HTTP는 TCP를 기반으로 한 REST의 특징을 모두 구현하고 있는 Web기반 프로토콜 입니다.

HTTP 특징

HTTP는 반드시 request를 주고 response를 받는 통신 방법 입니다. 클라이언트가 서버에 요청 메세지를 작성하고 응답을 대기합니다. 서버는 요청을 대기하고 있다가 요청을 받고 처리를 한 이후에 응답 메세지를 송신합니다. 클라이언트가 응답 메세지를 수신하면서 통신을 마칩니다.

요청대기 및 응답 대기의 과정에서 일정기간 동안 답이 없으면 대기를 마칩니다.

HTTP 요청 주요 메서드

	역할	CRUD	멱등성	안정성	PathVariable	QueryParameter	body
GET	리소스 읽기	R	O	O	O	O	X
POST	리소스 생성,추가	C	X	X	O	D	O
PUT	리소스 생성, 갱신	C,U	O	X	O	D	O
DELETE	리소스 삭제	D	O	X	O	O	X

HTTP Status code

1xx -> 처리가 계속 되는 상태. 클라이언트는 요청을 계속 하거나 재요청 요구
2xx -> 성공
3xx -> 다른 리소스로 리다이렉트 -> Response의 새로운 주소로 다시 요청 요구
4xx -> client error -> client측의 잘못된 요청 및 환경
5xx -> 서버 처리중 에러가 발생한 상태이며 서버 db구조에러 등의 이유인 경우에 발생