添加注释

        最近在重构的时候遇到问题,在网上进行查找,看到好多人的博客里代码都有类头注释,写着一些详细的信息。刚开始以为就是像行注释一样,自己手动添加的,然后每个类都来复制粘贴一下,后来一想机房那么多的类,这多麻烦呀,再说了有好几个地方都不一样呢,所以就动手查了查,原来是自己编写好的,然后在新建类时VS就能自动的为我们添加提前写好的类头注释。下面来看一下类头注释的步骤:

        一、找到Class.vb这个文件,以记事本的方式打开。(直接搜索即可找到;或是手动查找:找到VS的安装目录,依次进入vs\Common7\IDE\ItemTemplatesCache\VisualBasic\Code\2052\Class,便可找到Class.vb这个文件)          



    二、把相关的内容添加进去并保存即可。


     三、 以后建立新类的时候就会自动添加类头注释。


   

     下面是注释模板中的一些参数:

                                              

参数

描述

clrversion

当前系统CLR版本号

GUID [1-10]

生成全局唯一标识符,可以生成10个 (例如:guid1)

itemname

打开添加新建项时输入的文件名称

machinename

当前机器的名称(如:XXXX)

registeredorganization

注册的组织名,可以是小组名

rootnamespace

当前系统的根命名空间

safeitemname

保存的文件名,名称移除了不安全的字符和空格

time

当前系统时间,格式:DD/MM/YYYY 00:00:00.

userdomain

用户所在的域

username

当前系统用户名

year

当前系统年份 YYYY

     

       注意:我们这里是以Class为例写的类头注释,我们可以给其他的内容自行定义注释,大家尽情的尝试吧……

我们在重构中用到了很多的方法,所以摸索着又发现了对方法的注释:


        注释这个东东,我们在第一遍机房的时候,写过过程注释和行注释,重构的时候又添加了类头注释和方法注释,可见注释对我们走向专业化是很重要的呀!老师总是强调我们会是一个团队在工作,我们要时刻的为人民服务!

Tomcat是一个开源的Servlet容器,它实现了Java Servlet和JavaServer Pages (JSP) 规范。Tomcat代码加注释,通常指的是在Tomcat的源代码中加入注释,以帮助开发者更好地理解和维护代码。注释通常用于解释代码的作用、说明算法逻辑、提供使用示例或说明代码的限制和注意事项等。 在Java代码中,注释可以分为单行注释和多行注释: - 单行注释:以两个斜杠(//)开头,直到行末的内容都会被当作注释。 ```java // 这是一个单行注释示例 int i = 1; // 这个变量用于计数 ``` - 多行注释:以一个斜杠后跟一个星号(/*)开头,以一个星号后跟一个斜杠(*/)结尾,两者的中间部分是注释内容。 ```java /* 这是一个多行注释示例。 这段注释跨越了多行。 */ int j = 2; /* 在声明变量的同时,也可以做行内注释 */ ``` 对于Tomcat这样的大型项目,开发者通常会在公共接口、关键方法、复杂逻辑以及不直观的代码段添加注释。此外,还可以使用Javadoc工具来自动生成基于注释的文档,这些文档可以包括方法的用途、参数说明、返回值和异常等信息,有助于其他开发者了解API的使用方法。 为了在Tomcat中加注释,开发者需要了解Tomcat的架构和代码结构。由于Tomcat是用Java编写的,因此需要遵循Java注释的规则。以下是一些常见的注释实践: 1. 在类的顶部注释中说明类的作用、创建者和创建日期等。 2. 在方法上方注释中说明方法的功能、参数、返回值和可能抛出的异常。 3. 在复杂算法或实现逻辑前添加注释,解释其工作原理和使用场景。 4. 在代码变动或重要修改时,添加注释说明改动的原因和影响。 注释不仅能帮助其他开发者,还能在未来为开发者自身回顾和维护代码提供便利。
评论 32
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值