【java】 jsp/javaBean javaDoc

什么是JavaDoc？

文档标记

JDK定义好的，
如 @author、@version、@since、@see、@link、@code、@param、@return、@exception、@throws等。

写在类上的文档标注(javadoc)

• 概要：文档标注，用于标注作者、创建时间、参阅类等信息
• 详细：参数和参数描述，其他说明，一般每段话都以英文句号作为结束
• 文档标注，用于标注作者、创建时间、参阅类等信息

/*
* @link String
* @param <E> the type of elements in this list
*
* @author Rod Johnson
* @since 16 April 2001
* @version 1.0
* @see <a href="package-summary.html">java.util.stream</a>
*
* */

写在方法上的标注(javadoc)

• 概要描述，通常用一句或者一段话简要描述该方法的作用，以英文句号作为结束
• 详细描述，通常用一段或者多段话来详细描述该方法的作用，一般每段话都以英文句号作为结束
• 文档标注，用于标注参数、返回值、异常、参阅等

/*
* @param str the {@code CharSequence} to check (may be {@code null})
* @return {@code true} if the {@code CharSequence} is not {@code null},
* @see Character#isWhitespace
* @throws IllegalArgumentException when the given source contains invalid encoded sequences
* @exception IllegalArgumentException if <code>key</code> is null.
* {@value}  表示常量
* @inheritDoc 用于注解在重写方法或者子类上，用于继承父类中的Javadoc
* */

 

---

什么是JavaBean[java class]

• 属性必须私有化
• idea 自动生成 getter /setter 方法（或者其他编辑器）
• 默认或者显示有一个无参构造函数+
• 有命名规范 

eg:
name属性的修改器名称为setName，password属性的修改器名称为setPassword。

用途

• JavaBean在J2EE开发中，通常用于封装数据,可以通过反射技术实例化JavaBean对象
• 一个JavaBean的某个属性也可以只有set方法或get方法，这样的属性通常也称之为只写、只读属性。

javaBean/jsp

• <jsp:useBean>标签：用于在JSP页面中查找或实例化一个JavaBean组件。
• <jsp:setProperty>标签：用于在JSP页面中设置一个JavaBean组件的属性。
• <jsp:getProperty>标签：用于在JSP页面中获取一个JavaBean组件的属性。

 

<jsp:useBean ...> 
   Body 
</jsp:useBean> 

• Body部分的内容只在<jsp:useBean>标签创建JavaBean的实例对象时才执行。

jsp/执行原理

• jsp文件在执行的过程中首先会翻译成一个servlet(java) 实例化一个 java 类

 

---

参考链接

https://www.cnblogs.com/zterry/p/6863388.html   javaBean/jsp

https://blog.csdn.net/vbirdbest/article/details/80296136 Javadoc 使用