Swift Academy · Pelajaran

ORM Fluent dan Model

Simpan data dengan ORM Fluent Vapor.

Pelajaran 3 daripada 413 langkah

ORM Fluent dan Model ialah pelajaran Swift Academy percuma di CoddyKit. Ini ialah pelajaran 3 daripada 4. Sebanyak 3 pelajaran dalam laluan pembelajaran ini boleh dibaca sepenuhnya secara percuma — selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan praktikal dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Swift Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Swift Academy merangkumi sejumlah 4 pelajaran.

Apakah Fluent

Fluent ialah ORM Vapor. Ia memetakan kelas Swift kepada baris pangkalan data dan menyokong PostgreSQL, MySQL, SQLite serta MongoDB melalui satu API. Anda menulis Swift; Fluent menulis SQL.

import Fluent
import Vapor

Menentukan Model

Model Fluent ialah final class yang mematuhi Model dan biasanya Content. Model ini mengisytiharkan schema (nama jadual) dan sifat @ID untuk kunci primer.

final class Planet: Model, Content {
    static let schema = "planets"

    @ID(key: .id)
    var id: UUID?

    init() {}
}

Pembungkus Sifat @Field

Petakan lajur tersimpan dengan @Field. Kuncinya ialah nama lajur pangkalan data. Tambahkan satu sifat bagi setiap lajur yang ingin anda kekalkan.

@Field(key: "name")
var name: String

@Field(key: "diameter_km")
var diameterKm: Int

Model Lengkap

Model juga memerlukan penginisialisasi berasaskan ahli (selain init() kosong yang diperlukan) supaya anda boleh mencipta tika dalam kod.

final class Planet: Model, Content {
    static let schema = "planets"
    @ID(key: .id) var id: UUID?
    @Field(key: "name") var name: String
    init() {}
    init(id: UUID? = nil, name: String) {
        self.id = id
        self.name = name
    }
}

Migrasi

Migrasi mencipta atau mengubah skema pangkalan data. Ia mematuhi AsyncMigration dan melaksanakan prepare (guna) serta revert (buat asal).

struct CreatePlanet: AsyncMigration {
    func prepare(on db: Database) async throws {
        try await db.schema("planets")
            .id()
            .field("name", .string, .required)
            .create()
    }
    func revert(on db: Database) async throws {
        try await db.schema("planets").delete()
    }
}

Mendaftarkan Migrasi

Tambahkan migrasi kepada app.migrations dalam konfigurasi anda, kemudian jalankannya dengan app.autoMigrate() atau perintah migrate.

app.migrations.add(CreatePlanet())
try await app.autoMigrate()

Menyimpan Rekod

Cipta tika model dan panggil save(on:) dengan pangkalan data permintaan. Fluent mengeluarkan INSERT dan mengisi pengenal yang dijana.

app.post("planets") { req async throws -> Planet in
    let planet = try req.content.decode(Planet.self)
    try await planet.save(on: req.db)
    return planet
}

Membuat Pertanyaan Rekod

Gunakan Model.query(on:) untuk membina pertanyaan secara lancar. .all() mengembalikan setiap baris; rangkaikan penapis dan pengisihan mengikut keperluan.

app.get("planets") { req async throws -> [Planet] in
    try await Planet.query(on: req.db).all()
}

Menapis dan Mencari mengikut ID

find(_:on:) mendapatkan data berdasarkan kunci primer dan mengembalikan nilai pilihan. filter mengecilkan hasil berdasarkan nilai lajur.

let earth = try await Planet.query(on: req.db)
    .filter(\.$name == "Earth")
    .first()

let byId = try await Planet.find(someUUID, on: req.db)

Mengemas Kini dan Memadam

Ubah sifat model yang telah diperoleh dan panggil update(on:), atau buangnya dengan delete(on:). Kedua-duanya berjalan secara tak segerak pada pangkalan data.

if let planet = try await Planet.find(id, on: req.db) {
    planet.name = "Renamed"
    try await planet.update(on: req.db)
    // or: try await planet.delete(on: req.db)
}

Hubungan

Fluent memodelkan hubungan dengan pembungkus sifat: @Parent dan @Child untuk hubungan satu dengan satu atau satu dengan banyak, serta @Siblings untuk hubungan banyak dengan banyak. Pembungkus ini menentukan kunci asing dan membolehkan pemuatan awal dengan .with(...).

@Parent(key: "star_id")
var star: Star

// query eagerly loading the parent
Planet.query(on: req.db).with(\.$star).all()

Semakan Pantas: Fluent

Uji pemahaman anda tentang ORM.

Jawab dalam pelajaran interaktif

Ulang Kaji: ORM dan Model Fluent

Anda kini boleh mengekalkan data dengan Fluent:

Tentukan final class Model dengan pembungkus sifat @ID dan @Field serta schema.
Cipta jadual melalui AsyncMigration dan jalankannya dengan autoMigrate().
Lakukan operasi CRUD dengan save, query(on:), find, update dan delete.
Modelkan hubungan dengan @Parent, @Child dan @Siblings, dengan pemuatan awal melalui .with.

Percuma untuk bermula

Pelajari Swift dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus: 122
Pelajaran: 409

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “ORM Fluent dan Model” percuma?

Ya — sebanyak 3 pelajaran dalam laluan pembelajaran Swift Academy, termasuk “ORM Fluent dan Model”, boleh dibaca sepenuhnya secara percuma di web ini. Selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan interaktif dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Kursus Swift Academy merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “ORM Fluent dan Model”?

Simpan data dengan ORM Fluent Vapor. Anda berlatih Swift Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Swift Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Swift Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 3 daripada 4.

Berapa lamakah pelajaran “ORM Fluent dan Model” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Swift Academy ini?

Ya. Setiap pelajaran Swift Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

← Kembali ke Swift Academy