Montag, 12. April 2010

Silverlight with multiple assemblies: Right place for ServiceReferences.ClientConfig

Wenn man einen Silverlight client so designt, das dieser aus mehreren Assemblies besteht, so muss man auf die richtige Platzierung der ServiceReferences.ClientConfig achten. Es könnte sein, das man nach einem MVC-Pattern folgende Struktur wählt:

  • Client.DataAccess.dll – Kapselung der Datenzugriffe
  • Client.Entities.dll – Data Model
  • Client.View.dll – Views
  • Client.ViewModel.dll – Model der Views

Das Projekt Client.View ist in meinem konkreten Fall das Silverlight Projekt und die anderen jeweils eine Silverlight Class Library. Möchte man nun über Visual Studio eine Service Reference in Client.DataAccess hinzufügen, so wird die ServiceReferences.ClientConfig in dem Class Library-Projekt Client.DataAccess eingefügt. Benötigt wird aber die ServiceReferences.ClientConfig in dem Silverlight-Projekt Client.View !!!

Kontrollieren kann man die Verwendung der richtigen ServiceRefrerences.ClientConfig übrigens dadurch, das man die XAP-Datei mit z.B. 7-Zip anschaut (XAP ist ja einfach eine Zip-Datei). 

Sonntag, 11. April 2010

New features for Silverlight 4 RC

Einen schönen Beitrag hierzu habe ich bei Tim Heuer (Program Manager Microsoft Silverlight) gefunden: A guide to what has changed in the Silverlight 4 RC

Endpoint configurations (WCF) for Silverlight applications

Wer kennt nicht die Pein von der Ablage von Konfigurationsinformationen für unterschiedliche Zielumgebungen? Der Entwickler neigt meistens dazu, in den Konfigurationsdateien die unterschiedlichen Definitionen rein zu schreiben und immer nur diejenige nicht zu kommentieren, welcher er gerade nicht benötigt. Wenn man aber ein großes Projekt hat, kann diese Kommentierung-/Auskommentierungs-Fronarbeit aber ganz schön lästig sein. Was wäre es nicht schön, wenn wir beim Buildvorgang einfach unsere Zielumgebung auswählen könnten und schon haben wir die richtig konfigurierte Version. Als Ansatz für diese Lösung können wir – zumindest bis Microsoft hier eine Lösung in Visual Studio liefert – die bedingte Kompilierung verwenden.

Wi gehen dazu zunächst in den Buildmanager und legen uns für jede Umgebung (außer Development, den hier haben wir ja schon Debug) einen neue Konfiguration an. In meinem Fall sind das STAGING und PRODUCTION. In der Eigenschaft Conditional compilation symbols der Build-Konfiguration sollte dann z.B. SILVERLIGHT;STAGING usw. stehen.

Ab Silverlight 4 haben wir bei der Konfiguration von WCF-Services übrigens eine schöne Erweiterung: RelativeBinding. Hier kann die Endpoint-URI des Services in der ServiceReferences.ClientConfig relativ zur Silverlight-Ursprungs-Domäne angegeben werden.

(1) ServiceReferences.ClientConfig des Silverlight-Clients

In der ServiceReferences.ClientConfig definiert man für jede Umgebung einen Endpoint mit dem entsprechenden Binding.

<configuration>
    <system.serviceModel>
        <bindings>
            <customBinding>
                <binding name="DevelopmentServiceBinding">
                    <binaryMessageEncoding />
                    <httpTransport maxReceivedMessageSize="2147483647" maxBufferSize="2147483647" />
                </binding>
                <binding name="StagingServiceBinding">
                    <binaryMessageEncoding />
                    <httpTransport maxReceivedMessageSize="2147483647" maxBufferSize="2147483647" />
                </binding>
                <binding name="ProductionServiceBinding">
                    <binaryMessageEncoding />
                    <httpTransport maxReceivedMessageSize="2147483647" maxBufferSize="2147483647" />
                </binding>
                <binding name="RelativeBinding">
                    <binaryMessageEncoding />
                    <httpTransport maxReceivedMessageSize="2147483647" maxBufferSize="2147483647" />
                </binding>
            </customBinding>
        </bindings>
        <client>
            <endpoint address="http://localhost:40473/HelloWorldService.svc"
                binding="customBinding" bindingConfiguration="DevelopmentServiceBinding"
                contract="HelloServices.HelloWorldService" name="DevelopmentServiceBinding" />
            <endpoint address="http://localhost:40848/HelloWorldService.svc"
                binding="customBinding" bindingConfiguration="StagingServiceBinding"
                contract="HelloServices.HelloWorldService" name="StagingServiceBinding" />
            <endpoint address="http://localhost:40849/HelloWorldService.svc"
                binding="customBinding" bindingConfiguration="ProductionServiceBinding"
                contract="HelloServices.HelloWorldService" name="ProductionServiceBinding" />
          <!-- New at Silverlight 4 !!! -->
          <endpoint address="../HelloWorldService.svc"
               binding="customBinding" bindingConfiguration="RelativeBinding"
               contract="HelloServices.HelloWorldService" name="RelativeBinding" />
        </client>
    </system.serviceModel>
</configuration>

Die URIs der unterschiedlichen Endpoints zeigen hier zum Ausprobieren auf die lokalen Services und müssen letztendlich mit den richtigen Adressen der Staging- und Production-Services versorgt werden.

(2) Durch bedingte Kompilierung Endpoint setzen

Mittels der bedingten Kompilierung kann man dann den Endpoint entsprechend der ausgewählten Build-Konfiguration auswählen.

   1: void MainPage_Loaded(object sender, RoutedEventArgs e)
   2: {
   3:     _endpointName = "DevelopmentServiceBinding";
   4:     // oder für SL 4
   5:     _endpointName = "RelativeBinding";
   6:  
   7:     #if PRODUCTION
   8:         _endpointName = "ProductionServiceBinding";
   9:     #endif
  10:  
  11:     #if STAGING
  12:         _endpointName = "StagingServiceBinding";
  13:     #endif
Schlussbetrachtung

Wenn man diese Variante verwendet, muss man sich vergegenwärtigen, dass die ServiceReferenences.clientconfig als Resource kompiliert wird und so natürlich die Dev/Staging-URIs für jeden ersichtlich sind (zu mindestens diejenigen, die ein Tool wie Silverlight Spy oder Reflector ihr eigen nennen).

Die ergänzende Variante wäre, die Endpoints im Coding hart zu codieren, aber auch hier kann natürlich jeden den Silverlight-Client dekompilieren. Also eine echte Sicherheit zum Verbergen der Konfigurationsinformationen, gibt es erst, wenn Microsoft mal den Punkt “Config-Informationen in Abhägigkeit von der Umgebung” von der Wishlist von Visual Studio umsetzt.

[Quelle: Beitrag von Method ~ of ~ failed by Tim Heuer]

Samstag, 10. April 2010

Facts of the week

Da ich mich zur Zeit intensiv mit den Themen Cloud Computing mit Windows Azure und Silverlight Business Applications beschäftige, möchte an dieser Stelle mit einem “facts of the week” (wenn möglich wöchentlich) einige Erkenntnisse bzw. Wissenwertes bloggen. Kann sein, das die Informationen nicht immer ganz strukturiert sind, aber ich werde immer versuchen, das entsprechende Themengebiet kurz zu umreißen.

Also let’s start:

Kein Browser-Fenster starten, beim Debuggen einer Windows Azure-Anwendung in der DevFabric.
Configuration der Rolle->Startup action Launch Browser for Http Endpoint nicht ankreuzen

Windows Azure: Lokaler Speicher einer Instanz (nicht der Storage von Windows Azure)

· The local storage is not shared between instances

Tracen von Windows Azure Anwendungen

Windows Azure nutzt den Storage zur Ablage von allen möglichen Logs (IIS, Windows,…siehe unten….) und den Trace.WriteLine Informationen. Hierzu ist notwendig:

Web.Config (alle gewünschten Listener hinzufügen)

<system.diagnostics> 
<trace autoflush="false" indentsize="4"> 
<listeners> 
<add name="AzureDiagnostics" 
type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener, Microsoft.WindowsAzure.Diagnostics, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" /> 
</listeners> 
</trace> 
</system.diagnostics>

Trace.WriteLine("Hier ist ein KRITISCHER Log-Eintrag", "Critical");
Trace.WriteLine("Hier ist eine INFORMATION für das Log", "Information");

Beim Zugriff auf den Azure Storage, von wo aus die Logs dann auf dem üblichen Weg (Storage API oder Webservices) ausgelesen werden können, können die Logs nach Datentyp, Level und Zeitraum gefiltert werden. Die folgende Tabelle gibt einen Überblick über die möglichen Informationsquellen für die Anwendungsüberwachung und Analyse.

Datenquelle

Standardkonfiguration

Konfiguration

Format

Trace Logs

aktiviert, lokal gespeichert

Diagnostics API, Trace Listener

Table

Performance Counters

deaktiviert

Diagnostics API

Table

Windows Event Logs

deaktiviert

Diagnostics API

Table

Infrastruktur-Logs

aktiviert, lokal gespeichert

Diagnostics API

Table

IIS Logs

aktiviert, lokal gespeichert

Diagnostics API, Web.config

Blob

IIS Failed Request Logs

deaktiviert

Diagnostics API, Web.config

Blob

Application Crash Dumps

deaktiviert

Diagnostics API, Crash API

Blob

Beliebige Logs & Dateien

deaktiviert

Diagnostics API

Blob

       

Die wichtigsten Windows Azure Bibliotheken

  • Microsoft.WindowsAzure
    Über die Klassen dieses Namespaces können die Credentials für Windows Azure Storage Accounts verwaltet werden
  • Microsoft.WindowsAzure.ServiceRuntime
    Klassen in diesem Namespace erlauben die Interaktion mit der Windows Azure-Umgebung aus einer Role heraus
  • Microsoft.WindowsAzure.Diagnostics
    Die Klassen aus diesem Namespace werden für die Sammlung von Logging- und Diagnosemeldungen benötigt
  • Microsoft.WindowsAzure.Diagnostics.Management
    Klassen dieses Namespaces können dazu verwendet werden Logging- und Diagnoseinformationen auszulesen
  • Microsoft.WindowsAzure.StorageClient
    Dieser Namespace umfasst die Klassen für den Zugriff auf den Windows Azure Storage Service. Die betreffenden Klassen waren während der CTP-Phase im Namespace Samples enthalten.
  • Microsoft.WindowsAzure.StorageClient.Protocol
    Klassen aus diesem Namespace stellen Wrapper für den Zugriff auf den Windows Azure Storage via REST-Protokoll zur Verfügung.

Windows Azure Version angeben

Spätestens nach Erscheinen der OS-Version 1.1 (Februar 2010) ist es notwendig, die OS-Version zu konfigurieren, die man in der Staging- bzw. Prod-Umgebung auf dem Windows Azure Space benutzt. Dies geschieht in der Windows Azure Service Configuration Datei. Die Eigenschaft osVersion kann dann folgenden Wert haben:

WA-GUEST-OS-M.m_YYYYMM-nn

Where:

WA-GUEST-OS is a fixed string
M.m refers to the major and minor versions
YYYY refers to the year
MM refers to the month

!Wichtig!:
If this attribute is omitted from the configuration file when you deploy your service, the service is deployed to the default version of the operating system; the default version is undefined.

Cross domain calls for Silverlight client

Ein Silverlight Client lässt standardmäßig nur den Aufruf von Webservices aus der Web-Domäne zu, von der der Silverlight-Client herunter geladen wurde. In manchen Fällen möchte man aber zum Beispiel einen Webservice per WCF (SOAP) aufrufen oder einen POX- bzw. REST-konformen Call per WebClient oder HttpRequest machen. Um dies zu ermöglichen, müssen in der aufgerufenen Domäne im Root die zwei Dateien clientaccesspolicy.xml und ggf. auch crossdomain.xml vorhanden sein.

In meinem konkreten Szenario hatte ich ein Windows Azure-Projekt mit mehreren Web-Roles. Da jede Web-Role (bei mir eine Webservice-Role) eine eigene Adresse hat, ist jeder Aufruf vom Silverlight-Client ein Cross Domain Access. Wenn man nun die unten beschriebene Policy-Datei clientaccesspolicy.xml  in das WebService-Projekt im Root anlegt, erlaubt man Silverlight auch auf diesen WebService außerhalb seiner Download-Domäne zuzugreifen.

Die Policy-Datei crossdomain.xml ist eine Alternative, dessen Format ursprünglich von Adobe Flash kommt. Im Unterschied zur clientaccesspolicy.xml muss man in dieser Datei den Zugriff von jeder beliebigen Domäne auf den Webservice erlauben. Macht man dies nicht, wird der Cross domain call von Silverlight nicht akzeptiert.

In der clientaccesspolicy.xml kann man hingegen, den Zugriff auf den Webservice von bestimmten Domänen einschränken (allow-from->domain). Ist also die Verwendung dieser Policy-Datei zu präferieren.

clientaccesspolicy.xml
<?xml version="1.0" encoding="utf-8"?>
<access-policy>
  <cross-domain-access>
    <policy>
      <allow-from http-request-headers="*">
        <domain uri="*"/>
      </allow-from>
      <grant-to>
        <resource path="/" include-subpaths="true"/>
      </grant-to>
    </policy>
  </cross-domain-access>
</access-policy>
crossdomain.xml
<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy SYSTEM "http://www.macromedia.com/xml/dtds/cross-domain-policy.dtd">
<cross-domain-policy>
  <allow-http-request-headers-from domain="*" headers="*"/>
</cross-domain-policy>

Bei beiden Dateien müssen, damit diese auch in die Silverlight XAP gepackt werden, die Attribute Content und Copy if newer gesetzt werden.

Donnerstag, 8. April 2010

Silverlight Client with WCF Service hosted on cloud (Windows Azure)

Nach einigen Stunden Config-Debugging möchte ich mal meine wesentlichen Informationen für Einstellungsarbeiten und Patch-/Hotfix-Installation geben, wenn man für folgendes Szenario eine Anwendung entwerfen möchte:

“Ein Silverlight-Client in der Cloud (Windows Azure)” nutzt einen ebenfalls in der Cloud gehosteten Webservice (basicHttpBinding)”

Betriebssystem: Windows 7
Webserver: IIS 7.5
Visual Studio: 2008 (SP1)
.NET: 3.5 (SP1)
CloudService: 1.1 (Feb. 2010)

Damit eine Windows-Azure Anwendung läuft, muss man über einen lauffähigen IIS verfügen. Als Entwickler nimmt man hierfür am besten den lokalen IIS auf dem eigenen Rechner. Für meinen IIS habe ich über die Funktion Control Panel->Programs and Features->Turn Windows features on or off folgende Einstellungen vorgenommen:

image  

Wichtig ist die Aktivierung der “Windows Communication Foundation HTTP Activation” unter Microsoft .NET Framework 3.5.1.

Hotfix für WCF mit .NET Framework 3.5 unter Windows 7 oder Windows Server 2008 R2

Diese Hotfix-Sammlung http://support.microsoft.com/kb/981002/en-us muss installiert werden, damit die WCF Services in der obigen Konfiguration unter Windows Azure ohne Fehlermeldung arbeiten.

In der Web.Config seiner WebRole (von dem Windows Azure-Part des Projekts) muss der betroffene Service mit folgendem Behaviour definiert werden:

<behavior name="LoadBalancedBehavior">
         <serviceMetadata httpGetEnabled="true" />
         <serviceDebug includeExceptionDetailInFaults="true"/>
         <useRequestHeadersForMetadataAddress>
           <defaultPorts>
             <add scheme="http" port="81" />
             <add scheme="https" port="444" />
           </defaultPorts>
         </useRequestHeadersForMetadataAddress>
       </behavior>

Info: Windows Azure Web-Dienste oder Webrollen laufen immer ab Port 81 und werden z.B. als http://127.0.0.1:81/Services/Service1.svc adressiert.

Bei der Generierung der Proxy-Klassen für den Silverlight-Client muss man dazu entweder eine zweite Visual Studio-Instanz aufmachen – damit erkennt Visual Studio den laufenden Service unter der Port 81-Adresse (ansonsten bekommt man die Adresse mit localhost:xxxxx des Cassini-Webservers) – oder man macht nach der Generierung der Proxy-Klassen ein Suchen/Ersetzen des http://localhost:xxxx/Services/Service1.svc durch http://127.0.0.1:81/Services/Service1.svc.

Ein weitere Falle, in die man rein treten kann ist, das der MIME-Type im IIS für .xap nicht definiert ist. Hier hilft dann folgendes:

To ensure solutions containing Silverlight clients work correctly in the development fabric, please ensure that the MIME type for the Silverlight .xap extension is configured correctly in IIS.

1. Open Internet Information Services (IIS) Configuration Manager and select the server to manage (usually the top-level item on the left side)

2. Double-click MIME Types on the right side

3. Add an entry to map the .xap extension to the application/x-silverlight-app MIME type

Um den Silverlight-Client debuggen zu können, kann man überprüfen, ob der ensprechende Haken in der Web-Rolle gesetzt ist:

If for some reason (say if you were doing Javascript debugging "you cannot debug Silverlight code and JavaScript code at the same time." or you didn't select "Enable Silverlight debugging when you created the Silverlight project) you disabled the Silverlight debugger, you can re-enable it on the Web tab of the Web Application project settings (lower right corner):

Mehr Informationen zum Thema Debugging von Windows Azure-Applikationen findet man übrigens hier: http://msdn.microsoft.com/en-us/library/cc838267(VS.95).aspx

Samstag, 3. April 2010

Localization in Silverlight 3

Um eine Silverlight 3 Anwendung zu lokalisieren, gibt es einen wichtigen Punkt, den man auch nicht unbedingt auf den Microsoft “How-To-Dos” findet. Man muss nämlich zum Notepad greifen und das csproj-File seines Silverlight-Projekts editieren. In der Sektion SupportedCultures müssen alle unterstützen Cultures der Silverlight Anwendung eingetragen werden. Macht man dies nicht, so werden im XAP durch den Compiler keine Ressourcendateien erzeugt.

Beispiel (nur deutsche und Default-Culture verfügbar):

   1: <SupportedCultures>de
   2:     </SupportedCultures>

Folgende Schritte sind zur Lokalisierung notwendig:

  1. Ressourcen-Dateien hinzufügen
  2. Access-Modifier der Ressourcen-Dateien (im Ressource Editor) auf Public stellen
  3. Eine Zugriffsklasse auf das Ressource-File definieren (Namespace des Ressource-Files im Beispiel AppServices.Ressources und Name des Ressource-File ist CommonRessources).
       1: namespace AppServices
       2: {
       3:     public class LocalizedStrings
       4:     {
       5:         public LocalizedStrings()
       6:         {
       7:         }
       8:         private static AppServices.Resources.CommonRessource commonRessource = new AppServices.Resources.CommonRessource();
       9:         public AppServices.Resources.CommonRessource CommonRessource { get { return commonRessource; } }
      10:     }
      11:  
      12: }
  4. In UserControl.Ressources oder Application.Ressources des Silverlight UserControls oder der Silverlight Seite die angelegte Zugriffsklasse aus (3) referenzieren (Namespace und Name anpassen)

       1: <UserControl.Resources>
       2:         <local:LocalizedStrings xmlns:local ="clr-namespace:AppServices"
       3:                            x:Key="LocalizedStrings" />
  5. Das Silverlight Control an die Ressource binden. Hier muss im Binding Path der Dateiname des Ressource-Files und der Key der Resource verwendet werden! Die Source-Eigenschaft enthält den Key aus (4)

       1: <Button Height="23" Width="73.5" 
       2:        Canvas.Left="24" Canvas.Top="118.5" 
       3:        Content="{Binding Path=CommonRessource.btn_signin, Source={StaticResource LocalizedStrings }}" 
  6. Die neutrale Sprache im Assembly Info File einstellen. Entweder über die Properties->Assembly Information in Visual Studio oder direkt in der AssembleyInfo.cs-Datei.

  7. [assembly: NeutralResourcesLanguageAttribute("en")]