평평하게하는 것을 존중하도록 가르쳐 준 작업은 티켓에서 지루해 보였습니다: & quot;설정 개체를 스프레드 시트로 내보내 클라이언트가 편집 할 수 있도록. & quot; 설정은 Laravel 구성에서 깊이 중첩 된 JSON 블롭이었고,장소 깊이에 3 개와 4 개의 레벨이 있으며,기능 플래그 배열이 혼합되어 있습니다. 스프레드 시트에는 트리가 아닌 열이 있습니다. 나는 클라이언트가 한 행에서 볼 수있는 단일 플랫 키로 모든 리프 값이 필요했고,편집하고, 다시 핸드백 한 다음 단일 배열 인덱스를 잃지 않고 편집에서 정확한 중첩 구조를 다시 작성해야했습니다. 중첩 된 라운드 트립과 평평한 플랫 백이 중첩 된 라운드 트립은 JSON 플랫너가하는 일이며,무손실로 얻는 것이 전체 게임입니다. The Toolz JSON 플랫터너 는 그 일을 위해 제가 만든 도구이며, 이 가이드는 그것이 어떻게 작동하고 어디에서 당신을 구하는지 설명합니다.
TL;DR: JSON 플랫테너는 중첩된 개체를 키가 각 값의 경로인 단일 수준 개체로 변환합니다
{"user":{"city":"Austin"}}된다{"user.city":"Austin"}. 경로에 인덱스가 있는 평평한 배열입니다(Arrays flatten with their index in the path)roles.0). Unflatten 은 이를 반대로 하여 점선 키에서 중첩된 객체와 배열을 다시 작성합니다. Toolz 도구는 양방향을 무손실로 수행하고 빈 객체와 배열을 보존하며 점 또는 브래킷 배열 표기법과 사용자 정의 구분 기호를 지원하고 업로드 및 가입 없이 완전히 클라이언트 측에서 실행됩니다.
나는 Laravel 과 React 에 SaaS 를 구축하고 WordPress 플러그인을 출하하므로 중첩 된 JSON 은 내 하루 중 어디에나 있습니다: 구성 파일,API 페이로드,i18n 메시지 카탈로그,기능 플래그 저장소. 그 페이로드를 소비하는 시스템은,하지만, 자주 플랫 키를 원한다. 평평하게하는 것은 구조화 된 데이터에 자연스러운 모양과 스프레드 시트,환경 변수 및 점선 키 저장소에 자연스러운 모양 사이의 어댑터입니다. 그렇지 않으면 성가신 작업을 조용히 많이 차단 해제하는 작은 작업입니다.
JSON flattener 란 무엇입니까?
JSON 플랫트너는 중첩된 JSON 객체를 각 키가 루트에서 리프 값으로 가는 전체 경로인 단일 레벨 객체로 변환합니다. 경로 구문도 임의적이지 않습니다: RFC 6901 문서 내부의 한 값을 처리하는 표준 방법인 JSON 포인터를 정의합니다. 중첩 {"user":{"name":"Ada","address":{"city":"Austin"}}} 플랫이 됩니다 {"user.name":"Ada","user.address.city":"Austin"}. 값에 대한 아무것도 변경되지 않습니다; 만 주소 지정 않습니다. 모든 잎, 아무리 깊은, 그것에 도달하는 방법을 철자 한 키를 가져옵니다.
배열은 같은 방식으로 처리되며 배열 인덱스는 경로 세그먼트가 됩니다: {"roles":["admin","editor"]} 평평하게 {"roles.0":"admin","roles.1":"editor"}. 키의 인덱스는 역방향 작업이 배열을 올바른 순서로 다시 빌드할 수 있게 하는 것입니다. 플랫이 해제된 역방향 작업은 점선 키의 플랫 개체를 가져와 중첩된 개체와 배열을 재구성하여 각 단계에서 경로 세그먼트가 개체 속성을 지정하는지 배열 인덱스를 지정하는지 결정합니다. 플랫이 해제된 경우 동일한 구분 기호와 배열 표기법을 사용하면 정확한 반전이며 무손실 왕복 여행은 일방적인 편의가 아닌 실제 작업에 도구를 신뢰할 수 있게 만드는 속성입니다.
애초에 JSON을 평평하게 만드는 이유는 무엇입니까?
왜냐하면 많은 시스템들이 플랫 키-값 쌍만을 말하고,점선 경로는 중첩된 구조를 잃지 않고 그것들을 통해 전달하는 표준 방법이기 때문입니다. 가장 명확한 예는 스프레드시트입니다. 스프레드시트는 열의 격자이고,사용자 내부의 주소 안에 있는 "the city 에 대한 열이 없습니다." 객체를 평평하게 하고 user.address.city 값이 따라갈 수 있는 단일 열 헤더가 되며, 이는 내 설정 내보내기 티켓에 필요한 것과 정확히 같습니다.
다른 많은 곳에서도 같은 모양이 나타납니다. 환경 변수와 .env 파일은 평면이고 구성 매핑 도구는 점선 또는 밑줄 경로를 사용합니다. 국제화 라이브러리는 점선 경로로 문자열을 입력합니다 checkout.button.label. 기능 플래그 플랫폼,분석 이벤트 스키마 및 많은 로깅 파이프라인은 모두 한 레벨의 키를 원하므로 종종 각 필드를 독립적으로 인덱싱하거나 쿼리할 수 있습니다. 모든 경우에 중첩은 실제적이고 의미가 있으며 평평하게 하면 경로에서 이를 버리지 않고 보존합니다. 평평한 표현이 목적을 달성하면 평평하지 않은 상태로 원래 개체를 다시 작성합니다. JSON 과 스프레드시트 사이를 구체적으로 이동하는 경우에도 CSV 에서 JSON 변환기 해당 여행의 테이블형 다리에 대한 자연스러운 동반자입니다.
평평하게 할 때 배열은 어떻게 처리됩니까?
배열은 사람들이 가장 자주 틀리는 부분이므로 정확하게 설명할 가치가 있습니다. 배열 요소는 숫자 인덱스를 경로 세그먼트로 사용하여 평평하게 되어 순서를 유지하고 배열을 정확하게 다시 작성할 수 있습니다. Toolz 도구는 해당 인덱스에 대해 두 가지 표기법을 제공하며 동일한 정보를 다른 구문으로 인코딩합니다.
| 입력 | 점 표기법 | 브라켓 표기법 |
|---|---|---|
{"roles":["admin","editor"]} |
roles.0, roles.1 |
roles[0], roles[1] |
{"items":[{"id":1}]} |
items.0.id |
items[0].id |
{"matrix":[[1,2]]} |
matrix.0.0 |
matrix[0][0] |
점 표기법이 씁니다 roles.0는 콤팩트하고 얼마나 많은 config 와 i18n 시스템이 그들의 값을 키하는지 일치시킵니다. 브라켓 표기법 쓰기 roles[0]이는 JavaScript 액세스 구문과 일부 쿼리 언어가 사용하는 경로 스타일을 반영합니다. 둘 다 더 정확하지 않습니다; 다른 쪽 끝에서 시스템이 기대하는 것을 선택합니다. 중요한 것은 일관성입니다: 평평하게 만드는 표기법이 무엇이든 동일한 표기법을 사용하여 평평하게 해제하십시오. 왜냐하면 도구가 숫자 세그먼트를 아는 방법은 "array index" number."가 아닌 객체 키이기 때문입니다; Toolz 플랫너는 기본적으로 도트 표기법을 사용하며 한 번의 클릭으로 괄호로 전환할 수 있습니다.
JSON flattener 는 어떻게 사용합니까?
흐름은 두 방향과 두 가지 옵션이 있습니다. 상단에 토글을 사용하여 flatten 또는 unflatten 을 선택하여 시작하십시오. Flatten 은 중첩 된 JSON 을 가져 와서 점선 키를 생성합니다; unflatten 은 점선 키를 가져 와서 중첩 된 구조를 다시 작성합니다. 로드 샘플은 어느 방향에 있든 작업 된 예제를 채우므로 자신의 데이터를 붙여 넣기 전에 입력과 출력 모두의 모양을 볼 수 있습니다.
입력 상자에 JSON 을 붙여 넣습니다. flatten 의 경우,그것은 중첩 된 객체입니다; unflatten 의 경우 키가 점선 경로 인 평평한 객체입니다. 입력은 유효한 JSON 이어야하며 그렇지 않은 경우 도구는 빈 출력을 전달하는 대신 parser's 메시지와 문제의 위치를보고하므로 길 잃은 후행 쉼표를 빠르게 찾을 수 있습니다. 키 스타일 설정: 구분 기호는 기본적으로 점으로 설정되며 키에 이미 점이 포함되어있을 때 변경할 수 있으며 배열 표기법 토글은 전환됩니다 roles.0 그리고 roles[0]니다. 그 두 설정을 동일하게 평평하게하고 그 일치하는 unflatten 에 걸쳐 유지 그래서 왕복 줄. 작업 버튼을 클릭하고,얼마나 많은 잎이 생산되었는지 확인하는 키 카운트를 확인하고,출력을 복사하거나 a 로 다운로드합니다 .json 파일. 모든 것은 당신이 클릭하는 순간 실행, 브라우저에서, 아무데도 전송되지.
평탄화는 무손실이며, 가장자리 사례는 무엇입니까?
Toolz 도구의 경우,예, 알 가치가있는 하나의 가장자리 케이스가 있습니다. 스칼라, null, 부울, 그리고 숫자는 손대지 않고 살아남습니다 미묘한 부분은 빈 컨테이너입니다: 빈 객체 {} 또는 빈 배열 [] 은 묵묵히 드롭되는 것이 아니라 leaf 값으로 보존되므로,빈 리스트에 의존하는 구성은 여전히 정확히 그 모습 그대로를 왕복합니다. 순진한 플랫테너들이 빈 컨테이너를 많이 잃어버리는데,이는 문서의 의미를 조용히 바꾸기 때문에 의도적인 선택입니다.
진짜 제한 하나는 이미 구분자를 포함하고 있는 키입니다. 데이터에 리터럴 점이 있는 개체 키가 있는 경우 처럼 {"a.b":1}그리고 점 구분 기호로 평평하게 하면 경로가 모호해집니다: 평평하지 않으면 여부를 알 수 없습니다 a.b 하나의 키이거나 중첩된 키였습니다 a 그럼 b. 수정은 구분 기호를 슬래시나 파이프와 같이 키에 나타나지 않는 문자로 변경하고 양방향에 동일한 구분 기호를 사용하는 것입니다. 언제 볼 수 있는 탈출 문제의 동일한 클래스입니다 CSV 구분 기호가 데이터와 충돌합니다그리고 같은 해결책이 적용됩니다: 값에 포함되지 않은 구분 기호를 선택합니다. 그 경우 밖에서는 평평함 뒤에 일치하는 설정이 있는 평평하지 않은 것이 원본 문서를 정확하게 재현하며 배열과 빈 컨테이너가 포함됩니다.
평평하게 하는 것과 다른 형식으로 변환하는 것의 차이점은 무엇입니까?
평탄화는 형식 변환이 아닙니다; JSON 내에서의 구조 조정입니다. 평탄화의 출력은 여전히 JSON 이며,중첩 대신 점선 키의 단일 레벨만 사용합니다. 이는 JSON 을 진정으로 다른 직렬화로 바꾸는 변환기와 다르며,필요한 것을 아는 것은 단계를 저장합니다.
구성 파일에 대해 YAML과 동일한 데이터를 표현하려면 JSON 에서 YAML 변환기 모양이 아닌 구문을 변경하기 때문에 도구입니다. 프런트 엔드가 처리 내용을 알 수 있도록 구조를 설명하는 TypeScript 인터페이스를 원하는 경우 JSON에서 TypeScript로 변환합니다 샘플에서 이를 추론합니다. 검증을 위한 공식 계약을 원한다면 JSON 스키마 생성기 예제에서 JSON 스키마를 파생합니다. Flattening 은 이들을 대체하는 것이 아니라 옆에 위치합니다: 다운스트림 시스템이 한 레벨의 키를 원할 때 플랫튼을 수행하고 시스템이 다른 언어를 원할 때 변환합니다. 나는 자주 두 가지를 순서대로 수행하여 페이로드를 플랫튼하여 열로 편집한 다음 별도로 React 에 건네는 중첩 버전에 대한 유형을 생성합니다. 해당 체인의 어느 지점에서나 JSON 을 예쁜 인쇄하거나 유효성을 검사하기 위해,the JSON 포맷터 다음 탭에서 계속 열어두는 유틸리티입니다.
Unflatten은 배열과 객체 사이를 어떻게 결정합니까?
이것은 왕복 여행을 작동하게하는 메커니즘이며,이해하는 것은 tool's 기본값과 하나의 날카로운 모서리를 모두 설명합니다. unflatten 이 다음과 같은 키를 읽을 때 user.roles.0, 세그먼트로 나눕니다 user, roles, 그리고 0그리고 나서,그들에게 건물 구조를 가는 대로 걸어줍니다. 각 단계에서 어떤 종류의 컨테이너를 만들 것인지 결정하기 위해 다음 세그먼트를 봅니다. 다음 세그먼트가 음수가 아닌 정수라면,배열을 만듭니다; 다른 것이라면,객체를 만듭니다. 그래서 roles.0 도구에 이를 알려줍니다 roles 는 첫 번째 요소가 값인 배열이어야 합니다 address.city 라고 말합니다 address 가 있는 객체여야 합니다 city 재산.
그 단일 규칙, "integer 세그먼트는 배열 인덱스,"를 의미하므로 일치하는 설정으로 평평하고 평평하지 않은 배열이 배열을 정확하게 재현합니다. 또한 선택한 배열 표기법이 일관되어야하는 이유이기도합니다. 점 표기법에서 배열 인덱스와 개체 키는 모두 점 사이의 텍스트 일 뿐이므로 도구는 전적으로 정수 테스트에 의존합니다. 괄호 표기법에서 [0] 구문은 분할이 발생하기도 전에 인텐트를 명시적으로 만듭니다. 둘 중 하나는 작동하지만,그들을 혼합하여 괄호로 평평하게 하고 점으로 평평하게 하면 도구가 의존하는 신호가 끊어집니다.
다음은 규칙에서 따르는 날카로운 모서리입니다: 키가 실제로 문자열인 개체입니다 "0", "1", "2" 는 배열과 한번 평평하게 구별할 수 없다. 둘 다 키를 생성한다 0, 1, 2그리고 unflatten 은 압도적으로 일반적인 경우이기 때문에 배열로 다시 작성합니다. 왕복 여행에서 살아남기 위해 숫자 문자열 키가있는 개체가 정말로 필요하다면,평평하게하고 unflattening 이 정확한 유형을 돌려주지 않는 한 가지 상황이므로 해당 개체를 중첩 상태로 유지하거나 숫자가 아닌 키 체계를 사용하는 것이 좋습니다. 이 작업을 수행 한 몇 년 동안 나는 처음부터 잘못 모델링 된 것으로 틀림없는 데이터에서 두 번 모두 그 경우를 정확히 두 번 쳤으므로 기본값은 거의 모든 사람에게 올바른 거래입니다. 앞에 0 이있는 숫자를 문자열로 유지하는 것과 같은 종류의 실용적인 결정입니다 CSV 에서 JSON 변환기: 이 도구는 데이터가 거의 항상 의미하는 바를 최적화하고 공통 경로를 어색하게 만드는 대신 드문 예외를 문서화합니다.
내 JSON 이 도구에 붙여 넣기에 안전합니까?
예,그리고 약속이라기 보다는 건축적입니다. 파싱,평평화화, 플래튼 해제,직렬화는 모두 자신의 브라우저 탭 안에서 자바스크립트로 실행됩니다. 업로드도 없고,서버 왕복도 없고,아무것도 기록되거나 저장되지 않습니다. browser's 네트워크 탭을 열고 작업 버튼을 클릭하세요: 요청이 나가지 않습니다. 페이지가 로드되면 인터넷에서 연결을 끊을 수 있고 계속 작동합니다. 왜냐하면 처음부터 루프에는 서버가 없었기 때문입니다.
이것은 보일지도 모르다 보다는 더 많은 것을,왜냐하면 JSON 페이로드는 비밀을 나르는 것의 정확하게 종류이기 때문에,중요합니다: 윤곽에 있는 API 토큰,API 응답에 있는 개인 자료,설정 blob 에 있는 내부 식별자. 서버에 당신의 목표를 올려주기한 평평하게 하는 사람은 누군가 else's 통나무 선으로 개인적인 페이로드를 돌 것입니다. 클라이언트 측 처리는 위험을 전부 제거하는 이유,Toolz.dev 에 모든 공구에 걸쳐 기본인 이유 가득 차있는 추론을 원하는 경우에,나는에 그것을 밖으로 놓았습니다 온라인 도구에 대한 데이터 개인 정보 보호 가이드그리고 이런 종류의 작업에 사용하는 더 넓은 키트가 내 안에 있습니다 웹 개발자 툴킷 가이드.
자주 묻는 질문
JSON을 평평하게 한다는 것은 무엇을 의미합니까?
Flattening JSON 은 중첩된 객체를 키가 각 값의 경로인 단일 레벨 객체로 변환합니다. 중첩된 {"user":{"city":"Austin"}} 플랫이 됩니다 {"user.city":"Austin"}. 모든 leaf 값은 하나의 점선 키를 얻고,출력에는 nesting 이 남지 않습니다. Unflatten 은 프로세스를 역전시키고 중첩된 구조를 다시 만듭니다.
평평하게 할 때 배열은 어떻게 처리됩니까?
배열 요소는 인덱스를 경로 세그먼트로 사용하여 평평해집니다. {"roles":["admin","editor"]} 된다 {"roles.0":"admin","roles.1":"editor"} 점 표기법에서 또는 {"roles[0]":"admin","roles[1]":"editor"} 대괄호 표기법에서. 인덱스는 순서를 보존하므로 배열을 플래튼을 풀 때 정확하게 다시 작성할 수 있습니다.
점선 키를 중첩된 JSON으로 다시 풀 수 있나요? 예. unflatten 모드로 전환하고 키가 점선 경로인 평평한 개체를 붙여 넣습니다. 도구는 중첩된 개체와 배열을 다시 작성하여 각 경로 세그먼트가 정수 인덱스인지 여부에 따라 배열 대 개체를 결정합니다. Flatten 과 unflatten 은 구분 기호와 배열 표기법이 일치할 때 정확한 역수입니다.
점 배열 표기법과 괄호 배열 표기법의 차이점은 무엇입니까?
둘 다 동일한 배열 인덱스를 인코딩합니다; 구문만 다릅니다. 점 표기법이 씁니다 items.0.id구성 및 i18n 키에서 컴팩트하고 일반적인 것입니다. 브래킷 표기법이 씁니다 items[0].id는 자바스크립트 액세스 문법과 일부 쿼리 언어와 일치합니다. 대상 시스템이 예상하는 것을 선택하고 양방향에 동일한 것을 사용하십시오.
평평하게하면 데이터가 손실됩니까? 아니요. 스칼라,널, 부울,심지어 빈 객체와 빈 배열도 리프 값으로 보존되므로 결과를 띄워두지 않으면 원본 문서가 재현됩니다. 지켜봐야 할 한 가지는 구분 기호가 이미 포함된 키이므로 구분 기호를 구성할 수 있습니다.
왜 JSON을 평평하게 만들까요? Flattening 은 중첩된 데이터를 한 단계의 키를 기대하는 시스템에 적용합니다: 스프레드시트 열,환경 변수,점선 번역 키,기능 플래그 저장소,많은 분석 및 로깅 파이프라인. 점선 경로는 평면 형식을 통해 원래 구조를 전달하므로 손실되는 것은 없습니다.
키에 이미 점이 포함되어 있으면 어떻게 되나요? 키 내부의 리터럴 도트는 경로 구분 기호로 모호하므로 왕복 여행이 잘못된 위치에서 분할할 수 있습니다. 구분 기호를 슬래시나 파이프와 같이 키에 나타나지 않는 문자로 변경하고 평평함과 평평하지 않음 모두에 동일한 구분 기호를 사용합니다.
내 json이 아무데나 업로드됩니까? 아니요. 파싱 및 변환은 브라우저에서 JavaScript 로 실행됩니다. 전송,로그 또는 저장되는 것은 없습니다. 평평하게하는 동안 네트워크 탭을 보거나 도구가 연결없이 계속 작동하므로 오프라인으로 전환하여이를 확인할 수 있습니다.
