Film Tipi Alanının Eklenmesi

Eğer sinema filmleri ile birlikte diziler ve mini dizileri de Movie tablomuzda tutmak isteseydik, bu bilgiyi saklamak için başka bir alana ihtiyacımız olurdu Kind (Tip).

Movie tablosunu oluştururken bu alanı tanımlamadığımızdan, veritabanına eklemek için başka bir migration yazacağız.

MovieTutorial.Web/Modules/Common/Migrations/DefaultDB/ DefaultDB_20150924_142200_MovieKind.cs: dosyasında yeni bir migration oluşturun:

using FluentMigrator;
using System;

namespace MovieTutorial.Migrations.DefaultDB
{
    [Migration(20150924142200)]
    public class DefaultDB_20150924_142200_MovieKind : Migration
    {
        public override void Up()
        {
            Alter.Table("Movie").InSchema("mov")
                .AddColumn("Kind").AsInt32().NotNullable()
                    .WithDefaultValue(1);
        }

        public override void Down()
        {
        }
    }
}

MovieKind Enumeration'ının Tanımlanması

Kind alanı Movie tablosuna ekledikten sonra, film tiplerini içeren bir listeye ihtiyacımız olacak. MovieTutorial.Web/Modules/MovieDB/Movie/MovieKind.cs altında bir enum olarak tanımlayalım:

using Serenity.ComponentModel;
using System.ComponentModel;

namespace MovieTutorial.MovieDB
{
    [EnumKey("MovieDB.MovieKind")]
    public enum MovieKind
    {
        [Description("Film")]
        Film = 1,
        [Description("TV Series")]
        TvSeries = 2,
        [Description("Mini Series")]
        MiniSeries = 3
    }
}

Kind (Tip) Alanının MovieRow Entity'sine Eklenmesi

Artık Sergen'i kullanmadığımıza göre, Kind kolonu için MovieRow.cs dosyamıza manuel olarak bir eşleme (mapping) eklemeliyiz. Runtime property'sinden sonra aşağıdaki property tanımını ekleyin:

[DisplayName("Runtime (mins)")]
public Int32? Runtime
{
    get { return Fields.Runtime[this]; }
    set { Fields.Runtime[this] = value; }
}

[DisplayName("Kind"), NotNull]
public MovieKind? Kind
{
    get { return (MovieKind?)Fields.Kind[this]; }
    set { Fields.Kind[this] = (Int32?)value; }
}

Ek olarak, Serenity varlık (entity) sistemi için gerekli olan bir Int32Field nesnesi de tanımlamalıyız. MovieRow.cs dosyasının sonunda RowFields sınıfını bulun ve Runtime alanından sonra gelecek şekilde Kind alanını eklemek üzere düzenleyin:

public class RowFields : RowFieldsBase
{
    // ...
    public readonly Int32Field Runtime;
    public readonly Int32Field Kind;

    public RowFields()
        : base("[mov].Movie")
    {
        LocalTextPrefix = "MovieDB.Movie";
    }
}

Film Formuna Tip Seçimi Ekleme

Eğer şimdi projemizi derleyip çalıştırırsak, film (Movie) formunda herhangi bir değişiklik olmadığını farkederiz. Oysa, Kind alanı için MovieRow'a bir eşleme eklemiştik. Bunun nedeni, formda gösterilip düzenlecek alanlarının MovieForm.cs dosyasındaki property tanımlarıyla kontrol edilmekte olmasıdır.

Row'daki bazı alanlar formda gösterilmeyebilir.

MovieForm.cs'i aşağıdaki gibi düzenleyin:

namespace MovieTutorial.MovieDB.Forms
{
    // ...
    [FormScript("MovieDB.Movie")]
    [BasedOnRow(typeof(Entities.MovieRow))]
    public class MovieForm
    {
        // ...
        public Int32 Runtime { get; set; }
        public MovieKind Kind { get; set; }
    }
}

Şimdi solution'ı derleyip çalıştırın. Bir film kaydını düzenlemeye ya da yeni bir tane eklemeye çalıştığınızda, hiçbirşey olmayacaktır. Bu beklenen bir durumdur. Eğer tarayıcınızın geliştirici araçları konsolunu kontrol ederseniz (F12, öğeyi incele vs.) şöyle bir hatayla karşılaşırsınız:

Uncaught Can't find MovieTutorial.MovieDB.MovieKind enum type!

Bu hata, MovieKind enumuration tipinin, istemci tarafında mevcut olmamasından kaynaklanır. Uygulamamızı çalıştırmadan önce T4 şablonlarını dönüştürmemiz gerekirdi.

Visual Studio'da Build -> Transform All Templates (Derleme -> Tüm Şablonları Dönüştür) e tekrar tıklayın.

Solution'ı tekrar rebuild edip, çalıştırın. Artık film formumuzda, film tipini seçebileceğimiz hoş bir çekme menümüz var:

Film Tipi İçin Bir Öndeğer Belirleme

Kind zorunlu bir alan olduğundan, yeni bir film eklerken doldurmak zorundayız, aksi taktirde bir doğrulama (validation) hatası alırız.

Fakat saklayacağımız filmlerin büyük kısmı sinema filmi olacaktır, yani öndeğer olarak bu değer olmalı.

Kind property'sine bir öndeğer tanımlamak için, üstüne şunun gibi bir DefaultValue niteliği ekleyin:

[DisplayName("Kind"), NotNull, DefaultValue(1)]
public MovieKind? Kind
{
    get { return (MovieKind?)Fields.Kind[this]; }
    set { Fields.Kind[this] = (Int32?)value; }
}

Artık Add Movie (Film Ekle) diyaloğumuzda Kind (Tip) alanı Film olarak dolu gelecektir.