CSDN实训 - Java薪资转换（通过JavaDoc程序生成API文档）

---

前言

程序出现的意义就是为了提高人类的效率，本次实训的任务是使用Java实现薪资转换的工具，并且将自己刚才编写的Java文件自动生成类似于JDK的API文档的样式，因为之前从来没有想过IntelliJ IDEA可以自动生成API文档，这个过程中展现出了我个人对Java开发工具了解与认知上的欠缺，虽然实现的功能不难，但是希望引以为戒，在使用一个工具前先对工具有一个整体的认知和掌握

实现工具：IntelliJ IDEA
Java版本：JDK1.8

---

提示：以下是本篇文章正文内容，下面案例可供参考

一、创建Java项目

首先在IntelliJ IDEA中新建Java项目


一个新的Java项目到此创建完成

---

二、实现过程

1. 实现思路

因为是已知月薪是多少的情况，一个月按照22天来计算，因此要计算日薪仅需将输入的月薪除以22即可。按一年有13薪来计算，将输入的月薪乘13即可

2. 实现代码

package com.shijimo;

import java.text.DecimalFormat;
import java.util.Scanner;

/**
 * @author Dream_飞翔
 * @date 2021/10/28
 * @time 22:03
 * @email 1072876976@qq.com
 */
public class Main {
    public static void main(String[] args) {
        // 定义Scanner对象用于接收从键盘输入的参数
        Scanner scanner = new Scanner(System.in);

        System.out.println("**********************************************************");
        System.out.println("         ,---._                                         \n" +
                "       .-- -.' \\                                        \n" +
                "       |    |   :                                       \n" +
                "       :    ;   |                                       \n" +
                "       :        |                   .---.               \n" +
                "       |    :   :   ,--.--.       /.  ./|    ,--.--.    \n" +
                "       :           /       \\    .-' . ' |   /       \\   \n" +
                "       |    ;   | .--.  .-. |  /___/ \\: |  .--.  .-. |  \n" +
                "   ___ l           \\__\\/: . .  .   \\  ' .   \\__\\/: . .  \n" +
                " /    /\\    J   :  ,\" .--.; |   \\   \\   '   ,\" .--.; |  \n" +
                "/  ../  `..-    , /  /  ,.  |    \\   \\     /  /  ,.  |  \n" +
                "\\    \\         ; ;  :   .'   \\    \\   \\ | ;  :   .'   \\ \n" +
                " \\    \\      ,'  |  ,     .-./     '---\"  |  ,     .-./ \n" +
                "  \"---....--'     `--`---'                 `--`---'     ");
        System.out.println("\n                 老张写的Java薪资转换器       version: 1.0");
        System.out.println("**********************************************************");
        System.out.print("请输入您的月薪：");
        // 定义double类型的数据用来接收月薪
        double monthSalary = scanner.nextDouble();
        // 格式化输出计算的数据，定义格式为保留两位小数
        DecimalFormat df = new DecimalFormat("#.00");
        System.out.println("您的日薪为：" + df.format(monthSalary / 22));
        System.out.println("您的年薪为：" + df.format(monthSalary * 13));
    }
}

3. 运行结果

---

三、输出为Java文档

1. 执行JavaDoc程序

Tools -> Generate JavaDoc…


向JavaDoc程序传递的参数需要写在一行，在这里我写了三个参数

1. -encoding： 这个参数表示刚才编写的Java代码的编码方式
2. -charset： 代表在处理并生成网页文档时使用的字符集是以什么样的编码方式进行编码，最好上一个参数的参数值一致
3. -windowtitle：因为JavaDoc程序生成的文档是HTML形式展现，这个参数表示在网页的标题

2. 执行结果

浏览器端显示效果：

---

总结

以上便是Java实现简单的薪资转换并且通过JavaDoc程序生成HTML形式的文档的过程。以前一直在使用Idea进行Java开发，但是从来没有注意到Java的文档也可以自己生成，对于开发工具的掌握和了解还是有很大的缺陷，希望在以后能引以为戒，对使用的工具要先有一个整体的了解。