Java Academy · Lektion

Skriv et benchmark

@Benchmark og modes

Lektion 2 af 413 trin

Skriv et benchmark er en gratis Java Academy-lektion på CoddyKit. Dette er lektion 2 af 4. Du kan læse hele lektionen gratis nedenfor — og derefter øve dig praktisk i browseren med en indbygget kodeeditor og en AI-vejleder, der er tilgængelig døgnet rundt. Den er en del af læringsforløbet i Java Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Java Academy-kurset indeholder 4 lektioner i alt.

Skriv et benchmark

Et JMH-benchmark er blot en metode, der er annoteret med @Benchmark, i en almindelig klasse. JMH's annotationsprocessor genererer harnesset omkring den. Denne lektion gennemgår de annoteringer, der definerer, hvad og hvordan du måler.

Annoteringen @Benchmark

Markér enhver public-metode med @Benchmark, så kalder JMH den gentagne gange og måler hvert kald. Metodens returværdi bør returneres og ikke kasseres, så JMH kan bruge den.

En minimal benchmarkklasse

Her er strukturen for et benchmark. Importen er org.openjdk.jmh.annotations.*. Da JMH ikke findes på denne runners classpath, er dette kun et illustrativt eksempel.

import org.openjdk.jmh.annotations.Benchmark;

public class StringBench {
    @Benchmark
    public String concat() {
        return "foo" + System.nanoTime();
    }
}

Benchmarktilstande

@BenchmarkMode vælger, hvad der rapporteres:

  • Throughput — operationer pr. tidsenhed (højere er bedre).
  • AverageTime — tid pr. operation (lavere er bedre).
  • SampleTime — fordelingen af tider (percentiler).
  • SingleShotTime — ét kald, velegnet til kold start.
import org.openjdk.jmh.annotations.*;

public class Bench {
    @Benchmark
    @BenchmarkMode(Mode.AverageTime)
    public int work() {
        return 2 + 2;
    }
}

Valg af tidsenheder

@OutputTimeUnit angiver tidsenheden for rapporten, så tallene er lette at læse. For en hurtig operation giver nanosekunder mening; for en langsom operation millisekunder.

import java.util.concurrent.TimeUnit;
import org.openjdk.jmh.annotations.*;

public class Bench {
    @Benchmark
    @BenchmarkMode(Mode.AverageTime)
    @OutputTimeUnit(TimeUnit.NANOSECONDS)
    public int work() {
        return 42;
    }
}

Returnering af resultater

Du skal altid returnere resultatet af arbejdet. JMH giver automatisk returnerede værdier til en Blackhole, hvilket forhindrer eliminering af død kode. Et void-benchmark, der beregner noget og kasserer resultatet, er en klassisk fejl.

Standarder for annoteringer

Annoteringer kan placeres på metoden eller på hele klassen. Annoteringer på klasseniveau gælder for alle @Benchmark i klassen, hvilket holder konfigurationen DRY, når du har flere relaterede benchmarks.

Forgrening

@Fork(n) kører benchmarket i n nye JVM-processer. Forgrening isolerer hver kørsel fra JIT-profiler, der er opbygget af tidligere benchmarks, og forbedrer dermed reproducerbarheden. Standardværdien er én forgrening.

import org.openjdk.jmh.annotations.*;

@Fork(2)
public class Bench {
    @Benchmark
    public long now() {
        return System.nanoTime();
    }
}

Start af Runner

Du starter benchmarks via en main, der konfigurerer et Options-objekt og en Runner, eller via den genererede eksekverbare JAR-fil. Det regulære udtryk i include(...) vælger, hvilke benchmarks der skal køres.

import org.openjdk.jmh.runner.Runner;
import org.openjdk.jmh.runner.options.*;

public class Launcher {
    public static void main(String[] args) throws Exception {
        Options opt = new OptionsBuilder()
            .include("Bench")
            .build();
        new Runner(opt).run();
    }
}

Læsning af resultatet

JMH udskriver en tabel med benchmarknavnet, tilstanden, antallet af prøver, resultatet, resultatets fejl og enhederne, f.eks.: Bench.work avgt 25 3.142 +/- 0.011 ns/op. +/- er konfidensintervallet.

Hold benchmarks fokuserede

Hvert benchmark bør måle én ting. Hvis du blander opsætning, I/O og den operation, der testes, bliver resultatet uklart. Flyt forberedelsen til @Setup-metoder, som gennemgås sammen med tilstand, så kun den varme kodevej bliver målt.

Hurtigt tjek

Test din forståelse af, hvordan man skriver benchmarks.

Opsummering

Du har lært at skrive et JMH-benchmark:

  • Annotér en metode med @Benchmark, og returnér resultatet.
  • @BenchmarkMode vælger Throughput, AverageTime, SampleTime eller SingleShotTime.
  • @OutputTimeUnit angiver læselige enheder; @Fork isolerer kørsler i nye JVM'er.
  • Start med en Runner + Options eller den genererede JAR-fil.
  • Hold hvert benchmark fokuseret på én varm kodevej.
Gratis at komme i gang

Lær Java med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser
104
Lektioner
374

Ofte stillede spørgsmål

Er lektionen “Skriv et benchmark” gratis?

Ja — hele teksten til “Skriv et benchmark” kan læses gratis her på nettet. Hvis du vil øve dig interaktivt med en indbygget kodeeditor og en AI-vejleder døgnet rundt og få adgang til resten af Java Academy-kurset, skal du opgradere til CoddyKit PRO. Java Academy-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “Skriv et benchmark”?

@Benchmark og modes Du øver dig i Java Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på Java Academy?

Der kræves ingen tidligere erfaring. Java Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 2 af 4.

Hvor lang tid tager lektionen “Skriv et benchmark”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne Java Academy-lektion?

Ja. Alle Java Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

  1. Hvorfor JMH
  2. Skriv et benchmark
  3. Warmup og iterationer
  4. Undgå dead-code elimination
← Tilbage til Java Academy