Apicurio-studio: νŽΈμ§‘κΈ°: 데이터 μœ ν˜•(예: UUID)의 자유 ν˜•μ‹ "ν˜•μ‹" 값에 λŒ€ν•œ 지원 μΆ”κ°€

에 λ§Œλ“  2019λ…„ 04μ›” 09일  Β·  4μ½”λ©˜νŠΈ  Β·  좜처: Apicurio/apicurio-studio

UUID에 λŒ€ν•œ κΈ°λ³Έ 제곡 μœ ν˜•μ€ μ—†μ§€λ§Œ OpenAPI 사양은 λ‹€μŒμ„ μ‚¬μš©ν•˜λ„λ‘ μ œμ•ˆν•©λ‹ˆλ‹€.

μœ ν˜•: λ¬Έμžμ—΄ν˜•μ‹: uuid

데이터 μœ ν˜• μ„Ήμ…˜(κ°•μ‘° κ΄‘μ‚°):

ν”„λ¦¬λ―Έν‹°λΈŒμ—λŠ” 선택적 μˆ˜μ •μž 속성인 ν˜•μ‹μ΄ μžˆμŠ΅λ‹ˆλ‹€. OASλŠ” λͺ‡ 가지 μ•Œλ €μ§„ ν˜•μ‹μ„ μ‚¬μš©ν•˜μ—¬ μ‚¬μš© 쀑인 데이터 μœ ν˜•μ„ μ„ΈλΆ€μ μœΌλ‘œ μ •μ˜ν•©λ‹ˆλ‹€. κ·ΈλŸ¬λ‚˜ λ¬Έμ„œ μš”κ΅¬ 사항을 μ§€μ›ν•˜κΈ° μœ„ν•΄ format 속성은 μ—΄λ¦° λ¬Έμžμ—΄ κ°’ 속성이며 λͺ¨λ“  값을 κ°€μ§ˆ 수 μžˆμŠ΅λ‹ˆλ‹€. "email", "uuid" λ“±κ³Ό 같은 ν˜•μ‹μ€ 이 μ‚¬μ–‘μ—μ„œ μ •μ˜λ˜μ§€ μ•Šλ”λΌλ„ μ‚¬μš©ν•  수 μžˆμŠ΅λ‹ˆλ‹€(MAY).

예λ₯Ό λ“€μ–΄, Swagger Codegen은 ν˜•μ‹: uuidλ₯Ό C#의 System.Guid λ˜λŠ” Java의 java.util.UUID에 λ§€ν•‘ν•©λ‹ˆλ‹€. format: uuidλ₯Ό μ§€μ›ν•˜μ§€ μ•ŠλŠ” λ„κ΅¬λŠ” type: string으둜 μ²˜λ¦¬ν•©λ‹ˆλ‹€.

(볡사: https://stackoverflow.com/questions/50204588/how-to-define-uuid-property-in-json-schema-and-open-api-oas)

기타 μ°Έμ‘°: https://github.com/json-schema-org/json-schema-spec/issues/542

enhancement editor

κ°€μž₯ μœ μš©ν•œ λŒ“κΈ€

λ‚˜λŠ” 이것이 λ˜ν•œ λˆ„λ½λ˜μ—ˆμŒμ„ μ•Œμ•˜μŠ΅λ‹ˆλ‹€. μ†ŒμŠ€μ— UUIDλ₯Ό μˆ˜λ™μœΌλ‘œ μΆ”κ°€ν•  수 μžˆμ§€λ§Œ UI에 있으면 쒋을 κ²ƒμž…λ‹ˆλ‹€.

λͺ¨λ“  4 λŒ“κΈ€

λ‚˜λŠ” 이것이 λ˜ν•œ λˆ„λ½λ˜μ—ˆμŒμ„ μ•Œμ•˜μŠ΅λ‹ˆλ‹€. μ†ŒμŠ€μ— UUIDλ₯Ό μˆ˜λ™μœΌλ‘œ μΆ”κ°€ν•  수 μžˆμ§€λ§Œ UI에 있으면 쒋을 κ²ƒμž…λ‹ˆλ‹€.

이것은 λ‚΄ λͺ¨λ“  μ‚¬μš© 사둀에도 ν™•μ‹€νžˆ 도움이 될 κ²ƒμž…λ‹ˆλ‹€. λ‚˜λŠ” μƒλ‹Ήνžˆ UUIDκ°€ λ§Žμ€ APIλ₯Ό λ§Œλ“€κ³  μžˆμŠ΅λ‹ˆλ‹€!

이 ν•­λͺ©μ— λŒ€ν•΄ μ—¬λŸ¬ ν‘œλ₯Ό μ–»μ—ˆμŠ΅λ‹ˆλ‹€. μš°μ„  μˆœμœ„ λͺ©λ‘μ„ 올리기 μœ„ν•΄ μ΅œμ„ μ„ λ‹€ν•  κ²ƒμž…λ‹ˆλ‹€.

이것은 정말 ν•„μš”ν•©λ‹ˆλ‹€! +1

이 νŽ˜μ΄μ§€κ°€ 도움이 λ˜μ—ˆλ‚˜μš”?
0 / 5 - 0 λ“±κΈ‰