Java Academy · Lektion

Builder-mønsteret med fluent API

Konstruér komplekse objekter trin for trin med en fluent builder for at undgå teleskoperende konstruktører.

Lektion 4 af 413 trin

Builder-mønsteret med fluent API er en gratis Java Academy-lektion på CoddyKit. Dette er lektion 4 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.

Problemet med teleskopkonstruktører

Når en klasse har mange valgfrie parametre, bliver der flere og flere konstruktører: med 2 parametre, 3 parametre, 4 parametre ... Builder-mønsteret løser dette med en flydende API til trinvis konfiguration.

// Without builder — hard to read:
Pizza p = new Pizza("large", "thin", true, false, true, false, "mozzarella");

Grundlæggende Builder-struktur

Opret en statisk indlejret Builder-klasse. Den ydre klasse har en privat konstruktør, der modtager builderen. Hver setter i builderen returnerer this, så kald kan kædes sammen.

public final class Pizza {
    private final String size, crustType, cheese;
    private final boolean extraSauce, pepperoni;
    private Pizza(Builder b) {
        this.size = b.size; this.crustType = b.crustType;
        this.cheese = b.cheese; this.extraSauce = b.extraSauce;
        this.pepperoni = b.pepperoni;
    }
    public static class Builder {
        private final String size;
        private String crustType = "regular", cheese = "mozzarella";
        private boolean extraSauce, pepperoni;
        public Builder(String size) { this.size = size; }
        public Builder crustType(String c) { this.crustType = c; return this; }
        public Builder cheese(String c)    { this.cheese = c;    return this; }
        public Builder extraSauce()        { this.extraSauce = true; return this; }
        public Builder pepperoni()         { this.pepperoni = true; return this; }
        public Pizza build()               { return new Pizza(this); }
    }
}

Brug af en flydende API

Builderen kan læses som en sætning. Påkrævede parametre angives i konstruktøren, mens valgfrie parametre angives som metodekald. Det afsluttende kald til build() opretter det uforanderlige objekt.

Pizza p = new Pizza.Builder("large")
    .crustType("thin")
    .extraSauce()
    .pepperoni()
    .build();
System.out.println(p);

Validering i build()

Tilføj valideringslogik i build(), før objektet oprettes. Kast IllegalStateException eller IllegalArgumentException ved ugyldige kombinationer.

public Pizza build() {
    if (size == null || size.isBlank())
        throw new IllegalArgumentException("Size required");
    if (extraSauce && crustType.equals("stuffed"))
        throw new IllegalStateException("No extra sauce on stuffed crust");
    return new Pizza(this);
}

Builder til uforanderlige objekter

Fordi den ydre klasse oprettes fra builderen i én operation, kan alle felter være final — hvilket gør det resulterende objekt fuldstændig uforanderligt og trådsikkert.

public final class Address {
    private final String street, city, country;
    private final String postalCode;
    private Address(Builder b) { ... } // all finals
    // no setters — immutable!
}

Generisk Builder med selvtype

Brug en rekursiv generisk typeparameter (SELF extends Builder<SELF>) i nedarvningshierarkier, så builderne i underklasser returnerer underklassens type fra kædede metoder.

public abstract static class Builder<SELF extends Builder<SELF>> {
    String name;
    @SuppressWarnings("unchecked")
    public SELF name(String n) { this.name = n; return (SELF) this; }
    public abstract Vehicle build();
}

Lombok @Builder

Lomboks @Builder genererer hele builder-infrastrukturen på kompileringstidspunktet. Brug @Builder.Default til standardværdier for felter og @Singular til samlinger.

@Builder
public class Report {
    private final String title;
    @Builder.Default private final int pageCount = 1;
    @Singular private final List<String> authors;
}
// Usage:
Report r = Report.builder().title("Q4").author("Alice").author("Bob").build();

Builder i JDK'et

Mange JDK-klasser bruger API'er i Builder-stil: StringBuilder, HttpRequest.newBuilder(), ProcessBuilder og Stream.Builder. Lær at genkende mønsteret.

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.example.com/users"))
    .header("Accept", "application/json")
    .GET()
    .build();

Builder kontra fabrik

Brug Builder, når et objekt kræver mange parametre og trinvis konfiguration. Brug en fabrik, når alle varianter er enkle, og oprettelsen kan klares med ét kald.

Builder til testdata

Builder-mønsteret er særligt nyttigt i tests: Opret en grundbuilder i en hjælpefunktion, og tilsidesæt derefter kun de felter, der er relevante for hvert testtilfælde — så testene forbliver DRY og læsbare.

User defaultUser() { return new User.Builder("test@example.com").name("Test User").build(); }
User adminUser()   { return new User.Builder("admin@example.com").name("Admin").role(ADMIN).build(); }

Trådsikkerhed

Builderen er ikke selv trådsikker — del ikke en Builder mellem tråde. Produktet, der oprettes med den, kan være uforanderligt og trådsikkert, hvis alle felter er final, og ingen foranderlige objekter deles.

Hurtigt tjek

Hvad gør en buildermetode "flydende"?

Besvar den i den interaktive lektion

Opsummering

Builder løser problemet med teleskopkonstruktører. Brug en statisk indlejret Builder-klasse, returnér this fra hver setter, validér i build(), og opret et uforanderligt objekt. Lombok @Builder automatiserer standardkoden.

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

Start gratis Se hele kurset

Ofte stillede spørgsmål

Er lektionen “Builder-mønsteret med fluent API” gratis?

Ja — hele teksten til “Builder-mønsteret med fluent API” 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 “Builder-mønsteret med fluent API”?

Konstruér komplekse objekter trin for trin med en fluent builder for at undgå teleskoperende konstruktører. 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 4 af 4.

Hvor lang tid tager lektionen “Builder-mønsteret med fluent API”?

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

← Tilbage til Java Academy