Azure Mobile Services .NET Backend : Custom API Oluşturmak

Merhabalar,
Bir önceki yazımda Azure’da barındırılan bir mobil servise nasıl tablo eklendiğinden bahsetmiştim. Bu yazımda ise mobil servise bir Custom api ekleyeceğiz.

Tablo oluştururken önce tablo şablonu için EntityData sınıfında türeyen bir sınıf ekleyip daha sonra bir Controller(Table controller) eklemiştik. Custom api oluştururken ise Custom controller ekliyor olacağız.

Bu yazımda şöyle bir basit senaryo düşündüm.

  • Parametre olarak bir sitenin url’sini alan bir api yazacağız
  • Bu api parametre olarak gelen sitenin başlığını çekecek (<title></title> etiketleri arasını)
  • Çekilen başlığı mobil servisimizin veritabanındaki Titles adındaki tablosuna ekleyecek.

Başlamadan önce mobil servise kullanacağımız Title şablonuna uygun bir tablo ekleyeceğiz. Bu yazının konusu tablo eklemeyle ilgili olmadığı için burayı atlıyorum. Şöyle bir tablo ekledim;

Site ve value alanları sitenin adresi ve başlığı için.

Şimdi solution explorer’da Controllers klasörüne sağ tık yapıp Add -> Controller seçelim.

Bunu yaptıktan bir pencere açılacak, o pencereden Custom controller seçip Add butonuna tıklayalım.

İsim olarak getTitleController verdim. Dikkat edilmesi gereken nokta controller isminin controller ile bitmesi gerekiyor. Bu işlemi de yaptıktan sonra controller sınıfımız açılmış olacak. Default olarak şöyle geliyor:

Gördüğünüz gibi son derece basit bir örnek, api çağrıldığında geriye “Hello” dönecek.

Şimdi apimizi yazının başında verdiğim senaryoya göre düzenleyeceğiz. Api, parametre olarak bir website url string alacak, o url’in <title></title> etiketleri arasındaki veriyi çekecek ve bizim mobil servisimizdeki Titles tablosuna ekleyecek.

 public class getTitleController : ApiController
{
public ApiServices Services { get; set; }

servicesampleContext context = new servicesampleContext();

// GET api/getTitle
public string Get(string url)
{
WebClient client = new WebClient();
string source = client.DownloadString(url);
string title = Regex.Match(source, @"\<title\b[^>]*\>\s*(?<Title>[\s\S]*?)\</title\>", RegexOptions.IgnoreCase).Groups["Title"].Value;

this.context.Titles.Add(new Title { Id = (context.Titles.Count<Title>() + 1).ToString(), Site = url, Value = title });
this.context.SaveChanges();

return url + " basligi eklendi";
}

}

Bu kodda açıklanması gereken bir kaç kısım var. serviceSample benim azure üzerinde oluşturduğum mobil servisin ismi idi. serviceSampleContext ise bu servisimin Data context’i. (Data context kavramından bir önceki makalede bahsetmiştim. Kısaca açıklamak gerekirse Data context bizim tablolarımız arasındaki ilişkiyi kuran yapı. Bir tabloya custom api üzerinden veri eklemek için serviceSampleContext’i kullanmamız gerekecek.)


Kodu düzenlemen önce Get metodu parametre almıyordu, biz onu url parametresini alacak şekilde düzenledik. Daha sonra WebClient sınıfını kullanarak url’in html kaynağını string olarak indirdik. Sonrasında regex ile site başlığını çektik.(İtiraf ediyorum regex patternı ben yazmadım. : ) )

Sonrasında ise context’imizin Titles adlı özelliğine yeni bir Title sınıfı örneği ekledik. Ve bu değişiklikleri kaydetmek için SaveChanges() metodunu çağırdık.

Servisi bu haliyle test ettiğimizde parametre olarak girilen url’in tabloya eklendiğini göreceğiz. Browser üzerinden apiye direk çağrıda url’de : ve // karakterleri olduğundan izin verilmiyor, bu sebeple mobile services’ın test aracını kullandım.

Bu apileri client üzerinden nasıl çağrıldığına, nasıl parametreler gönderildiğine önümüzdeki günlerde değineceğim fakat kısaca bahsetmek gerekirse

Mobil servisin InvokeApiAsync(string apiismi) veya InvokeApiAsync(string apiismi, IDictionary<string,string> parametreler) metodlarını kullanarak custom apilere client üzerinden çağrı gönderebiliyoruz. 

Azure mobile services üzerinde custom api oluşturup basit bir örnek yaptık, faydalı olması dileğiyle.

Fazlasını Oku

Azure Mobile Services .NET Backend : Tablo Ekleme

Merhaba arkadaşlar,

Bu yazımda Azure Mobile Services .NET backend’inde tablo oluşturmayı anlatacağım. Bu yazıyı okumadan önce mobil servislerdeki tablolarla ilgili kavramları anlattığım buradaki yazıyı okumanızı tavsiye ederim.

Öncelikle mobil servis projesini azure portaldan bilgisayara indirdikten sonra projeyi Visual Studio’da açalım. (Projeyi ilk defa açıyorsanız önce build etmek gerekiyor.)

Tablo oluşturmak için oluşturacağımız tablo için bir Data Object sınıfı hazırlamamız gerekiyor. Data object sınıfında ilgili tablonun alanlarını belirtiyoruz.

1. Data Object tanımlama: Solution Explorer’da DataObjects klasörünün üzerine sağ tık yapıp Add -> New Class seçerek yeni bir sınıf ekleyelim. Ve ismine Kitap.cs verelim.

Bu sınıfı EntityData sınıfından türetmemiz ve oluşturacağımız tabloda hangi alanların olacağını belirtmemiz gerekiyor.


2 . Table Controller Ekleme : Şimdi de tablomuz için bir Controller ekleyeceğiz. Bu controller ise tabloya veri ekleme, silme, güncelleme gibi işlemleri handle ettiğimiz sınıf olacak.

Solution Explorer’da Controllers klasörüne sağ tıklayıp Add -> Controller seçelim.

Açılan pencereden Table Controller’ı seçip Add butonuna tıklayalım.

Şimdi de açılan pencerede Model Class kısmında biraz önce oluşturduğumuz Kitap sınıfını seçelim.

Add butonuna tıklandığında Kitap tablosu oluşmuş olacak. 

Şimdi servisi localde çalıştırıp Kitap tablosu için veri ekleyelim.

Gördüğünüz gibi tabloya ilk veriyi ekledik.

Bu işlemden sonra Visual Studio’da Server explorer’da ilgili tablo görünür olacak.

Bu yazımda Azure Mobile Services’te bulunan .NET backendli servisi için nasıl tablo oluşturulacağı hakkında bilgiler verdim. Faydalı olması dileğiyle.

Fazlasını Oku

Azure Mobile Services .NET Backend : Temel Kavramlar

Merhaba arkadaşlar,

Bildiğiniz gibi bir süre önce Azure Mobile Services için .NET backend’i preview’dan çıktı. Ben dahil javascript yazmak istemeyenleri sevindiren bir olaydı.

Bu yazımda Azure Mobile Services’teki Data Context, Data Object ve Controller kavramlarına değineceğim. 

Data Context
Mobil servisin data kısmını bağlayan iskelet gibi düşünebiliriz. Oluşturulan tüm tablolar datacontext’te belirtilmelidir. Data context, Mobil servisi bilgisayarınıza indirdiğinizde default olarak \Models klasörüne bulunan \sampleContext.cs dosyasıdır. Bu context’i silmeyip bunu kullanmanızı öneririm.

Data Object
Data object oluşturacağınız her bir tabloda bulunacak alanları belirttiğiniz bir şablondur. Oluşturacağınız her bir tablo için \DataObjects klasörüne EntityData sınıfından türemiş bir sınıf eklemelisiniz ve oluşturacağınız tabloda olmasını istediğiniz alanları bu sınıf içerisine property olarak eklemelisiniz. Bildiğimiz sınıf, fakat EntityData‘dan türemesi şarttır.

Örnek bir data object sınıfı:

 public class Ogrenci : EntityData
{
public string Name { get; set; }
public string Surname { get; set; }
}


Controller
Tablo ile ilgili her işlem controller sınıflarında yapılır. Javascript backendindeki insert, del, update scriptlerindeki işlemler .NET backend inde controller sayesinde yapılır. Ayrıca custom api oluşturmak için de controller oluşturulur.

Örneğin: Tabloya her ekleme işlemini handle eden Controller içinde bulunan PostTodoItem metodu:

        // POST tables/TodoItem/[id]
public async Task<IHttpActionResult> PostTodoItem(TodoItem item)
{
TodoItem current = await InsertAsync(item);
return CreatedAtRoute("Tables", new { id = current.Id }, current);
}

.NET backendi ile bilinmesi gereken temel kavramlar bunlardı. Önümüzdeki günlerde Tablo oluşturma, custom api oluşturma, controller’a parametre gönderme konularında yazılar yazacağım.

Görüşmek üzere.

Fazlasını Oku