PathVariable과 Query String

정안녕·2026년 1월 16일

Metaverse

목록 보기
7/16

PathVariable이란

Spring에서 URL 경로에 있는 데이터를 변수로 가져오는 방법

REST API에서 URI에 변수가 들어가는 걸 실무에서 많이 볼 수 있는데
http://localhost:8080/api/user/_1234_
http://music.bugs.co.kr/album/_4026_
이처럼 밑줄 친 부분이 @PathVariable로 처리할 수 있는 부분이다.

[사용법]

URL 경로에서 특정 부분을 추출해서 컨트롤러의 파라미터로 직접 바인딩할 때 사용

@GetMapping("/user/{id}")
public String getUser(@PathVariable String id){
	return "User ID: " + id;
    }

이때 123은 사용자 ID고, 이걸 코드에서 변수로 쓰려면 이렇게 합니다.
@PathVariable이 바로 저 id에 123을 넣어주는 역할을 한다.

URL 경로에 포함된 변수 값(경로 변수)를 추출할 때 사용되며
기본값을 설정할 수 없으며 경로 변수는 필수이다.

@GetMapping("/api/users/{id}")
public String getUserByPathVariable(@PathVariable("id") String userID){
	//경로 변수로 전달된 값을 사용
    return "User ID: " + userId:
}
요청 URL : /api/users/123

전체 흐름(프론트 - 백의 연동)

  1. 사용자가 웹사이트에서 마이페이지(프로필) 클릭
  2. 프론트 엔드가 로그인된 사용자의 ID를 알고 있고 이렇게 요청
GET/user/123
  1. 백엔드(Spring)가 해당 요청을 받고, 123을 메서드 안 id에 담는다.
  2. 백엔드가 사용자 정보를 조회하거나 단순히 문자열 응답을 반환
  3. 프론트가 그 응답을 받아서 웹 화면에 보여준다.

Query String

URL의 '?' 뒤에 붙는 "이름=값" 형태의 데이터 쌍들로, 서버에 추가 정보를 전달하는 문자열

http://host:post/path?querystring

사용자의 검색어, 필터링 조건, 페이지 번호 등을 웹 페이지로 전달하여
원하는 데이터를 가져오거나 특정 기능을 수행하게 하는 데 사용되며,
여러 데이터는 '&'으로 연결됩니다.

Query Parameters(? 뒤 =로 연결된 key value pair 부분)을 URL 뒤에 덧붙여서 추가적인 정보를 서버 측에 전달하는 것이다.

클라이언트가 어떤 특정 리소스에 접근하고 싶어하느지 정보를 담는다.

<특징 및 구성>

위치 : URL의 마지막 부분, '?' 문자 뒤에 위치.
형식 : key=value 형태로 구성되며, 여러 쌍은 & 기호로 연결.
[용도]
검색 : ?q=검색어
필터링 : ?category=shoes&color=blue
페이지네이션 : ?page=2&size=10
전송 방식 : HTTP 요청 시 URL에 포함되어 서버로 전달.

profile
죽순 디벨롭

0개의 댓글