ReturnType HandlerName(InputType input, IFcContext context);  //包含IFcContext。
ReturnType HandlerName(InputType input); // 不包含IFcContext。
Async Task<ReturnType> HandlerName(InputType input, IFcContext context);
Async Task<ReturnType> HandlerName(InputType input);

函數(shù)計(jì)算支持在使用C#編寫的函數(shù)中應(yīng)用Async，此時(shí)函數(shù)的執(zhí)行會(huì)等待異步方法執(zhí)行結(jié)束。以下是對(duì)ReturnType、InputType和IFcContext的說(shuō)明。

• ReturnType：返回對(duì)象可以是void、System.IO.Stream對(duì)象或者任何可以被JSON序列化和反序列化的對(duì)象。如果返回對(duì)象是Stream，該Stream內(nèi)容將直接在響應(yīng)體返回，否則返回對(duì)象被JSON序列化后，在響應(yīng)體返回。
• InputType：輸入?yún)?shù)可以是System.IO.Stream或任何可以被JSON序列化和反序列化的對(duì)象。
• IFcContext：函數(shù)的Context對(duì)象。更多信息，請(qǐng)參見(jiàn)上下文。

  <ItemGroup>
        <PackageReference Include="Aliyun.Serverless.Core" Version="1.0.1" />
  </ItemGroup>

一個(gè)最簡(jiǎn)單的Stream Handler示例如下所示。

using System.IO;
using System.Threading.Tasks;
using Aliyun.Serverless.Core;
using Microsoft.Extensions.Logging;

namespace Example
{
    public class Hello
    {
        public async Task<Stream> StreamHandler(Stream input, IFcContext context)
        {
            IFcLogger logger = context.Logger;
            logger.LogInformation("Handle request: {0}", context.RequestId);
            MemoryStream copy = new MemoryStream();
            await input.CopyToAsync(copy);
            copy.Seek(0, SeekOrigin.Begin);
            return copy;
        }

        static void Main(string[] args){}
    }
}

示例解析如下。

• 命名空間和類

  命名空間為Example，類名為Hello，方法名為StreamHandler，假設(shè)程序集名稱為HelloFcApp，則請(qǐng)求處理程序的配置為HelloFcApp::Example.Hello::StreamHandler。

• 參數(shù)Stream input

  處理程序的輸入，該示例的輸入類型為Stream。

• 參數(shù)IFcContext context（可選）

  上下文對(duì)象，包含函數(shù)和請(qǐng)求的信息。

• 返回值Task<Stream>

  返回值為Stream類型。

一個(gè)最簡(jiǎn)單的POCO Handler示例如下所示。

using Aliyun.Serverless.Core;
using Microsoft.Extensions.Logging;

namespace Example
{
    public class Hello
    {
        public class Product
        {
            public string Id { get; set; }
            public string Description { get; set; }
        }

        // optional serializer class, if it’s not specified, the default serializer (based on JSON.Net) will be used.
        // [FcSerializer(typeof(MySerialization))]
        public Product PocoHandler(Product product, IFcContext context)
        {
            string Id = product.Id;
            string Description = product.Description;
            context.Logger.LogInformation("Id {0}, Description {1}", Id, Description);
            return product;
        }

        static void Main(string[] args){}
    }
}

除了Stream作為輸入輸出參數(shù)，POCO（Plain old CLR objects）對(duì)象同樣也可以作為輸入和輸出。如果該P(yáng)OCO沒(méi)有指定特定的JSON序列化對(duì)象，則函數(shù)計(jì)算默認(rèn)使用JSON.Net進(jìn)行對(duì)象的JSON序列化和反序列化。具體解析如下。

• 命名空間和類

  命名空間為Example，類名為Hello，方法名為PocoHandler，假設(shè)程序集名稱為 HelloFcApp, 則請(qǐng)求處理程序的配置為HelloFcApp::Example.Hello::PocoHandler。

• 參數(shù)Product product

  處理程序的輸入，該示例的輸入類型為Product Class。如果該P(yáng)OCO沒(méi)有指定特定的JSON序列化對(duì)象，則函數(shù)計(jì)算默認(rèn)使用JSON.Net進(jìn)行對(duì)象的JSON反序列化。

• 參數(shù)IFcContext context（可選）

  上下文對(duì)象，包含函數(shù)和請(qǐng)求的信息。

• 返回值Product

  返回值為POCO Product類型。如果該P(yáng)OCO沒(méi)有指定特定的JSON序列化對(duì)象，則函數(shù)計(jì)算默認(rèn)使用JSON.Net進(jìn)行對(duì)象的JSON序列化。

public interface IFcSerializer
{
    T Deserialize<T>(Stream requestStream);
    void Serialize<T>(T response, Stream responseStream);
}      

函數(shù)計(jì)算官方庫(kù)包含使用各種處理程序類型和接口的示例應(yīng)用程序。每個(gè)示例應(yīng)用程序都包含用于輕松編譯部署的方法。

• dotnet3-blank-stream-event：使用Stream格式的事件回調(diào)處理程序。
• dotnet3-blank-poco-event：使用POCO格式的事件回調(diào)處理程序。