Oluşturucu Kalıbı

Coddy'nin Swift Journey'sinin Nesne Yönelimli Programlama bölümünün bir parçası. Ders 48 / 57.

builder deseni, karmaşık bir nesneyi adım adım oluşturur. Her adım bir parçayı ayarlar ve builder'ı döndürür; böylece adımlar zincirlenebilir ve son olarak build() tamamlanmış nesneyi oluşturur:

struct Request {
    let url: String
    let method: String
    let headers: [String: String]
}

struct RequestBuilder {
    private var url = ""
    private var method = "GET"
    private var headers: [String: String] = [:]

    func url(_ u: String) -> RequestBuilder { var b = self; b.url = u; return b }
    func method(_ m: String) -> RequestBuilder { var b = self; b.method = m; return b }
    func header(_ k: String, _ v: String) -> RequestBuilder { var b = self; b.headers[k] = v; return b }
    func build() -> Request { Request(url: url, method: method, headers: headers) }
}

let req = RequestBuilder().url("/users").method("POST").header("Auth", "token").build()
print("\(req.method) \(req.url) \(req.headers.count) header")

Çıktı:

POST /users 1 header

Builder, nesneyi oluşturmadan önce yapılandırmanın tamamını kontrol edebilir; böylece geçersiz bir nesne asla oluşturulmaz. Burada, gerekli bir parça eksik olduğunda build() hata fırlatır:

enum BuildError: Error { case missingURL }

struct Request { let url: String; let method: String }

struct RequestBuilder {
    private var url: String?
    private var method = "GET"
    func url(_ u: String) -> RequestBuilder { var b = self; b.url = u; return b }
    func method(_ m: String) -> RequestBuilder { var b = self; b.method = m; return b }
    func build() throws -> Request {
        guard let url else { throw BuildError.missingURL }
        return Request(url: url, method: method)
    }
}

do {
    _ = try RequestBuilder().method("PUT").build()
} catch {
    print("cannot build: \(error)")
}

Çıktı:

cannot build: missingURL

Her adım struct'ı kopyalar ve kopyayı değiştirir; bu nedenle kısmen yapılandırılmış bir builder, birkaç nesne için şablon olarak yeniden kullanılabilir:

struct PizzaBuilder {
    private var size = "medium"
    private var toppings: [String] = []
    func size(_ s: String) -> PizzaBuilder { var b = self; b.size = s; return b }
    func add(_ t: String) -> PizzaBuilder { var b = self; b.toppings.append(t); return b }
    func build() -> String { "\(size) pizza with " + (toppings.isEmpty ? "nothing" : toppings.joined(separator: ", ")) }
}

let base = PizzaBuilder().size("large").add("cheese")
print(base.add("ham").build())
print(base.add("olives").build())

Çıktı:

large pizza with cheese, ham
large pizza with cheese, olives

Swift'in varsayılan parametre değerleri basit durumları zaten kapsar (Request(url: "/", method: "GET")). Bir nesnenin birçok isteğe bağlı parçası, birbirine bağlı parçaları veya var olabilmesi için önceden denetlenmesi gereken kuralları olduğunda oluşturucu işe yarar.

// basit: varsayılan argümanlar yeterli
struct Point { var x = 0, y = 0 }
// karmaşık: birçok isteğe bağlı parça ve doğrulama -> builder
let report = ReportBuilder().title("Q3").add(section: s1).add(section: s2).footer("draft").build()

Görev

Kolay

E-posta iletileri için bir oluşturucu yazın. EmailBuilder, zincirlenebilir to(_:) (birden çok kez çağrılabilir ve alıcılar ekler), subject(_:), body(_:) ve urgent() adımlarına sahiptir. build() bir Email döndürür veya EmailError.noRecipients ya da EmailError.noSubject hatası fırlatır. Acil bir e-postanın konu satırının önüne [URGENT] eklenir.

Sağlanan kod, her e-posta için komutları --- satırlarıyla ayrılmış şekilde okur (to ada@x.io, subject Hello, body text, urgent, ardından send) ve To: ada@x.io, bo@x.io | [URGENT] Hello | text, error: no recipients veya error: no subject çıktısını verir.

Kodunuz Email.swift, EmailError.swift ve EmailBuilder.swift dosyalarına yerleştirilmelidir. main.swift, sağlanan giriş/çıkış kodunu içerir ve düzenlenemez.

Kendin dene

// Sağlanan girdi/çıktı kodu: olduğu gibi bırakın
var input: [String] = []
while let line = readLine() { input.append(line) }
var builder = EmailBuilder()
for line in input {
    let p = line.split(separator: " ", maxSplits: 1).map(String.init)
    switch p[0] {
    case "to": builder = builder.to(p[1])
    case "subject": builder = builder.subject(p[1])
    case "body": builder = builder.body(p[1])
    case "urgent": builder = builder.urgent()
    case "send":
        do {
            let e = try builder.build()
            print("To: \(e.recipients.joined(separator: ", ")) | \(e.subject) | \(e.body)")
        } catch EmailError.noRecipients {
            print("error: no recipients")
        } catch {
            print("error: no subject")
        }
    default: builder = EmailBuilder()
    }
}