DotAmf

Packages NuGet: DOTAMF (sérialiseur) et dotamf.wcf (couche de service).

À propos

Sérialiseur .NET et liaisons WCF pour AMF avec un support à distance complet.

Le format de message d'action (AMF) est un format binaire utilisé pour sérialiser les graphiques d'objets tels que les objets ActionScript et XML, ou envoyer des messages entre un client Adobe Flash et un service distant, généralement un serveur de médias flash ou des alternatives tierces. La langue ActionScript 3 fournit des classes de codage et de décodage à partir du format AMF.

http://en.wikipedia.org/wiki/Action_Message_Format

L'AMF présente plusieurs avantages par rapport aux formats de sérialisation existants, y compris la capacité de maintenir le graphique des objets, une petite empreinte lors du stockage d'un ensemble d'objets identiques (y compris des chaînes) ou des références au même objet, et un large éventail de types natifs (tels que XmlDocument , DateTime et Dictionary ).

Configuration WCF

Considérez les contrats de service suivants:

    using System;
    using System.Runtime.Serialization;
    using System.ServiceModel;
    using System.Xml;

    namespace ExampleService
    {
        [ServiceContract]
        public interface IMyService
        {
            [OperationContract]
            ProductVo[] GetAllProducts();

            [OperationContract(Name = "GetUser")] //Custom procedure name
            User GetUserDataContract(int id);

            [OperationContract]
            int AddUser(User user);

            [OperationContract]
            Content SendContent(Content content);

            [OperationContract]
            User[] SendGraph(User[] users);

            [OperationContract]
            void DoStuff();

            [OperationContract]
            [FaultContract(typeof(CustomFault))]
            void DoFault();
        }

        [DataContract] //Will have the "ExampleService.User" alias
        public class User
        {
            [DataMember(Name = "id")] //Custom field name
            public int Id { get; set; }

            [DataMember(Name = "is_active")]
            public bool IsActive { get; set; }

            [DataMember] //Use explicit name
            public string name { get; set; }

            [DataMember(Name = "products")]
            public ProductVo[] Products { get; set; }
        }

        [DataContract(Name = "Product")] //Custom alias
        public class ProductVo
        {
            [DataMember(Name = "id")]
            public int Id { get; set; }
        }

        [DataContract]
        public class CustomFault
        {
            [DataMember(Name = "date")]
            public DateTime Date { get; set; }

            [DataMember(Name = "message")]
            public string Message { get; set; }
        }

        [DataContract]
        public class Content
        {
            [DataMember(Name = "data")]
            public byte[] Data { get; set; }

            [DataMember(Name = "xml")]
            public XmlDocument Xml { get; set; }
        }
    }

Pour ajouter un support AMF à un service, vous n'avez qu'à mettre à jour votre configuration:

 <?xml version="1.0"?>
<configuration>
  <system.web>
    <compilation debug="true" targetFramework="4.0" />
  </system.web>
  <system.serviceModel>
    <extensions>
      <behaviorExtensions>
        <add name="amfBehaviorExtension" type="DotAmf.ServiceModel.Configuration.AmfBehaviorExtensionElement, DotAmf.Wcf"/>
      </behaviorExtensions>
      <bindingElementExtensions>
        <add name="amfBindingExtension" type="DotAmf.ServiceModel.Configuration.AmfBindingExtensionElement, DotAmf.Wcf"/>
      </bindingElementExtensions>
    </extensions>
    <behaviors>
      <endpointBehaviors>
        <behavior name="amfEndpoint">
          <amfBehaviorExtension/>
        </behavior>
      </endpointBehaviors>
      <serviceBehaviors>
        <behavior name="amfServiceBehavior">
          <serviceMetadata httpGetEnabled="false"/>
          <serviceDebug includeExceptionDetailInFaults="true" httpHelpPageEnabled="false"/>
        </behavior>
      </serviceBehaviors>
    </behaviors>
    <bindings>
      <customBinding>
        <binding name="amfBinding">
          <amfBindingExtension/>
          <httpTransport/>
        </binding>
      </customBinding>
    </bindings>
    <services>
      <service name="ExampleService.MyService" behaviorConfiguration="amfServiceBehavior">
        <endpoint address="" contract="ExampleService.IMyService" binding="customBinding" bindingConfiguration="amfBinding" behaviorConfiguration="amfEndpoint"/>
      </service>
    </services>
    <serviceHostingEnvironment multipleSiteBindingsEnabled="true"/>
  </system.serviceModel>
 <system.webServer>
    <modules runAllManagedModulesForAllRequests="true"/>
    <directoryBrowse enabled="false"/>
  </system.webServer>
</configuration>

Voir le dossier Examples pour un service complet et des implémentations clients.

Sérialisation

Vous pouvez utiliser DataContractAmfSerializer pour sérialiser et désérialiser à partir de données AMF binaires en dehors du WCF.

 CustomType objectToWrite;

var knownTypes = new[] {
    typeof(KnownType1),
    typeof(KnownType2)
};
var serializer = new DataContractAmfSerializer(typeof(CustomType), knownTypes);

using (var stream = new MemoryStream())
    serializer.WriteObject(stream, objectToWrite);