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 8584×

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ů

4.10.2018 21:30 /Ondřej Čečák
LinuxDays 2018 již tento víkend, registrace je otevřená.
Přidat komentář

18.9.2018 23:30 /František Kučera
Zářijový pražský sraz spolku OpenAlt se koná již tento čtvrtek – 20. 9. 2018 od 18:00 v Radegastovně Perón (Stroupežnického 20, Praha 5). Tentokrát bez oficiální přednášky, ale zato s dobrým jídlem a pivem – volná diskuse na téma IoT, CNC, svobodný software, hardware a další hračky.
Přidat komentář

9.9.2018 14:15 /Redakce Linuxsoft.cz
20.9.2018 proběhne v pražském Kongresovém centru Vavruška konference Mobilní řešení pro business. Návštěvníci si vyslechnou mimo jiné přednášky na témata: Nejdůležitější aktuální trendy v oblasti mobilních technologií, správa a zabezpečení mobilních zařízení ve firmách, jak mobilně přistupovat k informačnímu systému firmy, kdy se vyplatí používat odolná mobilní zařízení nebo jak zabezpečit mobilní komunikaci.
Přidat komentář

12.8.2018 16:58 /František Kučera
Srpnový pražský sraz spolku OpenAlt se koná ve čtvrtek – 16. 8. 2018 od 19:00 v Kavárně Ideál (Sázavská 30, Praha), kde máme rezervovaný salonek. Tentokrát jsou tématem srazu databáze prezentaci svého projektu si pro nás připravil Standa Dzik. Dále bude prostor, abychom probrali nápady na využití IoT a sítě The Things Network, případně další témata.
Přidat komentář

16.7.2018 1:05 /František Kučera
Červencový pražský sraz spolku OpenAlt se koná již tento čtvrtek – 19. 7. 2018 od 18:00 v Kavárně Ideál (Sázavská 30, Praha), kde máme rezervovaný salonek. Tentokrát bude přednáška na téma: automatizační nástroj Ansible, kterou si připravil Martin Vicián.
Přidat komentář

18.6.2018 0:43 /František Kučera
Červnový pražský sraz spolku OpenAlt se koná již tento čtvrtek – 21. 6. 2018 od 18:00 v Kavárně Ideál (Sázavská 30, Praha), kde máme rezervovaný salonek. Tentokrát na téma: F-Droid, aneb svobodný software do vašeho mobilu. Kromě toho budou k vidění i vývojové desky HiFive1 se svobodným/otevřeným čipem RISC-V.
Přidat komentář

23.5.2018 20:55 /Ondřej Čečák
Od pátku 25.5. proběhne na Fakultě informačních technologií ČVUT v Praze openSUSE Conference. Můžete se těšit na spostu zajímavých přednášek, workshopů a také na Release Party nového openSUSE leap 15.0. V na stejném místě proběhne v sobotu 26.5. i seminář o bezpečnosti CryptoFest.
Přidat komentář

20.5.2018 17:45 /Redakce Linuxsoft.cz
Ve čtvrtek 31. května 2018 připravuje webový magazín BusinessIT ve spolupráci s Best Online Média s.r.o. pátý ročník odborné konference Firemní informační systémy 2018. Akce proběhne v kongresovém centru Vavruška (palác Charitas), Karlovo náměstí 5, Praha 2 (u metra Karlovo náměstí) od 9:00 hod. dopoledne do cca 15 hod. odpoledne. Konference je zaměřena na efektivní využití firemních informačních systémů a na to, jak plně využít jejich potenciál. Podrobnější informace na webových stránkách konfrence.
Přidat komentář

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

> Poslední diskuze

5.10.2018 17:12 / Jakub Kuljovsky
Re: Jaký kurz a software by jste doporučili pro začínajcího kodéra?

20.9.2018 10:04 / Jan Ober
Jaký kurz a software by jste doporučili pro začínajcího kodéra?

20.9.2018 10:00 / Jan Ober
Re: Gimp

20.2.2018 18:48 / Ivan Majer
portal

20.2.2018 15:57 / Jan Havel
Jak využíváte služby cloudu v podnikání?

Více ...

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