Doğrulamalar (Validation)

Doğrulama tanımlamaları view(görünün) içerisinde bileşen niteliklerine atama yapılarak sağlanır. Doğrulama sonucları event (olay) nesnesinin niteliğine göre AJAX ya da sayfa post edilerek tarayıcıya gönderilir.

Doğrulama işlemlerinde bileşenlerin 5 niteliği bulunur.

Bunlar

• validator

• rule

• messagefor

• message

• success

Validator: bu niteliğe static metodlar barındıran doğrulama sınıfının ismi verilmelidir. io dizininde filtler ve validator isimlerimlerinde hazır iki doğrulama sınıfı bulunmaktadır.

Rule : Validator niteliği ile bildirilen doğrulama sınıfının doğrulma işlemi için kullandığı metodun ismidir. (doğrulama metodu)

Message : Doğrulama işlemin sonucunun (false) yanlış  olması durumunda  verilecek olan uyarı  mesajdır. Örneğin “Hatali email adresi girdiniz ! ”

Success Doğrulama işlemin sonucunun (true) doğru  olması durumunda  verilecek olan mesajdır. . Örneğin “email adresiniz doğrulandı ! ”  Eğer doğrulama mesajı verilmek istenmiyorsa bu nitelik boş bırakılabilir.

Messagefor : message ve success ile belirtilen mesajların hangi bileşende görüntüleneceğidir.

FacesController varsayılan durum da bir doğrulama işleminin sonucu yanlış ise olay metotlarını işletmez . Doğrulama işleminin sonucu yanlış olduğu halde örneğin bir Clicked metodunun işletilmesini istiyorsanız FacesController ın setValidCallBack(boolean); metoduna true değerini vermeniz yeterlidir.

Doğrulama işleminin sonucunun doğru ya da yanlış olduğunu bileşenin isValid metodunun döndürdüğü değere bakarak anlaşılabilir.

Örnek Kullanıcı tarafından girilen e-mail Adresinin doğrulanması.

View görünüm dosyası

<faces>
<@import prefix="f" taglib="phpf.ui.*"/>
<f:form method="post">
E-Mail :<f:textbox
validator="filter"
rule="mail"
success="Mail adresiniz doğrulandı"
message=" Hatali email adresi girdiniz ! "
messagefor="msgbox"
/>
<f:message id="msgbox"/>
</f:form>
</faces>

Doğrulama işlemi sonucu doğru ise  msgbox isimli bileşende success ile belirtilen yanlış ise message ile belirtilen bilgi yer alır.

Filtler sınıfının metotları aşağıdaki gibidir.

• required

• mail

• url

• ip

• float

• int

• boolean

• regxp

Validator sınıfının metotları aşağıdaki gibidir.

• required

• equals

• minLength

• maxLength

• mail

• alpha

• alpha_numeric

• numeric

• integer

• betweenLength

• between

• boolean

• test