Joshua's Blog

Log4Net adalah sebuah library yang menyediakan fungsi-fungsi logger bagi aplikasi yang dikembangkan dengan .NET. Library ini dikembangkan dari project pendahulunya yang sudah lebih terkenal, yaitu Log4J. Pertama kali saya mencoba Log4Net tidak mengalami banyak kesulitan. Alur Kerja cukup mudah dipahami, contoh-contoh konfigurasi juga disediakan.

Namun, ada beberapa masalah yang mungkin sampai saat ini belum mampu saya cari solusinya saat mengimplementasikan di dalam sebuah website (Visual Studi0 2005 / .NET 2.0).

Permasalahan tersebut antara lain:

• File Config tidak terbaca apabila disimpan terpisah dengan web.config
• Deklarasi assembly untuk membaca konfigurasi seakan tidak tereksekusi.

Solusi sementara yang saya miliki adalah sbb:

• Gabungkan Log4Net.config dengan web.config
• Gunakan Global.asax, dan taruhlah potongan kode berikut pada Application_OnStart:

  log4net.Config.XmlConfigurator.Configure();

Semoga membantu.

Dokumentasi source code mungkin untuk sebagian teman-teman belum menjadi prioritas dalam bekerja. Apalagi jika kita merupakan seorang single fighter atau hanya terdiri dari tim yang kecil. Namun, dengan penerapan OO pada pekerjaan kita, dokumentasi merupakan sesuatu yang mutlak untuk diperhatikan. Untuk programmer java / php, mungkin sudah terbiasa menggunakan source documentation generator seperti JavaDoc atau PhpDoc.

Namun, bagaimana untuk yang menggunakan microsoft .NET? Untuk .NET, ada beberapa software freeware / commercial yang tersedia seperti N-Doc, VSDocMan, dan yang terakhir Sandcastle. Referensi mengenai perbandingan document generator dapat dilihat di wikipedia. Fokus utama yang akan dibahas di dalam artikel ini adalah Sandcastle dengan menggunakan DocProject. Sandcastle adalah software yang dikembangkan oleh microsoft sebagai alat untuk menghasilkan dokumen program dari komentar-komentar yang ada pada sumber program. Sedangkan DocProject merupakan alat bantu untuk sandcastle, karena menggunakan sandcastle secara manual dirasa cukup merepotkan dan membingungkan. Beberapa alasan untuk menggunakan dua software tersebut adalah sbb:

1. Free & Gratis, Sandcastle berlisensi Microsoft Public License, dan DocProject berlisensi GNU/GPL (GPLv2).
2. DocProject lebih mudah digunakan, dan masih didukung oleh komunitas.

Read the rest of this entry »