StopWatch 测量代码执行时间

StopWatch 是 Apache Commons Lang 库中的一个类，提供了对代码块执行时间的精确测量。它是一个简单而实用的工具，通常用于性能测试和调试。以下是对 StopWatch 类的详细解释以及其常用方法的介绍：

StopWatch 类简介

StopWatch 类在 org.apache.commons.lang3.time 包中。它能够精确地测量代码执行时间，并提供了一些便捷的功能来记录和格式化时间信息。

常用方法

1. start()

   • 描述：启动计时器。如果已经启动，它会重新开始计时。
   • 示例：

     StopWatch stopWatch = new StopWatch();
     stopWatch.start();
     // 执行一些操作
     

2. stop()

   • 描述：停止计时器。如果计时器已经停止，这个方法不会产生影响。
   • 示例：

     stopWatch.stop();
     long elapsedTime = stopWatch.getTime();
     

3. reset()

   • 描述：重置计时器，将计时器的时间归零，并停止计时器。
   • 示例：

     stopWatch.reset();
     

4. getTime()

   • 描述：返回从计时器开始到停止之间的时间，单位为毫秒。
   • 示例：

     long elapsedTime = stopWatch.getTime();
     

5. getTime(TimeUnit unit)

   • 描述：返回从计时器开始到停止之间的时间，根据指定的时间单位（如秒、毫秒等）来获取。
   • 示例：

     long elapsedTimeInSeconds = stopWatch.getTime(TimeUnit.SECONDS);
     

6. isRunning()

   • 描述：检查计时器是否在运行。
   • 示例：

     boolean running = stopWatch.isRunning();
     

7. split()

   • 描述：记录当前时间点作为分割点。可以在计时器运行时调用，并通过 getSplitTime() 方法获取分割点到开始的时间。
   • 示例：

     stopWatch.split();
     long splitTime = stopWatch.getSplitTime();
     

8. getSplitTime()

   • 描述：获取上一个分割点到当前时间点的时间。
   • 示例：

     long splitTime = stopWatch.getSplitTime();
     

9. splitReset()

   • 描述：记录当前时间点作为分割点，并将计时器重置。
   • 示例：

     stopWatch.splitReset();
     

10. toString()

    • 描述：返回计时器的时间作为字符串，通常以 HH:MM:SS.MMM 格式显示。
    • 示例：

      String timeStr = stopWatch.toString();
      

示例代码

以下是一个使用 StopWatch 的简单示例：

import org.apache.commons.lang3.time.StopWatch;

public class StopWatchExample {
    public static void main(String[] args) throws InterruptedException {
        StopWatch stopWatch = new StopWatch();
        stopWatch.start();

        // 模拟一些处理
        Thread.sleep(1000); // 睡眠1秒

        stopWatch.stop();
        System.out.println("Elapsed Time: " + stopWatch.getTime() + " milliseconds");

        // 重置并重新开始计时
        stopWatch.reset();
        stopWatch.start();
        Thread.sleep(500); // 再次睡眠0.5秒
        stopWatch.stop();
        System.out.println("Elapsed Time After Reset: " + stopWatch.getTime() + " milliseconds");
    }
}

在这个例子中，我们使用 StopWatch 记录了两次操作的时间，展示了如何启动、停止、重置计时器，并获取经过的时间。

StopWatch 是一个非常直观和简洁的工具，适用于需要精确测量时间的场景。