# Data - Veri Erişim Katmanı

### Açıklama

Bu belge veri erişim katmanı işlemlerini tanımlar. Veri erişim katmanı Veritabanı, Servis ve diğer veri kaynaklarına erişim için kullanılan katmandır.Bu katmanda:

* **İş mantığı bulunmaz**. (Sadece veri alma-verme işlemleri yapılır.)
* Veri istemcileri arayüzler üzerinden çalışır ve birim testleri oluşturulur.

### Veritabanı Erişimi

#### Repository metotları

Repository metotları temel olarak aşağıdaki adımlardan oluşur:

1. İstek bilgilerinin oluşturulması
2. Varsayılan dönüş değerinin tanımlanması
3. Veritabanı isteğinin yapılması ve sonucun döndürülmesi

**Örnek:**

```csharp
public bool UpdatePost(int postId, int memberId)
{
    var dataRequest = dataRequestFactory.UpdatePost(postId, memberId);
    var defaultReturnValue = false;

    return dataClient.GetScalar<bool>(dataRequest, defaultReturnValue);
}
```

#### DataRequest

Veritabanı işlemi istek bilgileri `IDataRequestFactory` aracılığıyla oluşturulur. Bu sınıfta istek bilgilerini içeren özel bir metot oluşturulur.

**Dikkat edilecek konular:**

1. Metot, çağrılacak prosedür ile aynı isme sahip olur.
2. Prosedür isimleri `ProcedureNames` sınıfında özellik olarak tanımlanır.
3. Parametre isimleri `ParameterNames` sınıfında özellik olarak tanımlanır.

**Vertabanı isteği oluşturma örneği:**

```csharp
public DataRequest UpdatePost(int postId, int memberId)
{
    string procedureName = ProcedureNames.UpdatePost;
    var parameters = new DynamicParameters();
    parameters.Add(ParameterNames.PostId, postId);
    parameters.Add(ParameterNames.MemberId, memberId);

    return new DapperDataRequest
    {
        ProcedureName = procedureName,
        Parameters = parameters
    };
}
```

**OUTPUT tipinde parametre kullanan bir örnek:**

```csharp
public int AddPost(Post post)
{
    var dataRequest = dataRequestFactory.AddPost(post);
    var defaultReturnValue = false;

    bool isSuccess = dataClient.GetScalar<bool>(dataRequest, defaultReturnValue);

    if (!isSuccess)
    {
        return 0;
    }

    return dataRequest.Parameters.Get<int>(ParameterNames.PostId);
}
```

Bu metot için veri isteği aşağıdaki gibi oluşturulur:

```csharp
public DataRequest AddPost(Post post)
{
    string procedureName = ProcedureNames.AddPost;
    var parameters = new DynamicParameters();
    parameters.Add(ParameterNames.PostSecureId, post.PostSecureId);
    parameters.Add(ParameterNames.MemberId, post.MemberId);
    parameters.Add(ParameterNames.PostTypeId, post.PostType.ToInt32());
    parameters.Add(ParameterNames.PostId, 0, DbType.Int32, ParameterDirection.Output, sizeof(int));

    return new DapperDataRequest
    {
        ProcedureName = procedureName,
        Parameters = parameters
    };
}
```

**SplitOn içeren veri isteği örneği:**

Sorgu sonucu dönen alanlar belli nesnelere göre gruplanarak alt sınıflar doldurulacaksa, ilgili nesnenin alanlarını döndüren alanlar belirtilir.

```csharp
public DataRequest GetProfileInfo(int memberId)
{
    string procedureName = ProcedureNames.GetProfileInfo;
    var parameters = new DynamicParameters();
    parameters.Add(ParameterNames.MemberId, memberId);

    return new DapperDataRequest
    {
        ProcedureName = procedureName,
        Parameters = parameters,
        SplitOnParameters = GetSplitOnParameters(ColumnNames.OccupationId, ColumnNames.EducationId)
    };
}

string GetSplitOnParameters(params string[] fieldNames)
{
    return string.Join(",", fieldNames);
}
```

Bu istek bilgilerini kullanan repository metodu aşağıda gösterilmiştir. `GetItem` metodu çağrılırken belirtilen ilk 3 tip (`ProfileInfo, Occupation, Education`) sorgunun ayrılacağı parçaları, son tip (`ProfileInfo`) dönüş tipini belirler.

```csharp
public ProfileInfo GetProfileInfo(int memberId)
{
    var dataRequest = dataRequestFactory.GetProfileInfo(memberId);
    ProfileInfo defaultValue = null;

    return dataClient.GetItem<ProfileInfo, Occupation, Education, ProfileInfo>(
        dataRequest,
        (profileInfo, occupation, education) =>
        {
            profileInfo.Education = education;
            profileInfo.Occupation = occupation;
            return profileInfo;
        },
        dataRequest.SplitOnParameters,
        defaultValue);
}
```

#### Varsayılan değerler

Veritabanı isteği başarısız olursa ya da döndürülecek bir kayıt bulunamazsa hangi sonucun döndürüleceği Repository metodunda yapılan çağrıda belirtilir.

`bool` tipinde dönüş değeri için varsayılan:

```csharp
var defaultReturnValue = false;
```

`int` ve sayısal dönüş değerleri için varsayılan:

```csharp
var defaultReturnValue = 0;
```

`string` tipinde dönüş değeri için varsayılan:

```csharp
string defaultReturnValue = null;
```

Sınıf tipinde dönüş değerleri için varsayılan:

```csharp
Post defaultReturnValue = null;
```

Özel durum için dönüş tipleri `IDefaultValueFactory` sınıfında tanımlanır.

```csharp
public PasswordActivation CreateDefaultPasswordActivation()
{
    return new PasswordActivation { IsActive = false };
}
```

Liste dönüş tipleri için varsayılan olarak boş liste döndürülür:

```csharp
var defaultValue = new List<Member>();
```

### Servis Erişimi

Servislere erişen Repository metotları temel olarak aşağıdaki adımlardan oluşur:

1. İstek bilgilerinin oluşturulması
2. İstek sonucunun uygun tipe çevrilmesi ve döndürülmesi
3. Hata kontrolü

Veritabanı istemcisi yerine Api istemcisi kullanılır. Diğer yönleriyle Veritabanı erişimi gibi tasarlanır ve kullanılır.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bekoturko.gitbook.io/yazilim-gelistirme-wiki/uygulama-yapisi-ve-katmanlari/veri-erisim-katmani.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.