在Java中,$ref限制如下:
- $ref只能用于定義OpenAPI規(guī)范中的“definitions”或“parameters”部分,用來引用其他定義或參數(shù)。
- $ref中的值必須是一個字符串,并且必須以“#/”開頭,后面跟隨引用的路徑。
- 被引用的定義必須在同一個OpenAPI規(guī)范文件中或者是外部引用的文件中。
- $ref不能引用自身,即不能形成循環(huán)引用。
- $ref不能引用響應(yīng)體的定義,只能引用請求參數(shù)的定義。
- $ref引用的路徑必須是正確的,否則會導(dǎo)致解析錯誤。
總的來說,$ref在Java中主要用于引用其他定義或參數(shù),幫助簡化和重用OpenAPI規(guī)范中的結(jié)構(gòu)和內(nèi)容。