From 7f8a4d4b595f9e148cc9e8d71cc6278d856c3fe5 Mon Sep 17 00:00:00 2001
From: Dominik Liebler <liebler.dominik@googlemail.com>
Date: Sat, 21 Sep 2013 23:31:14 +0200
Subject: [PATCH 1/2] added XML namespace and XSD

---
 DependencyInjection/NelmioApiDocExtension.php | 16 ++++
 Resources/config/schema/api_doc.xsd           | 85 +++++++++++++++++++
 2 files changed, 101 insertions(+)
 create mode 100644 Resources/config/schema/api_doc.xsd

diff --git a/DependencyInjection/NelmioApiDocExtension.php b/DependencyInjection/NelmioApiDocExtension.php
index d26a39d..9decfec 100644
--- a/DependencyInjection/NelmioApiDocExtension.php
+++ b/DependencyInjection/NelmioApiDocExtension.php
@@ -50,4 +50,20 @@ class NelmioApiDocExtension extends Extension
             $container->setParameter('nelmio_api_doc.sandbox.authentication', $config['sandbox']['authentication']);
         }
     }
+
+    /**
+     * @return string
+     */
+    public function getNamespace()
+    {
+        return 'http://nelmio.github.io/schema/dic/nelmio_api_doc';
+    }
+
+    /**
+     * @return string
+     */
+    public function getXsdValidationBasePath()
+    {
+        return __DIR__ . '/../Resources/config/schema';
+    }
 }
diff --git a/Resources/config/schema/api_doc.xsd b/Resources/config/schema/api_doc.xsd
new file mode 100644
index 0000000..66f36a9
--- /dev/null
+++ b/Resources/config/schema/api_doc.xsd
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<xsd:schema xmlns="http://nelmio.github.io/schema/dic/nelmio_api_doc"
+    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+    targetNamespace="http://nelmio.github.io/schema/dic/nelmio_api_doc"
+    elementFormDefault="qualified">
+
+    <xsd:element name="config">
+        <xsd:complexType>
+            <xsd:sequence>
+                <xsd:element name="name" type="xsd:string" minOccurs="0" maxOccurs="1"/>
+                <xsd:element name="motd" type="motd" minOccurs="0" maxOccurs="1"/>
+                <xsd:element name="request_listener" type="request_listener" minOccurs="0" maxOccurs="1"/>
+                <xsd:element name="sandbox" type="sandbox" minOccurs="0" maxOccurs="1"/>
+            </xsd:sequence>
+        </xsd:complexType>
+    </xsd:element>
+
+    <xsd:complexType name="motd">
+        <xsd:sequence>
+            <xsd:element name="template" type="xsd:string" minOccurs="0" maxOccurs="1"/>
+        </xsd:sequence>
+    </xsd:complexType>
+
+    <xsd:complexType name="request_listener">
+        <xsd:sequence>
+            <xsd:element name="enabled" default="true" type="xsd:boolean" minOccurs="0" maxOccurs="1"/>
+            <xsd:element name="parameter" default="_doc" type="xsd:string" minOccurs="0" maxOccurs="1"/>
+        </xsd:sequence>
+    </xsd:complexType>
+
+    <xsd:complexType name="sandbox">
+        <xsd:sequence>
+            <xsd:element name="enabled" default="true" type="xsd:boolean" minOccurs="0" maxOccurs="1"/>
+            <xsd:element name="endpoint" nillable="true" type="xsd:string" minOccurs="0" maxOccurs="1"/>
+            <xsd:element name="accept_type" type="xsd:string" minOccurs="0" maxOccurs="1"/>
+            <xsd:element name="body_format" type="body_format_enum" minOccurs="0" maxOccurs="1"/>
+            <xsd:element name="request_format" type="request_format" minOccurs="0" maxOccurs="1"/>
+            <xsd:element name="authentication" type="authentication" minOccurs="0" maxOccurs="1"/>
+        </xsd:sequence>
+    </xsd:complexType>
+
+    <xsd:simpleType name="body_format_enum">
+        <xsd:restriction base="xsd:string">
+            <xsd:enumeration value="form"/>
+            <xsd:enumeration value="json"/>
+        </xsd:restriction>
+    </xsd:simpleType>
+
+    <xsd:complexType name="request_format">
+        <xsd:sequence>
+            <xsd:element name="method" type="request_format_method_enum" minOccurs="0" maxOccurs="1"/>
+            <xsd:element name="default_format" type="request_format_default_format_enum" minOccurs="0" maxOccurs="1"/>
+        </xsd:sequence>
+    </xsd:complexType>
+
+    <xsd:simpleType name="request_format_method_enum">
+        <xsd:restriction base="xsd:string">
+            <xsd:enumeration value="format_param"/>
+            <xsd:enumeration value="accept_header"/>
+        </xsd:restriction>
+    </xsd:simpleType>
+
+    <xsd:simpleType name="request_format_default_format_enum">
+        <xsd:restriction base="xsd:string">
+            <xsd:enumeration value="json"/>
+            <xsd:enumeration value="xml"/>
+        </xsd:restriction>
+    </xsd:simpleType>
+    
+    <xsd:complexType name="authentication">
+        <xsd:sequence>
+            <xsd:element name="name" type="xsd:string" maxOccurs="1"/>
+            <xsd:element name="delivery" type="authentication_delivery_enum" maxOccurs="1"/>
+            <xsd:element name="custom_endpoint" type="xsd:boolean" default="false" minOccurs="0" maxOccurs="1"/>
+        </xsd:sequence>
+    </xsd:complexType>
+
+    <xsd:simpleType name="authentication_delivery_enum">
+        <xsd:restriction base="xsd:string">
+            <xsd:enumeration value="query"/>
+            <xsd:enumeration value="http_basic"/>
+            <xsd:enumeration value="header"/>
+        </xsd:restriction>
+    </xsd:simpleType>
+</xsd:schema>

From 7ba7ea40368a182fc2363bc59b54263f227eeaa6 Mon Sep 17 00:00:00 2001
From: Dominik Liebler <liebler.dominik@googlemail.com>
Date: Mon, 23 Sep 2013 13:46:32 +0200
Subject: [PATCH 2/2] changed XSD elements to attributes

---
 Resources/config/schema/api_doc.xsd | 44 +++++++++++------------------
 1 file changed, 17 insertions(+), 27 deletions(-)

diff --git a/Resources/config/schema/api_doc.xsd b/Resources/config/schema/api_doc.xsd
index 66f36a9..b8c97ab 100644
--- a/Resources/config/schema/api_doc.xsd
+++ b/Resources/config/schema/api_doc.xsd
@@ -6,37 +6,31 @@
 
     <xsd:element name="config">
         <xsd:complexType>
-            <xsd:sequence>
-                <xsd:element name="name" type="xsd:string" minOccurs="0" maxOccurs="1"/>
+            <xsd:all>
                 <xsd:element name="motd" type="motd" minOccurs="0" maxOccurs="1"/>
                 <xsd:element name="request_listener" type="request_listener" minOccurs="0" maxOccurs="1"/>
                 <xsd:element name="sandbox" type="sandbox" minOccurs="0" maxOccurs="1"/>
-            </xsd:sequence>
+            </xsd:all>
+            <xsd:attribute name="name" type="xsd:string"/>
         </xsd:complexType>
     </xsd:element>
 
     <xsd:complexType name="motd">
-        <xsd:sequence>
-            <xsd:element name="template" type="xsd:string" minOccurs="0" maxOccurs="1"/>
-        </xsd:sequence>
+        <xsd:attribute name="template" type="xsd:string"/>
     </xsd:complexType>
 
     <xsd:complexType name="request_listener">
-        <xsd:sequence>
-            <xsd:element name="enabled" default="true" type="xsd:boolean" minOccurs="0" maxOccurs="1"/>
-            <xsd:element name="parameter" default="_doc" type="xsd:string" minOccurs="0" maxOccurs="1"/>
-        </xsd:sequence>
+        <xsd:attribute name="enabled" default="true" type="xsd:boolean"/>
+        <xsd:attribute name="parameter" default="_doc" type="xsd:string"/>
     </xsd:complexType>
 
     <xsd:complexType name="sandbox">
-        <xsd:sequence>
-            <xsd:element name="enabled" default="true" type="xsd:boolean" minOccurs="0" maxOccurs="1"/>
-            <xsd:element name="endpoint" nillable="true" type="xsd:string" minOccurs="0" maxOccurs="1"/>
-            <xsd:element name="accept_type" type="xsd:string" minOccurs="0" maxOccurs="1"/>
-            <xsd:element name="body_format" type="body_format_enum" minOccurs="0" maxOccurs="1"/>
-            <xsd:element name="request_format" type="request_format" minOccurs="0" maxOccurs="1"/>
-            <xsd:element name="authentication" type="authentication" minOccurs="0" maxOccurs="1"/>
-        </xsd:sequence>
+        <xsd:attribute name="enabled" default="true" type="xsd:boolean"/>
+        <xsd:attribute name="endpoint" type="xsd:string"/>
+        <xsd:attribute name="accept_type" type="xsd:string"/>
+        <xsd:attribute name="body_format" type="body_format_enum"/>
+        <xsd:attribute name="request_format" type="request_format"/>
+        <xsd:attribute name="authentication" type="authentication"/>
     </xsd:complexType>
 
     <xsd:simpleType name="body_format_enum">
@@ -47,10 +41,8 @@
     </xsd:simpleType>
 
     <xsd:complexType name="request_format">
-        <xsd:sequence>
-            <xsd:element name="method" type="request_format_method_enum" minOccurs="0" maxOccurs="1"/>
-            <xsd:element name="default_format" type="request_format_default_format_enum" minOccurs="0" maxOccurs="1"/>
-        </xsd:sequence>
+        <xsd:attribute name="method" type="request_format_method_enum"/>
+        <xsd:attribute name="default_format" type="request_format_default_format_enum"/>
     </xsd:complexType>
 
     <xsd:simpleType name="request_format_method_enum">
@@ -68,11 +60,9 @@
     </xsd:simpleType>
     
     <xsd:complexType name="authentication">
-        <xsd:sequence>
-            <xsd:element name="name" type="xsd:string" maxOccurs="1"/>
-            <xsd:element name="delivery" type="authentication_delivery_enum" maxOccurs="1"/>
-            <xsd:element name="custom_endpoint" type="xsd:boolean" default="false" minOccurs="0" maxOccurs="1"/>
-        </xsd:sequence>
+        <xsd:attribute name="name" type="xsd:string"/>
+        <xsd:attribute name="delivery" type="authentication_delivery_enum"/>
+        <xsd:attribute name="custom_endpoint" type="xsd:boolean" default="false"/>
     </xsd:complexType>
 
     <xsd:simpleType name="authentication_delivery_enum">