Builder — βασικές αρχές του προτύπου κατασκευαστή στην ανάπτυξη κινητών

Τι είναι ο Builder: ουσία του προτύπου κατασκευαστή;

Builder (κατασκευαστής) — ένα δημιουργικό πρότυπο GoF που διαχωρίζει την κατασκευή ενός σύνθετου αντικειμένου από την αναπαράστασή του. Η ίδια διαδικασία κατασκευής μπορεί να δημιουργήσει διαφορετικές αναπαραστάσεις. Ο Builder είναι χρήσιμος όταν ένα αντικείμενο έχει πολλές προαιρετικές παραμέτρους και ένας κατασκευαστής με δέκα πεδία είναι δυσανάγνωστος και μη ευέλικτος. Το πρότυπο λύνει επίσης το πρόβλημα του Telescoping Constructor — ένα αντι-πρότυπο όπου ο αριθμός των υπερφορτώσεων του κατασκευαστή αυξάνεται εκθετικά.

Δομή Builder περιλαμβάνει μια εσωτερική στατική κλάση Builder με πεδία που αντιγράφουν τα πεδία της κύριας κλάσης. Κάθε set-μέθοδος επιστρέφει Builder (this) για fluent chaining. Η τελική build() μέθοδος δημιουργεί το αντικείμενο-στόχο, μεταβιβάζοντας τις τιμές των πεδίων στον ιδιωτικό κατασκευαστή. Η κύρια κλάση έχει έναν ιδιωτικό κατασκευαστή που δέχεται Builder. Πελάτης: Object.builder().setField1(val1).setField2(val2).build().

Πότε να χρησιμοποιείτε τον Builder — αντικείμενα με 5+ πεδία, από τα οποία μόνο 2-3 είναι υποχρεωτικά. Αντικείμενα διαμόρφωσης (RequestConfig, DatabaseConfig). Αντικείμενα με σύνθετη λογική επικύρωσης κατά τη δημιουργία. Αντικείμενα που πρέπει να είναι αμετάβλητα (immutable) μετά τη δημιουργία. Στο Android, ο Builder χρησιμοποιείται ενεργά στο SDK: AlertDialog.Builder, Retrofit.Builder, OkHttpClient.Builder, NotificationCompat.Builder.

Builder στην Kotlin: κλασική και DSL υλοποίηση

Kotlin Builder έχει δύο προσεγγίσεις: κλασικό Java-style Builder (μέσω ένθετης κλάσης) και Kotlin-style DSL builder (μέσω lambda με δέκτη). Ο Java-style Builder προτιμάται για συμβατότητα με Android και κατά τη χρήση με κώδικα Java. DSL builder — ιδιωματικός τρόπος Kotlin: η συνάρτηση δέχεται ένα lambda, μέσα στο οποίο το this είναι το περιβάλλον Builder, όπου τα πεδία μπορούν να εκχωρηθούν άμεσα.

// Κλασικός Builder
data class HttpConfig private constructor(
    val baseUrl: String,
    val timeout: Long = 30_000,
    val retries: Int = 3,
    val headers: Map<String, String> = emptyMap()
) {
    class Builder {
        private var baseUrl: String = ""
        private var timeout: Long = 30_000
        private var retries: Int = 3
        private var headers: MutableMap<String, String> = mutableMapOf()

        fun baseUrl(url: String) = apply { this.baseUrl = url }
        fun timeout(ms: Long) = apply { this.timeout = ms }
        fun retries(n: Int) = apply { this.retries = n }
        fun header(key: String, value: String) = apply { headers[key] = value }

        fun build(): HttpConfig {
            require(baseUrl.isNotBlank()) { "baseUrl is required" }
            return HttpConfig(baseUrl, timeout, retries, headers)
        }
    }
}

// Χρήση
val config = HttpConfig.Builder()
    .baseUrl("https://api.example.com")
    .timeout(15_000)
    .header("Authorization", "Bearer token")
    .build()

Kotlin DSL builder — εναλλακτική χωρίς ένθετη κλάση. Η builder-συνάρτηση δέχεται ένα lambda στο περιβάλλον του αντικειμένου-κατασκευαστή. Αυτό είναι ιδιωματικό για την Kotlin και δεν απαιτεί write-πεδία. Οι DSL builders χρησιμοποιούνται ενεργά στο Ktor Client, kotlinx.serialization, Compose (Modifier). Ο DSL builder δεν είναι συμβατός με Java και δεν είναι κατάλληλος για βιβλιοθήκες με Java API.

Builder στην Swift: result builders και αλυσίδες

Swift Builder — η Swift δεν έχει ενσωματωμένο πρότυπο Builder, αλλά το fluent interface υλοποιείται εύκολα μέσω μεθόδων που επιστρέφουν Self. Κάθε μέθοδος ρυθμίζει μια ιδιότητα και επιστρέφει self. Σε αντίθεση με την Kotlin, η Swift δεν απαιτεί ξεχωριστή κλάση Builder — το ίδιο το αντικείμενο μπορεί να επιστραφεί εάν είναι mutable στο στάδιο συναρμολόγησης. Για immutable αντικείμενα, χρησιμοποιείται ένθετη κλάση Builder παρόμοια με την Kotlin.

struct NetworkRequest {
    let url: String
    let method: HTTPMethod
    let headers: [String: String]
    let body: Data?
    let timeout: TimeInterval

    final class Builder {
        private var url: String = ""
        private var method: HTTPMethod = .get
        private var headers: [String: String] = [:]
        private var body: Data? = nil
        private var timeout: TimeInterval = 30

        func withURL(_: String) -> Self { /* self */ }
        func withMethod(_: HTTPMethod) -> Self { /* self */ }
        func withHeader(key: String, value: String) -> Self { /* self */ }
        func withBody(_: Data) -> Self { /* self */ }
        func withTimeout(_: TimeInterval) -> Self { /* self */ }

        func build() throws -> NetworkRequest {
            guard !url.isEmpty else { throw BuilderError.missingURL }
            return NetworkRequest(
                url: url, method: method, headers: headers,
                body: body, timeout: timeout
            )
        }
    }
}

Result Builders — η Swift 5.4 εισήγαγε το @resultBuilder — έναν γλωσσικό μηχανισμό για δηλωτική κατασκευή δομών. Τα SwiftUI, AttributedString, SceneBuilder χρησιμοποιούν result builders. Αυτό είναι μια εναλλακτική του κλασικού Builder: αντί για αλυσίδα set-μεθόδων, ο result builder χρησιμοποιεί ένα μπλοκ κώδικα με στοιχεία που ο μεταγλωττιστής συλλέγει σε πίνακα ή δέντρο. Το @ViewBuilder στο SwiftUI — το πιο γνωστό παράδειγμα: μέσα στο body μπορούν να γραφτούν if, switch, ForEach, και ο μεταγλωττιστής χτίζει View από τις συνθήκες.

Builder vs Telescoping Constructor: σύγκριση προσεγγίσεων

Telescoping Constructor — ένα αντι-πρότυπο όπου μια κλάση έχει πολλαπλούς υπερφορτωμένους κατασκευαστές με διαφορετικά σύνολα παραμέτρων. Για παράδειγμα, τρεις κατασκευαστές: HttpConfig(url), HttpConfig(url, timeout), HttpConfig(url, timeout, retries). Με την αύξηση των παραμέτρων, ο αριθμός των κατασκευαστών αυξάνεται εκθετικά — για n προαιρετικά πεδία χρειάζονται n! συνδυασμοί. Ο Builder λύνει αυτό το πρόβλημα επιτρέποντας τη ρύθμιση μόνο των απαραίτητων πεδίων.

Kotlin named arguments + default values — μια κομψή εναλλακτική του Builder σε καθαρά έργα Kotlin. Οι παράμετροι του κατασκευαστή έχουν προεπιλεγμένες τιμές, ο πελάτης μεταβιβάζει μόνο τις απαραίτητες: HttpConfig(baseUrl = url, timeout = 15_000). Μειονέκτημα — αδυναμία επικύρωσης υποχρεωτικών πεδίων στο στάδιο μεταγλώττισης. Ο Builder παρέχει υποχρεωτικά πεδία μέσω του κατασκευαστή Builder (baseUrl είναι υποχρεωτικό). Για βιβλιοθήκες Java, ο Builder παραμένει το de facto πρότυπο.

Builder στο Android SDK: AlertDialog, Retrofit, OkHttp

Builder στο Android SDK — ένα από τα πιο διαδεδομένα πρότυπα στην τυπική βιβλιοθήκη. AlertDialog.Builder: new AlertDialog.Builder(context).setTitle().setMessage().setPositiveButton().create(). Retrofit.Builder: new Retrofit.Builder().baseUrl().addConverterFactory().build(). OkHttpClient.Builder: new OkHttpClient.Builder().connectTimeout().addInterceptor().build(). NotificationCompat.Builder: setContentTitle().setContentText().setSmallIcon().build().

Γιατί η Google χρησιμοποιεί Builder — συμβατότητα προς τα πίσω. Η προσθήκη μιας νέας μεθόδου στον Builder δεν σπάει τον υπάρχοντα κώδικα. Αν η Google χρησιμοποιούσε κατασκευαστή με 20 παραμέτρους, κάθε νέο πεδίο θα απαιτούσε νέα υπερφόρτωση. Ο Builder επιτρέπει την προσθήκη set-μεθόδων για χρόνια χωρίς breaking changes. Για παράδειγμα, το NotificationCompat.Builder πρόσθεσε το setBubbleMetadata() στο Android 11, χωρίς να επηρεάσει τον υπάρχοντα κώδικα.

Builder σε βιβλιοθήκες Kotlin — Ktor (HttpClientBuilder), Coil (ImageRequest.Builder), Room (Room.databaseBuilder()), Navigation (NavOptionsBuilder). Σε έργα Kotlin, ο Builder συχνά συνδυάζεται με DSL: Room.databaseBuilder(context, AppDatabase.class, "db").fallbackToDestructiveMigration().build(). Το πρότυπο παραμένει σχετικό για δημόσια API όπου η συμβατότητα προς τα πίσω και η διαλειτουργικότητα Java είναι σημαντικές.