类的无参方法和Doc注释

Posted 2020-11-09 農農

一:Java Doc注释:

语法:

/**

*AccpSchool 类

*@author JadeBird

*@version 1.0 2018/5/26

*/

Java Doc是前Sun公司提供的一种技术,它能够从程序代码中抽取类,方法,成员等的注释,形成一个和源代码配套的API帮助文档(简答地说,就是介绍该类,类的方法和成员变量的文档).

因此只要在编写程序时以一套特定的标签作为注释,在程序编写完成后,通过JavaDoc技术就可以同时生产程序的开发文档,这正是它的优势所在.

 

>JavaDoc注释以"/**"开头,以"*/"结尾.

>每个注释包含一些描述性的文本及若干个JavaDoc标签

>JavaDoc标签一般以"@"为前缀,

>常用的JavaDoc标签:@author>作者   @parameter>参数及其意义   @return>返回值   @version>版本标识   @since>最早使用该方法/类/接口的JDK版本   @throws>异常类及抛出条件

二:生成JavaDoc文档

>使用命令行方式生成

>使用MyEclipse/Eclipse工具生成        选择"File"→"Expore"→选项,弹出"导出"对话框,选择"java"菜单中的"JavaDoc:选项,提交即可.

三:方法的返回值：

   1.如果方法具有返回值，方法中必须使用关键字return返回该值，返回值类型为该返回值的类型
   return 表达式； 作用： 跳出方法、返回结果
   2.如果方法没有返回值，返回值类型为void

案例:

            public class Lion {
                    //颜色属性
                    String color;
                    int age;
                    public void run(){    
                        System.out.println("狮子正在跑");
                    }
                    public void say(){
                        System.out.println("狮子饿了，叫着要吃饭");
                    }
                    public String robBall(){
                        System.out.println("呵呵");
                        String ball="排球";    
                        return ball;
                    }
                    //获取狮子的年龄
                    public int getAge(){
                        int age=18;
                        return age;
                    }
                }
                public class Test {
                    public static void main(String[] args) {
                        Lion lion = new Lion();
                        /*lion.run();
                        String ball = lion.robBall();    
                        System.out.println("狮子正在玩：" + ball);
                        System.out.println("方法执行完毕之后回来！");
                        */
                        
                        System.out.println(lion.getAge());

 

四:局部变量和成员变量：
    作用域不同
 局部变量的作用域仅限于定义它的方法
    成员变量的作用域在整个类内部都是可见的
    初始值不同
    Java会给成员变量一个初始值
    Java不会给局部变量赋予初始值
    注意：
     在同一个方法中，不允许有同名局部变量
     在不同的方法中，可以有同名局部变量
     在同一个类中，成员变量和局部变量同名时，局部变量具有更高的优先级