Posts tagged .net framework

Giriş

.NET Remoting uygulamaları üzerinde bulunan, yani Marshal-by-reference tipindeki, remote object’ler Remoting server üzerinde belirli bir süre boyunca tutulurlar ve bu süre sponsorlar ve lease manager tarafından belirlenir. Sponsorlar System.Runtime.Remoting.Lifetime.ISponsor interface’ini implement eden remotable type’lardır. Lease manager ise System.Runtime.Remoting.Lifetime.ILease interface’ini implement eden ve tek görevi remote object’in ne kadar süre memory üzerinde tutulacağı ile ilgili işlemlerin yönetimi olan object’leri ve sponsorları yönetmek ile görevlidir.

.NET Remoting uygulamalarında bu sistemin bulunmasının sebebi Remoting server’ın, kendisine connected durumda olan Remoting client’ları ile iletişim halince olmadan hangi remote object’i ne zaman garbage collection ile memory’de sileceğini bilemeyecek olmasıdır.

Marshal-by-value tipindeki remote object’ler ise instance’ları oluşturulup, tüm object client’a gönderildikten sonra ilk garbage collection’da memory’den silinecek şekilde mark’lanırlar.

Remoting Objesinin Oluşturulması

System.MarshalByRefObject class’ını inherit eden remotable type’lar InitializeLifetimeService method’unu override ederek memory’de ne kadar süre kalacaklarını belirlerler. InitializeLifetimeService method’u System.Runtime.Remoting.Lifetime.ILease tipinde bir object return eder ve bu object’in CurrentState property’si LeaseState.Initial değilse, üzerinde bulunan diğer özelliklerin set edilmesi başarılı olmayacaktır. InitializeLifetimeService method’u remote object üzerindeki method’lardan birisinin ilk kez call edilmesi durumunda otomatik olarak call edilmektedir.

InitializeLifetimeService method’unun kullanımı

using System;
using System.Runtime.Remoting.Lifetime;
namespace Module3.Chapter5.InitializeLifetime
{
    public class MyRemotableType : MarshalByRefObject
    {
        public MyRemotableType() { }

        public override object InitializeLifetimeService()
        {
            ILease lease = (ILease)base.InitializeLifetimeService();

            if (lease.CurrentState == LeaseState.Initial)
            {
                lease.InitialLeaseTime = TimeSpan.FromMinutes(10);
                lease.RenewOnCallTime = TimeSpan.FromMinutes(5);
                lease.SponsorshipTimeout = TimeSpan.FromMinutes(2);
            }

            return lease;
        }
    }
}

ILease interface’ine ait özellikler aşağıdaki tabloda listelenmiştir.

ILease interface’ine ait method’lar aşağıdaki tabloda listelenmiştir.

ILease interface’ine ait InitialLeaseTime, RenewOnCallTime ve SponsorshipTimeout property’leri Remoting configuration file’ı içerisinde de belirtilebilir. Bu yönetimin kullanılması durumunda yalnızca Client Activated Object tipindeki object’lerin life time’ları tanımlanabilir. <lifetime> node’unun tüm attribute’leri opsiyoneldir ve aldıkları değerin yanında, default S olmak üzere, D (day), H (hour), M (minute), S (second) ve ya MS (millisecond) değerlerinden biri eklenerek değer verilirler.

<lifetime> node’unun kullanımı

<configuration>
    <system.runtime.remoting>
        <application>
            <lifetime
                leaseTime="10M"
                renewOnCallTime="5M"
                sponsorshipTimeOut="2M"
                leaseManagerPollTime="30S"
            />
        </application>
    </system.runtime.remoting>
</configuration>

<lifetime> interface’ine ait özellikler aşağıdaki tabloda listelenmiştir.

Life time yönetimi için bir diğer opsiyon ise System.Runtime.Remoting.Lifetime.LifetimeServices class’ı içerisinde bulunan static property’lerin uygulama başladığında set edilmesidir. LifetimeServices class’ı <lifetime> node’u ile aynı özelliklere sahiptir. Life time property’lerinin bu şekilde belirlenmesi property’lerin set edildiği AppDomain içerisindeki tüm remote object’lerin life time property’lerini bu şekilde set edecektir.

System.Runtime.Remoting.Lifetime.LifetimeServices class’ı kullanımı

LifetimeServices.LeaseTime = TimeSpan.FromMinutes(10);
LifetimeServices.RenewOnCallTime = TimeSpan.FromMinutes(5);
LifetimeServices.SponsorshipTimeout = TimeSpan.FromMinutes(2);
LifetimeServices.LeaseManagerPollTime = TimeSpan.FromSeconds(30);

Remoting Objesinin Yenilenmesi

Remoting server’ları remote object’lerin memory’den ne zaman silineceğini tek başlarına bilemeyeceklerinden remote object’leri silmeden önce sponsor’lara, sırasıyla, remote object’in lease time’ını uzatmak isteyip istemediklerini sorarlar. Remoting server’ı bir sponsordan ILease interface’inin üzerinde bulunan SponsorshipTimeout süresi boyunca cevap alamazsa bu sponsoru otomatik olarak unregister eder ve eğer varsa diğer register edilmiş sponsorlar için de aynı kuralı takip eder.

Register edildiği lease üzerinden her request gelişinde remote object’in lease time’ını 30 saniye daha uzatacak olan bir sponsor şu şekilde yazılır.

MyRemotableType.cs

public class MyRemotableType : MarshalByRefObject
{
    public MyRemotableType() { }
}

MyRemotableTypeSponsor.cs

public class MyRemotableTypeSponsor : MarshalByRefObject, ISponsor
{
    public MyRemotableTypeSponsor() { }

    #region ISponsor Members
    public TimeSpan Renewal(ILease lease)
    {
        return TimeSpan.FromSeconds(30);
    }
    #endregion

}

Sponsor’un kullanımı

MyRemotableType remoteObject = (MyRemotableType)Activator.GetObject (typeof(MyRemotableType), "tcp://localhost:1234/MyRemotableType.rem");

ILease lease = (ILease) System.Runtime.Remoting.RemotingServices.GetLifetimeService(remoteObject);

MyRemotableTypeSponsor sponsor = (MyRemotableTypeSponsor)Activator.GetObject (typeof(MyRemotableTypeSponsor), "tcp://localhost:1234/MyRemotableTypeSponsor.rem");

lease.Register(sponsor);

Sponsorlara ek olarak, developer istediği durumlarda remote object’in lease time’ını uzatma imkanına sahiptir. Bunun için Remoting client’ın kodu içerisinde RemotingServices.GetLifetimeService method’u kullanılarak ILease object’ine erişilebilir ve ILease class’inin Renew methodu kullanılarak lease time istenilen süre boyunca uzatılabilir.

ILease.Renew method’u kullanımı

MyRemotableType remoteObject = new MyRemotableType();

ILease lease = (ILease)RemotingServices.GetLifetimeService(remoteObject);

lease.Renew(TimeSpan.FromSeconds(30));

Özet

• Life time yönetimi Remoting server’ın, kendi üzerinde bulunan remote object’lerin hala kullanılır olup olmadığını anlaması gerektiği için önemlidir.
• Sponsorlar System.Runtime.Remoting.Lifetime.ISponsor interface’ini implement eden remotable type’lardır.
• Life time initial value’ları configuration dosyası içerisinde <lifetime> node’u kullanılarak yapılabilir.
• Marshal-by-value olarak tanımlanan remotable type’lar instance’ları client’a gönderildikten hemen sonra ilk garbage collection’da memory’den silinecek şekilde flag’lenirler.

.NET içerisinde bulundurduğu hazır class’lar sayesinde uygulamanızın Windows Performans Monitor ile son derece kolay bir şekilde etkileşim kurabilmesini sağlamaktadır.

Performans Monitor, Control Panel içerisinde bulunan “Administrative Tools” klasörü içinde “Performance” isimli shortcut’a tıklayarak ulaşılır ve ilk açıldığında aşağıdaki görüntüye sahiptir.

Performans Monitor üzerinde yeni bir monitör ekranı açmak istendiğinde “New Counter Set” butonuna tıklanır.

Yeni counter set’inde hiçbir counter bulunmaz. Bu boş counter set’ine yeni performance counter’ları eklemek için “Add” butonuna tıklanır.

Açılan ekranda “Performance object” seçeneği ile ne tip bir performance counter ekleneceği seçilir. .NET ile ilgili performance object’leri ekran görüntüsünde de görüldüğü gibi şu şekildedir:

Add Counters ekranında “Explain” butonuna tıklanarak performance counter hakkında detaylı bilgi alınır:

Instance seçim bölümünde uygulama seçilerek “Add” butonuna tıklanır:

Performance counter eklendikten sonra “Add Counters” ekranı başka performance counter’ların ekleneceği düşünülere kapatılmaz. Kapatılmak istendiğinde “Close” butonuna tıklanır. “Close” butonuna tıklandıktan sonra geri dönülen ekranda bulunan performance counter listesinde eklenmiş olan counter bulunur.

Bu işlemleri yaptıktan sonra seçmiş olunan uygulamaya bağlanacak olan Remoting client’ı run edilir ve ekrandaki değerler gözlemlenir.

Uygulama tekrar çalıştırıldığında değerler kaldığı yerden tekrar artacaktır.

.NET Framework’ün System.Diagnostics namespace’i altında bulunan PerformanceCounter class’ı Performance Monitor uygulamasının ekranda grafiksel olarak gösterdiği bilgilere, uygulamanın programmatic olarak erişebilmesini sağlar. Bu sayede yazılımcılar kendilerine özel performance monitor uygulamaları geliştirebilirler ve ihtiyaçlarına özel raporlar oluşturabilirler.

Daha önceden geliştirmiş olduğumuz MyFirstRemotingService project’i içerisinde bulunan MyRemotableType class’ını aşağıdaki şekilde değiştirerek, uygulamanın RequestCount method’u içerisinde PerformanceCounter class’ını kullanarak aldığı bilgiyi döndürmesini sağlayabiliriz.

MyRemotableType.cs

using System;
using MyFirstRemotableType;
using System.Diagnostics;
namespace MyFirstWindowsService
{
    public class MyRemotableType : MarshalByRefObject, IMyRemotableType
    {
        PerformanceCounter perfCounter;

        public MyRemotableType()
        {
            perfCounter = new PerformanceCounter();
            perfCounter.CategoryName = ".NET CLR Remoting";
            perfCounter.CounterName = "Total Remote Calls";
            perfCounter.InstanceName = "MyFirstWindowsService";
            perfCounter.MachineName = Environment.MachineName;
        }

        public DateTime GetServerDateTime()
        {
            return System.DateTime.Now;
        }

        public int RequestCount()
        {
            return Convert.ToInt32(perfCounter.NextValue());
        }
    }
}

PerformansCounter class’ının CategoryName özelliği Performance Monitor uygulamasına counter eklerken seçtiğimiz “Performance object” seçeneğine denk gelmektedir. Bu özelliğe “Add Counters” ekranında görmüş olduğunuz herhangi bir değeri string olarak atayabilirsiniz.

PerformansCounter class’ının CounterName özelliği “Add Counters” ekranındaki “Counter” seçeneğine denk gelmektedir. Bu özelliğe “Add Counters” ekranında, “Counters” bölümünde görmüş olduğunuz herhangi bir değeri string olarak atayabilirsiniz.

PerformansCounter class’ının InstanceName özelliği “Add Counters” ekranındaki “Instance” seçeneğine denk gelmektedir ve instance listesinde bulunan uygulamalardan hangilerinin bu counter ile ölçüleceğini belirlemek için kullanılır. Bu özelliğe “Add Counters” ekranında, “Instances” bölümünde görmüş olduğunuz herhangi bir değeri string olarak atayabilirsiniz.

PerformansCounter class’ının MachineName özelliği Performance Monitor uygulamasına counter eklerken seçtiğimiz “Counter” seçeneğine denk gelmektedir. System namespace’inde bulunan Environment class’ının sahip olduğu static access-modifier’ına sahip MachineName özelliği uygulamanın üzerinde çalıştığı bilgisayarın ismini verdiğinden, sabit değer verilmek istenmemesi durumunda bu özelliğin atanması mümkündür.

PerformansCounter class’ının NextValue method’u counter’ın üzerinde gerekli hesaplamaları yaparak hesaplanan değeri geri döndürür.

Remote object’in instance’ının Remoting server’ı üzerinde oluşturulup Remoting client’a gönderilmesinin ardından Remoting client’ı üzerinde referansı tutulan object Remoting client üzerinde aynen local bir object gibi kullanılabilir. Remoting server’da bulunan ve Remoting client’ında sadece referansı tutulan bu object’lerin herhangi bir method’u call edildiğinde bu işlem tamamiyle Remoting server’ı üzerinde çalışacaktır.

Öncelikle daha önceki makalelerde yazmış olduğumuz Remoting server’ın host ettiği MyRemotableType class’ının özelliklerini hatırlayalım.

Tablo 3.1.2

Remoting Server’ın Development’ı

1. Visual Studio’yu çalıştırın.

2. File > New menüleri altındaki Project seçeneğini seçin.

3. Visual C# > Windows seçeneği altındaki Console Application proje tipini seçin.

4. Name property’sine MyFirstRemotingClient yazın.

5. Location property’sine projeyi oluşturmak istediğiniz klasörün path’ini yazın ve ya Browse seçeneğini kullanarak path’i gösterin.

6. Solution Name property’si otomatik olarak MyFirstRemotingClient şeklinde değişir, eğer değişmemiş ise bu property’ye de MyFirstRemotingClient yazın.

Bu işlemler sonrasında New Project ekranı aşağıdaki şekilde görünür:

NOT

Location property’sinde yazmakta olan “C:\Path\to\Your\Project” path’i seçmiş olduğunuz path’e göre değişiklik gösterektir.

7.     OK butonuna tıklayın.

8.     Karşınıza “Program.cs” isimli bir dosya açık olacak çıkar.

9.     Bu dosyanın ismini Solution Explorer penceresi yardımı ile “MyRemotingClient.cs” olarak değiştirin.

10.  Visual Studio “Program.cs” dosyasının ismini değiştirdikten sonra bu dosya içerisindeki “Program” isimli class’ın ismi otomatik olarak “MyRemotingClient” şeklinde değişir. Değişmemesi durumunda class’ın ismini “MyRemotingClient” olarak değiştirin.

11.  Solution Explorer penceresindeki References klasörüne sağ tıklayarak “Add Reference” seçeneğine tıklayın.

12.  Karşınıza “Add Reference” penceresi çıkar. Bu pencerede “.NET” tab’ındaki “System.Runtime.Remoting” assembly’sini seçin ve OK butonuna tıklayın.

13.  Solution Explorer penceresindeki References klasörüne sağ tıklayarak “Add Reference” seçeneğine tıklayın.

14.  Karşınıza “Add Reference” penceresi çıkar. Bu pencerede “Browse” tab’ını seçerek “MyFirstRemotableType” project’inin bulunduğu klasöre gidin.

15.  Bu klasör içerisinde de sırasıyla “bin” ve “Debug” klasörlerine girerek “MyFirstRemotableType.dll” isimli assembly’yi seçin ve OK butonuna tıklayın.

16.  MyRemotingClient.cs dosyası içerisinde aşağıdaki namespace’leri import edin:

MyRemotingClient.cs dosyasına import edilecek namespace’lerin import edilişleri

using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Tcp;
using MyFirstRemotableType;

17.  MyRemotingClient class’ının access modifier’ını public olarak ayarlayın.

MyRemotingClient class’ının “public” access modifier’ına sahip olarak ayarlanması

public class MyRemotingClient

18.  Remote object’in instance’ını IMyRemotableType type’ındaki object’e atayın ve bu object’in üzerindeki GetServerDateTime method’unu call ederek dönen değeri command prompt’a yazdırın.

Remote Object’in instance’ına erişimlesi

IMyRemotableType remoteObject = (IMyRemotableType)Activator.GetObject (typeof(IMyRemotableType), "tcp://localhost:4444/MyRemotableType.rem");

Console.WriteLine(remoteObject.GetServerDateTime());

19.  Remoting server’ınızı ENTER tuşuna basıldığında programı sonlandıracak şekilde ilgili kodu yazın.

Console Application'un ENTER tuşu ile sonlandırılması
Console.WriteLine("Press ENTER to exit.");
Console.ReadLine();

20.  Build menüsünü kullanarak project’i build edin.

21.  Bu işlem sonrasında Visual Studio’nun sol alt köşesinde “Build succeeded” yazısı belirir.

22.  Visual Studio’yu kapatın.

Remoting Client’ının Çalıştırılması

1.     Start menüsü içerisinde bulunan “Run” kısayoluna tıklayın ve karşınıza çıkan ekrana “cmd” yazarak OK butonuna tıklayın.

2.     Açılan ekranda command prompt’a cd command’ını kullanarak MyFirstRemotingClient project’inizin bulunduğu klasöre, oradan da sırasıyla “bin” ve “Debug” klasörlerine girin.

3.     İlgili klasörlere girdikten sonra command prompt’a “MyFirstRemotingClient.exe” yazarak ENTER tuşuna basın.

4.     Bilgisayarınızda herhangi bir firewall uygulaması yüklü olması durumunda karşınıza “MyFirstRemotingClient” uygulamasının internet ve ya network üzerinden bağlantı sağlamasının block’landığına dair bir mesaj gelebilir.

5.     Bu durumda uygulamanın unblock edilmesi gerekir.

6.     Uygulamanın düzgün çalışması durumunda command prompt’ta Remoting server’ın üzerinde çalıştığı bilgisayarın tarih ve saat bilgileri ile birlikte “Press ENTER to exit.” yazısı belirir.

Özet

• Remote object’ler Remoting server üzerinde create edildikten sonra instance’ları Remoting client’larına gönderilen ve client üzerinde bu object üzerinde bir işlem yapılması durumunda işlem object’in Marshal-by-ref olması durumunda Remoting server’ı üzerinde execute edilecektir.
• Remoting client’ları hem configuration file kullanılarak hem de programmatic olarak configure edilebilmektedir. Fakat remote object’ler Activator class’ının GetObject method’u kullanılarak erişilebilirler.