streamalism.org

5. Annotaties

Laten we een paar handige annotaties bespreken die door Apache Tapestry worden geleverd voor dagelijks gebruik. In de toekomst zullen we deze annotaties gebruiken in onze implementaties.

5.1. @Injecteren

De @Injecteren annotatie is beschikbaar in de org.apache.tapestry5.ioc.annotaties pakket en biedt een gemakkelijke manier om afhankelijkheden in Java-klassen te injecteren.

Deze annotatie is best handig om een ​​asset, block, resource en service te injecteren.

5.2. @InjectPage

Verkrijgbaar in de org.apache.tapestry5.annotaties pakket, het @InjectPage annotatie stelt ons in staat om een ​​pagina in een andere component te injecteren. De geïnjecteerde pagina is ook altijd een alleen-lezen eigenschap.

5.3. @InjectComponent

Evenzo is het @InjectComponent annotatie stelt ons in staat om een ​​component te injecteren die in de sjabloon is gedefinieerd.

5.4. @Log

De @Log annotatie is beschikbaar in de org.apache.tapestry5.annotaties pakket en is handig om logboekregistratie op DEBUG-niveau op elke methode in te schakelen. Het registreert het invoeren en verlaten van de methode, samen met parameterwaarden.

5.5. @Eigendom

Verkrijgbaar in de org.apache.tapestry5.annotaties pakket, het @Eigendom annotatie markeert een veld als een eigenschap. Tegelijkertijd creëert het automatisch getters en setters voor het onroerend goed.

5.6. @Parameter

Evenzo is het @Parameter annotatie geeft aan dat een veld een componentparameter is.

6. Blz

Dus we zijn helemaal klaar om de basisfuncties van het framework te verkennen. Laten we een nieuw maken Huis pagina in onze app.

Eerst definiëren we een Java-klasse Huis in de Pagina's directory in src / main / java:

openbare les Home {}

6.1. Sjabloon

Vervolgens maken we een overeenkomstig Home.tml sjabloon in het Pagina's directory onder src / main / resources.

Een bestand met de extensie .tml (Tapestry Markup Language) is vergelijkbaar met een HTML / XHTML-bestand met XML-opmaak geleverd door Apache Tapestry.

Laten we bijvoorbeeld eens kijken naar de Home.tml sjabloon:

  apache-tapestry Home 

Voila! Door simpelweg de Jetty-server opnieuw op te starten, hebben we toegang tot het Huis pagina op localhost: 8080 / apache-tapestry / home:

6.2. Eigendom

Laten we eens kijken hoe we een eigenschap kunnen renderen op het Huis bladzijde.

Hiervoor voegen we een eigenschap en een getter-methode toe in de Huis klasse:

@Property private String appName = "apache-tapestry"; openbare datum getCurrentTime () {terugkeer nieuwe datum (); }

Om het applicatie naam eigendom op de Huis pagina, kunnen we gewoon gebruiken $ {appName}.

Evenzo kunnen we schrijven $ {currentTime} om toegang te krijgen tot het getCurrentTime methode van de pagina.

6.3. Lokalisatie

Apache Tapestry biedt geïntegreerde ondersteuning voor lokalisatie. Volgens afspraak houdt een eigenschappenbestand van een paginanaam de lijst bij van alle lokale berichten die op de pagina moeten worden weergegeven.

We maken bijvoorbeeld een home.properties bestand in het Pagina's directory voor de Huis pagina met een lokaal bericht:

introMsg = Welkom bij de Apache Tapestry Tutorial

De berichteigenschappen verschillen van de Java-eigenschappen.

Om dezelfde reden is de sleutelnaam met de bericht prefix wordt gebruikt om een ​​berichteigenschap weer te geven - bijvoorbeeld $ {bericht: introMsg}.

6.4. Lay-outcomponent

Laten we een basislay-outcomponent definiëren door de Layout.java klasse. We bewaren het bestand in het componenten directory in src / main / java:

openbare klasse Layout {@Property @Parameter (vereist = true, defaultPrefix = BindingConstants.LITERAL) private String-titel; }

Hier de titel eigenschap is gemarkeerd als vereist en het standaardvoorvoegsel voor binding is ingesteld als letterlijk Draad.

Vervolgens schrijven we een overeenkomstig sjabloonbestand Layout.tml in de componenten directory in src / main / resources:

  $ {title} 
© Uw bedrijf

Laten we nu de indeling op de huis bladzijde:

$ {bericht: introMsg}
$ {currentTime}

Let op, de naamruimte wordt gebruikt om de elementen (t: type en t: lichaam) geleverd door Apache Tapestry. Tegelijkertijd biedt de naamruimte ook componenten en attributen.

Hier de t: type zal de indeling op de huis bladzijde. En de t: lichaam element zal de inhoud van de pagina invoegen.

Laten we eens kijken naar de Huis pagina met de lay-out:

7. Vorm

Laten we een Log in pagina met een formulier, zodat gebruikers zich kunnen aanmelden.

Zoals al is onderzocht, maken we eerst een Java-klasse Log in:

openbare klasse Login {// ... @InjectComponent privé Formulier login; @Property private String e-mail; @Property privé String-wachtwoord; }

Hier hebben we twee eigenschappen gedefinieerd - e-mail en wachtwoord. We hebben ook een Het formulier component voor de login.

Laten we vervolgens een bijbehorend sjabloon maken login.tml:

Log in alstublieft

Nu hebben we toegang tot het Log in pagina op localhost: 8080 / apache-tapestry / login:

8. Validatie

Apache Tapestry biedt een aantal ingebouwde methoden voor formuliervalidatie. Het biedt ook manieren om het slagen of mislukken van de formulierinzending af te handelen.

De ingebouwde methode volgt de conventie van de gebeurtenis en de componentnaam. Bijvoorbeeld de methode onValidationFromLogin valideert het Log in component.

Evenzo methoden zoals onSuccessFromLogin en onFailureFromLogin zijn respectievelijk voor succes- en mislukkinggebeurtenissen.

Dus laten we deze ingebouwde methoden toevoegen aan het Log in klasse:

openbare klasse Login {// ... void onValidateFromLogin () {if (email == null) System.out.println ("E-mail is null); if (wachtwoord == null) System.out.println (" Wachtwoord is null ); } Object onSuccessFromLogin () {System.out.println ("Welkom! Inloggen succesvol"); terug naar Home.class; } void onFailureFromLogin () {System.out.println ("Probeer het opnieuw met de juiste inloggegevens"); }}

9. Waarschuwingen

Formuliervalidatie is onvolledig zonder de juiste waarschuwingen. Om nog maar te zwijgen, het framework heeft ook ingebouwde ondersteuning voor waarschuwingsberichten.

Hiervoor injecteren we eerst de instantie van de AlertManager in de Log in klasse om de waarschuwingen te beheren. Vervang vervolgens het println verklaringen in bestaande methoden met de waarschuwingsberichten:

openbare klasse Login {// ... @Inject privé AlertManager alertManager; void onValidateFromLogin () {if (email == null || wachtwoord == null) {alertManager.error ("E-mail / wachtwoord is null"); login.recordError ("Validatie mislukt"); // indieningsfout op het formulier}} Object onSuccessFromLogin () {alertManager.success ("Welkom! Inloggen succesvol"); terug naar Home.class; } void onFailureFromLogin () {alertManager.error ("Probeer het opnieuw met de juiste inloggegevens"); }}

Laten we de waarschuwingen in actie zien wanneer het inloggen mislukt:

10. Ajax

Tot nu toe hebben we de creatie van een simple huis pagina met een formulier. Tegelijkertijd hebben we de validaties en ondersteuning voor waarschuwingsberichten gezien.

Laten we vervolgens de ingebouwde ondersteuning van de Apache Tapestry voor Ajax bekijken.

Eerst injecteren we de instantie van de AjaxResponseRenderer en Blok component in de Huis klasse. Vervolgens maken we een methode onCallAjax voor het verwerken van de Ajax-oproep:

openbare klasse Home {// .... @Inject privé AjaxResponseRenderer ajaxResponseRenderer; @Inject privéblok ajaxBlock; @Log void onCallAjax () {ajaxResponseRenderer.addRender ("ajaxZone", ajaxBlock); }}

We moeten ook een paar wijzigingen aanbrengen in onze Home.tml.

Eerst voegen we de eventLink om het onCallAjax methode. Vervolgens voegen we een zone element met id ajaxZone om de Ajax-reactie weer te geven.

Als laatste hebben we een blokcomponent nodig die in het Huis klasse en weergegeven als Ajax-antwoord:

Bel Ajax
Weergegeven via Ajax
De huidige tijd is: $ {currentTime}

Laten we eens kijken naar de bijgewerkte huis bladzijde:

Vervolgens kunnen we op de knop Ajax bellen klikken en het ajaxResponseRenderer in actie:

11. Logboekregistratie

Om de ingebouwde logboekfunctie in te schakelen, moet de instantie van het Logger moet worden geïnjecteerd. Vervolgens kunnen we het gebruiken om in te loggen op elk niveau, zoals TRACE, DEBUG en INFO.

Laten we dus de vereiste wijzigingen aanbrengen in het Huis klasse:

openbare klasse Home {// ... @Inject private Logger-logger; void onCallAjax () {logger.info ("Ajax-oproep"); ajaxResponseRenderer.addRender ("ajaxZone", ajaxBlock); }}

Als we nu op de knop Ajax bellen klikken, wordt het logger logt in op het INFO-niveau:

[INFO] pagina's. Thuis Ajax bellen 

12. Conclusie

In dit artikel hebben we het webframework van Apache Tapestry verkend.

Om te beginnen hebben we een snelstartwebtoepassing gemaakt en een Huis pagina met basisfuncties van Apache Tapestry, zoals componenten, Pagina's, en Sjablonen.

Vervolgens hebben we enkele handige annotaties onderzocht die door Apache Tapestry worden geleverd om een ​​eigenschap en component / pagina-injectie te configureren.

Als laatste hebben we de ingebouwde ondersteuning voor Ajax en logboekregistratie door het framework onderzocht.

Zoals gewoonlijk zijn alle code-implementaties beschikbaar op GitHub.