docs: add dynamic sql example to @select

Signed-off-by: DevDengChao <[email protected]>

Author: DevDengChao

pom.xml

@@ -106,6 +106,10 @@
       <name>Tomáš Neuberg</name>
       <email>[email protected]</email>
     </contributor>
+    <contributor>
+      <name>DevDengChao</name>
+      <email>[email protected]</email>
+    </contributor>
   </contributors>
 
   <scm>

src/main/java/org/apache/ibatis/annotations/Select.java

@@ -26,15 +26,34 @@
  * The annotation that specify an SQL for retrieving record(s).
  * <p>
  * <b>How to use:</b>
- *
- * <pre>
- * public interface UserMapper {
- *   &#064;Select("SELECT id, name FROM users WHERE id = #{id}")
- *   User selectById(int id);
- * }
- * </pre>
+ * <br/>
+ * <ul>
+ *   <li>
+ *   Simple:
+ *   <pre>
+ *   public interface UserMapper {
+ *       &#064;Select("SELECT id, name FROM users WHERE id = #{id}")
+ *       User selectById(int id);
+ *   }
+ *   </pre>
+ *   </li>
+ *   <li>
+ *   Dynamic SQL:
+ *   <pre>
+ *   public interface UserMapper {
+ *       &#064;Select({"&lt;script>",
+ *           "select * from users",
+ *           "where name = #{name}",
+ *           "&lt;if test="age != null"> age = #{age} &lt;/if>",
+ *           "&lt;/script>"})
+ *       User select(@NotNull String name, @Nullable Intger age);
+ *   }
+ *   </pre>
+ *   </li>
+ * </ul>
  *
  * @author Clinton Begin
+ * @see <a href="https://mybatis.org/mybatis-3/dynamic-sql.html">How to use Dynamic SQL</a>
  */
 @Documented
 @Retention(RetentionPolicy.RUNTIME)