Merge pull request #55 from vsodhi/MTA-3334

MTA-3334 -JAVA annotation

Author: raoradhika

docs/topics/create-yaml-rule.adoc

@@ -28,7 +28,7 @@ The table below lists the available providers and their capabilities. Select a p
 
 .2+.^|`java`
 |`referenced`
-|Finds references of a pattern with an optional code location for detailed searches
+|Finds references of a pattern, including annotations, with an optional code location for detailed searches
 
 |`dependency`
 |Checks whether the application has a given dependency
@@ -71,14 +71,17 @@ The table below lists all available providers, their capabilities, and their fie
 |===
 |Provider |Capability |Field |Required? |Description
 
-.6+.^|`java`
-.2+.^|`referenced`
+.7+.^|`java`
+.3+.^|`referenced`
 |`pattern`
 |Yes
 |RegEx pattern
 |`location`
 |No
 |Source code location; see below for a list of all supported search locations
+|`annotated`
+|No
+|Annotations and their elements (name and value)
 
 .4+.^|`dependency`
 |`name`
@@ -203,9 +206,3 @@ when:
       location: IMPORT
       pattern: junit.junit
 ----
-
-
-
-
-
-

docs/topics/yaml-rule-structure-syntax.adoc

@@ -361,17 +361,28 @@ This provider has the following capabilities:
 
 .`referenced`
 
-The `referenced` capability enables the provider to find references in the source code. This capability takes two input parameters, `pattern` and `location`.
+The `referenced` capability enables the provider to find references in the source code. This capability takes three input parameters: `pattern`, `location`, and 'annotated'.
 
 [source,terminal]
 ----
 when:
   java.referenced:
     pattern: "<pattern>" <1>
     location: "<location>" <2>
+    annotated: "<annotated>" <3>
 ----
 <1> A regular expression pattern to match, for example, `org.kubernetes.*`.
 <2> Specifies the exact location where the pattern needs to be matched, for example, `IMPORT`.
+<3> Checks for specific annotations and their elements, such as name and value in the Java code using a query. For example, the following query matches the Bean(url = “http://www.example.com”) annotation in the method.
++
+[source,terminal]
+----
+ annotated:
+      pattern: org.framework.Bean
+      elements:
+      - name: url
+        value: "http://www.example.com"
+----
 
 The supported locations are the following:
 
@@ -385,6 +396,8 @@ The supported locations are the following:
 * `RETURN_TYPE`
 * `IMPORT`
 * `VARIABLE_DECLARATION`
+* `FIELD`
+* `METHOD`
 
 .`dependency`