728x90
반응형
728x90
반응형

HTTP(HyperText Transport Protocol)

 웹 서버와 클라이언트 간의 문서를 교환하기 위한 통신 규약

 HTTP는 웹에서만 사용하는 protocol TCP/IP 기반으로 서버와 클라이언트 간의 요청과 응답을 전송


 HTTP 0.9 -> HTTP 1.0 -> HTTP 1.1
 HTTP 0.9 : 읽기 전용. GET 요청만 가능했습니다. 
 HTTP 1.0 : POST, HEAD 가 추가 되었습니다. 즉 클라이언트에서 서버로의  데이터 전송도 가능해 졌습니다. 
 HTTP 1.1(최신 버전) : PUT,DELETE,TRACE 등 추가 되었습니다. 클라이언트는 서버로의 데이터 전송 뿐만 아니라 변경, 삭제 까지 가능하게 되었습니다.


클라이언트 요청[편집]

GET /restapi/v1.0 HTTP/1.1
Accept: application/json
Authorization: Bearer UExBMDFUMDRQV1MwMnzpdvtYYNWMSJ7CL8h0zM6q6a9ntw

서버 응답[편집]

HTTP/1.1 200 OK
Date: Mon, 23 May 2005 22:38:34 GMT
Content-Type: text/html; charset=UTF-8
Content-Encoding: UTF-8
Content-Length: 138
Last-Modified: Wed, 08 Jan 2003 23:11:55 GMT
Server: Apache/1.3.3.7 (Unix) (Red-Hat/Linux)
ETag: "3f80f-1b6-3e1cb03b"
Accept-Ranges: bytes
Connection: close

<html>
<head>
  <title>An Example Page</title>
</head>
<body>
  Hello World, this is a very simple HTML document.
</body>
</html>

응답 코드[편집]

클라이언트가 서버에 접속하여 어떠한 요청을 하면, 서버는 세 자리 수로 된 응답 코드와 함께 응답한다. HTTP의 응답 코드는 다음과 같다.

코드메시지설명
1XXInformational(정보)정보 교환.
100Continue클라이언트로부터 일부 요청을 받았으니 나머지 요청 정보를 계속 보내주길 바람. (HTTP 1.1에서 처음 등장)
101Switching Protocols서버는 클라이언트의 요청대로 Upgrade 헤더를 따라 다른 프로토콜로 바꿀 것임. (HTTP 1.1에서 처음 등장)
2XXSuccess(성공)데이터 전송이 성공적으로 이루어졌거나, 이해되었거나, 수락되었음.
200OK오류 없이 전송 성공.
202Accepted서버가 클라이언트의 요청을 수락함.
203Non-authoritavive Information서버가 클라이언트 요구중 일부만 전송.
204Non Content클라이언트의 요구를 처리했으나 전송할 데이터가 없음.
205Reset Content새 문서 없음. 하지만 브라우저는 문서 창을 리셋해야 함. (브라우저가 CGI 폼 필드를 전부 지우도록 할 때 사용됨.) (HTTP 1.1에서 처음 등장)
206Partial Content클라이언트가 Range 헤더와 함께 요청의 일부분을 보냈고 서버는 이를 수행했음. (HTTP 1.1에서 처음 등장)
3XXRedirection(방향 바꿈)자료의 위치가 바뀌었음.
300Multiple Choices최근에 옮겨진 데이터를 요청.
301Moved Permanently요구한 데이터를 변경된 URL에서 찾았음.
302Moved Permanently요구한 데이터가 변경된 URL에 있음을 명시. 301과 비슷하지만 새 URL은 임시 저장 장소로 해석됨.

[8]

303See Other요구한 데이터를 변경하지 않았기 때문에 문제가 있음.
304Not modified클라이언트의 캐시에 이 문서가 저장되었고 선택적인 요청에 의해 수행됨 (보통 지정된 날짜보다 더 나중의 문서만을 보여주도록 하는 If-Modified-Since 헤더의 경우). [9]
305Use Proxy요청된 문서는 Location 헤더에 나열된 프록시를 통해 추출되어야 함. (HTTP 1.1에서 처음 등장)
307Temporary Redirect자료가 임시적으로 옮겨짐.
4XXClient Error(클라이언트 오류)클라이언트 측의 오류. 주소를 잘못 입력하였거나 요청이 잘못 되었음.
400Bad Request요청 실패. 문법상 오류가 있어서 서버가 요청사항을 이해하지 못함, [10]
401.1Unauthorized권한 없음 (접속실패). 서버에 로그온 하려는 요청사항이 서버에 들어있는 권한과 비교했을 때 맞지 않음. [11]
401.2Unauthorized권한 없음 (서버설정으로 인한 접속 실패). 서버에 로그온 하려는 요청사항이 서버에 들어있는 권한과 비교했을 때 맞지않음. [12]
401.3Unauthorized권한 없음 (자원에 대한 ACL에 기인한 권한 없음). 클라이언트가 특정 자료에 접근할 수 없음. [13]
401.4Unauthorized권한 없음 (필터에 의한 권한 부여 실패). 서버에 접속하는 사용자들을 확인하기 위해 설치한 필터 프로그램이 있음. [14]
401.5Unauthorized권한 없음 (ISA PI/CGI 애플리케이션에 의한 권한부여 실패). 이용하려는 서버의 주소에 ISA PI나 CGI프로그램이 설치되어 있고, 권한을 부여할 수 없음. [15]
402Payment Required예약됨.
403.1Forbidden금지 (수행접근 금지). 수행시키지 못하도록 되어있는 디렉터리 내의 실행 파일을 수행하려고 하였음.
403.2Forbidden금지 (읽기 접근 금지). 접근한 디렉터리에 가용한 기본 페이지가 없음. [16]
403.4Forbidden금지 (SSL 필요함). 접근하려는 페이지가 SSL로 보안유지 되고 있음. [17]
403.5Forbidden금지 (SSL 128필요함). 페이지가 128비트의 SSL로 보안유지 되고 있음. [18]
403.6Forbidden금지 (IP 주소 거부됨). 사용자가 허용되지 않은 IP로부터 접근함.
403.7Forbidden금지 (클라이언트 확인 필요). 클라이언트가 자료에 접근할 수 있는지 확인 요함. [19]
403.8Forbidden금지 (사이트 접근 거부됨). 서버가 요청사항을 수행하고 있지 않거나, 해당 사이트에 접근하는 것이 허락되지 않음.
403.9Forbidden접근금지 (연결된 사용자수 과다). 서버가 BUSY 상태에 있어서 요청을 수행할 수 없음.
403.10Forbidden접근금지 (설정이 확실 하지 않음).
403.11Forbidden접근금지 (패스워드 변경됨). 잘못된 암호를 입력했음.
403.12Forbidden접근금지(Mapper 접근 금지됨). 클라이언트 인증용 맵이 해당 웹 사이트에 접근하는 것이 거부됨.
404Not Found문서를 찾을 수 없음. 서버가 요청한 파일이나 스크립트를 찾지 못함.
405Method not allowed메서드 허용 안됨. 요청 내용에 명시된 메서드를 수행하기 위해 해당 자원의 이용이 허용되지 않음. [20]
406Not Acceptable받아들일 수 없음. [21]
407Proxy Authentication Required프록시 서버의 인증이 필요함. [22]
408Request timeout요청 시간이 지남.
409Conflict요청을 처리하는 데 문제가 있음. 보통 PUT 요청과 관계가 있다. 보통 다른 버전의 파일을 업로드할 경우 발생함. (HTTP 1.1에서 새로 등장)
410Gone영구적으로 사용할 수 없음.
411Length Required클라이언트가 헤더에 Content-Length를 포함하지 않으면 서버가 처리할 수 없음.(HTTP 1.1에서 새로 등장)
412Precondition Failed선결조건 실패. 헤더에 하나 이상의 선결조건을 서버에서 충족시킬 수 없음. [23]
413Request entity too large요청된 문서가 현재 서버가 다룰 수 있는 크기보다 큼. [24] (HTTP 1.1에서 새로 등장)
414Request-URI too long요청한 URI가 너무 김. [25]
415Unsupported media type요청이 알려지지 않은 형태임. (HTTP 1.1에서 새로 등장)
5XXServer Error(서버 오류)서버 측의 오류로 올바른 요청을 처리할 수 없음.
500Internal Server Error서버 내부 오류. [26]
501Not Implemented필요한 기능이 서버에 설치되지 않았음. [27]
502Bad gateway게이트웨이 상태 나쁨. [28]
503Service Unavailable외부 서비스가 죽었거나 현재 멈춘 상태 또는 이용할 수 없는 서비스. [29]
504Gateway timeout프록시나 게이트웨이의 역할을 하는 서버에서 볼 수 있음. 초기 서버가 원격 서버로부터 응답을 받을 수 없음. (HTTP 1.1에서 새로 등장)
505HTTP Version Not Supported해당 HTTP 버전을 지원하지 않음.

HTTP 메소드

 GET, ,HEAD, POST, PUT, DELETE, CONNECT, OPTIONS, TRACE, PATCH



728x90
반응형
728x90
반응형

REST는 'Representational State Transfer'의 약어로 하나의 URI는 하나의 고유한 리소스(Resource)를 대표하도록 설계된다는 개념입니다.

최근 서버에 접근하는 기기의 종류가 다양해 지면서 다양한 기기에 공통으로 데이터를 처리할 수 이쓴 규칙을 만드는 것이 REST방식입니다.

REST API 설계 시 중요한 점

1. URI는 정보의 자원을 표현해야 합니다.

2. 자원에 대한 방식은 HTTP Method(GET, POST, PUT, DELETE)로 표현합니다.


스프링은 3버전부터 @ResponseBody 어노테이션을 지원하며 REST방식의 처리를 지원했고

@ResponseBody 어노테이션은 메소드나 리턴 타입에 사용할 수 있는 어노테이션으로 자동화된 처리 방식입니다.

최근 4버전 부터는 @RestController 어노테이션이 사용가능해졌습니다.

@RestController 어노테이션의 경우 기존의 특정한 JSP와 같은 뷰를 만들어 내는 것이 아닌 REST 방식의 데이터 처리(데이터 자체를 반환)를 위해 사용하는 어노테이션입니다. 문자열 데이터는 브라우저에서 'text/html' 타입으로 처리됩니다.


<dependency>

<groupId>com.fasterxml.jackson.core</groupId>

<artifactId>jackson-databind</artifactId>

<version>2.8.4</version>

</dependency>    


스프링에서 jackson-databind 라이브러리를 pom.xml에 추가해줘야 합니다. jackson-databind 라이브러리는 객체를 JSON 타입의 데이터로 변환하거나, 반대의 작업을 할 때 사용합니다. JSON을 사용해야 하는 프로젝트에 반드시 필요한 라이브러리입니다.


REST 방식은 다양한 디바이스(Android나 iPhone과 같은 모바일 환경에서 서버의 데이터, HTML5, Ajax 등을 사용하는 경우)로부터 서버에 데이터와 작업을 요청하고, 결과를 받는다는 점에서 유용하지만, 일반적인 웹 페이지와는 달리 화면을 제작하지 않는 형태로 처리되기 때문에, 결과를 체크하면서 개발하기에는 적합하지 않습니다.


하지만 좀 더 쉽게 결과를 테스트 할 수 있도록 REST 클라이언트 프로그램이 존재합니다

Chrome 브라우저의 앱으로 존재하는 Advanced REST Client입니다. 

먼저 크롬에 Advanced REST Client 키워드를 검새합니다.


저는 이미 설치가 되어있는데요. 설치가 되지 않은 분들은 아래 빨간 화면에 앱 추가 버튼을 눌러주세요!





설치가 되었다면 아래와 같이 ARC 프로그램이 웹 스토어에 등록됩니다.



사용하는 방법은 RequestURL에 URL을 입력하고 전송 방식을 선택하면 됩니다.  전송 방식에 따라 추가적인 데이터를 입력할 수 있습니다.

SEND버튼을 누르면 아래와 같은 화면이 보여집니다.




728x90
반응형
728x90
반응형

+ Recent posts