Xamarin.Forms Web Hizmetleri tanıtımı

  • Makale
  • Okumak için 3 dakika

Örnek indir Örneği indirin

Bu konu, Xamarin.Forms farklı Web hizmetleriyle nasıl iletişim kurabileceğinizi gösteren örnek uygulamaya yönelik bir anlatım sağlar. Her Web hizmeti ayrı bir örnek uygulama kullandığından, işlevsel olarak benzerdir ve ortak sınıfları paylaşır.

Aşağıda açıklanan örnek Yapılacaklar listesi uygulaması, ile farklı türlerdeki Web hizmeti arka uçlarına nasıl erişebileceğinizi göstermek için kullanılır Xamarin.Forms . Şu işlevleri sağlar:

  • Görevlerin listesini görüntüleyin.
  • Görevleri ekleyin, düzenleyin ve silin.
  • Görevin durumunu ' bitti ' olarak ayarlayın.
  • Görevin adı ve notlar alanlarını konuşun.

Her durumda, görevler bir Web hizmeti üzerinden erişilen bir arka uçta depolanır.

Uygulama başlatıldığında, Web hizmetinden alınan tüm görevleri listeleyen bir sayfa görüntülenir ve kullanıcının yeni bir görev oluşturmasına izin verir. Bir göreve tıklanması, uygulamayı görevin düzenlenebildiği, kaydedileceği, silinebileceği ve konuşulan ikinci bir sayfaya götürür. Son uygulama aşağıda gösterilmektedir:

ToDo uygulaması-ilk sayfaToDo uygulaması-ikinci sayfa

Bu kılavuzdaki her konu, belirli bir Web hizmeti arka ucu türünü gösteren uygulamanın farklı bir sürümüne indirme bağlantısı sağlar. Her Web hizmeti stiliyle ilgili sayfada ilgili örnek kodu indirin.

Uygulama anatommumu anlama

Her örnek uygulama için paylaşılan kod projesi üç ana klasörden oluşur:

Klasör Amaç
Veriler Veri öğelerini yönetmek için kullanılan sınıfları ve arabirimleri içerir ve Web hizmetiyle iletişim kurar. Bu, en azından, TodoItemManagerApp Web hizmeti işlemlerini çağırmak için sınıfındaki bir özellik aracılığıyla ortaya çıkarılan sınıfını içerir.
Modeller Uygulama için veri modeli sınıflarını içerir. En azından, bu, TodoItem uygulama tarafından kullanılan tek bir veri öğesini modelleyen sınıfını içerir. Klasör, Kullanıcı verilerini modelleyebilir kullanılan ek sınıfları da içerebilir.
Görünümler Uygulamanın sayfalarını içerir. Bu genellikle, TodoListPage ve TodoItemPage sınıflarının yanı sıra kimlik doğrulama amacıyla kullanılan diğer sınıflardan oluşur.

Her uygulama için paylaşılan kod projesi de bazı önemli dosyalardan oluşur:

Dosya Amaç
Sabitler. cs ConstantsWeb hizmetiyle iletişim kurmak için uygulama tarafından kullanılan sabitleri belirten sınıfı. Bu sabitler, bir sağlayıcıda oluşturulan kişisel arka uç hizmetinize erişmek için güncelleştirmenin güncelleştirilmesini gerektirir.
Ixttospeech. cs ITextToSpeechSpeak Yöntemin uygulama sınıfları tarafından sağlanması gerektiğini belirten arabirim.
Todo. cs AppHer bir platformda uygulama tarafından görüntülenecek ilk sayfayı ve TodoItemManager Web hizmeti işlemlerini çağırmak için kullanılan sınıfı örneği oluşturma işleminden sorumlu sınıf.

Sayfaları görüntüle

Örnek uygulamaların çoğunluğu en az iki sayfa içerir:

  • TodoListPage – bu sayfada bir örnek listesi ve özelliği varsa bir değer simgesi görüntülenir TodoItem.Donetrue . Bir öğeye tıklanması öğesine gider TodoItemPage . Ayrıca, simgeye tıklanarak yeni öğeler oluşturulabilir + .
  • TodoItemPage – bu sayfada seçili olan ayrıntılar görüntülenir ve düzenleme, kaydetme, silme ve söylenebilir.

Ayrıca, bazı örnek uygulamalar, Kullanıcı kimlik doğrulama işlemini yönetmek için kullanılan ek sayfalar içerir.

Verileri modelleme

Her örnek uygulama, TodoItem görüntülenen ve depolama için Web hizmetine gönderilen verileri modellemek için sınıfını kullanır. Aşağıdaki kod örneği, sınıfını göstermektedir TodoItem :

public class TodoItem
{
    public string ID { get; set; }
    public string Name { get; set; }
    public string Notes { get; set; }
    public bool Done { get; set; }
}

IDÖzelliği, her örneği benzersiz bir şekilde tanımlamak için kullanılır TodoItem ve her bir Web hizmeti tarafından güncelleştirileceği veya silinecek verileri belirlemek için kullanılır.

Web hizmeti işlemlerini çağırma

Web hizmeti işlemlerine TodoItemManager sınıfından erişilir ve sınıfın bir örneğine özelliği aracılığıyla erişilebilir App.TodoManager . TodoItemManagerSınıfı, Web hizmeti işlemlerini çağırmak için aşağıdaki yöntemleri sağlar:

  • Gettasksasync – bu yöntem , üzerindeki denetimini TodoListPageTodoItem Web hizmetinden alınan örneklerle doldurmak için kullanılır.
  • Savetaskasync – bu yöntem Web hizmetinde bir örnek oluşturmak veya güncelleştirmek için kullanılır .
  • Deletetaskasync – bu yöntem Web hizmetindeki bir örneği silmek için kullanılır .

Ayrıca, bazı örnek uygulamalar TodoItemManager sınıfında kullanıcı kimlik doğrulama işlemini yönetmek için kullanılan ek yöntemler içerir.

Web hizmeti işlemlerini doğrudan çağırmak yerine, TodoItemManager Yöntemler oluşturucuya eklenen bir bağımlı sınıfta yöntemleri çağırır TodoItemManager . Örneğin, bir örnek uygulama, veritabanına RestServiceTodoItemManager erışmek Için REST API 'leri kullanan uygulamayı sağlamak üzere sınıfını oluşturucuya çıkartır.