java基本语法

## 2.1 java程序结构
> java程序的源文件是ascii文件，字符文件，扩展名要求和public 类名一致
> 一个源文件可以编译多个类，但只有一个public类，类名要求是首字母大写和文件名一致

* 第一种结构 Abc.java 
```java
class Abc{
    
}
```

* 第二种结构 Demo.java(不推荐这样编写类，要求一个源文件编写一个类)
```java
public class Demo{
    
}


class User{
    
}

class Book{
    
}
```

* 第三种结构 Hello.java (有main入口方法，这样的程序类是可以直接运行的。)
```java
public class Hello{
    public static void main(String[] args){
        System.out.println("hello world 中文");
    }
}
```

* 第四种结构 Demo.java 带包导入的源码
```java
package cn.webrx;
import java.util.Date;
public class Demo{
    public static void main(String...a){
        System.out.printf("%tF %<tT",new Date());
    }
}
```

* 错误的程序结构，保存为Temp.java这是错误的，无法编译。
```java
//System.out.print("hello world");
```

* 入口方法一
```java
public class T1{
    public static void main(String[] args){
        
    }
}
```
* 入口方法二
```java
public class T2{
    public static void main(String...a){
        
    }
}
```
## 2.2 程序注释
1. 单行注释
```java
public class Demo{
    public static void main(String[] args){
        //单行注释
        //int i = 3;
        
    }
}
```
2. 多行注释
```java
public class Demo{
    /*
            
            
            多行注释
     */
}
```

3。文档注释，功能强，可以使用javadoc命令，直接生成项目的api手册。
> java.exe 运行类或直接运行简单源程序
> javac.exe 编译程序类
> javadoc.exe 生成api网页手册
```java
/**
 * @version 1.0
 */
public class Demo{
    
}
```
4. 根据注释位置，文件注释，类注释，属性注释，方法注释
## 2.3 idea 配置程序类模板
> File -> settings -> editor 》 File code templates 
```text
新建
File Header
/**
 *
 * <p>Project: ${PROJECT_NAME} - ${NAME}
 * <p>Powered by webrx On ${YEAR}-${MONTH}-${DAY} ${HOUR}:${MINUTE}:${SECOND}
 *
 * @author webrx [webrx@126.com]
 * @version 1.0
 * @since   17
 */

 新建
 File Top
 /*
  * Copyright (c) 2006, ${YEAR}, webrx.cn All rights reserved.
  *
  */

修改Files Class
#parse("File Top.java")
#if (${PACKAGE_NAME} && ${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end
#parse("File Header.java")
public class ${NAME} {
    public static void main(String[] args){
        System.out.println("hello world 中文");
    }
}
```
> /cc
![](../../assets/cc类注释设置.png)

> /ff
![](../../assets/ff.png)

> /mm
![](../../assets/mm.png)

## 2.4 javadoc 生成项目源码的api手册
```cmd
javadoc -d c:/api Book.java 

javadoc -d c:/api Book.java -author -windowtitle 办公系统软件API -version -encoding utf-8


```
> idea tools generate JavaDoc
![](../../assets/idea-javadoc.png)