JSP中的注释
JSP中最好使用
// 这种注释优于 /**/ 因为MyEclips编辑器可以将这种注释内容显示为绿色，易于与代码区分
而不是
/* 这种注释尽量不要用，因为MyEclips将里面的内容显示为黑色，不易与代码区分开来 */
描述性注释
<%
//程序名称：通常是该JSP文件名
//程序功能：该JSP功能描述
//创建日期：2002-06-19 11:10:36（越精确越好）
//创建人 ：CrtHtml程序创建
//更新记录： 更新人 更新日期 更新原因/内容
// 人名 日期 原因
//例如： niuzj 2006-08-23 YDtm需要在录入受益人信息时增加一个“性别”字段
%>
幸福的JSP通常用于前台显示和数据提交，由于功能相对简单，我们不提倡在JSP中加入太多java风格的注释。
Javascript的注释
我们Test系统大部分javascript的注释写的较为凌乱，终其原因，大部分人都是以java软件工程师的身份进入公司，因此对javascript不够重视，实际上javascript是一种解释执行的语言，我们页面所运行的javascript实际上是每次客户端请求时从后台服务器发送过去的，因此javascript体积越小页面传输速度越快。
幸福项目组要求，新建立的.js文件在程序能够被理解的时候尽量不要在里面添加注释。
描述性注释示例，如果创建一份通用的js文件这部分信息是不可少的：
/*************************************************************************
* <p>Title: Test 1.0</p>
* <p>Description: SScompanyTest管理系统</p>
* <p>Copyright: Copyright (c) 2005 SScompany, Co.Ltd. All Rights Reserved</p>
* <p>Company: SScompany </p>
* <p>WebSite: http://www.SScompany.com.cn</p>
*
* @author : SScompany
* @version : 1.00
* @date : 2006-11-08
* @direction: Test系统多行显示/输入表格
* @comment : XinYQ formatted on 2006-11-08
**************************************************************************/
但如果仅仅是创建一份用于某个单独页面逻辑的js文件，还是不要增加太多注释了，会影响速度的。
解释性注释
用于对js的function进行注释
/*****************************************************
* 保存集体投保单的提交（function的功能描述）
* 参数 ： (行参，由于javascript的function行参是没有类型标志的，最好在此告知参数类型)
* 返回值： （返回信息，注意冒号与参数列表对齐，并描述返回值类型）
*****************************************************
*/
提示性注释
除较为复杂的算法外，本文档不建议在Javascript文件大量编写提示性注释，此外，也不建议将业务逻辑放在javascript中，因为除了效率的考虑之外，javascript的安全性也值得怀疑。
提示性注释举例：
this.formName = formName || "fm"; //表单名称
this.name = name || ""; //实例名称
this.count = 0; //行输入对象的行数
this.add = 1; //是否可以允许增加，删除1表示可以，0表示不可以
this.select = 0; //是否可以选择，1表示可以，0表示不可以
this.title = 1; //是否现实title 1表示显示，0表示不显示
javascript注释可以参看common包中公司前辈们的大作，有些程序至今无人能改。考虑到Test系统的总销售额，用一字千金来形容这些代码也不为过。
HTML的注释
HTML中主要是解释性注释，便于阅读者知道某一个TABLE或者DIV上应该输入什么样的 字段。
CCtm项目组的HTML中有两种主要注释方法
HTML风格的注释方法，可用于所有HTML和JSP文件
<!-- HTML注释，会被发送到客户端，考虑到安全性，不推荐使用 -->
JSP 的注释方法同样可以注释HTML模块功能，只能用于JSP文件
<%-- JSP引擎会自动忽略的注释，不会被发送到客户端，推荐使用 --%>
2008-5-20 21:26
以上文字来自以下地址：
http://blog.csdn.net/l0979365428/archive/2007/10/22/1836477.aspx
分享到：
相关推荐
本文将详细介绍在JSP页面中如何进行注释，帮助初学者更好地理解和掌握JSP注释的方法。 #### 二、JSP注释的重要性 注释是提高代码可读性和可维护性的关键因素之一。它可以帮助其他开发者更快地理解代码的功能和逻辑...
**JSP注释及其在浏览器源代码中的表现** 在JavaServer Pages (JSP) 技术中，注释是开发者用来记录代码逻辑、提供说明或临时排除部分代码的方法。注释对于代码的可读性和维护性至关重要。在JSP中有三种类型的注释...
笔记中提到了JSP中注释的两种类型：显式注释和隐式注释。显式注释（如`! %>`和`<%-- --%>`）会在最终的HTML页面中显示，而隐式注释（如`<% // %>`和`* */ %>`)则不会出现在客户端，仅用于开发者内部注释。这种区分...
在JSP中，可以使用HTML注释（`<!-- ... -->`）或Java注释（`//`, `/* ... */`）。Java注释在JSP被翻译成Servlet后仍保留，而HTML注释只对客户端可见。 **4. 指令** - `<%@ page %>`: 用于设置整个页面的属性，比如...
4. **JSP注释的作用** - **提高可读性**：注释能够帮助开发者理解代码的功能和目的，特别是在团队合作时。 - **调试辅助**：临时屏蔽代码块以进行调试时，注释可以起到关键作用。 - **版本控制**：在代码版本更新...
例如，以下代码片段展示了HTML注释中包含Java代码的情况： ```jsp 性别:select name="qureyItemGroup.sex" class="selinp" style="width:75px;"> 全部 这里有迭代器，但是由于是HTML注释，代码依然会执行： ...
3. **注释模板**：一个标准的JSP注释模板可能如下所示： ``` /** * @author [作者姓名] * @version [版本号] * @since [创建日期] * @function [功能描述] * @param [参数1] - [参数1描述] * @param [参数2]...
**JSP注释详解** 在JavaServer Pages (JSP) 中，注释是开发者用于记录代码逻辑、提高代码可读性和防止某些代码片段被解析或执行的重要工具。JSP提供了三种不同的注释格式，每种都有其特定的用途和可见性。 ### 一...
在这个09课堂案例中，我们专注于理解和使用JSP注释，这是一项重要的编程实践，有助于提高代码的可读性和维护性。以下是对案例内容的详细解释： ### 输出注释 输出注释是可以在页面上显示给用户的注释。在JSP中，...
Spring MVC 提供了一个灵活的架构，支持多种视图技术，如 JSP、FreeMarker 和 Velocity。 4. **AOP（面向切面编程）**：Spring 的 AOP 模块提供了面向切面编程的实现，允许开发者定义方法拦截器和切入点，以实现如...
在本文中，我们将深入探讨如何在JavaServer Pages (JSP) 中实现文件上传功能，并结合实际的代码注释进行详细讲解。文件上传是Web应用程序中常见的功能，它允许用户将本地计算机上的文件发送到服务器。在JSP中，我们...
本篇文档主要介绍了JSP中的三种注释方式以及两种重要的JSP动作——`jsp:useBean`和`jsp:setProperty`。 首先，JSP提供了三种注释方式： 1. **HTML注释**：这种注释方式对客户端可见，因为它会被发送到浏览器。例如...
用java编写的代码注释删除小工具，能去文本中掉//和/* */注释。 第一个按钮的功能为去掉文本框1中代码的注释，输出到文本框2. 第二个按钮的功能为批量删除文件中的注释，并输出到当前目录（新文件名为xxx.txt）。但...
6. **安全性**：源码中的注释可能涵盖了如何防止SQL注入、XSS攻击等安全措施，例如使用预编译语句（PreparedStatement）来防止SQL注入，对用户输入进行过滤和转义以防止XSS攻击。 7. **用户认证和授权**：系统可能...
1. **JSP注释**：这种注释仅在源代码中可见，在服务器编译JSP为Servlet时会被忽略。 ```jsp 这是JSP注释 --%> ``` 2. **Java注释**：这种注释与Java代码中的注释相同，会在编译时被保留。 ```jsp <!-- 这是...
2. **JSP注释**：`这是JSP注释 --%>`，服务器端处理时会忽略，不会发送到客户端。 JSP标准动作（JSP Actions）是基于XML的标签，用于简化某些功能，比如： 1. **jsp:include**：动态包含其他资源。 2. **jsp:...
JSP 中还有一些其他类型的注释符号，如 scriptlet、声明、表达式和指令等。 MySQL 注释 MySQL 中的注释符号为： 1. 单行注释：使用 `#` 开头，例如：`# 这是一个单行注释` 2. 单行注释：使用 `--` 开头，但需要在...
### 4.2 JSP注释 JSP提供了两种注释方式： - **JSP隐藏注释**：`<%-- comment --%>`，在执行过程中被忽略，不显示给客户端。 - **HTML注释**：`<!-- comment -->`，在客户端查看源代码时可见。 例如，文件`...