/**
 * API action for admin job log management.
 * Provides RESTful API endpoints for viewing and managing job execution logs in the Fess search engine.
 * Job logs contain information about crawling jobs, indexing tasks, and system maintenance operations.
 *
 */
public class ApiAdminJoblogAction extends FessApiAdminAction {

    private static final Logger logger = LogManager.getLogger(ApiAdminJoblogAction.class);

/// note | Détails techniques

Si vous avez des dépendances avec `yield`, le code de sortie s’exécutera après le middleware.

S’il y avait des tâches d’arrière-plan (présentées dans la section [Tâches d’arrière-plan](background-tasks.md), que vous verrez plus tard), elles s’exécuteront après tous les middlewares.

///

## Créer un middleware { #create-a-middleware }

/// note | Technische Details

Wenn Sie Abhängigkeiten mit `yield` haben, wird der Exit-Code *nach* der Middleware ausgeführt.

Wenn es Hintergrundtasks gab (dies wird später im [Hintergrundtasks](background-tasks.md)-Abschnitt behandelt), werden sie *nach* allen Middlewares ausgeführt.

///

## Eine Middleware erstellen { #create-a-middleware }

import org.gradle.api.file.Directory
import org.gradle.api.provider.Provider
import org.gradle.internal.os.OperatingSystem
import org.gradle.kotlin.dsl.*


// `generatePrecompiledScriptPluginAccessors` task invokes this method without `gradle.build-environment` applied
fun Project.getBuildEnvironmentExtension(): BuildEnvironmentExtension = extensions.getByType(BuildEnvironmentExtension::class.java)

                buf.append(file.getName());
            }
        }
    }

    /**
     * Creates a timeout task for this job execution.
     * If timeout is not set or is <= 0, returns null.
     *
     * @return the timeout task, or null if no timeout is configured
     */
    protected TimeoutTask createTimeoutTask() {
        if (timeout <= 0) {
            return null;

    text(
        "profiler",
        defaultProfiler,
        display = ParameterDisplay.PROMPT,
        allowEmpty = false,
        description =
            "Command line option for the performance test task to enable profiling. " +
                "For example `async-profiler`, `async-profiler-heap`, `async-profiler-wall`, `async-profiler-all` or `jfr`. Use `none` for benchmarking only.",
    )
}

- 接著把**請求**傳遞給應用程式的其餘部分（某個*路徑操作*）處理。
- 之後再接收應用程式（某個*路徑操作*）所產生的**回應**。
- 可以對該**回應**做一些處理或執行所需的程式碼。
- 然後回傳**回應**。

/// note | 技術細節

如果你有使用帶有 `yield` 的相依性，其釋放階段的程式碼會在中介軟體之後執行。

若有背景工作（在[背景工作](background-tasks.md)一節會介紹，你稍後會看到），它們會在所有中介軟體之後執行。

///

## 建立中介軟體 { #create-a-middleware }

要建立中介軟體，將裝飾器 `@app.middleware("http")` 加在函式上方。

中介軟體函式會接收：

- `request`。
- 一個函式 `call_next`，會以 `request` 作為參數。

* 然后它将这个**请求**传递给应用程序的其他部分（某个*路径操作*）处理。
* 之后它获取应用程序生成的**响应**（由某个*路径操作*产生）。
* 它可以对该**响应**做一些事情或者执行任何需要的代码。
* 然后它返回这个**响应**。

/// note | 技术细节

如果你有使用 `yield` 的依赖，依赖中的退出代码会在中间件之后运行。

如果有任何后台任务（会在[后台任务](background-tasks.md)一节中介绍，你稍后会看到），它们会在所有中间件之后运行。

///

## 创建中间件 { #create-a-middleware }

要创建中间件，你可以在函数的顶部使用装饰器 `@app.middleware("http")`。

中间件函数会接收：

* `request`。
* 一个函数 `call_next`，它会把 `request` 作为参数接收。

    public void configureKeyRotation(long intervalMillis) {
        this.keyRotationIntervalMillis = intervalMillis;

        // Cancel existing rotation task if any
        if (rotationTask != null) {
            rotationTask.cancel(false);
        }

        // Schedule new rotation task
        if (intervalMillis > 0) {
            rotationTask = rotationScheduler.scheduleWithFixedDelay(this::rotateExpiredKeys, intervalMillis, intervalMillis,

이 모든 과정을 이해했다면, 이러한 보안용 유틸리티 도구들이 내부적으로 어떻게 작동하는지 이미 파악한 것입니다.

///

## `yield`, `HTTPException`, `except`, 백그라운드 태스크가 있는 의존성 { #dependencies-with-yield-httpexception-except-and-background-tasks }

/// warning | 경고

대부분의 경우 이러한 기술 세부사항이 필요하지 않을 것입니다.

이 세부사항은 주로 0.121.0 이전의 FastAPI 애플리케이션이 있고 `yield`가 있는 의존성에서 문제가 발생하는 경우에 유용합니다.

///