Obsah

Základy Seamu
Seam, Seam, Seam
Naše zkušenosti

.

Historie

autorem myšlenky a architektem je Gavin King (autor Hibernate)
2005
vyvíjí JBoss (divize RedHatu)
LGPL

Každým dnem vyjde Seam 2.0
Vyžaduje >= JDK 1.5
Funguje i s Tomcatem/Jetty

.

Gavinovi vadil stav frameworků a "nestavovost" webových aplikací

Co to je?

Integrační framework pro J2EE
- EJB
- JPA
- JSF
- JTA
- JMS
- JSP
- PDF
- ...
Kontexty & Komponenty
Dependency Injection (bijection)
...

.

Znáte ještě někdo nějakou zkratku na 3 písmena? NHL :-)
Inversion of Control (IoC)

Základy

komponenta
kontext
expression language (EL)

.

Komponenta

POJO / JavaBean
Deklarace komponenty anotacemi:
- @Name("componentName")
- @Scope(ScopeType.EVENT)
- @Startup
- @AutoCreate

V XML WEB-INF/components.xml

<component name="myComponent"  class="cz.softeu.MyComponent">
	<property name="name">Moje jméno</property>
	<property name="skupina">#{skupina}</property>
</component>

Contexts.getEventContext().put("nazev", new MyComponent())

jen JAR s seam.properties

.

Nemusíte implementovat žádné interface

Dependency Bijection

@In
- @In Session hibernateSession
- @In("#{messages['Hello']}") private String helloMessage;
- @In("componentName")
- @In(required=true, create=true)
@Out

.

Dependency Injection 2 :-)
@Out zveřejní komponentu pokud byla volána libovolná akce (tj. kromě getterů)
Kontexty se prohledávají hierarchicky (od nejkratšího)
Komponenty se automaticky nevytváří

Dependency Bijection 2

Spojení komponent:
- Dynamické
- Kontextuální
- Obousměrné
Forma 'aliasu' – lze z EVENT do SESSION
@Create – metoda volaná po naplnění závislostmi
@Interceptor(around={SomeInterceptor.class, OtherInterceptor.class})

.

Vytváří se PROXY
AOP
Lze používat komponenty i z kratšího kontextu. Při každém volání se může komponenta měnit
V době volání konstruktoru ještě nejsou komponenty navázané

@Factory

@Factory

@Name("loggedUser")
public class LoggedUser {
	@In(required=true)
	Long loggedUserId;
	
	@In
	Session hibernateSession;
	
	@Factory
	public User getLoggedUser() {
		return (User) hibernateSession.load(User.class, loggedUserId);
	}
}

<factory name="rootUrl" scope="EVENT" 
	value="#{facesContext.externalContext.requestContextPath}"/>

.

Umožňuje exportovat jako komponentu prvky i bez podpory Seamu resp. autor nemohl znát způsob použití

Kontext

METHOD
EVENT
PAGE
CONVERSATION
SESSION
APPLICATION
BUSINESS_PROCESS

.

Ovoce Durian

Bezstavová aplikace

Webové aplikace obvykle bezstavové – minimální stav
- HTTP Session – nutnost replikace, není řízeno transakčně
- Cookie
- Databáze
AJAX by neměl při každém požadavku přistupovat k DB
náročná obsluha optimistických transakcí

.

probrat body
Když mám stav, tak aplikace není bezstavová
Kontexty definované Servlet API neodpovídají realitě
Přístup k datům v session by měl být synchronizovaný

Komponentový model

vše je komponenta
HTTP Session – žádná explicitní obsluha
Persistence kontext je cache
Více typů kontextů

.

Konverzace

Kontext
Přes několik požadavků
Přirozená cache pro data
Odpovídá případu použití, soubor kliknutí
Život je řízen programově (@Begin(flush=FlushModeType.MANUAL), @End)

.

Persistence

Seam řídí transakce (dvě na request)
Podporuje:
- JTA (dvoufázový commit)
- ResourceLocal (JDBC)
- bez transakce
Optimistické transakce
Atomické konverzace
- Stav je zapsán až na konci konverzace
- Jen Hibernate (FLUSH)
@Transactional

.

bez transakce až od verze 2.0
FLUSH Nám umožní pracovat s objekty hibernate bez uložení do databáze

JPA

@Entity
public class User {
        @Id
        private long id;

        @NotNull
        @Length
        private String userName;

        private String fullName;
}

.

JPA Akce

@Name("userAction")		
public class UserAction {	
	@In
	Session hibernateSession;

	@RequestParameter
	Long id;

	public User getUser() {
		return (User) session.load(User.class, id);
	}
}

.

Expression Language

Expression Language je základem pro:
- Vazbu komponent a vlastností (property)
- Jazykové překlady
- Přístupová práva

User user = em.createQuery("from User where userName=#{loggedUser.userName}")
		.getSingleResult();

(String) new UnifiedELValueBinding("#{loggedUser.userName}")
		.getValue( FacesContext.getCurrentInstance() );

.

EL a tlačítka v diamondu

RESTful URL

PULL – metoda s @Factory
PUSH – akce spuštěné při vstupu na stránku
- index.page.xml: <page action="#{userList.beforeLoad}" />
- <param name="id" value="#{userHome.storedId}" />
@RequestParameter
Seam zajišťuje propagaci parametrů
- Používat <h:outputLink /> místo <a href="" />

.

Synchronizace

Seam synchronizuje přístup:
- k session komponentám
- ke konverzačním komponentám
Lze vynutit synchronizaci pomocí @Synchronized

.

Validace

Seam podporuje Hibernate Validation
Viz předchozí přednáška ...

.

Obsluha vyjímek

Anotace:

@Redirect(viewId="/failure.xhtml", end=true), message=“whatever”)‏
      @ApplicationException(rollback=true)‏
       public class UnrecoverableApplicationException { }

XML:

<exception class="org.jboss.seam.security.AuthorizationException">
	<end-conversation/>
	<redirect view-id="/error.xhtml">
    	<message severity="WARN">#{handledException.message}</message>
	</redirect>
</exception>

.

Bezpečnost

Dva režimy:
- Jednoduchý
- Rozšířené (Drools)
<h:outputText rendered="#{s:hasRole('admin')}" />
@Restrict
@Restrict("#{s:hasRole('admin')}")
#{s:hasPermission('skupina', 'akce', instance)}

.

Drools

rule CanUserDeleteCustomers
 when
    c: PermissionCheck(name == "customer", action == "delete")‏
    Role(name == "admin")‏
 then
    c.grant();
end;

.

E-Mail

<m:message xmlns:m="http://jboss.com/products/seam/mail">
    <m:from name="Seam" address="do-not-reply@jboss.com" />
    <m:to name="#{person.fullName}">#{person.address}</m:to>
    <m:subject>Plain text email sent by Seam</m:subject>
    <m:body type="plain">Dear #{person.firstname},

This is a simple, plain text, email.

Regards

JBoss Seam Mail</m:body>
</m:message>

@In Renderer renderer;
renderer.render("/html.xhtml");

.

Framework

"Snadné" CRUD

EntityHome:

<framework:entity-home name="personHome" entity-class="eg.Person" />

@Name("personHome")
public class PersonHome extends EntityHome<Person> {}

#{personHome.persist}

EntityQuery:

<framework:entity-query name="people" 
                        ejbql="select p from Person p"  
                        order="lastName" 
                        max-results="20"/>

.