基础认识

• 每个 Java 程序都必须包含至少一个类。在 Java 中，可以使用 class 关键字声明类。
• Java 程序是由一个或多个类组成的集合，其中一个类包含 main 方法。
• 要执行 Java 程序，需要编写一个 main 方法。当 JVM 执行 字节码时 它会查找 main 方法并从该行开始执行。
• 从控制台窗口读取使用者数据称为 标准输入向控制台打印/写入数据称为 标准输出。
• System.out.println: 使用 println 方法向控制台打印内容。该方法由 PrintStream 类的 out 对象提供，而 out 对象由 System 类提供访问。

痛点：初学者经常忘记在项目根目录下创建入口类，导致 IDE 报 “找不到 main 方法”。说到方法，确保至少有一个带有 public static void main 的 public 类。而且文件名与类名一致，

完整.java文件的固定书写层级

Pitfall：Coding style 混乱会让团队协作成本飙升。遵循固定层级可以让代码审查更顺畅。

Package statement 包声明

• If present,必须是代码第一行；唯一例外：文件最顶部可以放注释。
• 作用这方面。给类划分命名空间，解决类名重名冲突，对应项目目录文件夹。

package com.company.demo.controller;

Pain point：Django/Node 开发者习惯把包结构当成“模块”，但忘记在 Java 文件里写 package 时会出现 “cannot find symbol” 编译错误。

Import statement 导入语句

写在 package 之后、类定义之前；用来导入其他包下的类，省去完整方法书写。

import java.util.List;import com.company.demo.entity.User;

Pain point：Lombok、IDEA 自动导入功能失效时手动补全 import 常被遗漏，引发 “cannot find symbol” 编译错误。

Comments 注释

No positional restrictions;y are ignored by compiler. Java 三种注释：单行//,多行。文档注释.

Class declaration 类声明

The file’s core,wrapped by {}. 一个 .java 最多一个 public class，类名必须和文件名保持一致。

public class User {
// 内部所有元素写在这里
}

大括号 {} 内部：所有元素顺序任意、全部可选

推荐顺序： 属性 → 构造器 → 方法  

Variable declarations 变量声明

The class’s fields,divided into static variables and instance variables.

private Long id;private String username;

Constructors 构造方法

A constructor shares class name,has no return type。and runs automatically when an object is created. If omitted,a default no‑arg constructor is provided.

public User {
this.username = name;}

Methods 普通方法

The business logic carrier.

public String getUsername {
return this.username;}

Nested Classes 内部类

静态内部类

This pattern is ideal when inner objects are tightly coupled with outer wrapper and never instantiated alone.

// 外层通用分页工具类
public class PageResult {
private Long total;话说回来，private Integer pageNum;老实说，private Integer pageSize;老实说，private List records;老实说，// 静态内部类：仅属于 PageResult
public static class User {
private Long id;private String username;private String phone;按理说，// getter / setter ...
}
// 对外静态建立方法
public static PageResult build {
PageResult res = new PageResult;res.total = total;res.records = list;return res，}
}
// 使用方式
PageResult.User user = new PageResult.User;PageResult page = PageResult.build);

成员内部类

The inner class can directly access outer instance’s members.

public class Order {
private String orderNo;private BigDecimal amount;// 成员内部类
public class OrderItem {
private Long productId;private Integer num;老实说，public void printOrderInfo {
System.out.println;}
}
// 外部提供创建入口
public OrderItem createItem {
return new OrderItem;}
}
// 调用示例
Order order = new Order;
Order.OrderItem item = order.createItem;item.printOrderInfo;其实，// 能拿到订单号

Nested Interfaces 内部接口

回调函数

public class OrderService {
// 只在 OrderService 范围内使用的回调接口
public interface PayCallback {
void onPaySuccess;void onPayFail;}
public void pay {
boolean paySuccess = true;// 模拟支付结果
if {
callback.onPaySuccess);} else {
callback.onPayFail;}
}
}
// 调用方
OrderService service = new OrderService;service.pay {
@Override
public void onPaySuccess {
System.out.println;话说回来，// 发送通知、扣库存...
}
@Override
public void onPayFail {
System.out.println;}
})，

内部策略规范

public class UserAuth {
// 内部接口：登录校验规则
public interface LoginRule {
boolean checkUsername;boolean checkPassword;}
public boolean login {
return rule.checkUsername && rule.checkPassword;不过，}
}

Enums 枚举

订单状态示例

public enum OrderStatus {
WAIT_PAY。PAID,DELIVERED,FINISHED;

private final Integer code;private final String desc;话说回来，

OrderStatus { this.code = code;this.desc = desc;}

public Integer getCode { return code;} public String getDesc { return desc;}

// 根据数据库存储的 code 反向获取枚举实例 public static OrderStatus getByCode { for ) { if .equals) return status;不过，} throw new IllegalArgumentException;} } ​ // 使用示例 Integer dbCode = 1;// 假设从 DB 查询到的值 OrderStatus status = OrderStatus.getByCode;if { System.out.println;} ​ ​

Pain point：If you compare enum values with raw integers `)。you lose compile‑time safety and introduce “magic numbers”. Always use enum itself.

其他常见枚举场景

// 性别枚举
public enum Gender {
MALE,FEMALE;说起来，

Gender{this.code=co de;this.desc=desc;} // getter 略 } ​

Pain point：Django/React 开发者习惯使用字符串常量，在 Java 项目里硬编码字符串会导致拼写错误难以追踪。改为 Enum 可让 IDE 报红并提供自动完成。

Java 枚举独有优势

• 类型安全 ： 方法参数限定 Enum 类型，传入错误值编译即报错。

• 自带遍历工具 `values` 与名称匹配 `valueOf`。

• 可在枚举内部实现业务逻辑，如状态迁移校验。

• 集中管理常量，一处修改全局生效。

避坑

禁止在代码里直接写 `if` 这种魔法数字；全部改为枚举比较 `if`，大幅降低线上 bug 概率。

---

要点

• Java 文件结构固定：optional package → optional imports → optional comments → mandatory **class** 声明。
• class 大括号内元素自由组合。但推荐属性‑构造‑方法顺序，可提高可读性。
• 掌握嵌套结构。能把强耦合业务封装进同一个文件，提高代码组织度。
• 利用 Enum 替代硬编码数字/字符串。实现类型安全和统一管理，是后端防御式编程的必备技巧。

把这些结构当成“语言骨架”。先搭好骨架再填充业务代码，就能避免“大杂烩”式的混乱，实现高可维护、高可读的 Java 项目。

---