Arcgis server task消息的流程和自定义Task

一、首先先要了解task消息的传递流程（如图）

 1、当客户端触发执行Task事件之后，就会执行executeTask（）方法，该方法就会调用另       个一个StartJob（）方法，并给它分配各jobid，用于追踪这个异步请求。

 2、StartJob（）方法就会提供一系列的参数给微软的WebForm_DoCallBack()方法，最后经 过WebForm_DoCallBack()进行异步请求，通过参数_callBackArg传入微软异步请求的回调

   主体RaiseCallbackEvent中。这样参数就传到的服务端的回调方法中了。

3、服务端的回调方法在处理过程中，会调用GetCallbackReasult（）方法，该方法会根据传 入的不同参数，做出不同的处理(例如传入参数为“EventArg=shown”进会执行显示界面)

4、如果传入GetCallbackReasult（）的参数为（EventArg=startTaskActivityIndicator）就会执行ExecuteTask（）方法，该方法是Task的主体方法，处理主要的业务逻辑。该法处理的结果为Results，该方法执行完之后会调用DisplayReasults（）方法，通过processCallbackReasutl（）将结果返回

 

 

二、自定义Task

自定义Task的类必须要继承FloatingPanelTask类，比重写父类的CreateChildControls（），ExecuteTask（），GetCallbackReasut（）方法。

1、CreateChildControls（）方法，是在Task实例化的时候执行，该方法主要是定义Task的 界面的，可以自定义些控件，通过Controls.Add（）方法将控件加入到Task中，这些控件

  中必须有个能触发executeTask的事件（比如Button的onclick事件可以为：

  string.Format("executeTask({0},\"{1}\");", getAgrString, this.CallbackFunctionString)     其中getAgrString为传入的参数）

2、GetCallbackReasut（）方法，是在客户端触发executeTask（）方法之后执行，可以通过this.CallbackEventArgument得到客户端传过来的参数，并将其中有关逻辑处理的参数放入 this.input中。

3.ExecuteTask（）方法，是Task的核心，在执行完GetCallbackReasut（）方法之后执行，可以从this.input中得到参数处理结果保存在this.Reasults中。

 

三、自定义Task的例子，

（得到当前服务器的实际，和在Task文本框注入的字符串）

右击解决方案à添加à新建项目à类库（名称改为myTask）

 

usingSystem;

usingSystem.Collections.Generic;

usingSystem.Linq;

usingSystem.Text;

usingSystem.Web.UI.WebControls;

usingSystem.Collections.Specialized;

using ESRI.ArcGIS.ADF.Web.UI.WebControls;

usingSystem.Web.UI.HtmlControls;

 

namespacemyTask

{

    public class myTask:ESRI .ArcGIS .ADF .Web.UI .WebControls .FloatingPanelTask

    {

        private TextBox txt = null;

        private HtmlInputButton btn = null;

        protected override voidCreateChildControls()

        {

            Controls.Clear();

            base.CreateChildControls();

            txt = new TextBox();

            txt.ID = "txt1";

            btn = new HtmlInputButton();

            btn.ID = "btn1";

            btn.Value = "确定";

            Controls.Add(txt);//把textbox添加到Task中

            Controls.Add(btn);//把Buttont添加到Task中

            string getAgrString =string.Format("'txtboxvalue=' + document.getElementById('{0}').value",txt.ClientID);//把TextBox的值作为参数

            string onClickcc =string.Format("executeTask({0},\"{1}\");", getAgrString,this.CallbackFunctionString);//定义executeTask，并给它传入参数

           btn.Attributes.Add("onclick", onClickcc);//给Button注册方法，该方法能执行executeTask方法

        }

 

 

        /// <summary>

        /// 得到参数，并根据不同的参数，执行不同的处理

        /// </summary>

        /// <returns></returns>

        public override stringGetCallbackResult()

        {

            NameValueCollection namecolltion =   CallbackUtility.ParseStringIntoNameValueCollection(this.CallbackEventArgument);

            this.input =namecolltion["txtboxvalue"];//得到TextBox的值

            return base.GetCallbackResult();

        }

 

        public override void ExecuteTask()

        {

            this.Results = null;

            string txtvalue =this.input.ToString();

            string heading =string.Format("The time on the server is {0}",DateTime.Now.ToShortDateString());

            string detail =string.Format("The value in the Textbox is:{0}", txtvalue);

            SimpleTaskResult str = newSimpleTaskResult(heading, detail);

            this.Results = str;//把处理结果存入Reasus中

        }

 

        public overrideList<ESRI.ArcGIS.ADF.Web.UI.WebControls.GISResourceItemDependency> GetGISResourceItemDependencies()

        {

           List<ESRI.ArcGIS.ADF.Web.UI.WebControls.GISResourceItemDependency>list = newList<ESRI.ArcGIS.ADF.Web.UI.WebControls.GISResourceItemDependency>();

            return list;

        }

    }

}

 

按F6编译，ToolBox就会多出一个myTask的控件。