C#
CFC 支持 .NET Core 2.2 运行环境,支持的函数语言为 C# 和 Powershell,本文主要介绍如何使用 C# 函数。
函数入口
当创建一个基于 C# 的函数时,您需要从 Nuget 引用 BaiduBce.CFC.Core ,该 SDK 中定义了一个接口,定义如下:
1namespace BaiduBce.CFC.Core {
2 public interface StreamHandler {
3 void Handler(Stream input, Stream output, InvokeContext context);
4 }
5}
您需要创建一个入口类并实现这个接口,在 Handler 函数中处理您的逻辑。Handler 函数有三个参数:input 表示输入数据,output 表示输出数据,context 表示函数运行时信息。
函数代码示例
以下是一个较简单的示例,共包含三个文件。
StreamHandler.cs
创建 BaiduBce.CFC.Demo 类,实现 StreamHandler 接口,打印出 input 和 context 中的部分内容。您可以将日志输出到 stdout 和 stderr,函数计算服务会自动收集这些日志。
1using System;
2using System.IO;
3using Newtonsoft.Json;
4using BaiduBce.CFC.Core;
5
6namespace BaiduBce.CFC.Demo
7{
8 public class StreamHandlerDemo : StreamHandler
9 {
10 public void Handler(Stream input, Stream output, InvokeContext context)
11 {
12 StreamReader reader = new StreamReader(input);
13 InvokeEvent invoke = JsonConvert.DeserializeObject<InvokeEvent>(reader.ReadToEnd());
14 StreamWriter writer = new StreamWriter(output);
15 writer.AutoFlush = true;
16
17 if (invoke.Event != null)
18 {
19 Console.Out.Write(invoke.Event);
20 }
21
22 Console.Out.WriteLine("RequestID = {0}", context.RequestID);
23 Console.Out.WriteLine("FunctionBrn = {0}", context.FunctionBrn);
24 StsCredential credential = context.Credential;
25 if (credential != null)
26 {
27 Console.Out.WriteLine("AccessKeyID = {0}", credential.AccessKeyID);
28 Console.Out.WriteLine("SecretAccessKey = {0}", credential.SecretAccessKey);
29 Console.Out.WriteLine("SessionToken = {0}", credential.SessionToken);
30 }
31
32 writer.WriteLine("Hello world!");
33 }
34 }
35}
InvokeEvent.cs
该文件定义了一个可以被 JSON 序列化和反序列化的对象,用于反序列化 Handler 函数的 input。您需要根据函数接收的输入 JSON 结构来定义此对象。
1using Newtonsoft.Json;
2namespace BaiduBce.CFC.Demo {
3 public class InvokeEvent {
4 [JsonProperty(PropertyName = "event")]
5 public string Event { get; set; }
6 }
7}
Program.cs
该文件定义了程序的入口,您无需修改此文件。
1using BaiduBce.CFC.Core;
2namespace BaiduBce.CFC.Demo {
3 class MainClass {
4 public static void Main(string[] args) {
5 CfcClient.main();
6 }
7 }
8}
函数打包及上传
函数打包
在您的项目根目录下执行 publish 命令,dotnet 会编译程序并输出结果:
1$ dotnet publish -c Release
打包输出结果:
1$ cd bin/Release/netcoreapp2.2/publish/
2$ zip -r csharp-demo.zip *
然后,您就可以在 CFC 的函数代码页,点击"上传函数.ZIP包",将 csharp-demo.zip 上传。
Handler 命名
在创建函数时,您需要制定一个 handler 方法的字符串,用来告诉函数计算如何调用您的函数。该字符串格式如下:AssemblyFileName::FullClassName,其中 AssemblyFileName 是函数所在的 Assembly 的文件名(省去.dll),FullClassName 是该函数所在类的全名,Namepsace.ClassName。
在上述简单示例中,如果 Assembly 文件名为 csharp_demo,则 handler 字符串为 csharp_demo::BaiduBce.CFC.Demo.StreamHandlerDemo。
至此,您的 csharp 函数就已配置完,点击"测试"即可运行函数。