Dokumentasi Seam Project

Instalasi Java dan Pengaturannya

1. Install Java Development Kit (JDK), yang saya gunakan jdk 5 :

2. Ikuti petunjuk instalasi seperti biasanya. 3. Jika java telah terinstall dan Jbossnya telah di copy ke komputer, tambahkan pengaturan pada Environment Variable pada user variable for usernya. Untuk windows 7, klik kanan pada Start > Computer, sebagai berikut :

4. Klik Properties, maka muncul kotak dialog sebagai berikut :

5. Klik Advanced System settings, maka muncul kotak dialog sebagai berikut :

6. Klik [Environment Variables], maka muncul kotak dialog sebagai berikut :

7. Tambahkan variable baru pada User Variables dengan nama JAVA_HOME, dengan klik New, sebagai berikut :

8. Tambahkan variable baru pada User Variables dengan nama JBOSS_HOME, dengan klik New, sebagai berikut :

9. Tambakan variable value pada user variable Path, atau jika belum ada tambahkan variable Path pada user variable, dengan klik New, tambahkan variable valuenya dengan ; (titik koma) sebagai pemisah dengan variable value yang lain, contoh :

Buat Project Baru

1. Buat database yang akan digunakan, contoh : a. Menggunakan Postgresql, nama database : payroll_db

b. Buat 2 tabel, employee dan jobstatus.

c. Buat 2 sequence untuk mengisi kolom id pada setiap table secara otomatis (auto_increment).

2. Buka eclipse, yang saya gunakan eclipse Ganymede.

3. Jika belum menentukan folder workspace, akan muncul kotak dialog seperti ini :

4. Tentukan folder workspacenya dengan klik [Browse]. 5. Untuk mengubah letak workspace, klik File > Switch Workspace > Other

6. Untuk membuat project seam, klik open perspective > other, maka muncul kotak dialog open perspective, lalu pilih seam.

7. Untuk membuat project seam baru, klik File > New > Seam Project.

8. Muncul kotak dialog, isikan nama project dan yang lainnya. Contoh :

a. Project name : protest. b. Target Runtime : i. Klik [New], muncul kotak dialog baru.

ii. Pilih Jboss Community > Jboss 4.2 Runtime.

iii. Klik [Next], sesuaikan Home directory dengan letak folder Jbossnya. Lalu klik [Finish].

c. Target Server : i. Klik New, muncul kotak dialog.

ii. Klik Finish, karena server sudah ter-setting pada saat men-setting Jboss runtime-nya. d. Configuration, pilih : Dynamic Web Project with Seam 2.1 (technology preview). Karena di project ini menggunakan seam versi 2.1.2. e. Muncul kotak dialog baru, tidak perlu mengubah apapun. Lalu klik Next.

f. Muncul kotak dialog baru, tidak perlu mengubah apapun. Lalu klik Next.

g. Muncul Kotak dialog baru, setting :

i. Seam Runtime : 1. Klik Add, muncul kotak dialog.

2. Klik Browse, pilih folder seamnya.

3. Klik Finish. ii. Pilih Deploy As : Ear. iii. Pilih Database Type : PostgreSQL. iv. Connection Profile : 1. Klik New, muncul kotak dialog.

2. Pilih PostgreSQL, isi Name, sebagai berikut :

3. Klik Next, muncul kotak dialog.

4. Klik New Driver Definition.

5. Muncul kotak dialog, isi sebagai berikut :

6. Klik OK v. DB Tables already exist in database : checklist. vi. Klik Finish. 9. Klik menu Window > Preferences, Pilih Validation dan check Suspend all Validators, lalu klik OK.

10.Klik menu Window > Show View > Other, pilih Server > Server, lalu klik OK.

11.Klik Run pada server.

12.Setelah proses running selesai, tampilkan hasil di browser.

Menambah Entity Baru

1. Stop Server dan hapus ear projectnya. 2. Klik kanan pada main projectnya, pilih New > Seam Generate Entities. Dengan Seam Generate Entities, otomatis membuat tampilannya berupa .xhtml.

3. Muncul kotak dialog, klik Next.

4. Muncul kotak dialog, klik Refresh maka muncul databasenya. Klik pada tabel yang akan dibuat entity nya, klik Include.

5. Setelah selesai, klik Finish.

Mengubah kolom id
Karena sebelumnya di database kolom id pada setiap table telah ditentukan diisi menggunakan sequence maka id pada entity nya harus di generate berdasarkan sequence yang digunakan. 1. Buka file entity nya, contoh : Employee.java

2. Tambahkan annotation pada kolom id nya sebagai berikut :

3. Hapus / jadikan komentar script kolom isian id nya di file xhtmlnya, :

Menyambungkan antar Entity

1. Data jobstatusid pada Entity Employee.java mengambil data jobstatusid pada Jobstatus.java jadi diperlukan hubungan antar entity tersebut. 2. Jika sebelum men-Generate Entity menggunakan Seam Generate entities tabel yang digunakan telah di relasikan, maka di script entitynya akan muncul seperti ini : Contoh menggunakan Employee.java yang mengambil data kolom jobstatusid nya ke data jobstatusid pada Jobstatus.java

3. Jika tabel yang digunakan belum ada relasinya di database, entity yang ada bisa direlasikan langsung menggunakan script diatas.

Menampilkan data yang direlasikan pada xhtml

Tampilan yang diinginkan :

Field Job status berupa combo box. 1. Buka page EmployeeEdit.xhtml

2. Tambahkan script berikut :

3. Tambahkan juga script parameternya di EmployeeEdit.page.xml, seperti berikut :

4. Untuk tampilan page yang lainnya dapat disesuaikan.