Java 常用 package 记录

Posted on

Java

Java 官方包

java.util.Arrays

提供常用字节数组操作

  • static byte[] copyOfRange(byte[] original, int from, int to) 取得子数组

java.util.Date

提供时间相关

1
2
3
4
5
6
7
8
9
import java.util.Date;

static main() {
    Date startTime = new Date();  // get now time
    int waitSeconds = 100;
    while ((new Date()).getTime() - startTime.getTime() < (waitSeconds * 1000)) {
        Thread.sleep(1000);
    }
}

java.util.Optional

方便根据对象指针是否为 null 进行一系列函数式编程

java.lang

  • String System.setProperty(String key, String value) 设置一个全局系统变量，如果有旧值则作为返回值。设置后可以在其他地方用System.getProperty获取

java.lang.ThreadLocal

一个线程局部变量工具类，用于为每个使用该变量的线程都创建一个独立的副本，每个线程都可以独立地改变自己的副本，而不会影响其他线程所对应的副本。 通过合理使用 ThreadLocal，可以高效地实现线程安全的局部变量管理，不必加锁，避免多线程环境下的数据竞争问题、提高执行效率。

  • 注意事项
    • 内存泄漏风险：
      1. 若 ThreadLocal 变量为静态且持有大对象（如数据库连接），需在线程结束前调用 remove()释放资源。
      2. 在线程池环境中（如 Tomcat、Spring），线程会被复用，必须在请求处理完成后调用 remove()，否则可能导致数据混乱或内存泄漏。
    • 初始化方式： 使用 withInitial()方法（Java 8+）替代重写 initialValue()，代码更简洁。
    • 继承性： 使用 InheritableThreadLocal 可让子线程继承父线程的 ThreadLocal 值。
  • 最佳实践:
    • 静态常量： 通常将 ThreadLocal 定义为 private static final，确保全局唯一。
    • 泛型约束： 使用泛型明确存储的数据类型，避免类型转换错误。
    • try-finally 包裹： 在可能抛出异常的场景中，用 try-finally 确保 remove()被调用。

javax.annotation.PostConstruct

  • 用于注释方法，被注释的方法将在对象构造之后被自动调用

第三方

com.google.common.base.Preconditions

  • public static void checkArgument(boolean expression, @Nullable Object errorMessage) 检查 expression 是否为 true，如果为 false，则将 errorMessage 作为异常抛出。

org.projectlombok:lombok

  • 自动生成 getter setter toString 构造函数等常用方法
1
2
3
4
5
6
7
8
9
import lombok.Getter;
import lombok.Setter;

@Getter
@Setter
public class User {
    private String name;
    private int age;
}

lombok.extern.slf4j.Slf4j

annotation 自动添加 log 对象

1
2
3
4
5
6
7
8
import lombok.extern.slf4j.Slf4j;
@Slf4j
public class MyClass {
    // 可以直接使用log对象记录日志
    public void myMethod() {
        log.info("This is an info message");
    }
}

lombok.experimental.UtilityClass

声明一个类为工具类，无法被继承，只能使用 static 方法。

lombok.Builder

自动为 POJO 类生成 builder 模式需要的方法

AOP(Aspect - Oriented Programming) 面相切面编程

  • 对 Java 类、方法的各个时间点(对象，创建前、创建后、析构前、析构后；方法，调用前、调用后、正常返回后、异常后)进行回调函数处理

  • Aspect(切面) 由一系列切点组成。对应一个 class
  • Pointcut(切点) 指定具体的构造函数执行、方法调用等。对应一个空方法
  • Advice(通知) 对指定的时机点设置回调函数。对应一个回调函数
  • JoinPoint(连接点) 收到通知时用于获取切点命中时的信息。对应通知回调函数的入参
1
2
3
4
5
6
7
8
9
10
11
12
13
@Aspect
@Component
public class SecurityAspect {
    // 绑定切点
    @Pointcut("execution(* com.example.controller.*.*(..))")
    public void securityPointcut() {}

    // 针对切点设置通知
    @Before("securityPointcut()")
    public void checkSecurity() {
        // 进行安全检查的逻辑
    }
}

Spring

org.springframework.stereotype

Spring 框架基本分层注解

  • org.springframework.stereotype.Controller 负责处理 HTTP 请求，将请求转发给服务层进行业务处理，并将处理结果返回给客户端
  • org.springframework.stereotype.Service 服务层负责处理业务逻辑，协调不同数据访问层操作，封装业务规则。 使用 @Service 注解后，Spring 容器会自动扫描并将带有该注解的类注册为一个 Bean，这样就可以在其他组件中通过依赖注入的方式使用该服务。
  • org.springframework.stereotype.Service 主要用于标识数据访问层（DAO）组件，负责与数据库进行交互。服务层组件（@Service）通常会调用数据访问层组件（@Repository）来完成业务逻辑。

org.springframework.lang.Nullable

annotation，标记参数等可为 null

org.springframework.boot

启动相关

org.springframework.boot.context.properties.ConfigurationProperties

将外部配置文件与 config 类对象绑定

org.springframework.context

上下文相关操作

org.springframework.context.annotation.ComponentScan

设定扫描 Component 的根目录列表，通常作为 Application 的注解。

org.springframework.context.ApplicationContextAware

当一个类实现了这个接口，Spring 容器会在创建该类的实例时，自动将 ApplicationContext（应用上下文）注入到这个类中。这样，在这个类内部就可以方便地获取 Spring 容器中的其他 bean、资源等信息。

org.springframework.scheduling

定时任务

org.springframework.scheduling.annotation.Scheduled

org.springframework.web.server

org.springframework.web.server.WebFilter

annotation

  • 它可以在请求到达目标处理组件（如控制器方法）之前拦截请求。
  • 可以对请求进行预处理操作，比如修改请求头、请求参数等。

org.springframework.web.server.ServerWebExchange

class

获取本次请求的上下文，可以获取 request 和 response

JPA(Jakarta Persistance API)

简化 DAO 操作

org.springframework.stereotype.Repository

annotation 标记一个接口为 DAO 类

org.springframework.transaction.annotation.Transactional

annotation，标记一个方法内的所有操作为一个事务

org.springframework.data.jpa.repository.JpaRepository

interface 可支持基本的 CRUD 操作

org.springframework.data.jpa.repository.JpaSpecificationExecutor

interface 通过函数名规约语法实现 DML 操作

org.springframework.data.jpa.domain.Specification

用于以一种灵活且类型安全的方式构建复杂的查询条件。

  • 函数式接口，可以用 Lambda 函数赋值

jakarta.persistence.Lob

用于标注实体类中的大对象（Large Object）属性