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

> Apache Struts (4) - formuláře, modul Validator

Projdeme všechny typy formulářů a ukážeme si základní použití modulu Validator, který provádí kontrolu vstupních dat od uživatelů

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

Formuláře typu ActionForm

Téměř každá webová aplikace potřebuje získávat vstupy od uživatelů, např. uživatelská jména a hesla, uživatelské nastavení apod. HTML pro tyto potřeby poskytuje odpovídající prvky - textové pole, tlačítka, checkboxy a další. Struts všechen uživatelský vstup mapuje do vlastních formulářů, které jsou vždy podtřídou org.apache.struts.action.ActionForm a poskytují metody pro validaci vstupních dat, jejich předávání do akcí a jejich rušení. Jelikož je však ActionForm přímou součástí rámce, přičemž importuje balíky ze servletového API, není vhodné jeho přímé předávání do business vrstev. Obvyklé řešení je jeho zkopírování do DTO objektu pomocí BeanUtils a posléze již práce s daným DTO. Formulář Struts má následující rysy:

  • JavaBean - formulář má definované privátní členy a pro přístup k nim odpovídající veřejné metody
  • metoda reset() - ruší data ve formuláři
  • metoda validate() - kontroluje správnost dat

Jelikož Struts formuláře recyklují (pokud existuje stávající volná instance objektu, použije se), musí formulář definovat metodu reset(), která formulář vyčistí. Po tomto kroku dojde k naplnění formuláře vstupními daty, a posléze k jejich kontrole metodou validate(). Validace dat formuláře kontroluje správnost dat pouze na úrovni části VIEW, tedy že čísla jsou opravdu čísla, emailová adresa obsahuje zavináč apod. Následuje ukázka formuláře pro přihlašování uživatelů, v němž heslo musí být minimálně šestimístné číslo.

package cz.linuxsoft.web.struts.shop.forms;

import javax.servlet.http.HttpServletRequest;
import org.apache.struts.action.*;
import java.text.Format;
import java.text.NumberFormat;

public class LoginForm extends ActionForm {
    
    private String username = null;
    private String password = null;
    
    public void reset(ActionMapping      mapping,
                      HttpServletRequest request)
    {
        this.username = null;
        this.password = null;
    }
    
    public ActionErrors validate(ActionMapping      mapping, 
                                 HttpServletRequest request)
    {
        ActionErrors errors = new ActionErrors();
        if (username == null || username.length() < 1)
            errors.add("username",
	               new ActionMessage("errors.required", "User name"));
        if (password == null || password.length() < 1)
            errors.add("password",
	               new ActionMessage("errors.required", "Password"));
        else if (password.length() < 7)
            errors.add("password",
	               new ActionMessage("errors.minlength", "Password", "6"));
        else
        {
            try {
                Format format = NumberFormat.getNumberInstance();
                format.parseObject(password);
            } catch (Exception ex) {
                //heslo nelze převést na číslo
                errors.add("password",
		           new ActionMessage("errors.number", "Password"));
            }
        }
        return errors;
    }
    
    public void setUsername(String username) {
        this.username = username;
    }
    
    public void setPassword(String password) {
        this.password = password;
    }

    public String getUsername() {
        return this.username;
    }
    
    public String getPassword() {
        return this.password;
    }
}

Třída ActionErrors poskytuje účinný mechanismus předávání chybových zpráv zpět na stránku JSP, konkrétně do tagu <html:errors />. Jednotlivé zprávy se do ní přidávají metodou add(String klíč, ActionMessage zpráva), kde ActionMessage obsahuje sadu předdefinovaných konstruktorů, ve kterých první parametr představuje klíč ze souborů zdrojových svazků zpráv (MessagesResources) a další parametry jsou hodnoty předávané do klíče. Tímto dokáži účinně používat stávající položky zpráv a nemusím pro každou chybějící položku vytvářet vlastní zprávu. Odpovídající část z anglického souboru zdrojových svazků vypadá následovně:

errors.minlength={0} can not be less than {1} characters.
errors.required={0} is required.
errors.number={0} must be a number.

A k tomu ještě odpovídající konfigurační soubor Struts, pokud bychom ve formuláři nedefinovali metodu validate, parametr validate akce bychom změnili na false.

<form-beans>
  <form-bean
    name="loginForm"
    type="cz.linuxsoft.web.struts.shop.forms.LoginForm" />
</form-beans>
<action-mappings>
  <action
    path="/login"
    type="cz.linuxsoft.web.struts.shop.actions.LoginAction"
    name="loginForm"
    scope="request"
    input="/pages/login.jsp"
    validate="true">
      <forward name="success" path="/pages/welcome.jsp" />
  </action>
</action-mappings>

Formuláře typu DynaActionForm

Přes výhody, které nám přináší definování ActionFormů, existují i značné nevýhody tohoto řešení. Především v projektu vzniká značný počet jednoduchých tříd, které jenom kopírují DTO objekty. Dalším neduhem je, že ActionForm je svázán s HTML stránkou, jakákoliv její změna se tedy musí projevit i v této třídě. Proto se ve Struts v1.1 objevuje nový formulář dynamického typu, a to třída org.apache.struts.action.DynaActionForm. Celý formulář i s členy se definuje v konfiguračním souboru Struts, jak jsme již viděli v předminulém díle. Samozřejmě díky dynamickému charakteru tohoto formuláře nyní nelze provádět kontrolu dat metodou validate(), zde nastupuje modul Validator, který popíši dále. Formulář z minulé kapitoly by tedy vypadal takto:

<form-beans>
  <form-bean
    name="loginForm" 
    type="org.apache.struts.action.DynaActionForm">
      <form-property
        name="username"
        type="java.lang.String" />
      <form-property
        name="password"
        type="java.lang.Integer" />
  </form-bean>
</form-beans>

Formuláře typu LazyValidatorForm

Speciálním typem formuláře, který se objevuje od Struts v1.2.6 (zatím pouze development verze), je LazyValidatorForm. Tento formulář využívá nové třídy LazyBean, která jakožto součást BeanUtils, představuje "nafukovací" beanu, vytvářející si členy pouhým voláním metody set. Vlastností tohoto formuláře tedy je, že není nutné definovat žádné členy, vytvoří se automaticky za běhu přímo ze vstupních dat. Definice formuláře tedy vypadá takto:

<form-beans>
  <form-bean
    name="loginForm"
    type="org.apache.struts.validator.LazyValidatorForm" />
</form-beans>

Modul Validator

Jak jsme si již mohli všimnout, kontrolu uživatelských vstupů můžeme provádět přímo v potomcích ActionFormu. Tato možnost má však dost nevýhod, především dochází k silné opakovatelnosti kódu. Proto vznikl modul Validator, jenž přesouvá veškerou kontrolní logiku do speciálních xml souborů, přičemž přichází se spoustou již vytvořených standartních pravidel kontroly a zároveň nám dává možnost vytvořit vlastní pravidla založené na regulárních výrazech. Pokud chceme tento modul použít, musíme ho uvést do konfigurace Struts v části plugin. Následně všechny formuláře typu DynaActionForm, které chceme validovat, změníme na typ org.apache.struts.validator.DynaValidatorForm, to samé provedeme u formulářů typu ActionForm, kde změníme rodiče třídy na org.apache.struts.validator.ValidatorForm.

<form-beans>
  <form-bean
    name="loginForm"
    type="org.apache.struts.validator.DynaValidatorForm">
    <form-property
      name="username"
      type="java.lang.String" />
    <form-property
      name="password"
      type="java.lang.String" />
  </form-bean>
</form-beans>

<plug-in className="org.apache.struts.validator.ValidatorPlugIn">
  <set-property
    property="pathnames"
    value="/WEB-INF/validator-rules.xml,/WEB-INF/validation.xml" />
</plug-in>

Soubor validator-rules.xml obsahuje již zmiňované předdefinované pravidla, validation.xml je určen pro naše nastavení. Jednoduchá validace pro předchozí příklady by tedy odpovídala následujícímu souboru:

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE form-validation PUBLIC
 "-//Apache Software Foundation//DTD Commons Validator Rules Configuration 1.1.3//EN"
 "http://jakarta.apache.org/commons/dtds/validator_1_1_3.dtd">

<form-validation>
  <formset>
  
    <!-- jméno formuláře z konfigurace Struts -->
    <form name="loginForm">
    
      <!-- člen username je vyžadován -->
      <field property="username" depends="required">
        <!-- klíč z MessageResources -->
        <arg0 key="login.username"/>
      </field>
      
      <!-- člen password je vyžadován, musí to být číslo a mít minimální délku -->
      <field property="password" depends="required,integer,minlength">
        <!-- klíč z MessageResources -->
        <arg0 key="login.password"/>
        <!-- minimální délka, bere se z proměnných -->
        <arg1 name="minlength" key="${var:minlength}" resource="false"/>
        <!-- definice proměnných -->
	<var>
          <!-- proměnná pro minimální délku -->
	  <var-name>minlength</var-name>
	  <var-value>5</var-value>
	</var>
       </field>
       
    </form>
    
  </formset>
</form-validation>

Vidíme, že musíme definovat jednotlivé položky ve formuláři, přičemž pro každou položku je definován seznam pravidel parametrem depends. Argumenty zprávy jsou předávány podobně jako u ActionFormu, my pouze definujeme argumenty, které budou předány do hodnoty klíče. Pro položku můžeme definovat i seznam proměnných, v našem případě se jednalo o definici minimální délky řetězce. Validaci uživatelských vstupů můžeme rozdělit na validaci dat na serveru, což je standartní postup, a na kontrolu javascriptem, což je další možnost tohoto modulu. Pro standartní serverovou validaci není třeba nijak upravovat stávající jsp soubory, avšak při použití javascriptu je potřeba provést drobné změny. Nejprve si vytvoříme stránku javascript/static.jsp se statickou částí javascriptového kódu. Tento postup je vhodný vzhledem k poměru velikostí staticky a dynamicky generovaného kódu, přičemž při umístění statického javascriptu do speciálního souboru prohlížeč používá vyrovnávací paměť.

<%@ taglib uri="/tags/struts-html" prefix="html" %>

<html:javascript dynamicJavascript="false" staticJavascript="true" />

Následuje upravený soubor login.jsp, tučně jsou vyznačeny změny.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
    "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<%@ page contentType="text/html" %>
<%@ page pageEncoding="UTF-8" %>
<%@ taglib uri="/tags/struts-bean" prefix="bean" %>
<%@ taglib uri="/tags/struts-html" prefix="html" %>
<%@ taglib uri="/tags/struts-logic" prefix="logic" %>

<html:xhtml />
<html:html>
  <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
      <title><bean:message key="login.title" /></title>
      <link
        rel="stylesheet"
	type="text/css" 
	href="<html:rewrite page="/theme/style.css" />">
      <html:javascript
        formName="loginForm"
	dynamicJavascript="true"
	staticJavascript="false"
	cdata="false"/>
      <script
        type="text/javascript"
	src="<html:rewrite page="/javascript/static.jsp" />">
      </script>
  </head>
    <body>
        <h1><bean:message key="login.title" /></h1>
        <div class="errors">
        <html:errors />
        <br /><br />
        </div>
        <html:form
	  action="/login"
	  method="post"
	  onsubmit="return validateLoginForm(this);">
        <table>
            <tr>
	       <td><bean:message key="login.username" /></td>
	       <td>:</td>
	       <td><html:text property="username" value="" /></td>
            </tr>
            <tr>
	       <td><bean:message key="login.password" /></td>
	       <td>:</td>
	       <td><html:password property="password" value="" /></td>
	    </tr>
        </table>
        <p>
	  <html:submit>
	    <bean:message key="login.submit" />
	  </html:submit>
	</p>
        </html:form>
    </body>
</html:html>

Příště

Tímto jsme si probrali základní typy formulářů používaných ve Struts a seznámili se s velice užitečným modulem Validator. Příště probereme jeho rozšířené možnosti včetně definice vlastních kontrolních pravidel.

Verze pro tisk

pridej.cz

 

DISKUZE

Nejsou žádné diskuzní příspěvky u dané položky.



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