Menggunakan AWSSDK .Extensions.NetCore.Setup dan antarmuka Iconfiguration

(Topik ini sebelumnya berjudul, “Configuring the AWS SDK for .NET with .NET Core”)

Salah satu perubahan terbesar dalam .NET Core adalah penghapusan dan standar ConfigurationManager app.config dan web.config file yang digunakan dengan aplikasi.NET Framework dan ASP.NET.

Konfigurasi dalam.NET Core didasarkan pada pasangan nilai kunci yang ditetapkan oleh penyedia konfigurasi. Penyedia konfigurasi membaca data konfigurasi menjadi pasangan nilai kunci dari berbagai sumber konfigurasi, termasuk argumen baris perintah, file direktori, variabel lingkungan, dan file pengaturan.

Untuk membuatnya mudah digunakan AWS SDK for .NET dengan .NET Core, Anda dapat menggunakan AWSSDK NuGet paket.Extensions.NetCore.Setup. Seperti banyak pustaka .NET Core, ia menambahkan metode ekstensi ke IConfiguration antarmuka untuk membuat AWS konfigurasi mulus.

Menggunakan AWSSDK .Extensions.NetCore.Setup

Misalkan Anda membuat aplikasi ASP.NET Core Model-View-Controller (MVC), yang dapat dicapai dengan template ASP.NET Core Web Application di Visual Studio atau dengan berjalan di .NET Core CLI. dotnet new mvc ... Ketika Anda membuat aplikasi seperti itu, konstruktor untuk Startup.cs menangani konfigurasi dengan membaca di berbagai sumber input dari penyedia konfigurasi sepertiappsettings.json.

public Startup(IConfiguration configuration)
{
    Configuration = configuration;
}

Untuk menggunakan Configuration objek untuk mendapatkan AWSopsi, pertama-tama tambahkan AWSSDK.Extensions.NETCore.Setup NuGet paket. Kemudian, tambahkan opsi Anda ke file konfigurasi seperti yang dijelaskan selanjutnya.

Perhatikan bahwa salah satu file yang ditambahkan ke proyek Anda adalahappsettings.Development.json. Ini sesuai dengan satu EnvironmentName set untuk Pengembangan. Selama pengembangan, Anda menempatkan konfigurasi Anda dalam file ini, yang hanya dibaca selama pengujian lokal. Saat Anda menerapkan instans Amazon EC2 yang EnvironmentName telah disetel ke Production, file ini akan diabaikan dan AWS SDK for .NET akan kembali ke kredensi IAM dan Wilayah yang dikonfigurasi untuk instans Amazon EC2.

Pengaturan konfigurasi berikut menunjukkan contoh nilai yang dapat Anda tambahkan dalam appsettings.Development.json file dalam proyek Anda untuk menyediakan AWS pengaturan.

{
  "AWS": {
    "Profile": "local-test-profile",
    "Region": "us-west-2"
  },
  "SupportEmail": "TechSupport@example.com"
}

Untuk mengakses pengaturan dalam file CSHTHTML, gunakan direktif. Configuration

@using Microsoft.Extensions.Configuration
@inject IConfiguration Configuration

<h1>Contact</h1>

<p>
    <strong>Support:</strong> <a href='mailto:@Configuration["SupportEmail"]'>@Configuration["SupportEmail"]</a><br />
</p>

Untuk mengakses AWS opsi yang ditetapkan dalam file dari kode, panggil metode GetAWSOptions ekstensi yang ditambahkan keIConfiguration.

Untuk membangun klien layanan dari opsi ini, hubungiCreateServiceClient. Contoh berikut menunjukkan cara membuat klien layanan Amazon S3. (Pastikan untuk menambahkan AWSSDK NuGet paket.S3 ke proyek Anda.)

var options = Configuration.GetAWSOptions();
IAmazonS3 client = options.CreateServiceClient<IAmazonS3>();

Anda juga dapat membuat beberapa klien layanan dengan pengaturan yang tidak kompatibel dengan menggunakan beberapa entri dalam appsettings.Development.json file, seperti yang ditunjukkan dalam contoh berikut di mana konfigurasi untuk service1 menyertakan us-west-2 Wilayah dan konfigurasi untuk service2 menyertakan URL titik akhir khusus.

{
  "service1": {
    "Profile": "default",
    "Region": "us-west-2"
  },
  "service2": {
    "Profile": "default",
    "ServiceURL": "URL"
  }
}

Anda kemudian bisa mendapatkan opsi untuk layanan tertentu dengan menggunakan entri dalam file JSON. Misalnya, untuk mendapatkan pengaturan untuk service1 gunakan yang berikut ini.

var options = Configuration.GetAWSOptions("service1");

Nilai yang diizinkan dalam file pengaturan aplikasi

Nilai konfigurasi aplikasi berikut dapat diatur dalam appsettings.Development.json file. Nama bidang harus menggunakan casing yang ditampilkan. Untuk detail tentang pengaturan ini, lihat AWS.Runtime.ClientConfig kelas.

Injeksi ketergantungan ASP.NET Core

NuGet Paket AWSSDK.Extensions.NetCore.Setup juga terintegrasi dengan sistem injeksi ketergantungan baru di ASP.NET Core. ConfigureServicesMetode di Startup kelas aplikasi Anda adalah di mana layanan MVC ditambahkan. Jika aplikasi menggunakan Entity Framework, ini juga tempat yang diinisialisasi.

public void ConfigureServices(IServiceCollection services)
{
    // Add framework services.
    services.AddMvc();
}

AWSSDK.Extensions.NETCore.Setup NuGet Paket ini menambahkan metode ekstensi baru IServiceCollection yang dapat Anda gunakan untuk menambahkan AWS layanan ke injeksi ketergantungan. Kode berikut menunjukkan cara menambahkan AWS opsi yang dibaca IConfiguration untuk menambahkan Amazon S3 dan DynamoDB ke daftar layanan. (Pastikan untuk menambahkan AWSSDKpaket.S3 dan AWSSDK.DynamoDBv2 NuGet ke proyek Anda.)

public void ConfigureServices(IServiceCollection services)
{
    // Add framework services.
    services.AddMvc();

    services.AddDefaultAWSOptions(Configuration.GetAWSOptions());
    services.AddAWSService<IAmazonS3>();
    services.AddAWSService<IAmazonDynamoDB>();
}

Sekarang, jika pengontrol MVC Anda menggunakan salah satu IAmazonS3 atau IAmazonDynamoDB sebagai parameter dalam konstruktornya, sistem injeksi ketergantungan melewati layanan tersebut.

public class HomeController : Controller
{
    IAmazonS3 S3Client { get; set; }

    public HomeController(IAmazonS3 s3Client)
    {
        this.S3Client = s3Client;
    }

    ...

}