Add cache annotation extractor

Annotation/ApiDoc.php

@@ -105,6 +105,11 @@ class ApiDoc
      */
     private $authentication = false;
 
+    /**
+     * @var int
+     */
+    private $cache;
+
     /**
      * @var array
      */
@@ -328,6 +333,22 @@ class ApiDoc
         $this->authentication = $authentication;
     }
 
+    /**
+     * @return int
+     */
+    public function getCache()
+    {
+        return $this->cache;
+    }
+
+    /**
+     * @param int $cache
+     */
+    public function setCache($cache)
+    {
+        $this->cache = (int) $cache;
+    }
+
     /**
      * @return array
      */
@@ -370,6 +391,10 @@ class ApiDoc
             $data['section'] = $section;
         }
 
+        if ($cache = $this->cache) {
+            $data['cache'] = $cache;
+        }
+
         $data['https'] = $this->https;
         $data['authentication'] = $this->authentication;
 

Extractor/ApiDocExtractor.php

@@ -30,6 +30,8 @@ class ApiDocExtractor
 
     const JMS_SECURITY_EXTRA_SECURE_CLASS = 'JMS\\SecurityExtraBundle\\Annotation\\Secure';
 
+    const CACHE_ANNOTATION_CLASS          = 'Sensio\\Bundle\\FrameworkExtraBundle\\Configuration\\Cache';
+
     /**
      * @var ContainerInterface
      */
@@ -364,6 +366,8 @@ class ApiDocExtractor
                 ));
             } elseif (is_a($annot, self::JMS_SECURITY_EXTRA_SECURE_CLASS)) {
                 $annotation->setAuthentication(true);
+            }  elseif (is_a($annot, self::CACHE_ANNOTATION_CLASS)) {
+                $annotation->setCache($annot->getMaxAge());
             }
         }
     }

Resources/views/method.html.twig

@@ -165,6 +165,11 @@
                 </table>
             {% endif %}
 
+            {% if data.cache is defined and data.cache is not empty %}
+                <h4>Cache</h4>
+                <div>{{ data.cache }}s</div>
+            {% endif %}
+
             </div>
 
             {% if enableSandbox %}