Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tentukan penangan fungsi Lambda di C #

Handler fungsi Lambda Anda adalah metode dalam kode fungsi Anda yang memproses peristiwa. Saat fungsi Anda diaktifkan, Lambda menjalankan metode handler. Fungsi Anda berjalan sampai handler mengembalikan respons, keluar, atau waktu habis.

Ketika fungsi Anda dipanggil dan Lambda menjalankan metode handler fungsi Anda, ia meneruskan dua argumen ke fungsi Anda. Argumen pertama adalah event objek. Ketika yang lain Layanan AWS memanggil fungsi Anda, event objek berisi data tentang peristiwa yang menyebabkan fungsi Anda dipanggil. Misalnya, event objek dari API Gateway berisi informasi tentang jalur, HTTP metode, dan HTTP header. Struktur acara yang tepat bervariasi sesuai dengan Layanan AWS pemanggilan fungsi Anda. Lihat Memanggil Lambda dengan acara dari layanan lain AWS untuk informasi selengkapnya tentang format acara untuk layanan individual.

Lambda juga meneruskan context objek ke fungsi Anda. Objek ini berisi informasi tentang pemanggilan, fungsi, dan lingkungan eksekusi. Untuk informasi selengkapnya, lihat Menggunakan objek konteks Lambda untuk mengambil informasi fungsi C #.

Format asli untuk semua peristiwa Lambda adalah aliran byte yang mewakili peristiwa yang diformat. JSON Kecuali parameter input dan output fungsi Anda bertipeSystem.IO.Stream, Anda harus membuat serialisasi. Tentukan serializer yang ingin Anda gunakan dengan mengatur atribut LambdaSerializer assembly. Untuk informasi selengkapnya, lihat Serialisasi dalam fungsi Lambda.

. NETmodel eksekusi untuk Lambda

Ada dua model eksekusi yang berbeda untuk menjalankan fungsi Lambda di. NET: pendekatan perpustakaan kelas dan pendekatan perakitan yang dapat dieksekusi.

Dalam pendekatan pustaka kelas, Anda memberikan Lambda string yang menunjukkanAssemblyName,ClassName, dan Method fungsi yang akan dipanggil. Untuk informasi selengkapnya tentang format string ini, lihatPenangan perpustakaan kelas. Selama fase inisialisasi fungsi, kelas fungsi Anda diinisialisasi, dan kode apa pun dalam konstruktor dijalankan.

Dalam pendekatan perakitan yang dapat dieksekusi, Anda menggunakan fitur pernyataan tingkat atas C # 9. Pendekatan ini menghasilkan perakitan yang dapat dieksekusi yang dijalankan Lambda setiap kali menerima perintah pemanggilan untuk fungsi Anda. Anda hanya memberi Lambda nama rakitan yang dapat dieksekusi untuk dijalankan.

Bagian berikut memberikan contoh kode fungsi untuk dua pendekatan ini.

Penangan perpustakaan kelas

Kode fungsi Lambda berikut menunjukkan contoh metode handler (FunctionHandler) untuk fungsi Lambda yang menggunakan pendekatan pustaka kelas. Dalam contoh funtion ini, Lambda menerima peristiwa API dari Gateway yang memanggil fungsi. Fungsi membaca catatan dari database dan mengembalikan catatan sebagai bagian dari respons API Gateway.

[assembly: LambdaSerializer(typeof(Amazon.Lambda.Serialization.SystemTextJson.DefaultLambdaJsonSerializer))]

namespace GetProductHandler;

public class Function
{
    private readonly IDatabaseRepository _repo;
    
    public Function()
    {
        this._repo = new DatabaseRepository();
    }
    
    public async Task<APIGatewayProxyResponse> FunctionHandler(APIGatewayProxyRequest request)
    {
        var id = request.PathParameters["id"];
        
        var databaseRecord = await this._repo.GetById(id);
        
        return new APIGatewayProxyResponse 
        {
            StatusCode = (int)HttpStatusCode.OK,
            Body = JsonSerializer.Serialize(databaseRecord)
        };
    }
}

Saat Anda membuat fungsi Lambda, Anda perlu memberikan Lambda informasi tentang handler fungsi Anda dalam bentuk string handler. Ini memberi tahu Lambda metode mana dalam kode Anda untuk dijalankan ketika fungsi Anda dipanggil. Dalam C #, format string handler saat menggunakan pendekatan perpustakaan kelas adalah sebagai berikut:

ASSEMBLY::TYPE::METHOD, dimana:

Untuk contoh kode yang ditampilkan, jika perakitan diberi namaGetProductHandler, maka string handler akan menjadiGetProductHandler::GetProductHandler.Function::FunctionHandler.

Penangan perakitan yang dapat dieksekusi

Dalam contoh berikut, fungsi Lambda didefinisikan sebagai perakitan yang dapat dieksekusi. Metode handler dalam kode ini Handler dinamai. Saat menggunakan rakitan yang dapat dieksekusi, runtime Lambda harus di-bootstrap. Untuk melakukan ini, Anda menggunakan LambdaBootstrapBuilder.Create metode ini. Metode ini mengambil sebagai input metode yang digunakan fungsi Anda sebagai handler dan serializer Lambda untuk digunakan.

Untuk informasi selengkapnya tentang menggunakan pernyataan tingkat atas, lihat Memperkenalkan. NET6 runtime untuk AWS Lambda di blog AWS komputasi.

namespace GetProductHandler;

IDatabaseRepository repo = new DatabaseRepository();

await LambdaBootstrapBuilder.Create<APIGatewayProxyRequest>(Handler, new DefaultLambdaJsonSerializer())
    .Build()
    .RunAsync();

async Task<APIGatewayProxyResponse> Handler(APIGatewayProxyRequest apigProxyEvent, ILambdaContext context)
{
    var id = apigProxyEvent.PathParameters["id"];
        
    var databaseRecord = await this.repo.GetById(id);
    
    return new APIGatewayProxyResponse 
    {
        StatusCode = (int)HttpStatusCode.OK,
        Body = JsonSerializer.Serialize(databaseRecord)
    };
};

Saat menggunakan rakitan yang dapat dieksekusi, string handler yang memberi tahu Lambda cara menjalankan kode Anda adalah nama perakitan. Dalam contoh ini, itu akan menjadiGetProductHandler.

Serialisasi dalam fungsi Lambda

Jika fungsi Lambda Anda menggunakan jenis input atau output selain Stream objek, Anda harus menambahkan pustaka serialisasi ke aplikasi Anda. Anda dapat menerapkan serialisasi baik menggunakan serialisasi berbasis refleksi standar yang disediakan oleh System.Text.Json danNewtonsoft.Json, atau dengan menggunakan serialisasi yang dihasilkan sumber.

Menggunakan serialisasi yang dihasilkan sumber

Serialisasi yang dihasilkan sumber adalah fitur dari. NETversi 6 dan yang lebih baru yang memungkinkan kode serialisasi dihasilkan pada waktu kompilasi. Ini menghilangkan kebutuhan untuk refleksi dan dapat meningkatkan kinerja fungsi Anda. Untuk menggunakan serialisasi yang dihasilkan sumber dalam fungsi Anda, lakukan hal berikut:

Sebuah fungsi contoh menggunakan sumber yang dihasilkan serialisasi ditampilkan dalam kode berikut.

[assembly: LambdaSerializer(typeof(SourceGeneratorLambdaJsonSerializer<CustomSerializer>))]

public class Function
{
    private readonly IDatabaseRepository _repo;
    
    public Function()
    {
        this._repo = new DatabaseRepository();
    }
    
    public async Task<APIGatewayProxyResponse> FunctionHandler(APIGatewayProxyRequest request)
    {
        var id = request.PathParameters["id"];
        
        var databaseRecord = await this._repo.GetById(id);
        
        return new APIGatewayProxyResponse 
        {
            StatusCode = (int)HttpStatusCode.OK,
            Body = JsonSerializer.Serialize(databaseRecord, CustomSerializer.Default.Product)
        };
    }
}

[JsonSerializable(typeof(APIGatewayProxyRequest))]
[JsonSerializable(typeof(APIGatewayProxyResponse))]
[JsonSerializable(typeof(Product))]
public partial class CustomSerializer : JsonSerializerContext
{
    
}

Menggunakan serialisasi berbasis refleksi

AWS menyediakan pustaka bawaan untuk memungkinkan Anda menambahkan serialisasi ke aplikasi dengan cepat. Anda mengonfigurasi ini menggunakan Amazon.Lambda.Serialization.Json NuGet paket Amazon.Lambda.Serialization.SystemTextJson atau. Di belakang layar, Amazon.Lambda.Serialization.SystemTextJson gunakan System.Text.Json untuk melakukan tugas serialisasi, dan Amazon.Lambda.Serialization.Json menggunakan Newtonsoft.Json paket.

Anda juga dapat membuat pustaka serialisasi Anda sendiri dengan mengimplementasikan ILambdaSerializer antarmuka, yang tersedia sebagai bagian dari Amazon.Lambda.Core perpustakaan. Antarmuka ini mendefinisikan dua metode:

Sederhanakan kode fungsi dengan kerangka kerja Anotasi Lambda

Anotasi Lambda adalah kerangka kerja untuk. NET6 dan. NET8 yang menyederhanakan penulisan fungsi Lambda menggunakan C #. Dengan kerangka kerja Anotasi, Anda dapat mengganti banyak kode dalam fungsi Lambda yang ditulis menggunakan model pemrograman biasa. Kode yang ditulis menggunakan kerangka kerja menggunakan ekspresi sederhana yang memungkinkan Anda untuk fokus pada logika bisnis Anda.

Contoh kode berikut menunjukkan bagaimana menggunakan kerangka anotasi dapat menyederhanakan penulisan fungsi Lambda. Contoh pertama menunjukkan kode yang ditulis menggunakan model program Lambda biasa, dan yang kedua menunjukkan yang setara menggunakan kerangka kerja Anotasi.

public APIGatewayHttpApiV2ProxyResponse LambdaMathAdd(APIGatewayHttpApiV2ProxyRequest request, ILambdaContext context)
{
    if (!request.PathParameters.TryGetValue("x", out var xs))
    {
        return new APIGatewayHttpApiV2ProxyResponse
        {
            StatusCode = (int)HttpStatusCode.BadRequest
        };
    }
    if (!request.PathParameters.TryGetValue("y", out var ys))
    {
        return new APIGatewayHttpApiV2ProxyResponse
        {
            StatusCode = (int)HttpStatusCode.BadRequest
        };
    }
    var x = int.Parse(xs);
    var y = int.Parse(ys);
    return new APIGatewayHttpApiV2ProxyResponse
    {
        StatusCode = (int)HttpStatusCode.OK,
        Body = (x + y).ToString(),
        Headers = new Dictionary≪string, string> { { "Content-Type", "text/plain" } }
    };
}

[LambdaFunction]
[HttpApi(LambdaHttpMethod.Get, "/add/{x}/{y}")]
public int Add(int x, int y)
{
    return x + y;
}

Untuk contoh lain bagaimana menggunakan Anotasi Lambda dapat menyederhanakan kode Anda, lihat contoh aplikasi lintas layanan ini di repositori. awsdocs/aws-doc-sdk-examples GitHub Folder PamApiAnnotations menggunakan Anotasi Lambda di file utama. function.cs Sebagai perbandingan, PamApi folder memiliki file setara yang ditulis menggunakan model pemrograman Lambda biasa.

Kerangka kerja Anotasi menggunakan generator sumber untuk menghasilkan kode yang diterjemahkan dari model pemrograman Lambda ke kode yang terlihat pada contoh kedua.

Untuk informasi selengkapnya tentang cara menggunakan Anotasi Lambda untuk. NET, lihat sumber daya berikut:

Injeksi ketergantungan dengan kerangka kerja Anotasi Lambda

Anda juga dapat menggunakan kerangka kerja Anotasi Lambda untuk menambahkan injeksi ketergantungan ke fungsi Lambda Anda menggunakan sintaks yang Anda kenal. Saat Anda menambahkan [LambdaStartup] atribut ke Startup.cs file, kerangka kerja Anotasi Lambda akan menghasilkan kode yang diperlukan pada waktu kompilasi.

[LambdaStartup]
public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddSingleton<IDatabaseRepository, DatabaseRepository>();
    }
}

Fungsi Lambda Anda dapat menyuntikkan layanan menggunakan injeksi konstruktor atau dengan menyuntikkan ke dalam metode individual menggunakan atribut. [FromServices]

[assembly: LambdaSerializer(typeof(Amazon.Lambda.Serialization.SystemTextJson.DefaultLambdaJsonSerializer))]

namespace GetProductHandler;

public class Function
{
    private readonly IDatabaseRepository _repo;
    
    public Function(IDatabaseRepository repo)
    {
        this._repo = repo;
    }
    
    [LambdaFunction]
    [HttpApi(LambdaHttpMethod.Get, "/product/{id}")]
    public async Task<Product> FunctionHandler([FromServices] IDatabaseRepository repository, string id)
    {
        return await this._repo.GetById(id);
    }
}

Pembatasan handler fungsi Lambda

Perhatikan bahwa ada beberapa pembatasan pada tanda tangan handler.

Praktik terbaik kode untuk fungsi C# Lambda

Patuhi pedoman dalam daftar berikut untuk menggunakan praktik pengkodean terbaik saat membangun fungsi Lambda Anda: