Как можно документировать файл JSP ".tag"?
Существует файл тегов JSP, например:
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ attribute name="attr" required="true" type="java.lang.String" rtexprvalue="true" description="FOOO" %>
<%@ attribute name="var" required="true" type="java.lang.String" rtexprvalue="false" description="BAAR" %>
<%@ variable name-from-attribute="var" variable-class="java.lang.String" alias="attrValue" scope="AT_BEGIN" %>
<c:set var="attrValue" value="${requestScope[attr]}" />
Кажется, можно документировать атрибуты. Как добавить документацию к самому тегу?
1 ответ
Решение
Подходящим местом для описания тега и его свойств (включая атрибуты) является дескриптор библиотеки тегов. description
атрибут attribute
Директива является ИМХО пережитком "из темного прошлого" и в настоящее время не имеет реального применения.