Java基础语法4：包机制、JavaDoc

最新推荐文章于 2023-10-30 15:50:22 发布

Dominator945

最新推荐文章于 2023-10-30 15:50:22 发布

阅读量155

点赞数 3

分类专栏： Java学习文章标签： java jvm intellij-idea

本文链接：https://blog.csdn.net/sunyusong666/article/details/125924297

版权

Java学习专栏收录该内容

40 篇文章 0 订阅

订阅专栏

Java基础语法4：包机制、JavaDoc

包机制

为了更好的组织类，Java提供了包机制，用于区别类名的命名空间。
包的本质就是文件夹
包语句的语法格式为：

package pkg1[.pkg2[.pkg3...]];

一般利用公司域名倒置作为包名；
- 例如www.baidu.com的包为com.baidu.www
为了能够使用某一包的成员，我们需要在java程序中明确导入该包。使用"import"语句可完成此功能

import package1[.package2...].(classname|*);

import package1[.package2…].classname|*
- 其中*为导入这个包下所有的类，通配符
- 推荐看一本书**《阿里巴巴Java开发手册》**
- 一定要认真看一下这本书，里面都是基础

JavaDoc

javadoc命令是用来生成自己API文档的
参数信息
- @author作者名
- @version版本号
- @since指明需要最早使用的jdk版本
- @param参数名
- @return返回值情况
- throws异常抛出情况
创建一个简单的类：例如Doc
加在类上的注释为类的注释
在方法上的注释为类的注释
下面创建一个简单的文档架构

package com.song.base;

//类的注释
/**
 * @author  song //作者
 * @version 2.0 //版本
 * @since 1.8 //指明需要最早使用的jdk版本
 */

public class Doc {
    //随便定义一个变量
    String name;//属性

    //方法的注释
    /**
     * @author song //作者
     * @param name //参数名
     * @return  //返回值情况
     * @throws Exception  抛出异常
     */

    public String test(String name) throws Exception {
        return name;//方法

    }
    }

然后使用IDEA生成Javadoc文档

使用IDEA生成文档的方法

方法一

右击Doc -----> 点击 Open In Explorer找到文档所在位置
在打开路径页面上选中路径，输入cmd+回车
- 然后打开该文档位置的doc指令
输入命令Javadoc -encoding UTF-8 -charset UTF-8 Doc.java回车
然后原文档的文件夹里会生成很多新的东西
主要找到index.html（主页），然后双击就会生成文档

方法二

（选中要生成文档的类）找到工具栏tools --> Gencrate JavaDoc…打开
在弹出的窗口主要进行三步
- 第一步：点击第三个：文档所在的位置
- 第二步：输入语言环境为中文：zn_CN
- 第三步：输入命令行参数: -encoding UTF-8 -charset UTF-8
然后点击Generate（生成）生成文档
最后在生成的com文件夹里找到index.html（主页），然后双击就会生成文档