今天在群里看到有人分享了一段搞笑的注释代码,觉得挺好玩的,在这里收藏一下 // _ooOoo_ // o8888888o // 88" . "88 // (| -_- |) // O\ = /O // ____/`---'\____ // . ' \\| |// `. // / \\||| : |||// \ // / _||||| -:- |||||- \ // | | \\\ - /// | | // | \_| ''\---/'' | | // \ .-\__ `-` ___/-

java代码注释规范   代码注释是架起程序设计者与程序阅读者之间的通信桥梁,最大限度的提高团队开发合作效率.也是程序代码可维护性的重要环节之一.所以我们不是为写注释而写注释.下面说一下我们在诉求网二期开发中使用的代码注释规范,供大家参考下. 原则: 1.注释形式统一 在整个应用程序中,使用具有一致的标点和结构的样式来构造注释.如果在其它项目中发现它们的注释规范与这份文档不同,按照这份规范写代码,不要试图在既成的规范系统中引入新的规范. 2.注释内容准确简洁 内容要简单.明了.含义准确,防止注释

一.目的 1.  为什么需要注释规范? 注释规范对于程序员而言尤为重要,有以下几个原因: 一个软件的生命周期中,80%的花费在于维护. 几乎没有任何一个软件,在其整个生命周期中,均由最初的开发人员来维护 注释规范可以改善软件的可读性,可以让程序员尽快而彻底地理解新的代码 统一的注释规范可以快速生成文档说明 二.注释说明 Java 程序有两类注释:归档(文本/文档)注释(document comments)和实现注释(implementation comments). 归档注释:采用java do

代码注释是架起程序设计者与程序阅读者之间的通信桥梁,最大限度的提高团队开发合作效率.也是程序代码可维护性的重要环节之一.所以我们不是为写注释而写注释.下面说一下我们在诉求网二期开发中使用的代码注释规范,供大家参考下. 原则: 1.注释形式统一 在整个应用程序中,使用具有一致的标点和结构的样式来构造注释.如果在其它项目中发现它们的注释规范与这份文档不同,按照这份规范写代码,不要试图在既成的规范系统中引入新的规范. 2.注释内容准确简洁 内容要简单.明了.含义准确,防止注释的多义性,错误的注释不但无

有时为了信息保密或是单纯阅读代码,我们常常需要删除注释. 之前考虑过正则表达式,但是感觉实现起来相当麻烦.而状态机可以把多种情况归为一类状态再行分解,大大简化问题.本文就是基于状态机实现的. 删除C/C++代码注释 需要考虑的情况 // /* */ //和/* */嵌套(注意不存在/* */和/* */嵌套) 折行注释(用\间隔) 字符中存在的/和* 字符串中存在的//和/* */ 字符串中的折行代码(用\间隔) 头文件中可能存在的/ 状态转移描述 这里的内容参考了博客http://www.cn

eclipse中添加Java代码注释模板 1.Window->Preference->Java->Code Style->Code Template,进入注释编辑界面 2.文件(Files)标签注释 3.类型(Types)标签注释(类的注释) 4.字段(Fields)标签注释 5.构造函数(Constructor )标签 6.方法(Methods)标签注释 7.覆盖方法(Overriding Methods)标签注释 8.代表方法(Delegate Methods)标签注释 9.G

单行注释: 选中代码,按下ctrl+/ 一条代码单行注释:选中一条代码按下ctrl+/,则为一条代码单行注释: 多条代码单行注释:选中多条代码按下ctrl+/,则为多条代码单行注释: 取消注释:对已经注释好的代码选中再次按下ctrl+/,则取消注释. public class PrintDemo { public static void main(String[] args) { // System.out.print("Hello"); 一条代码单行注释 // System.out.

1. 引言     团队开发时,业务模块分配的越清晰,代码注释管理越完善,越有利于后面维护,后面再管理也方便不少.另外也起着"文字砖"的作用,你懂的.注释不需要很详细,把代码块方法块功能简述一下就行.不然三月后回头看就要骂人了,骂完发现是自己写的,啧啧啧...     三种常用的 Java 注释方式 // 声明常量 int number; /* * 类主函数 */ public static void main(String[] args) { } /** * @param maste

今天在查看曾经写过的代码时发生了一件很是让人头疼的事: 我写的所有注释全部都变成了了乱码,曾经刚入门时也是经常遇到类似的问题,解决起来很快,每天可能都会在工作空间里看到,但是随着时间的推移,写代码的规范也越来越标准,这类问题很少遇到,于是它就随着时间淡化了,今天我可是挠破了头皮在解决掉这个麻烦,下面看分析: Eclipse JAVA文件注释乱码将别人的项目或JAVA文件导入到自己的Eclipse中时,常常会出现JAVA文件的中文注释变成乱码的情况,主要原因就是别人的IDE编码格式和自己的Ecli

1定义java文件头部的注释 2给java类中的方法添加上注释 2.1第一步勾选Enable Live  Templates 2.2第二步新建一个Group 2.3第三步新建一个Template 2.4第四步点击Define按钮 2.5第五步填写注释模板 1.定义java文件头部的注释 打开设置面板,然后填写注释模板: File  => setting  => editor =>  File and Code Templates 如图: 2.给java类中的方法添加上注释 2.1.第一步

Eclipse JAVA文件注释乱码将别人的项目或JAVA文件导入到自己的Eclipse中时,常常会出现JAVA文件的中文注释变成乱码的情况,主要原因就是别人的IDE编码格式和自己的Eclipse编码格式不同. 总结网上的建议和自己的体会,可以参考以下几种解决方式: 1 改变整个文件类型的编码格式1) eclipse->window->preferences->General->Content Types2) 找到要修改的文件的类型(JAVA,JSP等等),在下面有个Default

Java SE 基础:注释 一.注释定义 用于解释说明程序的文字. 二.注释的作用 1.解释说明程序,提高程序的可读性 2.可以帮助我们调试程序:通过注释代码块,检测错误位置 三.格式 1.单行注释 // 注释内容 2.多行注释 /* 注释内容 */ 3.文档注释 /** 注释内容 */ 三.关于注释 在写程序时应当养成良好的习惯:先写注释,后写代码.应当每行代码都有注释(当然 int age 这样见名知意的代码可以忽略).一个项目中注释的数量差不多为整个项目代码量的 2/3 .请养成写注释的习

转载自:http://blog.163.com/hui_san/blog/static/5710286720104191100389/ 前言 Java 的语法与 C++ 及为相似,那么,你知道 Java 的注释有几种吗? 1)// 注释一行   2)/* ...... */ 注释若干行 3)/** ...... */ 注释若干行,并写入 javadoc 文档 通常这种注释的多行写法如下: /**   * .........   * .........   */ 这第三种注释有什么用?javado

eclipse 代码中文注释乱码 求解决 将别人的项目或JAVA文件导入到自己的Eclipse中时,常常会出现JAVA文件的中文注释变成乱码的情况,主要原因就是别人的IDE编码格式和自己的Eclipse编码格式不同.总结网上的建议和自己的体会,可以参考以下几种解决方式: 1 改变整个文件类型的编码格式 1) eclipse->window->preferences->General->Content Types 2) 找到要修改的文件的类型(JAVA,JSP等等),在下面有个Def

1.类注释 Window->Preference->Java->Code Style->Code Template alt+shift+J 默认的快捷键 或者 先敲“/”在敲两个**,然后回车 /** * @Description 学习使用sikuli * @author Administrator * @Date 2016年7月13日 * @Time 下午9:57:02 */ 如果把时间设置成 @Date ${Date}${Time},则时间效果如下  @Date 2016年7月

产品地址:https://www.eolinker.com开源代码:https://www.eolinker.com/#/os/download在线生成代码注释工具:http://tool.eolinker.com/doc2code注释生成文档脚本:https://github.com/eolinker/Code2Doc eoLinker提供了从代码注释直接生成接口文档的功能,有效地将接口文档与代码实现了同步.本篇文章将详细介绍如何通过eoLinker的Python脚本程序来生成文档. [必要条

前言: 一般写完代码之后,还要将各类参数注解写入API文档,方便后续进行对接和测试,这个过程通常都很麻烦,如果有工具可以读取代码注释直接生成API文档的话,那会十分方便. 此前一直都是在使用eolinker的,但自从去年他们家"注释生成文档"的功能下线后,我就一直活在水深火热当中--真的不想写文档啊,真的好累啊. 然而这两天上线后,突然发现这个功能重新上线了!必须给大家安利一波! 官网地址:https://www.eolinker.com 根据官方的解释,这个功能简单来说就是读取 gi

定义函数 Kotlin定义一个函数的风格大致如下 访问控制符 fun 方法名(参数,参数,参数) : 返回值类型{ ... ... } 访问控制符:与Java有点差异,Kotlin的访问范围从大到小分别是public.internal.protected.private,不声明默认是public: 返回值类型:不需要返回类型的函数,后面的 : 返回值类型可以缺省(这里可以看到无论是变量还是方法,Kotlin都喜欢名字在前,类型在后): /***Kotlin版代码***/ //有返回参数的函数 f

4.7 代码注释与编码规范 在程序代码中适当的添加注释可以提高程序的可读性和可维护性.好的编码规范可以使程序更易阅读和理解.下面我们将介绍几种代码注释,以及应该注意的编码规范. 4.7.1 代码注释 通过在程序代码中添加注释可提高程序的阅读性.注释中包含了程序的信息,可以帮助程序员更好地阅读和理解程序.在Java源程序的任意位置都可以添加注释语句.注释中的文字Java编译器不进行编译,所有代码中的注释文字对程序不产生任何影响.Java语言提供了3种添加注释的方法,分别为单行注释.多行注释和文档注

通常我们需要在源代码中添加文字用来对进行代码解释说明,但这些文字并不是Java代码的语法,会导致编译出错.这时我们可以使用注释来完成这一事项! 在编译时,编译器会忽略注释的存在,就好像注释内容不存在一样.所以注释并不会导致编译出错,同时注释还方便编写者和其他人阅读源代码,加强对代码的理解. Java中提供了三种注释方式,分别是: l  单行注释    //注释内容 l  多行注释    /*注释内容*/ l  文档注释          /**注释内容*/ 其中文档注释与多行注释作用基本相同,唯