zoukankan      html  css  js  c++  java
  • 文档注释

    代码规范之第一条:注释

    下面介绍Java代码的第一条内容,注释

    注释的作用:

    方便他人阅读你的程序

    API接口的使用说明

    方便代码debug

    (可以理解为一个说明语句的存在,在编译的过程中不会被编译成字节码文件)

    注释的种类:

    单行注释---"// + 内容 ---后面的内容均为注释"

    // 注释的内容
    多行注释---"/* + 内容 + */"

    /* 注释的内容
    多行注释
    很多行都可以进行注释
    */
    文档注释---"/** + 文档内容(写项目的时候可以是API) + */"

    /**
    文档内容 JavaDoc标签
    */
    文档注释的作用

    下面先来介绍一段代码在介绍文档注释的主要用途

    /**
    这是一个文档注释
    @author jun wei
    @version 1.0
    这是我的文档注释代码,very important!!!
    */
    public class HelloWorld2{
    public static void main(String[] args){
    System.out.println("Hi This is my Java project!");
    }
    /**
    @parametric name 姓名
    @parametric age 年龄
    @parametric sex 雄性
    */
    public void eat(String name,int age,String sex){
    System.out.println("Hi This is my Java project laborer!");
    }
    }
    文档注释的主要用处是配合jdk提供的javadoc.exe可以对注释文档进行解析,生成一套html的该程序的说明文档,(生成一个自定义类的API)。


    这里说明几个参数:

    -d---directory---目录名后面接的是你要生成的文件夹的名称

    -author---是文档注释里面的内容

    -version---也是文档注释里面的内容

    最后加的是你的java文件

    最后生成的是一个API文档


    It's a lonely road!!!
  • 相关阅读:
    struts2_文件上传和下载
    struts2_方法拦截器
    struts2_Action之间的重定向传参
    struts2_全局的拦截器,拦截用户非法登陆
    Hibernate入门心得
    struts2_异常页面处理
    设计师小法器:字体大管家
    IE6,IE7下设置body{overflow:hidden;}失效Bug【转】
    子层的margintop属性应用到父层上的解决方法
    jQuery CSS选择器nthchild
  • 原文地址:https://www.cnblogs.com/JunkingBoy/p/14378507.html
Copyright © 2011-2022 走看看