Bagaimanakah jenis data go's.JSON diterangkan dalam spesifikasi openAPI?

editor php Baicao memperkenalkan kepada anda cara jenis data.JSON jenis data go diterangkan dalam spesifikasi openAPI. Dalam spesifikasi openAPI, Objek Skema digunakan untuk menerangkan jenis data. Untuk jenis data types.JSON dalam go, ia boleh diterangkan menggunakan jenis sebagai "rentetan" dan format sebagai "json". Ini membolehkan anda menentukan secara eksplisit jenis data medan sebagai rentetan dalam format JSON. Selain itu, anda juga boleh menggunakan medan contoh untuk memberikan nilai contoh untuk membantu pembangun memahami dengan lebih baik struktur dan penggunaan jenis data ini. Melalui penggunaan spesifikasi openAPI yang munasabah, datatypes.JSON jenis data dalam go boleh diterangkan dengan tepat, memberikan pembangun dengan dokumen antara muka yang jelas dan definisi jenis data.

Isi soalan

Saya ada projek golang-gin. Terdapat struktur sedemikian:

type Value struct { 
    gorm.Model 
    QuesAns       datatypes.JSON json:"ques_ans" 
}

Medan

QuesAns harus mempunyai JSON daripada mana-mana tiga jenis ini.

"ques_ans": {
    "receiver.ques": [
         "Q1",
         "Q2"
     ], 
    "receiver.ans": [
         "Ans1",
         "Ans2",
         "Ans3" 
     ]
 }

"ques_ans": {
     "id": "1",
     "receiver.sid": "2743dfjfh87",
     "receiver.ques": [
         "Q1",
         "Q2",
         "Q3" 
     ] 
 }

"ques_ans": {
     "receiver.ques_key": [
         "1",
         "2" 
     ],
     "receiver.ans_key": [
         "13",
         "20" 
     ] 
 }

Bagaimana anda menerangkan penyepaduan spesifikasi Open API?

Saya mencuba berbilang jenis tetapi tidak dapat menyegerakkan kesemuanya kerana JSON boleh terdiri daripada pelbagai jenis dan hanya tiga jenis ini berfungsi.

Penyelesaian

Okay! Begini cara saya menyelesaikannya:

components:
  schemas:
    Value:
      type: object
      properties:
        ques_ans:
          oneOf:
            - $ref: '#/components/schemas/Type1'
            - $ref: '#/components/schemas/Type2'
            - $ref: '#/components/schemas/Type3'
    Type1:
      type: object
      properties:
        receiver.ques:
          type: array
          items:
            type: string
        receiver.ans:
          type: array
          items:
            type: string
    Type2:
      type: object
      properties:
        id:
          type: string
        receiver.sid:
           type: string
        receiver.ques:
          type: array
          items:
            type: string
    Type3:
      type: object
      properties:
        receiver.ques_key:
          type: array
          items:
            type: string
        receiver.ans_key:
          type: array
          items:
            type: string

Atas ialah kandungan terperinci Bagaimanakah jenis data go's.JSON diterangkan dalam spesifikasi openAPI?. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!