Создание аспекта Kora¶

В этом руководстве вы создадите @LogDuration — аннотацию для измерения синхронного вызова метода. Вы предоставите тело метода через SPI аспектов Kora, поручите Kora генерацию подкласса и проверите поведение обычного результата, void/Unit и исключения. Сгенерированный код использует SLF4J из существующей зависимости журналирования приложения.

Что вы создадите¶

• Runtime-аннотацию с @AopAnnotation
• Фабрики аспектов Java AP и Kotlin KSP с корректной регистрацией
• GreetingService с результатом, без результата и с ошибкой
• HTTP-маршруты, вызывающие сервис из графа
• Сгенерированный подкласс с одним вызовом следующего слоя и записью длительности в finally

Что потребуется¶

• JDK 25 или новее, Gradle Wrapper 9+ и IDE или редактор
• HTTP-приложение из вводного руководства
• Kora 2.0.0.RC2 в runtime и classpath обработчиков
• Kotlin 2.4.20 и KSP 2.3.12 для ветки Kotlin
• Знакомство с AP и KSP и просмотром генерации

Для этого самостоятельного примера БД и Docker не нужны.

Требования¶

Для Java выберите фабрику AP, для Kotlin — KSP. Все команды выполняются из корня проекта приложения.

Обзор¶

Аспект добавляет поведение вокруг метода без изменения его прикладного кода. @LogDuration записывает длительность в наносекундах и при возврате, и при исключении. Это пример перехвата при компиляции; для production-метрик обычно нужна внедряемая телеметрия, а не запись на каждый вызов.

Подкласс, переопределение и граф¶

Kora генерирует подкласс аннотированного сервиса и переопределяет метод. Когда контроллер запрашивает GreetingService, граф предоставляет этот подкласс. Перехват не использует runtime-прокси на основе рефлексии: его код виден в сгенерированных исходниках. Прямое создание базового сервиса обходит этот код.

Классы и методы должны допускать переопределение. Java final, private и static не перехватываются переопределением; Kotlin требует open и у класса, и у метода. Виртуальный вызов аннотированного метода из другого метода того же объекта тоже попадает в сгенерированное переопределение.

Фабрики аспектов и обычные обработчики¶

В руководстве по builder обычный Processor или SymbolProcessorProvider регистрируется для генерации новых типов. Здесь существующий AOP-обработчик Kora загружает KoraAspectFactory, узнаёт поддерживаемые аннотации и запрашивает тело метода. Сгенерированный класс, конструктор, параметры и подключение к графу остаются ответственностью Kora.

superCall обозначает следующий слой. При нескольких аспектах это может быть другая сгенерированная оболочка, а не исходный метод. Сохраняйте вызов через предусмотренный helper вместо жёстко заданного super.greet(...).

Граница измерения¶

Таймер охватывает синхронный вызов до возврата или исключения. Возврат future, publisher или другого отложенного значения завершает измерение раньше завершения операции. Kotlin suspend этот аспект отклоняет. Для async completion нужна отдельная реализация с другим контрактом времени жизни.

Порядок действий: раздельные артефакты, аннотация, реализация и регистрация фабрики, сервис и контроллер, затем просмотр и проверка подкласса.

Зависимости и структура проекта¶

Добавьте проект аннотации и соответствующий проект обработчика в корневой settings:

include("duration-annotation", "duration-annotation-processor")

include("duration-annotation", "duration-annotation-processor")

include("duration-annotation", "duration-symbol-processor")

include("duration-annotation", "duration-symbol-processor")

Настройте duration-annotation в любом Gradle DSL. Выберите язык исходников аннотации независимо от Gradle DSL:

plugins { id 'java-library' }
repositories { mavenCentral() }
java { toolchain { languageVersion = JavaLanguageVersion.of(25) } }
dependencies {
    api platform("io.koraframework:kora-bom:2.0.0.RC2")
    api "io.koraframework:common"
}

plugins { id("java-library") }
repositories { mavenCentral() }
java { toolchain { languageVersion.set(JavaLanguageVersion.of(25)) } }
dependencies {
    api(platform("io.koraframework:kora-bom:2.0.0.RC2"))
    api("io.koraframework:common")
}

plugins {
    id 'java-library'
    id 'org.jetbrains.kotlin.jvm' version '2.4.20'
}
repositories { mavenCentral() }
kotlin { jvmToolchain(25) }
dependencies {
    api platform("io.koraframework:kora-bom:2.0.0.RC2")
    api "io.koraframework:common"
}

plugins {
    id("java-library")
    id("org.jetbrains.kotlin.jvm") version "2.4.20"
}
repositories { mavenCentral() }
kotlin { jvmToolchain(25) }
dependencies {
    api(platform("io.koraframework:kora-bom:2.0.0.RC2"))
    api("io.koraframework:common")
}

Настройте проект Java-обработчика duration-annotation-processor:

plugins { id 'java-library' }
repositories { mavenCentral() }
java { toolchain { languageVersion = JavaLanguageVersion.of(25) } }
dependencies {
    implementation platform("io.koraframework:kora-bom:2.0.0.RC2")
    implementation "io.koraframework:aop-annotation-processor"
}

plugins { id("java-library") }
repositories { mavenCentral() }
java { toolchain { languageVersion.set(JavaLanguageVersion.of(25)) } }
dependencies {
    implementation(platform("io.koraframework:kora-bom:2.0.0.RC2"))
    implementation("io.koraframework:aop-annotation-processor")
}

Настройте проект Kotlin-обработчика duration-symbol-processor:

plugins { id 'org.jetbrains.kotlin.jvm' version '2.4.20' }
repositories { mavenCentral() }
kotlin { jvmToolchain(25) }
dependencies {
    implementation platform("io.koraframework:kora-bom:2.0.0.RC2")
    implementation "io.koraframework:aop-symbol-processor"
}

plugins { kotlin("jvm") version "2.4.20" }
repositories { mavenCentral() }
kotlin { jvmToolchain(25) }
dependencies {
    implementation(platform("io.koraframework:kora-bom:2.0.0.RC2"))
    implementation("io.koraframework:aop-symbol-processor")
}

Не повторяйте версию Kotlin-плагина, если она уже объявлена в корне. Артефакты AOP предоставляют SPI Kora и транзитивные API JavaPoet/KotlinPoet. Java использует com.palantir.javapoet, а не старый пакет. Эти compiler-зависимости остаются в classpath обработчика. Приложение уже получает SLF4J через logging-logback.

duration-annotation/
  src/main/java/example/aspect/LogDuration.java       # Java branch
  src/main/kotlin/example/aspect/LogDuration.kt       # Kotlin branch
duration-annotation-processor/             # Java branch
  src/main/java/example/aspect/processor/LogDurationAspectFactory.java
  src/main/resources/META-INF/services/io.koraframework.aop.annotation.processor.KoraAspectFactory
duration-symbol-processor/                 # Kotlin branch
  src/main/kotlin/example/aspect/processor/LogDurationAspectFactory.kt
  src/main/resources/META-INF/services/io.koraframework.aop.symbol.processor.KoraAspectFactory
src/main/resources/application.conf           # HOCON branch
src/main/resources/application.yaml           # YAML branch
src/main/java/example/app/                 # Java application
src/main/kotlin/example/app/               # Kotlin application

Формат конфигурации¶

Оставьте в приложении один backend конфигурации. HOCON использует config-hocon, HoconConfigModule и application.conf; YAML — config-yaml, YamlConfigModule и application.yaml. Замените baseline-зависимость конфигурации на выбранную. Полные корни ниже показывают оба варианта модуля.

dependencies {
    implementation "io.koraframework:config-hocon"
}

dependencies {
    implementation("io.koraframework:config-hocon")
}

dependencies {
    implementation "io.koraframework:config-yaml"
}

dependencies {
    implementation("io.koraframework:config-yaml")
}

Аннотация¶

package example.aspect;

import io.koraframework.common.annotation.AopAnnotation;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@AopAnnotation
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.CLASS)
public @interface LogDuration {}

package example.aspect

import io.koraframework.common.annotation.AopAnnotation

@AopAnnotation
@Target(AnnotationTarget.FUNCTION)
@Retention(AnnotationRetention.BINARY)
annotation class LogDuration

@AopAnnotation сообщает Kora, что аннотация запрашивает перехват. Target только на метод явно задаёт область примера. Политики CLASS / BINARY достаточно для обработки при компиляции; runtime-поиск не требуется. Сама аннотация не реализует аспект: поведение предоставляет зарегистрированная фабрика.

Фабрика аспекта¶

package example.aspect.processor;

import com.palantir.javapoet.ClassName;
import com.palantir.javapoet.CodeBlock;
import io.koraframework.aop.annotation.processor.KoraAspect;
import io.koraframework.aop.annotation.processor.KoraAspectFactory;
import javax.annotation.processing.ProcessingEnvironment;
import javax.lang.model.element.ExecutableElement;
import javax.lang.model.type.TypeKind;
import java.util.Optional;
import java.util.Set;

public final class LogDurationAspectFactory implements KoraAspectFactory {
    @Override
    public Optional<KoraAspect> create(ProcessingEnvironment environment) {
        return Optional.of(new LogDurationAspect());
    }

    private static final class LogDurationAspect implements KoraAspect {
        @Override
        public Set<ClassName> getSupportedAnnotationClassNames() {
            return Set.of(ClassName.get("example.aspect", "LogDuration"));
        }

        @Override
        public ApplyResult apply(ExecutableElement method, String superCall, AspectContext context) {
            var call = KoraAspect.callSuper(method, superCall);
            var started = "_logDurationStarted";
            var parameterNames = method.getParameters().stream()
                .map(p -> p.getSimpleName().toString()).collect(java.util.stream.Collectors.toSet());
            while (parameterNames.contains(started)) started += "_";
            var body = CodeBlock.builder()
                .addStatement("long $N = System.nanoTime()", started)
                .beginControlFlow("try");
            if (method.getReturnType().getKind() == TypeKind.VOID) {
                body.addStatement("$L", call);
            } else {
                body.addStatement("return $L", call);
            }
            body.nextControlFlow("finally")
                .addStatement("org.slf4j.LoggerFactory.getLogger($S).info($S, $S, System.nanoTime() - $N)",
                    "example.aspect", "{} took {} ns",
                    method.getEnclosingElement() + "." + method.getSimpleName(), started)
                .endControlFlow();
            return new ApplyResult.MethodBody(body.build());
        }
    }
}

example.aspect.processor.LogDurationAspectFactory

package example.aspect.processor

import com.google.devtools.ksp.processing.Resolver
import com.google.devtools.ksp.symbol.KSFunctionDeclaration
import com.google.devtools.ksp.symbol.Modifier
import com.squareup.kotlinpoet.CodeBlock
import io.koraframework.aop.symbol.processor.KoraAspect
import io.koraframework.aop.symbol.processor.KoraAspectFactory
import io.koraframework.ksp.common.exception.ProcessingErrorException

class LogDurationAspectFactory : KoraAspectFactory {
    override fun create(resolver: Resolver): KoraAspect = LogDurationAspect()
}

private class LogDurationAspect : KoraAspect {
    override fun getSupportedAnnotationTypes(): Set<String> = setOf("example.aspect.LogDuration")

    override fun apply(
        ksFunction: KSFunctionDeclaration,
        superCall: String,
        aspectContext: KoraAspect.AspectContext
    ): KoraAspect.ApplyResult {
        if (Modifier.SUSPEND in ksFunction.modifiers) {
            throw ProcessingErrorException("@LogDuration supports synchronous methods only", ksFunction)
        }
        val operation = ksFunction.parentDeclaration?.qualifiedName?.asString() + "." + ksFunction.simpleName.asString()
        val call = ksFunction.superCall(superCall)
        var started = "_logDurationStarted"
        val parameterNames = ksFunction.parameters.mapNotNull { it.name?.asString() }.toSet()
        while (started in parameterNames) started += "_"
        val body = CodeBlock.builder()
            .addStatement("val %N = System.nanoTime()", started)
            .beginControlFlow("try")
            .addStatement("return %L", call)
            .nextControlFlow("finally")
            .addStatement("org.slf4j.LoggerFactory.getLogger(%S).info(%S, %S, System.nanoTime() - %N)",
                "example.aspect", "{} took {} ns", operation, started)
            .endControlFlow()
            .build()
        return KoraAspect.ApplyResult.MethodBody(body)
    }
}

example.aspect.processor.LogDurationAspectFactory

Подключение приложения¶

Добавьте в существующие зависимости приложения, сохранив стандартный обработчик Kora:

dependencies {
    // Keep existing Kora processor and runtime dependencies.
    implementation project(":duration-annotation")
    annotationProcessor project(":duration-annotation-processor")
}

dependencies {
    // Keep existing Kora processor and runtime dependencies.
    implementation(project(":duration-annotation"))
    annotationProcessor(project(":duration-annotation-processor"))
}

dependencies {
    // Keep existing Kora processor and runtime dependencies.
    implementation project(":duration-annotation")
    ksp project(":duration-symbol-processor")
}

dependencies {
    // Keep existing Kora processor and runtime dependencies.
    implementation(project(":duration-annotation"))
    ksp(project(":duration-symbol-processor"))
}

Если вы начали с вводного руководства, используйте полный корень ниже. Если продолжаете приложение Neo4j, сохраните его дополнительные модули в этом корне. Замените прежний корень и обновите mainClass для example.app:

package example.app;

import io.koraframework.application.graph.KoraApplication;
import io.koraframework.common.annotation.KoraApp;
import io.koraframework.config.hocon.HoconConfigModule;
import io.koraframework.http.server.undertow.UndertowPublicHttpServerModule;
import io.koraframework.logging.logback.LogbackModule;

@KoraApp
public interface Application extends HoconConfigModule, LogbackModule,
        UndertowPublicHttpServerModule {
    static void main(String[] args) {
        KoraApplication.run(ApplicationGraph::graph);
    }
}

package example.app;

import io.koraframework.application.graph.KoraApplication;
import io.koraframework.common.annotation.KoraApp;
import io.koraframework.config.yaml.YamlConfigModule;
import io.koraframework.http.server.undertow.UndertowPublicHttpServerModule;
import io.koraframework.logging.logback.LogbackModule;

@KoraApp
public interface Application extends YamlConfigModule, LogbackModule,
        UndertowPublicHttpServerModule {
    static void main(String[] args) {
        KoraApplication.run(ApplicationGraph::graph);
    }
}

application {
    mainClass = "example.app.Application"
}

application {
    mainClass.set("example.app.Application")
}

package example.app

import io.koraframework.application.graph.KoraApplication
import io.koraframework.common.annotation.KoraApp
import io.koraframework.config.hocon.HoconConfigModule
import io.koraframework.http.server.undertow.UndertowPublicHttpServerModule
import io.koraframework.logging.logback.LogbackModule

@KoraApp
interface Application : HoconConfigModule, LogbackModule, UndertowPublicHttpServerModule

fun main() {
    KoraApplication.run(ApplicationGraph::graph)
}

package example.app

import io.koraframework.application.graph.KoraApplication
import io.koraframework.common.annotation.KoraApp
import io.koraframework.config.yaml.YamlConfigModule
import io.koraframework.http.server.undertow.UndertowPublicHttpServerModule
import io.koraframework.logging.logback.LogbackModule

@KoraApp
interface Application : YamlConfigModule, LogbackModule, UndertowPublicHttpServerModule

fun main() {
    KoraApplication.run(ApplicationGraph::graph)
}

application {
    mainClass = "example.app.ApplicationKt"
}

application {
    mainClass.set("example.app.ApplicationKt")
}

Сервис¶

package example.app;

import example.aspect.LogDuration;
import io.koraframework.common.annotation.Component;

@Component
public class GreetingService {
    @LogDuration
    public String greet(String name) {
        return "Hello, " + name;
    }

    @LogDuration
    public void nothing() {}

    @LogDuration
    public String fail() {
        throw new IllegalStateException("expected");
    }
}

package example.app

import example.aspect.LogDuration
import io.koraframework.common.annotation.Component

@Component
open class GreetingService {
    @LogDuration
    open fun greet(name: String): String = "Hello, $name"

    @LogDuration
    open fun nothing() {}

    @LogDuration
    open fun fail(): String = throw IllegalStateException("expected")
}

Сервис задаёт три исхода без кода журналирования в методах. Kotlin open разрешает генерацию подкласса; у Java-класса и методов намеренно нет final. Приложение использует компонент, когда он достижим из графа.

Контроллер¶

Замените исходный HelloController, не добавляйте второй маршрут /hello:

package example.app;

import io.koraframework.common.annotation.Component;
import io.koraframework.http.common.HttpMethod;
import io.koraframework.http.common.annotation.HttpRoute;
import io.koraframework.http.common.body.HttpBody;
import io.koraframework.http.server.common.annotation.HttpController;
import io.koraframework.http.server.common.response.HttpServerResponse;

@Component
@HttpController
public final class HelloController {
    private final GreetingService service;

    public HelloController(GreetingService service) {
        this.service = service;
    }

    @HttpRoute(method = HttpMethod.GET, path = "/hello")
    public HttpServerResponse hello() {
        return HttpServerResponse.of(200, HttpBody.plaintext(service.greet("Kora")));
    }

    @HttpRoute(method = HttpMethod.GET, path = "/duration/void")
    public HttpServerResponse nothing() {
        service.nothing();
        return HttpServerResponse.of(200, HttpBody.plaintext("done"));
    }

    @HttpRoute(method = HttpMethod.GET, path = "/duration/fail")
    public HttpServerResponse fail() {
        return HttpServerResponse.of(200, HttpBody.plaintext(service.fail()));
    }
}

package example.app

import io.koraframework.common.annotation.Component
import io.koraframework.http.common.HttpMethod
import io.koraframework.http.common.annotation.HttpRoute
import io.koraframework.http.common.body.HttpBody
import io.koraframework.http.server.common.annotation.HttpController
import io.koraframework.http.server.common.response.HttpServerResponse

@Component
@HttpController
class HelloController(private val service: GreetingService) {
    @HttpRoute(method = HttpMethod.GET, path = "/hello")
    fun hello(): HttpServerResponse =
        HttpServerResponse.of(200, HttpBody.plaintext(service.greet("Kora")))

    @HttpRoute(method = HttpMethod.GET, path = "/duration/void")
    fun nothing(): HttpServerResponse {
        service.nothing()
        return HttpServerResponse.of(200, HttpBody.plaintext("done"))
    }

    @HttpRoute(method = HttpMethod.GET, path = "/duration/fail")
    fun fail(): HttpServerResponse =
        HttpServerResponse.of(200, HttpBody.plaintext(service.fail()))
}

Внедрение через конструктор гарантирует получение сгенерированного подкласса. /duration/void показывает выполнение метода без значения; /duration/fail оставляет исключение сервиса в обычном пути HTTP-ошибки. Аспект не превращает ошибки в успешные ответы.

Выберите один формат конфигурации и добавьте соответствующий ресурс:

httpServer.port = 8080
httpServer.system.port = 8085
logging.levels {
  "example.aspect" = "INFO"
}

httpServer:
  port: 8080
  system:
    port: 8085
logging:
  levels:
        "example.aspect": "INFO"

Сгенерированный logger использует SLF4J напрямую, поэтому уровень задаётся конфигурацией журналирования Kora. Самому аспекту bridge JDK logging не требуется.

Сгенерированный код аспекта¶

После компиляции откройте сгенерированный подкласс:

build/generated/sources/annotationProcessor/java/main/example/app/$GreetingService__AopProxy.java

build/generated/ksp/main/kotlin/example/app/$GreetingService__AopProxy.kt

При одном аспекте переопределение имеет следующую форму. Это сокращённая иллюстрация; для цепочки аспектов Kora может вводить вспомогательные методы:

@Override
public String greet(String name) {
    long _logDurationStarted = System.nanoTime();
    try {
        return super.greet(name);
    } finally {
        org.slf4j.LoggerFactory.getLogger("example.aspect")
            .info("{} took {} ns", "example.app.GreetingService.greet",
                System.nanoTime() - _logDurationStarted);
    }
}

override fun greet(name: String): String {
    val _logDurationStarted = System.nanoTime()
    try {
        return super.greet(name)
    } finally {
        org.slf4j.LoggerFactory.getLogger("example.aspect")
            .info("{} took {} ns", "example.app.GreetingService.greet",
                System.nanoTime() - _logDurationStarted)
    }
}

Найдите фабрику в ApplicationGraph: для зависимости GreetingService она должна создавать подкласс. Исходник показывает границу измерения, единственный вызов и передачу исключения. Для изменения поведения редактируйте фабрику аспекта или исходный сервис, а не этот файл.

Запуск приложения¶

./gradlew clean classes
./gradlew run

./gradlew.bat clean classes
./gradlew.bat run

Если продолжаете граф Neo4j, запустите БД и задайте NEO4J_PASSWORD по предыдущему руководству. Самостоятельному графу аспекта они не нужны.

Проверка приложения¶

В другом терминале выполните (curl.exe в PowerShell):

curl -i http://localhost:8080/hello
curl -i http://localhost:8080/duration/void
curl -i http://localhost:8080/duration/fail

Длительность меняется; запись имеет вид example.app.GreetingService.greet took ... ns. HTTP-обработка ошибки может создать дополнительные записи, поэтому считайте только сообщения example.aspect. Не полагайтесь на точное тело ошибки.

Проверка контракта перехвата¶

Остановите приложение и временно сделайте GreetingService final в Java или уберите open у Kotlin-класса. Выполните classes: компиляция должна отвергнуть непереопределяемую цель аспекта. Восстановите объявление. В Kotlin временно замените greet на open suspend fun: фабрика сообщает @LogDuration supports synchronous methods only (вызывающему коду тоже понадобится обработка suspension). Верните синхронную сигнатуру.

Проверьте три сгенерированных метода: следующий слой вызывается один раз, измерение находится в finally, а catch не заменяет исходное исключение. При расширении аспекта добавьте прямые тесты возвращаемых значений, идентичности исключения, void/Unit, конфликтов имён параметров и self-invocation. Телеметрия в finally не должна бросать исключения и скрывать прикладную ошибку. После проверки остановите приложение через Ctrl+C.

Расширение аспекта¶

Для внедрения телеметрии AP использует context.fieldFactory().constructorParam(...), KSP — aspectContext.fieldFactory.constructorParam(...). Kora добавляет поле в сгенерированный конструктор и разрешает тип из графа. constructorInitialized(...) создаёт поле, инициализируемое один раз кодом конструктора. Runtime-телеметрия остаётся в обычном модуле; обработчик генерирует вызовы, а не подключается к runtime-сервисам.

Помечайте вспомогательную аннотацию @AopPropagate из io.koraframework.common.annotation, если генераторы Kora должны перенести её на методы или параметры. Примеры — @Log.off и @Fallback.Reason. Перенос не активирует аспект: основной аннотации по-прежнему нужны @AopAnnotation и зарегистрированная фабрика.

При нескольких аспектах сохраняйте superCall и смотрите фактический порядок генерации. Комбинации отказоустойчивости показывают, почему порядок оболочек меняет поведение.

Лучшие практики¶

• Отделяйте runtime-аннотации от зависимостей compiler SPI.
• Сохраняйте переданный вызов следующего слоя и исходный контракт метода.
• Используйте System.nanoTime() для длительности, а не календарное время.
• Объявляйте синхронные и async-границы до обещания метрик завершения.
• Получайте сервис из графа и оставляйте методы переопределяемыми.
• Не допускайте исключений в журналировании и телеметрии; проверяйте цепочку аспектов в генерации.

Итоги¶

Вы создали аннотацию, зарегистрировали фабрику AP/KSP, подключили управляемый графом сервис и изучили подкласс. HTTP-проверки показывают измерение при возврате, void/Unit и ошибке без изменения прикладного кода сервиса.

Ключевые понятия¶

• @AopAnnotation запрашивает перехват при компиляции.
• KoraAspectFactory предоставляет поведение AOP-обработчику Kora.
• ApplyResult.MethodBody задаёт тело; класс генерирует Kora.
• superCall сохраняет следующий слой цепочки аспектов.
• finally охватывает возврат и исключение; синхронный таймер заканчивается при возврате.
• Граф выбирает подкласс; прямой конструктор его обходит.

Устранение неполадок¶

Подкласс не сгенерирован

Проверьте @AopAnnotation, точный service path фабрики в JAR обработчика, зависимость annotationProcessor/ksp и стандартный обработчик Kora. Регистрация обычного provider не является регистрацией аспекта.

Невозможно переопределить метод

Уберите Java final или добавьте Kotlin open классу и методу. Не аннотируйте private/static; используйте доступный однозначный конструктор.

Метод выполняется без записи длительности

Найдите создание подкласса в графе, исключите ручной new GreetingService() и проверьте INFO для example.aspect. Убедитесь, что маршрут вызывает аннотированный метод.

Async-длительность слишком короткая

Фабрика измеряет только синхронный вызов. Для async-результата нужен перехват завершения; suspend намеренно отвергается.

Что дальше?¶

• Используйте наблюдаемость, чтобы заменить учебное журналирование внедряемой телеметрией.
• Изучите отказоустойчивость для реальной композиции аспектов.
• Используйте компонентное тестирование для проверки сервисов через сгенерированный граф.

Помощь¶

Проверьте документацию DI для разрешения графа и журналирование для настройки logger. В исходниках фреймворка определены Java SPI аспектов и Kotlin SPI аспектов; перед расширением примера сверяйте их с зафиксированной версией Kora.