LINUXSOFT.cz Přeskoč levou lištu
Uživatel: Heslo:  
   CZUKPL

> Apache Struts (5) - modul Validator

Dnes si projdeme standardní pravidla tohoto modulu, které nám vystačí v naprosté většině běžných webových aplikací. Na konci článku si vytvoříme pravidlo vlastní , jehož validace bude založena na širokých možnostech regulárních výrazů a mrkneme na použití modulu Validator ve vícejazyčném prostředí.

14.4.2005 06:00 | Miroslav Holubec | Články autora | přečteno 8287×

Předdefinovaná pravidla

Začneme výčtem předdefinovaných pravidel modulu Validator, které nám pro většinu běžných aplikací vystačí. Všechny pravidla mají jeden povinný argument, kterým je klíč názvu položky formuláře ze souborů zdrojových svazků zpráv (messages resources). Nadpisy jednotlivých pravidel ubsahují stručný popis pravidla, jeho název a kód klíče chybové hlášky. Pokud bychom chtěli předefinovat výhozí kód chybové hlášky, použijeme XML element <msg /> (viz příklad u short).

Nutná hodnota - required - errors.required

Toto zřejmě nejpoužívanější pravidlo určuje, že uživatel nemůže nechat políčko nevyplněné, jeho hodnota je tedy povinná. Použití je jednoduché, pravidlo vyžaduje jako argument pouze název položky, jak ukazuje následující ukázka ze souboru validation.xml:

      
  <field property="username" depends="required">
    <arg0 key="login.username"/>
  </field>

Pokud dojde k porušení pravidla, použije se klíč errors.required, jejíž výchozí překlad je {0} is required. Místo {0} se v tomto příkladě použije hodnota klíče login.username.

Minimální délka - minlength - errors.minlength

Určuje minimální délku položky, přičemž kromě povinného argumentu vyžaduje ještě jeden, nazvaný minlength, kterým je právě minimální počet znaků. Atribut resource použijeme vždy, když nechceme aby se hodnota parametru nehledala v klíčích zdrojových svazků zpráv, ale použila se přímo. Stejně jako definujeme argument, který slouží k nahrazování parametrů ve zprávách, musíme definovat i proměnnou minlength, která je určující pro validátor.

      
  <field property="password" depends="required,minlength">
    <arg0 key="login.password"/>
    <arg1 name="minlength" key="${var:minlength}" resource="false"/>
    <var>
      <var-name>minlength</var-name>
      <var-value>5</var-value>
    </var>
  </field>

Maximální délka - maxlength - errors.maxlength

Určuje maximální délku položky, použití je obdobné jako u pravidla maxlength.

Mask - mask - errors.invalid

Je nejsilnější pravidlo, dovoluje aplikovat na položku regulární výraz. Jeho použití si ukážeme ke konci článku.

typ Byte - byte - errors.byte

Použití tohoto pravidla využijeme, pokud v aplikační logice pracujeme s typem Byte. Hodnota bude tedy akceptována v rozmezí celočíselných hodnot -128 až 127.

      
  <field property="age" depends="required, byte">
    <arg0 key="registration.age"/>
  </field>

typ Short - short - errors.short

Obdobné jako typ Byte, až na rozmezí od -32768 do 32767. U tohoto pravidla si ukážeme jak předefinovat výchozí klíč chybové hlášky na námi definovaný.

      
  <field property="pin" depends="required, short">
    <arg0 key="registration.pin"/>
    <msg  name="short" key="registration.pin.low"/>
  </field>

typ Integer - integer - errors.integer

Celočíselné hodnoty v mezích od -2147483648 do 2147483647.

typ Long - long - errors.long

Celočíselné hodnoty v mezích od -9223372036854775808 do 9223372036854775807.

typ Float - float - errors.float

Reálné hodnoty dle IEEE 754 v mezích od ±1.4E-45 do ±3.4028235E+38.

typ Double - double - errors.double

Reálné hodnoty dle IEEE 754 v mezích od ±4.9E-324 to ±1.7976931348623157E+308.

Datum - date - errors.date

Validace probíhá pomocí třídy java.text.SimpleDateFormat, které se zadává proměnná, jejíž hodnotou je formát data. Jsou dvě možosti rozlišení dle názvu proměnné, obvykle použijeme datePattern, pokud bychom chtěli kontrolovat i pevný počet znaků, museli bychom použít datePatternStrict ( 1.12.2005 by formátem dd.MM.yyyy neprošlo ).

      
  <field property="date" depends="required,date">
    <arg0 key="registration.date"/>
    <var>
      <var-name>datePattern</var-name>
      <var-value>dd.MM.yyyy</var-value>
    </var>
  </field>

Email - email - errors.email

Pravidlo využijeme u validace emailové adresy, adresa musí obsahovat zavináč a tečku.

      
  <field property="email" depends="required,email">
    <arg0 key="registration.email"/>
  </field>

Kreditní karta - creditCard - errors.creditcard

Jak již název napovídá, validací projdou jen skutečně aktivní čísla kreditních karet :)

URL - url - errors.url

Dokáže zvalidovat formát adresy url pro specifické protokoly. Můžeme zadat čtyři nepovinné proměnné, které ovlivňují kontrolu.

  • allowallschemes Povoluje všechny protokoly, možné hodnoty jsou true nebo false, přičemž standartně je nastaveno na false. Pokud proměnnou nastavíme na true, pak bude proměnná schemes ignorována.
  • allow2slashes Říká jestli je povoleno uvádět dvojité lomítko '/'. Výchozí hodnota je false).
  • nofragments Povoluje necelé adresy url. Výchozí je true, tedy nepovoleno.
  • schemes Definuje protokoly, které lze použít v adresách URL. Výchozím nastavením je http, https a ftp.
      
  <field property="url" depends="url">
    <arg0 key="registration.url"/>
    <var>
      <var-name>schemes</var-name>
      <var-value>http,https</var-value>
    </var>
  </field>

Rozmezí celočíselných čísel - intRange - errors.range

Pravidlo akceptuje všechna celočíselná čísla, která se nachází mezi zadanou dvojicí proměnných, vyžaduje tedy celkem tři argumenty (pro MessagesResources) a dvě proměnné.

      
  <field property="age" depends="required,integer,intRange">
    <arg0 key="registration.age"/>
    <arg1 name="intRange" key="${var:min}" resource="false"/>
    <arg2 name="intRange" key="${var:max}" resource="false"/>
    <var>
      <var-name>min</var-name>
      <var-value>18</var-value>
    </var>
    <var>
      <var-name>max</var-name>
      <var-value>60</var-value>
    </var>
  </field>

Rozmezí reálných čísel - floatRange - errors.range

Použití je stejné jako u předchozího pravidla s tím, že hodnoty mohou být s v rámci reálných čísel.

Větvení kontrol - validwhen - errors.invalid

Od Struts v1.2 je možnost použít tohoto pravidla, které určuje závislosti na ostatních položkách formuláře. Pravidlu je nutné nadefinovat proměnnou test, do níž zadáme výraz jazyka Java. Např. výraz z následujícího příkladu říká: toto pole sendNews je validní pouze tehdy, je-li uveden email a věk je větší nežli 17, nebo není-li zadána hodnota.

      
  <field property="sendNews" depends="validwhen">
    <arg0 key="registration.sendNews"/>
    <var>
      <var-name>test</var-name>
      <var-value>(((email != null) && (age>17)) or (*this* == null))</var-value>
    </var>
  </field>

Vytváření vlastních pravidel na bázi regulárních výrazů

K tomuto účelu nám poslouží mocné pravidlo mask. Chceme-li definovat například formát PSČ, odpovídající regulární výraz je \d{3}(\ )?\d{2}. Každý regulární výraz validátoru musí začínat znakem ^ a končit znakem $. Jednoduchý příklad by tedy vypadal takto:

      
  <field property="zip" depends="mask">
    <arg0 key="registration.zip"/>
    <msg  name="mask" key="registration.zip.invalid"/>
    <var>
      <var-name>mask</var-name>
      <var-value>^\d{3}(\ )?\d{2}$</var-value>
    </var>
  </field>

Modul Validator a i18n

Validátor obsahuje stejně jako ostatní části Struts plnou podporu internacionalizace. Obvyklým postupem je, že definujeme sadu globálních konstant (např. některé univerzální regulární výrazy) společných pro většinu lokalizací. Dále již definujeme formuláře pro danou lokalizaci uvnitř elementu formset, včetně společných konstant pro danou lokalizaci. Příklad ukazuje kontrolu formuláře s jednou položkou pro britské a české prostředí.

      
<form-validation>
  
  <global>
    <constant>
      <constant-name>zip</constant-name>
      <constant-value>^[\d|\w]{3}(\ )?[\d|\w]{3}$</constant-value>
    </constant>
  </global>
  
  <formset language="cs" country="CZ">
    <constant>
      <constant-name>zip</constant-name>
      <constant-value>^\d{3}(\ )?\d{2}$</constant-value>
    </constant>
    <form name="RegistrationForm">
      <field property="zip" depends="required,mask,minlength">
        <arg0 key="registration.zip"/>
        <arg1 name="minlength" key="${var:minlength}" resource="false"/>
        <msg  name="mask" key="registration.zip.invalid"/>
        <var>
          <var-name>minlength</var-name>
	  <var-value>5</var-value>
        </var>
        <var>
          <var-name>mask</var-name>
	  <var-value>${zip}</var-value>
        </var>
      </field>
    </form>
  </formset>

  <formset language="en" country="UK">
    <form name="RegistrationForm">
      <field property="zip" depends="required,mask,minlength">
        <arg0 key="registration.zip"/>
        <arg1 name="minlength" key="${var:minlength}" resource="false"/>
        <msg  name="mask" key="registration.zip.invalid"/>
        <var>
          <var-name>minlength</var-name>
	  <var-value>5</var-value>
        </var>
        <var>
          <var-name>mask</var-name>
	  <var-value>${zip}</var-value>
        </var>
      </field>
    </form>
  </formset>

</form-validation>

Příště

Probereme část Controller, konkrétně akce Struts.

Verze pro tisk

pridej.cz

 

DISKUZE

nepíše se standardní s D? 14.4.2005 06:57 Petr Šigut
  L Re: nepíše se standardní s D? 14.4.2005 10:27 Miroslav Holubec




Příspívat do diskuze mohou pouze registrovaní uživatelé.
> Vyhledávání software
> Vyhledávání článků

14.11.2017 16:56 /František Kučera
Máš rád svobodný software a hardware nebo se o nich chceš něco dozvědět? Zajímá tě DIY, CNC, SDR nebo morseovka? Přijď na sraz spolku OpenAlt – tradičně první čtvrtek před třetím pátkem v měsíci: 16. listopadu od 18:00 v Radegastovně Perón (Stroupežnického 20, Praha 5).
Přidat komentář

12.11.2017 11:06 /Redakce Linuxsoft.cz
PR: 4. ročník odborné IT konference na téma Datová centra pro business proběhne již ve čtvrtek 23. listopadu 2017 v konferenčním centru Vavruška, v paláci Charitas, Karlovo náměstí 5, Praha 2 (u metra Karlovo náměstí) od 9:00. Konference o návrhu, budování, správě a efektivním využívání datových center nabídne odpovědi na aktuální a často řešené otázky, např Jaké jsou aktuální trendy v oblasti datových center a jak je využít pro vlastní prospěch? Jak zajistit pro firmu či jinou organizaci odpovídající služby datových center? Podle jakých kritérií vybrat dodavatele služeb? Jak volit součásti infrastruktury při budování či rozšiřování vlastního datového centra? Jak efektivně spravovat datové centrum? Jak eliminovat možná rizika? apod.
Přidat komentář

13.9.2017 8:00 /František Kučera
Máš rád svobodný software a hardware nebo se o nich chceš něco dozvědět? Zajímá tě DIY, CNC, SDR nebo morseovka? Přijď na sraz spolku OpenAlt – tentokrát netradičně v pondělí: 18. září od 18:00 v Radegastovně Perón (Stroupežnického 20, Praha 5).
Přidat komentář

3.9.2017 20:45 /Redakce Linuxsoft.cz
PR: Dne 21. září 2017 proběhne v Praze konference "Mobilní řešení pro business". Hlavní tématy konference budou: nejnovější trendy v oblasti mobilních řešení pro firmy, efektivní využití mobilních zařízení, bezpečnostní rizika a řešení pro jejich omezení, správa mobilních zařízení ve firmách a další.
Přidat komentář

15.5.2017 23:50 /František Kučera
Máš rád svobodný software a hardware nebo se o nich chceš něco dozvědět? Zajímá tě DIY, CNC, SDR nebo morseovka? Přijď na sraz spolku OpenAlt, který se bude konat ve čtvrtek 18. května od 18:00 v Radegastovně Perón (Stroupežnického 20, Praha 5).
Přidat komentář

12.5.2017 16:42 /Honza Javorek
PyCon CZ, česká konference o programovacím jazyce Python, se po dvou úspěšných ročnících v Brně bude letos konat v Praze, a to 8. až 10. června. Na konferenci letos zavítá např. i Armin Ronacher, známý především jako autor frameworku Flask, šablon Jinja2/Twig, a dalších projektů. Těšit se můžete na přednášky o datové analytice, tvorbě webu, testování, tvorbě API, učení a mentorování programování, přednášky o rozvoji komunity, o použití Pythonu ve vědě nebo k ovládání nejrůznějších zařízení (MicroPython). Na vlastní prsty si můžete na workshopech vyzkoušet postavit Pythonem ovládaného robota, naučit se učit šestileté děti programovat, efektivně testovat nebo si v Pythonu pohrát s kartografickým materiálem. Kupujte lístky, dokud jsou.
Přidat komentář

2.5.2017 9:20 /Eva Rázgová
Putovní konference československé Drupal komunity "DrupalCamp Československo" se tentokrát koná 27. 5.2017 na VUT FIT v Brně. Můžete načerpat a vyměnit si zkušenosti z oblasti Drupalu 7 a 8, UX, SEO, managementu týmového vývoje, využití Dockeru pro Drupal a dalších. Vítáni jsou nováčci i experti. Akci pořádají Slovenská Drupal Asociácia a česká Asociace pro Drupal. Registrace na webu .
Přidat komentář

1.5.2017 20:31 /Pavel `Goldenfish' Kysilka
PR: 25.5.2017 proběhne v Praze konference na téma Firemní informační systémy. Hlavními tématy jsou: Informační systémy s vlastní inteligencí, efektivní práce s dokumenty, mobilní přístup k datům nebo využívání cloudu.
Přidat komentář

   Více ...   Přidat zprávičku

> Poslední diskuze

15.12.2017 15:11 / Petit
freehold nj

15.12.2017 15:06 / Petit
nj freehold

5.12.2017 11:50 / Thomas
kitchen renovations

18.9.2017 14:37 / Rojas
high security vault

15.9.2017 7:33 / Wilson
new zealand childcare jobs

Více ...

ISSN 1801-3805 | Provozovatel: Pavel Kysilka, IČ: 72868490 (2003-2017) | mail at linuxsoft dot cz | Design: www.megadesign.cz | Textová verze