Pengujian unit adalah salah satu komponen penting dalam pengembangan perangkat lunak yang bertujuan untuk memastikan bahwa setiap bagian kode berfungsi sesuai harapan. Dalam konteks pengembangan aplikasi web, terutama dengan framework seperti ASP.NET Web API 2, pengujian unit menjadi kunci untuk menjaga kualitas dan stabilitas aplikasi. Artikel ini akan membimbing Anda melalui langkah-langkah praktis dalam membuat pengujian unit untuk aplikasi Web API 2, mulai dari persiapan hingga pelaksanaan.

Persyaratan Awal

Sebelum memulai, pastikan Anda memiliki lingkungan pengembangan yang siap. Untuk tutorial ini, diperlukan Visual Studio 2017 Edisi Komunitas, Profesional, atau Perusahaan. Selain itu, Anda juga perlu mengunduh proyek yang telah selesai agar dapat langsung mencoba dan memahami implementasinya.

Membuat Aplikasi dengan Proyek Pengujian Unit

Anda dapat membuat proyek pengujian unit saat membuat aplikasi atau menambahkan proyek pengujian unit ke aplikasi yang sudah ada. Tutorial ini menunjukkan kedua metode tersebut. Misalnya, jika Anda ingin membuat aplikasi baru bernama StoreApp, ikuti langkah-langkah berikut:

1. Buka Visual Studio dan pilih template “Empty” untuk aplikasi Web ASP.NET.
2. Tambahkan folder dan referensi inti untuk API Web.
3. Pilih opsi “Add Unit Test” untuk membuat proyek pengujian unit secara otomatis.
4. Nama proyek pengujian unit akan otomatis diberi nama StoreApp.Tests.

Menambahkan Proyek Pengujian Unit ke Aplikasi yang Sudah Ada

Jika Anda tidak membuat proyek pengujian unit saat membuat aplikasi, Anda bisa menambahkannya kapan saja. Berikut langkah-langkahnya:

1. Klik kanan solusi di Penjelajah Solusi.
2. Pilih “Add” > “New Project”.
3. Pilih jenis proyek “Unit Test Project”.
4. Beri nama proyek StoreApp.Tests.
5. Tambahkan referensi proyek ke proyek asli.

Menyiapkan Aplikasi Web API 2

Setelah proyek pengujian unit dibuat, langkah selanjutnya adalah menyiapkan aplikasi Web API 2. Tambahkan file kelas ke folder Model bernama Product.cs dengan kode berikut:

using System;
namespace StoreApp.Models {
    public class Product {
        public int Id { get; set; }
        public string Name { get; set; }
        public decimal Price { get; set; }
    }
}

Selanjutnya, tambahkan controller untuk mengelola data produk. Contoh kode untuk SimpleProductController adalah sebagai berikut:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using System.Web.Http;
using StoreApp.Models;

namespace StoreApp.Controllers {
    public class SimpleProductController : ApiController {
        List<Product> products = new List<Product>();

        public SimpleProductController() { }

        public SimpleProductController(List<Product> products) {
            this.products = products;
        }

        public IEnumerable<Product> GetAllProducts() {
            return products;
        }

        public async Task<IEnumerable<Product>> GetAllProductsAsync() {
            return await Task.FromResult(GetAllProducts());
        }

        public IHttpActionResult GetProduct(int id) {
            var product = products.FirstOrDefault((p) => p.Id == id);
            if (product == null) {
                return NotFound();
            }
            return Ok(product);
        }

        public async Task<IHttpActionResult> GetProductAsync(int id) {
            return await Task.FromResult(GetProduct(id));
        }
    }
}

Menginstal Paket NuGet dalam Proyek Pengujian

Untuk memastikan proyek pengujian unit berjalan dengan baik, instal paket NuGet yang diperlukan. Berikut langkah-langkahnya:

1. Klik kanan proyek StoreApp.Tests.
2. Pilih “Manage NuGet Packages”.
3. Cari dan instal paket “Microsoft ASP.NET Web API 2 Core”.

Membuat Pengujian

Setelah semua persiapan selesai, buat file pengujian unit. Contoh kode untuk pengujian metode GetAllProducts adalah sebagai berikut:

[TestClass]
public class TestSimpleProductController {
    [TestMethod]
    public void GetAllProducts_ShouldReturnAllProducts() {
        var testProducts = GetTestProducts();
        var controller = new SimpleProductController(testProducts);
        var result = controller.GetAllProducts() as List<Product>;
        Assert.AreEqual(testProducts.Count, result.Count);
    }

    private List<Product> GetTestProducts() {
        var testProducts = new List<Product>();
        testProducts.Add(new Product { Id = 1, Name = "Demo1", Price = 1 });
        testProducts.Add(new Product { Id = 2, Name = "Demo2", Price = 3.75M });
        testProducts.Add(new Product { Id = 3, Name = "Demo3", Price = 16.99M });
        testProducts.Add(new Product { Id = 4, Name = "Demo4", Price = 11.00M });
        return testProducts;
    }
}

Jalankan Pengujian

Setelah semua metode pengujian ditulis, jalankan pengujian untuk memastikan semua tes lulus. Anda dapat menggunakan Test Explorer di Visual Studio untuk menjalankan dan melihat hasil pengujian.

Kesimpulan

Pengujian unit dalam ASP.NET Web API 2 adalah langkah penting untuk memastikan kualitas dan stabilitas aplikasi. Dengan mengikuti panduan lengkap ini, Anda dapat membuat pengujian unit yang efektif dan efisien. Pastikan untuk selalu memperbarui dan merevisi pengujian sesuai dengan perubahan kode agar tetap relevan dan bermanfaat. Dengan pendekatan yang tepat, pengujian unit akan menjadi alat kuat dalam pengembangan perangkat lunak yang andal.