手记

在javascript中使用wcf服务

狐的传说
2018-04-20 14:43:37浏览 2241

开发平台：

1、Visual Studio 2008 SP1

2、.NET Framework 3.5 SP1

3、ASP.NET AJAX

4、IIS 7 或者 VS Integrated Web Server [WCF 和 SVS文件的配置]

5、Windows Vista

 

 

 介绍：

 

      WCF为微软的应用程序开发平台提供了大量的新增的功能。特别是在各个应用程序之间的交互。在这篇文章中,我们将看到能够在客户端的Javacript直接使用WCF服务。这个是ASP.NET AJAX提供的非常酷的功能。在这篇文章中,我们不会涵盖WCF内部的原理，我们仅仅关注如何在JavaScript中直接使用wcf服务。因此,没有asp.net或者.net运行时如何管理这些功能的幕后的东西。

    为了演示这些观点和功能，我将创建一个带有两个工程的解决方案的例子。因此,为了不浪费时间,创建一个空解决方案然后保存。现在，在这个解决方案中添加一个类库工程。改名为ServiceLibrary。然后，向这个解决方案中再添加一个Web Application工程，改名为WEBUI 。我们将看到两种途径来添加让Javascript使用的WCF服务。

 

   1、 使用Ajax-Enable WCF Service 项目模板

   2、 将使用的服务接口定义在一个类库项目中

使用Ajax-Enable WCF Service 项目模板

 

      这里,我们将看见一个非常直截了当的方式来实现在JavaScript中使用WCF服务。右击添加好的Web Application工程，选择添加一个新项。选择AJAX-Enabled WCF Service 项目模板,将其命名为“HelloWorldService.svc” ，点击OK。和预期一样向导添加一个HelloWorldService.svc 文件到解决方案中。这个文件是个代码隐藏文件。如果你以XML文本编辑器打开HelloWorldService.svc 文件，你将会看到下面这些标签。

<%@ ServiceHost Language="C#" Debug="true" 
  Service="WebUI.HelloWorldService" CodeBehind="HelloWorldService.svc.cs" %>

 

 

    如果你打开隐藏的代码文件,你将会看到如下的代码：

代码

namespace WebUI
{
    [ServiceContract(Namespace = "")]
    [AspNetCompatibilityRequirements(RequirementsMode = 
        AspNetCompatibilityRequirementsMode.Allowed)]
    public class HelloWorldService
    {
        [OperationContract]
        public void DoWork()
        {
            return;
        }
    }
}

 

Visual Studio 2008 会自动的添加必要的配置到web.config 文件中,所以你不需要在web.config配置任何东西。现在，回到前面添加一个返回字符串 “HelloWorld”的方法，然后为这个方法添加一个[OperationContract] 属性。从 Visual Studio工具箱上拖拽一个Script Manager控件，在ScriptManager 的标签内，添加一个<Services>来引用wcf服务.一个例子给出如下：

 

<asp:ScriptManager ID="ScriptManager1" runat="server">
    <Services>
        <asp:ServiceReference Path="~/HelloWorldService.svc" />
    </Services>
</asp:ScriptManager>

  

现在，添加一个button和一个textbox到页面上，在button的点击事件中，使用JavaScript 函数来调用WCF服务.下面给出了全部的HTML代码

代码

<form id="form1" runat="server">
<div>
    <script language="javascript" type="text/javascript">
        function GetValueFromServer() {
            HelloWorldService.HelloWorld(onSuccess, onFailure);
        }

        function onSuccess(result) {
            document.getElementById('txtValueContainer').value = result;
        }

        function onFailure(result) {
            window.alert(result);
        }
    </script>
    <asp:ScriptManager ID="ScriptManager1" runat="server">
        <Services>
            <asp:ServiceReference Path="~/HelloWorldService.svc" />
        </Services>
    </asp:ScriptManager>
    <input id="btnServiceCaller" type="button" value="Get Value" 
           onclick="GetValueFromServer()"; />
    <input id="txtValueContainer" type="text" value="" />
</div>
</form>

      注意当调用这个服务的时候,我们传递了两个方法：一个是正常的回调，另外一个是错误的回调。如果你要传递的参数给这个函数,这些参数必须在回调函数的前面。例如，如果我们有一个命名为getvalue 的参数他需要两个字符串的参数，我们将这样调用这个函数：[NameSpaceName].[ServiceName].getvalue(“value one”,”value two”,on_success,on_error)；这里on_sucess 和on_error 分别是正常和错误的回调函数。

 

使用的类库项目来定义WCF服务接口

    因此，我们看看如何使用通过一个项目来使用AJAX-enabled WCF 服务。现在，我们将看见一个更传统的WCF服务的实现,我们也将会看见如何公开这个WCF服务给ASP.NET AJAX。  当我们创建的默认类库项目，它是不会被添加WCF必要的的服务模型和运行时序列化的支持,因此，我们不得不添加必要的服务引用。回到前面，右击类库项目。选择添加引用。然后选择下面这些引用：

  • System.Runtime.Serialization

  • System.ServiceModel  

          在这个阶段， 我将使用一个TODO Management 的例子来说明这个观点。 添加一个服务的基础数据库,创建一个TODO 表，它有ID, Description, 和Status 字段。 现在，从项目模板中添加一个LINQ to SQL的类。  从数据库中拖拽TODO表到LINQ to SQL设计类中。 然后，点击属性框中的设计界面，将serialization模式改成Unidirectional.现在 我们设计产生出了准备为wcf使用的LINQ to SQL 类。如果你想要使用客户自定义的类型,你就必须为你的自定义的类型设置[DataContract] 属性，你必须为每个你想曝露给wcf的类的属性添加 [DataMember]属性。

    现在，我们添加一个如下的服务接口：

    代码

    namespace ServiceLibrary
    {
        [ServiceContract(Namespace = "ServiceLibrary")]
        interface IToDoService
        {
            [OperationContract]
            ToDo GetToDo(long ID);
            [OperationContract]
            ToDo AddToDo(ToDo toDo);
            [OperationContract]
            bool DeleteToDo(ToDo todo);
            [OperationContract]
            ToDo UpdateToDo(ToDo todo);
            [OperationContract]
            List<ToDo> GetAllToDo();
        }
    }

         请注意，我们已经提到包含ServiceContract接口属性的命名空间。这是非重要的 。我们将使用这个名字作为在Javascript代码中访问wcf服务的名称。现在，我们将要去实现这个服务接口。代码给出如下所示。请注意，我们使用了 [AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowed)] 属性类；为了公开这个服务给ASP.NET AJAX ，这样做是必须的。

    代码

    namespace ServiceLibrary
    {
        [AspNetCompatibilityRequirements(RequirementsMode = 
            AspNetCompatibilityRequirementsMode.Allowed)]
        public class ToDoService : IToDoService
        {
            #region IToDoService Members
            public ToDo GetToDo(long ID)
            {
                DataClasses1DataContext context = new DataClasses1DataContext();
                var toDos = from p in context.ToDos
                            where p.ID == ID
                            select p;
                List<ToDo> listTodos =  toDos.ToList();
                if (listTodos != null && listTodos.Count > 0)
                {
                    return listTodos[0];
                }
                else
                {
                    return null;
                }
            }
            #endregion
        }
    }

     

    配置一个Web 应用程序来使用TODO服务

     

         现在我们已经定义了所有的必须的东西来运行我们的 TODO 程序，现在是时候公开服务给一个能使用WCF的ASP.NET AJAX 程序的客户端。为此,我们将添加一个 AJAX-enabled WCF服务，一个.svc文件。然后处理掉代码隐藏文件。或者我们添加一个XML或文本文件然后将它命名为ToDoService.svc。用一个XML编辑器打开，添加如下指令：

     

  • <%@ ServiceHost Language="C#" Debug="true" Service="ServiceLibrary.ToDoService" %>

     

    现在，我们将在web.config添加必需的配置信息来运行这个服务。代码如下所示：

     

    代码

    <system.serviceModel>
      <behaviors>
       <endpointBehaviors>
        <behavior name="AspNetAjaxBehavior">
         <enableWebScript />
        </behavior>
        <behavior name="WebUI.HelloWorldServiceAspNetAjaxBehavior">
         <enableWebScript />
        </behavior>
       </endpointBehaviors>
      </behaviors>
      <serviceHostingEnvironment aspNetCompatibilityEnabled="true" />
      <services>
       <service name="ServiceLibrary.ToDoService">
        <endpoint behaviorConfiguration="AspNetAjaxBehavior" binding="webHttpBinding"
         contract="ServiceLibrary.IToDoService" />
       </service>
       <service name="WebUI.HelloWorldService">
        <endpoint address="" behaviorConfiguration="WebUI.HelloWorldServiceAspNetAjaxBehavior"
         binding="webHttpBinding" contract="WebUI.HelloWorldService" />
       </service>
      </services>
    </system.serviceModel>

     

        现在，右击这个文件，然后选择在浏览器中查看，测试一下服务启动和运行是否良好。在进一步叙说之前，有几件事情必须先提，你必须添加添加serviceHostingEnvironment和设置 aspNetCompatibilityEnabled="true"，才能在ASP.NET中使用WCF的一些服务，例如 HTTP Context ，Session 等等

     

    在Javascript中使用WCF服务

         现在，像先前我们使用的HelloWorldService一样使用该服务,为了清楚起见，我们给出例子的代码。也给出了ScriptManager标签代码。请注意,我们已经添加的一个clientServiceHelper.js文件，我们把所有的客户端到服务端交互的Javascript函数放在里面了。

     

    代码

    <asp:ScriptManager ID="ScriptManager1" runat="server">
        <Scripts>
            <asp:ScriptReference Path="~/Script/ClientServiceHeler.js" />
        </Scripts>
        <Services>
            <asp:ServiceReference Path="~/ToDoService.svc" />
        </Services>
    </asp:ScriptManager>

     

    我们使用使用ASP.NET AJAX 客户端orm来实现clientServiceHelper.js

    代码

    Type.registerNamespace("ServiceClients");
        ServiceClients.ToDoClient = function() {
    }

    ServiceClients.ToDoClient.prototype = {

        AddToDo: function(todo, callback, errorCallBack) {
            ServiceLibrary.IToDoService.AddToDo(todo, callback, errorCallBack);
        },

        DeleteToDo: function(todo, callback, errorCallBack) {
            ServiceLibrary.IToDoService.DeleteToDo(todo, callback, errorCallBack);
        },

        UpdateToDo: function(todo, callback, errorCallBack) {
            ServiceLibrary.IToDoService.UpdateToDo(todo, callback, errorCallBack);
        },

        GetAllToDo: function(callback, errorCallBack) {
            ServiceLibrary.IToDoService.GetAllToDo(callback, errorCallBack);
        },

        dispose: function() {
        }
    }

    ServiceClients.ToDoClient.registerClass('ServiceClients.ToDoClient', null, Sys.IDisposable)

    if (typeof (Sys) !== 'undefined') Sys.Application.notifyScriptLoaded();

     

    总结：

    在这篇文章中，我们已经学习了如何使用AJAX-enabled WCF Service 项目模版.然后,我们学习了如何使用定义基于wcf服务的服务接口。我们也学习到了如何配置wcf服务的web.config 。最后，我们学习了在一个ScriptManager中添加服务引用。在文章结束之前，一点必须说明，我们能通过C#代码添加服务引用。下面是一个例子的代码：

     

    ScriptManager manager = ScriptManager.GetCurrent(Page);
    ServiceReference reference = new ServiceReference("ToDoService.svc");
    manager.Services.Add(reference);


相关标签
JavaScript
0人推荐
随时随地看视频
慕课网APP

相关阅读

微信小程序之获取并解密用户数据（获取openid，nickName等）
使用Safe.js进行快速开发搜索引擎页面实践
sliverlight:按点击移动的连续跑马灯
模块化JavaScript组件开发指南
JavaScript简单抽奖程序的实现及代码