Api-blueprint: السمات مع مصفوفة من الكائنات تنتج مخططًا غير كامل

تم إنشاؤها على ١١ مايو ٢٠١٦  ·  8تعليقات  ·  مصدر: apiaryio/api-blueprint

الجزء التالي من الملف النصي الخاص بي:

  • Response 200 (التطبيق / JSON)

    • سمات (كائن)

    • العقد (مصفوفة [كائن])



      • المعرف: 4 (رقم)


      • sname: Chromista (سلسلة) - الاسم العلمي


      • الترتيب: Kingdom (سلسلة) - الترتيب التصنيفي للاسم العلمي


      • حقوق التأليف: noworms, 1603 (سلسلة) - معلومات التأليف حول الاسم العلمي



    • الجسم

```
{
    "nodes": [
        {
            "id": "1",
            "sname": "Animalia",
            "rank": "Kingdom",
            "authorship": "noworms, 1603"
        },
        {
            "id": "2",
            "sname": "Archaea",
            "rank": "Kingdom",
            "authorship": "noworms, 1603"
        },
        {
            "id": "3",
            "sname": "Bacteria",
            "rank": "Kingdom",
            "authorship": "noworms, 1603"
        },
        {
            "id": "4",
            "sname": "Chromista",
            "rank": "Kingdom",
            "authorship": "noworms, 1603"
        },
        {
            "id": "5",
            "sname": "Fungi",
            "rank": "Kingdom",
            "authorship": "noworms, 1603"
        }
    ],
    "hasMore": 1
}
```

ينتج هذا HTML:

pic1

جزء المخطط الموجود داخل "العقد" مفقود! لماذا؟
لقد حاولت أيضًا استخدام هياكل البيانات ولكن المخطط لا يزال غير مكتمل.

التعليق الأكثر فائدة

هل يمكنك تجربة هذا؟

+ nodes (array, fixed)
    + (object)
        + id: 4 (number)

ال 8 كومينتر

agougousis هل يمكنك تجربة ما يلي؟

nodes (array[object], fixed)

موافق! على الرغم من أنني لم أجد حتى الآن من أين جاء هذا العالم "الثابت" ، فقد اكتمل المخطط الآن.
ومع ذلك ، يبدو أن المخطط الناتج ليس صحيحًا.
المخطط الناتج هو:

pic3

ويجب أن يكون المخطط الصحيح:

pic4

هل انا مخطئ

هل يمكنك تجربة هذا؟

+ nodes (array, fixed)
    + (object)
        + id: 4 (number)

نعم! أفضل كثيرا! لم أكن أعتقد أنه يمكن تعريف الكائنات "المجهولة"!
لست متأكدًا ، لكنني أعتقد أن الأقواس المميزة في لقطة الشاشة التالية لا ينبغي أن تكون موجودة. ما رأيك؟
schema

agougousis الأقواس صحيحة لأن العناصر عبارة عن مصفوفة من الأنواع الممكنة

لا أتذكر القواعد جيدًا ، ولكن في http://jsonschema.net/ (حل سريع وقذر أستخدمه من وقت لآخر) عندما أعطي بيانات json كمدخلات ، فإنها تعطيني المخطط بدون هذه الأقواس .

agougousis استخدم fixed-type لهذا:

+ nodes (array, fixed-type)
    + (object)
        + id: 4 (number)

+1 للنوع الثابت

ثابت - مثيل من هذا النوع بنية وقيم ثابتة. تنتشر هذه السمة إلى أنواع الأعضاء المتداخلة.

نوع ثابت - مثيل هذا النوع من البنية ثابت ، والقيمة ليست كذلك. لا تنتشر هذه السمة إلى أنواع الأعضاء المتداخلة.

https://apiblueprint.org/documentation/mson/specification.html#353 -type-attribute

هل كانت هذه الصفحة مفيدة؟
0 / 5 - 0 التقييمات