위키득계정 ↗
기술

JSON 포인터

JSON 포인터기술
명세
RFC 6901
대상
JSON 문서 내부의 값
경로 구분
슬래시
배열 위치
0부터 시작하는 인덱스
JSON 포인터는 JSON 문서 안의 특정 값을 문자열로 가리키는 표기법이다. 객체의 이름이나 배열의 위치를 차례로 따라가며 값을 찾고, JSON 패치에서는 변경할 위치를 나타내는 데 사용한다.

루트에서 값을 따라가는 경로

빈 문자열은 문서 전체를 가리킨다. 슬래시로 나눈 각 부분은 현재 객체의 항목 이름이나 배열의 인덱스를 뜻한다. 평가 과정에서는 루트에서 출발해 각 부분을 순서대로 적용하므로 같은 문자열도 대상 자료의 구조에 따라 해석이 달라질 수 있다.

이름과 배열 인덱스의 표현

이름 안의 물결표는 ~0으로, 슬래시는 ~1로 표현한다. 해석할 때는 ~1을 먼저 복원한다. 배열 인덱스는 0부터 시작하며 여러 자리 수의 앞에 불필요한 0을 붙이지 않는다. 객체 이름을 비교할 때 유니코드 정규화를 자동 수행하지 않는다.

값이 없는 경로의 처리

문법이 맞더라도 해당 값이 존재한다는 보장은 없다. 잘못된 경로나 존재하지 않는 항목을 만났을 때의 처리는 사용하는 응용에서 정한다. 배열 뒤를 나타내는 하이픈도 일반 조회에서는 실제 항목이 아니며, JSON 패치는 이를 끝에 추가하는 위치로 해석한다.

관련 문서

JSON 패치 / JSON / JSON Schema / URI / 배열 / 유니코드