weld-commits December 2008

weld-commits@lists.jboss.org

1 participants
361 discussions

[webbeans-commits] Webbeans SVN: r604 - doc/trunk/reference/en/modules.

by webbeans-commits＠lists.jboss.org

Author: pete.muir(a)jboss.org Date: 2008-12-19 15:42:42 -0500 (Fri, 19 Dec 2008) New Revision: 604 Modified: doc/trunk/reference/en/modules/ri.xml Log: talk about jboss.home property in ref guide Modified: doc/trunk/reference/en/modules/ri.xml =================================================================== --- doc/trunk/reference/en/modules/ri.xml 2008-12-19 20:42:26 UTC (rev 603) +++ doc/trunk/reference/en/modules/ri.xml 2008-12-19 20:42:42 UTC (rev 604) @@ -29,7 +29,16 @@ <programlisting><![CDATA[$ cd ~/ $ unzip ~/webbeans-1.0.0.ALPHA1.zip]]></programlisting> + <para> + Next, we need to tell Web Beans where JBoss is located. Edit + <literal>jboss-as/build.properties</literal> and set the + <literal>jboss.home</literal> property. For example: + </para> + + <programlisting>jboss.home=/Applications/jboss-5.0.0.GA</programlisting> + + <para> As Web Beans is a new piece of software, you need to update JBoss AS to run the Web Beans RI. Future versions of JBoss AS will include these updates, and this step won't be necessary.

15 years, 6 months

1
0
0 / 0

[webbeans-commits] Webbeans SVN: r603 - ri/trunk/jboss-as.

by webbeans-commits＠lists.jboss.org

Author: pete.muir(a)jboss.org Date: 2008-12-19 15:42:26 -0500 (Fri, 19 Dec 2008) New Revision: 603 Modified: ri/trunk/jboss-as/build.properties Log: empty jboss.home by default Modified: ri/trunk/jboss-as/build.properties =================================================================== --- ri/trunk/jboss-as/build.properties 2008-12-19 20:31:50 UTC (rev 602) +++ ri/trunk/jboss-as/build.properties 2008-12-19 20:42:26 UTC (rev 603) @@ -1 +1 @@ -jboss.home=/Applications/jboss-5.0.0.GA +#jboss.home=/Applications/jboss-5.0.0.GA

15 years, 6 months

1
0
0 / 0

[webbeans-commits] Webbeans SVN: r602 - in doc/trunk/reference: en and 12 other directories.

by webbeans-commits＠lists.jboss.org

Author: pete.muir(a)jboss.org Date: 2008-12-19 15:31:50 -0500 (Fri, 19 Dec 2008) New Revision: 602 Added: doc/trunk/reference/en/Book_Info.xml doc/trunk/reference/es-ES/ doc/trunk/reference/es-ES/Book_Info.po doc/trunk/reference/es-ES/master.po doc/trunk/reference/es-ES/modules/ doc/trunk/reference/es-ES/modules/decorators.po doc/trunk/reference/es-ES/modules/ee.po doc/trunk/reference/es-ES/modules/events.po doc/trunk/reference/es-ES/modules/example.po doc/trunk/reference/es-ES/modules/extend.po doc/trunk/reference/es-ES/modules/injection.po doc/trunk/reference/es-ES/modules/interceptors.po doc/trunk/reference/es-ES/modules/intro.po doc/trunk/reference/es-ES/modules/next.po doc/trunk/reference/es-ES/modules/part1.po doc/trunk/reference/es-ES/modules/part2.po doc/trunk/reference/es-ES/modules/part3.po doc/trunk/reference/es-ES/modules/part4.po doc/trunk/reference/es-ES/modules/producermethods.po doc/trunk/reference/es-ES/modules/ri.po doc/trunk/reference/es-ES/modules/scopescontexts.po doc/trunk/reference/es-ES/modules/specialization.po doc/trunk/reference/es-ES/modules/stereotypes.po doc/trunk/reference/es-ES/modules/xml.po doc/trunk/reference/fr-FR/ doc/trunk/reference/fr-FR/Book_Info.po doc/trunk/reference/fr-FR/master.po doc/trunk/reference/fr-FR/modules/ doc/trunk/reference/fr-FR/modules/decorators.po doc/trunk/reference/fr-FR/modules/ee.po doc/trunk/reference/fr-FR/modules/events.po doc/trunk/reference/fr-FR/modules/example.po doc/trunk/reference/fr-FR/modules/extend.po doc/trunk/reference/fr-FR/modules/injection.po doc/trunk/reference/fr-FR/modules/interceptors.po doc/trunk/reference/fr-FR/modules/intro.po doc/trunk/reference/fr-FR/modules/next.po doc/trunk/reference/fr-FR/modules/part1.po doc/trunk/reference/fr-FR/modules/part2.po doc/trunk/reference/fr-FR/modules/part3.po doc/trunk/reference/fr-FR/modules/part4.po doc/trunk/reference/fr-FR/modules/producermethods.po doc/trunk/reference/fr-FR/modules/ri.po doc/trunk/reference/fr-FR/modules/scopescontexts.po doc/trunk/reference/fr-FR/modules/specialization.po doc/trunk/reference/fr-FR/modules/stereotypes.po doc/trunk/reference/fr-FR/modules/xml.po doc/trunk/reference/it-IT/ doc/trunk/reference/it-IT/Book_Info.po doc/trunk/reference/it-IT/master.po doc/trunk/reference/it-IT/modules/ doc/trunk/reference/it-IT/modules/decorators.po doc/trunk/reference/it-IT/modules/ee.po doc/trunk/reference/it-IT/modules/events.po doc/trunk/reference/it-IT/modules/example.po doc/trunk/reference/it-IT/modules/extend.po doc/trunk/reference/it-IT/modules/injection.po doc/trunk/reference/it-IT/modules/interceptors.po doc/trunk/reference/it-IT/modules/intro.po doc/trunk/reference/it-IT/modules/next.po doc/trunk/reference/it-IT/modules/part1.po doc/trunk/reference/it-IT/modules/part2.po doc/trunk/reference/it-IT/modules/part3.po doc/trunk/reference/it-IT/modules/part4.po doc/trunk/reference/it-IT/modules/producermethods.po doc/trunk/reference/it-IT/modules/ri.po doc/trunk/reference/it-IT/modules/scopescontexts.po doc/trunk/reference/it-IT/modules/specialization.po doc/trunk/reference/it-IT/modules/stereotypes.po doc/trunk/reference/it-IT/modules/xml.po doc/trunk/reference/ja-JP/ doc/trunk/reference/ja-JP/Book_Info.po doc/trunk/reference/ja-JP/master.po doc/trunk/reference/ja-JP/modules/ doc/trunk/reference/ja-JP/modules/decorators.po doc/trunk/reference/ja-JP/modules/ee.po doc/trunk/reference/ja-JP/modules/events.po doc/trunk/reference/ja-JP/modules/example.po doc/trunk/reference/ja-JP/modules/extend.po doc/trunk/reference/ja-JP/modules/injection.po doc/trunk/reference/ja-JP/modules/interceptors.po doc/trunk/reference/ja-JP/modules/intro.po doc/trunk/reference/ja-JP/modules/next.po doc/trunk/reference/ja-JP/modules/part1.po doc/trunk/reference/ja-JP/modules/part2.po doc/trunk/reference/ja-JP/modules/part3.po doc/trunk/reference/ja-JP/modules/part4.po doc/trunk/reference/ja-JP/modules/producermethods.po doc/trunk/reference/ja-JP/modules/ri.po doc/trunk/reference/ja-JP/modules/scopescontexts.po doc/trunk/reference/ja-JP/modules/specialization.po doc/trunk/reference/ja-JP/modules/stereotypes.po doc/trunk/reference/ja-JP/modules/xml.po doc/trunk/reference/pot/ doc/trunk/reference/pot/Book_Info.pot doc/trunk/reference/pot/master.pot doc/trunk/reference/pot/messages.mo doc/trunk/reference/pot/modules/ doc/trunk/reference/pot/modules/decorators.pot doc/trunk/reference/pot/modules/ee.pot doc/trunk/reference/pot/modules/events.pot doc/trunk/reference/pot/modules/example.pot doc/trunk/reference/pot/modules/extend.pot doc/trunk/reference/pot/modules/injection.pot doc/trunk/reference/pot/modules/interceptors.pot doc/trunk/reference/pot/modules/intro.pot doc/trunk/reference/pot/modules/next.pot doc/trunk/reference/pot/modules/part1.pot doc/trunk/reference/pot/modules/part2.pot doc/trunk/reference/pot/modules/part3.pot doc/trunk/reference/pot/modules/part4.pot doc/trunk/reference/pot/modules/producermethods.pot doc/trunk/reference/pot/modules/ri.pot doc/trunk/reference/pot/modules/scopescontexts.pot doc/trunk/reference/pot/modules/specialization.pot doc/trunk/reference/pot/modules/stereotypes.pot doc/trunk/reference/pot/modules/xml.pot doc/trunk/reference/zh-CN/ doc/trunk/reference/zh-CN/Book_Info.po doc/trunk/reference/zh-CN/master.po doc/trunk/reference/zh-CN/modules/ doc/trunk/reference/zh-CN/modules/decorators.po doc/trunk/reference/zh-CN/modules/ee.po doc/trunk/reference/zh-CN/modules/events.po doc/trunk/reference/zh-CN/modules/example.po doc/trunk/reference/zh-CN/modules/extend.po doc/trunk/reference/zh-CN/modules/injection.po doc/trunk/reference/zh-CN/modules/interceptors.po doc/trunk/reference/zh-CN/modules/intro.po doc/trunk/reference/zh-CN/modules/next.po doc/trunk/reference/zh-CN/modules/part1.po doc/trunk/reference/zh-CN/modules/part2.po doc/trunk/reference/zh-CN/modules/part3.po doc/trunk/reference/zh-CN/modules/part4.po doc/trunk/reference/zh-CN/modules/producermethods.po doc/trunk/reference/zh-CN/modules/ri.po doc/trunk/reference/zh-CN/modules/scopescontexts.po doc/trunk/reference/zh-CN/modules/specialization.po doc/trunk/reference/zh-CN/modules/stereotypes.po doc/trunk/reference/zh-CN/modules/xml.po Modified: doc/trunk/reference/Makefile doc/trunk/reference/en/master.xml Log: Add PO files for translations Modified: doc/trunk/reference/Makefile =================================================================== --- doc/trunk/reference/Makefile 2008-12-19 20:24:06 UTC (rev 601) +++ doc/trunk/reference/Makefile 2008-12-19 20:31:50 UTC (rev 602) @@ -2,7 +2,7 @@ #Created by Jeff Fearn <jfearn(a)redhat.com> #Copyright Red Hat Inc. 2006 -XML_LANG = en-US +XML_LANG = en DOCNAME = master.xml PRODUCT = WebBeansReferenceManual BRAND = JBoss Added: doc/trunk/reference/en/Book_Info.xml =================================================================== --- doc/trunk/reference/en/Book_Info.xml (rev 0) +++ doc/trunk/reference/en/Book_Info.xml 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,28 @@ +<?xml version='1.0' encoding="iso-8859-1"?> + +<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ ]> + +<bookinfo> + <title>Introduction to Web Beans</title> + <subtitle>The new Java standard for dependency injection and + contextual state management</subtitle> + <authorgroup> + <author> + <firstname>Gavin</firstname> + <surname>King</surname> + <affiliation> + <jobtitle>Web Beans (JSR-299) specification lead</jobtitle> + <orgname>Red Hat Middleware LLC</orgname> + + </affiliation> + </author> + <author> + <firstname>Pete</firstname> + <surname>Muir</surname> + <affiliation> + <jobtitle>Web Beans (JSR-299) Reference Implementation lead</jobtitle> + <orgname>Red Hat Middleware LLC</orgname> + </affiliation> + </author> + </authorgroup> +</bookinfo> Property changes on: doc/trunk/reference/en/Book_Info.xml ___________________________________________________________________ Name: svn:mime-type + text/plain Modified: doc/trunk/reference/en/master.xml =================================================================== --- doc/trunk/reference/en/master.xml 2008-12-19 20:24:06 UTC (rev 601) +++ doc/trunk/reference/en/master.xml 2008-12-19 20:31:50 UTC (rev 602) @@ -3,32 +3,9 @@ <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ ]> <book lang="en"> + + <xi:include href="Book_Info" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <bookinfo> - <title>Introduction to Web Beans</title> - <subtitle>The new Java standard for dependency injection and - contextual state management</subtitle> - <authorgroup> - <author> - <firstname>Gavin</firstname> - <surname>King</surname> - <affiliation> - <jobtitle>Web Beans (JSR-299) specification lead</jobtitle> - <orgname>Red Hat Middleware LLC</orgname> - - </affiliation> - </author> - <author> - <firstname>Pete</firstname> - <surname>Muir</surname> - <affiliation> - <jobtitle>Web Beans (JSR-299) Reference Implementation lead</jobtitle> - <orgname>Red Hat Middleware LLC</orgname> - </affiliation> - </author> - </authorgroup> - </bookinfo> - <toc/> <part> Added: doc/trunk/reference/es-ES/Book_Info.po =================================================================== --- doc/trunk/reference/es-ES/Book_Info.po (rev 0) +++ doc/trunk/reference/es-ES/Book_Info.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,56 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: 2008-12-19 20:29+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: Book_Info.xml:6 +#, no-c-format +msgid "Introduction to Web Beans" +msgstr "" + +#. Tag: subtitle +#: Book_Info.xml:7 +#, no-c-format +msgid "" +"The new Java standard for dependency injection and contextual state " +"management" +msgstr "" + +#. Tag: author +#: Book_Info.xml:10 +#, no-c-format +msgid "<firstname>Gavin</firstname> <surname>King</surname>" +msgstr "" + +#. Tag: affiliation +#: Book_Info.xml:13 +#, no-c-format +msgid "" +"<jobtitle>Web Beans (JSR-299) specification lead</jobtitle> <orgname>Red Hat " +"Middleware LLC</orgname>" +msgstr "" + +#. Tag: author +#: Book_Info.xml:19 +#, no-c-format +msgid "<firstname>Pete</firstname> <surname>Muir</surname>" +msgstr "" + +#. Tag: affiliation +#: Book_Info.xml:22 +#, no-c-format +msgid "" +"<jobtitle>Web Beans (JSR-299) Reference Implementation lead</jobtitle> " +"<orgname>Red Hat Middleware LLC</orgname>" +msgstr "" Added: doc/trunk/reference/es-ES/master.po =================================================================== --- doc/trunk/reference/es-ES/master.po (rev 0) +++ doc/trunk/reference/es-ES/master.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,38 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: master.xml:12 +#, no-c-format +msgid "Using contextual objects" +msgstr "" + +#. Tag: title +#: master.xml:25 +#, no-c-format +msgid "Developing loosely-coupled code" +msgstr "" + +#. Tag: title +#: master.xml:35 +#, no-c-format +msgid "Making the most of strong typing" +msgstr "" + +#. Tag: title +#: master.xml:46 +#, no-c-format +msgid "Web Beans and the Java EE ecosystem" +msgstr "" Added: doc/trunk/reference/es-ES/modules/decorators.po =================================================================== --- doc/trunk/reference/es-ES/modules/decorators.po (rev 0) +++ doc/trunk/reference/es-ES/modules/decorators.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,243 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: decorators.xml:4 +#, no-c-format +msgid "Decorators" +msgstr "" + +#. Tag: para +#: decorators.xml:6 +#, no-c-format +msgid "" +"Interceptors are a powerful way to capture and separate concerns which are " +"<emphasis>orthogonal</emphasis> to the type system. Any interceptor is able " +"to intercept invocations of any Java type. This makes them perfect for " +"solving technical concerns such as transaction management and security. " +"However, by nature, interceptors are unaware of the actual semantics of the " +"events they intercept. Thus, interceptors aren't an appropriate tool for " +"separating business-related concerns." +msgstr "" + +#. Tag: para +#: decorators.xml:14 +#, no-c-format +msgid "" +"The reverse is true of <emphasis>decorators</emphasis>. A decorator " +"intercepts invocations only for a certain Java interface, and is therefore " +"aware of all the semantics attached to that interface. This makes decorators " +"a perfect tool for modeling some kinds of business concerns. It also means " +"that a decorator doesn't have the generality of an interceptor. Decorators " +"aren't able to solve technical concerns that cut across many disparate types." +msgstr "" + +#. Tag: para +#: decorators.xml:22 +#, no-c-format +msgid "Suppose we have an interface that represents accounts:" +msgstr "" + +#. Tag: programlisting +#: decorators.xml:24 +#, no-c-format +msgid "" +"<![CDATA[public interface Account {\n" +" public BigDecimal getBalance();\n" +" public User getOwner();\n" +" public void withdraw(BigDecimal amount);\n" +" public void deposit(BigDecimal amount);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:26 +#, no-c-format +msgid "" +"Several different Web Beans in our system implement the <literal>Account</" +"literal> interface. However, we have a common legal requirement that, for " +"any kind of account, large transactions must be recorded by the system in a " +"special log. This is a perfect job for a decorator." +msgstr "" + +#. Tag: para +#: decorators.xml:32 +#, no-c-format +msgid "" +"A decorator is a simple Web Bean that implements the type it decorates and " +"is annotated <literal>@Decorator</literal>." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:35 +#, no-c-format +msgid "" +"<![CDATA[@Decorator\n" +"public abstract class LargeTransactionDecorator \n" +" implements Account {\n" +" \n" +" @Decorates Account account;\n" +" \n" +" @PersistenceContext EntityManager em;\n" +" \n" +" public void withdraw(BigDecimal amount) {\n" +" account.withdraw(amount);\n" +" if ( amount.compareTo(LARGE_AMOUNT)>0 ) {\n" +" em.persist( new LoggedWithdrawl(amount) );\n" +" }\n" +" }\n" +" \n" +" public void deposit(BigDecimal amount);\n" +" account.deposit(amount);\n" +" if ( amount.compareTo(LARGE_AMOUNT)>0 ) {\n" +" em.persist( new LoggedDeposit(amount) );\n" +" }\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:37 +#, no-c-format +msgid "" +"Unlike other simple Web Beans, a decorator may be an abstract class. If " +"there's nothing special the decorator needs to do for a particular method of " +"the decorated interface, you don't need to implement that method." +msgstr "" + +#. Tag: title +#: decorators.xml:43 +#, no-c-format +msgid "Delegate attributes" +msgstr "" + +#. Tag: para +#: decorators.xml:45 +#, no-c-format +msgid "" +"All decorators have a <emphasis>delegate attribute</emphasis>. The type and " +"binding types of the delegate attribute determine which Web Beans the " +"decorator is bound to. The delegate attribute type must implement or extend " +"all interfaces implemented by the decorator." +msgstr "" + +#. Tag: para +#: decorators.xml:50 +#, no-c-format +msgid "" +"This delegate attribute specifies that the decorator is bound to all Web " +"Beans that implement <literal>Account</literal>:" +msgstr "" + +#. Tag: programlisting +#: decorators.xml:53 +#, no-c-format +msgid "<![CDATA[@Decorates Account account;]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:55 +#, no-c-format +msgid "" +"A delegate attribute may specify a binding annotation. Then the decorator " +"will only be bound to Web Beans with the same binding." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:58 +#, no-c-format +msgid "<![CDATA[@Decorates @Foreign Account account;]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:60 +#, no-c-format +msgid "A decorator is bound to any Web Bean which:" +msgstr "" + +#. Tag: para +#: decorators.xml:64 +#, no-c-format +msgid "has the type of the delegate attribute as an API type, and" +msgstr "" + +#. Tag: para +#: decorators.xml:67 +#, no-c-format +msgid "has all binding types that are declared by the delegate attribute." +msgstr "" + +#. Tag: para +#: decorators.xml:71 +#, no-c-format +msgid "" +"The decorator may invoke the delegate attribute, which has much the same " +"effect as calling <literal>InvocationContext.proceed()</literal> from an " +"interceptor." +msgstr "" + +#. Tag: title +#: decorators.xml:78 +#, no-c-format +msgid "Enabling decorators" +msgstr "" + +#. Tag: para +#: decorators.xml:80 +#, no-c-format +msgid "" +"We need to <emphasis>enable</emphasis> our decorator in <literal>web-beans." +"xml</literal>." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:83 +#, no-c-format +msgid "" +"<![CDATA[<Decorators>\n" +" <myapp:LargeTransactionDecorator/>\n" +"</Decorators>]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:85 +#, no-c-format +msgid "" +"This declaration serves the same purpose for decorators that the " +"<literal><Interceptors></literal> declaration serves for interceptors:" +msgstr "" + +#. Tag: para +#: decorators.xml:90 +#, no-c-format +msgid "" +"it enables us to specify a total ordering for all decorators in our system, " +"ensuring deterministic behavior, and" +msgstr "" + +#. Tag: para +#: decorators.xml:94 +#, no-c-format +msgid "it lets us enable or disable decorator classes at deployment time." +msgstr "" + +#. Tag: para +#: decorators.xml:98 +#, no-c-format +msgid "" +"Interceptors for a method are called before decorators that apply to that " +"method." +msgstr "" Added: doc/trunk/reference/es-ES/modules/ee.po =================================================================== --- doc/trunk/reference/es-ES/modules/ee.po (rev 0) +++ doc/trunk/reference/es-ES/modules/ee.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,329 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: ee.xml:4 +#, no-c-format +msgid "Java EE integration" +msgstr "" + +#. Tag: para +#: ee.xml:6 +#, no-c-format +msgid "" +"Web Beans is fully integrated into the Java EE environment. Web Beans have " +"access to Java EE resources and JPA persistence contexts. They may be used " +"in Unified EL expressions in JSF and JSP pages. They may even be injected " +"into some objects, such as Servlets and Message-Driven Beans, which are not " +"Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:12 +#, no-c-format +msgid "Injecting Java EE resources into a Web Bean" +msgstr "" + +#. Tag: para +#: ee.xml:14 +#, no-c-format +msgid "" +"All simple and enterprise Web Beans may take advantage of Java EE dependency " +"injection using <literal>@Resource</literal>, <literal>@EJB</literal> and " +"<literal>@PersistenceContext</literal>. We've already seen a couple of " +"examples of this, though we didn't pay much attention at the time:" +msgstr "" + +#. Tag: programlisting +#: ee.xml:19 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +"\n" +" @Resource Transaction transaction;\n" +"\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: ee.xml:21 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped\n" +"public class Login {\n" +"\n" +" @Current Credentials credentials;\n" +" @PersistenceContext EntityManager userDatabase;\n" +" \n" +" ...\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: ee.xml:23 +#, no-c-format +msgid "" +"The Java EE <literal>@PostConstruct</literal> and <literal>@PreDestroy</" +"literal> callbacks are also supported for all simple and enterprise Web " +"Beans. The <literal>@PostConstruct</literal> method is called after " +"<emphasis>all</emphasis> injection has been performed." +msgstr "" + +#. Tag: para +#: ee.xml:28 +#, no-c-format +msgid "" +"There is one restriction to be aware of here: <literal>@PersistenceContext" +"(type=EXTENDED)</literal> is not supported for simple Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:35 +#, no-c-format +msgid "Calling a Web Bean from a Servlet" +msgstr "" + +#. Tag: para +#: ee.xml:37 +#, no-c-format +msgid "" +"It's easy to use a Web Bean from a Servlet in Java EE 6. Simply inject the " +"Web Bean using Web Beans field or initializer method injection." +msgstr "" + +#. Tag: programlisting +#: ee.xml:40 +#, no-c-format +msgid "" +"public class Login extends HttpServlet {\n" +"\n" +" @Current Credentials credentials;\n" +" @Current Login login;\n" +"\n" +" @Override\n" +" public void service(HttpServletRequest request, HttpServletResponse " +"response)\n" +" throws ServletException, IOException {\n" +" credentials.setUsername( request.getAttribute(\"username\") ):\n" +" credentials.setPassword( request.getAttribute(\"password\") ):\n" +" login.login();\n" +" if ( login.isLoggedIn() ) {\n" +" response.sendRedirect(\"/home.jsp\");\n" +" }\n" +" else {\n" +" response.sendRedirect(\"/loginError.jsp\");\n" +" }\n" +" }\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:42 +#, no-c-format +msgid "" +"The Web Beans client proxy takes care of routing method invocations from the " +"Servlet to the correct instances of <literal>Credentials</literal> and " +"<literal>Login</literal> for the current request and HTTP session." +msgstr "" + +#. Tag: title +#: ee.xml:49 +#, no-c-format +msgid "Calling a Web Bean from a Message-Driven Bean" +msgstr "" + +#. Tag: para +#: ee.xml:51 +#, no-c-format +msgid "" +"Web Beans injection applies to all EJBs, even when they aren't under the " +"control of the Web Bean manager (if they were obtained by direct JNDI " +"lookup, or injection using <literal>@EJB</literal>, for example. In " +"particular, you can use Web Beans injection in Message-Driven Beans, which " +"are not considered Web Beans because you can't inject them." +msgstr "" + +#. Tag: para +#: ee.xml:57 +#, no-c-format +msgid "" +"You can even use Web Beans interceptor bindings for Message-Driven Beans." +msgstr "" + +#. Tag: programlisting +#: ee.xml:59 +#, no-c-format +msgid "" +"@Transactional @MessageDriven\n" +"public class ProcessOrder implements MessageListener {\n" +"\n" +" @Current Inventory inventory;\n" +" @PersistenceContext EntityManager em;\n" +"\n" +" public void onMessage(Message message) {\n" +" ...\n" +" }\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:61 +#, no-c-format +msgid "" +"Thus, receiving messages is super-easy in a Web Beans environment. But " +"beware that there is no session or conversation context available when a " +"message is delivered to a Message-Driven Bean. Only <literal>@RequestScoped</" +"literal> and <literal>@ApplicationScoped</literal> Web Beans are available." +msgstr "" + +#. Tag: para +#: ee.xml:66 +#, no-c-format +msgid "It's also easy to send messages using Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:71 +#, no-c-format +msgid "JMS endpoints" +msgstr "" + +#. Tag: para +#: ee.xml:73 +#, no-c-format +msgid "" +"Sending messages using JMS can be quite complex, because of the number of " +"different objects you need to deal with. For queues we have <literal>Queue</" +"literal>, <literal>QueueConnectionFactory</literal>, " +"<literal>QueueConnection</literal>, <literal>QueueSession</literal> and " +"<literal>QueueSender</literal>. For topics we have <literal>Topic</literal>, " +"<literal>TopicConnectionFactory</literal>, <literal>TopicConnection</" +"literal>, <literal>TopicSession</literal> and <literal>TopicPublisher</" +"literal>. Each of these objects has its own lifecycle and threading model " +"that we need to worry about." +msgstr "" + +#. Tag: para +#: ee.xml:82 +#, no-c-format +msgid "" +"Web Beans takes care of all this for us. All we need to do is declare the " +"queue or topic in <literal>web-beans.xml</literal>, specifying an associated " +"binding type and connection factory." +msgstr "" + +#. Tag: programlisting +#: ee.xml:86 +#, no-c-format +msgid "" +"<![CDATA[<Queue>\n" +" <destination>java:comp/env/jms/OrderQueue</destination>\n" +" <connectionFactory>java:comp/env/jms/QueueConnectionFactory</" +"connectionFactory>\n" +" <myapp:OrderProcessor/> \n" +"</Queue>]]>" +msgstr "" + +#. Tag: programlisting +#: ee.xml:88 +#, no-c-format +msgid "" +"<![CDATA[<Topic>\n" +" <destination>java:comp/env/jms/StockPrices</destination>\n" +" <connectionFactory>java:comp/env/jms/TopicConnectionFactory</" +"connectionFactory>\n" +" <myapp:StockPrices/> \n" +"</Topic>]]>" +msgstr "" + +#. Tag: para +#: ee.xml:90 +#, no-c-format +msgid "" +"Now we can just inject the <literal>Queue</literal>, " +"<literal>QueueConnection</literal>, <literal>QueueSession</literal> or " +"<literal>QueueSender</literal> for a queue, or the <literal>Topic</literal>, " +"<literal>TopicConnection</literal>, <literal>TopicSession</literal> or " +"<literal>TopicPublisher</literal> for a topic." +msgstr "" + +#. Tag: programlisting +#: ee.xml:96 +#, no-c-format +msgid "" +"@OrderProcessor QueueSender orderSender;\n" +"@OrderProcessor QueueSession orderSession;\n" +"\n" +"public void sendMessage() {\n" +" MapMessage msg = orderSession.createMapMessage();\n" +" ...\n" +" orderSender.send(msg);\n" +"}" +msgstr "" + +#. Tag: programlisting +#: ee.xml:98 +#, no-c-format +msgid "" +"@StockPrices TopicPublisher pricePublisher;\n" +"@StockPrices TopicSession priceSession;\n" +"\n" +"public void sendMessage(String price) {\n" +" pricePublisher.send( priceSession.createTextMessage(price) );\n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:100 +#, no-c-format +msgid "" +"The lifecycle of the injected JMS objects are completely controlled by the " +"Web Bean manager." +msgstr "" + +#. Tag: title +#: ee.xml:106 +#, no-c-format +msgid "Packaging and deployment" +msgstr "" + +#. Tag: para +#: ee.xml:108 +#, no-c-format +msgid "" +"Web Beans doesn't define any special deployment archive. You can package Web " +"Beans in JARs, EJB-JARs or WARsany deployment location in the " +"application classpath. However, each archive that contains Web Beans must " +"include a file named <literal>web-beans.xml</literal> in the <literal>META-" +"INF</literal> or <literal>WEB-INF</literal> directory. The file may be " +"empty. Web Beans deployed in archives that do not have a <literal>web-beans." +"xml</literal> file will not be available for use in the application." +msgstr "" + +#. Tag: para +#: ee.xml:116 +#, no-c-format +msgid "" +"For Java SE execution, Web Beans may be deployed in any location in which " +"EJBs may be deployed for execution by the embeddable EJB Lite container. " +"Again, each location must contain a <literal>web-beans.xml</literal> file." +msgstr "" Added: doc/trunk/reference/es-ES/modules/events.po =================================================================== --- doc/trunk/reference/es-ES/modules/events.po (rev 0) +++ doc/trunk/reference/es-ES/modules/events.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,649 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: events.xml:4 +#, no-c-format +msgid "Events" +msgstr "" + +#. Tag: para +#: events.xml:6 +#, no-c-format +msgid "" +"The Web Beans event notification facility allows Web Beans to interact in a " +"totally decoupled manner. Event <emphasis>producers</emphasis> raise events " +"that are then delivered to event <emphasis>observers</emphasis> by the Web " +"Bean manager. This basic schema might sound like the familiar observer/" +"observable pattern, but there are a couple of twists:" +msgstr "" + +#. Tag: para +#: events.xml:14 +#, no-c-format +msgid "" +"not only are event producers decoupled from observers; observers are " +"completely decoupled from producers," +msgstr "" + +#. Tag: para +#: events.xml:18 +#, no-c-format +msgid "" +"observers can specify a combination of \"selectors\" to narrow the set of " +"event notifications they will receive, and" +msgstr "" + +#. Tag: para +#: events.xml:22 +#, no-c-format +msgid "" +"observers can be notified immediately, or can specify that delivery of the " +"event should be delayed until the end of the current transaction" +msgstr "" + +#. Tag: title +#: events.xml:28 +#, no-c-format +msgid "Event observers" +msgstr "" + +#. Tag: para +#: events.xml:30 +#, no-c-format +msgid "" +"An <emphasis>observer method</emphasis> is a method of a Web Bean with a " +"parameter annotated <literal>@Observes</literal>." +msgstr "" + +#. Tag: programlisting +#: events.xml:33 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyDocumentEvent(@Observes Document document) " +"{ ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:35 +#, no-c-format +msgid "" +"The annotated parameter is called the <emphasis>event parameter</emphasis>. " +"The type of the event parameter is the observed <emphasis>event type</" +"emphasis>. Observer methods may also specify \"selectors\", which are just " +"instances of Web Beans binding types. When a binding type is used as an " +"event selector, it is called an <emphasis>event binding type</emphasis>." +msgstr "" + +#. Tag: programlisting +#: events.xml:41 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Target({PARAMETER, FIELD})\n" +"@Retention(RUNTIME)\n" +"public @interface Updated { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:43 +#, no-c-format +msgid "" +"We specify the event bindings of the observer method by annotating the event " +"parameter:" +msgstr "" + +#. Tag: programlisting +#: events.xml:46 events.xml:190 +#, no-c-format +msgid "" +"<![CDATA[public void afterDocumentUpdate(@Observes @Updated Document " +"document) { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:48 +#, no-c-format +msgid "" +"An observer method need not specify any event bindingsin this case it " +"is interested in <emphasis>all</emphasis> events of a particular type. If it " +"does specify event bindings, it is only interested in events which also have " +"those event bindings." +msgstr "" + +#. Tag: para +#: events.xml:53 +#, no-c-format +msgid "" +"The observer method may have additional parameters, which are injected " +"according to the usual Web Beans method parameter injection semantics:" +msgstr "" + +#. Tag: programlisting +#: events.xml:56 +#, no-c-format +msgid "" +"<![CDATA[public void afterDocumentUpdate(@Observes @Updated Document " +"document, User user) { ... }]]>" +msgstr "" + +#. Tag: title +#: events.xml:61 +#, no-c-format +msgid "Event producers" +msgstr "" + +#. Tag: para +#: events.xml:63 +#, no-c-format +msgid "" +"The event producer may obtain an <emphasis>event notifier</emphasis> object " +"by injection:" +msgstr "" + +#. Tag: programlisting +#: events.xml:66 +#, no-c-format +msgid "<![CDATA[@Observable Event<Document> documentEvent]]>" +msgstr "" + +#. Tag: para +#: events.xml:68 +#, no-c-format +msgid "" +"The <literal>@Observable</literal> annotation implicitly defines a Web Bean " +"with scope <literal>@Dependent</literal> and deployment type " +"<literal>@Standard</literal>, with an implementation provided by the Web " +"Bean manager." +msgstr "" + +#. Tag: para +#: events.xml:72 +#, no-c-format +msgid "" +"A producer raises events by calling the <literal>fire()</literal> method of " +"the <literal>Event</literal> interface, passing an <emphasis>event object</" +"emphasis>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:75 +#, no-c-format +msgid "<![CDATA[documentEvent.fire(document);]]>" +msgstr "" + +#. Tag: para +#: events.xml:77 +#, no-c-format +msgid "" +"An event object may be an instance of any Java class that has no type " +"variables or wildcard type parameters. The event will be delivered to every " +"observer method that:" +msgstr "" + +#. Tag: para +#: events.xml:83 events.xml:107 events.xml:126 +#, no-c-format +msgid "has an event parameter to which the event object is assignable, and" +msgstr "" + +#. Tag: para +#: events.xml:86 +#, no-c-format +msgid "specifies no event bindings." +msgstr "" + +#. Tag: para +#: events.xml:90 +#, no-c-format +msgid "" +"The Web Bean manager simply calls all the observer methods, passing the " +"event object as the value of the event parameter. If any observer method " +"throws an exception, the Web Bean manager stops calling observer methods, " +"and the exception is rethrown by the <literal>fire()</literal> method." +msgstr "" + +#. Tag: para +#: events.xml:95 +#, no-c-format +msgid "" +"To specify a \"selector\", the event producer may pass an instance of the " +"event binding type to the <literal>fire()</literal> method:" +msgstr "" + +#. Tag: programlisting +#: events.xml:98 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.fire( document, new AnnotationLiteral<Updated>()" +"{} );]]>" +msgstr "" + +#. Tag: para +#: events.xml:100 +#, no-c-format +msgid "" +"The helper class <literal>AnnotationLiteral</literal> makes it possible to " +"instantiate binding types inline, since this is otherwise difficult to do in " +"Java." +msgstr "" + +#. Tag: para +#: events.xml:103 +#, no-c-format +msgid "The event will be delivered to every observer method that:" +msgstr "" + +#. Tag: para +#: events.xml:110 +#, no-c-format +msgid "" +"does not specify any event binding <emphasis>except</emphasis> for the event " +"bindings passed to <literal>fire()</literal>." +msgstr "" + +#. Tag: para +#: events.xml:115 +#, no-c-format +msgid "" +"Alternatively, event bindings may be specified by annotating the event " +"notifier injection point:" +msgstr "" + +#. Tag: programlisting +#: events.xml:118 +#, no-c-format +msgid "<![CDATA[@Observable @Updated Event<Document> documentUpdatedEvent]]>" +msgstr "" + +#. Tag: para +#: events.xml:120 +#, no-c-format +msgid "" +"Then every event fired via this instance of <literal>Event</literal> has the " +"annotated event binding. The event will be delivered to every observer " +"method that:" +msgstr "" + +#. Tag: para +#: events.xml:129 +#, no-c-format +msgid "" +"does not specify any event binding <emphasis>except</emphasis> for the event " +"bindings passed to <literal>fire()</literal> or the annotated event bindings " +"of the event notifier injection point." +msgstr "" + +#. Tag: title +#: events.xml:138 +#, no-c-format +msgid "Registering observers dynamically" +msgstr "" + +#. Tag: para +#: events.xml:140 +#, no-c-format +msgid "" +"It's often useful to register an event observer dynamically. The application " +"may implement the <literal>Observer</literal> interface and register an " +"instance with an event notifier by calling the <literal>observe()</literal> " +"method." +msgstr "" + +#. Tag: programlisting +#: events.xml:144 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.observe( new Observer<Document>() { public void notify" +"(Document doc) { ... } } );]]>" +msgstr "" + +#. Tag: para +#: events.xml:146 +#, no-c-format +msgid "" +"Event binding types may be specified by the event notifier injection point " +"or by passing event binding type instances to the <literal>observe()</" +"literal> method:" +msgstr "" + +#. Tag: programlisting +#: events.xml:149 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.observe( new Observer<Document>() { public void notify" +"(Document doc) { ... } }, \n" +" new " +"AnnotationLiteral<Updated>(){} );]]>" +msgstr "" + +#. Tag: title +#: events.xml:154 +#, no-c-format +msgid "Event bindings with members" +msgstr "" + +#. Tag: para +#: events.xml:156 +#, no-c-format +msgid "An event binding type may have annotation members:" +msgstr "" + +#. Tag: programlisting +#: events.xml:158 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Target({PARAMETER, FIELD})\n" +"@Retention(RUNTIME)\n" +"public @interface Role {\n" +" RoleType value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:160 +#, no-c-format +msgid "" +"The member value is used to narrow the messages delivered to the observer:" +msgstr "" + +#. Tag: programlisting +#: events.xml:162 +#, no-c-format +msgid "" +"<![CDATA[public void adminLoggedIn(@Observes @Role(ADMIN) LoggedIn event) " +"{ ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:164 +#, no-c-format +msgid "" +"Event binding type members may be specified statically by the event " +"producer, via annotations at the event notifier injection point:" +msgstr "" + +#. Tag: programlisting +#: events.xml:167 +#, no-c-format +msgid "<![CDATA[@Observable @Role(ADMIN) Event<LoggedIn> LoggedInEvent;}}]]>" +msgstr "" + +#. Tag: para +#: events.xml:169 +#, no-c-format +msgid "" +"Alternatively, the value of the event binding type member may be determined " +"dynamically by the event producer. We start by writing an abstract subclass " +"of <literal>AnnotationLiteral</literal>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:172 +#, no-c-format +msgid "" +"<![CDATA[abstract class RoleBinding \n" +" extends AnnotationLiteral<Role> \n" +" implements Role {}]]>" +msgstr "" + +#. Tag: para +#: events.xml:174 +#, no-c-format +msgid "" +"The event producer passes an instance of this class to <literal>fire()</" +"literal>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:176 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.fire( document, new RoleBinding() { public void value" +"() { return user.getRole(); } } );]]>" +msgstr "" + +#. Tag: title +#: events.xml:181 +#, no-c-format +msgid "Multiple event bindings" +msgstr "" + +#. Tag: para +#: events.xml:183 +#, no-c-format +msgid "Event binding types may be combined, for example:" +msgstr "" + +#. Tag: programlisting +#: events.xml:185 +#, no-c-format +msgid "" +"<![CDATA[@Observable @Blog Event<Document> blogEvent;\n" +"...\n" +"if (document.isBlog()) blogEvent.fire(document, new " +"AnnotationLiteral<Updated>(){});]]>" +msgstr "" + +#. Tag: para +#: events.xml:187 +#, no-c-format +msgid "" +"When this event occurs, all of the following observer methods will be " +"notified:" +msgstr "" + +#. Tag: programlisting +#: events.xml:189 +#, no-c-format +msgid "" +"<![CDATA[public void afterBlogUpdate(@Observes @Updated @Blog Document " +"document) { ... }]]>" +msgstr "" + +#. Tag: programlisting +#: events.xml:191 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyBlogEvent(@Observes @Blog Document document) " +"{ ... }]]>" +msgstr "" + +#. Tag: programlisting +#: events.xml:192 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyDocumentEvent(@Observes Document document) " +"{ ... }}}]]>" +msgstr "" + +#. Tag: title +#: events.xml:197 +#, no-c-format +msgid "Transactional observers" +msgstr "" + +#. Tag: para +#: events.xml:199 +#, no-c-format +msgid "" +"Transactional observers receive their event notifications during the before " +"or after completion phase of the transaction in which the event was raised. " +"For example, the following observer method needs to refresh a query result " +"set that is cached in the application context, but only when transactions " +"that update the <literal>Category</literal> tree succeed:" +msgstr "" + +#. Tag: programlisting +#: events.xml:205 +#, no-c-format +msgid "" +"<![CDATA[public void refreshCategoryTree(@AfterTransactionSuccess @Observes " +"CategoryUpdateEvent event) { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:207 +#, no-c-format +msgid "There are three kinds of transactional observers:" +msgstr "" + +#. Tag: para +#: events.xml:211 +#, no-c-format +msgid "" +"<literal>@AfterTransactionSuccess</literal> observers are called during the " +"after completion phase of the transaction, but only if the transaction " +"completes successfully" +msgstr "" + +#. Tag: para +#: events.xml:216 +#, no-c-format +msgid "" +"<literal>@AfterTransactionFailure</literal> observers are called during the " +"after completion phase of the transaction, but only if the transaction fails " +"to complete successfully" +msgstr "" + +#. Tag: para +#: events.xml:221 +#, no-c-format +msgid "" +"<literal>@AfterTransactionCompletion</literal> observers are called during " +"the after completion phase of the transaction" +msgstr "" + +#. Tag: para +#: events.xml:225 +#, no-c-format +msgid "" +"<literal>@BeforeTransactionCompletion</literal> observers are called during " +"the before completion phase of the transaction" +msgstr "" + +#. Tag: para +#: events.xml:230 +#, no-c-format +msgid "" +"Transactional observers are very important in a stateful object model like " +"Web Beans, because state is often held for longer than a single atomic " +"transaction." +msgstr "" + +#. Tag: para +#: events.xml:233 +#, no-c-format +msgid "" +"Imagine that we have cached a JPA query result set in the application scope:" +msgstr "" + +#. Tag: programlisting +#: events.xml:235 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Singleton\n" +"public class Catalog {\n" +"\n" +" @PersistenceContext EntityManager em;\n" +" \n" +" List<Product> products;\n" +"\n" +" @Produces @Catalog \n" +" List<Product> getCatalog() {\n" +" if (products==null) {\n" +" products = em.createQuery(\"select p from Product p where p." +"deleted = false\")\n" +" .getResultList();\n" +" }\n" +" return products;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:237 +#, no-c-format +msgid "" +"From time to time, a <literal>Product</literal> is created or deleted. When " +"this occurs, we need to refresh the <literal>Product</literal> catalog. But " +"we should wait until <emphasis>after</emphasis> the transaction completes " +"successfully before performing this refresh!" +msgstr "" + +#. Tag: para +#: events.xml:242 +#, no-c-format +msgid "" +"The Web Bean that creates and deletes <literal>Product</literal>s could " +"raise events, for example:" +msgstr "" + +#. Tag: programlisting +#: events.xml:245 +#, no-c-format +msgid "" +"<![CDATA[@Stateless\n" +"public class ProductManager {\n" +"\n" +" @PersistenceContext EntityManager em;\n" +" @Observable Event<Product> productEvent;\n" +"\n" +" public void delete(Product product) {\n" +" em.delete(product);\n" +" productEvent.fire(product, new AnnotationLiteral<Deleted>(){});\n" +" }\n" +" \n" +" public void persist(Product product) {\n" +" em.persist(product);\n" +" productEvent.fire(product, new AnnotationLiteral<Created>(){});\n" +" }\n" +" \n" +" ...\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:247 +#, no-c-format +msgid "" +"And now <literal>Catalog</literal> can observe the events after successful " +"completion of the transaction:" +msgstr "" + +#. Tag: programlisting +#: events.xml:250 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Singleton\n" +"public class Catalog {\n" +"\n" +" ...\n" +" \n" +" void addProduct(@AfterTransactionSuccess @Observes @Created Product " +"product) {\n" +" products.add(product);\n" +" }\n" +" \n" +" void addProduct(@AfterTransactionSuccess @Observes @Deleted Product " +"product) {\n" +" products.remove(product);\n" +" }\n" +" \n" +"}]]>" +msgstr "" Added: doc/trunk/reference/es-ES/modules/example.po =================================================================== --- doc/trunk/reference/es-ES/modules/example.po (rev 0) +++ doc/trunk/reference/es-ES/modules/example.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,172 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: example.xml:4 +#, no-c-format +msgid "JSF web application example" +msgstr "" + +#. Tag: para +#: example.xml:6 +#, no-c-format +msgid "" +"Let's illustrate these ideas with a full example. We're going to implement " +"user login/logout for an application that uses JSF. First, we'll define a " +"Web Bean to hold the username and password entered during login:" +msgstr "" + +#. Tag: programlisting +#: example.xml:11 +#, no-c-format +msgid "" +"<![CDATA[@Named\n" +"public class Credentials {\n" +" \n" +" private String username;\n" +" private String password;\n" +" \n" +" public String getUsername() { return username; }\n" +" public void setUsername(String username) { this.username = username; }\n" +" \n" +" public String getPassword() { return password; }\n" +" public void setPassword(String password) { this.password = password; }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:13 +#, no-c-format +msgid "This Web Bean is bound to the login prompt in the following JSF form:" +msgstr "" + +#. Tag: programlisting +#: example.xml:15 +#, no-c-format +msgid "" +"<![CDATA[<f:form>\n" +" <h:panelGrid columns=\"2\" rendered=\"#{!login.loggedIn}\">\n" +" <h:outputLabel for=\"username\">Username:</h:outputLabel>\n" +" <h:inputText id=\"username\" value=\"#{credentials.username}\"/>\n" +" <h:outputLabel for=\"password\">Password:</h:outputLabel>\n" +" <h:inputText id=\"password\" value=\"#{credentials.password}\"/>\n" +" </h:panelGrid>\n" +" <h:commandButton value=\"Login\" action=\"#{login.login}\" rendered=\"#{!" +"login.loggedIn}\"/>\n" +" <h:commandButton value=\"Logout\" acion=\"#{login.logout}\" rendered=\"#" +"{login.loggedIn}\"/>\n" +"</f:form]]>" +msgstr "" + +#. Tag: para +#: example.xml:17 +#, no-c-format +msgid "" +"The actual work is done by a session scoped Web Bean that maintains " +"information about the currently logged-in user and exposes the " +"<literal>User</literal> entity to other Web Beans:" +msgstr "" + +#. Tag: programlisting +#: example.xml:21 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named\n" +"public class Login {\n" +"\n" +" @Current Credentials credentials;\n" +" @PersistenceContext EntityManager userDatabase;\n" +"\n" +" private User user;\n" +" \n" +" public void login() {\n" +" \n" +" List<User> results = userDatabase.createQuery(\n" +" \"select u from User u where u.username=:username and u.password=:" +"password\")\n" +" .setParameter(\"username\", credentials.getUsername())\n" +" .setParameter(\"password\", credentials.getPassword())\n" +" .getResultList();\n" +" \n" +" if ( !results.isEmpty() ) {\n" +" user = results.get(0);\n" +" }\n" +" \n" +" }\n" +" \n" +" public void logout() {\n" +" user = null;\n" +" }\n" +" \n" +" public boolean isLoggedIn() {\n" +" return user!=null;\n" +" }\n" +" \n" +" @Produces @LoggedIn User getCurrentUser() {\n" +" return user;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:23 +#, no-c-format +msgid "Of course, <literal>@LoggedIn</literal> is a binding annotation:" +msgstr "" + +#. Tag: programlisting +#: example.xml:25 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD})\n" +"@BindingType\n" +"public @interface LoggedIn {}]]>" +msgstr "" + +#. Tag: para +#: example.xml:27 +#, no-c-format +msgid "Now, any other Web Bean can easily inject the current user:" +msgstr "" + +#. Tag: programlisting +#: example.xml:29 +#, no-c-format +msgid "" +"<![CDATA[public class DocumentEditor {\n" +"\n" +" @Current Document document;\n" +" @LoggedIn User currentUser;\n" +" @PersistenceContext EntityManager docDatabase;\n" +" \n" +" public void save() {\n" +" document.setCreatedBy(currentUser);\n" +" docDatabase.persist(document);\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:31 +#, no-c-format +msgid "" +"Hopefully, this example gives a flavor of the Web Bean programming model. In " +"the next chapter, we'll explore Web Beans dependency injection in greater " +"depth." +msgstr "" Added: doc/trunk/reference/es-ES/modules/extend.po =================================================================== --- doc/trunk/reference/es-ES/modules/extend.po (rev 0) +++ doc/trunk/reference/es-ES/modules/extend.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,252 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: extend.xml:4 +#, no-c-format +msgid "Extending Web Beans" +msgstr "" + +#. Tag: para +#: extend.xml:6 +#, no-c-format +msgid "" +"Web Beans is intended to be a platform for frameworks, extensions and " +"integration with other technologies. Therefore, Web Beans exposes a set of " +"SPIs for the use of developers of portable extensions to Web Beans. For " +"example, the following kinds of extensions were envisaged by the designers " +"of Web Beans:" +msgstr "" + +#. Tag: para +#: extend.xml:14 +#, no-c-format +msgid "integration with Business Process Management engines," +msgstr "" + +#. Tag: para +#: extend.xml:17 +#, no-c-format +msgid "" +"integration with third-party frameworks such as Spring, Seam, GWT or Wicket, " +"and" +msgstr "" + +#. Tag: para +#: extend.xml:21 +#, no-c-format +msgid "new technology based upon the Web Beans programming model." +msgstr "" + +#. Tag: para +#: extend.xml:25 +#, no-c-format +msgid "" +"The nerve center for extending Web Beans is the <literal>Manager</literal> " +"object." +msgstr "" + +#. Tag: title +#: extend.xml:29 +#, no-c-format +msgid "The <literal>Manager</literal> object" +msgstr "" + +#. Tag: para +#: extend.xml:31 +#, no-c-format +msgid "" +"The <literal>Manager</literal> interface lets us register and obtain Web " +"Beans, interceptors, decorators, observers and contexts programatically." +msgstr "" + +#. Tag: programlisting +#: extend.xml:34 +#, no-c-format +msgid "" +"<![CDATA[public interface Manager\n" +"{\n" +"\n" +" public <T> Set<Bean<T>> resolveByType(Class<T> type, Annotation... " +"bindings);\n" +"\n" +" public <T> Set<Bean<T>> resolveByType(TypeLiteral<T> apiType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> T getInstanceByType(Class<T> type, Annotation... bindings);\n" +"\n" +" public <T> T getInstanceByType(TypeLiteral<T> type,\n" +" Annotation... bindings);\n" +"\n" +" public Set<Bean<?>> resolveByName(String name);\n" +"\n" +" public Object getInstanceByName(String name);\n" +"\n" +" public <T> T getInstance(Bean<T> bean);\n" +"\n" +" public void fireEvent(Object event, Annotation... bindings);\n" +"\n" +" public Context getContext(Class<? extends Annotation> scopeType);\n" +"\n" +" public Manager addContext(Context context);\n" +"\n" +" public Manager addBean(Bean<?> bean);\n" +"\n" +" public Manager addInterceptor(Interceptor interceptor);\n" +"\n" +" public Manager addDecorator(Decorator decorator);\n" +"\n" +" public <T> Manager addObserver(Observer<T> observer, Class<T> eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager addObserver(Observer<T> observer, TypeLiteral<T> " +"eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager removeObserver(Observer<T> observer, Class<T> " +"eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager removeObserver(Observer<T> observer,\n" +" TypeLiteral<T> eventType, Annotation... bindings);\n" +"\n" +" public <T> Set<Observer<T>> resolveObservers(T event, Annotation... " +"bindings);\n" +"\n" +" public List<Interceptor> resolveInterceptors(InterceptionType type,\n" +" Annotation... interceptorBindings);\n" +"\n" +" public List<Decorator> resolveDecorators(Set<Class<?>> types,\n" +" Annotation... bindings);\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: extend.xml:36 +#, no-c-format +msgid "We can obtain an instance of <literal>Manager</literal> via injection:" +msgstr "" + +#. Tag: programlisting +#: extend.xml:38 +#, no-c-format +msgid "@Current Manager manager" +msgstr "" + +#. Tag: title +#: extend.xml:43 +#, no-c-format +msgid "The <literal>Bean</literal> class" +msgstr "" + +#. Tag: para +#: extend.xml:45 +#, no-c-format +msgid "" +"Instances of the abstract class <literal>Bean</literal> represent Web Beans. " +"There is an instance of <literal>Bean</literal> registered with the " +"<literal>Manager</literal> object for every Web Bean in the application." +msgstr "" + +#. Tag: programlisting +#: extend.xml:50 +#, no-c-format +msgid "" +"public abstract class Bean<T> {\n" +" \n" +" private final Manager manager;\n" +" \n" +" protected Bean(Manager manager) {\n" +" this.manager=manager;\n" +" }\n" +" \n" +" protected Manager getManager() {\n" +" return manager;\n" +" }\n" +" \n" +" public abstract Set<Class> getTypes();\n" +" public abstract Set<Annotation> getBindingTypes();\n" +" public abstract Class<? extends Annotation> getScopeType();\n" +" public abstract Class<? extends Annotation> getDeploymentType(); \n" +" public abstract String getName();\n" +" \n" +" public abstract boolean isSerializable();\n" +" public abstract boolean isNullable();\n" +"\n" +" public abstract T create();\n" +" public abstract void destroy(T instance);\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: extend.xml:52 +#, no-c-format +msgid "" +"It's possible to extend the <literal>Bean</literal> class and register " +"instances by calling <literal>Manager.addBean()</literal> to provide support " +"for new kinds of Web Beans, beyond those defined by the Web Beans " +"specification (simple and enterprise Web Beans, producer methods and JMS " +"endpoints). For example, we could use the <literal>Bean</literal> class to " +"allow objects managed by another framework to be injected into Web Beans." +msgstr "" + +#. Tag: para +#: extend.xml:60 +#, no-c-format +msgid "" +"There are two subclasses of <literal>Bean</literal> defined by the Web Beans " +"specification: <literal>Interceptor</literal> and <literal>Decorator</" +"literal>." +msgstr "" + +#. Tag: title +#: extend.xml:67 +#, no-c-format +msgid "The <literal>Context</literal> interface" +msgstr "" + +#. Tag: para +#: extend.xml:69 +#, no-c-format +msgid "" +"The <literal>Context</literal> interface supports addition of new scopes to " +"Web Beans, or extension of the built-in scopes to new environments." +msgstr "" + +#. Tag: programlisting +#: extend.xml:72 +#, no-c-format +msgid "" +"public interface Context {\n" +" \n" +" public Class<? extends Annotation> getScopeType();\n" +" \n" +" public <T> T get(Bean<T> bean, boolean create);\n" +" \n" +" boolean isActive();\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: extend.xml:74 +#, no-c-format +msgid "" +"For example, we might implement <literal>Context</literal> to add a business " +"process scope to Web Beans, or to add support for the conversation scope to " +"an application that uses Wicket." +msgstr "" Added: doc/trunk/reference/es-ES/modules/injection.po =================================================================== --- doc/trunk/reference/es-ES/modules/injection.po (rev 0) +++ doc/trunk/reference/es-ES/modules/injection.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,1226 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: injection.xml:4 +#, no-c-format +msgid "Dependency injection" +msgstr "" + +#. Tag: para +#: injection.xml:6 +#, no-c-format +msgid "Web Beans supports three primary mechanisms for dependency injection:" +msgstr "" + +#. Tag: para +#: injection.xml:8 +#, no-c-format +msgid "Constructor parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:10 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +" \n" +" private final ShoppingCart cart;\n" +" \n" +" @Initializer\n" +" public Checkout(ShoppingCart cart) {\n" +" this.cart = cart;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:12 +#, no-c-format +msgid "<emphasis>Initializer</emphasis> method parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:14 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +" \n" +" private ShoppingCart cart;\n" +"\n" +" @Initializer \n" +" void setShoppingCart(ShoppingCart cart) {\n" +" this.cart = cart;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:16 +#, no-c-format +msgid "And direct field injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:18 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +"\n" +" private @Current ShoppingCart cart;\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:20 +#, no-c-format +msgid "" +"Dependency injection always occurs when the Web Bean instance is first " +"instantiated." +msgstr "" + +#. Tag: para +#: injection.xml:25 +#, no-c-format +msgid "" +"First, the Web Bean manager calls the Web Bean constructor, to obtain an " +"instance of the Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:29 +#, no-c-format +msgid "" +"Next, the Web Bean manager initializes the values of all injected fields of " +"the Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:33 +#, no-c-format +msgid "Next, the Web Bean manager calls all initializer methods of Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:37 +#, no-c-format +msgid "" +"Finally, the <literal>@PostConstruct</literal> method of the Web Bean, if " +"any, is called." +msgstr "" + +#. Tag: para +#: injection.xml:42 +#, no-c-format +msgid "" +"Constructor parameter injection is not supported for EJB beans, since the " +"EJB is instantiated by the EJB container, not the Web Bean manager." +msgstr "" + +#. Tag: para +#: injection.xml:45 +#, no-c-format +msgid "" +"Parameters of constructors and initializer methods need not be explicitly " +"annotated when the default binding type <literal>@Current</literal> applies. " +"Injected fields, however, <emphasis>must</emphasis> specify a binding type, " +"even when the default binding type applies. If the field does not specify a " +"binding type, it will not be injected." +msgstr "" + +#. Tag: para +#: injection.xml:51 +#, no-c-format +msgid "Producer methods also support parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:53 +#, no-c-format +msgid "" +"<![CDATA[@Produces Checkout createCheckout(ShoppingCart cart) {\n" +" return new Checkout(cart);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:55 +#, no-c-format +msgid "" +"Finally, observer methods (which we'll meet in <xref linkend=\"events\"/>), " +"disposal methods and destructor methods all support parameter injection." +msgstr "" + +#. Tag: para +#: injection.xml:58 +#, no-c-format +msgid "" +"The Web Beans specification defines a procedure, called the " +"<emphasis>typesafe resolution algorithm</emphasis>, that the Web Bean " +"manager follows when identifying the Web Bean to inject to an injection " +"point. This algorithm looks complex at first, but once you understand it, " +"it's really quite intuitive. Typesafe resolution is performed at system " +"initialization time, which means that the manager will inform the user " +"immediately if a Web Bean's dependencies cannot be satisfied, by throwing a " +"<literal>UnsatisfiedDependencyException</literal> or " +"<literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:67 +#, no-c-format +msgid "" +"The purpose of this algorithm is to allow multiple Web Beans to implement " +"the same API type and either:" +msgstr "" + +#. Tag: para +#: injection.xml:72 +#, no-c-format +msgid "" +"allow the client to select which implementation it requires using " +"<emphasis>binding annotations</emphasis>," +msgstr "" + +#. Tag: para +#: injection.xml:77 +#, no-c-format +msgid "" +"allow the application deployer to select which implementation is appropriate " +"for a particular deployment, without changes to the client, by enabling or " +"disabling <emphasis>deployment types</emphasis>, or" +msgstr "" + +#. Tag: para +#: injection.xml:82 +#, no-c-format +msgid "" +"allow one implementation of an API to override another implementation of the " +"same API at deployment time, without changes to the client, using " +"<emphasis>deployment type precedence</emphasis>." +msgstr "" + +#. Tag: para +#: injection.xml:88 +#, no-c-format +msgid "" +"Let's explore how the Web Beans manager determines a Web Bean to be injected." +msgstr "" + +#. Tag: title +#: injection.xml:91 +#, no-c-format +msgid "Binding annotations" +msgstr "" + +#. Tag: para +#: injection.xml:93 +#, no-c-format +msgid "" +"If we have more than one Web Bean that implements a particular API type, the " +"injection point can specify exactly which Web Bean should be injected using " +"a binding annotation. For example, there might be two implementations of " +"<literal>PaymentProcessor</literal>:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:98 +#, no-c-format +msgid "" +"<![CDATA[@PayByCheque\n" +"public class ChequePaymentProcessor implements PaymentProcessor {\n" +" public void process(Payment payment) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:100 +#, no-c-format +msgid "" +"<![CDATA[@PayByCreditCard\n" +"public class CreditCardPaymentProcessor implements PaymentProcessor {\n" +" public void process(Payment payment) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:102 +#, no-c-format +msgid "" +"Where <literal>@PayByCheque</literal> and <literal>@PayByCreditCard</" +"literal> are binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:105 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayByCheque {}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:107 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayByCreditCard {}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:109 +#, no-c-format +msgid "" +"A client Web Bean developer uses the binding annotation to specify exactly " +"which Web Bean should be injected." +msgstr "" + +#. Tag: para +#: injection.xml:112 +#, no-c-format +msgid "Using field injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:114 +#, no-c-format +msgid "" +"<![CDATA[@PayByCheque PaymentProcessor chequePaymentProcessor;\n" +"@PayByCreditCard PaymentProcessor creditCardPaymentProcessor;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:116 +#, no-c-format +msgid "Using initializer method injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:118 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public void setPaymentProcessors(@PayByCheque PaymentProcessor " +"chequePaymentProcessor, \n" +" @PayByCreditCard PaymentProcessor " +"creditCardPaymentProcessor) {\n" +" this.chequePaymentProcessor = chequePaymentProcessor;\n" +" this.creditCardPaymentProcessor = creditCardPaymentProcessor;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:120 +#, no-c-format +msgid "Or using constructor injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:122 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public Checkout(@PayByCheque PaymentProcessor chequePaymentProcessor, \n" +" @PayByCreditCard PaymentProcessor " +"creditCardPaymentProcessor) {\n" +" this.chequePaymentProcessor = chequePaymentProcessor;\n" +" this.creditCardPaymentProcessor = creditCardPaymentProcessor;\n" +"}]]>" +msgstr "" + +#. Tag: title +#: injection.xml:125 +#, no-c-format +msgid "Binding annotations with members" +msgstr "" + +#. Tag: para +#: injection.xml:127 +#, no-c-format +msgid "Binding annotations may have members:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:129 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayBy {\n" +" PaymentType value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:131 +#, no-c-format +msgid "In which case, the member value is significant:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:133 +#, no-c-format +msgid "" +"<![CDATA[@PayBy(CHEQUE) PaymentProcessor chequePaymentProcessor;\n" +"@PayBy(CREDIT_CARD) PaymentProcessor creditCardPaymentProcessor;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:135 +#, no-c-format +msgid "" +"You can tell the Web Bean manager to ignore a member of a binding annotation " +"type by annotating the member <literal>@NonBinding</literal>." +msgstr "" + +#. Tag: title +#: injection.xml:141 +#, no-c-format +msgid "Combinations of binding annnotations" +msgstr "" + +#. Tag: para +#: injection.xml:143 +#, no-c-format +msgid "An injection point may even specify multiple binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:145 +#, no-c-format +msgid "" +"<![CDATA[@Asynchronous @PayByCheque PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: injection.xml:147 +#, no-c-format +msgid "" +"In this case, only a Web Bean which has <emphasis>both</emphasis> binding " +"annotations would be eligible for injection." +msgstr "" + +#. Tag: title +#: injection.xml:153 +#, no-c-format +msgid "Binding annotations and producer methods" +msgstr "" + +#. Tag: para +#: injection.xml:155 +#, no-c-format +msgid "Even producer methods may specify binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:157 +#, no-c-format +msgid "" +"<![CDATA[@Produces \n" +"@Asynchronous @PayByCheque \n" +"PaymentProcessor createAsyncPaymentProcessor(@PayByCheque PaymentProcessor " +"processor) {\n" +" return new AsynchronousPaymentProcessor(processor);\n" +"}]]>" +msgstr "" + +#. Tag: title +#: injection.xml:162 +#, no-c-format +msgid "The default binding type" +msgstr "" + +#. Tag: para +#: injection.xml:164 +#, no-c-format +msgid "" +"Web Beans defines a binding type <literal>@Current</literal> that is the " +"default binding type for any injection point or Web Bean that does not " +"explicitly specify a binding type." +msgstr "" + +#. Tag: para +#: injection.xml:168 +#, no-c-format +msgid "" +"There are two common circumstances in which it is necessary to explicitly " +"specify <literal>@Current</literal>:" +msgstr "" + +#. Tag: para +#: injection.xml:173 +#, no-c-format +msgid "" +"on a field, in order to declare it as an injected field with the default " +"binding type, and" +msgstr "" + +#. Tag: para +#: injection.xml:177 +#, no-c-format +msgid "" +"on a Web Bean which has another binding type in addition to the default " +"binding type." +msgstr "" + +#. Tag: title +#: injection.xml:187 +#, no-c-format +msgid "Deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:189 +#, no-c-format +msgid "" +"All Web Beans have a <emphasis>deployment type</emphasis>. Each deployment " +"type identifies a set of Web Beans that should be conditionally installed in " +"some deployments of the system." +msgstr "" + +#. Tag: para +#: injection.xml:193 +#, no-c-format +msgid "" +"For example, we could define a deployment type named <literal>@Mock</" +"literal>, which would identify Web Beans that should only be installed when " +"the system executes inside an integration testing environment:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:197 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +" @Target({TYPE, METHOD})\n" +" @DeploymentType\n" +" public @interface Mock {}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:199 +#, no-c-format +msgid "" +"Suppose we had some Web Bean that interacted with an external system to " +"process payments:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:202 +#, no-c-format +msgid "" +"<![CDATA[public class ExternalPaymentProcessor {\n" +" \n" +" public void process(Payment p) {\n" +" ...\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:204 +#, no-c-format +msgid "" +"Since this Web Bean does not explicitly specify a deployment type, it has " +"the default deployment type <literal>@Production</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:207 +#, no-c-format +msgid "" +"For integration or unit testing, the external system is slow or unavailable. " +"So we would create a mock object:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:210 +#, no-c-format +msgid "" +"<![CDATA[@Mock \n" +"public class MockPaymentProcessor implements PaymentProcessor {\n" +"\n" +" @Override\n" +" public void process(Payment p) {\n" +" p.setSuccessful(true);\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:212 +#, no-c-format +msgid "" +"But how does the Web Bean manager determine which implementation to use in a " +"particular deployment?" +msgstr "" + +#. Tag: title +#: injection.xml:216 +#, no-c-format +msgid "Enabling deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:218 +#, no-c-format +msgid "" +"Web Beans defines two built-in deployment types: <literal>@Production</" +"literal> and <literal>@Standard</literal>. By default, only Web Beans with " +"the built-in deployment types are enabled when the system is deployed. We " +"can identify additional deployment types to be enabled in a particular " +"deployment by listing them in <literal>web-beans.xml</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:224 +#, no-c-format +msgid "" +"Going back to our example, when we deploy our integration tests, we want all " +"our <literal>@Mock</literal> objects to be installed:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:227 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans>\n" +" <Deploy>\n" +" <Standard/>\n" +" <Production/>\n" +" <test:Mock/>\n" +" </Deploy>\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: injection.xml:229 +#, no-c-format +msgid "" +"Now the Web Bean manager will identify and install all Web Beans annotated " +"<literal>@Production</literal>, <literal>@Standard</literal> or " +"<literal>@Mock</literal> at deployment time." +msgstr "" + +#. Tag: para +#: injection.xml:233 +#, no-c-format +msgid "" +"The deployment type <literal>@Standard</literal> is used only for certain " +"special Web Beans defined by the Web Beans specification. We can't use it " +"for our own Web Beans, and we can't disable it." +msgstr "" + +#. Tag: para +#: injection.xml:237 +#, no-c-format +msgid "" +"The deployment type <literal>@Production</literal> is the default deployment " +"type for Web Beans which don't explicitly declare a deployment type, and may " +"be disabled." +msgstr "" + +#. Tag: title +#: injection.xml:244 +#, no-c-format +msgid "Deployment type precedence" +msgstr "" + +#. Tag: para +#: injection.xml:246 +#, no-c-format +msgid "" +"If you've been paying attention, you're probably wondering how the Web Bean " +"manager decides which implementation<literal>ExternalPaymentProcessor</" +"literal> or <literal>MockPaymentProcessor</literal>to choose. Consider " +"what happens when the manager encounters this injection point:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:251 +#, no-c-format +msgid "<![CDATA[@Current PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: injection.xml:253 +#, no-c-format +msgid "" +"There are now two Web Beans which satisfy the <literal>PaymentProcessor</" +"literal> contract. Of course, we can't use a binding annotation to " +"disambiguate, since binding annotations are hard-coded into the source at " +"the injection point, and we want the manager to be able to decide at " +"deployment time!" +msgstr "" + +#. Tag: para +#: injection.xml:258 +#, no-c-format +msgid "" +"The solution to this problem is that each deployment type has a different " +"<emphasis>precedence</emphasis>. The precedence of the deployment types is " +"determined by the order in which they appear in <literal>web-beans.xml</" +"literal>. In our example, <literal>@Mock</literal> appears later than " +"<literal>@Production</literal> so it has a higher precedence." +msgstr "" + +#. Tag: para +#: injection.xml:264 +#, no-c-format +msgid "" +"Whenever the manager discovers that more than one Web Bean could satisfy the " +"contract (API type plus binding annotations) specified by an injection " +"point, it considers the relative precedence of the Web Beans. If one has a " +"higher precedence than the others, it chooses the higher precedence Web Bean " +"to inject. So, in our example, the Web Bean manager will inject " +"<literal>MockPaymentProcessor</literal> when executing in our integration " +"testing environment (which is exactly what we want)." +msgstr "" + +#. Tag: para +#: injection.xml:271 +#, no-c-format +msgid "" +"It's interesting to compare this facility to today's popular manager " +"architectures. Various \"lightweight\" containers also allow conditional " +"deployment of classes that exist in the classpath, but the classes that are " +"to be deployed must be explicity, individually, listed in configuration code " +"or in some XML configuration file. Web Beans does support Web Bean " +"definition and configuration via XML, but in the common case where no " +"complex configuration is required, deployment types allow a whole set of Web " +"Beans to be enabled with a single line of XML. Meanwhile, a developer " +"browsing the code can easily identify what deployment scenarios the Web Bean " +"will be used in." +msgstr "" + +#. Tag: title +#: injection.xml:284 +#, no-c-format +msgid "Example deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:286 +#, no-c-format +msgid "" +"Deployment types are useful for all kinds of things, here's some examples:" +msgstr "" + +#. Tag: para +#: injection.xml:290 +#, no-c-format +msgid "" +"<literal>@Mock</literal> and <literal>@Staging</literal> deployment types " +"for testing" +msgstr "" + +#. Tag: para +#: injection.xml:294 +#, no-c-format +msgid "<literal>@AustralianTaxLaw</literal> for site-specific Web Beans" +msgstr "" + +#. Tag: para +#: injection.xml:297 +#, no-c-format +msgid "" +"<literal>@SeamFramework</literal>, <literal>@Guice</literal> for third-party " +"frameworks which build on Web Beans" +msgstr "" + +#. Tag: para +#: injection.xml:301 +#, no-c-format +msgid "" +"<literal>@Standard</literal> for standard Web Beans defined by the Web Beans " +"specification" +msgstr "" + +#. Tag: para +#: injection.xml:306 +#, no-c-format +msgid "I'm sure you can think of more applications..." +msgstr "" + +#. Tag: title +#: injection.xml:313 +#, no-c-format +msgid "Fixing unsatisfied dependencies" +msgstr "" + +#. Tag: para +#: injection.xml:315 +#, no-c-format +msgid "" +"The typesafe resolution algorithm fails when, after considering the binding " +"annotations and and deployment types of all Web Beans that implement the API " +"type of an injection point, the Web Bean manager is unable to identify " +"exactly one Web Bean to inject." +msgstr "" + +#. Tag: para +#: injection.xml:320 +#, no-c-format +msgid "" +"It's usually easy to fix an <literal>UnsatisfiedDependencyException</" +"literal> or <literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:323 +#, no-c-format +msgid "" +"To fix an <literal>UnsatisfiedDependencyException</literal>, simply provide " +"a Web Bean which implements the API type and has the binding types of the " +"injection pointor enable the deployment type of a Web Bean that " +"already implements the API type and has the binding types." +msgstr "" + +#. Tag: para +#: injection.xml:328 +#, no-c-format +msgid "" +"To fix an <literal>AmbiguousDependencyException</literal>, introduce a " +"binding type to distinguish between the two implementations of the API type, " +"or change the deployment type of one of the implementations so that the Web " +"Bean manager can use deployment type precedence to choose between them. An " +"<literal>AmbiguousDependencyException</literal> can only occur if two Web " +"Beans share a binding type and have exactly the same deployment type." +msgstr "" + +#. Tag: para +#: injection.xml:335 +#, no-c-format +msgid "" +"There's one more issue you need to be aware of when using dependency " +"injection in Web Beans." +msgstr "" + +#. Tag: title +#: injection.xml:341 +#, no-c-format +msgid "Client proxies" +msgstr "" + +#. Tag: para +#: injection.xml:343 +#, no-c-format +msgid "" +"Clients of an injected Web Bean do not usually hold a direct reference to a " +"Web Bean instance." +msgstr "" + +#. Tag: para +#: injection.xml:346 +#, no-c-format +msgid "" +"Imagine that a Web Bean bound to the application scope held a direct " +"reference to a Web Bean bound to the request scope. The application scoped " +"Web Bean is shared between many different requests. However, each request " +"should see a different instance of the request scoped Web bean!" +msgstr "" + +#. Tag: para +#: injection.xml:351 +#, no-c-format +msgid "" +"Now imagine that a Web Bean bound to the session scope held a direct " +"reference to a Web Bean bound to the application scope. From time to time, " +"the session context is serialized to disk in order to use memory more " +"efficiently. However, the application scoped Web Bean instance should not be " +"serialized along with the session scoped Web Bean!" +msgstr "" + +#. Tag: para +#: injection.xml:357 +#, no-c-format +msgid "" +"Therefore, unless a Web Bean has the default scope <literal>@Dependent</" +"literal>, the Web Bean manager must indirect all injected references to the " +"Web Bean through a proxy object. This <emphasis>client proxy</emphasis> is " +"responsible for ensuring that the Web Bean instance that receives a method " +"invocation is the instance that is associated with the current context. The " +"client proxy also allows Web Beans bound to contexts such as the session " +"context to be serialized to disk without recursively serializing other " +"injected Web Beans." +msgstr "" + +#. Tag: para +#: injection.xml:365 +#, no-c-format +msgid "" +"Unfortunately, due to limitations of the Java language, some Java types " +"cannot be proxied by the Web Bean manager. Therefore, the Web Bean manager " +"throws an <literal>UnproxyableDependencyException</literal> if the type of " +"an injection point cannot be proxied." +msgstr "" + +#. Tag: para +#: injection.xml:370 +#, no-c-format +msgid "The following Java types cannot be proxied by the Web Bean manager:" +msgstr "" + +#. Tag: para +#: injection.xml:374 +#, no-c-format +msgid "" +"classes which are declared <literal>final</literal> or have a " +"<literal>final</literal> method," +msgstr "" + +#. Tag: para +#: injection.xml:378 +#, no-c-format +msgid "classes which have no non-private constructor with no parameters, and" +msgstr "" + +#. Tag: para +#: injection.xml:381 +#, no-c-format +msgid "arrays and primitive types." +msgstr "" + +#. Tag: para +#: injection.xml:385 +#, no-c-format +msgid "" +"It's usually very easy to fix an <literal>UnproxyableDependencyException</" +"literal>. Simply add a constructor with no parameters to the injected class, " +"introduce an interface, or change the scope of the injected Web Bean to " +"<literal>@Dependent</literal>." +msgstr "" + +#. Tag: title +#: injection.xml:392 +#, no-c-format +msgid "Obtaining a Web Bean by programatic lookup" +msgstr "" + +#. Tag: para +#: injection.xml:394 +#, no-c-format +msgid "" +"The application may obtain an instance of the interface <literal>Manager</" +"literal> by injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:397 +#, no-c-format +msgid "<![CDATA[@Current Manager manager;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:399 +#, no-c-format +msgid "" +"The <literal>Manager</literal> object provides a set of methods for " +"obtaining a Web Bean instance programatically." +msgstr "" + +#. Tag: programlisting +#: injection.xml:402 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class);]]>" +msgstr "" + +#. Tag: para +#: injection.xml:404 +#, no-c-format +msgid "" +"Binding annotations may be specified by subclassing the helper class " +"<literal>AnnotationLiteral</literal>, since it is otherwise difficult to " +"instantiate an annotation type in Java." +msgstr "" + +#. Tag: programlisting +#: injection.xml:408 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class, \n" +" new " +"AnnotationLiteral<CreditCard>(){});]]>" +msgstr "" + +#. Tag: para +#: injection.xml:410 +#, no-c-format +msgid "" +"If the binding type has an annotation member, we can't use an anonymous " +"subclass of <literal>AnnotationLiteral</literal>instead we'll need to " +"create a named subclass:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:413 +#, no-c-format +msgid "" +"<![CDATA[abstract class CreditCardBinding \n" +" extends AnnotationLiteral<CreditCard> \n" +" implements CreditCard {}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:415 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class, \n" +" new CreditCardBinding() { \n" +" public void value() " +"{ return paymentType; } \n" +" } );]]>" +msgstr "" + +#. Tag: title +#: injection.xml:419 +#, no-c-format +msgid "" +"Lifecycle callbacks, <literal>@Resource</literal>, <literal>@EJB</literal> " +"and <literal>@PersistenceContext</literal>" +msgstr "" + +#. Tag: para +#: injection.xml:422 +#, no-c-format +msgid "" +"Enterprise Web Beans support all the lifecycle callbacks defined by the EJB " +"specification: <literal>@PostConstruct</literal>, <literal>@PreDestroy</" +"literal>, <literal>@PrePassivate</literal> and <literal>@PostActivate</" +"literal>." +msgstr "" + +#. Tag: para +#: injection.xml:426 +#, no-c-format +msgid "" +"Simple Web Beans support only the <literal>@PostConstruct</literal> and " +"<literal>@PreDestroy</literal> callbacks." +msgstr "" + +#. Tag: para +#: injection.xml:429 +#, no-c-format +msgid "" +"Both enterprise and simple Web Beans support the use of <literal>@Resource</" +"literal>, <literal>@EJB</literal> and <literal>@PersistenceContext</literal> " +"for injection of Java EE resources, EJBs and JPA persistence contexts, " +"respectively. Simple Web Beans do not support the use of " +"<literal>@PersistenceContext(type=EXTENDED)</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:434 +#, no-c-format +msgid "" +"The <literal>@PostConstruct</literal> callback always occurs after all " +"dependencies have been injected." +msgstr "" + +#. Tag: title +#: injection.xml:440 +#, no-c-format +msgid "The <literal>InjectionPoint</literal> object" +msgstr "" + +#. Tag: para +#: injection.xml:442 +#, no-c-format +msgid "" +"There are certain kinds of dependent objectsWeb Beans with scope " +"<literal>@Dependent</literal>that need to know something about the " +"object or injection point into which they are injected in order to be able " +"to do what they do. For example:" +msgstr "" + +#. Tag: para +#: injection.xml:448 +#, no-c-format +msgid "" +"The log category for a <literal>Logger</literal> depends upon the class of " +"the object that owns it." +msgstr "" + +#. Tag: para +#: injection.xml:452 +#, no-c-format +msgid "" +"Injection of a HTTP parameter or header value depends upon what parameter or " +"header name was specified at the injection point." +msgstr "" + +#. Tag: para +#: injection.xml:456 +#, no-c-format +msgid "" +"Injection of the result of an EL expression evaluation depends upon the " +"expression that was specified at the injection point." +msgstr "" + +#. Tag: para +#: injection.xml:461 +#, no-c-format +msgid "" +"A Web Bean with scope <literal>@Dependent</literal> may inject an instance " +"of <literal>InjectionPoint</literal> and access metadata relating to the " +"injection point to which it belongs." +msgstr "" + +#. Tag: para +#: injection.xml:465 +#, no-c-format +msgid "" +"Let's look at an example. The following code is verbose, and vulnerable to " +"refactoring problems:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:468 +#, no-c-format +msgid "<![CDATA[Logger log = Logger.getLogger(MyClass.class.getName());]]>" +msgstr "" + +#. Tag: para +#: injection.xml:470 +#, no-c-format +msgid "" +"This clever little producer method lets you inject a JDK <literal>Logger</" +"literal> without explicitly specifying the log category:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:473 +#, no-c-format +msgid "" +"<![CDATA[class LogFactory {\n" +"\n" +" @Produces Logger createLogger(InjectionPoint injectionPoint) { \n" +" return Logger.getLogger(injectionPoint.getMember().getDeclaringClass()." +"getName()); \n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:475 +#, no-c-format +msgid "We can now write:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:477 +#, no-c-format +msgid "<![CDATA[@Current Logger log;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:479 +#, no-c-format +msgid "" +"Not convinced? Then here's a second example. To inject HTTP parameters, we " +"need to define a binding type:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:482 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"public @interface HttpParam {\n" +" @NonBinding public String value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:484 +#, no-c-format +msgid "We would use this binding type at injection points as follows:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:486 +#, no-c-format +msgid "" +"<![CDATA[@HttpParam(\"username\") String username;\n" +"@HttpParam(\"password\") String password;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:488 +#, no-c-format +msgid "The following producer method does the work:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:490 +#, no-c-format +msgid "" +"<![CDATA[class HttpParams\n" +"\n" +" @Produces @HttpParam(\"\")\n" +" String getParamValue(ServletRequest request, InjectionPoint ip) {\n" +" return request.getParameter(ip.getAnnotation(HttpParam.class).value" +"());\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:492 +#, no-c-format +msgid "" +"(Note that the <literal>value()</literal> member of the <literal>HttpParam</" +"literal> annotation is ignored by the Web Bean manager since it is annotated " +"<literal>@NonBinding.</literal>)" +msgstr "" + +#. Tag: para +#: injection.xml:495 +#, no-c-format +msgid "" +"The Web Bean manager provides a built-in Web Bean that implements the " +"<literal>InjectionPoint</literal> interface:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:498 +#, no-c-format +msgid "" +"<![CDATA[public interface InjectionPoint { \n" +" public Object getInstance(); \n" +" public Bean<?> getBean(); \n" +" public Member getMember(): \n" +" public <T extends Annotation> T getAnnotation(Class<T> annotation); \n" +" public Set<T extends Annotation> getAnnotations(); \n" +"}]]>" +msgstr "" Added: doc/trunk/reference/es-ES/modules/interceptors.po =================================================================== --- doc/trunk/reference/es-ES/modules/interceptors.po (rev 0) +++ doc/trunk/reference/es-ES/modules/interceptors.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,572 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: interceptors.xml:4 +#, no-c-format +msgid "Interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:6 +#, no-c-format +msgid "" +"Web Beans re-uses the basic interceptor architecture of EJB 3.0, extending " +"the functionality in two directions:" +msgstr "" + +#. Tag: para +#: interceptors.xml:11 +#, no-c-format +msgid "Any Web Bean may have interceptors, not just session beans." +msgstr "" + +#. Tag: para +#: interceptors.xml:14 +#, no-c-format +msgid "" +"Web Beans features a more sophisticated annotation-based approach to binding " +"interceptors to Web Beans." +msgstr "" + +#. Tag: para +#: interceptors.xml:22 +#, no-c-format +msgid "The EJB specification defines two kinds of interception points:" +msgstr "" + +#. Tag: para +#: interceptors.xml:26 +#, no-c-format +msgid "business method interception, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:29 +#, no-c-format +msgid "lifecycle callback interception." +msgstr "" + +#. Tag: para +#: interceptors.xml:33 +#, no-c-format +msgid "" +"A <emphasis>business method interceptor</emphasis> applies to invocations of " +"methods of the Web Bean by clients of the Web Bean:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:36 +#, no-c-format +msgid "" +"<![CDATA[public class TransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:38 +#, no-c-format +msgid "" +"A <emphasis>lifecycle callback interceptor</emphasis> applies to invocations " +"of lifecycle callbacks by the container:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:41 +#, no-c-format +msgid "" +"<![CDATA[public class DependencyInjectionInterceptor {\n" +" @PostConstruct public void injectDependencies(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:43 +#, no-c-format +msgid "" +"An interceptor class may intercept both lifecycle callbacks and business " +"methods." +msgstr "" + +#. Tag: title +#: interceptors.xml:49 +#, no-c-format +msgid "Interceptor bindings" +msgstr "" + +#. Tag: para +#: interceptors.xml:51 +#, no-c-format +msgid "" +"Suppose we want to declare that some of our Web Beans are transactional. The " +"first thing we need is an <emphasis>interceptor binding annotation</" +"emphasis> to specify exactly which Web Beans we're interested in:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:55 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Transactional {}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:57 +#, no-c-format +msgid "" +"Now we can easily specify that our <literal>ShoppingCart</literal> is a " +"transactional object:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:60 +#, no-c-format +msgid "" +"<![CDATA[@Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:62 +#, no-c-format +msgid "Or, if we prefer, we can specify that just one method is transactional:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:64 +#, no-c-format +msgid "" +"<![CDATA[public class ShoppingCart {\n" +" @Transactional public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:69 +#, no-c-format +msgid "Implementing interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:71 +#, no-c-format +msgid "" +"That's great, but somewhere along the line we're going to have to actually " +"implement the interceptor that provides this transaction management aspect. " +"All we need to do is create a standard EJB interceptor, and annotate it " +"<literal>@Interceptor</literal> and <literal>@Transactional</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:76 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:78 +#, no-c-format +msgid "" +"All Web Beans interceptors are simple Web Beans, and can take advantage of " +"dependency injection and contextual lifecycle management." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:81 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +"\n" +" @Resource Transaction transaction;\n" +"\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:83 +#, no-c-format +msgid "Multiple interceptors may use the same interceptor binding type." +msgstr "" + +#. Tag: title +#: interceptors.xml:88 +#, no-c-format +msgid "Enabling interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:90 +#, no-c-format +msgid "" +"Finally, we need to <emphasis>enable</emphasis> our interceptor in " +"<literal>web-beans.xml</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:93 +#, no-c-format +msgid "" +"<![CDATA[<Interceptors>\n" +" <tx:TransactionInterceptor/>\n" +"</Interceptors>]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:95 +#, no-c-format +msgid "Whoah! Why the angle bracket stew?" +msgstr "" + +#. Tag: para +#: interceptors.xml:97 +#, no-c-format +msgid "Well, the XML declaration solves two problems:" +msgstr "" + +#. Tag: para +#: interceptors.xml:101 +#, no-c-format +msgid "" +"it enables us to specify a total ordering for all the interceptors in our " +"system, ensuring deterministic behavior, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:105 +#, no-c-format +msgid "it lets us enable or disable interceptor classes at deployment time." +msgstr "" + +#. Tag: para +#: interceptors.xml:109 +#, no-c-format +msgid "" +"For example, we could specify that our security interceptor runs before our " +"<literal>TransactionInterceptor</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:112 +#, no-c-format +msgid "" +"<![CDATA[<Interceptors>\n" +" <sx:SecurityInterceptor/>\n" +" <tx:TransactionInterceptor/>\n" +"</Interceptors>]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:114 +#, no-c-format +msgid "Or we could turn them both off in our test environment!" +msgstr "" + +#. Tag: title +#: interceptors.xml:119 +#, no-c-format +msgid "Interceptor bindings with members" +msgstr "" + +#. Tag: para +#: interceptors.xml:121 +#, no-c-format +msgid "" +"Suppose we want to add some extra information to our " +"<literal>@Transactional</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:124 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Transactional {\n" +" boolean requiresNew() default false;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:126 +#, no-c-format +msgid "" +"Web Beans will use the value of <literal>requiresNew</literal> to choose " +"between two different interceptors, <literal>TransactionInterceptor</" +"literal> and <literal>RequiresNewTransactionInterceptor</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:130 +#, no-c-format +msgid "" +"<![CDATA[@Transactional(requiresNew=true) @Interceptor\n" +"public class RequiresNewTransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:132 +#, no-c-format +msgid "" +"Now we can use <literal>RequiresNewTransactionInterceptor</literal> like " +"this:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:134 +#, no-c-format +msgid "" +"<![CDATA[@Transactional(requiresNew=true)\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:136 +#, no-c-format +msgid "" +"But what if we only have one interceptor and we want the manager to ignore " +"the value of <literal>requiresNew</literal> when binding interceptors? We " +"can use the <literal>@NonBinding</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:140 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Secure {\n" +" @NonBinding String[] rolesAllowed() default {};\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:145 +#, no-c-format +msgid "Multiple interceptor binding annotations" +msgstr "" + +#. Tag: para +#: interceptors.xml:147 +#, no-c-format +msgid "" +"Usually we use combinations of interceptor bindings types to bind multiple " +"interceptors to a Web Bean. For example, the following declaration would be " +"used to bind <literal>TransactionInterceptor</literal> and " +"<literal>SecurityInterceptor</literal> to the same Web Bean:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:152 +#, no-c-format +msgid "" +"<![CDATA[@Secure(rolesAllowed=\"admin\") @Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:154 +#, no-c-format +msgid "" +"However, in very complex cases, an interceptor itself may specify some " +"combination of interceptor binding types:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:157 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure @Interceptor\n" +"public class TransactionalSecureInterceptor { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:159 +#, no-c-format +msgid "" +"Then this interceptor could be bound to the <literal>checkout()</literal> " +"method using any one of the following combinations:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:162 +#, no-c-format +msgid "" +"<![CDATA[public class ShoppingCart {\n" +" @Transactional @Secure public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:164 +#, no-c-format +msgid "" +"<![CDATA[@Secure\n" +"public class ShoppingCart {\n" +" @Transactional public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:166 +#, no-c-format +msgid "" +"<![CDATA[@Transactionl\n" +"public class ShoppingCart {\n" +" @Secure public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:168 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure\n" +"public class ShoppingCart {\n" +" public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:173 +#, no-c-format +msgid "Interceptor binding type inheritance" +msgstr "" + +#. Tag: para +#: interceptors.xml:175 +#, no-c-format +msgid "" +"One limitation of the Java language support for annotations is the lack of " +"annotation inheritance. Really, annotations should have reuse built in, to " +"allow this kind of thing to work:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:179 +#, no-c-format +msgid "" +"<![CDATA[public @interface Action extends Transactional, Secure { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:181 +#, no-c-format +msgid "" +"Well, fortunately, Web Beans works around this missing feature of Java. We " +"may annotate one interceptor binding type with other interceptor binding " +"types. The interceptor bindings are transitiveany Web Bean with the " +"first interceptor binding inherits the interceptor bindings declared as meta-" +"annotations." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:186 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure\n" +"@InterceptorBindingType\n" +"@Target(TYPE)\n" +"@Retention(RUNTIME)\n" +"public @interface Action { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:188 +#, no-c-format +msgid "" +"Any Web Bean annotated <literal>@Action</literal> will be bound to both " +"<literal>TransactionInterceptor</literal> and <literal>SecurityInterceptor</" +"literal>. (And even <literal>TransactionalSecureInterceptor</literal>, if it " +"exists.)" +msgstr "" + +#. Tag: title +#: interceptors.xml:195 +#, no-c-format +msgid "Use of <literal>@Interceptors</literal>" +msgstr "" + +#. Tag: para +#: interceptors.xml:197 +#, no-c-format +msgid "" +"The <literal>@Interceptors</literal> annotation defined by the EJB " +"specification is supported for both enterprise and simple Web Beans, for " +"example:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:200 +#, no-c-format +msgid "" +"<![CDATA[(a)Interceptors({TransactionInterceptor.class, @SecurityInterceptor." +"class})\n" +"public class ShoppingCart {\n" +" public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:202 +#, no-c-format +msgid "However, this approach suffers the following drawbacks:" +msgstr "" + +#. Tag: para +#: interceptors.xml:206 +#, no-c-format +msgid "the interceptor implementation is hardcoded in business code," +msgstr "" + +#. Tag: para +#: interceptors.xml:209 +#, no-c-format +msgid "interceptors may not be easily disabled at deployment time, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:212 +#, no-c-format +msgid "" +"the interceptor ordering is non-globalit is determined by the order in " +"which interceptors are listed at the class level." +msgstr "" + +#. Tag: para +#: interceptors.xml:217 +#, no-c-format +msgid "" +"Therefore, we recommend the use of Web Beans-style interceptor bindings." +msgstr "" Added: doc/trunk/reference/es-ES/modules/intro.po =================================================================== --- doc/trunk/reference/es-ES/modules/intro.po (rev 0) +++ doc/trunk/reference/es-ES/modules/intro.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,1075 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: intro.xml:4 +#, no-c-format +msgid "Getting started with Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:6 +#, no-c-format +msgid "" +"So you're already keen to get started writing your first Web Bean? Or " +"perhaps you're skeptical, wondering what kinds of hoops the Web Beans " +"specification will make you jump through! The good news is that you've " +"probably already written and used hundreds, perhaps thousands of Web Beans. " +"You might not even remember the first Web Bean you wrote." +msgstr "" + +#. Tag: title +#: intro.xml:13 +#, no-c-format +msgid "Your first Web Bean" +msgstr "" + +#. Tag: para +#: intro.xml:15 +#, no-c-format +msgid "" +"With certain, very special exceptions, every Java class with a constructor " +"that accepts no parameters is a Web Bean. That includes every JavaBean. " +"Furthermore, every EJB 3-style session bean is a Web Bean. Sure, the " +"JavaBeans and EJBs you've been writing every day have not been able to take " +"advantage of the new services defined by the Web Beans specification, but " +"you'll be able to use every one of them as Web Beansinjecting them " +"into other Web Beans, configuring them via the Web Beans XML configuration " +"facility, even adding interceptors and decorators to themwithout " +"touching your existing code." +msgstr "" + +#. Tag: para +#: intro.xml:25 +#, no-c-format +msgid "" +"Suppose that we have two existing Java classes, that we've been using for " +"years in various applications. The first class parses a string into a list " +"of sentences:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:29 +#, no-c-format +msgid "" +"<![CDATA[public class SentenceParser {\n" +" public List<String> parse(String text) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:31 +#, no-c-format +msgid "" +"The second existing class is a stateless session bean front-end for an " +"external system that is able to translate sentences from one language to " +"another:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:35 +#, no-c-format +msgid "" +"<![CDATA[@Stateless\n" +"public class SentenceTranslator implements Translator {\n" +" public String translate(String sentence) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:37 +#, no-c-format +msgid "Where <literal>Translator</literal> is the local interface:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:39 +#, no-c-format +msgid "" +"<![CDATA[@Local\n" +"public interface Translator {\n" +" public String translate(String sentence);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:41 +#, no-c-format +msgid "" +"Unfortunately, we don't have a preexisting class that translates whole text " +"documents. So let's write a Web Bean that does this job:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:44 +#, no-c-format +msgid "" +"<![CDATA[public class TextTranslator {\n" +" \n" +" private SentenceParser sentenceParser;\n" +" private Translator sentenceTranslator;\n" +" \n" +" @Initializer\n" +" TextTranslator(SentenceParser sentenceParser, Translator " +"sentenceTranslator) {\n" +" this.sentenceParser = sentenceParser;\n" +" this.sentenceTranslator = sentenceTranslator;\n" +" }\n" +" \n" +" public String translate(String text) {\n" +" StringBuilder sb = new StringBuilder();\n" +" for (String sentence: sentenceParser.parse(text)) {\n" +" sb.append(sentenceTranslator.translate(sentence));\n" +" }\n" +" return sb.toString();\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:46 +#, no-c-format +msgid "" +"We may obtain an instance of <literal>TextTranslator</literal> by injecting " +"it into a Web Bean, Servlet or EJB:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:49 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public setTextTranslator(TextTranslator textTranslator) {\n" +" this.textTranslator = textTranslator;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:51 +#, no-c-format +msgid "" +"Alternatively, we may obtain an instance by directly calling a method of the " +"Web Bean manager:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:54 +#, no-c-format +msgid "" +"<![CDATA[TextTranslator tt = manager.getInstanceByType(TextTranslator." +"class);]]>" +msgstr "" + +#. Tag: para +#: intro.xml:56 +#, no-c-format +msgid "" +"But wait: <literal>TextTranslator</literal> does not have a constructor with " +"no parameters! Is it still a Web Bean? Well, a class that does not have a " +"constructor with no parameters can still be a Web Bean if it has a " +"constructor annotated <literal>@Initializer</literal>." +msgstr "" + +#. Tag: para +#: intro.xml:61 +#, no-c-format +msgid "" +"As you've guessed, the <literal>@Initializer</literal> annotation has " +"something to do with dependency injection! <literal>@Initializer</literal> " +"may be applied to a constructor or method of a Web Bean, and tells the Web " +"Bean manager to call that constructor or method when instantiating the Web " +"Bean. The Web Bean manager will inject other Web Beans to the parameters of " +"the constructor or method." +msgstr "" + +#. Tag: para +#: intro.xml:68 +#, no-c-format +msgid "" +"At system initialization time, the Web Bean manager must validate that " +"exactly one Web Bean exists which satisfies each injection point. In our " +"example, if no implementation of <literal>Translator</literal> " +"availableif the <literal>SentenceTranslator</literal> EJB was not " +"deployedthe Web Bean manager would throw an " +"<literal>UnsatisfiedDependencyException</literal>. If more than one " +"implementation of <literal>Translator</literal> was available, the Web Bean " +"manager would throw an <literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: title +#: intro.xml:80 +#, no-c-format +msgid "What is a Web Bean?" +msgstr "" + +#. Tag: para +#: intro.xml:82 +#, no-c-format +msgid "So what, <emphasis>exactly</emphasis>, is a Web Bean?" +msgstr "" + +#. Tag: para +#: intro.xml:84 +#, no-c-format +msgid "" +"A Web Bean is an application class that contains business logic. A Web Bean " +"may be called directly from Java code, or it may be invoked via Unified EL. " +"A Web Bean may access transactional resources. Dependencies between Web " +"Beans are managed automatically by the Web Bean manager. Most Web Beans are " +"<emphasis>stateful</emphasis> and <emphasis>contextual</emphasis>. The " +"lifecycle of a Web Bean is always managed by the Web Bean manager." +msgstr "" + +#. Tag: para +#: intro.xml:91 +#, no-c-format +msgid "" +"Let's back up a second. What does it really mean to be \"contextual\"? Since " +"Web Beans may be stateful, it matters <emphasis>which</emphasis> bean " +"instance I have. Unlike a stateless component model (for example, stateless " +"session beans) or a singleton component model (such as servlets, or " +"singleton beans), different clients of a Web Bean see the Web Bean in " +"different states. The client-visible state depends upon which instance of " +"the Web Bean the client has a reference to." +msgstr "" + +#. Tag: para +#: intro.xml:98 +#, no-c-format +msgid "" +"However, like a stateless or singleton model, but <emphasis>unlike</" +"emphasis> stateful session beans, the client does not control the lifecycle " +"of the instance by explicitly creating and destroying it. Instead, the " +"<emphasis>scope</emphasis> of the Web Bean determines:" +msgstr "" + +#. Tag: para +#: intro.xml:105 +#, no-c-format +msgid "the lifecycle of each instance of the Web Bean and" +msgstr "" + +#. Tag: para +#: intro.xml:108 +#, no-c-format +msgid "" +"which clients share a reference to a particular instance of the Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:113 +#, no-c-format +msgid "" +"For a given thread in a Web Beans application, there may be an " +"<emphasis>active context</emphasis> associated with the scope of the Web " +"Bean. This context may be unique to the thread (for example, if the Web Bean " +"is request scoped), or it may be shared with certain other threads (for " +"example, if the Web Bean is session scoped) or even all other threads (if it " +"is application scoped)." +msgstr "" + +#. Tag: para +#: intro.xml:119 +#, no-c-format +msgid "" +"Clients (for example, other Web Beans) executing in the same context will " +"see the same instance of the Web Bean. But clients in a different context " +"will see a different instance." +msgstr "" + +#. Tag: para +#: intro.xml:123 +#, no-c-format +msgid "" +"One great advantage of the contextual model is that it allows stateful Web " +"Beans to be treated like services! The client need not concern itself with " +"managing the lifecycle of the Web Bean it is using, <emphasis>nor does it " +"even need to know what that lifecyle is.</emphasis> Web Beans interact by " +"passing messages, and the Web Bean implementations define the lifecycle of " +"their own state. The Web Beans are loosely coupled because:" +msgstr "" + +#. Tag: para +#: intro.xml:132 +#, no-c-format +msgid "they interact via well-defined public APIs" +msgstr "" + +#. Tag: para +#: intro.xml:135 +#, no-c-format +msgid "their lifecycles are completely decoupled" +msgstr "" + +#. Tag: para +#: intro.xml:139 +#, no-c-format +msgid "" +"We can replace one Web Bean with a different Web Bean that implements the " +"same API and has a different lifecycle (a different scope) without affecting " +"the other Web Bean implementation. In fact, Web Beans defines a " +"sophisticated facility for overriding Web Bean implementations at deployment " +"time, as we will see in <xref linkend=\"deploymenttypes\"/>." +msgstr "" + +#. Tag: para +#: intro.xml:145 +#, no-c-format +msgid "" +"Note that not all clients of a Web Bean are Web Beans. Other objects such as " +"Servlets or Message-Driven Beanswhich are by nature not injectable, " +"contextual objectsmay also obtain references to Web Beans by injection." +msgstr "" + +#. Tag: para +#: intro.xml:149 +#, no-c-format +msgid "Enough hand-waving. More formally, according to the spec:" +msgstr "" + +#. Tag: para +#: intro.xml:153 +#, no-c-format +msgid "A Web Bean comprises:" +msgstr "" + +#. Tag: para +#: intro.xml:156 +#, no-c-format +msgid "A (nonempty) set of API types" +msgstr "" + +#. Tag: para +#: intro.xml:157 +#, no-c-format +msgid "A (nonempty) set of binding annotation types" +msgstr "" + +#. Tag: para +#: intro.xml:158 +#, no-c-format +msgid "A scope" +msgstr "" + +#. Tag: para +#: intro.xml:159 +#, no-c-format +msgid "A deployment type" +msgstr "" + +#. Tag: para +#: intro.xml:160 +#, no-c-format +msgid "Optionally, a Web Bean name" +msgstr "" + +#. Tag: para +#: intro.xml:161 +#, no-c-format +msgid "A set of interceptor binding types" +msgstr "" + +#. Tag: para +#: intro.xml:162 +#, no-c-format +msgid "A Web Bean implementation" +msgstr "" + +#. Tag: para +#: intro.xml:167 +#, no-c-format +msgid "Let's see what some of these terms mean, to the Web Bean developer." +msgstr "" + +#. Tag: title +#: intro.xml:170 +#, no-c-format +msgid "API types, binding types and dependency injection" +msgstr "" + +#. Tag: para +#: intro.xml:172 +#, no-c-format +msgid "" +"Web Beans usually acquire references to other Web Beans via dependency " +"injection. Any injected attribute specifies a \"contract\" that must be " +"satisfied by the Web Bean to be injected. The contract is:" +msgstr "" + +#. Tag: para +#: intro.xml:177 +#, no-c-format +msgid "an API type, together with" +msgstr "" + +#. Tag: para +#: intro.xml:178 +#, no-c-format +msgid "a set of binding types." +msgstr "" + +#. Tag: para +#: intro.xml:181 +#, no-c-format +msgid "" +"An API is a user-defined class or interface. (If the Web Bean is an EJB " +"session bean, the API type is the <literal>@Local</literal> interface or " +"bean-class local view). A binding type represents some client-visible " +"semantic that is satisfied by some implementations of the API and not by " +"others." +msgstr "" + +#. Tag: para +#: intro.xml:186 +#, no-c-format +msgid "" +"Binding types are represented by user-defined annotations that are " +"themselves annotated <literal>@BindingType</literal>. For example, the " +"following injection point has API type <literal>PaymentProcessor</literal> " +"and binding type <literal>@CreditCard</literal>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:191 +#, no-c-format +msgid "<![CDATA[@CreditCard PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: intro.xml:193 +#, no-c-format +msgid "" +"If no binding type is explicitly specified at an injection point, the " +"default binding type <literal>@Current</literal> is assumed." +msgstr "" + +#. Tag: para +#: intro.xml:196 +#, no-c-format +msgid "" +"For each injection point, the Web Bean manager searches for a Web Bean which " +"satisfies the contract (implements the API, and has all the binding types), " +"and injects that Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:200 +#, no-c-format +msgid "" +"The following Web Bean has the binding type <literal>@CreditCard</literal> " +"and implements the API type <literal>PaymentProcessor</literal>. It could " +"therefore be injected to the example injection point:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:204 +#, no-c-format +msgid "" +"<![CDATA[@CreditCard\n" +"public class CreditCardPaymentProcessor \n" +" implements PaymentProcessor { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:206 +#, no-c-format +msgid "" +"If a Web Bean does not explicitly specify a set of binding types, it has " +"exactly one binding type: the default binding type <literal>@Current</" +"literal>." +msgstr "" + +#. Tag: para +#: intro.xml:209 +#, no-c-format +msgid "" +"Web Beans defines a sophisticated but intuitive <emphasis>resolution " +"algorithm</emphasis> that helps the container decide what to do if there is " +"more than one Web Bean that satisfies a particular contract. We'll get into " +"the details in <xref linkend=\"injection\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:217 +#, no-c-format +msgid "Deployment types" +msgstr "" + +#. Tag: para +#: intro.xml:219 +#, no-c-format +msgid "" +"<emphasis>Deployment types</emphasis> let us classify our Web Beans by " +"deployment scenario. A deployment type is an annotation that represents a " +"particular deployment scenario, for example <literal>@Mock</literal>, " +"<literal>@Staging</literal> or <literal>@AustralianTaxLaw</literal>. We " +"apply the annotation to Web Beans which should be deployed in that scenario. " +"A deployment type allows a whole set of Web Beans to be conditionally " +"deployed, with a just single line of configuration." +msgstr "" + +#. Tag: para +#: intro.xml:226 +#, no-c-format +msgid "" +"Many Web Beans just use the default deployment type <literal>@Production</" +"literal>, in which case no deployment type need be explicitly specified. All " +"three Web Bean in our example have the deployment type <literal>@Production</" +"literal>." +msgstr "" + +#. Tag: para +#: intro.xml:230 +#, no-c-format +msgid "" +"In a testing environment, we might want to replace the " +"<literal>SentenceTranslator</literal> Web Bean with a \"mock object\":" +msgstr "" + +#. Tag: programlisting +#: intro.xml:233 +#, no-c-format +msgid "" +"<![CDATA[@Mock\n" +"public class MockSentenceTranslator implements Translator {\n" +" public String translate(String sentence) {\n" +" return \"Lorem ipsum dolor sit amet\";\n" +" }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:236 +#, no-c-format +msgid "" +"We would enable the deployment type <literal>@Mock</literal> in our testing " +"environment, to indicate that <literal>MockSentenceTranslator</literal> and " +"any other Web Bean annotated <literal>@Mock</literal> should be used." +msgstr "" + +#. Tag: para +#: intro.xml:240 +#, no-c-format +msgid "" +"We'll talk more about this unique and powerful feature in <xref linkend=" +"\"deploymenttypes\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:246 +#, no-c-format +msgid "Scope" +msgstr "" + +#. Tag: para +#: intro.xml:248 +#, no-c-format +msgid "" +"The <emphasis>scope</emphasis> defines the lifecycle and visibility of " +"instances of the Web Bean. The Web Beans context model is extensible, " +"accommodating arbitrary scopes. However, certain important scopes are built-" +"in to the specification, and provided by the Web Bean manager. A scope is " +"represented by an annotation type." +msgstr "" + +#. Tag: para +#: intro.xml:254 +#, no-c-format +msgid "" +"For example, any web application may have <emphasis>session scoped</" +"emphasis> Web Beans:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:257 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:259 +#, no-c-format +msgid "" +"An instance of a session scoped Web Bean is bound to a user session and is " +"shared by all requests that execute in the context of that session." +msgstr "" + +#. Tag: para +#: intro.xml:262 +#, no-c-format +msgid "" +"By default, Web Beans belong to a special scope called the " +"<emphasis>dependent pseudo-scope</emphasis>. Web Beans with this scope are " +"pure dependent objects of the object into which they are injected, and their " +"lifecycle is bound to the lifecycle of that object." +msgstr "" + +#. Tag: para +#: intro.xml:267 +#, no-c-format +msgid "We'll talk more about scopes in <xref linkend=\"scopescontexts\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:272 +#, no-c-format +msgid "Web Bean names and Unified EL" +msgstr "" + +#. Tag: para +#: intro.xml:274 +#, no-c-format +msgid "" +"A Web Bean may have a <emphasis>name</emphasis>, allowing it to be used in " +"Unified EL expressions. It's easy to specify the name of a Web Bean:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:278 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named(\"cart\")\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:280 +#, no-c-format +msgid "Now we can easily use the Web Bean in any JSF or JSP page:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:282 +#, no-c-format +msgid "" +"<![CDATA[<h:dataTable value=\"#{cart.lineItems}\" var=\"item\">\n" +" ....\n" +"</h:dataTable>]]>" +msgstr "" + +#. Tag: para +#: intro.xml:284 +#, no-c-format +msgid "" +"It's even easier to just let the name be defaulted by the Web Bean manager:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:287 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:289 +#, no-c-format +msgid "" +"In this case, the name defaults to <literal>shoppingCart</literal>the " +"unqualified class name, with the first character changed to lowercase." +msgstr "" + +#. Tag: title +#: intro.xml:295 +#, no-c-format +msgid "Interceptor binding types" +msgstr "" + +#. Tag: para +#: intro.xml:297 +#, no-c-format +msgid "" +"Web Beans supports the interceptor functionality defined by EJB 3, not only " +"for EJB beans, but also for plain Java classes. In addition, Web Beans " +"provides a new approach to binding interceptors to EJB beans and other Web " +"Beans." +msgstr "" + +#. Tag: para +#: intro.xml:302 +#, no-c-format +msgid "" +"It remains possible to directly specify the interceptor class via use of the " +"<literal>@Interceptors</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:305 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped \n" +"@Interceptors(TransactionInterceptor.class)\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:307 +#, no-c-format +msgid "" +"However, it is more elegant, and better practice, to indirect the " +"interceptor binding through an <emphasis>interceptor binding type</emphasis>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:311 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:313 +#, no-c-format +msgid "" +"We'll discuss Web Beans interceptors and decorators in <xref linkend=" +"\"interceptors\"/> and <xref linkend=\"decorators\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:321 +#, no-c-format +msgid "What kinds of objects can be Web Beans?" +msgstr "" + +#. Tag: para +#: intro.xml:323 +#, no-c-format +msgid "" +"We've already seen that JavaBeans, EJBs and some other Java classes can be " +"Web Beans. But exactly what kinds of objects are Web Beans?" +msgstr "" + +#. Tag: title +#: intro.xml:327 +#, no-c-format +msgid "Simple Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:329 +#, no-c-format +msgid "" +"The Web Beans specification says that a concrete Java class is a " +"<emphasis>simple</emphasis> Web Bean if:" +msgstr "" + +#. Tag: para +#: intro.xml:334 +#, no-c-format +msgid "" +"it is not an EE container-managed component, like an EJB, a Servlet or a JPA " +"entity," +msgstr "" + +#. Tag: para +#: intro.xml:338 +#, no-c-format +msgid "it is not a non-static static inner class," +msgstr "" + +#. Tag: para +#: intro.xml:341 +#, no-c-format +msgid "it is not a parameterized type, and" +msgstr "" + +#. Tag: para +#: intro.xml:344 +#, no-c-format +msgid "" +"it has a constructor with no parameters, or a constructor annotated " +"<literal>@Initializer</literal>." +msgstr "" + +#. Tag: para +#: intro.xml:349 +#, no-c-format +msgid "Thus, almost every JavaBean is a simple Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:351 +#, no-c-format +msgid "" +"Every interface implemented directly or indirectly by a simple Web Bean is " +"an API type of the simple Web Bean. The class and its superclasses are also " +"API types." +msgstr "" + +#. Tag: title +#: intro.xml:358 +#, no-c-format +msgid "Enterprise Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:360 +#, no-c-format +msgid "" +"The specification says that all EJB 3-style session and singleton beans are " +"<emphasis>enterprise</emphasis> Web Beans. Message driven beans are not Web " +"Beanssince they are not intended to be injected into other " +"objectsbut they can take advantage of most of the functionality of Web " +"Beans, including dependency injection and interceptors." +msgstr "" + +#. Tag: para +#: intro.xml:366 +#, no-c-format +msgid "" +"Every local interface of an enterprise Web Bean that does not have a " +"wildcard type parameter or type variable, and every one of its " +"superinterfaces, is an API type of the enterprise Web Bean. If the EJB bean " +"has a bean class local view, the bean class, and every one of its " +"superclasses, is also an API type." +msgstr "" + +#. Tag: para +#: intro.xml:372 +#, no-c-format +msgid "" +"Stateful session beans should declare a remove method with no parameters or " +"a remove method annotated <literal>@Destructor</literal>. The Web Bean " +"manager calls this method to destroy the stateful session bean instance at " +"the end of its lifecycle. This method is called the <emphasis>destructor</" +"emphasis> method of the enterprise Web Bean." +msgstr "" + +#. Tag: programlisting +#: intro.xml:378 +#, no-c-format +msgid "" +"<![CDATA[@Stateful @SessionScoped\n" +"public class ShoppingCart {\n" +"\n" +" ...\n" +" \n" +" @Remove\n" +" public void destroy() {}\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:380 +#, no-c-format +msgid "" +"So when should we use an enterprise Web Bean instead of a simple Web Bean? " +"Well, whenever we need the advanced enterprise services offered by EJB, such " +"as:" +msgstr "" + +#. Tag: para +#: intro.xml:387 +#, no-c-format +msgid "method-level transaction management and security," +msgstr "" + +#. Tag: para +#: intro.xml:390 +#, no-c-format +msgid "concurrency management," +msgstr "" + +#. Tag: para +#: intro.xml:393 +#, no-c-format +msgid "" +"instance-level passivation for stateful session beans and instance-pooling " +"for stateless session beans," +msgstr "" + +#. Tag: para +#: intro.xml:397 +#, no-c-format +msgid "remote and web service invocation, and" +msgstr "" + +#. Tag: para +#: intro.xml:400 +#, no-c-format +msgid "timers and asynchronous methods," +msgstr "" + +#. Tag: para +#: intro.xml:404 +#, no-c-format +msgid "" +"we should use an enterprise Web Bean. When we don't need any of these " +"things, a simple Web Bean will serve just fine." +msgstr "" + +#. Tag: para +#: intro.xml:407 +#, no-c-format +msgid "" +"Many Web Beans (including any session or application scoped Web Bean) are " +"available for concurrent access. Therefore, the concurrency management " +"provided by EJB 3.1 is especially useful. Most session and application " +"scoped Web Beans should be EJBs." +msgstr "" + +#. Tag: para +#: intro.xml:412 +#, no-c-format +msgid "" +"Web Beans which hold references to heavy-weight resources, or hold a lot of " +"internal state benefit from the advanced container-managed lifecycle defined " +"by the EJB <literal>@Stateless</literal>/<literal>@Stateful</literal>/" +"<literal>@Singleton</literal> model, with its support for passivation and " +"instance pooling." +msgstr "" + +#. Tag: para +#: intro.xml:417 +#, no-c-format +msgid "" +"Finally, it's usually obvious when method-level transaction management, " +"method-level security, timers, remote methods or asynchronous methods are " +"needed." +msgstr "" + +#. Tag: para +#: intro.xml:420 +#, no-c-format +msgid "" +"It's usually easy to start with simple Web Bean, and then turn it into an " +"EJB, just by adding an annotation: <literal>@Stateless</literal>, " +"<literal>@Stateful</literal> or <literal>@Singleton</literal>." +msgstr "" + +#. Tag: title +#: intro.xml:427 +#, no-c-format +msgid "Producer methods" +msgstr "" + +#. Tag: para +#: intro.xml:429 +#, no-c-format +msgid "" +"A <emphasis>producer method</emphasis> is a method that is called by the Web " +"Bean manager to obtain an instance of the Web Bean when no instance exists " +"in the current context. A producer method lets the application take full " +"control of the instantiation process, instead of leaving instantiation to " +"the Web Bean manager. For example:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:435 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped\n" +"public class Generator {\n" +"\n" +" private Random random = new Random( System.currentTimeMillis() );\n" +" \n" +" @Produces @Random int next() {\n" +" return random.nextInt(100);\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:437 +#, no-c-format +msgid "" +"The result of a producer method is injected just like any other Web Bean." +msgstr "" + +#. Tag: programlisting +#: intro.xml:439 +#, no-c-format +msgid "<![CDATA[@Random int randomNumber]]>" +msgstr "" + +#. Tag: para +#: intro.xml:441 +#, no-c-format +msgid "" +"The method return type and all interfaces it extends/implements directly or " +"indirectly are API types of the producer method. If the return type is a " +"class, all superclasses are also API types." +msgstr "" + +#. Tag: para +#: intro.xml:445 +#, no-c-format +msgid "Some producer methods return objects that require explicit destruction:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:447 +#, no-c-format +msgid "" +"<![CDATA[@Produces @RequestScoped Connection connect(User user) {\n" +" return createConnection( user.getId(), user.getPassword() );\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:449 +#, no-c-format +msgid "" +"These producer methods may define matching <emphasis>disposal methods</" +"emphasis>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:451 +#, no-c-format +msgid "" +"<![CDATA[void close(@Disposes Connection connection) {\n" +" connection.close();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:453 +#, no-c-format +msgid "" +"This disposal method is called automatically by the Web Bean manager at the " +"end of the request." +msgstr "" + +#. Tag: para +#: intro.xml:456 +#, no-c-format +msgid "" +"We'll talk much more about producer methods in <xref linkend=" +"\"producermethods\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:461 +#, no-c-format +msgid "JMS endpoints" +msgstr "" + +#. Tag: para +#: intro.xml:463 +#, no-c-format +msgid "" +"Finally, a JMS queue or topic can be a Web Bean. Web Beans relieves the " +"developer from the tedium of managing the lifecycles of all the various JMS " +"objects required to send messages to queues and topics. We'll discuss JMS " +"endpoints in <xref linkend=\"jms\"/>." +msgstr "" Added: doc/trunk/reference/es-ES/modules/next.po =================================================================== --- doc/trunk/reference/es-ES/modules/next.po (rev 0) +++ doc/trunk/reference/es-ES/modules/next.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,49 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: next.xml:4 +#, no-c-format +msgid "Next steps" +msgstr "" + +#. Tag: para +#: next.xml:6 +#, no-c-format +msgid "" +"Because Web Beans is so new, there's not yet a lot of information available " +"online." +msgstr "" + +#. Tag: para +#: next.xml:9 +#, no-c-format +msgid "" +"Of course, the Web Beans specification is the best source of more " +"information about Web Beans. The spec is about 100 pages long, only twice " +"the length of this article, and almost as readable. But, of course, it " +"covers many details that we've skipped over. The spec is available from " +"<literal>http://jcp.org/en/jsr/detail?id=299</literal>." +msgstr "" + +#. Tag: para +#: next.xml:15 +#, no-c-format +msgid "" +"The Web Beans Reference implementation is being developed at <literal>http://" +"seamframework.org/WebBeans</literal>. The RI development team and the Web " +"Beans spec lead blog at <literal>http://in.relation.to</literal>. This " +"article is substantially based upon a series of blog entries published there." +msgstr "" Added: doc/trunk/reference/es-ES/modules/part1.po =================================================================== --- doc/trunk/reference/es-ES/modules/part1.po (rev 0) +++ doc/trunk/reference/es-ES/modules/part1.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,229 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part1.xml:5 +#, no-c-format +msgid "" +"The Web Beans (JSR-299) specification defines a set of services for the Java " +"EE environment that makes applications much easier to develop. Web Beans " +"layers an enhanced lifecycle and interaction model over existing Java " +"component types including JavaBeans and Enterprise Java Beans. As a " +"complement to the traditional Java EE programming model, the Web Beans " +"services provide:" +msgstr "" + +#. Tag: para +#: part1.xml:14 +#, no-c-format +msgid "" +"an improved lifecycle for stateful components, bound to well-defined " +"<emphasis>contexts</emphasis>," +msgstr "" + +#. Tag: para +#: part1.xml:18 +#, no-c-format +msgid "a typesafe approach to <emphasis>dependency injection</emphasis>," +msgstr "" + +#. Tag: para +#: part1.xml:21 +#, no-c-format +msgid "" +"interaction via an <emphasis>event notification</emphasis> facility, and" +msgstr "" + +#. Tag: para +#: part1.xml:25 +#, no-c-format +msgid "" +"a better approach to binding <emphasis>interceptors</emphasis> to " +"components, along with a new kind of interceptor, called a " +"<emphasis>decorator</emphasis>, that is more appropriate for use in solving " +"business problems." +msgstr "" + +#. Tag: para +#: part1.xml:32 +#, no-c-format +msgid "" +"Dependency injection, together with contextual lifecycle management, saves " +"the user of an unfamiliar API from having to ask and answer the following " +"questions:" +msgstr "" + +#. Tag: para +#: part1.xml:38 +#, no-c-format +msgid "what is the lifecycle of this object?" +msgstr "" + +#. Tag: para +#: part1.xml:41 +#, no-c-format +msgid "how many simultaneous clients can it have?" +msgstr "" + +#. Tag: para +#: part1.xml:44 +#, no-c-format +msgid "is it multithreaded?" +msgstr "" + +#. Tag: para +#: part1.xml:47 +#, no-c-format +msgid "where can I get one from?" +msgstr "" + +#. Tag: para +#: part1.xml:50 +#, no-c-format +msgid "do I need to explicitly destroy it?" +msgstr "" + +#. Tag: para +#: part1.xml:53 +#, no-c-format +msgid "where should I keep my reference to it when I'm not using it directly?" +msgstr "" + +#. Tag: para +#: part1.xml:57 +#, no-c-format +msgid "" +"how can I add an indirection layer, so that the implementation of this " +"object can vary at deployment time?" +msgstr "" + +#. Tag: para +#: part1.xml:61 +#, no-c-format +msgid "how should I go about sharing this object between other objects?" +msgstr "" + +#. Tag: para +#: part1.xml:65 +#, no-c-format +msgid "" +"A Web Bean specifies only the type and semantics of other Web Beans it " +"depends upon. It need not be aware of the actual lifecycle, concrete " +"implementation, threading model or other clients of any Web Bean it depends " +"upon. Even better, the concrete implementation, lifecycle and threading " +"model of a Web Bean it depends upon may vary according to the deployment " +"scenario, without affecting any client." +msgstr "" + +#. Tag: para +#: part1.xml:72 +#, no-c-format +msgid "" +"Events, interceptors and decorators enhance the <emphasis>loose-coupling</" +"emphasis> that is inherent in this model:" +msgstr "" + +#. Tag: para +#: part1.xml:77 +#, no-c-format +msgid "" +"<emphasis>event notifications</emphasis> decouple event producers from event " +"consumers," +msgstr "" + +#. Tag: para +#: part1.xml:81 +#, no-c-format +msgid "" +"<emphasis>interceptors</emphasis> decouple technical concerns from business " +"logic, and" +msgstr "" + +#. Tag: para +#: part1.xml:85 +#, no-c-format +msgid "" +"<emphasis>decorators</emphasis> allow business concerns to be " +"compartmentalized." +msgstr "" + +#. Tag: para +#: part1.xml:90 +#, no-c-format +msgid "" +"Most importantly, Web Beans provides all these facilities in a " +"<emphasis>typesafe</emphasis> way. Web Beans never uses string-based " +"identifiers to determine how collaborating objects fit together. And XML, " +"though it remains an option, is rarely used. Instead, Web Beans uses the " +"typing information that is already available in the Java object model, " +"together with a new pattern, called <emphasis>binding annotations</" +"emphasis>, to wire together Web Beans, their dependencies, their " +"interceptors and decorators and their event consumers." +msgstr "" + +#. Tag: para +#: part1.xml:100 +#, no-c-format +msgid "" +"The Web Beans services are general and apply to the following types of " +"components that exist in the Java EE environment:" +msgstr "" + +#. Tag: para +#: part1.xml:105 +#, no-c-format +msgid "all JavaBeans," +msgstr "" + +#. Tag: para +#: part1.xml:108 +#, no-c-format +msgid "all EJBs, and" +msgstr "" + +#. Tag: para +#: part1.xml:111 +#, no-c-format +msgid "all Servlets." +msgstr "" + +#. Tag: para +#: part1.xml:115 +#, no-c-format +msgid "" +"Web Beans even provides the necessary integration points so that other kinds " +"of components defined by future Java EE specifications or by non-standard " +"frameworks may be cleanly integrated with Web Beans, take advantage of the " +"Web Beans services, and interact with any other kind of Web Bean." +msgstr "" + +#. Tag: para +#: part1.xml:120 +#, no-c-format +msgid "" +"Web Beans was influenced by a number of existing Java frameworks, including " +"Seam, Guice and Spring. However, Web Beans has its own very distinct " +"character: more typesafe than Seam, more stateful and less XML-centric than " +"Spring, more web and enterprise-application capable than Guice." +msgstr "" + +#. Tag: para +#: part1.xml:125 +#, no-c-format +msgid "" +"Most importantly, Web Beans is a JCP standard that integrates cleanly with " +"Java EE, and with any Java SE environment where embeddable EJB Lite is " +"available." +msgstr "" Added: doc/trunk/reference/es-ES/modules/part2.po =================================================================== --- doc/trunk/reference/es-ES/modules/part2.po (rev 0) +++ doc/trunk/reference/es-ES/modules/part2.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,102 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part2.xml:5 +#, no-c-format +msgid "" +"The first major theme of Web Beans is <emphasis>loose coupling</emphasis>. " +"We've already seen three means of achieving loose coupling:" +msgstr "" + +#. Tag: para +#: part2.xml:10 +#, no-c-format +msgid "" +"<emphasis>deployment types</emphasis> enable deployment time polymorphism," +msgstr "" + +#. Tag: para +#: part2.xml:14 +#, no-c-format +msgid "<emphasis>producer methods</emphasis> enable runtime polymorphism, and" +msgstr "" + +#. Tag: para +#: part2.xml:18 +#, no-c-format +msgid "" +"<emphasis>contextual lifecycle management</emphasis> decouples Web Bean " +"lifecycles." +msgstr "" + +#. Tag: para +#: part2.xml:23 +#, no-c-format +msgid "" +"These techniques serve to enable loose coupling of client and server. The " +"client is no longer tightly bound to an implementation of an API, nor is it " +"required to manage the lifecycle of the server object. This approach lets " +"<emphasis>stateful objects interact as if they were services</emphasis>." +msgstr "" + +#. Tag: para +#: part2.xml:28 +#, no-c-format +msgid "" +"Loose coupling makes a system more <emphasis>dynamic</emphasis>. The system " +"can respond to change in a well-defined manner. In the past, frameworks that " +"attempted to provide the facilities listed above invariably did it by " +"sacrificing type safety. Web Beans is the first technology that achieves " +"this level of loose coupling in a typesafe way." +msgstr "" + +#. Tag: para +#: part2.xml:34 +#, no-c-format +msgid "" +"Web Beans provides three extra important facilities that further the goal of " +"loose coupling:" +msgstr "" + +#. Tag: para +#: part2.xml:39 +#, no-c-format +msgid "" +"<emphasis>interceptors</emphasis> decouple technical concerns from business " +"logic," +msgstr "" + +#. Tag: para +#: part2.xml:43 +#, no-c-format +msgid "" +"<emphasis>decorators</emphasis> may be used to decouple some business " +"concerns, and" +msgstr "" + +#. Tag: para +#: part2.xml:47 +#, no-c-format +msgid "" +"<emphasis>event notifications</emphasis> decouple event producers from event " +"consumers." +msgstr "" + +#. Tag: para +#: part2.xml:52 +#, no-c-format +msgid "Let's explore interceptors first." +msgstr "" Added: doc/trunk/reference/es-ES/modules/part3.po =================================================================== --- doc/trunk/reference/es-ES/modules/part3.po (rev 0) +++ doc/trunk/reference/es-ES/modules/part3.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,150 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part3.xml:5 +#, no-c-format +msgid "" +"The second major theme of Web Beans is <emphasis>strong typing</emphasis>. " +"The information about the dependencies, interceptors and decorators of a Web " +"Bean, and the information about event consumers for an event producer, is " +"contained in typesafe Java constructs that may be validated by the compiler." +msgstr "" + +#. Tag: para +#: part3.xml:10 +#, no-c-format +msgid "" +"You don't see string-based identifiers in Web Beans code, not because the " +"framework is hiding them from you using clever defaulting rulesso-" +"called \"configuration by convention\"but because there are simply no " +"strings there to begin with!" +msgstr "" + +#. Tag: para +#: part3.xml:15 +#, no-c-format +msgid "" +"The obvious benefit of this approach is that <emphasis>any</emphasis> IDE " +"can provide autocompletion, validation and refactoring without the need for " +"special tooling. But there is a second, less-immediately-obvious, benefit. " +"It turns out that when you start thinking of identifying objects, events or " +"interceptors via annotations instead of names, you have an opportunity to " +"lift the semantic level of your code." +msgstr "" + +#. Tag: para +#: part3.xml:21 +#, no-c-format +msgid "" +"Web Beans encourages you develop annotations that model concepts, for " +"example," +msgstr "" + +#. Tag: para +#: part3.xml:26 +#, no-c-format +msgid "<literal>@Asynchronous</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:29 +#, no-c-format +msgid "<literal>@Mock</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:32 +#, no-c-format +msgid "<literal>@Secure</literal> or" +msgstr "" + +#. Tag: para +#: part3.xml:35 +#, no-c-format +msgid "<literal>@Updated</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:39 +#, no-c-format +msgid "instead of using compound names like" +msgstr "" + +#. Tag: para +#: part3.xml:43 +#, no-c-format +msgid "<literal>asyncPaymentProcessor</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:46 +#, no-c-format +msgid "<literal>mockPaymentProcessor</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:49 +#, no-c-format +msgid "<literal>SecurityInterceptor</literal> or" +msgstr "" + +#. Tag: para +#: part3.xml:52 +#, no-c-format +msgid "<literal>DocumentUpdatedEvent</literal>." +msgstr "" + +#. Tag: para +#: part3.xml:56 +#, no-c-format +msgid "" +"The annotations are reusable. They help describe common qualities of " +"disparate parts of the system. They help us categorize and understand our " +"code. They help us deal with common concerns in a common way. They make our " +"code more literate and more understandable." +msgstr "" + +#. Tag: para +#: part3.xml:61 +#, no-c-format +msgid "" +"Web Beans <emphasis>stereotypes</emphasis> take this idea a step further. A " +"stereotype models a common <emphasis>role</emphasis> in your application " +"architecture. It encapsulates various properties of the role, including " +"scope, interceptor bindings, deployment type, etc, into a single reusable " +"package." +msgstr "" + +#. Tag: para +#: part3.xml:66 +#, no-c-format +msgid "" +"Even Web Beans XML metadata is strongly typed! There's no compiler for XML, " +"so Web Beans takes advantage of XML schemas to validate the Java types and " +"attributes that appear in XML. This approach turns out to make the XML more " +"literate, just like annotations made our Java code more literate." +msgstr "" + +#. Tag: para +#: part3.xml:71 +#, no-c-format +msgid "" +"We're now ready to meet some more advanced features of Web Beans. Bear in " +"mind that these features exist to make our code both easier to validate and " +"more understandable. Most of the time you don't ever really <emphasis>need</" +"emphasis> to use these features, but if you use them wisely, you'll come to " +"appreciate their power." +msgstr "" Added: doc/trunk/reference/es-ES/modules/part4.po =================================================================== --- doc/trunk/reference/es-ES/modules/part4.po (rev 0) +++ doc/trunk/reference/es-ES/modules/part4.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,52 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part4.xml:5 +#, no-c-format +msgid "" +"The third theme of Web Beans is <emphasis>integration</emphasis>. Web Beans " +"was designed to work in concert with other technologies, helping the " +"application developer fit the other technologies together. Web Beans is an " +"open technology. It forms a part of the Java EE ecosystem, and is itself the " +"foundation for a new ecosystem of portable extensions and integration with " +"existing frameworks and technologies." +msgstr "" + +#. Tag: para +#: part4.xml:12 +#, no-c-format +msgid "" +"We've already seen how Web Beans helps integrate EJB and JSF, allowing EJBs " +"to be bound directly to JSF pages. That's just the beginning. Web Beans " +"offers the same potential to diverse other technologies, such as Business " +"Process Management engines, other Web Frameworks, and third-party component " +"models. The Java EE platform will never be able to standardize all the " +"interesting technologies that are used in the world of Java application " +"development, but Web Beans makes it easier to use the technologies which are " +"not yet part of the platform seamlessly within the Java EE environment." +msgstr "" + +#. Tag: para +#: part4.xml:21 +#, no-c-format +msgid "" +"We're about to see how to take full advantage of the Java EE platform in an " +"application that uses Web Beans. We'll also briefly meet a set of SPIs that " +"are provided to support portable extensions to Web Beans. You might not ever " +"need to use these SPIs directly, but it's nice to know they are there if you " +"need them. Most importantly, you'll take advantage of them indirectly, every " +"time you use a third-party extension." +msgstr "" Added: doc/trunk/reference/es-ES/modules/producermethods.po =================================================================== --- doc/trunk/reference/es-ES/modules/producermethods.po (rev 0) +++ doc/trunk/reference/es-ES/modules/producermethods.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,246 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: producermethods.xml:5 +#, no-c-format +msgid "Producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:7 +#, no-c-format +msgid "" +"Producer methods let us overcome certain limitations that arise when the Web " +"Bean manager, instead of the application, is responsible for instantiating " +"objects. They're also the easiest way to integrate objects which are not Web " +"Beans into the Web Beans environment. (We'll meet a second approach in <xref " +"linkend=\"xml\"/>.)" +msgstr "" + +#. Tag: para +#: producermethods.xml:12 +#, no-c-format +msgid "According to the spec:" +msgstr "" + +#. Tag: chapter +#: producermethods.xml:12 +#, no-c-format +msgid "" +"<blockquote> <para>A Web Beans producer method acts as a source of objects " +"to be injected, where:</para> <itemizedlist> <listitem> <para>the objects to " +"be injected are not required to be instances of Web Beans,</para> </" +"listitem> <listitem> <para>the concrete type of the objects to be injected " +"may vary at runtime or</para> </listitem> <listitem> <para>the objects " +"require some custom initialization that is not performed by the Web Bean " +"constructor</para> </listitem> </itemizedlist> </blockquote> <para>For " +"example, producer methods let us:</para> <itemizedlist> <listitem> " +"<para>expose a JPA entity as a Web Bean,</para> </listitem> <listitem> " +"<para>expose any JDK class as a Web Bean,</para> </listitem> <listitem> " +"<para>define multiple Web Beans, with different scopes or initialization, " +"for the same implementation class, or</para> </listitem> <listitem> " +"<para>vary the implementation of an API type at runtime.</para> </listitem> " +"</itemizedlist> <para>In particular, producer methods let us use runtime " +"polymorphism with Web Beans. As we've seen, deployment types are a powerful " +"solution to the problem of deployment-time polymorphism. But once the system " +"is deployed, the Web Bean implementation is fixed. A producer method has no " +"such limitation:</para> <programlisting><![CDATA[@SessionScoped\n" +"public class Preferences {\n" +" \n" +" private PaymentStrategyType paymentStrategy;\n" +" \n" +" ...\n" +" \n" +" @Produces @Preferred \n" +" public PaymentStrategy getPaymentStrategy() {\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return new CreditCardPaymentStrategy();\n" +" case CHEQUE: return new ChequePaymentStrategy();\n" +" case PAYPAL: return new PayPalPaymentStrategy();\n" +" default: return null;\n" +" } \n" +" }\n" +" \n" +"}]]></programlisting> <para>Consider an injection point:</para> " +"<programlisting><![CDATA[@Preferred PaymentStrategy paymentStrat;]]></" +"programlisting> <para>This injection point has the same type and binding " +"annotations as the producer method, so it resolves to the producer method " +"using the usual Web Beans injection rules. The producer method will be " +"called by the Web Bean manager to obtain an instance to service this " +"injection point.</para>." +msgstr "" + +#. Tag: title +#: producermethods.xml:68 +#, no-c-format +msgid "Scope of a producer method" +msgstr "" + +#. Tag: para +#: producermethods.xml:70 +#, no-c-format +msgid "" +"The scope of the producer method defaults to <literal>@Dependent</literal>, " +"and so it will be called <emphasis>every time</emphasis> the Web Bean " +"manager injects this field or any other field that resolves to the same " +"producer method. Thus, there could be multiple instances of the " +"<literal>PaymentStrategy</literal> object for each user session." +msgstr "" + +#. Tag: para +#: producermethods.xml:75 +#, no-c-format +msgid "" +"To change this behavior, we can add a <literal>@SessionScoped</literal> " +"annotation to the method." +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:78 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy() {\n" +" ...\n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:80 +#, no-c-format +msgid "" +"Now, when the producer method is called, the returned " +"<literal>PaymentStrategy</literal> will be bound to the session context. The " +"producer method won't be called again in the same session." +msgstr "" + +#. Tag: title +#: producermethods.xml:87 +#, no-c-format +msgid "Injection into producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:89 +#, no-c-format +msgid "" +"There's one potential problem with the code above. The implementations of " +"<literal>CreditCardPaymentStrategy</literal> are instantiated using the Java " +"<literal>new</literal> operator. Objects instantiated directly by the " +"application can't take advantage of dependency injection and don't have " +"interceptors." +msgstr "" + +#. Tag: para +#: producermethods.xml:94 +#, no-c-format +msgid "" +"If this isn't what we want we can use dependency injection into the producer " +"method to obtain Web Bean instances:" +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:97 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy(CreditCardPaymentStrategy ccps,\n" +" ChequePaymentStrategy cps,\n" +" PayPalPaymentStrategy ppps) {\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return ccps;\n" +" case CHEQUE: return cps;\n" +" case PAYPAL: return ppps;\n" +" default: return null;\n" +" } \n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:99 +#, no-c-format +msgid "" +"Wait, what if <literal>CreditCardPaymentStrategy</literal> is a request " +"scoped Web Bean? Then the producer method has the effect of \"promoting\" " +"the current request scoped instance into session scope. This is almost " +"certainly a bug! The request scoped object will be destroyed by the Web Bean " +"manager before the session ends, but the reference to the object will be " +"left \"hanging\" in the session scope. This error will <emphasis>not</" +"emphasis> be detected by the Web Bean manager, so please take extra care " +"when returning Web Bean instances from producer methods!" +msgstr "" + +#. Tag: para +#: producermethods.xml:107 +#, no-c-format +msgid "" +"There's at least three ways we could go about fixing this bug. We could " +"change the scope of the <literal>CreditCardPaymentStrategy</literal> " +"implementation, but this would affect other clients of that Web Bean. A " +"better option would be to change the scope of the producer method to " +"<literal>@Dependent</literal> or <literal>@RequestScoped</literal>." +msgstr "" + +#. Tag: para +#: producermethods.xml:113 +#, no-c-format +msgid "" +"But a more common solution is to use the special <literal>@New</literal> " +"binding annotation." +msgstr "" + +#. Tag: title +#: producermethods.xml:119 +#, no-c-format +msgid "Use of <literal>@New</literal> with producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:121 +#, no-c-format +msgid "Consider the following producer method:" +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:123 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy(@New CreditCardPaymentStrategy " +"ccps,\n" +" @New ChequePaymentStrategy cps,\n" +" @New PayPalPaymentStrategy ppps) " +"{\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return ccps;\n" +" case CHEQUE: return cps;\n" +" case PAYPAL: return ppps;\n" +" default: return null;\n" +" } \n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:125 +#, no-c-format +msgid "" +"Then a new <emphasis>dependent</emphasis> instance of " +"<literal>CreditCardPaymentStrategy</literal> will be created, passed to the " +"producer method, returned by the producer method and finally bound to the " +"session context. The dependent object won't be destroyed until the " +"<literal>Preferences</literal> object is destroyed, at the end of the " +"session." +msgstr "" Added: doc/trunk/reference/es-ES/modules/ri.po =================================================================== --- doc/trunk/reference/es-ES/modules/ri.po (rev 0) +++ doc/trunk/reference/es-ES/modules/ri.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,898 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: ri.xml:4 +#, no-c-format +msgid "Using the Web Beans Reference Implementation" +msgstr "" + +#. Tag: para +#: ri.xml:6 +#, no-c-format +msgid "" +"The Web Beans RI comes with a two examples, <literal>webbeans-numberguess</" +"literal> (a war example, containing only simple beans) and <literal>webbeans-" +"translator</literal> (an ear example, containing enterprise beans)." +msgstr "" + +#. Tag: para +#: ri.xml:13 +#, no-c-format +msgid "" +"Currently, the Web Beans RI only runs on JBoss Application Server 5. You'll " +"need to download JBoss AS 5.0.0.GA from <ulink url=\"http://www.jboss.org/" +"jbossas/downloads/\">jboss.org</ulink>, and unzip it. For example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:20 +#, no-c-format +msgid "" +"<![CDATA[$ cd /Applications\n" +"$ unzip ~/jboss-5.0.0.GA.zip]]>" +msgstr "" + +#. Tag: para +#: ri.xml:22 +#, no-c-format +msgid "" +"Next, download the Web Beans RI from <ulink url=\"http://seamframework.org/" +"WebBeans\">seamframework.org</ulink>, and unzip it. For example" +msgstr "" + +#. Tag: programlisting +#: ri.xml:28 +#, no-c-format +msgid "" +"<![CDATA[$ cd ~/\n" +"$ unzip ~/webbeans-1.0.0.ALPHA1.zip]]>" +msgstr "" + +#. Tag: para +#: ri.xml:30 +#, no-c-format +msgid "" +"As Web Beans is a new piece of software, you need to update JBoss AS to run " +"the Web Beans RI. Future versions of JBoss AS will include these updates, " +"and this step won't be necessary." +msgstr "" + +#. Tag: para +#: ri.xml:37 +#, no-c-format +msgid "" +"Currently, two updates are needed. Firstly, a new deployer, " +"<literal>webbeans.deployer</literal> is added. This adds supports for Web " +"Bean archives to JBoss AS, and allows the Web Beans RI to query the EJB3 " +"container and discover which EJBs are installed in your application. " +"Secondly, an update to JBoss EJB3 is needed." +msgstr "" + +#. Tag: para +#: ri.xml:46 +#, no-c-format +msgid "" +"To install the update, you'll need ant 1.7.0 installed, and the " +"<literal>ANT_HOME</literal> environment variable set. For example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:51 +#, no-c-format +msgid "" +"$ unzip apache-ant-1.7.0.zip\n" +"$ export ANT_HOME=~/apache-ant-1.7.0" +msgstr "" + +#. Tag: para +#: ri.xml:53 +#, no-c-format +msgid "" +"Then, you can install the update. The update script will use Maven to " +"download the Web Beans and EJB3 automatically." +msgstr "" + +#. Tag: programlisting +#: ri.xml:58 +#, no-c-format +msgid "" +"$ cd webbeans-1.0.0.ALPHA1/jboss-as\n" +"$ ant update" +msgstr "" + +#. Tag: para +#: ri.xml:60 +#, no-c-format +msgid "Now, you're ready to deploy your first example!" +msgstr "" + +#. Tag: para +#: ri.xml:65 +#, no-c-format +msgid "" +"The build scripts for the examples offer a number of targets, these are:" +msgstr "" + +#. Tag: para +#: ri.xml:71 +#, no-c-format +msgid "<literal>ant restart</literal> - deploy the example in exploded format" +msgstr "" + +#. Tag: para +#: ri.xml:77 +#, no-c-format +msgid "" +"<literal>ant explode</literal> - update an exploded example, without " +"restarting the deployment" +msgstr "" + +#. Tag: para +#: ri.xml:83 +#, no-c-format +msgid "" +"<literal>ant deploy</literal> - deploy the example in compressed jar format" +msgstr "" + +#. Tag: para +#: ri.xml:88 +#, no-c-format +msgid "<literal>ant undeploy</literal> - remove the example from the server" +msgstr "" + +#. Tag: para +#: ri.xml:93 +#, no-c-format +msgid "<literal>ant clean</literal> - clean the example" +msgstr "" + +#. Tag: para +#: ri.xml:100 +#, no-c-format +msgid "To deploy the numberguess example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:104 +#, no-c-format +msgid "" +"$ cd examples/numberguess\n" +"ant deploy" +msgstr "" + +#. Tag: para +#: ri.xml:106 +#, no-c-format +msgid "" +"Wait for the application to deploy, and enjoy hours of fun at <ulink url=" +"\"http://localhost:8080/webbeans-numberguess\"></ulink>!" +msgstr "" + +#. Tag: para +#: ri.xml:111 +#, no-c-format +msgid "" +"The Web Beans RI includes a second simple example that will translate your " +"text into Latin. The numberguess example is a war example, and uses only " +"simple beans; the translator example is an ear example, and includes " +"enterprise beans, packaged in an EJB module. To try it out:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:118 +#, no-c-format +msgid "" +"$ cd examples/traslator\n" +"ant deploy" +msgstr "" + +#. Tag: para +#: ri.xml:120 +#, no-c-format +msgid "" +"Wait for the application to deploy, and visit <ulink url=\"http://" +"localhost:8080/webbeans-translator\"></ulink>!" +msgstr "" + +#. Tag: title +#: ri.xml:126 +#, no-c-format +msgid "The numberguess example" +msgstr "" + +#. Tag: para +#: ri.xml:128 +#, no-c-format +msgid "" +"In the numberguess application you get given 10 attempts to guess a number " +"between 1 and 100. After each attempt, you will be told whether you are too " +"high, or too low." +msgstr "" + +#. Tag: para +#: ri.xml:134 +#, no-c-format +msgid "" +"The numberguess example is comprised of a number of Web Beans, configuration " +"files, and Facelet JSF pages, packaged as a war. Let's start with the " +"configuration files." +msgstr "" + +#. Tag: para +#: ri.xml:140 +#, no-c-format +msgid "" +"All the configuration files for this example are located in <literal>WEB-INF/" +"</literal>, which is stored in <literal>WebContent</literal> in the source " +"tree. First, we have <literal>faces-config.xml</literal>, in which we tell " +"JSF to use Facelets:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:148 +#, no-c-format +msgid "" +"<![CDATA[<?xml version='1.0' encoding='UTF-8'?>\n" +"<faces-config version=\"1.2\"\n" +" xmlns=\"http://java.sun.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://" +"java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd\">\n" +" \n" +" <application>\n" +" <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>\n" +" </application>\n" +"\n" +"</faces-config>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:150 +#, no-c-format +msgid "" +"There is an empty <literal>web-beans.xml</literal> file, which marks this " +"application as a Web Beans application." +msgstr "" + +#. Tag: para +#: ri.xml:155 +#, no-c-format +msgid "Finally there is <literal>web.xml</literal>:" +msgstr "" + +#. Tag: section +#: ri.xml:157 +#, no-c-format +msgid "" +"<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> " +"<area id=\"faces.servlet.mapping\" coords=\"18\"/> <area id=\"faces.default." +"suffix\" coords=\"23\"/> <area id=\"session.timeout\" coords=\"28\"/> <area " +"id=\"webbeans.listener\" coords=\"32\"/> </areaspec> <programlisting><![CDATA" +"[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"\n" +"<web-app version=\"2.5\"\n" +" xmlns=\"http://java.sun.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun." +"com/xml/ns/javaee/web-app_2_5.xsd\">\n" +" \n" +" <display-name>Web Beans Numbergues example</display-name>\n" +"\n" +" \n" +"\n" +" <servlet>\n" +" <servlet-name>Faces Servlet</servlet-name>\n" +" <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>\n" +" <load-on-startup>1</load-on-startup>\n" +" </servlet>\n" +"\n" +" <servlet-mapping>\n" +" <servlet-name>Faces Servlet</servlet-name>\n" +" <url-pattern>*.jsf</url-pattern>\n" +" </servlet-mapping>\n" +" \n" +" <context-param>\n" +" <param-name>javax.faces.DEFAULT_SUFFIX</param-name>\n" +" <param-value>.xhtml</param-value>\n" +" </context-param>\n" +"\n" +" <session-config>\n" +" <session-timeout>10</session-timeout>\n" +" </session-config>\n" +" \n" +" <listener>\n" +" <listener-class>org.jboss.webbeans.servlet.WebBeansListener</listener-" +"class>\n" +" </listener>\n" +"\n" +"</web-app>]]></programlisting> <calloutlist> <callout arearefs=\"faces." +"servlet\"> <para> Enable and load the JSF servlet </para> </callout> " +"<callout arearefs=\"faces.servlet.mapping\"> <para> Configure requests to " +"<literal>.jsf</literal> pages to be handled by JSF </para> </callout> " +"<callout arearefs=\"faces.default.suffix\"> <para> Tell JSF that we will be " +"giving our source files (facelets) an extension of <literal>.jsf</literal> </" +"para> </callout> <callout arearefs=\"session.timeout\"> <para> Configure a " +"session timeout of 10 minutes </para> </callout> <callout arearefs=" +"\"webbeans.listener\"> <para> Configure the Web Beans listener, so that Web " +"Beans services can be used in the servlet request </para> </callout> </" +"calloutlist> </programlistingco> <note> <para> The only configuration " +"required by the Web Beans RI in <literal>web.xml</literal> is to add the Web " +"Beans listener. </para> <para> Whilst this demo is a JSF demo, you can use " +"the Web Beans RI with any Servlet based web framework; just configure the " +"Web Beans listener. </para> </note> <para> Let's take a look at the Facelet " +"view: </para> <programlistingco> <areaspec> <area id=\"template\" coords=\"8" +"\"/> <area id=\"messages\" coords=\"12\"/> <area id=\"instructions\" coords=" +"\"19\"/> <area id=\"guess\" coords=\"25\"/> <area id=\"validator\" coords=" +"\"29\"/> <area id=\"submit\" coords=\"32\"/> </areaspec> <programlisting><!" +"[CDATA[<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" " +"\"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\n" +"<html xmlns=\"http://www.w3.org/1999/xhtml\"\n" +" xmlns:ui=\"http://java.sun.com/jsf/facelets\"\n" +" xmlns:h=\"http://java.sun.com/jsf/html\"\n" +" xmlns:f=\"http://java.sun.com/jsf/core\"\n" +" xmlns:s=\"http://jboss.com/products/seam/taglib\">\n" +"\n" +" <ui:composition template=\"template.xhtml\">\n" +" <ui:define name=\"content\">\n" +" <h1>Guess a number...</h1>\n" +" <h:form id=\"NumberGuessMain\">\n" +" <div style=\"color: red\">\n" +" <h:messages id=\"messages\" globalOnly=\"false\"/>\n" +" <h:outputText id=\"Higher\" value=\"Higher!\" rendered=\"#{game." +"number gt game.guess}\"/>\n" +" <h:outputText id=\"Lower\" value=\"Lower!\" rendered=\"#{game." +"number lt game.guess}\"/>\n" +" </div>\n" +" \n" +" <div>\n" +" I'm thinking of a number between #{game.smallest} and #{game." +"biggest}.\n" +" You have #{game.remainingGuesses} guesses.\n" +" </div>\n" +" \n" +" <div>\n" +" Your guess: \n" +" <h:inputText id=\"inputGuess\" \n" +" value=\"#{game.guess}\" \n" +" required=\"true\" \n" +" size=\"3\">\n" +" <f:validateLongRange maximum=\"#{game.biggest}\" \n" +" minimum=\"#{game.smallest}\"/>\n" +" </h:inputText>\n" +" <h:commandButton id=\"GuessButton\" \n" +" value=\"Guess\" \n" +" action=\"#{game.check}\"/>\n" +" </div>\n" +" \n" +" </h:form>\n" +" </ui:define>\n" +" </ui:composition>\n" +"</html>]]></programlisting> <calloutlist> <callout arearefs=\"template\"> " +"<para> Facelets is a templating language for JSF, here we are wrapping our " +"page in a template which defines the header. </para> </callout> <callout " +"arearefs=\"messages\"> <para> There are a number of messages which can be " +"sent to the user, \"Higher!\", \"Lower!\" and \"Correct!\" </para> </" +"callout> <callout arearefs=\"instructions\"> <para> As the user guesses, the " +"range of numbers they can guess gets smaller - this sentance changes to make " +"sure they know what range to guess in. </para> </callout> <callout arearefs=" +"\"guess\"> <para> This input field is bound to a Web Bean, using the value " +"expression. </para> </callout> <callout arearefs=\"validator\"> <para> A " +"range validator is used to make sure the user doesn't accidentally input a " +"number outside of the range in which they can guess - if the validator " +"wasn't here, the user might use up a guess on an out of range number. </" +"para> </callout> <callout arearefs=\"submit\"> <para> And, of course, there " +"must be a way for the user to send their guess to the server. Here we bind " +"to an action method on the Web Bean. </para> </callout> </calloutlist> </" +"programlistingco>" +msgstr "" + +#. Tag: para +#: ri.xml:270 +#, no-c-format +msgid "" +"The example exists of 4 classes, the first two of which are binding types. " +"First, there is the <literal>@Random</literal> binding type, used for " +"injecting a random number:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:276 +#, no-c-format +msgid "" +"<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" +"@Retention(RUNTIME)\n" +"@Documented\n" +"@BindingType\n" +"public @interface Random {}]]>" +msgstr "" + +#. Tag: para +#: ri.xml:278 +#, no-c-format +msgid "" +"There is also the <literal>@MaxNumber</literal> binding type, used for " +"injecting the maximum number that can be injected:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:283 +#, no-c-format +msgid "" +"<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" +"@Retention(RUNTIME)\n" +"@Documented\n" +"@BindingType\n" +"public @interface MaxNumber {}\n" +"]]>" +msgstr "" + +#. Tag: para +#: ri.xml:285 +#, no-c-format +msgid "" +"The <literal>Generator</literal> class is responsible for creating the " +"random number, via a producer method. It also exposes the maximum possible " +"number via a producer method:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:291 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped\n" +"public class Generator {\n" +" \n" +" private java.util.Random random = new java.util.Random( System." +"currentTimeMillis() );\n" +" \n" +" private int maxNumber = 100;\n" +" \n" +" java.util.Random getRandom()\n" +" {\n" +" return random;\n" +" }\n" +" \n" +" @Produces @Random int next() { \n" +" return getRandom().nextInt(maxNumber); \n" +" }\n" +" \n" +" @Produces @MaxNumber int getMaxNumber()\n" +" {\n" +" return maxNumber;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: ri.xml:293 +#, no-c-format +msgid "" +"You'll notice that the <literal>Generator</literal> is application scoped; " +"therefore we don't get a different random each time." +msgstr "" + +#. Tag: para +#: ri.xml:298 +#, no-c-format +msgid "" +"The final Web Bean in the application is the session scoped <literal>Game</" +"literal>. By making <literal>Game</literal> session scoped, you can only " +"play the game once per browser session. You could easily add a reset button " +"- a good exercise for the reader :-)" +msgstr "" + +#. Tag: para +#: ri.xml:305 +#, no-c-format +msgid "" +"You'll also note that we've used the <literal>@Named</literal> annotation, " +"so that we can use the bean through EL in the JSF page. Finally, we've used " +"constructor injection to initialize the game with a random number. And of " +"course, we need to tell the player when they've won, so we give feedback " +"with a <literal>FacesMessage</literal>." +msgstr "" + +#. Tag: programlisting +#: ri.xml:313 +#, no-c-format +msgid "" +"<![CDATA[@Named\n" +"@SessionScoped\n" +"public class Game {\n" +" private int number;\n" +" \n" +" private int guess;\n" +" private int smallest;\n" +" private int biggest;\n" +" private int remainingGuesses;\n" +" \n" +" public Game() {}\n" +" \n" +" @Initializer\n" +" Game(@Random int number, @MaxNumber int maxNumber) {\n" +" this.number = number;\n" +" this.smallest = 1;\n" +" this.biggest = maxNumber;\n" +" this.remainingGuesses = 10;\n" +" }\n" +"\n" +" // Getters and setters for fields\n" +" \n" +" public String check() {\n" +" if (guess>number) {\n" +" biggest = guess - 1;\n" +" }\n" +" if (guess<number) {\n" +" smallest = guess + 1;\n" +" }\n" +" if (guess == number) {\n" +" FacesContext.getCurrentInstance().addMessage(null, new FacesMessage" +"(\"Correct!\"));\n" +" }\n" +" remainingGuesses--;\n" +" return null;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: title +#: ri.xml:317 +#, no-c-format +msgid "The translator example" +msgstr "" + +#. Tag: para +#: ri.xml:319 +#, no-c-format +msgid "" +"The translator example will take any sentences you enter, and translate them " +"to Latin." +msgstr "" + +#. Tag: para +#: ri.xml:324 +#, no-c-format +msgid "" +"The translator example is built as an ear, and contains EJBs and enterprise " +"beans. As a result, it's structure is more complex than the numberguess " +"example." +msgstr "" + +#. Tag: para +#: ri.xml:331 +#, no-c-format +msgid "" +"EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will make " +"this structure much simpler!" +msgstr "" + +#. Tag: para +#: ri.xml:337 +#, no-c-format +msgid "" +"First, let's take a look at the ear aggregator, which is located in " +"<literal>webbeans-translator-ear</literal> module. Maven automatically " +"generates the <literal>application.xml</literal> and <literal>jboss-app.xml</" +"literal> for us:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:344 +#, no-c-format +msgid "" +"<![CDATA[<plugin>\n" +" <groupId>org.apache.maven.plugins</groupId>\n" +" <artifactId>maven-ear-plugin</artifactId>\n" +" <configuration>\n" +" <modules>\n" +" <webModule>\n" +" <groupId>org.jboss.webbeans.examples.translator</groupId>\n" +" <artifactId>webbeans-translator-war</artifactId>\n" +" <contextRoot>/webbeans-translator</contextRoot>\n" +" </webModule>\n" +" </modules>\n" +" <jboss>\n" +" <loader-repository>webbeans.jboss.org:loader=webbeans-translator</" +"loader-repository>\n" +" </jboss>\n" +" </configuration>\n" +"</plugin>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:346 +#, no-c-format +msgid "" +"We're doing a couple of things here - firstly we set the context path, which " +"gives us a nice url (<ulink url=\"http://localhost:8080/webbeans-translator" +"\">http://localhost:8080/webbeans-translator</ulink>) and we also enable " +"class loader isolation for JBoss AS." +msgstr "" + +#. Tag: para +#: ri.xml:354 +#, no-c-format +msgid "" +"If you aren't using Maven to generate these files, you would need " +"<literal>META-INF/jboss-app.xml</literal>:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:359 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<!DOCTYPE jboss-app\n" +" PUBLIC \"-//JBoss//DTD J2EE Application 4.2//EN\"\n" +" \"http://www.jboss.org/j2ee/dtd/jboss-app_4_2.dtd\">\n" +"<jboss-app>\n" +" <loader-repository>webbeans.jboss.org:loader=webbeans-translator</loader-" +"repository>\n" +"</jboss-app>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:361 +#, no-c-format +msgid "and <literal>META-INF/application.xml</literal>:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:365 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<application xmlns=\"http://java.sun.com/xml/ns/javaee\" \n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://" +"java.sun.com/xml/ns/javaee/application_5.xsd\"\n" +" version=\"5\">\n" +" <display-name>webbeans-translator-ear</display-name>\n" +" <description>Ear Example for the reference implementation of JSR 299: Web " +"Beans</description>\n" +" \n" +" <module>\n" +" <web>\n" +" <web-uri>webbeans-translator.war</web-uri>\n" +" <context-root>/webbeans-translator</context-root>\n" +" </web>\n" +" </module>\n" +" <module>\n" +" <ejb>webbeans-translator.jar</ejb>\n" +" </module>\n" +"</application>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:368 +#, no-c-format +msgid "" +"Next, lets look at the war. Just as in the numberguess example, we have a " +"<literal>faces-config.xml</literal> (to enabled Facelets) and a <literal>web." +"xml</literal> (to enable JSF and attach Web Beans services to the servlet " +"container) in <literal>WebContent/WEB-INF</literal>." +msgstr "" + +#. Tag: para +#: ri.xml:375 +#, no-c-format +msgid "" +"More intersting is the facelet used to translate text. Just as in the " +"numberguess example we have a template, which surrounds the form (ommitted " +"here for brevity):" +msgstr "" + +#. Tag: programlisting +#: ri.xml:381 +#, no-c-format +msgid "" +"<![CDATA[<h:form id=\"NumberGuessMain\">\n" +" \n" +" <table>\n" +" <tr align=\"center\" style=\"font-weight: bold\" >\n" +" <td>\n" +" Your text\n" +" </td>\n" +" <td>\n" +" Translation\n" +" </td>\n" +" </tr>\n" +" <tr>\n" +" <td>\n" +" <h:inputTextarea id=\"text\" value=\"#{translator.text}\" " +"required=\"true\" rows=\"5\" cols=\"80\" />\n" +" </td>\n" +" <td>\n" +" <h:outputText value=\"#{translator.translatedText}\" />\n" +" </td>\n" +" </tr>\n" +" </table>\n" +" <div>\n" +" <h:commandButton id=\"button\" value=\"Translate\" action=\"#" +"{translator.translate}\"/>\n" +" </div>\n" +" \n" +"</h:form>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:383 +#, no-c-format +msgid "" +"The user can enter some text in the lefthand textarea, and hit the translate " +"button to see the result to the right." +msgstr "" + +#. Tag: para +#: ri.xml:388 +#, no-c-format +msgid "" +"Finally, let's look at the ejb module, <literal>webbeans-translator-ejb</" +"literal>. There are two configuration files in <literal>src/main/resources/" +"META-INF</literal>, an empty <literal>web-beans.xml</literal>, used to mark " +"the archive as containing Web Beans, and <literal>ejb-jar.xml</literal>. Web " +"Beans provides injection and initializtion services for all EJBs, and uses " +"<literal>ejb-jar.xml</literal> to enable this, you'll need this in any EJB " +"project which uses Web Beans:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:400 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar xmlns=\"http://java.sun.com/xml/ns/javaee\" \n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" \n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java." +"sun.com/xml/ns/javaee/ejb-jar_3_0.xsd\"\n" +" version=\"3.0\">\n" +" \n" +" <interceptors>\n" +" <interceptor>\n" +" <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</" +"interceptor-class>\n" +" </interceptor>\n" +" </interceptors>\n" +" \n" +" <assembly-descriptor>\n" +" <interceptor-binding>\n" +" <ejb-name>*</ejb-name>\n" +" <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</" +"interceptor-class>\n" +" </interceptor-binding>\n" +" </assembly-descriptor>\n" +" \n" +"</ejb-jar>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:402 +#, no-c-format +msgid "" +"We've saved the most interesting bit to last, the code! The project has two " +"simple beans, <literal>SentanceParser</literal> and <literal>TextTranslator</" +"literal> and two enterprise beans, <literal>TanslatorControllerBean</" +"literal> and <literal>SentenceTranslator</literal>. You should be getting " +"quite familiar with what a Web Bean looks like by now, so we'll just " +"highlight the most interesting bits here." +msgstr "" + +#. Tag: para +#: ri.xml:412 +#, no-c-format +msgid "" +"Both <literal>SentanceParser</literal> and <literal>TextTranslator</literal> " +"are dependent beans, and <literal>TextTranslator</literal> uses constructor " +"initialization:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:418 +#, no-c-format +msgid "" +"<![CDATA[public class TextTranslator { \n" +" private SentenceParser sentenceParser; \n" +" private Translator sentenceTranslator; \n" +" \n" +" @Initializer\n" +" TextTranslator(SentenceParser sentenceParser, Translator " +"sentenceTranslator) \n" +" { \n" +" this.sentenceParser = sentenceParser; \n" +" this.sentenceTranslator = sentenceTranslator;]]>" +msgstr "" + +#. Tag: para +#: ri.xml:420 +#, no-c-format +msgid "" +"<literal>TextTranslator</literal> is a stateless bean (with a local business " +"interface), where the magic happens - of course, we couldn't develop a full " +"translator, but we gave it a good go!" +msgstr "" + +#. Tag: para +#: ri.xml:426 +#, no-c-format +msgid "" +"Finally, there is UI orientated controller, that collects the text from the " +"user, and dispatches it to the translator. This is a request scoped, named, " +"stateful session bean, which injects the translator." +msgstr "" + +#. Tag: programlisting +#: ri.xml:432 +#, no-c-format +msgid "" +"<![CDATA[@Stateful\n" +"@RequestScoped\n" +"@Named(\"translator\")\n" +"public class TranslatorControllerBean implements TranslatorController\n" +"{\n" +" \n" +" @Current TextTranslator translator;]]>" +msgstr "" + +#. Tag: para +#: ri.xml:434 +#, no-c-format +msgid "The bean also has getters and setters for all the fields on the page." +msgstr "" + +#. Tag: para +#: ri.xml:438 +#, no-c-format +msgid "As this is a stateful session bean, we have to have a remove method:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:442 +#, no-c-format +msgid "" +"<![CDATA[ @Remove\n" +" public void remove()\n" +" {\n" +" \n" +" }]]>" +msgstr "" + +#. Tag: para +#: ri.xml:444 +#, no-c-format +msgid "" +"The Web Beans manager will call the remove method for you when the bean is " +"destroyed; in this case at the end of the request." +msgstr "" + +#. Tag: para +#: ri.xml:450 +#, no-c-format +msgid "" +"That concludes our short tour of the Web Beans RI examples. For more on the " +"RI, or to help out, please visit <ulink url=\"http://www.seamframework.org/" +"WebBeans/Development\">http://www.seamframework.org/WebBeans/Development</" +"ulink>." +msgstr "" + +#. Tag: para +#: ri.xml:456 +#, no-c-format +msgid "" +"We need help in all areas - bug fixing, writing new features, writing " +"examples and translating this reference guide." +msgstr "" Added: doc/trunk/reference/es-ES/modules/scopescontexts.po =================================================================== --- doc/trunk/reference/es-ES/modules/scopescontexts.po (rev 0) +++ doc/trunk/reference/es-ES/modules/scopescontexts.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,582 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: scopescontexts.xml:4 +#, no-c-format +msgid "Scopes and contexts" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:6 +#, no-c-format +msgid "" +"So far, we've seen a few examples of <emphasis>scope type annotations</" +"emphasis>. The scope of a Web Bean determines the lifecycle of instances of " +"the Web Bean. The scope also determines which clients refer to which " +"instances of the Web Bean. According to the Web Beans specification, a scope " +"determines:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:14 +#, no-c-format +msgid "When a new instance of any Web Bean with that scope is created" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:17 +#, no-c-format +msgid "When an existing instance of any Web Bean with that scope is destroyed" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:20 +#, no-c-format +msgid "" +"Which injected references refer to any instance of a Web Bean with that scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:25 +#, no-c-format +msgid "" +"For example, if we have a session scoped Web Bean, <literal>CurrentUser</" +"literal>, all Web Beans that are called in the context of the same " +"<literal>HttpSession</literal> will see the same instance of " +"<literal>CurrentUser</literal>. This instance will be automatically created " +"the first time a <literal>CurrentUser</literal> is needed in that session, " +"and automatically destroyed when the session ends." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:32 +#, no-c-format +msgid "Scope types" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:34 +#, no-c-format +msgid "" +"Web Beans features an <emphasis>extensible context model</emphasis>. It is " +"possible to define new scopes by creating a new scope type annotation:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:37 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD})\n" +"@ScopeType\n" +"public @interface ClusterScoped {}]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:39 +#, no-c-format +msgid "" +"Of course, that's the easy part of the job. For this scope type to be " +"useful, we will also need to define a <literal>Context</literal> object that " +"implements the scope! Implementing a <literal>Context</literal> is usually a " +"very technical task, intended for framework development only." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:44 +#, no-c-format +msgid "" +"We can apply a scope type annotation to a Web Bean implementation class to " +"specify the scope of the Web Bean:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:47 +#, no-c-format +msgid "" +"<![CDATA[@ClusterScoped\n" +"public class SecondLevelCache { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:58 +#, no-c-format +msgid "Usually, you'll use one of Web Beans' built-in scopes." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:63 +#, no-c-format +msgid "Built-in scopes" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:65 +#, no-c-format +msgid "Web Beans defines four built-in scopes:" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:69 +#, no-c-format +msgid "@RequestScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:72 +#, no-c-format +msgid "@SessionScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:75 +#, no-c-format +msgid "@ApplicationScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:78 +#, no-c-format +msgid "@ConversationScoped" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:82 +#, no-c-format +msgid "For a web application that uses Web Beans:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:86 +#, no-c-format +msgid "" +"any servlet request has access to active request, session and application " +"scopes, and, additionally" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:90 +#, no-c-format +msgid "any JSF request has access to an active conversation scope." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:94 +#, no-c-format +msgid "The request and application scopes are also active:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:98 +#, no-c-format +msgid "during invocations of EJB remote methods," +msgstr "" + +#. Tag: para +#: scopescontexts.xml:101 +#, no-c-format +msgid "during EJB timeouts," +msgstr "" + +#. Tag: para +#: scopescontexts.xml:104 +#, no-c-format +msgid "during message delivery to a message-driven bean, and" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:107 +#, no-c-format +msgid "during web service invocations." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:111 +#, no-c-format +msgid "" +"If the application tries to invoke a Web Bean with a scope that does not " +"have an active context, a <literal>ContextNotActiveException</literal> is " +"thrown by the Web Bean manager at runtime." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:115 +#, no-c-format +msgid "" +"Three of the four built-in scopes should be extremely familiar to every Java " +"EE developer, so let's not waste time discussing them here. One of the " +"scopes, however, is new." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:122 +#, no-c-format +msgid "The conversation scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:124 +#, no-c-format +msgid "" +"The Web Beans conversation scope is a bit like the traditional session scope " +"in that it holds state associated with a user of the system, and spans " +"multiple requests to the server. However, unlike the session scope, the " +"conversation scope:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:130 +#, no-c-format +msgid "is demarcated explicitly by the application, and" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:133 +#, no-c-format +msgid "" +"holds state associated with a particular web browser tab in a JSF " +"application." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:138 +#, no-c-format +msgid "" +"A conversation represents a task, a unit of work from the point of view of " +"the user. The conversation context holds state associated with what the user " +"is currently working on. If the user is doing multiple things at the same " +"time, there are multiple conversations." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:143 +#, no-c-format +msgid "" +"The conversation context is active during any JSF request. However, most " +"conversations are destroyed at the end of the request. If a conversation " +"should hold state across multiple requests, it must be explicitly promoted " +"to a <emphasis>long-running conversation</emphasis>." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:149 +#, no-c-format +msgid "Conversation demarcation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:151 +#, no-c-format +msgid "" +"Web Beans provides a built-in Web Bean for controlling the lifecyle of " +"conversations in a JSF application. This Web Bean may be obtained by " +"injection:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:154 +#, no-c-format +msgid "@Current Conversation conversation;" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:156 +#, no-c-format +msgid "" +"To promote the conversation associated with the current request to a long-" +"running conversation, call the <literal>begin()</literal> method from " +"application code. To schedule the current long-running conversation context " +"for destruction at the end of the current request, call <literal>end()</" +"literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:161 +#, no-c-format +msgid "" +"In the following example, a conversation-scoped Web Bean controls the " +"conversation with which it is associated:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:164 +#, no-c-format +msgid "" +"@ConversationScoped @Stateful\n" +"public class OrderBuilder {\n" +"\n" +" private Order order;\n" +" private @Current Conversation conversation;\n" +" private @PersistenceContext(type=EXTENDED) EntityManager em;\n" +" \n" +" @Produces public Order getOrder() {\n" +" return order;\n" +" }\n" +"\n" +" public Order createOrder() {\n" +" order = new Order();\n" +" conversation.begin();\n" +" return order;\n" +" }\n" +" \n" +" public void addLineItem(Product product, int quantity) {\n" +" order.add( new LineItem(product, quantity) );\n" +" }\n" +"\n" +" public void saveOrder(Order order) {\n" +" em.persist(order);\n" +" conversation.end();\n" +" }\n" +" \n" +" @Remove\n" +" public void destroy() {}\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:166 +#, no-c-format +msgid "" +"This Web Bean is able to control its own lifecycle through use of the " +"<literal>Conversation</literal> API. But some other Web Beans have a " +"lifecycle which depends completely upon another object." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:173 +#, no-c-format +msgid "Conversation propagation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:175 +#, no-c-format +msgid "" +"The conversation context automatically propagates with any JSF faces request " +"(JSF form submission). It does not automatically propagate with non-faces " +"requests, for example, navigation via a link." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:179 +#, no-c-format +msgid "" +"We can force the conversation to propagate with a non-faces request by " +"including the unique identifier of the conversation as a request parameter. " +"The Web Beans specification reserves the request parameter named " +"<literal>cid</literal> for this use. The unique identifier of the " +"conversation may be obtained from the <literal>Conversation</literal> " +"object, which has the Web Beans name <literal>conversation</literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:186 +#, no-c-format +msgid "Therefore, the following link propagates the conversation:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:188 +#, no-c-format +msgid "" +"<![CDATA[<a href=\"/addProduct.jsp?cid=#{conversation.id}\">Add Product</a>]]" +">" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:190 +#, no-c-format +msgid "" +"The Web Bean manager is also required to propagate conversations across any " +"redirect, even if the conversation is not marked long-running. This makes it " +"very easy to implement the common POST-then-redirect pattern, without resort " +"to fragile constructs such as a \"flash\" object. In this case, the Web Bean " +"manager automatically adds a request parameter to the redirect URL." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:200 +#, no-c-format +msgid "Conversation timeout" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:202 +#, no-c-format +msgid "" +"The Web Bean manager is permitted to destroy a conversation and all state " +"held in its context at any time in order to preserve resources. A Web Bean " +"manager implementation will normally do this on the basis of some kind of " +"timeoutthough this is not required by the Web Beans specification. The " +"timeout is the period of inactivity before the conversation is destroyed." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:208 +#, no-c-format +msgid "" +"The <literal>Conversation</literal> object provides a method to set the " +"timeout. This is a hint to the Web Bean manager, which is free to ignore the " +"setting." +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:212 +#, no-c-format +msgid "conversation.setTimeout(timeoutInMillis);" +msgstr "" + +#. Tag: title +#: scopescontexts.xml:219 +#, no-c-format +msgid "The dependent pseudo-scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:221 +#, no-c-format +msgid "" +"In addition to the four built-in scopes, Web Beans features the so-called " +"<emphasis>dependent pseudo-scope</emphasis>. This is the default scope for a " +"Web Bean which does not explicitly declare a scope type." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:225 +#, no-c-format +msgid "" +"For example, this Web Bean has the scope type <literal>@Dependent</literal>:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:227 +#, no-c-format +msgid "<![CDATA[public class Calculator { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:229 +#, no-c-format +msgid "" +"When an injection point of a Web Bean resolves to a dependent Web Bean, a " +"new instance of the dependent Web Bean is created every time the first Web " +"Bean is instantiated. Instances of dependent Web Beans are never shared " +"between different Web Beans or different injection points. They are " +"<emphasis>dependent objects</emphasis> of some other Web Bean instance." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:235 +#, no-c-format +msgid "" +"Dependent Web Bean instances are destroyed when the instance they depend " +"upon is destroyed." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:243 +#, no-c-format +msgid "" +"Web Beans makes it easy to obtain a dependent instance of a Java class or " +"EJB bean, even if the class or EJB bean is already declared as a Web Bean " +"with some other scope type." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:248 +#, no-c-format +msgid "The <literal>@New</literal> annotation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:250 +#, no-c-format +msgid "" +"The built-in <literal>@New</literal> binding annotation allows " +"<emphasis>implicit</emphasis> definition of a dependent Web Bean at an " +"injection point. Suppose we declare the following injected field:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:254 +#, no-c-format +msgid "<![CDATA[@New Calculator calculator;]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:256 +#, no-c-format +msgid "" +"Then a Web Bean with scope <literal>@Dependent</literal>, binding type " +"<literal>@New</literal>, API type <literal>Calculator</literal>, " +"implementation class <literal>Calculator</literal> and deployment type " +"<literal>@Standard</literal> is implicitly defined." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:261 +#, no-c-format +msgid "" +"This is true even if <literal>Calculator</literal> is <emphasis>already</" +"emphasis> declared with a different scope type, for example:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:264 +#, no-c-format +msgid "" +"<![CDATA[@ConversationScoped\n" +"public class Calculator { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:266 +#, no-c-format +msgid "" +"So the following injected attributes each get a different instance of " +"<literal>Calculator</literal>:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:269 +#, no-c-format +msgid "" +"<![CDATA[public class PaymentCalc {\n" +"\n" +" @Current Calculator calculator;\n" +" @New Calculator newCalculator;\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:271 +#, no-c-format +msgid "" +"The <literal>calculator</literal> field has a conversation-scoped instance " +"of <literal>Calculator</literal> injected. The <literal>newCalculator</" +"literal> field has a new instance of <literal>Calculator</literal> injected, " +"with a lifecycle that is bound to the owning <literal>PaymentCalc</literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:276 +#, no-c-format +msgid "" +"This feature is particularly useful with producer methods, as we'll see in " +"the next chapter." +msgstr "" Added: doc/trunk/reference/es-ES/modules/specialization.po =================================================================== --- doc/trunk/reference/es-ES/modules/specialization.po (rev 0) +++ doc/trunk/reference/es-ES/modules/specialization.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,291 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: specialization.xml:4 +#, no-c-format +msgid "Specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:6 +#, no-c-format +msgid "" +"We've already seen how the Web Beans dependency injection model lets us " +"<emphasis>override</emphasis> the implementation of an API at deployment " +"time. For example, the following enterprise Web Bean provides an " +"implementation of the API <literal>PaymentProcessor</literal> in production:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:11 +#, no-c-format +msgid "" +"@CreditCard @Stateless\n" +"public class CreditCardPaymentProcessor \n" +" implements PaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:13 +#, no-c-format +msgid "" +"But in our staging environment, we override that implementation of " +"<literal>PaymentProcessor</literal> with a different Web Bean:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:16 +#, no-c-format +msgid "" +"@CreditCard @Stateless @Staging\n" +"public class StagingCreditCardPaymentProcessor \n" +" implements PaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:18 +#, no-c-format +msgid "" +"What we've tried to do with <literal>StagingCreditCardPaymentProcessor</" +"literal> is to completely replace <literal>AsyncPaymentProcessor</literal> " +"in a particular deployment of the system. In that deployment, the deployment " +"type <literal>@Staging</literal> would have a higher priority than the " +"default deployment type <literal>@Production</literal>, and therefore " +"clients with the following injection point:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:24 +#, no-c-format +msgid "@CreditCard PaymentProcessor ccpp" +msgstr "" + +#. Tag: para +#: specialization.xml:26 +#, no-c-format +msgid "" +"Would receive an instance of <literal>StagingCreditCardPaymentProcessor</" +"literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:28 +#, no-c-format +msgid "Unfortunately, there are several traps we can easily fall into:" +msgstr "" + +#. Tag: para +#: specialization.xml:32 +#, no-c-format +msgid "" +"the higher-priority Web Bean may not implement all the API types of the Web " +"Bean that it attempts to override," +msgstr "" + +#. Tag: para +#: specialization.xml:36 +#, no-c-format +msgid "" +"the higher-priority Web Bean may not declare all the binding types of the " +"Web Bean that it attempts to override," +msgstr "" + +#. Tag: para +#: specialization.xml:40 +#, no-c-format +msgid "" +"the higher-priority Web Bean might not have the same name as the Web Bean " +"that it attempts to override, or" +msgstr "" + +#. Tag: para +#: specialization.xml:44 +#, no-c-format +msgid "" +"the Web Bean that it attempts to override might declare a producer method, " +"disposal method or observer method." +msgstr "" + +#. Tag: para +#: specialization.xml:49 +#, no-c-format +msgid "" +"In each of these cases, the Web Bean that we tried to override could still " +"be called at runtime. Therefore, overriding is somewhat prone to developer " +"error." +msgstr "" + +#. Tag: para +#: specialization.xml:52 +#, no-c-format +msgid "" +"Web Beans provides a special feature, called <emphasis>specialization</" +"emphasis>, that helps the developer avoid these traps. Specialization looks " +"a little esoteric at first, but it's easy to use in practice, and you'll " +"really appreciate the extra security it provides." +msgstr "" + +#. Tag: title +#: specialization.xml:58 +#, no-c-format +msgid "Using specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:60 +#, no-c-format +msgid "" +"Specialization is a feature that is specific to simple and enterprise Web " +"Beans. To make use of specialization, the higher-priority Web Bean must:" +msgstr "" + +#. Tag: para +#: specialization.xml:65 +#, no-c-format +msgid "be a direct subclass of the Web Bean it overrides, and" +msgstr "" + +#. Tag: para +#: specialization.xml:68 +#, no-c-format +msgid "" +"be a simple Web Bean if the Web Bean it overrides is a simple Web Bean or an " +"enterprise Web Bean if the Web Bean it overrides is an enterprise Web Bean, " +"and" +msgstr "" + +#. Tag: para +#: specialization.xml:73 +#, no-c-format +msgid "be annotated <literal>@Specializes</literal>." +msgstr "" + +#. Tag: programlisting +#: specialization.xml:77 +#, no-c-format +msgid "" +"@Stateless @Staging @Specializes\n" +"public class StagingCreditCardPaymentProcessor \n" +" extends CreditCardPaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:79 +#, no-c-format +msgid "" +"We say that the higher-priority Web Bean <emphasis>specializes</emphasis> " +"its superclass." +msgstr "" + +#. Tag: title +#: specialization.xml:85 +#, no-c-format +msgid "Advantages of specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:87 +#, no-c-format +msgid "When specialization is used:" +msgstr "" + +#. Tag: para +#: specialization.xml:91 +#, no-c-format +msgid "" +"the binding types of the superclass are automatically inherited by the Web " +"Bean annotated <literal>@Specializes</literal>, and" +msgstr "" + +#. Tag: para +#: specialization.xml:95 +#, no-c-format +msgid "" +"the Web Bean name of the superclass is automatically inherited by the Web " +"Bean annotated <literal>@Specializes</literal>, and" +msgstr "" + +#. Tag: para +#: specialization.xml:99 +#, no-c-format +msgid "" +"producer methods, disposal methods and observer methods declared by the " +"superclass are called upon an instance of the Web Bean annotated " +"<literal>@Specializes</literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:105 +#, no-c-format +msgid "" +"In our example, the binding type <literal>@CreditCard</literal> of " +"<literal>CreditCardPaymentProcessor</literal> is inherited by " +"<literal>StagingCreditCardPaymentProcessor</literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:109 +#, no-c-format +msgid "Furthermore, the Web Bean manager will validate that:" +msgstr "" + +#. Tag: para +#: specialization.xml:113 +#, no-c-format +msgid "" +"all API types of the superclass are API types of the Web Bean annotated " +"<literal>@Specializes</literal> (all local interfaces of the superclass " +"enterprise bean are also local interfaces of the subclass)," +msgstr "" + +#. Tag: para +#: specialization.xml:119 +#, no-c-format +msgid "" +"the deployment type of the Web Bean annotated <literal>@Specializes</" +"literal> has a higher precedence than the deployment type of the superclass, " +"and" +msgstr "" + +#. Tag: para +#: specialization.xml:124 +#, no-c-format +msgid "" +"there is no other enabled Web Bean that also specializes the superclass." +msgstr "" + +#. Tag: para +#: specialization.xml:129 +#, no-c-format +msgid "" +"If any of these conditions are violated, the Web Bean manager throws an " +"exception at initialization time." +msgstr "" + +#. Tag: para +#: specialization.xml:132 +#, no-c-format +msgid "" +"Therefore, we can be certain that the superclass with <emphasis>never</" +"emphasis> be called in any deployment of the system where the Web Bean " +"annotated <literal>@Specializes</literal> is deployed and enabled." +msgstr "" Added: doc/trunk/reference/es-ES/modules/stereotypes.po =================================================================== --- doc/trunk/reference/es-ES/modules/stereotypes.po (rev 0) +++ doc/trunk/reference/es-ES/modules/stereotypes.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,352 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: stereotypes.xml:4 +#, no-c-format +msgid "Stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:6 +#, no-c-format +msgid "According to the Web Beans specification:" +msgstr "" + +#. Tag: para +#: stereotypes.xml:10 +#, no-c-format +msgid "" +"In many systems, use of architectural patterns produces a set of recurring " +"Web Bean roles. A stereotype allows a framework developer to identify such a " +"role and declare some common metadata for Web Beans with that role in a " +"central place." +msgstr "" + +#. Tag: para +#: stereotypes.xml:14 +#, no-c-format +msgid "A stereotype encapsulates any combination of:" +msgstr "" + +#. Tag: para +#: stereotypes.xml:18 +#, no-c-format +msgid "a default deployment type," +msgstr "" + +#. Tag: para +#: stereotypes.xml:21 +#, no-c-format +msgid "a default scope type," +msgstr "" + +#. Tag: para +#: stereotypes.xml:24 +#, no-c-format +msgid "a restriction upon the Web Bean scope," +msgstr "" + +#. Tag: para +#: stereotypes.xml:27 +#, no-c-format +msgid "a requirement that the Web Bean implement or extend a certain type, and" +msgstr "" + +#. Tag: para +#: stereotypes.xml:30 +#, no-c-format +msgid "a set of interceptor binding annotations." +msgstr "" + +#. Tag: para +#: stereotypes.xml:34 +#, no-c-format +msgid "" +"A stereotype may also specify that all Web Beans with the stereotype have " +"defaulted Web Bean names." +msgstr "" + +#. Tag: para +#: stereotypes.xml:37 +#, no-c-format +msgid "A Web Bean may declare zero, one or multiple stereotypes." +msgstr "" + +#. Tag: para +#: stereotypes.xml:41 +#, no-c-format +msgid "" +"A stereotype is a Java annotation type. This stereotype identifies action " +"classes in some MVC framework:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:44 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:46 +#, no-c-format +msgid "We use the stereotype by applying the annotation to a Web Bean." +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:48 +#, no-c-format +msgid "" +"<![CDATA[@Action \n" +"public class LoginAction { ... }]]>" +msgstr "" + +#. Tag: title +#: stereotypes.xml:51 +#, no-c-format +msgid "Default scope and deployment type for a stereotype" +msgstr "" + +#. Tag: para +#: stereotypes.xml:53 +#, no-c-format +msgid "" +"A stereotype may specify a default scope and/or default deployment type for " +"Web Beans with that stereotype. For example, if the deployment type " +"<literal>@WebTier</literal> identifies Web Beans that should only be " +"deployed when the system executes as a web application, we might specify the " +"following defaults for action classes:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:59 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:61 +#, no-c-format +msgid "" +"Of course, a particular action may still override these defaults if " +"necessary:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:64 +#, no-c-format +msgid "" +"<![CDATA[@Dependent @Mock @Action \n" +"public class MockLoginAction { ... }]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:66 +#, no-c-format +msgid "" +"If we want to force all actions to a particular scope, we can do that too." +msgstr "" + +#. Tag: title +#: stereotypes.xml:72 +#, no-c-format +msgid "Restricting scope and type with a stereotype" +msgstr "" + +#. Tag: para +#: stereotypes.xml:74 +#, no-c-format +msgid "" +"Suppose that we wish to prevent actions from declaring certain scopes. Web " +"Beans lets us explicitly specify the set of allowed scopes for Web Beans " +"with a certain stereotype. For example:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:78 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype(supportedScopes=RequestScoped.class)\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:80 +#, no-c-format +msgid "" +"If a particular action class attempts to specify a scope other than the Web " +"Beans request scope, an exception will be thrown by the Web Bean manager at " +"initialization time." +msgstr "" + +#. Tag: para +#: stereotypes.xml:84 +#, no-c-format +msgid "" +"We can also force all Web Bean with a certain stereotype to implement an " +"interface or extend a class:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:87 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype(requiredTypes=AbstractAction.class)\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:89 +#, no-c-format +msgid "" +"If a particular action class does not extend the class " +"<literal>AbstractAction</literal>, an exception will be thrown by the Web " +"Bean manager at initialization time." +msgstr "" + +#. Tag: title +#: stereotypes.xml:96 +#, no-c-format +msgid "Interceptor bindings for stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:98 +#, no-c-format +msgid "" +"A stereotype may specify a set of interceptor bindings to be inherited by " +"all Web Beans with that stereotype." +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:101 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@Transactional(requiresNew=true)\n" +"@Secure\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:103 +#, no-c-format +msgid "" +"This helps us get technical concerns even further away from the business " +"code!" +msgstr "" + +#. Tag: title +#: stereotypes.xml:109 +#, no-c-format +msgid "Name defaulting with stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:111 +#, no-c-format +msgid "" +"Finally, we can specify that all Web Beans with a certain stereotype have a " +"Web Bean name, defaulted by the Web Bean manager. Actions are often " +"referenced in JSP pages, so they're a perfect use case for this feature. All " +"we need to do is add an empty <literal>@Named</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:116 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@Transactional(requiresNew=true)\n" +"@Secure\n" +"@Named\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:118 +#, no-c-format +msgid "" +"Now, <literal>LoginAction</literal> will have the name <literal>loginAction</" +"literal>." +msgstr "" + +#. Tag: title +#: stereotypes.xml:124 +#, no-c-format +msgid "Standard stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:126 +#, no-c-format +msgid "" +"We've already met two standard stereotypes defined by the Web Beans " +"specification: <literal>@Interceptor</literal> and <literal>@Decorator</" +"literal>." +msgstr "" + +#. Tag: para +#: stereotypes.xml:129 +#, no-c-format +msgid "Web Beans defines one further standard stereotype:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:131 +#, no-c-format +msgid "" +"<![CDATA[@Named \n" +"@RequestScoped \n" +"@Stereotype \n" +"@Target({TYPE, METHOD}) \n" +"@Retention(RUNTIME) \n" +"public @interface Model {} ]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:133 +#, no-c-format +msgid "" +"This stereotype is intended for use with JSF. Instead of using JSF managed " +"beans, just annotate a Web Bean <literal>@Model</literal>, and use it " +"directly in your JSF page." +msgstr "" Added: doc/trunk/reference/es-ES/modules/xml.po =================================================================== --- doc/trunk/reference/es-ES/modules/xml.po (rev 0) +++ doc/trunk/reference/es-ES/modules/xml.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,352 @@ +# Language es-ES translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: xml.xml:4 +#, no-c-format +msgid "Defining Web Beans using XML" +msgstr "" + +#. Tag: para +#: xml.xml:6 +#, no-c-format +msgid "" +"So far, we've seen plenty of examples of Web Beans declared using " +"annotations. However, there are a couple of occasions when we can't use " +"annotations to define the Web Bean:" +msgstr "" + +#. Tag: para +#: xml.xml:12 +#, no-c-format +msgid "when the implementation class comes from some preexisting library, or" +msgstr "" + +#. Tag: para +#: xml.xml:15 +#, no-c-format +msgid "" +"when there should be multiple Web Beans with the same implementation class." +msgstr "" + +#. Tag: para +#: xml.xml:20 +#, no-c-format +msgid "In either of these cases, Web Beans gives us two options:" +msgstr "" + +#. Tag: para +#: xml.xml:23 +#, no-c-format +msgid "write a producer method, or" +msgstr "" + +#. Tag: para +#: xml.xml:24 +#, no-c-format +msgid "declare the Web Bean using XML." +msgstr "" + +#. Tag: para +#: xml.xml:27 +#, no-c-format +msgid "" +"Many frameworks use XML to provide metadata relating to Java classes. " +"However, Web Beans uses a very different approach to specifying the names of " +"Java classes, fields or methods to most other frameworks. Instead of writing " +"class and member names as the string values of XML elements and attributes, " +"Web Beans lets you use the class or member name as the name of the XML " +"element." +msgstr "" + +#. Tag: para +#: xml.xml:33 +#, no-c-format +msgid "" +"The advantage of this approach is that you can write an XML schema that " +"prevents spelling errors in your XML document. It's even possible for a tool " +"to generate the XML schema automatically from the compiled Java code. Or, an " +"integrated development environment could perform the same validation without " +"the need for the explicit intermediate generation step." +msgstr "" + +#. Tag: title +#: xml.xml:40 +#, no-c-format +msgid "Declaring Web Bean classes" +msgstr "" + +#. Tag: para +#: xml.xml:42 +#, no-c-format +msgid "" +"For each Java package, Web Beans defines a corresponding XML namespace. The " +"namespace is formed by prepending <literal>urn:java:</literal> to the Java " +"package name. For the package <literal>com.mydomain.myapp</literal>, the XML " +"namespace is <literal>urn:java:com.mydomain.myapp</literal>." +msgstr "" + +#. Tag: para +#: xml.xml:47 +#, no-c-format +msgid "" +"Java types belonging to a package are referred to using an XML element in " +"the namespace corresponding to the package. The name of the element is the " +"name of the Java type. Fields and methods of the type are specified by child " +"elements in the same namespace. If the type is an annotation, members are " +"specified by attributes of the element." +msgstr "" + +#. Tag: para +#: xml.xml:53 +#, no-c-format +msgid "" +"For example, the element <literal><util:Date/></literal> in the " +"following XML fragment refers to the class <literal>java.util.Date</literal>:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:56 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans xmlns=\"urn:java:javax.webbeans\"\n" +" xmlns:util=\"urn:java:java.util\">\n" +"\n" +" <util:Date/>\n" +"\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:58 +#, no-c-format +msgid "" +"And this is all the code we need to declare that <literal>Date</literal> is " +"a simple Web Bean! An instance of <literal>Date</literal> may now be " +"injected by any other Web Bean:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:62 +#, no-c-format +msgid "<![CDATA[@Current Date date]]>" +msgstr "" + +#. Tag: title +#: xml.xml:67 +#, no-c-format +msgid "Declaring Web Bean metadata" +msgstr "" + +#. Tag: para +#: xml.xml:69 +#, no-c-format +msgid "" +"We can declare the scope, deployment type and interceptor binding types " +"using direct child elements of the Web Bean declaration:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:72 +#, no-c-format +msgid "" +"<![CDATA[<myapp:ShoppingCart>\n" +" <SessionScoped/>\n" +" <myfwk:Transactional requiresNew=\"true\"/>\n" +" <myfwk:Secure/>\n" +"</myapp:ShoppingCart>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:74 +#, no-c-format +msgid "We use exactly the same approach to specify names and binding type:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:76 +#, no-c-format +msgid "" +"<![CDATA[<util:Date>\n" +" <Named>currentTime</Named>\n" +"</util:Date>\n" +"\n" +"<util:Date>\n" +" <SessionScoped/>\n" +" <myapp:Login/>\n" +" <Named>loginTime</Named>\n" +"</util:Date>\n" +"\n" +"<util:Date>\n" +" <ApplicationScoped/>\n" +" <myapp:SystemStart/>\n" +" <Named>systemStartTime</Named>\n" +"</util:Date>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:78 +#, no-c-format +msgid "" +"Where <literal>@Login</literal> and <literal>@SystemStart</literal> are " +"binding annotations types." +msgstr "" + +#. Tag: programlisting +#: xml.xml:81 +#, no-c-format +msgid "" +"<![CDATA[@Current Date currentTime;\n" +"@Login Date loginTime;\n" +"@SystemStart Date systemStartTime;]]>" +msgstr "" + +#. Tag: para +#: xml.xml:83 +#, no-c-format +msgid "As usual, a Web Bean may support multiple binding types:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:85 +#, no-c-format +msgid "" +"<![CDATA[<myapp:AsynchronousChequePaymentProcessor>\n" +" <myapp:PayByCheque/>\n" +" <myapp:Asynchronous/>\n" +"</myapp:AsynchronousChequePaymentProcessor>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:87 +#, no-c-format +msgid "" +"Interceptors and decorators are just simple Web Beans, so they may be " +"declared just like any other simple Web Bean:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:90 +#, no-c-format +msgid "" +"<![CDATA[<myfwk:TransactionInterceptor>\n" +" <Interceptor/>\n" +" <myfwk:Transactional/>\n" +"</myfwk:TransactionInterceptor>]]>" +msgstr "" + +#. Tag: title +#: xml.xml:95 +#, no-c-format +msgid "Declaring Web Bean members" +msgstr "" + +#. Tag: para +#: xml.xml:97 +#, no-c-format +msgid "TODO!" +msgstr "" + +#. Tag: title +#: xml.xml:104 +#, no-c-format +msgid "Declaring inline Web Beans" +msgstr "" + +#. Tag: para +#: xml.xml:106 +#, no-c-format +msgid "Web Beans lets us define a Web Bean at an injection point. For example:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:108 +#, no-c-format +msgid "" +"<![CDATA[<myapp:System>\n" +" <ApplicationScoped/>\n" +" <myapp:admin>\n" +" <myapp:Name>\n" +" <myapp:firstname>Gavin</myapp:firstname>\n" +" <myapp:lastname>King</myapp:lastname>\n" +" <myapp:email>gavin(a)hibernate.org</myapp:email>\n" +" </myapp:Name>\n" +" </myapp:admin>\n" +"</myapp:System>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:110 +#, no-c-format +msgid "" +"The <literal><Name></literal> element declares a simple Web Bean of " +"scope <literal>@Dependent</literal> and class <literal>Name</literal>, with " +"a set of initial field values. This Web Bean has a special, container-" +"generated binding and is therefore injectable only to the specific injection " +"point at which it is declared." +msgstr "" + +#. Tag: para +#: xml.xml:116 +#, no-c-format +msgid "" +"This simple but powerful feature allows the Web Beans XML format to be used " +"to specify whole graphs of Java objects. It's not quite a full databinding " +"solution, but it's close!" +msgstr "" + +#. Tag: title +#: xml.xml:123 +#, no-c-format +msgid "Using a schema" +msgstr "" + +#. Tag: para +#: xml.xml:125 +#, no-c-format +msgid "" +"If we want our XML document format to be authored by people who aren't Java " +"developers, or who don't have access to our code, we need to provide a " +"schema. There's nothing specific to Web Beans about writing or using the " +"schema." +msgstr "" + +#. Tag: programlisting +#: xml.xml:130 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans xmlns=\"urn:java:javax.webbeans\"\n" +" xmlns:myapp=\"urn:java:com.mydomain.myapp\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"urn:java:javax.webbeans http://java.sun.com/" +"jee/web-beans-1.0.xsd\n" +" urn:java:com.mydomain.myapp http://mydomain." +"com/xsd/myapp-1.2.xsd\">\n" +"\n" +" <myapp:System>\n" +" ...\n" +" </myapp:System>\n" +"\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:132 +#, no-c-format +msgid "" +"Writing an XML schema is quite tedious. Therefore, the Web Beans RI project " +"will provide a tool which automatically generates the XML schema from " +"compiled Java code." +msgstr "" Added: doc/trunk/reference/fr-FR/Book_Info.po =================================================================== --- doc/trunk/reference/fr-FR/Book_Info.po (rev 0) +++ doc/trunk/reference/fr-FR/Book_Info.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,56 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: 2008-12-19 20:29+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: Book_Info.xml:6 +#, no-c-format +msgid "Introduction to Web Beans" +msgstr "" + +#. Tag: subtitle +#: Book_Info.xml:7 +#, no-c-format +msgid "" +"The new Java standard for dependency injection and contextual state " +"management" +msgstr "" + +#. Tag: author +#: Book_Info.xml:10 +#, no-c-format +msgid "<firstname>Gavin</firstname> <surname>King</surname>" +msgstr "" + +#. Tag: affiliation +#: Book_Info.xml:13 +#, no-c-format +msgid "" +"<jobtitle>Web Beans (JSR-299) specification lead</jobtitle> <orgname>Red Hat " +"Middleware LLC</orgname>" +msgstr "" + +#. Tag: author +#: Book_Info.xml:19 +#, no-c-format +msgid "<firstname>Pete</firstname> <surname>Muir</surname>" +msgstr "" + +#. Tag: affiliation +#: Book_Info.xml:22 +#, no-c-format +msgid "" +"<jobtitle>Web Beans (JSR-299) Reference Implementation lead</jobtitle> " +"<orgname>Red Hat Middleware LLC</orgname>" +msgstr "" Added: doc/trunk/reference/fr-FR/master.po =================================================================== --- doc/trunk/reference/fr-FR/master.po (rev 0) +++ doc/trunk/reference/fr-FR/master.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,38 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: master.xml:12 +#, no-c-format +msgid "Using contextual objects" +msgstr "" + +#. Tag: title +#: master.xml:25 +#, no-c-format +msgid "Developing loosely-coupled code" +msgstr "" + +#. Tag: title +#: master.xml:35 +#, no-c-format +msgid "Making the most of strong typing" +msgstr "" + +#. Tag: title +#: master.xml:46 +#, no-c-format +msgid "Web Beans and the Java EE ecosystem" +msgstr "" Added: doc/trunk/reference/fr-FR/modules/decorators.po =================================================================== --- doc/trunk/reference/fr-FR/modules/decorators.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/decorators.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,243 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: decorators.xml:4 +#, no-c-format +msgid "Decorators" +msgstr "" + +#. Tag: para +#: decorators.xml:6 +#, no-c-format +msgid "" +"Interceptors are a powerful way to capture and separate concerns which are " +"<emphasis>orthogonal</emphasis> to the type system. Any interceptor is able " +"to intercept invocations of any Java type. This makes them perfect for " +"solving technical concerns such as transaction management and security. " +"However, by nature, interceptors are unaware of the actual semantics of the " +"events they intercept. Thus, interceptors aren't an appropriate tool for " +"separating business-related concerns." +msgstr "" + +#. Tag: para +#: decorators.xml:14 +#, no-c-format +msgid "" +"The reverse is true of <emphasis>decorators</emphasis>. A decorator " +"intercepts invocations only for a certain Java interface, and is therefore " +"aware of all the semantics attached to that interface. This makes decorators " +"a perfect tool for modeling some kinds of business concerns. It also means " +"that a decorator doesn't have the generality of an interceptor. Decorators " +"aren't able to solve technical concerns that cut across many disparate types." +msgstr "" + +#. Tag: para +#: decorators.xml:22 +#, no-c-format +msgid "Suppose we have an interface that represents accounts:" +msgstr "" + +#. Tag: programlisting +#: decorators.xml:24 +#, no-c-format +msgid "" +"<![CDATA[public interface Account {\n" +" public BigDecimal getBalance();\n" +" public User getOwner();\n" +" public void withdraw(BigDecimal amount);\n" +" public void deposit(BigDecimal amount);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:26 +#, no-c-format +msgid "" +"Several different Web Beans in our system implement the <literal>Account</" +"literal> interface. However, we have a common legal requirement that, for " +"any kind of account, large transactions must be recorded by the system in a " +"special log. This is a perfect job for a decorator." +msgstr "" + +#. Tag: para +#: decorators.xml:32 +#, no-c-format +msgid "" +"A decorator is a simple Web Bean that implements the type it decorates and " +"is annotated <literal>@Decorator</literal>." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:35 +#, no-c-format +msgid "" +"<![CDATA[@Decorator\n" +"public abstract class LargeTransactionDecorator \n" +" implements Account {\n" +" \n" +" @Decorates Account account;\n" +" \n" +" @PersistenceContext EntityManager em;\n" +" \n" +" public void withdraw(BigDecimal amount) {\n" +" account.withdraw(amount);\n" +" if ( amount.compareTo(LARGE_AMOUNT)>0 ) {\n" +" em.persist( new LoggedWithdrawl(amount) );\n" +" }\n" +" }\n" +" \n" +" public void deposit(BigDecimal amount);\n" +" account.deposit(amount);\n" +" if ( amount.compareTo(LARGE_AMOUNT)>0 ) {\n" +" em.persist( new LoggedDeposit(amount) );\n" +" }\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:37 +#, no-c-format +msgid "" +"Unlike other simple Web Beans, a decorator may be an abstract class. If " +"there's nothing special the decorator needs to do for a particular method of " +"the decorated interface, you don't need to implement that method." +msgstr "" + +#. Tag: title +#: decorators.xml:43 +#, no-c-format +msgid "Delegate attributes" +msgstr "" + +#. Tag: para +#: decorators.xml:45 +#, no-c-format +msgid "" +"All decorators have a <emphasis>delegate attribute</emphasis>. The type and " +"binding types of the delegate attribute determine which Web Beans the " +"decorator is bound to. The delegate attribute type must implement or extend " +"all interfaces implemented by the decorator." +msgstr "" + +#. Tag: para +#: decorators.xml:50 +#, no-c-format +msgid "" +"This delegate attribute specifies that the decorator is bound to all Web " +"Beans that implement <literal>Account</literal>:" +msgstr "" + +#. Tag: programlisting +#: decorators.xml:53 +#, no-c-format +msgid "<![CDATA[@Decorates Account account;]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:55 +#, no-c-format +msgid "" +"A delegate attribute may specify a binding annotation. Then the decorator " +"will only be bound to Web Beans with the same binding." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:58 +#, no-c-format +msgid "<![CDATA[@Decorates @Foreign Account account;]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:60 +#, no-c-format +msgid "A decorator is bound to any Web Bean which:" +msgstr "" + +#. Tag: para +#: decorators.xml:64 +#, no-c-format +msgid "has the type of the delegate attribute as an API type, and" +msgstr "" + +#. Tag: para +#: decorators.xml:67 +#, no-c-format +msgid "has all binding types that are declared by the delegate attribute." +msgstr "" + +#. Tag: para +#: decorators.xml:71 +#, no-c-format +msgid "" +"The decorator may invoke the delegate attribute, which has much the same " +"effect as calling <literal>InvocationContext.proceed()</literal> from an " +"interceptor." +msgstr "" + +#. Tag: title +#: decorators.xml:78 +#, no-c-format +msgid "Enabling decorators" +msgstr "" + +#. Tag: para +#: decorators.xml:80 +#, no-c-format +msgid "" +"We need to <emphasis>enable</emphasis> our decorator in <literal>web-beans." +"xml</literal>." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:83 +#, no-c-format +msgid "" +"<![CDATA[<Decorators>\n" +" <myapp:LargeTransactionDecorator/>\n" +"</Decorators>]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:85 +#, no-c-format +msgid "" +"This declaration serves the same purpose for decorators that the " +"<literal><Interceptors></literal> declaration serves for interceptors:" +msgstr "" + +#. Tag: para +#: decorators.xml:90 +#, no-c-format +msgid "" +"it enables us to specify a total ordering for all decorators in our system, " +"ensuring deterministic behavior, and" +msgstr "" + +#. Tag: para +#: decorators.xml:94 +#, no-c-format +msgid "it lets us enable or disable decorator classes at deployment time." +msgstr "" + +#. Tag: para +#: decorators.xml:98 +#, no-c-format +msgid "" +"Interceptors for a method are called before decorators that apply to that " +"method." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/ee.po =================================================================== --- doc/trunk/reference/fr-FR/modules/ee.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/ee.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,329 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: ee.xml:4 +#, no-c-format +msgid "Java EE integration" +msgstr "" + +#. Tag: para +#: ee.xml:6 +#, no-c-format +msgid "" +"Web Beans is fully integrated into the Java EE environment. Web Beans have " +"access to Java EE resources and JPA persistence contexts. They may be used " +"in Unified EL expressions in JSF and JSP pages. They may even be injected " +"into some objects, such as Servlets and Message-Driven Beans, which are not " +"Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:12 +#, no-c-format +msgid "Injecting Java EE resources into a Web Bean" +msgstr "" + +#. Tag: para +#: ee.xml:14 +#, no-c-format +msgid "" +"All simple and enterprise Web Beans may take advantage of Java EE dependency " +"injection using <literal>@Resource</literal>, <literal>@EJB</literal> and " +"<literal>@PersistenceContext</literal>. We've already seen a couple of " +"examples of this, though we didn't pay much attention at the time:" +msgstr "" + +#. Tag: programlisting +#: ee.xml:19 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +"\n" +" @Resource Transaction transaction;\n" +"\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: ee.xml:21 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped\n" +"public class Login {\n" +"\n" +" @Current Credentials credentials;\n" +" @PersistenceContext EntityManager userDatabase;\n" +" \n" +" ...\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: ee.xml:23 +#, no-c-format +msgid "" +"The Java EE <literal>@PostConstruct</literal> and <literal>@PreDestroy</" +"literal> callbacks are also supported for all simple and enterprise Web " +"Beans. The <literal>@PostConstruct</literal> method is called after " +"<emphasis>all</emphasis> injection has been performed." +msgstr "" + +#. Tag: para +#: ee.xml:28 +#, no-c-format +msgid "" +"There is one restriction to be aware of here: <literal>@PersistenceContext" +"(type=EXTENDED)</literal> is not supported for simple Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:35 +#, no-c-format +msgid "Calling a Web Bean from a Servlet" +msgstr "" + +#. Tag: para +#: ee.xml:37 +#, no-c-format +msgid "" +"It's easy to use a Web Bean from a Servlet in Java EE 6. Simply inject the " +"Web Bean using Web Beans field or initializer method injection." +msgstr "" + +#. Tag: programlisting +#: ee.xml:40 +#, no-c-format +msgid "" +"public class Login extends HttpServlet {\n" +"\n" +" @Current Credentials credentials;\n" +" @Current Login login;\n" +"\n" +" @Override\n" +" public void service(HttpServletRequest request, HttpServletResponse " +"response)\n" +" throws ServletException, IOException {\n" +" credentials.setUsername( request.getAttribute(\"username\") ):\n" +" credentials.setPassword( request.getAttribute(\"password\") ):\n" +" login.login();\n" +" if ( login.isLoggedIn() ) {\n" +" response.sendRedirect(\"/home.jsp\");\n" +" }\n" +" else {\n" +" response.sendRedirect(\"/loginError.jsp\");\n" +" }\n" +" }\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:42 +#, no-c-format +msgid "" +"The Web Beans client proxy takes care of routing method invocations from the " +"Servlet to the correct instances of <literal>Credentials</literal> and " +"<literal>Login</literal> for the current request and HTTP session." +msgstr "" + +#. Tag: title +#: ee.xml:49 +#, no-c-format +msgid "Calling a Web Bean from a Message-Driven Bean" +msgstr "" + +#. Tag: para +#: ee.xml:51 +#, no-c-format +msgid "" +"Web Beans injection applies to all EJBs, even when they aren't under the " +"control of the Web Bean manager (if they were obtained by direct JNDI " +"lookup, or injection using <literal>@EJB</literal>, for example. In " +"particular, you can use Web Beans injection in Message-Driven Beans, which " +"are not considered Web Beans because you can't inject them." +msgstr "" + +#. Tag: para +#: ee.xml:57 +#, no-c-format +msgid "" +"You can even use Web Beans interceptor bindings for Message-Driven Beans." +msgstr "" + +#. Tag: programlisting +#: ee.xml:59 +#, no-c-format +msgid "" +"@Transactional @MessageDriven\n" +"public class ProcessOrder implements MessageListener {\n" +"\n" +" @Current Inventory inventory;\n" +" @PersistenceContext EntityManager em;\n" +"\n" +" public void onMessage(Message message) {\n" +" ...\n" +" }\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:61 +#, no-c-format +msgid "" +"Thus, receiving messages is super-easy in a Web Beans environment. But " +"beware that there is no session or conversation context available when a " +"message is delivered to a Message-Driven Bean. Only <literal>@RequestScoped</" +"literal> and <literal>@ApplicationScoped</literal> Web Beans are available." +msgstr "" + +#. Tag: para +#: ee.xml:66 +#, no-c-format +msgid "It's also easy to send messages using Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:71 +#, no-c-format +msgid "JMS endpoints" +msgstr "" + +#. Tag: para +#: ee.xml:73 +#, no-c-format +msgid "" +"Sending messages using JMS can be quite complex, because of the number of " +"different objects you need to deal with. For queues we have <literal>Queue</" +"literal>, <literal>QueueConnectionFactory</literal>, " +"<literal>QueueConnection</literal>, <literal>QueueSession</literal> and " +"<literal>QueueSender</literal>. For topics we have <literal>Topic</literal>, " +"<literal>TopicConnectionFactory</literal>, <literal>TopicConnection</" +"literal>, <literal>TopicSession</literal> and <literal>TopicPublisher</" +"literal>. Each of these objects has its own lifecycle and threading model " +"that we need to worry about." +msgstr "" + +#. Tag: para +#: ee.xml:82 +#, no-c-format +msgid "" +"Web Beans takes care of all this for us. All we need to do is declare the " +"queue or topic in <literal>web-beans.xml</literal>, specifying an associated " +"binding type and connection factory." +msgstr "" + +#. Tag: programlisting +#: ee.xml:86 +#, no-c-format +msgid "" +"<![CDATA[<Queue>\n" +" <destination>java:comp/env/jms/OrderQueue</destination>\n" +" <connectionFactory>java:comp/env/jms/QueueConnectionFactory</" +"connectionFactory>\n" +" <myapp:OrderProcessor/> \n" +"</Queue>]]>" +msgstr "" + +#. Tag: programlisting +#: ee.xml:88 +#, no-c-format +msgid "" +"<![CDATA[<Topic>\n" +" <destination>java:comp/env/jms/StockPrices</destination>\n" +" <connectionFactory>java:comp/env/jms/TopicConnectionFactory</" +"connectionFactory>\n" +" <myapp:StockPrices/> \n" +"</Topic>]]>" +msgstr "" + +#. Tag: para +#: ee.xml:90 +#, no-c-format +msgid "" +"Now we can just inject the <literal>Queue</literal>, " +"<literal>QueueConnection</literal>, <literal>QueueSession</literal> or " +"<literal>QueueSender</literal> for a queue, or the <literal>Topic</literal>, " +"<literal>TopicConnection</literal>, <literal>TopicSession</literal> or " +"<literal>TopicPublisher</literal> for a topic." +msgstr "" + +#. Tag: programlisting +#: ee.xml:96 +#, no-c-format +msgid "" +"@OrderProcessor QueueSender orderSender;\n" +"@OrderProcessor QueueSession orderSession;\n" +"\n" +"public void sendMessage() {\n" +" MapMessage msg = orderSession.createMapMessage();\n" +" ...\n" +" orderSender.send(msg);\n" +"}" +msgstr "" + +#. Tag: programlisting +#: ee.xml:98 +#, no-c-format +msgid "" +"@StockPrices TopicPublisher pricePublisher;\n" +"@StockPrices TopicSession priceSession;\n" +"\n" +"public void sendMessage(String price) {\n" +" pricePublisher.send( priceSession.createTextMessage(price) );\n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:100 +#, no-c-format +msgid "" +"The lifecycle of the injected JMS objects are completely controlled by the " +"Web Bean manager." +msgstr "" + +#. Tag: title +#: ee.xml:106 +#, no-c-format +msgid "Packaging and deployment" +msgstr "" + +#. Tag: para +#: ee.xml:108 +#, no-c-format +msgid "" +"Web Beans doesn't define any special deployment archive. You can package Web " +"Beans in JARs, EJB-JARs or WARsany deployment location in the " +"application classpath. However, each archive that contains Web Beans must " +"include a file named <literal>web-beans.xml</literal> in the <literal>META-" +"INF</literal> or <literal>WEB-INF</literal> directory. The file may be " +"empty. Web Beans deployed in archives that do not have a <literal>web-beans." +"xml</literal> file will not be available for use in the application." +msgstr "" + +#. Tag: para +#: ee.xml:116 +#, no-c-format +msgid "" +"For Java SE execution, Web Beans may be deployed in any location in which " +"EJBs may be deployed for execution by the embeddable EJB Lite container. " +"Again, each location must contain a <literal>web-beans.xml</literal> file." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/events.po =================================================================== --- doc/trunk/reference/fr-FR/modules/events.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/events.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,649 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: events.xml:4 +#, no-c-format +msgid "Events" +msgstr "" + +#. Tag: para +#: events.xml:6 +#, no-c-format +msgid "" +"The Web Beans event notification facility allows Web Beans to interact in a " +"totally decoupled manner. Event <emphasis>producers</emphasis> raise events " +"that are then delivered to event <emphasis>observers</emphasis> by the Web " +"Bean manager. This basic schema might sound like the familiar observer/" +"observable pattern, but there are a couple of twists:" +msgstr "" + +#. Tag: para +#: events.xml:14 +#, no-c-format +msgid "" +"not only are event producers decoupled from observers; observers are " +"completely decoupled from producers," +msgstr "" + +#. Tag: para +#: events.xml:18 +#, no-c-format +msgid "" +"observers can specify a combination of \"selectors\" to narrow the set of " +"event notifications they will receive, and" +msgstr "" + +#. Tag: para +#: events.xml:22 +#, no-c-format +msgid "" +"observers can be notified immediately, or can specify that delivery of the " +"event should be delayed until the end of the current transaction" +msgstr "" + +#. Tag: title +#: events.xml:28 +#, no-c-format +msgid "Event observers" +msgstr "" + +#. Tag: para +#: events.xml:30 +#, no-c-format +msgid "" +"An <emphasis>observer method</emphasis> is a method of a Web Bean with a " +"parameter annotated <literal>@Observes</literal>." +msgstr "" + +#. Tag: programlisting +#: events.xml:33 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyDocumentEvent(@Observes Document document) " +"{ ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:35 +#, no-c-format +msgid "" +"The annotated parameter is called the <emphasis>event parameter</emphasis>. " +"The type of the event parameter is the observed <emphasis>event type</" +"emphasis>. Observer methods may also specify \"selectors\", which are just " +"instances of Web Beans binding types. When a binding type is used as an " +"event selector, it is called an <emphasis>event binding type</emphasis>." +msgstr "" + +#. Tag: programlisting +#: events.xml:41 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Target({PARAMETER, FIELD})\n" +"@Retention(RUNTIME)\n" +"public @interface Updated { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:43 +#, no-c-format +msgid "" +"We specify the event bindings of the observer method by annotating the event " +"parameter:" +msgstr "" + +#. Tag: programlisting +#: events.xml:46 events.xml:190 +#, no-c-format +msgid "" +"<![CDATA[public void afterDocumentUpdate(@Observes @Updated Document " +"document) { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:48 +#, no-c-format +msgid "" +"An observer method need not specify any event bindingsin this case it " +"is interested in <emphasis>all</emphasis> events of a particular type. If it " +"does specify event bindings, it is only interested in events which also have " +"those event bindings." +msgstr "" + +#. Tag: para +#: events.xml:53 +#, no-c-format +msgid "" +"The observer method may have additional parameters, which are injected " +"according to the usual Web Beans method parameter injection semantics:" +msgstr "" + +#. Tag: programlisting +#: events.xml:56 +#, no-c-format +msgid "" +"<![CDATA[public void afterDocumentUpdate(@Observes @Updated Document " +"document, User user) { ... }]]>" +msgstr "" + +#. Tag: title +#: events.xml:61 +#, no-c-format +msgid "Event producers" +msgstr "" + +#. Tag: para +#: events.xml:63 +#, no-c-format +msgid "" +"The event producer may obtain an <emphasis>event notifier</emphasis> object " +"by injection:" +msgstr "" + +#. Tag: programlisting +#: events.xml:66 +#, no-c-format +msgid "<![CDATA[@Observable Event<Document> documentEvent]]>" +msgstr "" + +#. Tag: para +#: events.xml:68 +#, no-c-format +msgid "" +"The <literal>@Observable</literal> annotation implicitly defines a Web Bean " +"with scope <literal>@Dependent</literal> and deployment type " +"<literal>@Standard</literal>, with an implementation provided by the Web " +"Bean manager." +msgstr "" + +#. Tag: para +#: events.xml:72 +#, no-c-format +msgid "" +"A producer raises events by calling the <literal>fire()</literal> method of " +"the <literal>Event</literal> interface, passing an <emphasis>event object</" +"emphasis>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:75 +#, no-c-format +msgid "<![CDATA[documentEvent.fire(document);]]>" +msgstr "" + +#. Tag: para +#: events.xml:77 +#, no-c-format +msgid "" +"An event object may be an instance of any Java class that has no type " +"variables or wildcard type parameters. The event will be delivered to every " +"observer method that:" +msgstr "" + +#. Tag: para +#: events.xml:83 events.xml:107 events.xml:126 +#, no-c-format +msgid "has an event parameter to which the event object is assignable, and" +msgstr "" + +#. Tag: para +#: events.xml:86 +#, no-c-format +msgid "specifies no event bindings." +msgstr "" + +#. Tag: para +#: events.xml:90 +#, no-c-format +msgid "" +"The Web Bean manager simply calls all the observer methods, passing the " +"event object as the value of the event parameter. If any observer method " +"throws an exception, the Web Bean manager stops calling observer methods, " +"and the exception is rethrown by the <literal>fire()</literal> method." +msgstr "" + +#. Tag: para +#: events.xml:95 +#, no-c-format +msgid "" +"To specify a \"selector\", the event producer may pass an instance of the " +"event binding type to the <literal>fire()</literal> method:" +msgstr "" + +#. Tag: programlisting +#: events.xml:98 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.fire( document, new AnnotationLiteral<Updated>()" +"{} );]]>" +msgstr "" + +#. Tag: para +#: events.xml:100 +#, no-c-format +msgid "" +"The helper class <literal>AnnotationLiteral</literal> makes it possible to " +"instantiate binding types inline, since this is otherwise difficult to do in " +"Java." +msgstr "" + +#. Tag: para +#: events.xml:103 +#, no-c-format +msgid "The event will be delivered to every observer method that:" +msgstr "" + +#. Tag: para +#: events.xml:110 +#, no-c-format +msgid "" +"does not specify any event binding <emphasis>except</emphasis> for the event " +"bindings passed to <literal>fire()</literal>." +msgstr "" + +#. Tag: para +#: events.xml:115 +#, no-c-format +msgid "" +"Alternatively, event bindings may be specified by annotating the event " +"notifier injection point:" +msgstr "" + +#. Tag: programlisting +#: events.xml:118 +#, no-c-format +msgid "<![CDATA[@Observable @Updated Event<Document> documentUpdatedEvent]]>" +msgstr "" + +#. Tag: para +#: events.xml:120 +#, no-c-format +msgid "" +"Then every event fired via this instance of <literal>Event</literal> has the " +"annotated event binding. The event will be delivered to every observer " +"method that:" +msgstr "" + +#. Tag: para +#: events.xml:129 +#, no-c-format +msgid "" +"does not specify any event binding <emphasis>except</emphasis> for the event " +"bindings passed to <literal>fire()</literal> or the annotated event bindings " +"of the event notifier injection point." +msgstr "" + +#. Tag: title +#: events.xml:138 +#, no-c-format +msgid "Registering observers dynamically" +msgstr "" + +#. Tag: para +#: events.xml:140 +#, no-c-format +msgid "" +"It's often useful to register an event observer dynamically. The application " +"may implement the <literal>Observer</literal> interface and register an " +"instance with an event notifier by calling the <literal>observe()</literal> " +"method." +msgstr "" + +#. Tag: programlisting +#: events.xml:144 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.observe( new Observer<Document>() { public void notify" +"(Document doc) { ... } } );]]>" +msgstr "" + +#. Tag: para +#: events.xml:146 +#, no-c-format +msgid "" +"Event binding types may be specified by the event notifier injection point " +"or by passing event binding type instances to the <literal>observe()</" +"literal> method:" +msgstr "" + +#. Tag: programlisting +#: events.xml:149 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.observe( new Observer<Document>() { public void notify" +"(Document doc) { ... } }, \n" +" new " +"AnnotationLiteral<Updated>(){} );]]>" +msgstr "" + +#. Tag: title +#: events.xml:154 +#, no-c-format +msgid "Event bindings with members" +msgstr "" + +#. Tag: para +#: events.xml:156 +#, no-c-format +msgid "An event binding type may have annotation members:" +msgstr "" + +#. Tag: programlisting +#: events.xml:158 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Target({PARAMETER, FIELD})\n" +"@Retention(RUNTIME)\n" +"public @interface Role {\n" +" RoleType value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:160 +#, no-c-format +msgid "" +"The member value is used to narrow the messages delivered to the observer:" +msgstr "" + +#. Tag: programlisting +#: events.xml:162 +#, no-c-format +msgid "" +"<![CDATA[public void adminLoggedIn(@Observes @Role(ADMIN) LoggedIn event) " +"{ ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:164 +#, no-c-format +msgid "" +"Event binding type members may be specified statically by the event " +"producer, via annotations at the event notifier injection point:" +msgstr "" + +#. Tag: programlisting +#: events.xml:167 +#, no-c-format +msgid "<![CDATA[@Observable @Role(ADMIN) Event<LoggedIn> LoggedInEvent;}}]]>" +msgstr "" + +#. Tag: para +#: events.xml:169 +#, no-c-format +msgid "" +"Alternatively, the value of the event binding type member may be determined " +"dynamically by the event producer. We start by writing an abstract subclass " +"of <literal>AnnotationLiteral</literal>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:172 +#, no-c-format +msgid "" +"<![CDATA[abstract class RoleBinding \n" +" extends AnnotationLiteral<Role> \n" +" implements Role {}]]>" +msgstr "" + +#. Tag: para +#: events.xml:174 +#, no-c-format +msgid "" +"The event producer passes an instance of this class to <literal>fire()</" +"literal>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:176 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.fire( document, new RoleBinding() { public void value" +"() { return user.getRole(); } } );]]>" +msgstr "" + +#. Tag: title +#: events.xml:181 +#, no-c-format +msgid "Multiple event bindings" +msgstr "" + +#. Tag: para +#: events.xml:183 +#, no-c-format +msgid "Event binding types may be combined, for example:" +msgstr "" + +#. Tag: programlisting +#: events.xml:185 +#, no-c-format +msgid "" +"<![CDATA[@Observable @Blog Event<Document> blogEvent;\n" +"...\n" +"if (document.isBlog()) blogEvent.fire(document, new " +"AnnotationLiteral<Updated>(){});]]>" +msgstr "" + +#. Tag: para +#: events.xml:187 +#, no-c-format +msgid "" +"When this event occurs, all of the following observer methods will be " +"notified:" +msgstr "" + +#. Tag: programlisting +#: events.xml:189 +#, no-c-format +msgid "" +"<![CDATA[public void afterBlogUpdate(@Observes @Updated @Blog Document " +"document) { ... }]]>" +msgstr "" + +#. Tag: programlisting +#: events.xml:191 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyBlogEvent(@Observes @Blog Document document) " +"{ ... }]]>" +msgstr "" + +#. Tag: programlisting +#: events.xml:192 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyDocumentEvent(@Observes Document document) " +"{ ... }}}]]>" +msgstr "" + +#. Tag: title +#: events.xml:197 +#, no-c-format +msgid "Transactional observers" +msgstr "" + +#. Tag: para +#: events.xml:199 +#, no-c-format +msgid "" +"Transactional observers receive their event notifications during the before " +"or after completion phase of the transaction in which the event was raised. " +"For example, the following observer method needs to refresh a query result " +"set that is cached in the application context, but only when transactions " +"that update the <literal>Category</literal> tree succeed:" +msgstr "" + +#. Tag: programlisting +#: events.xml:205 +#, no-c-format +msgid "" +"<![CDATA[public void refreshCategoryTree(@AfterTransactionSuccess @Observes " +"CategoryUpdateEvent event) { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:207 +#, no-c-format +msgid "There are three kinds of transactional observers:" +msgstr "" + +#. Tag: para +#: events.xml:211 +#, no-c-format +msgid "" +"<literal>@AfterTransactionSuccess</literal> observers are called during the " +"after completion phase of the transaction, but only if the transaction " +"completes successfully" +msgstr "" + +#. Tag: para +#: events.xml:216 +#, no-c-format +msgid "" +"<literal>@AfterTransactionFailure</literal> observers are called during the " +"after completion phase of the transaction, but only if the transaction fails " +"to complete successfully" +msgstr "" + +#. Tag: para +#: events.xml:221 +#, no-c-format +msgid "" +"<literal>@AfterTransactionCompletion</literal> observers are called during " +"the after completion phase of the transaction" +msgstr "" + +#. Tag: para +#: events.xml:225 +#, no-c-format +msgid "" +"<literal>@BeforeTransactionCompletion</literal> observers are called during " +"the before completion phase of the transaction" +msgstr "" + +#. Tag: para +#: events.xml:230 +#, no-c-format +msgid "" +"Transactional observers are very important in a stateful object model like " +"Web Beans, because state is often held for longer than a single atomic " +"transaction." +msgstr "" + +#. Tag: para +#: events.xml:233 +#, no-c-format +msgid "" +"Imagine that we have cached a JPA query result set in the application scope:" +msgstr "" + +#. Tag: programlisting +#: events.xml:235 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Singleton\n" +"public class Catalog {\n" +"\n" +" @PersistenceContext EntityManager em;\n" +" \n" +" List<Product> products;\n" +"\n" +" @Produces @Catalog \n" +" List<Product> getCatalog() {\n" +" if (products==null) {\n" +" products = em.createQuery(\"select p from Product p where p." +"deleted = false\")\n" +" .getResultList();\n" +" }\n" +" return products;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:237 +#, no-c-format +msgid "" +"From time to time, a <literal>Product</literal> is created or deleted. When " +"this occurs, we need to refresh the <literal>Product</literal> catalog. But " +"we should wait until <emphasis>after</emphasis> the transaction completes " +"successfully before performing this refresh!" +msgstr "" + +#. Tag: para +#: events.xml:242 +#, no-c-format +msgid "" +"The Web Bean that creates and deletes <literal>Product</literal>s could " +"raise events, for example:" +msgstr "" + +#. Tag: programlisting +#: events.xml:245 +#, no-c-format +msgid "" +"<![CDATA[@Stateless\n" +"public class ProductManager {\n" +"\n" +" @PersistenceContext EntityManager em;\n" +" @Observable Event<Product> productEvent;\n" +"\n" +" public void delete(Product product) {\n" +" em.delete(product);\n" +" productEvent.fire(product, new AnnotationLiteral<Deleted>(){});\n" +" }\n" +" \n" +" public void persist(Product product) {\n" +" em.persist(product);\n" +" productEvent.fire(product, new AnnotationLiteral<Created>(){});\n" +" }\n" +" \n" +" ...\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:247 +#, no-c-format +msgid "" +"And now <literal>Catalog</literal> can observe the events after successful " +"completion of the transaction:" +msgstr "" + +#. Tag: programlisting +#: events.xml:250 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Singleton\n" +"public class Catalog {\n" +"\n" +" ...\n" +" \n" +" void addProduct(@AfterTransactionSuccess @Observes @Created Product " +"product) {\n" +" products.add(product);\n" +" }\n" +" \n" +" void addProduct(@AfterTransactionSuccess @Observes @Deleted Product " +"product) {\n" +" products.remove(product);\n" +" }\n" +" \n" +"}]]>" +msgstr "" Added: doc/trunk/reference/fr-FR/modules/example.po =================================================================== --- doc/trunk/reference/fr-FR/modules/example.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/example.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,172 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: example.xml:4 +#, no-c-format +msgid "JSF web application example" +msgstr "" + +#. Tag: para +#: example.xml:6 +#, no-c-format +msgid "" +"Let's illustrate these ideas with a full example. We're going to implement " +"user login/logout for an application that uses JSF. First, we'll define a " +"Web Bean to hold the username and password entered during login:" +msgstr "" + +#. Tag: programlisting +#: example.xml:11 +#, no-c-format +msgid "" +"<![CDATA[@Named\n" +"public class Credentials {\n" +" \n" +" private String username;\n" +" private String password;\n" +" \n" +" public String getUsername() { return username; }\n" +" public void setUsername(String username) { this.username = username; }\n" +" \n" +" public String getPassword() { return password; }\n" +" public void setPassword(String password) { this.password = password; }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:13 +#, no-c-format +msgid "This Web Bean is bound to the login prompt in the following JSF form:" +msgstr "" + +#. Tag: programlisting +#: example.xml:15 +#, no-c-format +msgid "" +"<![CDATA[<f:form>\n" +" <h:panelGrid columns=\"2\" rendered=\"#{!login.loggedIn}\">\n" +" <h:outputLabel for=\"username\">Username:</h:outputLabel>\n" +" <h:inputText id=\"username\" value=\"#{credentials.username}\"/>\n" +" <h:outputLabel for=\"password\">Password:</h:outputLabel>\n" +" <h:inputText id=\"password\" value=\"#{credentials.password}\"/>\n" +" </h:panelGrid>\n" +" <h:commandButton value=\"Login\" action=\"#{login.login}\" rendered=\"#{!" +"login.loggedIn}\"/>\n" +" <h:commandButton value=\"Logout\" acion=\"#{login.logout}\" rendered=\"#" +"{login.loggedIn}\"/>\n" +"</f:form]]>" +msgstr "" + +#. Tag: para +#: example.xml:17 +#, no-c-format +msgid "" +"The actual work is done by a session scoped Web Bean that maintains " +"information about the currently logged-in user and exposes the " +"<literal>User</literal> entity to other Web Beans:" +msgstr "" + +#. Tag: programlisting +#: example.xml:21 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named\n" +"public class Login {\n" +"\n" +" @Current Credentials credentials;\n" +" @PersistenceContext EntityManager userDatabase;\n" +"\n" +" private User user;\n" +" \n" +" public void login() {\n" +" \n" +" List<User> results = userDatabase.createQuery(\n" +" \"select u from User u where u.username=:username and u.password=:" +"password\")\n" +" .setParameter(\"username\", credentials.getUsername())\n" +" .setParameter(\"password\", credentials.getPassword())\n" +" .getResultList();\n" +" \n" +" if ( !results.isEmpty() ) {\n" +" user = results.get(0);\n" +" }\n" +" \n" +" }\n" +" \n" +" public void logout() {\n" +" user = null;\n" +" }\n" +" \n" +" public boolean isLoggedIn() {\n" +" return user!=null;\n" +" }\n" +" \n" +" @Produces @LoggedIn User getCurrentUser() {\n" +" return user;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:23 +#, no-c-format +msgid "Of course, <literal>@LoggedIn</literal> is a binding annotation:" +msgstr "" + +#. Tag: programlisting +#: example.xml:25 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD})\n" +"@BindingType\n" +"public @interface LoggedIn {}]]>" +msgstr "" + +#. Tag: para +#: example.xml:27 +#, no-c-format +msgid "Now, any other Web Bean can easily inject the current user:" +msgstr "" + +#. Tag: programlisting +#: example.xml:29 +#, no-c-format +msgid "" +"<![CDATA[public class DocumentEditor {\n" +"\n" +" @Current Document document;\n" +" @LoggedIn User currentUser;\n" +" @PersistenceContext EntityManager docDatabase;\n" +" \n" +" public void save() {\n" +" document.setCreatedBy(currentUser);\n" +" docDatabase.persist(document);\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:31 +#, no-c-format +msgid "" +"Hopefully, this example gives a flavor of the Web Bean programming model. In " +"the next chapter, we'll explore Web Beans dependency injection in greater " +"depth." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/extend.po =================================================================== --- doc/trunk/reference/fr-FR/modules/extend.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/extend.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,252 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: extend.xml:4 +#, no-c-format +msgid "Extending Web Beans" +msgstr "" + +#. Tag: para +#: extend.xml:6 +#, no-c-format +msgid "" +"Web Beans is intended to be a platform for frameworks, extensions and " +"integration with other technologies. Therefore, Web Beans exposes a set of " +"SPIs for the use of developers of portable extensions to Web Beans. For " +"example, the following kinds of extensions were envisaged by the designers " +"of Web Beans:" +msgstr "" + +#. Tag: para +#: extend.xml:14 +#, no-c-format +msgid "integration with Business Process Management engines," +msgstr "" + +#. Tag: para +#: extend.xml:17 +#, no-c-format +msgid "" +"integration with third-party frameworks such as Spring, Seam, GWT or Wicket, " +"and" +msgstr "" + +#. Tag: para +#: extend.xml:21 +#, no-c-format +msgid "new technology based upon the Web Beans programming model." +msgstr "" + +#. Tag: para +#: extend.xml:25 +#, no-c-format +msgid "" +"The nerve center for extending Web Beans is the <literal>Manager</literal> " +"object." +msgstr "" + +#. Tag: title +#: extend.xml:29 +#, no-c-format +msgid "The <literal>Manager</literal> object" +msgstr "" + +#. Tag: para +#: extend.xml:31 +#, no-c-format +msgid "" +"The <literal>Manager</literal> interface lets us register and obtain Web " +"Beans, interceptors, decorators, observers and contexts programatically." +msgstr "" + +#. Tag: programlisting +#: extend.xml:34 +#, no-c-format +msgid "" +"<![CDATA[public interface Manager\n" +"{\n" +"\n" +" public <T> Set<Bean<T>> resolveByType(Class<T> type, Annotation... " +"bindings);\n" +"\n" +" public <T> Set<Bean<T>> resolveByType(TypeLiteral<T> apiType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> T getInstanceByType(Class<T> type, Annotation... bindings);\n" +"\n" +" public <T> T getInstanceByType(TypeLiteral<T> type,\n" +" Annotation... bindings);\n" +"\n" +" public Set<Bean<?>> resolveByName(String name);\n" +"\n" +" public Object getInstanceByName(String name);\n" +"\n" +" public <T> T getInstance(Bean<T> bean);\n" +"\n" +" public void fireEvent(Object event, Annotation... bindings);\n" +"\n" +" public Context getContext(Class<? extends Annotation> scopeType);\n" +"\n" +" public Manager addContext(Context context);\n" +"\n" +" public Manager addBean(Bean<?> bean);\n" +"\n" +" public Manager addInterceptor(Interceptor interceptor);\n" +"\n" +" public Manager addDecorator(Decorator decorator);\n" +"\n" +" public <T> Manager addObserver(Observer<T> observer, Class<T> eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager addObserver(Observer<T> observer, TypeLiteral<T> " +"eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager removeObserver(Observer<T> observer, Class<T> " +"eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager removeObserver(Observer<T> observer,\n" +" TypeLiteral<T> eventType, Annotation... bindings);\n" +"\n" +" public <T> Set<Observer<T>> resolveObservers(T event, Annotation... " +"bindings);\n" +"\n" +" public List<Interceptor> resolveInterceptors(InterceptionType type,\n" +" Annotation... interceptorBindings);\n" +"\n" +" public List<Decorator> resolveDecorators(Set<Class<?>> types,\n" +" Annotation... bindings);\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: extend.xml:36 +#, no-c-format +msgid "We can obtain an instance of <literal>Manager</literal> via injection:" +msgstr "" + +#. Tag: programlisting +#: extend.xml:38 +#, no-c-format +msgid "@Current Manager manager" +msgstr "" + +#. Tag: title +#: extend.xml:43 +#, no-c-format +msgid "The <literal>Bean</literal> class" +msgstr "" + +#. Tag: para +#: extend.xml:45 +#, no-c-format +msgid "" +"Instances of the abstract class <literal>Bean</literal> represent Web Beans. " +"There is an instance of <literal>Bean</literal> registered with the " +"<literal>Manager</literal> object for every Web Bean in the application." +msgstr "" + +#. Tag: programlisting +#: extend.xml:50 +#, no-c-format +msgid "" +"public abstract class Bean<T> {\n" +" \n" +" private final Manager manager;\n" +" \n" +" protected Bean(Manager manager) {\n" +" this.manager=manager;\n" +" }\n" +" \n" +" protected Manager getManager() {\n" +" return manager;\n" +" }\n" +" \n" +" public abstract Set<Class> getTypes();\n" +" public abstract Set<Annotation> getBindingTypes();\n" +" public abstract Class<? extends Annotation> getScopeType();\n" +" public abstract Class<? extends Annotation> getDeploymentType(); \n" +" public abstract String getName();\n" +" \n" +" public abstract boolean isSerializable();\n" +" public abstract boolean isNullable();\n" +"\n" +" public abstract T create();\n" +" public abstract void destroy(T instance);\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: extend.xml:52 +#, no-c-format +msgid "" +"It's possible to extend the <literal>Bean</literal> class and register " +"instances by calling <literal>Manager.addBean()</literal> to provide support " +"for new kinds of Web Beans, beyond those defined by the Web Beans " +"specification (simple and enterprise Web Beans, producer methods and JMS " +"endpoints). For example, we could use the <literal>Bean</literal> class to " +"allow objects managed by another framework to be injected into Web Beans." +msgstr "" + +#. Tag: para +#: extend.xml:60 +#, no-c-format +msgid "" +"There are two subclasses of <literal>Bean</literal> defined by the Web Beans " +"specification: <literal>Interceptor</literal> and <literal>Decorator</" +"literal>." +msgstr "" + +#. Tag: title +#: extend.xml:67 +#, no-c-format +msgid "The <literal>Context</literal> interface" +msgstr "" + +#. Tag: para +#: extend.xml:69 +#, no-c-format +msgid "" +"The <literal>Context</literal> interface supports addition of new scopes to " +"Web Beans, or extension of the built-in scopes to new environments." +msgstr "" + +#. Tag: programlisting +#: extend.xml:72 +#, no-c-format +msgid "" +"public interface Context {\n" +" \n" +" public Class<? extends Annotation> getScopeType();\n" +" \n" +" public <T> T get(Bean<T> bean, boolean create);\n" +" \n" +" boolean isActive();\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: extend.xml:74 +#, no-c-format +msgid "" +"For example, we might implement <literal>Context</literal> to add a business " +"process scope to Web Beans, or to add support for the conversation scope to " +"an application that uses Wicket." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/injection.po =================================================================== --- doc/trunk/reference/fr-FR/modules/injection.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/injection.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,1226 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: injection.xml:4 +#, no-c-format +msgid "Dependency injection" +msgstr "" + +#. Tag: para +#: injection.xml:6 +#, no-c-format +msgid "Web Beans supports three primary mechanisms for dependency injection:" +msgstr "" + +#. Tag: para +#: injection.xml:8 +#, no-c-format +msgid "Constructor parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:10 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +" \n" +" private final ShoppingCart cart;\n" +" \n" +" @Initializer\n" +" public Checkout(ShoppingCart cart) {\n" +" this.cart = cart;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:12 +#, no-c-format +msgid "<emphasis>Initializer</emphasis> method parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:14 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +" \n" +" private ShoppingCart cart;\n" +"\n" +" @Initializer \n" +" void setShoppingCart(ShoppingCart cart) {\n" +" this.cart = cart;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:16 +#, no-c-format +msgid "And direct field injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:18 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +"\n" +" private @Current ShoppingCart cart;\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:20 +#, no-c-format +msgid "" +"Dependency injection always occurs when the Web Bean instance is first " +"instantiated." +msgstr "" + +#. Tag: para +#: injection.xml:25 +#, no-c-format +msgid "" +"First, the Web Bean manager calls the Web Bean constructor, to obtain an " +"instance of the Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:29 +#, no-c-format +msgid "" +"Next, the Web Bean manager initializes the values of all injected fields of " +"the Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:33 +#, no-c-format +msgid "Next, the Web Bean manager calls all initializer methods of Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:37 +#, no-c-format +msgid "" +"Finally, the <literal>@PostConstruct</literal> method of the Web Bean, if " +"any, is called." +msgstr "" + +#. Tag: para +#: injection.xml:42 +#, no-c-format +msgid "" +"Constructor parameter injection is not supported for EJB beans, since the " +"EJB is instantiated by the EJB container, not the Web Bean manager." +msgstr "" + +#. Tag: para +#: injection.xml:45 +#, no-c-format +msgid "" +"Parameters of constructors and initializer methods need not be explicitly " +"annotated when the default binding type <literal>@Current</literal> applies. " +"Injected fields, however, <emphasis>must</emphasis> specify a binding type, " +"even when the default binding type applies. If the field does not specify a " +"binding type, it will not be injected." +msgstr "" + +#. Tag: para +#: injection.xml:51 +#, no-c-format +msgid "Producer methods also support parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:53 +#, no-c-format +msgid "" +"<![CDATA[@Produces Checkout createCheckout(ShoppingCart cart) {\n" +" return new Checkout(cart);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:55 +#, no-c-format +msgid "" +"Finally, observer methods (which we'll meet in <xref linkend=\"events\"/>), " +"disposal methods and destructor methods all support parameter injection." +msgstr "" + +#. Tag: para +#: injection.xml:58 +#, no-c-format +msgid "" +"The Web Beans specification defines a procedure, called the " +"<emphasis>typesafe resolution algorithm</emphasis>, that the Web Bean " +"manager follows when identifying the Web Bean to inject to an injection " +"point. This algorithm looks complex at first, but once you understand it, " +"it's really quite intuitive. Typesafe resolution is performed at system " +"initialization time, which means that the manager will inform the user " +"immediately if a Web Bean's dependencies cannot be satisfied, by throwing a " +"<literal>UnsatisfiedDependencyException</literal> or " +"<literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:67 +#, no-c-format +msgid "" +"The purpose of this algorithm is to allow multiple Web Beans to implement " +"the same API type and either:" +msgstr "" + +#. Tag: para +#: injection.xml:72 +#, no-c-format +msgid "" +"allow the client to select which implementation it requires using " +"<emphasis>binding annotations</emphasis>," +msgstr "" + +#. Tag: para +#: injection.xml:77 +#, no-c-format +msgid "" +"allow the application deployer to select which implementation is appropriate " +"for a particular deployment, without changes to the client, by enabling or " +"disabling <emphasis>deployment types</emphasis>, or" +msgstr "" + +#. Tag: para +#: injection.xml:82 +#, no-c-format +msgid "" +"allow one implementation of an API to override another implementation of the " +"same API at deployment time, without changes to the client, using " +"<emphasis>deployment type precedence</emphasis>." +msgstr "" + +#. Tag: para +#: injection.xml:88 +#, no-c-format +msgid "" +"Let's explore how the Web Beans manager determines a Web Bean to be injected." +msgstr "" + +#. Tag: title +#: injection.xml:91 +#, no-c-format +msgid "Binding annotations" +msgstr "" + +#. Tag: para +#: injection.xml:93 +#, no-c-format +msgid "" +"If we have more than one Web Bean that implements a particular API type, the " +"injection point can specify exactly which Web Bean should be injected using " +"a binding annotation. For example, there might be two implementations of " +"<literal>PaymentProcessor</literal>:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:98 +#, no-c-format +msgid "" +"<![CDATA[@PayByCheque\n" +"public class ChequePaymentProcessor implements PaymentProcessor {\n" +" public void process(Payment payment) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:100 +#, no-c-format +msgid "" +"<![CDATA[@PayByCreditCard\n" +"public class CreditCardPaymentProcessor implements PaymentProcessor {\n" +" public void process(Payment payment) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:102 +#, no-c-format +msgid "" +"Where <literal>@PayByCheque</literal> and <literal>@PayByCreditCard</" +"literal> are binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:105 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayByCheque {}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:107 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayByCreditCard {}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:109 +#, no-c-format +msgid "" +"A client Web Bean developer uses the binding annotation to specify exactly " +"which Web Bean should be injected." +msgstr "" + +#. Tag: para +#: injection.xml:112 +#, no-c-format +msgid "Using field injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:114 +#, no-c-format +msgid "" +"<![CDATA[@PayByCheque PaymentProcessor chequePaymentProcessor;\n" +"@PayByCreditCard PaymentProcessor creditCardPaymentProcessor;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:116 +#, no-c-format +msgid "Using initializer method injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:118 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public void setPaymentProcessors(@PayByCheque PaymentProcessor " +"chequePaymentProcessor, \n" +" @PayByCreditCard PaymentProcessor " +"creditCardPaymentProcessor) {\n" +" this.chequePaymentProcessor = chequePaymentProcessor;\n" +" this.creditCardPaymentProcessor = creditCardPaymentProcessor;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:120 +#, no-c-format +msgid "Or using constructor injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:122 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public Checkout(@PayByCheque PaymentProcessor chequePaymentProcessor, \n" +" @PayByCreditCard PaymentProcessor " +"creditCardPaymentProcessor) {\n" +" this.chequePaymentProcessor = chequePaymentProcessor;\n" +" this.creditCardPaymentProcessor = creditCardPaymentProcessor;\n" +"}]]>" +msgstr "" + +#. Tag: title +#: injection.xml:125 +#, no-c-format +msgid "Binding annotations with members" +msgstr "" + +#. Tag: para +#: injection.xml:127 +#, no-c-format +msgid "Binding annotations may have members:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:129 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayBy {\n" +" PaymentType value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:131 +#, no-c-format +msgid "In which case, the member value is significant:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:133 +#, no-c-format +msgid "" +"<![CDATA[@PayBy(CHEQUE) PaymentProcessor chequePaymentProcessor;\n" +"@PayBy(CREDIT_CARD) PaymentProcessor creditCardPaymentProcessor;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:135 +#, no-c-format +msgid "" +"You can tell the Web Bean manager to ignore a member of a binding annotation " +"type by annotating the member <literal>@NonBinding</literal>." +msgstr "" + +#. Tag: title +#: injection.xml:141 +#, no-c-format +msgid "Combinations of binding annnotations" +msgstr "" + +#. Tag: para +#: injection.xml:143 +#, no-c-format +msgid "An injection point may even specify multiple binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:145 +#, no-c-format +msgid "" +"<![CDATA[@Asynchronous @PayByCheque PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: injection.xml:147 +#, no-c-format +msgid "" +"In this case, only a Web Bean which has <emphasis>both</emphasis> binding " +"annotations would be eligible for injection." +msgstr "" + +#. Tag: title +#: injection.xml:153 +#, no-c-format +msgid "Binding annotations and producer methods" +msgstr "" + +#. Tag: para +#: injection.xml:155 +#, no-c-format +msgid "Even producer methods may specify binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:157 +#, no-c-format +msgid "" +"<![CDATA[@Produces \n" +"@Asynchronous @PayByCheque \n" +"PaymentProcessor createAsyncPaymentProcessor(@PayByCheque PaymentProcessor " +"processor) {\n" +" return new AsynchronousPaymentProcessor(processor);\n" +"}]]>" +msgstr "" + +#. Tag: title +#: injection.xml:162 +#, no-c-format +msgid "The default binding type" +msgstr "" + +#. Tag: para +#: injection.xml:164 +#, no-c-format +msgid "" +"Web Beans defines a binding type <literal>@Current</literal> that is the " +"default binding type for any injection point or Web Bean that does not " +"explicitly specify a binding type." +msgstr "" + +#. Tag: para +#: injection.xml:168 +#, no-c-format +msgid "" +"There are two common circumstances in which it is necessary to explicitly " +"specify <literal>@Current</literal>:" +msgstr "" + +#. Tag: para +#: injection.xml:173 +#, no-c-format +msgid "" +"on a field, in order to declare it as an injected field with the default " +"binding type, and" +msgstr "" + +#. Tag: para +#: injection.xml:177 +#, no-c-format +msgid "" +"on a Web Bean which has another binding type in addition to the default " +"binding type." +msgstr "" + +#. Tag: title +#: injection.xml:187 +#, no-c-format +msgid "Deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:189 +#, no-c-format +msgid "" +"All Web Beans have a <emphasis>deployment type</emphasis>. Each deployment " +"type identifies a set of Web Beans that should be conditionally installed in " +"some deployments of the system." +msgstr "" + +#. Tag: para +#: injection.xml:193 +#, no-c-format +msgid "" +"For example, we could define a deployment type named <literal>@Mock</" +"literal>, which would identify Web Beans that should only be installed when " +"the system executes inside an integration testing environment:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:197 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +" @Target({TYPE, METHOD})\n" +" @DeploymentType\n" +" public @interface Mock {}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:199 +#, no-c-format +msgid "" +"Suppose we had some Web Bean that interacted with an external system to " +"process payments:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:202 +#, no-c-format +msgid "" +"<![CDATA[public class ExternalPaymentProcessor {\n" +" \n" +" public void process(Payment p) {\n" +" ...\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:204 +#, no-c-format +msgid "" +"Since this Web Bean does not explicitly specify a deployment type, it has " +"the default deployment type <literal>@Production</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:207 +#, no-c-format +msgid "" +"For integration or unit testing, the external system is slow or unavailable. " +"So we would create a mock object:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:210 +#, no-c-format +msgid "" +"<![CDATA[@Mock \n" +"public class MockPaymentProcessor implements PaymentProcessor {\n" +"\n" +" @Override\n" +" public void process(Payment p) {\n" +" p.setSuccessful(true);\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:212 +#, no-c-format +msgid "" +"But how does the Web Bean manager determine which implementation to use in a " +"particular deployment?" +msgstr "" + +#. Tag: title +#: injection.xml:216 +#, no-c-format +msgid "Enabling deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:218 +#, no-c-format +msgid "" +"Web Beans defines two built-in deployment types: <literal>@Production</" +"literal> and <literal>@Standard</literal>. By default, only Web Beans with " +"the built-in deployment types are enabled when the system is deployed. We " +"can identify additional deployment types to be enabled in a particular " +"deployment by listing them in <literal>web-beans.xml</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:224 +#, no-c-format +msgid "" +"Going back to our example, when we deploy our integration tests, we want all " +"our <literal>@Mock</literal> objects to be installed:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:227 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans>\n" +" <Deploy>\n" +" <Standard/>\n" +" <Production/>\n" +" <test:Mock/>\n" +" </Deploy>\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: injection.xml:229 +#, no-c-format +msgid "" +"Now the Web Bean manager will identify and install all Web Beans annotated " +"<literal>@Production</literal>, <literal>@Standard</literal> or " +"<literal>@Mock</literal> at deployment time." +msgstr "" + +#. Tag: para +#: injection.xml:233 +#, no-c-format +msgid "" +"The deployment type <literal>@Standard</literal> is used only for certain " +"special Web Beans defined by the Web Beans specification. We can't use it " +"for our own Web Beans, and we can't disable it." +msgstr "" + +#. Tag: para +#: injection.xml:237 +#, no-c-format +msgid "" +"The deployment type <literal>@Production</literal> is the default deployment " +"type for Web Beans which don't explicitly declare a deployment type, and may " +"be disabled." +msgstr "" + +#. Tag: title +#: injection.xml:244 +#, no-c-format +msgid "Deployment type precedence" +msgstr "" + +#. Tag: para +#: injection.xml:246 +#, no-c-format +msgid "" +"If you've been paying attention, you're probably wondering how the Web Bean " +"manager decides which implementation<literal>ExternalPaymentProcessor</" +"literal> or <literal>MockPaymentProcessor</literal>to choose. Consider " +"what happens when the manager encounters this injection point:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:251 +#, no-c-format +msgid "<![CDATA[@Current PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: injection.xml:253 +#, no-c-format +msgid "" +"There are now two Web Beans which satisfy the <literal>PaymentProcessor</" +"literal> contract. Of course, we can't use a binding annotation to " +"disambiguate, since binding annotations are hard-coded into the source at " +"the injection point, and we want the manager to be able to decide at " +"deployment time!" +msgstr "" + +#. Tag: para +#: injection.xml:258 +#, no-c-format +msgid "" +"The solution to this problem is that each deployment type has a different " +"<emphasis>precedence</emphasis>. The precedence of the deployment types is " +"determined by the order in which they appear in <literal>web-beans.xml</" +"literal>. In our example, <literal>@Mock</literal> appears later than " +"<literal>@Production</literal> so it has a higher precedence." +msgstr "" + +#. Tag: para +#: injection.xml:264 +#, no-c-format +msgid "" +"Whenever the manager discovers that more than one Web Bean could satisfy the " +"contract (API type plus binding annotations) specified by an injection " +"point, it considers the relative precedence of the Web Beans. If one has a " +"higher precedence than the others, it chooses the higher precedence Web Bean " +"to inject. So, in our example, the Web Bean manager will inject " +"<literal>MockPaymentProcessor</literal> when executing in our integration " +"testing environment (which is exactly what we want)." +msgstr "" + +#. Tag: para +#: injection.xml:271 +#, no-c-format +msgid "" +"It's interesting to compare this facility to today's popular manager " +"architectures. Various \"lightweight\" containers also allow conditional " +"deployment of classes that exist in the classpath, but the classes that are " +"to be deployed must be explicity, individually, listed in configuration code " +"or in some XML configuration file. Web Beans does support Web Bean " +"definition and configuration via XML, but in the common case where no " +"complex configuration is required, deployment types allow a whole set of Web " +"Beans to be enabled with a single line of XML. Meanwhile, a developer " +"browsing the code can easily identify what deployment scenarios the Web Bean " +"will be used in." +msgstr "" + +#. Tag: title +#: injection.xml:284 +#, no-c-format +msgid "Example deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:286 +#, no-c-format +msgid "" +"Deployment types are useful for all kinds of things, here's some examples:" +msgstr "" + +#. Tag: para +#: injection.xml:290 +#, no-c-format +msgid "" +"<literal>@Mock</literal> and <literal>@Staging</literal> deployment types " +"for testing" +msgstr "" + +#. Tag: para +#: injection.xml:294 +#, no-c-format +msgid "<literal>@AustralianTaxLaw</literal> for site-specific Web Beans" +msgstr "" + +#. Tag: para +#: injection.xml:297 +#, no-c-format +msgid "" +"<literal>@SeamFramework</literal>, <literal>@Guice</literal> for third-party " +"frameworks which build on Web Beans" +msgstr "" + +#. Tag: para +#: injection.xml:301 +#, no-c-format +msgid "" +"<literal>@Standard</literal> for standard Web Beans defined by the Web Beans " +"specification" +msgstr "" + +#. Tag: para +#: injection.xml:306 +#, no-c-format +msgid "I'm sure you can think of more applications..." +msgstr "" + +#. Tag: title +#: injection.xml:313 +#, no-c-format +msgid "Fixing unsatisfied dependencies" +msgstr "" + +#. Tag: para +#: injection.xml:315 +#, no-c-format +msgid "" +"The typesafe resolution algorithm fails when, after considering the binding " +"annotations and and deployment types of all Web Beans that implement the API " +"type of an injection point, the Web Bean manager is unable to identify " +"exactly one Web Bean to inject." +msgstr "" + +#. Tag: para +#: injection.xml:320 +#, no-c-format +msgid "" +"It's usually easy to fix an <literal>UnsatisfiedDependencyException</" +"literal> or <literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:323 +#, no-c-format +msgid "" +"To fix an <literal>UnsatisfiedDependencyException</literal>, simply provide " +"a Web Bean which implements the API type and has the binding types of the " +"injection pointor enable the deployment type of a Web Bean that " +"already implements the API type and has the binding types." +msgstr "" + +#. Tag: para +#: injection.xml:328 +#, no-c-format +msgid "" +"To fix an <literal>AmbiguousDependencyException</literal>, introduce a " +"binding type to distinguish between the two implementations of the API type, " +"or change the deployment type of one of the implementations so that the Web " +"Bean manager can use deployment type precedence to choose between them. An " +"<literal>AmbiguousDependencyException</literal> can only occur if two Web " +"Beans share a binding type and have exactly the same deployment type." +msgstr "" + +#. Tag: para +#: injection.xml:335 +#, no-c-format +msgid "" +"There's one more issue you need to be aware of when using dependency " +"injection in Web Beans." +msgstr "" + +#. Tag: title +#: injection.xml:341 +#, no-c-format +msgid "Client proxies" +msgstr "" + +#. Tag: para +#: injection.xml:343 +#, no-c-format +msgid "" +"Clients of an injected Web Bean do not usually hold a direct reference to a " +"Web Bean instance." +msgstr "" + +#. Tag: para +#: injection.xml:346 +#, no-c-format +msgid "" +"Imagine that a Web Bean bound to the application scope held a direct " +"reference to a Web Bean bound to the request scope. The application scoped " +"Web Bean is shared between many different requests. However, each request " +"should see a different instance of the request scoped Web bean!" +msgstr "" + +#. Tag: para +#: injection.xml:351 +#, no-c-format +msgid "" +"Now imagine that a Web Bean bound to the session scope held a direct " +"reference to a Web Bean bound to the application scope. From time to time, " +"the session context is serialized to disk in order to use memory more " +"efficiently. However, the application scoped Web Bean instance should not be " +"serialized along with the session scoped Web Bean!" +msgstr "" + +#. Tag: para +#: injection.xml:357 +#, no-c-format +msgid "" +"Therefore, unless a Web Bean has the default scope <literal>@Dependent</" +"literal>, the Web Bean manager must indirect all injected references to the " +"Web Bean through a proxy object. This <emphasis>client proxy</emphasis> is " +"responsible for ensuring that the Web Bean instance that receives a method " +"invocation is the instance that is associated with the current context. The " +"client proxy also allows Web Beans bound to contexts such as the session " +"context to be serialized to disk without recursively serializing other " +"injected Web Beans." +msgstr "" + +#. Tag: para +#: injection.xml:365 +#, no-c-format +msgid "" +"Unfortunately, due to limitations of the Java language, some Java types " +"cannot be proxied by the Web Bean manager. Therefore, the Web Bean manager " +"throws an <literal>UnproxyableDependencyException</literal> if the type of " +"an injection point cannot be proxied." +msgstr "" + +#. Tag: para +#: injection.xml:370 +#, no-c-format +msgid "The following Java types cannot be proxied by the Web Bean manager:" +msgstr "" + +#. Tag: para +#: injection.xml:374 +#, no-c-format +msgid "" +"classes which are declared <literal>final</literal> or have a " +"<literal>final</literal> method," +msgstr "" + +#. Tag: para +#: injection.xml:378 +#, no-c-format +msgid "classes which have no non-private constructor with no parameters, and" +msgstr "" + +#. Tag: para +#: injection.xml:381 +#, no-c-format +msgid "arrays and primitive types." +msgstr "" + +#. Tag: para +#: injection.xml:385 +#, no-c-format +msgid "" +"It's usually very easy to fix an <literal>UnproxyableDependencyException</" +"literal>. Simply add a constructor with no parameters to the injected class, " +"introduce an interface, or change the scope of the injected Web Bean to " +"<literal>@Dependent</literal>." +msgstr "" + +#. Tag: title +#: injection.xml:392 +#, no-c-format +msgid "Obtaining a Web Bean by programatic lookup" +msgstr "" + +#. Tag: para +#: injection.xml:394 +#, no-c-format +msgid "" +"The application may obtain an instance of the interface <literal>Manager</" +"literal> by injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:397 +#, no-c-format +msgid "<![CDATA[@Current Manager manager;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:399 +#, no-c-format +msgid "" +"The <literal>Manager</literal> object provides a set of methods for " +"obtaining a Web Bean instance programatically." +msgstr "" + +#. Tag: programlisting +#: injection.xml:402 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class);]]>" +msgstr "" + +#. Tag: para +#: injection.xml:404 +#, no-c-format +msgid "" +"Binding annotations may be specified by subclassing the helper class " +"<literal>AnnotationLiteral</literal>, since it is otherwise difficult to " +"instantiate an annotation type in Java." +msgstr "" + +#. Tag: programlisting +#: injection.xml:408 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class, \n" +" new " +"AnnotationLiteral<CreditCard>(){});]]>" +msgstr "" + +#. Tag: para +#: injection.xml:410 +#, no-c-format +msgid "" +"If the binding type has an annotation member, we can't use an anonymous " +"subclass of <literal>AnnotationLiteral</literal>instead we'll need to " +"create a named subclass:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:413 +#, no-c-format +msgid "" +"<![CDATA[abstract class CreditCardBinding \n" +" extends AnnotationLiteral<CreditCard> \n" +" implements CreditCard {}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:415 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class, \n" +" new CreditCardBinding() { \n" +" public void value() " +"{ return paymentType; } \n" +" } );]]>" +msgstr "" + +#. Tag: title +#: injection.xml:419 +#, no-c-format +msgid "" +"Lifecycle callbacks, <literal>@Resource</literal>, <literal>@EJB</literal> " +"and <literal>@PersistenceContext</literal>" +msgstr "" + +#. Tag: para +#: injection.xml:422 +#, no-c-format +msgid "" +"Enterprise Web Beans support all the lifecycle callbacks defined by the EJB " +"specification: <literal>@PostConstruct</literal>, <literal>@PreDestroy</" +"literal>, <literal>@PrePassivate</literal> and <literal>@PostActivate</" +"literal>." +msgstr "" + +#. Tag: para +#: injection.xml:426 +#, no-c-format +msgid "" +"Simple Web Beans support only the <literal>@PostConstruct</literal> and " +"<literal>@PreDestroy</literal> callbacks." +msgstr "" + +#. Tag: para +#: injection.xml:429 +#, no-c-format +msgid "" +"Both enterprise and simple Web Beans support the use of <literal>@Resource</" +"literal>, <literal>@EJB</literal> and <literal>@PersistenceContext</literal> " +"for injection of Java EE resources, EJBs and JPA persistence contexts, " +"respectively. Simple Web Beans do not support the use of " +"<literal>@PersistenceContext(type=EXTENDED)</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:434 +#, no-c-format +msgid "" +"The <literal>@PostConstruct</literal> callback always occurs after all " +"dependencies have been injected." +msgstr "" + +#. Tag: title +#: injection.xml:440 +#, no-c-format +msgid "The <literal>InjectionPoint</literal> object" +msgstr "" + +#. Tag: para +#: injection.xml:442 +#, no-c-format +msgid "" +"There are certain kinds of dependent objectsWeb Beans with scope " +"<literal>@Dependent</literal>that need to know something about the " +"object or injection point into which they are injected in order to be able " +"to do what they do. For example:" +msgstr "" + +#. Tag: para +#: injection.xml:448 +#, no-c-format +msgid "" +"The log category for a <literal>Logger</literal> depends upon the class of " +"the object that owns it." +msgstr "" + +#. Tag: para +#: injection.xml:452 +#, no-c-format +msgid "" +"Injection of a HTTP parameter or header value depends upon what parameter or " +"header name was specified at the injection point." +msgstr "" + +#. Tag: para +#: injection.xml:456 +#, no-c-format +msgid "" +"Injection of the result of an EL expression evaluation depends upon the " +"expression that was specified at the injection point." +msgstr "" + +#. Tag: para +#: injection.xml:461 +#, no-c-format +msgid "" +"A Web Bean with scope <literal>@Dependent</literal> may inject an instance " +"of <literal>InjectionPoint</literal> and access metadata relating to the " +"injection point to which it belongs." +msgstr "" + +#. Tag: para +#: injection.xml:465 +#, no-c-format +msgid "" +"Let's look at an example. The following code is verbose, and vulnerable to " +"refactoring problems:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:468 +#, no-c-format +msgid "<![CDATA[Logger log = Logger.getLogger(MyClass.class.getName());]]>" +msgstr "" + +#. Tag: para +#: injection.xml:470 +#, no-c-format +msgid "" +"This clever little producer method lets you inject a JDK <literal>Logger</" +"literal> without explicitly specifying the log category:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:473 +#, no-c-format +msgid "" +"<![CDATA[class LogFactory {\n" +"\n" +" @Produces Logger createLogger(InjectionPoint injectionPoint) { \n" +" return Logger.getLogger(injectionPoint.getMember().getDeclaringClass()." +"getName()); \n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:475 +#, no-c-format +msgid "We can now write:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:477 +#, no-c-format +msgid "<![CDATA[@Current Logger log;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:479 +#, no-c-format +msgid "" +"Not convinced? Then here's a second example. To inject HTTP parameters, we " +"need to define a binding type:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:482 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"public @interface HttpParam {\n" +" @NonBinding public String value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:484 +#, no-c-format +msgid "We would use this binding type at injection points as follows:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:486 +#, no-c-format +msgid "" +"<![CDATA[@HttpParam(\"username\") String username;\n" +"@HttpParam(\"password\") String password;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:488 +#, no-c-format +msgid "The following producer method does the work:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:490 +#, no-c-format +msgid "" +"<![CDATA[class HttpParams\n" +"\n" +" @Produces @HttpParam(\"\")\n" +" String getParamValue(ServletRequest request, InjectionPoint ip) {\n" +" return request.getParameter(ip.getAnnotation(HttpParam.class).value" +"());\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:492 +#, no-c-format +msgid "" +"(Note that the <literal>value()</literal> member of the <literal>HttpParam</" +"literal> annotation is ignored by the Web Bean manager since it is annotated " +"<literal>@NonBinding.</literal>)" +msgstr "" + +#. Tag: para +#: injection.xml:495 +#, no-c-format +msgid "" +"The Web Bean manager provides a built-in Web Bean that implements the " +"<literal>InjectionPoint</literal> interface:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:498 +#, no-c-format +msgid "" +"<![CDATA[public interface InjectionPoint { \n" +" public Object getInstance(); \n" +" public Bean<?> getBean(); \n" +" public Member getMember(): \n" +" public <T extends Annotation> T getAnnotation(Class<T> annotation); \n" +" public Set<T extends Annotation> getAnnotations(); \n" +"}]]>" +msgstr "" Added: doc/trunk/reference/fr-FR/modules/interceptors.po =================================================================== --- doc/trunk/reference/fr-FR/modules/interceptors.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/interceptors.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,572 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: interceptors.xml:4 +#, no-c-format +msgid "Interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:6 +#, no-c-format +msgid "" +"Web Beans re-uses the basic interceptor architecture of EJB 3.0, extending " +"the functionality in two directions:" +msgstr "" + +#. Tag: para +#: interceptors.xml:11 +#, no-c-format +msgid "Any Web Bean may have interceptors, not just session beans." +msgstr "" + +#. Tag: para +#: interceptors.xml:14 +#, no-c-format +msgid "" +"Web Beans features a more sophisticated annotation-based approach to binding " +"interceptors to Web Beans." +msgstr "" + +#. Tag: para +#: interceptors.xml:22 +#, no-c-format +msgid "The EJB specification defines two kinds of interception points:" +msgstr "" + +#. Tag: para +#: interceptors.xml:26 +#, no-c-format +msgid "business method interception, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:29 +#, no-c-format +msgid "lifecycle callback interception." +msgstr "" + +#. Tag: para +#: interceptors.xml:33 +#, no-c-format +msgid "" +"A <emphasis>business method interceptor</emphasis> applies to invocations of " +"methods of the Web Bean by clients of the Web Bean:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:36 +#, no-c-format +msgid "" +"<![CDATA[public class TransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:38 +#, no-c-format +msgid "" +"A <emphasis>lifecycle callback interceptor</emphasis> applies to invocations " +"of lifecycle callbacks by the container:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:41 +#, no-c-format +msgid "" +"<![CDATA[public class DependencyInjectionInterceptor {\n" +" @PostConstruct public void injectDependencies(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:43 +#, no-c-format +msgid "" +"An interceptor class may intercept both lifecycle callbacks and business " +"methods." +msgstr "" + +#. Tag: title +#: interceptors.xml:49 +#, no-c-format +msgid "Interceptor bindings" +msgstr "" + +#. Tag: para +#: interceptors.xml:51 +#, no-c-format +msgid "" +"Suppose we want to declare that some of our Web Beans are transactional. The " +"first thing we need is an <emphasis>interceptor binding annotation</" +"emphasis> to specify exactly which Web Beans we're interested in:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:55 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Transactional {}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:57 +#, no-c-format +msgid "" +"Now we can easily specify that our <literal>ShoppingCart</literal> is a " +"transactional object:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:60 +#, no-c-format +msgid "" +"<![CDATA[@Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:62 +#, no-c-format +msgid "Or, if we prefer, we can specify that just one method is transactional:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:64 +#, no-c-format +msgid "" +"<![CDATA[public class ShoppingCart {\n" +" @Transactional public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:69 +#, no-c-format +msgid "Implementing interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:71 +#, no-c-format +msgid "" +"That's great, but somewhere along the line we're going to have to actually " +"implement the interceptor that provides this transaction management aspect. " +"All we need to do is create a standard EJB interceptor, and annotate it " +"<literal>@Interceptor</literal> and <literal>@Transactional</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:76 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:78 +#, no-c-format +msgid "" +"All Web Beans interceptors are simple Web Beans, and can take advantage of " +"dependency injection and contextual lifecycle management." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:81 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +"\n" +" @Resource Transaction transaction;\n" +"\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:83 +#, no-c-format +msgid "Multiple interceptors may use the same interceptor binding type." +msgstr "" + +#. Tag: title +#: interceptors.xml:88 +#, no-c-format +msgid "Enabling interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:90 +#, no-c-format +msgid "" +"Finally, we need to <emphasis>enable</emphasis> our interceptor in " +"<literal>web-beans.xml</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:93 +#, no-c-format +msgid "" +"<![CDATA[<Interceptors>\n" +" <tx:TransactionInterceptor/>\n" +"</Interceptors>]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:95 +#, no-c-format +msgid "Whoah! Why the angle bracket stew?" +msgstr "" + +#. Tag: para +#: interceptors.xml:97 +#, no-c-format +msgid "Well, the XML declaration solves two problems:" +msgstr "" + +#. Tag: para +#: interceptors.xml:101 +#, no-c-format +msgid "" +"it enables us to specify a total ordering for all the interceptors in our " +"system, ensuring deterministic behavior, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:105 +#, no-c-format +msgid "it lets us enable or disable interceptor classes at deployment time." +msgstr "" + +#. Tag: para +#: interceptors.xml:109 +#, no-c-format +msgid "" +"For example, we could specify that our security interceptor runs before our " +"<literal>TransactionInterceptor</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:112 +#, no-c-format +msgid "" +"<![CDATA[<Interceptors>\n" +" <sx:SecurityInterceptor/>\n" +" <tx:TransactionInterceptor/>\n" +"</Interceptors>]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:114 +#, no-c-format +msgid "Or we could turn them both off in our test environment!" +msgstr "" + +#. Tag: title +#: interceptors.xml:119 +#, no-c-format +msgid "Interceptor bindings with members" +msgstr "" + +#. Tag: para +#: interceptors.xml:121 +#, no-c-format +msgid "" +"Suppose we want to add some extra information to our " +"<literal>@Transactional</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:124 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Transactional {\n" +" boolean requiresNew() default false;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:126 +#, no-c-format +msgid "" +"Web Beans will use the value of <literal>requiresNew</literal> to choose " +"between two different interceptors, <literal>TransactionInterceptor</" +"literal> and <literal>RequiresNewTransactionInterceptor</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:130 +#, no-c-format +msgid "" +"<![CDATA[@Transactional(requiresNew=true) @Interceptor\n" +"public class RequiresNewTransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:132 +#, no-c-format +msgid "" +"Now we can use <literal>RequiresNewTransactionInterceptor</literal> like " +"this:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:134 +#, no-c-format +msgid "" +"<![CDATA[@Transactional(requiresNew=true)\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:136 +#, no-c-format +msgid "" +"But what if we only have one interceptor and we want the manager to ignore " +"the value of <literal>requiresNew</literal> when binding interceptors? We " +"can use the <literal>@NonBinding</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:140 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Secure {\n" +" @NonBinding String[] rolesAllowed() default {};\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:145 +#, no-c-format +msgid "Multiple interceptor binding annotations" +msgstr "" + +#. Tag: para +#: interceptors.xml:147 +#, no-c-format +msgid "" +"Usually we use combinations of interceptor bindings types to bind multiple " +"interceptors to a Web Bean. For example, the following declaration would be " +"used to bind <literal>TransactionInterceptor</literal> and " +"<literal>SecurityInterceptor</literal> to the same Web Bean:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:152 +#, no-c-format +msgid "" +"<![CDATA[@Secure(rolesAllowed=\"admin\") @Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:154 +#, no-c-format +msgid "" +"However, in very complex cases, an interceptor itself may specify some " +"combination of interceptor binding types:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:157 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure @Interceptor\n" +"public class TransactionalSecureInterceptor { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:159 +#, no-c-format +msgid "" +"Then this interceptor could be bound to the <literal>checkout()</literal> " +"method using any one of the following combinations:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:162 +#, no-c-format +msgid "" +"<![CDATA[public class ShoppingCart {\n" +" @Transactional @Secure public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:164 +#, no-c-format +msgid "" +"<![CDATA[@Secure\n" +"public class ShoppingCart {\n" +" @Transactional public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:166 +#, no-c-format +msgid "" +"<![CDATA[@Transactionl\n" +"public class ShoppingCart {\n" +" @Secure public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:168 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure\n" +"public class ShoppingCart {\n" +" public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:173 +#, no-c-format +msgid "Interceptor binding type inheritance" +msgstr "" + +#. Tag: para +#: interceptors.xml:175 +#, no-c-format +msgid "" +"One limitation of the Java language support for annotations is the lack of " +"annotation inheritance. Really, annotations should have reuse built in, to " +"allow this kind of thing to work:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:179 +#, no-c-format +msgid "" +"<![CDATA[public @interface Action extends Transactional, Secure { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:181 +#, no-c-format +msgid "" +"Well, fortunately, Web Beans works around this missing feature of Java. We " +"may annotate one interceptor binding type with other interceptor binding " +"types. The interceptor bindings are transitiveany Web Bean with the " +"first interceptor binding inherits the interceptor bindings declared as meta-" +"annotations." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:186 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure\n" +"@InterceptorBindingType\n" +"@Target(TYPE)\n" +"@Retention(RUNTIME)\n" +"public @interface Action { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:188 +#, no-c-format +msgid "" +"Any Web Bean annotated <literal>@Action</literal> will be bound to both " +"<literal>TransactionInterceptor</literal> and <literal>SecurityInterceptor</" +"literal>. (And even <literal>TransactionalSecureInterceptor</literal>, if it " +"exists.)" +msgstr "" + +#. Tag: title +#: interceptors.xml:195 +#, no-c-format +msgid "Use of <literal>@Interceptors</literal>" +msgstr "" + +#. Tag: para +#: interceptors.xml:197 +#, no-c-format +msgid "" +"The <literal>@Interceptors</literal> annotation defined by the EJB " +"specification is supported for both enterprise and simple Web Beans, for " +"example:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:200 +#, no-c-format +msgid "" +"<![CDATA[(a)Interceptors({TransactionInterceptor.class, @SecurityInterceptor." +"class})\n" +"public class ShoppingCart {\n" +" public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:202 +#, no-c-format +msgid "However, this approach suffers the following drawbacks:" +msgstr "" + +#. Tag: para +#: interceptors.xml:206 +#, no-c-format +msgid "the interceptor implementation is hardcoded in business code," +msgstr "" + +#. Tag: para +#: interceptors.xml:209 +#, no-c-format +msgid "interceptors may not be easily disabled at deployment time, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:212 +#, no-c-format +msgid "" +"the interceptor ordering is non-globalit is determined by the order in " +"which interceptors are listed at the class level." +msgstr "" + +#. Tag: para +#: interceptors.xml:217 +#, no-c-format +msgid "" +"Therefore, we recommend the use of Web Beans-style interceptor bindings." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/intro.po =================================================================== --- doc/trunk/reference/fr-FR/modules/intro.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/intro.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,1075 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: intro.xml:4 +#, no-c-format +msgid "Getting started with Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:6 +#, no-c-format +msgid "" +"So you're already keen to get started writing your first Web Bean? Or " +"perhaps you're skeptical, wondering what kinds of hoops the Web Beans " +"specification will make you jump through! The good news is that you've " +"probably already written and used hundreds, perhaps thousands of Web Beans. " +"You might not even remember the first Web Bean you wrote." +msgstr "" + +#. Tag: title +#: intro.xml:13 +#, no-c-format +msgid "Your first Web Bean" +msgstr "" + +#. Tag: para +#: intro.xml:15 +#, no-c-format +msgid "" +"With certain, very special exceptions, every Java class with a constructor " +"that accepts no parameters is a Web Bean. That includes every JavaBean. " +"Furthermore, every EJB 3-style session bean is a Web Bean. Sure, the " +"JavaBeans and EJBs you've been writing every day have not been able to take " +"advantage of the new services defined by the Web Beans specification, but " +"you'll be able to use every one of them as Web Beansinjecting them " +"into other Web Beans, configuring them via the Web Beans XML configuration " +"facility, even adding interceptors and decorators to themwithout " +"touching your existing code." +msgstr "" + +#. Tag: para +#: intro.xml:25 +#, no-c-format +msgid "" +"Suppose that we have two existing Java classes, that we've been using for " +"years in various applications. The first class parses a string into a list " +"of sentences:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:29 +#, no-c-format +msgid "" +"<![CDATA[public class SentenceParser {\n" +" public List<String> parse(String text) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:31 +#, no-c-format +msgid "" +"The second existing class is a stateless session bean front-end for an " +"external system that is able to translate sentences from one language to " +"another:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:35 +#, no-c-format +msgid "" +"<![CDATA[@Stateless\n" +"public class SentenceTranslator implements Translator {\n" +" public String translate(String sentence) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:37 +#, no-c-format +msgid "Where <literal>Translator</literal> is the local interface:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:39 +#, no-c-format +msgid "" +"<![CDATA[@Local\n" +"public interface Translator {\n" +" public String translate(String sentence);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:41 +#, no-c-format +msgid "" +"Unfortunately, we don't have a preexisting class that translates whole text " +"documents. So let's write a Web Bean that does this job:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:44 +#, no-c-format +msgid "" +"<![CDATA[public class TextTranslator {\n" +" \n" +" private SentenceParser sentenceParser;\n" +" private Translator sentenceTranslator;\n" +" \n" +" @Initializer\n" +" TextTranslator(SentenceParser sentenceParser, Translator " +"sentenceTranslator) {\n" +" this.sentenceParser = sentenceParser;\n" +" this.sentenceTranslator = sentenceTranslator;\n" +" }\n" +" \n" +" public String translate(String text) {\n" +" StringBuilder sb = new StringBuilder();\n" +" for (String sentence: sentenceParser.parse(text)) {\n" +" sb.append(sentenceTranslator.translate(sentence));\n" +" }\n" +" return sb.toString();\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:46 +#, no-c-format +msgid "" +"We may obtain an instance of <literal>TextTranslator</literal> by injecting " +"it into a Web Bean, Servlet or EJB:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:49 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public setTextTranslator(TextTranslator textTranslator) {\n" +" this.textTranslator = textTranslator;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:51 +#, no-c-format +msgid "" +"Alternatively, we may obtain an instance by directly calling a method of the " +"Web Bean manager:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:54 +#, no-c-format +msgid "" +"<![CDATA[TextTranslator tt = manager.getInstanceByType(TextTranslator." +"class);]]>" +msgstr "" + +#. Tag: para +#: intro.xml:56 +#, no-c-format +msgid "" +"But wait: <literal>TextTranslator</literal> does not have a constructor with " +"no parameters! Is it still a Web Bean? Well, a class that does not have a " +"constructor with no parameters can still be a Web Bean if it has a " +"constructor annotated <literal>@Initializer</literal>." +msgstr "" + +#. Tag: para +#: intro.xml:61 +#, no-c-format +msgid "" +"As you've guessed, the <literal>@Initializer</literal> annotation has " +"something to do with dependency injection! <literal>@Initializer</literal> " +"may be applied to a constructor or method of a Web Bean, and tells the Web " +"Bean manager to call that constructor or method when instantiating the Web " +"Bean. The Web Bean manager will inject other Web Beans to the parameters of " +"the constructor or method." +msgstr "" + +#. Tag: para +#: intro.xml:68 +#, no-c-format +msgid "" +"At system initialization time, the Web Bean manager must validate that " +"exactly one Web Bean exists which satisfies each injection point. In our " +"example, if no implementation of <literal>Translator</literal> " +"availableif the <literal>SentenceTranslator</literal> EJB was not " +"deployedthe Web Bean manager would throw an " +"<literal>UnsatisfiedDependencyException</literal>. If more than one " +"implementation of <literal>Translator</literal> was available, the Web Bean " +"manager would throw an <literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: title +#: intro.xml:80 +#, no-c-format +msgid "What is a Web Bean?" +msgstr "" + +#. Tag: para +#: intro.xml:82 +#, no-c-format +msgid "So what, <emphasis>exactly</emphasis>, is a Web Bean?" +msgstr "" + +#. Tag: para +#: intro.xml:84 +#, no-c-format +msgid "" +"A Web Bean is an application class that contains business logic. A Web Bean " +"may be called directly from Java code, or it may be invoked via Unified EL. " +"A Web Bean may access transactional resources. Dependencies between Web " +"Beans are managed automatically by the Web Bean manager. Most Web Beans are " +"<emphasis>stateful</emphasis> and <emphasis>contextual</emphasis>. The " +"lifecycle of a Web Bean is always managed by the Web Bean manager." +msgstr "" + +#. Tag: para +#: intro.xml:91 +#, no-c-format +msgid "" +"Let's back up a second. What does it really mean to be \"contextual\"? Since " +"Web Beans may be stateful, it matters <emphasis>which</emphasis> bean " +"instance I have. Unlike a stateless component model (for example, stateless " +"session beans) or a singleton component model (such as servlets, or " +"singleton beans), different clients of a Web Bean see the Web Bean in " +"different states. The client-visible state depends upon which instance of " +"the Web Bean the client has a reference to." +msgstr "" + +#. Tag: para +#: intro.xml:98 +#, no-c-format +msgid "" +"However, like a stateless or singleton model, but <emphasis>unlike</" +"emphasis> stateful session beans, the client does not control the lifecycle " +"of the instance by explicitly creating and destroying it. Instead, the " +"<emphasis>scope</emphasis> of the Web Bean determines:" +msgstr "" + +#. Tag: para +#: intro.xml:105 +#, no-c-format +msgid "the lifecycle of each instance of the Web Bean and" +msgstr "" + +#. Tag: para +#: intro.xml:108 +#, no-c-format +msgid "" +"which clients share a reference to a particular instance of the Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:113 +#, no-c-format +msgid "" +"For a given thread in a Web Beans application, there may be an " +"<emphasis>active context</emphasis> associated with the scope of the Web " +"Bean. This context may be unique to the thread (for example, if the Web Bean " +"is request scoped), or it may be shared with certain other threads (for " +"example, if the Web Bean is session scoped) or even all other threads (if it " +"is application scoped)." +msgstr "" + +#. Tag: para +#: intro.xml:119 +#, no-c-format +msgid "" +"Clients (for example, other Web Beans) executing in the same context will " +"see the same instance of the Web Bean. But clients in a different context " +"will see a different instance." +msgstr "" + +#. Tag: para +#: intro.xml:123 +#, no-c-format +msgid "" +"One great advantage of the contextual model is that it allows stateful Web " +"Beans to be treated like services! The client need not concern itself with " +"managing the lifecycle of the Web Bean it is using, <emphasis>nor does it " +"even need to know what that lifecyle is.</emphasis> Web Beans interact by " +"passing messages, and the Web Bean implementations define the lifecycle of " +"their own state. The Web Beans are loosely coupled because:" +msgstr "" + +#. Tag: para +#: intro.xml:132 +#, no-c-format +msgid "they interact via well-defined public APIs" +msgstr "" + +#. Tag: para +#: intro.xml:135 +#, no-c-format +msgid "their lifecycles are completely decoupled" +msgstr "" + +#. Tag: para +#: intro.xml:139 +#, no-c-format +msgid "" +"We can replace one Web Bean with a different Web Bean that implements the " +"same API and has a different lifecycle (a different scope) without affecting " +"the other Web Bean implementation. In fact, Web Beans defines a " +"sophisticated facility for overriding Web Bean implementations at deployment " +"time, as we will see in <xref linkend=\"deploymenttypes\"/>." +msgstr "" + +#. Tag: para +#: intro.xml:145 +#, no-c-format +msgid "" +"Note that not all clients of a Web Bean are Web Beans. Other objects such as " +"Servlets or Message-Driven Beanswhich are by nature not injectable, " +"contextual objectsmay also obtain references to Web Beans by injection." +msgstr "" + +#. Tag: para +#: intro.xml:149 +#, no-c-format +msgid "Enough hand-waving. More formally, according to the spec:" +msgstr "" + +#. Tag: para +#: intro.xml:153 +#, no-c-format +msgid "A Web Bean comprises:" +msgstr "" + +#. Tag: para +#: intro.xml:156 +#, no-c-format +msgid "A (nonempty) set of API types" +msgstr "" + +#. Tag: para +#: intro.xml:157 +#, no-c-format +msgid "A (nonempty) set of binding annotation types" +msgstr "" + +#. Tag: para +#: intro.xml:158 +#, no-c-format +msgid "A scope" +msgstr "" + +#. Tag: para +#: intro.xml:159 +#, no-c-format +msgid "A deployment type" +msgstr "" + +#. Tag: para +#: intro.xml:160 +#, no-c-format +msgid "Optionally, a Web Bean name" +msgstr "" + +#. Tag: para +#: intro.xml:161 +#, no-c-format +msgid "A set of interceptor binding types" +msgstr "" + +#. Tag: para +#: intro.xml:162 +#, no-c-format +msgid "A Web Bean implementation" +msgstr "" + +#. Tag: para +#: intro.xml:167 +#, no-c-format +msgid "Let's see what some of these terms mean, to the Web Bean developer." +msgstr "" + +#. Tag: title +#: intro.xml:170 +#, no-c-format +msgid "API types, binding types and dependency injection" +msgstr "" + +#. Tag: para +#: intro.xml:172 +#, no-c-format +msgid "" +"Web Beans usually acquire references to other Web Beans via dependency " +"injection. Any injected attribute specifies a \"contract\" that must be " +"satisfied by the Web Bean to be injected. The contract is:" +msgstr "" + +#. Tag: para +#: intro.xml:177 +#, no-c-format +msgid "an API type, together with" +msgstr "" + +#. Tag: para +#: intro.xml:178 +#, no-c-format +msgid "a set of binding types." +msgstr "" + +#. Tag: para +#: intro.xml:181 +#, no-c-format +msgid "" +"An API is a user-defined class or interface. (If the Web Bean is an EJB " +"session bean, the API type is the <literal>@Local</literal> interface or " +"bean-class local view). A binding type represents some client-visible " +"semantic that is satisfied by some implementations of the API and not by " +"others." +msgstr "" + +#. Tag: para +#: intro.xml:186 +#, no-c-format +msgid "" +"Binding types are represented by user-defined annotations that are " +"themselves annotated <literal>@BindingType</literal>. For example, the " +"following injection point has API type <literal>PaymentProcessor</literal> " +"and binding type <literal>@CreditCard</literal>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:191 +#, no-c-format +msgid "<![CDATA[@CreditCard PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: intro.xml:193 +#, no-c-format +msgid "" +"If no binding type is explicitly specified at an injection point, the " +"default binding type <literal>@Current</literal> is assumed." +msgstr "" + +#. Tag: para +#: intro.xml:196 +#, no-c-format +msgid "" +"For each injection point, the Web Bean manager searches for a Web Bean which " +"satisfies the contract (implements the API, and has all the binding types), " +"and injects that Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:200 +#, no-c-format +msgid "" +"The following Web Bean has the binding type <literal>@CreditCard</literal> " +"and implements the API type <literal>PaymentProcessor</literal>. It could " +"therefore be injected to the example injection point:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:204 +#, no-c-format +msgid "" +"<![CDATA[@CreditCard\n" +"public class CreditCardPaymentProcessor \n" +" implements PaymentProcessor { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:206 +#, no-c-format +msgid "" +"If a Web Bean does not explicitly specify a set of binding types, it has " +"exactly one binding type: the default binding type <literal>@Current</" +"literal>." +msgstr "" + +#. Tag: para +#: intro.xml:209 +#, no-c-format +msgid "" +"Web Beans defines a sophisticated but intuitive <emphasis>resolution " +"algorithm</emphasis> that helps the container decide what to do if there is " +"more than one Web Bean that satisfies a particular contract. We'll get into " +"the details in <xref linkend=\"injection\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:217 +#, no-c-format +msgid "Deployment types" +msgstr "" + +#. Tag: para +#: intro.xml:219 +#, no-c-format +msgid "" +"<emphasis>Deployment types</emphasis> let us classify our Web Beans by " +"deployment scenario. A deployment type is an annotation that represents a " +"particular deployment scenario, for example <literal>@Mock</literal>, " +"<literal>@Staging</literal> or <literal>@AustralianTaxLaw</literal>. We " +"apply the annotation to Web Beans which should be deployed in that scenario. " +"A deployment type allows a whole set of Web Beans to be conditionally " +"deployed, with a just single line of configuration." +msgstr "" + +#. Tag: para +#: intro.xml:226 +#, no-c-format +msgid "" +"Many Web Beans just use the default deployment type <literal>@Production</" +"literal>, in which case no deployment type need be explicitly specified. All " +"three Web Bean in our example have the deployment type <literal>@Production</" +"literal>." +msgstr "" + +#. Tag: para +#: intro.xml:230 +#, no-c-format +msgid "" +"In a testing environment, we might want to replace the " +"<literal>SentenceTranslator</literal> Web Bean with a \"mock object\":" +msgstr "" + +#. Tag: programlisting +#: intro.xml:233 +#, no-c-format +msgid "" +"<![CDATA[@Mock\n" +"public class MockSentenceTranslator implements Translator {\n" +" public String translate(String sentence) {\n" +" return \"Lorem ipsum dolor sit amet\";\n" +" }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:236 +#, no-c-format +msgid "" +"We would enable the deployment type <literal>@Mock</literal> in our testing " +"environment, to indicate that <literal>MockSentenceTranslator</literal> and " +"any other Web Bean annotated <literal>@Mock</literal> should be used." +msgstr "" + +#. Tag: para +#: intro.xml:240 +#, no-c-format +msgid "" +"We'll talk more about this unique and powerful feature in <xref linkend=" +"\"deploymenttypes\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:246 +#, no-c-format +msgid "Scope" +msgstr "" + +#. Tag: para +#: intro.xml:248 +#, no-c-format +msgid "" +"The <emphasis>scope</emphasis> defines the lifecycle and visibility of " +"instances of the Web Bean. The Web Beans context model is extensible, " +"accommodating arbitrary scopes. However, certain important scopes are built-" +"in to the specification, and provided by the Web Bean manager. A scope is " +"represented by an annotation type." +msgstr "" + +#. Tag: para +#: intro.xml:254 +#, no-c-format +msgid "" +"For example, any web application may have <emphasis>session scoped</" +"emphasis> Web Beans:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:257 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:259 +#, no-c-format +msgid "" +"An instance of a session scoped Web Bean is bound to a user session and is " +"shared by all requests that execute in the context of that session." +msgstr "" + +#. Tag: para +#: intro.xml:262 +#, no-c-format +msgid "" +"By default, Web Beans belong to a special scope called the " +"<emphasis>dependent pseudo-scope</emphasis>. Web Beans with this scope are " +"pure dependent objects of the object into which they are injected, and their " +"lifecycle is bound to the lifecycle of that object." +msgstr "" + +#. Tag: para +#: intro.xml:267 +#, no-c-format +msgid "We'll talk more about scopes in <xref linkend=\"scopescontexts\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:272 +#, no-c-format +msgid "Web Bean names and Unified EL" +msgstr "" + +#. Tag: para +#: intro.xml:274 +#, no-c-format +msgid "" +"A Web Bean may have a <emphasis>name</emphasis>, allowing it to be used in " +"Unified EL expressions. It's easy to specify the name of a Web Bean:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:278 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named(\"cart\")\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:280 +#, no-c-format +msgid "Now we can easily use the Web Bean in any JSF or JSP page:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:282 +#, no-c-format +msgid "" +"<![CDATA[<h:dataTable value=\"#{cart.lineItems}\" var=\"item\">\n" +" ....\n" +"</h:dataTable>]]>" +msgstr "" + +#. Tag: para +#: intro.xml:284 +#, no-c-format +msgid "" +"It's even easier to just let the name be defaulted by the Web Bean manager:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:287 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:289 +#, no-c-format +msgid "" +"In this case, the name defaults to <literal>shoppingCart</literal>the " +"unqualified class name, with the first character changed to lowercase." +msgstr "" + +#. Tag: title +#: intro.xml:295 +#, no-c-format +msgid "Interceptor binding types" +msgstr "" + +#. Tag: para +#: intro.xml:297 +#, no-c-format +msgid "" +"Web Beans supports the interceptor functionality defined by EJB 3, not only " +"for EJB beans, but also for plain Java classes. In addition, Web Beans " +"provides a new approach to binding interceptors to EJB beans and other Web " +"Beans." +msgstr "" + +#. Tag: para +#: intro.xml:302 +#, no-c-format +msgid "" +"It remains possible to directly specify the interceptor class via use of the " +"<literal>@Interceptors</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:305 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped \n" +"@Interceptors(TransactionInterceptor.class)\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:307 +#, no-c-format +msgid "" +"However, it is more elegant, and better practice, to indirect the " +"interceptor binding through an <emphasis>interceptor binding type</emphasis>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:311 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:313 +#, no-c-format +msgid "" +"We'll discuss Web Beans interceptors and decorators in <xref linkend=" +"\"interceptors\"/> and <xref linkend=\"decorators\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:321 +#, no-c-format +msgid "What kinds of objects can be Web Beans?" +msgstr "" + +#. Tag: para +#: intro.xml:323 +#, no-c-format +msgid "" +"We've already seen that JavaBeans, EJBs and some other Java classes can be " +"Web Beans. But exactly what kinds of objects are Web Beans?" +msgstr "" + +#. Tag: title +#: intro.xml:327 +#, no-c-format +msgid "Simple Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:329 +#, no-c-format +msgid "" +"The Web Beans specification says that a concrete Java class is a " +"<emphasis>simple</emphasis> Web Bean if:" +msgstr "" + +#. Tag: para +#: intro.xml:334 +#, no-c-format +msgid "" +"it is not an EE container-managed component, like an EJB, a Servlet or a JPA " +"entity," +msgstr "" + +#. Tag: para +#: intro.xml:338 +#, no-c-format +msgid "it is not a non-static static inner class," +msgstr "" + +#. Tag: para +#: intro.xml:341 +#, no-c-format +msgid "it is not a parameterized type, and" +msgstr "" + +#. Tag: para +#: intro.xml:344 +#, no-c-format +msgid "" +"it has a constructor with no parameters, or a constructor annotated " +"<literal>@Initializer</literal>." +msgstr "" + +#. Tag: para +#: intro.xml:349 +#, no-c-format +msgid "Thus, almost every JavaBean is a simple Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:351 +#, no-c-format +msgid "" +"Every interface implemented directly or indirectly by a simple Web Bean is " +"an API type of the simple Web Bean. The class and its superclasses are also " +"API types." +msgstr "" + +#. Tag: title +#: intro.xml:358 +#, no-c-format +msgid "Enterprise Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:360 +#, no-c-format +msgid "" +"The specification says that all EJB 3-style session and singleton beans are " +"<emphasis>enterprise</emphasis> Web Beans. Message driven beans are not Web " +"Beanssince they are not intended to be injected into other " +"objectsbut they can take advantage of most of the functionality of Web " +"Beans, including dependency injection and interceptors." +msgstr "" + +#. Tag: para +#: intro.xml:366 +#, no-c-format +msgid "" +"Every local interface of an enterprise Web Bean that does not have a " +"wildcard type parameter or type variable, and every one of its " +"superinterfaces, is an API type of the enterprise Web Bean. If the EJB bean " +"has a bean class local view, the bean class, and every one of its " +"superclasses, is also an API type." +msgstr "" + +#. Tag: para +#: intro.xml:372 +#, no-c-format +msgid "" +"Stateful session beans should declare a remove method with no parameters or " +"a remove method annotated <literal>@Destructor</literal>. The Web Bean " +"manager calls this method to destroy the stateful session bean instance at " +"the end of its lifecycle. This method is called the <emphasis>destructor</" +"emphasis> method of the enterprise Web Bean." +msgstr "" + +#. Tag: programlisting +#: intro.xml:378 +#, no-c-format +msgid "" +"<![CDATA[@Stateful @SessionScoped\n" +"public class ShoppingCart {\n" +"\n" +" ...\n" +" \n" +" @Remove\n" +" public void destroy() {}\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:380 +#, no-c-format +msgid "" +"So when should we use an enterprise Web Bean instead of a simple Web Bean? " +"Well, whenever we need the advanced enterprise services offered by EJB, such " +"as:" +msgstr "" + +#. Tag: para +#: intro.xml:387 +#, no-c-format +msgid "method-level transaction management and security," +msgstr "" + +#. Tag: para +#: intro.xml:390 +#, no-c-format +msgid "concurrency management," +msgstr "" + +#. Tag: para +#: intro.xml:393 +#, no-c-format +msgid "" +"instance-level passivation for stateful session beans and instance-pooling " +"for stateless session beans," +msgstr "" + +#. Tag: para +#: intro.xml:397 +#, no-c-format +msgid "remote and web service invocation, and" +msgstr "" + +#. Tag: para +#: intro.xml:400 +#, no-c-format +msgid "timers and asynchronous methods," +msgstr "" + +#. Tag: para +#: intro.xml:404 +#, no-c-format +msgid "" +"we should use an enterprise Web Bean. When we don't need any of these " +"things, a simple Web Bean will serve just fine." +msgstr "" + +#. Tag: para +#: intro.xml:407 +#, no-c-format +msgid "" +"Many Web Beans (including any session or application scoped Web Bean) are " +"available for concurrent access. Therefore, the concurrency management " +"provided by EJB 3.1 is especially useful. Most session and application " +"scoped Web Beans should be EJBs." +msgstr "" + +#. Tag: para +#: intro.xml:412 +#, no-c-format +msgid "" +"Web Beans which hold references to heavy-weight resources, or hold a lot of " +"internal state benefit from the advanced container-managed lifecycle defined " +"by the EJB <literal>@Stateless</literal>/<literal>@Stateful</literal>/" +"<literal>@Singleton</literal> model, with its support for passivation and " +"instance pooling." +msgstr "" + +#. Tag: para +#: intro.xml:417 +#, no-c-format +msgid "" +"Finally, it's usually obvious when method-level transaction management, " +"method-level security, timers, remote methods or asynchronous methods are " +"needed." +msgstr "" + +#. Tag: para +#: intro.xml:420 +#, no-c-format +msgid "" +"It's usually easy to start with simple Web Bean, and then turn it into an " +"EJB, just by adding an annotation: <literal>@Stateless</literal>, " +"<literal>@Stateful</literal> or <literal>@Singleton</literal>." +msgstr "" + +#. Tag: title +#: intro.xml:427 +#, no-c-format +msgid "Producer methods" +msgstr "" + +#. Tag: para +#: intro.xml:429 +#, no-c-format +msgid "" +"A <emphasis>producer method</emphasis> is a method that is called by the Web " +"Bean manager to obtain an instance of the Web Bean when no instance exists " +"in the current context. A producer method lets the application take full " +"control of the instantiation process, instead of leaving instantiation to " +"the Web Bean manager. For example:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:435 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped\n" +"public class Generator {\n" +"\n" +" private Random random = new Random( System.currentTimeMillis() );\n" +" \n" +" @Produces @Random int next() {\n" +" return random.nextInt(100);\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:437 +#, no-c-format +msgid "" +"The result of a producer method is injected just like any other Web Bean." +msgstr "" + +#. Tag: programlisting +#: intro.xml:439 +#, no-c-format +msgid "<![CDATA[@Random int randomNumber]]>" +msgstr "" + +#. Tag: para +#: intro.xml:441 +#, no-c-format +msgid "" +"The method return type and all interfaces it extends/implements directly or " +"indirectly are API types of the producer method. If the return type is a " +"class, all superclasses are also API types." +msgstr "" + +#. Tag: para +#: intro.xml:445 +#, no-c-format +msgid "Some producer methods return objects that require explicit destruction:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:447 +#, no-c-format +msgid "" +"<![CDATA[@Produces @RequestScoped Connection connect(User user) {\n" +" return createConnection( user.getId(), user.getPassword() );\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:449 +#, no-c-format +msgid "" +"These producer methods may define matching <emphasis>disposal methods</" +"emphasis>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:451 +#, no-c-format +msgid "" +"<![CDATA[void close(@Disposes Connection connection) {\n" +" connection.close();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:453 +#, no-c-format +msgid "" +"This disposal method is called automatically by the Web Bean manager at the " +"end of the request." +msgstr "" + +#. Tag: para +#: intro.xml:456 +#, no-c-format +msgid "" +"We'll talk much more about producer methods in <xref linkend=" +"\"producermethods\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:461 +#, no-c-format +msgid "JMS endpoints" +msgstr "" + +#. Tag: para +#: intro.xml:463 +#, no-c-format +msgid "" +"Finally, a JMS queue or topic can be a Web Bean. Web Beans relieves the " +"developer from the tedium of managing the lifecycles of all the various JMS " +"objects required to send messages to queues and topics. We'll discuss JMS " +"endpoints in <xref linkend=\"jms\"/>." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/next.po =================================================================== --- doc/trunk/reference/fr-FR/modules/next.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/next.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,49 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: next.xml:4 +#, no-c-format +msgid "Next steps" +msgstr "" + +#. Tag: para +#: next.xml:6 +#, no-c-format +msgid "" +"Because Web Beans is so new, there's not yet a lot of information available " +"online." +msgstr "" + +#. Tag: para +#: next.xml:9 +#, no-c-format +msgid "" +"Of course, the Web Beans specification is the best source of more " +"information about Web Beans. The spec is about 100 pages long, only twice " +"the length of this article, and almost as readable. But, of course, it " +"covers many details that we've skipped over. The spec is available from " +"<literal>http://jcp.org/en/jsr/detail?id=299</literal>." +msgstr "" + +#. Tag: para +#: next.xml:15 +#, no-c-format +msgid "" +"The Web Beans Reference implementation is being developed at <literal>http://" +"seamframework.org/WebBeans</literal>. The RI development team and the Web " +"Beans spec lead blog at <literal>http://in.relation.to</literal>. This " +"article is substantially based upon a series of blog entries published there." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/part1.po =================================================================== --- doc/trunk/reference/fr-FR/modules/part1.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/part1.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,229 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part1.xml:5 +#, no-c-format +msgid "" +"The Web Beans (JSR-299) specification defines a set of services for the Java " +"EE environment that makes applications much easier to develop. Web Beans " +"layers an enhanced lifecycle and interaction model over existing Java " +"component types including JavaBeans and Enterprise Java Beans. As a " +"complement to the traditional Java EE programming model, the Web Beans " +"services provide:" +msgstr "" + +#. Tag: para +#: part1.xml:14 +#, no-c-format +msgid "" +"an improved lifecycle for stateful components, bound to well-defined " +"<emphasis>contexts</emphasis>," +msgstr "" + +#. Tag: para +#: part1.xml:18 +#, no-c-format +msgid "a typesafe approach to <emphasis>dependency injection</emphasis>," +msgstr "" + +#. Tag: para +#: part1.xml:21 +#, no-c-format +msgid "" +"interaction via an <emphasis>event notification</emphasis> facility, and" +msgstr "" + +#. Tag: para +#: part1.xml:25 +#, no-c-format +msgid "" +"a better approach to binding <emphasis>interceptors</emphasis> to " +"components, along with a new kind of interceptor, called a " +"<emphasis>decorator</emphasis>, that is more appropriate for use in solving " +"business problems." +msgstr "" + +#. Tag: para +#: part1.xml:32 +#, no-c-format +msgid "" +"Dependency injection, together with contextual lifecycle management, saves " +"the user of an unfamiliar API from having to ask and answer the following " +"questions:" +msgstr "" + +#. Tag: para +#: part1.xml:38 +#, no-c-format +msgid "what is the lifecycle of this object?" +msgstr "" + +#. Tag: para +#: part1.xml:41 +#, no-c-format +msgid "how many simultaneous clients can it have?" +msgstr "" + +#. Tag: para +#: part1.xml:44 +#, no-c-format +msgid "is it multithreaded?" +msgstr "" + +#. Tag: para +#: part1.xml:47 +#, no-c-format +msgid "where can I get one from?" +msgstr "" + +#. Tag: para +#: part1.xml:50 +#, no-c-format +msgid "do I need to explicitly destroy it?" +msgstr "" + +#. Tag: para +#: part1.xml:53 +#, no-c-format +msgid "where should I keep my reference to it when I'm not using it directly?" +msgstr "" + +#. Tag: para +#: part1.xml:57 +#, no-c-format +msgid "" +"how can I add an indirection layer, so that the implementation of this " +"object can vary at deployment time?" +msgstr "" + +#. Tag: para +#: part1.xml:61 +#, no-c-format +msgid "how should I go about sharing this object between other objects?" +msgstr "" + +#. Tag: para +#: part1.xml:65 +#, no-c-format +msgid "" +"A Web Bean specifies only the type and semantics of other Web Beans it " +"depends upon. It need not be aware of the actual lifecycle, concrete " +"implementation, threading model or other clients of any Web Bean it depends " +"upon. Even better, the concrete implementation, lifecycle and threading " +"model of a Web Bean it depends upon may vary according to the deployment " +"scenario, without affecting any client." +msgstr "" + +#. Tag: para +#: part1.xml:72 +#, no-c-format +msgid "" +"Events, interceptors and decorators enhance the <emphasis>loose-coupling</" +"emphasis> that is inherent in this model:" +msgstr "" + +#. Tag: para +#: part1.xml:77 +#, no-c-format +msgid "" +"<emphasis>event notifications</emphasis> decouple event producers from event " +"consumers," +msgstr "" + +#. Tag: para +#: part1.xml:81 +#, no-c-format +msgid "" +"<emphasis>interceptors</emphasis> decouple technical concerns from business " +"logic, and" +msgstr "" + +#. Tag: para +#: part1.xml:85 +#, no-c-format +msgid "" +"<emphasis>decorators</emphasis> allow business concerns to be " +"compartmentalized." +msgstr "" + +#. Tag: para +#: part1.xml:90 +#, no-c-format +msgid "" +"Most importantly, Web Beans provides all these facilities in a " +"<emphasis>typesafe</emphasis> way. Web Beans never uses string-based " +"identifiers to determine how collaborating objects fit together. And XML, " +"though it remains an option, is rarely used. Instead, Web Beans uses the " +"typing information that is already available in the Java object model, " +"together with a new pattern, called <emphasis>binding annotations</" +"emphasis>, to wire together Web Beans, their dependencies, their " +"interceptors and decorators and their event consumers." +msgstr "" + +#. Tag: para +#: part1.xml:100 +#, no-c-format +msgid "" +"The Web Beans services are general and apply to the following types of " +"components that exist in the Java EE environment:" +msgstr "" + +#. Tag: para +#: part1.xml:105 +#, no-c-format +msgid "all JavaBeans," +msgstr "" + +#. Tag: para +#: part1.xml:108 +#, no-c-format +msgid "all EJBs, and" +msgstr "" + +#. Tag: para +#: part1.xml:111 +#, no-c-format +msgid "all Servlets." +msgstr "" + +#. Tag: para +#: part1.xml:115 +#, no-c-format +msgid "" +"Web Beans even provides the necessary integration points so that other kinds " +"of components defined by future Java EE specifications or by non-standard " +"frameworks may be cleanly integrated with Web Beans, take advantage of the " +"Web Beans services, and interact with any other kind of Web Bean." +msgstr "" + +#. Tag: para +#: part1.xml:120 +#, no-c-format +msgid "" +"Web Beans was influenced by a number of existing Java frameworks, including " +"Seam, Guice and Spring. However, Web Beans has its own very distinct " +"character: more typesafe than Seam, more stateful and less XML-centric than " +"Spring, more web and enterprise-application capable than Guice." +msgstr "" + +#. Tag: para +#: part1.xml:125 +#, no-c-format +msgid "" +"Most importantly, Web Beans is a JCP standard that integrates cleanly with " +"Java EE, and with any Java SE environment where embeddable EJB Lite is " +"available." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/part2.po =================================================================== --- doc/trunk/reference/fr-FR/modules/part2.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/part2.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,102 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part2.xml:5 +#, no-c-format +msgid "" +"The first major theme of Web Beans is <emphasis>loose coupling</emphasis>. " +"We've already seen three means of achieving loose coupling:" +msgstr "" + +#. Tag: para +#: part2.xml:10 +#, no-c-format +msgid "" +"<emphasis>deployment types</emphasis> enable deployment time polymorphism," +msgstr "" + +#. Tag: para +#: part2.xml:14 +#, no-c-format +msgid "<emphasis>producer methods</emphasis> enable runtime polymorphism, and" +msgstr "" + +#. Tag: para +#: part2.xml:18 +#, no-c-format +msgid "" +"<emphasis>contextual lifecycle management</emphasis> decouples Web Bean " +"lifecycles." +msgstr "" + +#. Tag: para +#: part2.xml:23 +#, no-c-format +msgid "" +"These techniques serve to enable loose coupling of client and server. The " +"client is no longer tightly bound to an implementation of an API, nor is it " +"required to manage the lifecycle of the server object. This approach lets " +"<emphasis>stateful objects interact as if they were services</emphasis>." +msgstr "" + +#. Tag: para +#: part2.xml:28 +#, no-c-format +msgid "" +"Loose coupling makes a system more <emphasis>dynamic</emphasis>. The system " +"can respond to change in a well-defined manner. In the past, frameworks that " +"attempted to provide the facilities listed above invariably did it by " +"sacrificing type safety. Web Beans is the first technology that achieves " +"this level of loose coupling in a typesafe way." +msgstr "" + +#. Tag: para +#: part2.xml:34 +#, no-c-format +msgid "" +"Web Beans provides three extra important facilities that further the goal of " +"loose coupling:" +msgstr "" + +#. Tag: para +#: part2.xml:39 +#, no-c-format +msgid "" +"<emphasis>interceptors</emphasis> decouple technical concerns from business " +"logic," +msgstr "" + +#. Tag: para +#: part2.xml:43 +#, no-c-format +msgid "" +"<emphasis>decorators</emphasis> may be used to decouple some business " +"concerns, and" +msgstr "" + +#. Tag: para +#: part2.xml:47 +#, no-c-format +msgid "" +"<emphasis>event notifications</emphasis> decouple event producers from event " +"consumers." +msgstr "" + +#. Tag: para +#: part2.xml:52 +#, no-c-format +msgid "Let's explore interceptors first." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/part3.po =================================================================== --- doc/trunk/reference/fr-FR/modules/part3.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/part3.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,150 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part3.xml:5 +#, no-c-format +msgid "" +"The second major theme of Web Beans is <emphasis>strong typing</emphasis>. " +"The information about the dependencies, interceptors and decorators of a Web " +"Bean, and the information about event consumers for an event producer, is " +"contained in typesafe Java constructs that may be validated by the compiler." +msgstr "" + +#. Tag: para +#: part3.xml:10 +#, no-c-format +msgid "" +"You don't see string-based identifiers in Web Beans code, not because the " +"framework is hiding them from you using clever defaulting rulesso-" +"called \"configuration by convention\"but because there are simply no " +"strings there to begin with!" +msgstr "" + +#. Tag: para +#: part3.xml:15 +#, no-c-format +msgid "" +"The obvious benefit of this approach is that <emphasis>any</emphasis> IDE " +"can provide autocompletion, validation and refactoring without the need for " +"special tooling. But there is a second, less-immediately-obvious, benefit. " +"It turns out that when you start thinking of identifying objects, events or " +"interceptors via annotations instead of names, you have an opportunity to " +"lift the semantic level of your code." +msgstr "" + +#. Tag: para +#: part3.xml:21 +#, no-c-format +msgid "" +"Web Beans encourages you develop annotations that model concepts, for " +"example," +msgstr "" + +#. Tag: para +#: part3.xml:26 +#, no-c-format +msgid "<literal>@Asynchronous</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:29 +#, no-c-format +msgid "<literal>@Mock</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:32 +#, no-c-format +msgid "<literal>@Secure</literal> or" +msgstr "" + +#. Tag: para +#: part3.xml:35 +#, no-c-format +msgid "<literal>@Updated</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:39 +#, no-c-format +msgid "instead of using compound names like" +msgstr "" + +#. Tag: para +#: part3.xml:43 +#, no-c-format +msgid "<literal>asyncPaymentProcessor</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:46 +#, no-c-format +msgid "<literal>mockPaymentProcessor</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:49 +#, no-c-format +msgid "<literal>SecurityInterceptor</literal> or" +msgstr "" + +#. Tag: para +#: part3.xml:52 +#, no-c-format +msgid "<literal>DocumentUpdatedEvent</literal>." +msgstr "" + +#. Tag: para +#: part3.xml:56 +#, no-c-format +msgid "" +"The annotations are reusable. They help describe common qualities of " +"disparate parts of the system. They help us categorize and understand our " +"code. They help us deal with common concerns in a common way. They make our " +"code more literate and more understandable." +msgstr "" + +#. Tag: para +#: part3.xml:61 +#, no-c-format +msgid "" +"Web Beans <emphasis>stereotypes</emphasis> take this idea a step further. A " +"stereotype models a common <emphasis>role</emphasis> in your application " +"architecture. It encapsulates various properties of the role, including " +"scope, interceptor bindings, deployment type, etc, into a single reusable " +"package." +msgstr "" + +#. Tag: para +#: part3.xml:66 +#, no-c-format +msgid "" +"Even Web Beans XML metadata is strongly typed! There's no compiler for XML, " +"so Web Beans takes advantage of XML schemas to validate the Java types and " +"attributes that appear in XML. This approach turns out to make the XML more " +"literate, just like annotations made our Java code more literate." +msgstr "" + +#. Tag: para +#: part3.xml:71 +#, no-c-format +msgid "" +"We're now ready to meet some more advanced features of Web Beans. Bear in " +"mind that these features exist to make our code both easier to validate and " +"more understandable. Most of the time you don't ever really <emphasis>need</" +"emphasis> to use these features, but if you use them wisely, you'll come to " +"appreciate their power." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/part4.po =================================================================== --- doc/trunk/reference/fr-FR/modules/part4.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/part4.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,52 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part4.xml:5 +#, no-c-format +msgid "" +"The third theme of Web Beans is <emphasis>integration</emphasis>. Web Beans " +"was designed to work in concert with other technologies, helping the " +"application developer fit the other technologies together. Web Beans is an " +"open technology. It forms a part of the Java EE ecosystem, and is itself the " +"foundation for a new ecosystem of portable extensions and integration with " +"existing frameworks and technologies." +msgstr "" + +#. Tag: para +#: part4.xml:12 +#, no-c-format +msgid "" +"We've already seen how Web Beans helps integrate EJB and JSF, allowing EJBs " +"to be bound directly to JSF pages. That's just the beginning. Web Beans " +"offers the same potential to diverse other technologies, such as Business " +"Process Management engines, other Web Frameworks, and third-party component " +"models. The Java EE platform will never be able to standardize all the " +"interesting technologies that are used in the world of Java application " +"development, but Web Beans makes it easier to use the technologies which are " +"not yet part of the platform seamlessly within the Java EE environment." +msgstr "" + +#. Tag: para +#: part4.xml:21 +#, no-c-format +msgid "" +"We're about to see how to take full advantage of the Java EE platform in an " +"application that uses Web Beans. We'll also briefly meet a set of SPIs that " +"are provided to support portable extensions to Web Beans. You might not ever " +"need to use these SPIs directly, but it's nice to know they are there if you " +"need them. Most importantly, you'll take advantage of them indirectly, every " +"time you use a third-party extension." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/producermethods.po =================================================================== --- doc/trunk/reference/fr-FR/modules/producermethods.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/producermethods.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,246 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: producermethods.xml:5 +#, no-c-format +msgid "Producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:7 +#, no-c-format +msgid "" +"Producer methods let us overcome certain limitations that arise when the Web " +"Bean manager, instead of the application, is responsible for instantiating " +"objects. They're also the easiest way to integrate objects which are not Web " +"Beans into the Web Beans environment. (We'll meet a second approach in <xref " +"linkend=\"xml\"/>.)" +msgstr "" + +#. Tag: para +#: producermethods.xml:12 +#, no-c-format +msgid "According to the spec:" +msgstr "" + +#. Tag: chapter +#: producermethods.xml:12 +#, no-c-format +msgid "" +"<blockquote> <para>A Web Beans producer method acts as a source of objects " +"to be injected, where:</para> <itemizedlist> <listitem> <para>the objects to " +"be injected are not required to be instances of Web Beans,</para> </" +"listitem> <listitem> <para>the concrete type of the objects to be injected " +"may vary at runtime or</para> </listitem> <listitem> <para>the objects " +"require some custom initialization that is not performed by the Web Bean " +"constructor</para> </listitem> </itemizedlist> </blockquote> <para>For " +"example, producer methods let us:</para> <itemizedlist> <listitem> " +"<para>expose a JPA entity as a Web Bean,</para> </listitem> <listitem> " +"<para>expose any JDK class as a Web Bean,</para> </listitem> <listitem> " +"<para>define multiple Web Beans, with different scopes or initialization, " +"for the same implementation class, or</para> </listitem> <listitem> " +"<para>vary the implementation of an API type at runtime.</para> </listitem> " +"</itemizedlist> <para>In particular, producer methods let us use runtime " +"polymorphism with Web Beans. As we've seen, deployment types are a powerful " +"solution to the problem of deployment-time polymorphism. But once the system " +"is deployed, the Web Bean implementation is fixed. A producer method has no " +"such limitation:</para> <programlisting><![CDATA[@SessionScoped\n" +"public class Preferences {\n" +" \n" +" private PaymentStrategyType paymentStrategy;\n" +" \n" +" ...\n" +" \n" +" @Produces @Preferred \n" +" public PaymentStrategy getPaymentStrategy() {\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return new CreditCardPaymentStrategy();\n" +" case CHEQUE: return new ChequePaymentStrategy();\n" +" case PAYPAL: return new PayPalPaymentStrategy();\n" +" default: return null;\n" +" } \n" +" }\n" +" \n" +"}]]></programlisting> <para>Consider an injection point:</para> " +"<programlisting><![CDATA[@Preferred PaymentStrategy paymentStrat;]]></" +"programlisting> <para>This injection point has the same type and binding " +"annotations as the producer method, so it resolves to the producer method " +"using the usual Web Beans injection rules. The producer method will be " +"called by the Web Bean manager to obtain an instance to service this " +"injection point.</para>." +msgstr "" + +#. Tag: title +#: producermethods.xml:68 +#, no-c-format +msgid "Scope of a producer method" +msgstr "" + +#. Tag: para +#: producermethods.xml:70 +#, no-c-format +msgid "" +"The scope of the producer method defaults to <literal>@Dependent</literal>, " +"and so it will be called <emphasis>every time</emphasis> the Web Bean " +"manager injects this field or any other field that resolves to the same " +"producer method. Thus, there could be multiple instances of the " +"<literal>PaymentStrategy</literal> object for each user session." +msgstr "" + +#. Tag: para +#: producermethods.xml:75 +#, no-c-format +msgid "" +"To change this behavior, we can add a <literal>@SessionScoped</literal> " +"annotation to the method." +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:78 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy() {\n" +" ...\n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:80 +#, no-c-format +msgid "" +"Now, when the producer method is called, the returned " +"<literal>PaymentStrategy</literal> will be bound to the session context. The " +"producer method won't be called again in the same session." +msgstr "" + +#. Tag: title +#: producermethods.xml:87 +#, no-c-format +msgid "Injection into producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:89 +#, no-c-format +msgid "" +"There's one potential problem with the code above. The implementations of " +"<literal>CreditCardPaymentStrategy</literal> are instantiated using the Java " +"<literal>new</literal> operator. Objects instantiated directly by the " +"application can't take advantage of dependency injection and don't have " +"interceptors." +msgstr "" + +#. Tag: para +#: producermethods.xml:94 +#, no-c-format +msgid "" +"If this isn't what we want we can use dependency injection into the producer " +"method to obtain Web Bean instances:" +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:97 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy(CreditCardPaymentStrategy ccps,\n" +" ChequePaymentStrategy cps,\n" +" PayPalPaymentStrategy ppps) {\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return ccps;\n" +" case CHEQUE: return cps;\n" +" case PAYPAL: return ppps;\n" +" default: return null;\n" +" } \n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:99 +#, no-c-format +msgid "" +"Wait, what if <literal>CreditCardPaymentStrategy</literal> is a request " +"scoped Web Bean? Then the producer method has the effect of \"promoting\" " +"the current request scoped instance into session scope. This is almost " +"certainly a bug! The request scoped object will be destroyed by the Web Bean " +"manager before the session ends, but the reference to the object will be " +"left \"hanging\" in the session scope. This error will <emphasis>not</" +"emphasis> be detected by the Web Bean manager, so please take extra care " +"when returning Web Bean instances from producer methods!" +msgstr "" + +#. Tag: para +#: producermethods.xml:107 +#, no-c-format +msgid "" +"There's at least three ways we could go about fixing this bug. We could " +"change the scope of the <literal>CreditCardPaymentStrategy</literal> " +"implementation, but this would affect other clients of that Web Bean. A " +"better option would be to change the scope of the producer method to " +"<literal>@Dependent</literal> or <literal>@RequestScoped</literal>." +msgstr "" + +#. Tag: para +#: producermethods.xml:113 +#, no-c-format +msgid "" +"But a more common solution is to use the special <literal>@New</literal> " +"binding annotation." +msgstr "" + +#. Tag: title +#: producermethods.xml:119 +#, no-c-format +msgid "Use of <literal>@New</literal> with producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:121 +#, no-c-format +msgid "Consider the following producer method:" +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:123 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy(@New CreditCardPaymentStrategy " +"ccps,\n" +" @New ChequePaymentStrategy cps,\n" +" @New PayPalPaymentStrategy ppps) " +"{\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return ccps;\n" +" case CHEQUE: return cps;\n" +" case PAYPAL: return ppps;\n" +" default: return null;\n" +" } \n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:125 +#, no-c-format +msgid "" +"Then a new <emphasis>dependent</emphasis> instance of " +"<literal>CreditCardPaymentStrategy</literal> will be created, passed to the " +"producer method, returned by the producer method and finally bound to the " +"session context. The dependent object won't be destroyed until the " +"<literal>Preferences</literal> object is destroyed, at the end of the " +"session." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/ri.po =================================================================== --- doc/trunk/reference/fr-FR/modules/ri.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/ri.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,898 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: ri.xml:4 +#, no-c-format +msgid "Using the Web Beans Reference Implementation" +msgstr "" + +#. Tag: para +#: ri.xml:6 +#, no-c-format +msgid "" +"The Web Beans RI comes with a two examples, <literal>webbeans-numberguess</" +"literal> (a war example, containing only simple beans) and <literal>webbeans-" +"translator</literal> (an ear example, containing enterprise beans)." +msgstr "" + +#. Tag: para +#: ri.xml:13 +#, no-c-format +msgid "" +"Currently, the Web Beans RI only runs on JBoss Application Server 5. You'll " +"need to download JBoss AS 5.0.0.GA from <ulink url=\"http://www.jboss.org/" +"jbossas/downloads/\">jboss.org</ulink>, and unzip it. For example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:20 +#, no-c-format +msgid "" +"<![CDATA[$ cd /Applications\n" +"$ unzip ~/jboss-5.0.0.GA.zip]]>" +msgstr "" + +#. Tag: para +#: ri.xml:22 +#, no-c-format +msgid "" +"Next, download the Web Beans RI from <ulink url=\"http://seamframework.org/" +"WebBeans\">seamframework.org</ulink>, and unzip it. For example" +msgstr "" + +#. Tag: programlisting +#: ri.xml:28 +#, no-c-format +msgid "" +"<![CDATA[$ cd ~/\n" +"$ unzip ~/webbeans-1.0.0.ALPHA1.zip]]>" +msgstr "" + +#. Tag: para +#: ri.xml:30 +#, no-c-format +msgid "" +"As Web Beans is a new piece of software, you need to update JBoss AS to run " +"the Web Beans RI. Future versions of JBoss AS will include these updates, " +"and this step won't be necessary." +msgstr "" + +#. Tag: para +#: ri.xml:37 +#, no-c-format +msgid "" +"Currently, two updates are needed. Firstly, a new deployer, " +"<literal>webbeans.deployer</literal> is added. This adds supports for Web " +"Bean archives to JBoss AS, and allows the Web Beans RI to query the EJB3 " +"container and discover which EJBs are installed in your application. " +"Secondly, an update to JBoss EJB3 is needed." +msgstr "" + +#. Tag: para +#: ri.xml:46 +#, no-c-format +msgid "" +"To install the update, you'll need ant 1.7.0 installed, and the " +"<literal>ANT_HOME</literal> environment variable set. For example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:51 +#, no-c-format +msgid "" +"$ unzip apache-ant-1.7.0.zip\n" +"$ export ANT_HOME=~/apache-ant-1.7.0" +msgstr "" + +#. Tag: para +#: ri.xml:53 +#, no-c-format +msgid "" +"Then, you can install the update. The update script will use Maven to " +"download the Web Beans and EJB3 automatically." +msgstr "" + +#. Tag: programlisting +#: ri.xml:58 +#, no-c-format +msgid "" +"$ cd webbeans-1.0.0.ALPHA1/jboss-as\n" +"$ ant update" +msgstr "" + +#. Tag: para +#: ri.xml:60 +#, no-c-format +msgid "Now, you're ready to deploy your first example!" +msgstr "" + +#. Tag: para +#: ri.xml:65 +#, no-c-format +msgid "" +"The build scripts for the examples offer a number of targets, these are:" +msgstr "" + +#. Tag: para +#: ri.xml:71 +#, no-c-format +msgid "<literal>ant restart</literal> - deploy the example in exploded format" +msgstr "" + +#. Tag: para +#: ri.xml:77 +#, no-c-format +msgid "" +"<literal>ant explode</literal> - update an exploded example, without " +"restarting the deployment" +msgstr "" + +#. Tag: para +#: ri.xml:83 +#, no-c-format +msgid "" +"<literal>ant deploy</literal> - deploy the example in compressed jar format" +msgstr "" + +#. Tag: para +#: ri.xml:88 +#, no-c-format +msgid "<literal>ant undeploy</literal> - remove the example from the server" +msgstr "" + +#. Tag: para +#: ri.xml:93 +#, no-c-format +msgid "<literal>ant clean</literal> - clean the example" +msgstr "" + +#. Tag: para +#: ri.xml:100 +#, no-c-format +msgid "To deploy the numberguess example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:104 +#, no-c-format +msgid "" +"$ cd examples/numberguess\n" +"ant deploy" +msgstr "" + +#. Tag: para +#: ri.xml:106 +#, no-c-format +msgid "" +"Wait for the application to deploy, and enjoy hours of fun at <ulink url=" +"\"http://localhost:8080/webbeans-numberguess\"></ulink>!" +msgstr "" + +#. Tag: para +#: ri.xml:111 +#, no-c-format +msgid "" +"The Web Beans RI includes a second simple example that will translate your " +"text into Latin. The numberguess example is a war example, and uses only " +"simple beans; the translator example is an ear example, and includes " +"enterprise beans, packaged in an EJB module. To try it out:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:118 +#, no-c-format +msgid "" +"$ cd examples/traslator\n" +"ant deploy" +msgstr "" + +#. Tag: para +#: ri.xml:120 +#, no-c-format +msgid "" +"Wait for the application to deploy, and visit <ulink url=\"http://" +"localhost:8080/webbeans-translator\"></ulink>!" +msgstr "" + +#. Tag: title +#: ri.xml:126 +#, no-c-format +msgid "The numberguess example" +msgstr "" + +#. Tag: para +#: ri.xml:128 +#, no-c-format +msgid "" +"In the numberguess application you get given 10 attempts to guess a number " +"between 1 and 100. After each attempt, you will be told whether you are too " +"high, or too low." +msgstr "" + +#. Tag: para +#: ri.xml:134 +#, no-c-format +msgid "" +"The numberguess example is comprised of a number of Web Beans, configuration " +"files, and Facelet JSF pages, packaged as a war. Let's start with the " +"configuration files." +msgstr "" + +#. Tag: para +#: ri.xml:140 +#, no-c-format +msgid "" +"All the configuration files for this example are located in <literal>WEB-INF/" +"</literal>, which is stored in <literal>WebContent</literal> in the source " +"tree. First, we have <literal>faces-config.xml</literal>, in which we tell " +"JSF to use Facelets:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:148 +#, no-c-format +msgid "" +"<![CDATA[<?xml version='1.0' encoding='UTF-8'?>\n" +"<faces-config version=\"1.2\"\n" +" xmlns=\"http://java.sun.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://" +"java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd\">\n" +" \n" +" <application>\n" +" <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>\n" +" </application>\n" +"\n" +"</faces-config>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:150 +#, no-c-format +msgid "" +"There is an empty <literal>web-beans.xml</literal> file, which marks this " +"application as a Web Beans application." +msgstr "" + +#. Tag: para +#: ri.xml:155 +#, no-c-format +msgid "Finally there is <literal>web.xml</literal>:" +msgstr "" + +#. Tag: section +#: ri.xml:157 +#, no-c-format +msgid "" +"<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> " +"<area id=\"faces.servlet.mapping\" coords=\"18\"/> <area id=\"faces.default." +"suffix\" coords=\"23\"/> <area id=\"session.timeout\" coords=\"28\"/> <area " +"id=\"webbeans.listener\" coords=\"32\"/> </areaspec> <programlisting><![CDATA" +"[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"\n" +"<web-app version=\"2.5\"\n" +" xmlns=\"http://java.sun.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun." +"com/xml/ns/javaee/web-app_2_5.xsd\">\n" +" \n" +" <display-name>Web Beans Numbergues example</display-name>\n" +"\n" +" \n" +"\n" +" <servlet>\n" +" <servlet-name>Faces Servlet</servlet-name>\n" +" <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>\n" +" <load-on-startup>1</load-on-startup>\n" +" </servlet>\n" +"\n" +" <servlet-mapping>\n" +" <servlet-name>Faces Servlet</servlet-name>\n" +" <url-pattern>*.jsf</url-pattern>\n" +" </servlet-mapping>\n" +" \n" +" <context-param>\n" +" <param-name>javax.faces.DEFAULT_SUFFIX</param-name>\n" +" <param-value>.xhtml</param-value>\n" +" </context-param>\n" +"\n" +" <session-config>\n" +" <session-timeout>10</session-timeout>\n" +" </session-config>\n" +" \n" +" <listener>\n" +" <listener-class>org.jboss.webbeans.servlet.WebBeansListener</listener-" +"class>\n" +" </listener>\n" +"\n" +"</web-app>]]></programlisting> <calloutlist> <callout arearefs=\"faces." +"servlet\"> <para> Enable and load the JSF servlet </para> </callout> " +"<callout arearefs=\"faces.servlet.mapping\"> <para> Configure requests to " +"<literal>.jsf</literal> pages to be handled by JSF </para> </callout> " +"<callout arearefs=\"faces.default.suffix\"> <para> Tell JSF that we will be " +"giving our source files (facelets) an extension of <literal>.jsf</literal> </" +"para> </callout> <callout arearefs=\"session.timeout\"> <para> Configure a " +"session timeout of 10 minutes </para> </callout> <callout arearefs=" +"\"webbeans.listener\"> <para> Configure the Web Beans listener, so that Web " +"Beans services can be used in the servlet request </para> </callout> </" +"calloutlist> </programlistingco> <note> <para> The only configuration " +"required by the Web Beans RI in <literal>web.xml</literal> is to add the Web " +"Beans listener. </para> <para> Whilst this demo is a JSF demo, you can use " +"the Web Beans RI with any Servlet based web framework; just configure the " +"Web Beans listener. </para> </note> <para> Let's take a look at the Facelet " +"view: </para> <programlistingco> <areaspec> <area id=\"template\" coords=\"8" +"\"/> <area id=\"messages\" coords=\"12\"/> <area id=\"instructions\" coords=" +"\"19\"/> <area id=\"guess\" coords=\"25\"/> <area id=\"validator\" coords=" +"\"29\"/> <area id=\"submit\" coords=\"32\"/> </areaspec> <programlisting><!" +"[CDATA[<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" " +"\"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\n" +"<html xmlns=\"http://www.w3.org/1999/xhtml\"\n" +" xmlns:ui=\"http://java.sun.com/jsf/facelets\"\n" +" xmlns:h=\"http://java.sun.com/jsf/html\"\n" +" xmlns:f=\"http://java.sun.com/jsf/core\"\n" +" xmlns:s=\"http://jboss.com/products/seam/taglib\">\n" +"\n" +" <ui:composition template=\"template.xhtml\">\n" +" <ui:define name=\"content\">\n" +" <h1>Guess a number...</h1>\n" +" <h:form id=\"NumberGuessMain\">\n" +" <div style=\"color: red\">\n" +" <h:messages id=\"messages\" globalOnly=\"false\"/>\n" +" <h:outputText id=\"Higher\" value=\"Higher!\" rendered=\"#{game." +"number gt game.guess}\"/>\n" +" <h:outputText id=\"Lower\" value=\"Lower!\" rendered=\"#{game." +"number lt game.guess}\"/>\n" +" </div>\n" +" \n" +" <div>\n" +" I'm thinking of a number between #{game.smallest} and #{game." +"biggest}.\n" +" You have #{game.remainingGuesses} guesses.\n" +" </div>\n" +" \n" +" <div>\n" +" Your guess: \n" +" <h:inputText id=\"inputGuess\" \n" +" value=\"#{game.guess}\" \n" +" required=\"true\" \n" +" size=\"3\">\n" +" <f:validateLongRange maximum=\"#{game.biggest}\" \n" +" minimum=\"#{game.smallest}\"/>\n" +" </h:inputText>\n" +" <h:commandButton id=\"GuessButton\" \n" +" value=\"Guess\" \n" +" action=\"#{game.check}\"/>\n" +" </div>\n" +" \n" +" </h:form>\n" +" </ui:define>\n" +" </ui:composition>\n" +"</html>]]></programlisting> <calloutlist> <callout arearefs=\"template\"> " +"<para> Facelets is a templating language for JSF, here we are wrapping our " +"page in a template which defines the header. </para> </callout> <callout " +"arearefs=\"messages\"> <para> There are a number of messages which can be " +"sent to the user, \"Higher!\", \"Lower!\" and \"Correct!\" </para> </" +"callout> <callout arearefs=\"instructions\"> <para> As the user guesses, the " +"range of numbers they can guess gets smaller - this sentance changes to make " +"sure they know what range to guess in. </para> </callout> <callout arearefs=" +"\"guess\"> <para> This input field is bound to a Web Bean, using the value " +"expression. </para> </callout> <callout arearefs=\"validator\"> <para> A " +"range validator is used to make sure the user doesn't accidentally input a " +"number outside of the range in which they can guess - if the validator " +"wasn't here, the user might use up a guess on an out of range number. </" +"para> </callout> <callout arearefs=\"submit\"> <para> And, of course, there " +"must be a way for the user to send their guess to the server. Here we bind " +"to an action method on the Web Bean. </para> </callout> </calloutlist> </" +"programlistingco>" +msgstr "" + +#. Tag: para +#: ri.xml:270 +#, no-c-format +msgid "" +"The example exists of 4 classes, the first two of which are binding types. " +"First, there is the <literal>@Random</literal> binding type, used for " +"injecting a random number:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:276 +#, no-c-format +msgid "" +"<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" +"@Retention(RUNTIME)\n" +"@Documented\n" +"@BindingType\n" +"public @interface Random {}]]>" +msgstr "" + +#. Tag: para +#: ri.xml:278 +#, no-c-format +msgid "" +"There is also the <literal>@MaxNumber</literal> binding type, used for " +"injecting the maximum number that can be injected:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:283 +#, no-c-format +msgid "" +"<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" +"@Retention(RUNTIME)\n" +"@Documented\n" +"@BindingType\n" +"public @interface MaxNumber {}\n" +"]]>" +msgstr "" + +#. Tag: para +#: ri.xml:285 +#, no-c-format +msgid "" +"The <literal>Generator</literal> class is responsible for creating the " +"random number, via a producer method. It also exposes the maximum possible " +"number via a producer method:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:291 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped\n" +"public class Generator {\n" +" \n" +" private java.util.Random random = new java.util.Random( System." +"currentTimeMillis() );\n" +" \n" +" private int maxNumber = 100;\n" +" \n" +" java.util.Random getRandom()\n" +" {\n" +" return random;\n" +" }\n" +" \n" +" @Produces @Random int next() { \n" +" return getRandom().nextInt(maxNumber); \n" +" }\n" +" \n" +" @Produces @MaxNumber int getMaxNumber()\n" +" {\n" +" return maxNumber;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: ri.xml:293 +#, no-c-format +msgid "" +"You'll notice that the <literal>Generator</literal> is application scoped; " +"therefore we don't get a different random each time." +msgstr "" + +#. Tag: para +#: ri.xml:298 +#, no-c-format +msgid "" +"The final Web Bean in the application is the session scoped <literal>Game</" +"literal>. By making <literal>Game</literal> session scoped, you can only " +"play the game once per browser session. You could easily add a reset button " +"- a good exercise for the reader :-)" +msgstr "" + +#. Tag: para +#: ri.xml:305 +#, no-c-format +msgid "" +"You'll also note that we've used the <literal>@Named</literal> annotation, " +"so that we can use the bean through EL in the JSF page. Finally, we've used " +"constructor injection to initialize the game with a random number. And of " +"course, we need to tell the player when they've won, so we give feedback " +"with a <literal>FacesMessage</literal>." +msgstr "" + +#. Tag: programlisting +#: ri.xml:313 +#, no-c-format +msgid "" +"<![CDATA[@Named\n" +"@SessionScoped\n" +"public class Game {\n" +" private int number;\n" +" \n" +" private int guess;\n" +" private int smallest;\n" +" private int biggest;\n" +" private int remainingGuesses;\n" +" \n" +" public Game() {}\n" +" \n" +" @Initializer\n" +" Game(@Random int number, @MaxNumber int maxNumber) {\n" +" this.number = number;\n" +" this.smallest = 1;\n" +" this.biggest = maxNumber;\n" +" this.remainingGuesses = 10;\n" +" }\n" +"\n" +" // Getters and setters for fields\n" +" \n" +" public String check() {\n" +" if (guess>number) {\n" +" biggest = guess - 1;\n" +" }\n" +" if (guess<number) {\n" +" smallest = guess + 1;\n" +" }\n" +" if (guess == number) {\n" +" FacesContext.getCurrentInstance().addMessage(null, new FacesMessage" +"(\"Correct!\"));\n" +" }\n" +" remainingGuesses--;\n" +" return null;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: title +#: ri.xml:317 +#, no-c-format +msgid "The translator example" +msgstr "" + +#. Tag: para +#: ri.xml:319 +#, no-c-format +msgid "" +"The translator example will take any sentences you enter, and translate them " +"to Latin." +msgstr "" + +#. Tag: para +#: ri.xml:324 +#, no-c-format +msgid "" +"The translator example is built as an ear, and contains EJBs and enterprise " +"beans. As a result, it's structure is more complex than the numberguess " +"example." +msgstr "" + +#. Tag: para +#: ri.xml:331 +#, no-c-format +msgid "" +"EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will make " +"this structure much simpler!" +msgstr "" + +#. Tag: para +#: ri.xml:337 +#, no-c-format +msgid "" +"First, let's take a look at the ear aggregator, which is located in " +"<literal>webbeans-translator-ear</literal> module. Maven automatically " +"generates the <literal>application.xml</literal> and <literal>jboss-app.xml</" +"literal> for us:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:344 +#, no-c-format +msgid "" +"<![CDATA[<plugin>\n" +" <groupId>org.apache.maven.plugins</groupId>\n" +" <artifactId>maven-ear-plugin</artifactId>\n" +" <configuration>\n" +" <modules>\n" +" <webModule>\n" +" <groupId>org.jboss.webbeans.examples.translator</groupId>\n" +" <artifactId>webbeans-translator-war</artifactId>\n" +" <contextRoot>/webbeans-translator</contextRoot>\n" +" </webModule>\n" +" </modules>\n" +" <jboss>\n" +" <loader-repository>webbeans.jboss.org:loader=webbeans-translator</" +"loader-repository>\n" +" </jboss>\n" +" </configuration>\n" +"</plugin>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:346 +#, no-c-format +msgid "" +"We're doing a couple of things here - firstly we set the context path, which " +"gives us a nice url (<ulink url=\"http://localhost:8080/webbeans-translator" +"\">http://localhost:8080/webbeans-translator</ulink>) and we also enable " +"class loader isolation for JBoss AS." +msgstr "" + +#. Tag: para +#: ri.xml:354 +#, no-c-format +msgid "" +"If you aren't using Maven to generate these files, you would need " +"<literal>META-INF/jboss-app.xml</literal>:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:359 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<!DOCTYPE jboss-app\n" +" PUBLIC \"-//JBoss//DTD J2EE Application 4.2//EN\"\n" +" \"http://www.jboss.org/j2ee/dtd/jboss-app_4_2.dtd\">\n" +"<jboss-app>\n" +" <loader-repository>webbeans.jboss.org:loader=webbeans-translator</loader-" +"repository>\n" +"</jboss-app>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:361 +#, no-c-format +msgid "and <literal>META-INF/application.xml</literal>:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:365 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<application xmlns=\"http://java.sun.com/xml/ns/javaee\" \n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://" +"java.sun.com/xml/ns/javaee/application_5.xsd\"\n" +" version=\"5\">\n" +" <display-name>webbeans-translator-ear</display-name>\n" +" <description>Ear Example for the reference implementation of JSR 299: Web " +"Beans</description>\n" +" \n" +" <module>\n" +" <web>\n" +" <web-uri>webbeans-translator.war</web-uri>\n" +" <context-root>/webbeans-translator</context-root>\n" +" </web>\n" +" </module>\n" +" <module>\n" +" <ejb>webbeans-translator.jar</ejb>\n" +" </module>\n" +"</application>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:368 +#, no-c-format +msgid "" +"Next, lets look at the war. Just as in the numberguess example, we have a " +"<literal>faces-config.xml</literal> (to enabled Facelets) and a <literal>web." +"xml</literal> (to enable JSF and attach Web Beans services to the servlet " +"container) in <literal>WebContent/WEB-INF</literal>." +msgstr "" + +#. Tag: para +#: ri.xml:375 +#, no-c-format +msgid "" +"More intersting is the facelet used to translate text. Just as in the " +"numberguess example we have a template, which surrounds the form (ommitted " +"here for brevity):" +msgstr "" + +#. Tag: programlisting +#: ri.xml:381 +#, no-c-format +msgid "" +"<![CDATA[<h:form id=\"NumberGuessMain\">\n" +" \n" +" <table>\n" +" <tr align=\"center\" style=\"font-weight: bold\" >\n" +" <td>\n" +" Your text\n" +" </td>\n" +" <td>\n" +" Translation\n" +" </td>\n" +" </tr>\n" +" <tr>\n" +" <td>\n" +" <h:inputTextarea id=\"text\" value=\"#{translator.text}\" " +"required=\"true\" rows=\"5\" cols=\"80\" />\n" +" </td>\n" +" <td>\n" +" <h:outputText value=\"#{translator.translatedText}\" />\n" +" </td>\n" +" </tr>\n" +" </table>\n" +" <div>\n" +" <h:commandButton id=\"button\" value=\"Translate\" action=\"#" +"{translator.translate}\"/>\n" +" </div>\n" +" \n" +"</h:form>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:383 +#, no-c-format +msgid "" +"The user can enter some text in the lefthand textarea, and hit the translate " +"button to see the result to the right." +msgstr "" + +#. Tag: para +#: ri.xml:388 +#, no-c-format +msgid "" +"Finally, let's look at the ejb module, <literal>webbeans-translator-ejb</" +"literal>. There are two configuration files in <literal>src/main/resources/" +"META-INF</literal>, an empty <literal>web-beans.xml</literal>, used to mark " +"the archive as containing Web Beans, and <literal>ejb-jar.xml</literal>. Web " +"Beans provides injection and initializtion services for all EJBs, and uses " +"<literal>ejb-jar.xml</literal> to enable this, you'll need this in any EJB " +"project which uses Web Beans:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:400 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar xmlns=\"http://java.sun.com/xml/ns/javaee\" \n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" \n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java." +"sun.com/xml/ns/javaee/ejb-jar_3_0.xsd\"\n" +" version=\"3.0\">\n" +" \n" +" <interceptors>\n" +" <interceptor>\n" +" <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</" +"interceptor-class>\n" +" </interceptor>\n" +" </interceptors>\n" +" \n" +" <assembly-descriptor>\n" +" <interceptor-binding>\n" +" <ejb-name>*</ejb-name>\n" +" <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</" +"interceptor-class>\n" +" </interceptor-binding>\n" +" </assembly-descriptor>\n" +" \n" +"</ejb-jar>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:402 +#, no-c-format +msgid "" +"We've saved the most interesting bit to last, the code! The project has two " +"simple beans, <literal>SentanceParser</literal> and <literal>TextTranslator</" +"literal> and two enterprise beans, <literal>TanslatorControllerBean</" +"literal> and <literal>SentenceTranslator</literal>. You should be getting " +"quite familiar with what a Web Bean looks like by now, so we'll just " +"highlight the most interesting bits here." +msgstr "" + +#. Tag: para +#: ri.xml:412 +#, no-c-format +msgid "" +"Both <literal>SentanceParser</literal> and <literal>TextTranslator</literal> " +"are dependent beans, and <literal>TextTranslator</literal> uses constructor " +"initialization:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:418 +#, no-c-format +msgid "" +"<![CDATA[public class TextTranslator { \n" +" private SentenceParser sentenceParser; \n" +" private Translator sentenceTranslator; \n" +" \n" +" @Initializer\n" +" TextTranslator(SentenceParser sentenceParser, Translator " +"sentenceTranslator) \n" +" { \n" +" this.sentenceParser = sentenceParser; \n" +" this.sentenceTranslator = sentenceTranslator;]]>" +msgstr "" + +#. Tag: para +#: ri.xml:420 +#, no-c-format +msgid "" +"<literal>TextTranslator</literal> is a stateless bean (with a local business " +"interface), where the magic happens - of course, we couldn't develop a full " +"translator, but we gave it a good go!" +msgstr "" + +#. Tag: para +#: ri.xml:426 +#, no-c-format +msgid "" +"Finally, there is UI orientated controller, that collects the text from the " +"user, and dispatches it to the translator. This is a request scoped, named, " +"stateful session bean, which injects the translator." +msgstr "" + +#. Tag: programlisting +#: ri.xml:432 +#, no-c-format +msgid "" +"<![CDATA[@Stateful\n" +"@RequestScoped\n" +"@Named(\"translator\")\n" +"public class TranslatorControllerBean implements TranslatorController\n" +"{\n" +" \n" +" @Current TextTranslator translator;]]>" +msgstr "" + +#. Tag: para +#: ri.xml:434 +#, no-c-format +msgid "The bean also has getters and setters for all the fields on the page." +msgstr "" + +#. Tag: para +#: ri.xml:438 +#, no-c-format +msgid "As this is a stateful session bean, we have to have a remove method:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:442 +#, no-c-format +msgid "" +"<![CDATA[ @Remove\n" +" public void remove()\n" +" {\n" +" \n" +" }]]>" +msgstr "" + +#. Tag: para +#: ri.xml:444 +#, no-c-format +msgid "" +"The Web Beans manager will call the remove method for you when the bean is " +"destroyed; in this case at the end of the request." +msgstr "" + +#. Tag: para +#: ri.xml:450 +#, no-c-format +msgid "" +"That concludes our short tour of the Web Beans RI examples. For more on the " +"RI, or to help out, please visit <ulink url=\"http://www.seamframework.org/" +"WebBeans/Development\">http://www.seamframework.org/WebBeans/Development</" +"ulink>." +msgstr "" + +#. Tag: para +#: ri.xml:456 +#, no-c-format +msgid "" +"We need help in all areas - bug fixing, writing new features, writing " +"examples and translating this reference guide." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/scopescontexts.po =================================================================== --- doc/trunk/reference/fr-FR/modules/scopescontexts.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/scopescontexts.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,582 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: scopescontexts.xml:4 +#, no-c-format +msgid "Scopes and contexts" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:6 +#, no-c-format +msgid "" +"So far, we've seen a few examples of <emphasis>scope type annotations</" +"emphasis>. The scope of a Web Bean determines the lifecycle of instances of " +"the Web Bean. The scope also determines which clients refer to which " +"instances of the Web Bean. According to the Web Beans specification, a scope " +"determines:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:14 +#, no-c-format +msgid "When a new instance of any Web Bean with that scope is created" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:17 +#, no-c-format +msgid "When an existing instance of any Web Bean with that scope is destroyed" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:20 +#, no-c-format +msgid "" +"Which injected references refer to any instance of a Web Bean with that scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:25 +#, no-c-format +msgid "" +"For example, if we have a session scoped Web Bean, <literal>CurrentUser</" +"literal>, all Web Beans that are called in the context of the same " +"<literal>HttpSession</literal> will see the same instance of " +"<literal>CurrentUser</literal>. This instance will be automatically created " +"the first time a <literal>CurrentUser</literal> is needed in that session, " +"and automatically destroyed when the session ends." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:32 +#, no-c-format +msgid "Scope types" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:34 +#, no-c-format +msgid "" +"Web Beans features an <emphasis>extensible context model</emphasis>. It is " +"possible to define new scopes by creating a new scope type annotation:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:37 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD})\n" +"@ScopeType\n" +"public @interface ClusterScoped {}]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:39 +#, no-c-format +msgid "" +"Of course, that's the easy part of the job. For this scope type to be " +"useful, we will also need to define a <literal>Context</literal> object that " +"implements the scope! Implementing a <literal>Context</literal> is usually a " +"very technical task, intended for framework development only." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:44 +#, no-c-format +msgid "" +"We can apply a scope type annotation to a Web Bean implementation class to " +"specify the scope of the Web Bean:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:47 +#, no-c-format +msgid "" +"<![CDATA[@ClusterScoped\n" +"public class SecondLevelCache { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:58 +#, no-c-format +msgid "Usually, you'll use one of Web Beans' built-in scopes." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:63 +#, no-c-format +msgid "Built-in scopes" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:65 +#, no-c-format +msgid "Web Beans defines four built-in scopes:" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:69 +#, no-c-format +msgid "@RequestScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:72 +#, no-c-format +msgid "@SessionScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:75 +#, no-c-format +msgid "@ApplicationScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:78 +#, no-c-format +msgid "@ConversationScoped" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:82 +#, no-c-format +msgid "For a web application that uses Web Beans:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:86 +#, no-c-format +msgid "" +"any servlet request has access to active request, session and application " +"scopes, and, additionally" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:90 +#, no-c-format +msgid "any JSF request has access to an active conversation scope." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:94 +#, no-c-format +msgid "The request and application scopes are also active:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:98 +#, no-c-format +msgid "during invocations of EJB remote methods," +msgstr "" + +#. Tag: para +#: scopescontexts.xml:101 +#, no-c-format +msgid "during EJB timeouts," +msgstr "" + +#. Tag: para +#: scopescontexts.xml:104 +#, no-c-format +msgid "during message delivery to a message-driven bean, and" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:107 +#, no-c-format +msgid "during web service invocations." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:111 +#, no-c-format +msgid "" +"If the application tries to invoke a Web Bean with a scope that does not " +"have an active context, a <literal>ContextNotActiveException</literal> is " +"thrown by the Web Bean manager at runtime." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:115 +#, no-c-format +msgid "" +"Three of the four built-in scopes should be extremely familiar to every Java " +"EE developer, so let's not waste time discussing them here. One of the " +"scopes, however, is new." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:122 +#, no-c-format +msgid "The conversation scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:124 +#, no-c-format +msgid "" +"The Web Beans conversation scope is a bit like the traditional session scope " +"in that it holds state associated with a user of the system, and spans " +"multiple requests to the server. However, unlike the session scope, the " +"conversation scope:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:130 +#, no-c-format +msgid "is demarcated explicitly by the application, and" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:133 +#, no-c-format +msgid "" +"holds state associated with a particular web browser tab in a JSF " +"application." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:138 +#, no-c-format +msgid "" +"A conversation represents a task, a unit of work from the point of view of " +"the user. The conversation context holds state associated with what the user " +"is currently working on. If the user is doing multiple things at the same " +"time, there are multiple conversations." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:143 +#, no-c-format +msgid "" +"The conversation context is active during any JSF request. However, most " +"conversations are destroyed at the end of the request. If a conversation " +"should hold state across multiple requests, it must be explicitly promoted " +"to a <emphasis>long-running conversation</emphasis>." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:149 +#, no-c-format +msgid "Conversation demarcation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:151 +#, no-c-format +msgid "" +"Web Beans provides a built-in Web Bean for controlling the lifecyle of " +"conversations in a JSF application. This Web Bean may be obtained by " +"injection:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:154 +#, no-c-format +msgid "@Current Conversation conversation;" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:156 +#, no-c-format +msgid "" +"To promote the conversation associated with the current request to a long-" +"running conversation, call the <literal>begin()</literal> method from " +"application code. To schedule the current long-running conversation context " +"for destruction at the end of the current request, call <literal>end()</" +"literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:161 +#, no-c-format +msgid "" +"In the following example, a conversation-scoped Web Bean controls the " +"conversation with which it is associated:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:164 +#, no-c-format +msgid "" +"@ConversationScoped @Stateful\n" +"public class OrderBuilder {\n" +"\n" +" private Order order;\n" +" private @Current Conversation conversation;\n" +" private @PersistenceContext(type=EXTENDED) EntityManager em;\n" +" \n" +" @Produces public Order getOrder() {\n" +" return order;\n" +" }\n" +"\n" +" public Order createOrder() {\n" +" order = new Order();\n" +" conversation.begin();\n" +" return order;\n" +" }\n" +" \n" +" public void addLineItem(Product product, int quantity) {\n" +" order.add( new LineItem(product, quantity) );\n" +" }\n" +"\n" +" public void saveOrder(Order order) {\n" +" em.persist(order);\n" +" conversation.end();\n" +" }\n" +" \n" +" @Remove\n" +" public void destroy() {}\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:166 +#, no-c-format +msgid "" +"This Web Bean is able to control its own lifecycle through use of the " +"<literal>Conversation</literal> API. But some other Web Beans have a " +"lifecycle which depends completely upon another object." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:173 +#, no-c-format +msgid "Conversation propagation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:175 +#, no-c-format +msgid "" +"The conversation context automatically propagates with any JSF faces request " +"(JSF form submission). It does not automatically propagate with non-faces " +"requests, for example, navigation via a link." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:179 +#, no-c-format +msgid "" +"We can force the conversation to propagate with a non-faces request by " +"including the unique identifier of the conversation as a request parameter. " +"The Web Beans specification reserves the request parameter named " +"<literal>cid</literal> for this use. The unique identifier of the " +"conversation may be obtained from the <literal>Conversation</literal> " +"object, which has the Web Beans name <literal>conversation</literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:186 +#, no-c-format +msgid "Therefore, the following link propagates the conversation:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:188 +#, no-c-format +msgid "" +"<![CDATA[<a href=\"/addProduct.jsp?cid=#{conversation.id}\">Add Product</a>]]" +">" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:190 +#, no-c-format +msgid "" +"The Web Bean manager is also required to propagate conversations across any " +"redirect, even if the conversation is not marked long-running. This makes it " +"very easy to implement the common POST-then-redirect pattern, without resort " +"to fragile constructs such as a \"flash\" object. In this case, the Web Bean " +"manager automatically adds a request parameter to the redirect URL." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:200 +#, no-c-format +msgid "Conversation timeout" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:202 +#, no-c-format +msgid "" +"The Web Bean manager is permitted to destroy a conversation and all state " +"held in its context at any time in order to preserve resources. A Web Bean " +"manager implementation will normally do this on the basis of some kind of " +"timeoutthough this is not required by the Web Beans specification. The " +"timeout is the period of inactivity before the conversation is destroyed." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:208 +#, no-c-format +msgid "" +"The <literal>Conversation</literal> object provides a method to set the " +"timeout. This is a hint to the Web Bean manager, which is free to ignore the " +"setting." +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:212 +#, no-c-format +msgid "conversation.setTimeout(timeoutInMillis);" +msgstr "" + +#. Tag: title +#: scopescontexts.xml:219 +#, no-c-format +msgid "The dependent pseudo-scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:221 +#, no-c-format +msgid "" +"In addition to the four built-in scopes, Web Beans features the so-called " +"<emphasis>dependent pseudo-scope</emphasis>. This is the default scope for a " +"Web Bean which does not explicitly declare a scope type." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:225 +#, no-c-format +msgid "" +"For example, this Web Bean has the scope type <literal>@Dependent</literal>:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:227 +#, no-c-format +msgid "<![CDATA[public class Calculator { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:229 +#, no-c-format +msgid "" +"When an injection point of a Web Bean resolves to a dependent Web Bean, a " +"new instance of the dependent Web Bean is created every time the first Web " +"Bean is instantiated. Instances of dependent Web Beans are never shared " +"between different Web Beans or different injection points. They are " +"<emphasis>dependent objects</emphasis> of some other Web Bean instance." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:235 +#, no-c-format +msgid "" +"Dependent Web Bean instances are destroyed when the instance they depend " +"upon is destroyed." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:243 +#, no-c-format +msgid "" +"Web Beans makes it easy to obtain a dependent instance of a Java class or " +"EJB bean, even if the class or EJB bean is already declared as a Web Bean " +"with some other scope type." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:248 +#, no-c-format +msgid "The <literal>@New</literal> annotation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:250 +#, no-c-format +msgid "" +"The built-in <literal>@New</literal> binding annotation allows " +"<emphasis>implicit</emphasis> definition of a dependent Web Bean at an " +"injection point. Suppose we declare the following injected field:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:254 +#, no-c-format +msgid "<![CDATA[@New Calculator calculator;]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:256 +#, no-c-format +msgid "" +"Then a Web Bean with scope <literal>@Dependent</literal>, binding type " +"<literal>@New</literal>, API type <literal>Calculator</literal>, " +"implementation class <literal>Calculator</literal> and deployment type " +"<literal>@Standard</literal> is implicitly defined." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:261 +#, no-c-format +msgid "" +"This is true even if <literal>Calculator</literal> is <emphasis>already</" +"emphasis> declared with a different scope type, for example:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:264 +#, no-c-format +msgid "" +"<![CDATA[@ConversationScoped\n" +"public class Calculator { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:266 +#, no-c-format +msgid "" +"So the following injected attributes each get a different instance of " +"<literal>Calculator</literal>:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:269 +#, no-c-format +msgid "" +"<![CDATA[public class PaymentCalc {\n" +"\n" +" @Current Calculator calculator;\n" +" @New Calculator newCalculator;\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:271 +#, no-c-format +msgid "" +"The <literal>calculator</literal> field has a conversation-scoped instance " +"of <literal>Calculator</literal> injected. The <literal>newCalculator</" +"literal> field has a new instance of <literal>Calculator</literal> injected, " +"with a lifecycle that is bound to the owning <literal>PaymentCalc</literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:276 +#, no-c-format +msgid "" +"This feature is particularly useful with producer methods, as we'll see in " +"the next chapter." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/specialization.po =================================================================== --- doc/trunk/reference/fr-FR/modules/specialization.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/specialization.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,291 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: specialization.xml:4 +#, no-c-format +msgid "Specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:6 +#, no-c-format +msgid "" +"We've already seen how the Web Beans dependency injection model lets us " +"<emphasis>override</emphasis> the implementation of an API at deployment " +"time. For example, the following enterprise Web Bean provides an " +"implementation of the API <literal>PaymentProcessor</literal> in production:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:11 +#, no-c-format +msgid "" +"@CreditCard @Stateless\n" +"public class CreditCardPaymentProcessor \n" +" implements PaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:13 +#, no-c-format +msgid "" +"But in our staging environment, we override that implementation of " +"<literal>PaymentProcessor</literal> with a different Web Bean:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:16 +#, no-c-format +msgid "" +"@CreditCard @Stateless @Staging\n" +"public class StagingCreditCardPaymentProcessor \n" +" implements PaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:18 +#, no-c-format +msgid "" +"What we've tried to do with <literal>StagingCreditCardPaymentProcessor</" +"literal> is to completely replace <literal>AsyncPaymentProcessor</literal> " +"in a particular deployment of the system. In that deployment, the deployment " +"type <literal>@Staging</literal> would have a higher priority than the " +"default deployment type <literal>@Production</literal>, and therefore " +"clients with the following injection point:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:24 +#, no-c-format +msgid "@CreditCard PaymentProcessor ccpp" +msgstr "" + +#. Tag: para +#: specialization.xml:26 +#, no-c-format +msgid "" +"Would receive an instance of <literal>StagingCreditCardPaymentProcessor</" +"literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:28 +#, no-c-format +msgid "Unfortunately, there are several traps we can easily fall into:" +msgstr "" + +#. Tag: para +#: specialization.xml:32 +#, no-c-format +msgid "" +"the higher-priority Web Bean may not implement all the API types of the Web " +"Bean that it attempts to override," +msgstr "" + +#. Tag: para +#: specialization.xml:36 +#, no-c-format +msgid "" +"the higher-priority Web Bean may not declare all the binding types of the " +"Web Bean that it attempts to override," +msgstr "" + +#. Tag: para +#: specialization.xml:40 +#, no-c-format +msgid "" +"the higher-priority Web Bean might not have the same name as the Web Bean " +"that it attempts to override, or" +msgstr "" + +#. Tag: para +#: specialization.xml:44 +#, no-c-format +msgid "" +"the Web Bean that it attempts to override might declare a producer method, " +"disposal method or observer method." +msgstr "" + +#. Tag: para +#: specialization.xml:49 +#, no-c-format +msgid "" +"In each of these cases, the Web Bean that we tried to override could still " +"be called at runtime. Therefore, overriding is somewhat prone to developer " +"error." +msgstr "" + +#. Tag: para +#: specialization.xml:52 +#, no-c-format +msgid "" +"Web Beans provides a special feature, called <emphasis>specialization</" +"emphasis>, that helps the developer avoid these traps. Specialization looks " +"a little esoteric at first, but it's easy to use in practice, and you'll " +"really appreciate the extra security it provides." +msgstr "" + +#. Tag: title +#: specialization.xml:58 +#, no-c-format +msgid "Using specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:60 +#, no-c-format +msgid "" +"Specialization is a feature that is specific to simple and enterprise Web " +"Beans. To make use of specialization, the higher-priority Web Bean must:" +msgstr "" + +#. Tag: para +#: specialization.xml:65 +#, no-c-format +msgid "be a direct subclass of the Web Bean it overrides, and" +msgstr "" + +#. Tag: para +#: specialization.xml:68 +#, no-c-format +msgid "" +"be a simple Web Bean if the Web Bean it overrides is a simple Web Bean or an " +"enterprise Web Bean if the Web Bean it overrides is an enterprise Web Bean, " +"and" +msgstr "" + +#. Tag: para +#: specialization.xml:73 +#, no-c-format +msgid "be annotated <literal>@Specializes</literal>." +msgstr "" + +#. Tag: programlisting +#: specialization.xml:77 +#, no-c-format +msgid "" +"@Stateless @Staging @Specializes\n" +"public class StagingCreditCardPaymentProcessor \n" +" extends CreditCardPaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:79 +#, no-c-format +msgid "" +"We say that the higher-priority Web Bean <emphasis>specializes</emphasis> " +"its superclass." +msgstr "" + +#. Tag: title +#: specialization.xml:85 +#, no-c-format +msgid "Advantages of specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:87 +#, no-c-format +msgid "When specialization is used:" +msgstr "" + +#. Tag: para +#: specialization.xml:91 +#, no-c-format +msgid "" +"the binding types of the superclass are automatically inherited by the Web " +"Bean annotated <literal>@Specializes</literal>, and" +msgstr "" + +#. Tag: para +#: specialization.xml:95 +#, no-c-format +msgid "" +"the Web Bean name of the superclass is automatically inherited by the Web " +"Bean annotated <literal>@Specializes</literal>, and" +msgstr "" + +#. Tag: para +#: specialization.xml:99 +#, no-c-format +msgid "" +"producer methods, disposal methods and observer methods declared by the " +"superclass are called upon an instance of the Web Bean annotated " +"<literal>@Specializes</literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:105 +#, no-c-format +msgid "" +"In our example, the binding type <literal>@CreditCard</literal> of " +"<literal>CreditCardPaymentProcessor</literal> is inherited by " +"<literal>StagingCreditCardPaymentProcessor</literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:109 +#, no-c-format +msgid "Furthermore, the Web Bean manager will validate that:" +msgstr "" + +#. Tag: para +#: specialization.xml:113 +#, no-c-format +msgid "" +"all API types of the superclass are API types of the Web Bean annotated " +"<literal>@Specializes</literal> (all local interfaces of the superclass " +"enterprise bean are also local interfaces of the subclass)," +msgstr "" + +#. Tag: para +#: specialization.xml:119 +#, no-c-format +msgid "" +"the deployment type of the Web Bean annotated <literal>@Specializes</" +"literal> has a higher precedence than the deployment type of the superclass, " +"and" +msgstr "" + +#. Tag: para +#: specialization.xml:124 +#, no-c-format +msgid "" +"there is no other enabled Web Bean that also specializes the superclass." +msgstr "" + +#. Tag: para +#: specialization.xml:129 +#, no-c-format +msgid "" +"If any of these conditions are violated, the Web Bean manager throws an " +"exception at initialization time." +msgstr "" + +#. Tag: para +#: specialization.xml:132 +#, no-c-format +msgid "" +"Therefore, we can be certain that the superclass with <emphasis>never</" +"emphasis> be called in any deployment of the system where the Web Bean " +"annotated <literal>@Specializes</literal> is deployed and enabled." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/stereotypes.po =================================================================== --- doc/trunk/reference/fr-FR/modules/stereotypes.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/stereotypes.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,352 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: stereotypes.xml:4 +#, no-c-format +msgid "Stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:6 +#, no-c-format +msgid "According to the Web Beans specification:" +msgstr "" + +#. Tag: para +#: stereotypes.xml:10 +#, no-c-format +msgid "" +"In many systems, use of architectural patterns produces a set of recurring " +"Web Bean roles. A stereotype allows a framework developer to identify such a " +"role and declare some common metadata for Web Beans with that role in a " +"central place." +msgstr "" + +#. Tag: para +#: stereotypes.xml:14 +#, no-c-format +msgid "A stereotype encapsulates any combination of:" +msgstr "" + +#. Tag: para +#: stereotypes.xml:18 +#, no-c-format +msgid "a default deployment type," +msgstr "" + +#. Tag: para +#: stereotypes.xml:21 +#, no-c-format +msgid "a default scope type," +msgstr "" + +#. Tag: para +#: stereotypes.xml:24 +#, no-c-format +msgid "a restriction upon the Web Bean scope," +msgstr "" + +#. Tag: para +#: stereotypes.xml:27 +#, no-c-format +msgid "a requirement that the Web Bean implement or extend a certain type, and" +msgstr "" + +#. Tag: para +#: stereotypes.xml:30 +#, no-c-format +msgid "a set of interceptor binding annotations." +msgstr "" + +#. Tag: para +#: stereotypes.xml:34 +#, no-c-format +msgid "" +"A stereotype may also specify that all Web Beans with the stereotype have " +"defaulted Web Bean names." +msgstr "" + +#. Tag: para +#: stereotypes.xml:37 +#, no-c-format +msgid "A Web Bean may declare zero, one or multiple stereotypes." +msgstr "" + +#. Tag: para +#: stereotypes.xml:41 +#, no-c-format +msgid "" +"A stereotype is a Java annotation type. This stereotype identifies action " +"classes in some MVC framework:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:44 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:46 +#, no-c-format +msgid "We use the stereotype by applying the annotation to a Web Bean." +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:48 +#, no-c-format +msgid "" +"<![CDATA[@Action \n" +"public class LoginAction { ... }]]>" +msgstr "" + +#. Tag: title +#: stereotypes.xml:51 +#, no-c-format +msgid "Default scope and deployment type for a stereotype" +msgstr "" + +#. Tag: para +#: stereotypes.xml:53 +#, no-c-format +msgid "" +"A stereotype may specify a default scope and/or default deployment type for " +"Web Beans with that stereotype. For example, if the deployment type " +"<literal>@WebTier</literal> identifies Web Beans that should only be " +"deployed when the system executes as a web application, we might specify the " +"following defaults for action classes:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:59 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:61 +#, no-c-format +msgid "" +"Of course, a particular action may still override these defaults if " +"necessary:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:64 +#, no-c-format +msgid "" +"<![CDATA[@Dependent @Mock @Action \n" +"public class MockLoginAction { ... }]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:66 +#, no-c-format +msgid "" +"If we want to force all actions to a particular scope, we can do that too." +msgstr "" + +#. Tag: title +#: stereotypes.xml:72 +#, no-c-format +msgid "Restricting scope and type with a stereotype" +msgstr "" + +#. Tag: para +#: stereotypes.xml:74 +#, no-c-format +msgid "" +"Suppose that we wish to prevent actions from declaring certain scopes. Web " +"Beans lets us explicitly specify the set of allowed scopes for Web Beans " +"with a certain stereotype. For example:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:78 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype(supportedScopes=RequestScoped.class)\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:80 +#, no-c-format +msgid "" +"If a particular action class attempts to specify a scope other than the Web " +"Beans request scope, an exception will be thrown by the Web Bean manager at " +"initialization time." +msgstr "" + +#. Tag: para +#: stereotypes.xml:84 +#, no-c-format +msgid "" +"We can also force all Web Bean with a certain stereotype to implement an " +"interface or extend a class:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:87 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype(requiredTypes=AbstractAction.class)\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:89 +#, no-c-format +msgid "" +"If a particular action class does not extend the class " +"<literal>AbstractAction</literal>, an exception will be thrown by the Web " +"Bean manager at initialization time." +msgstr "" + +#. Tag: title +#: stereotypes.xml:96 +#, no-c-format +msgid "Interceptor bindings for stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:98 +#, no-c-format +msgid "" +"A stereotype may specify a set of interceptor bindings to be inherited by " +"all Web Beans with that stereotype." +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:101 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@Transactional(requiresNew=true)\n" +"@Secure\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:103 +#, no-c-format +msgid "" +"This helps us get technical concerns even further away from the business " +"code!" +msgstr "" + +#. Tag: title +#: stereotypes.xml:109 +#, no-c-format +msgid "Name defaulting with stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:111 +#, no-c-format +msgid "" +"Finally, we can specify that all Web Beans with a certain stereotype have a " +"Web Bean name, defaulted by the Web Bean manager. Actions are often " +"referenced in JSP pages, so they're a perfect use case for this feature. All " +"we need to do is add an empty <literal>@Named</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:116 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@Transactional(requiresNew=true)\n" +"@Secure\n" +"@Named\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:118 +#, no-c-format +msgid "" +"Now, <literal>LoginAction</literal> will have the name <literal>loginAction</" +"literal>." +msgstr "" + +#. Tag: title +#: stereotypes.xml:124 +#, no-c-format +msgid "Standard stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:126 +#, no-c-format +msgid "" +"We've already met two standard stereotypes defined by the Web Beans " +"specification: <literal>@Interceptor</literal> and <literal>@Decorator</" +"literal>." +msgstr "" + +#. Tag: para +#: stereotypes.xml:129 +#, no-c-format +msgid "Web Beans defines one further standard stereotype:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:131 +#, no-c-format +msgid "" +"<![CDATA[@Named \n" +"@RequestScoped \n" +"@Stereotype \n" +"@Target({TYPE, METHOD}) \n" +"@Retention(RUNTIME) \n" +"public @interface Model {} ]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:133 +#, no-c-format +msgid "" +"This stereotype is intended for use with JSF. Instead of using JSF managed " +"beans, just annotate a Web Bean <literal>@Model</literal>, and use it " +"directly in your JSF page." +msgstr "" Added: doc/trunk/reference/fr-FR/modules/xml.po =================================================================== --- doc/trunk/reference/fr-FR/modules/xml.po (rev 0) +++ doc/trunk/reference/fr-FR/modules/xml.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,352 @@ +# Language fr-FR translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: xml.xml:4 +#, no-c-format +msgid "Defining Web Beans using XML" +msgstr "" + +#. Tag: para +#: xml.xml:6 +#, no-c-format +msgid "" +"So far, we've seen plenty of examples of Web Beans declared using " +"annotations. However, there are a couple of occasions when we can't use " +"annotations to define the Web Bean:" +msgstr "" + +#. Tag: para +#: xml.xml:12 +#, no-c-format +msgid "when the implementation class comes from some preexisting library, or" +msgstr "" + +#. Tag: para +#: xml.xml:15 +#, no-c-format +msgid "" +"when there should be multiple Web Beans with the same implementation class." +msgstr "" + +#. Tag: para +#: xml.xml:20 +#, no-c-format +msgid "In either of these cases, Web Beans gives us two options:" +msgstr "" + +#. Tag: para +#: xml.xml:23 +#, no-c-format +msgid "write a producer method, or" +msgstr "" + +#. Tag: para +#: xml.xml:24 +#, no-c-format +msgid "declare the Web Bean using XML." +msgstr "" + +#. Tag: para +#: xml.xml:27 +#, no-c-format +msgid "" +"Many frameworks use XML to provide metadata relating to Java classes. " +"However, Web Beans uses a very different approach to specifying the names of " +"Java classes, fields or methods to most other frameworks. Instead of writing " +"class and member names as the string values of XML elements and attributes, " +"Web Beans lets you use the class or member name as the name of the XML " +"element." +msgstr "" + +#. Tag: para +#: xml.xml:33 +#, no-c-format +msgid "" +"The advantage of this approach is that you can write an XML schema that " +"prevents spelling errors in your XML document. It's even possible for a tool " +"to generate the XML schema automatically from the compiled Java code. Or, an " +"integrated development environment could perform the same validation without " +"the need for the explicit intermediate generation step." +msgstr "" + +#. Tag: title +#: xml.xml:40 +#, no-c-format +msgid "Declaring Web Bean classes" +msgstr "" + +#. Tag: para +#: xml.xml:42 +#, no-c-format +msgid "" +"For each Java package, Web Beans defines a corresponding XML namespace. The " +"namespace is formed by prepending <literal>urn:java:</literal> to the Java " +"package name. For the package <literal>com.mydomain.myapp</literal>, the XML " +"namespace is <literal>urn:java:com.mydomain.myapp</literal>." +msgstr "" + +#. Tag: para +#: xml.xml:47 +#, no-c-format +msgid "" +"Java types belonging to a package are referred to using an XML element in " +"the namespace corresponding to the package. The name of the element is the " +"name of the Java type. Fields and methods of the type are specified by child " +"elements in the same namespace. If the type is an annotation, members are " +"specified by attributes of the element." +msgstr "" + +#. Tag: para +#: xml.xml:53 +#, no-c-format +msgid "" +"For example, the element <literal><util:Date/></literal> in the " +"following XML fragment refers to the class <literal>java.util.Date</literal>:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:56 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans xmlns=\"urn:java:javax.webbeans\"\n" +" xmlns:util=\"urn:java:java.util\">\n" +"\n" +" <util:Date/>\n" +"\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:58 +#, no-c-format +msgid "" +"And this is all the code we need to declare that <literal>Date</literal> is " +"a simple Web Bean! An instance of <literal>Date</literal> may now be " +"injected by any other Web Bean:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:62 +#, no-c-format +msgid "<![CDATA[@Current Date date]]>" +msgstr "" + +#. Tag: title +#: xml.xml:67 +#, no-c-format +msgid "Declaring Web Bean metadata" +msgstr "" + +#. Tag: para +#: xml.xml:69 +#, no-c-format +msgid "" +"We can declare the scope, deployment type and interceptor binding types " +"using direct child elements of the Web Bean declaration:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:72 +#, no-c-format +msgid "" +"<![CDATA[<myapp:ShoppingCart>\n" +" <SessionScoped/>\n" +" <myfwk:Transactional requiresNew=\"true\"/>\n" +" <myfwk:Secure/>\n" +"</myapp:ShoppingCart>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:74 +#, no-c-format +msgid "We use exactly the same approach to specify names and binding type:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:76 +#, no-c-format +msgid "" +"<![CDATA[<util:Date>\n" +" <Named>currentTime</Named>\n" +"</util:Date>\n" +"\n" +"<util:Date>\n" +" <SessionScoped/>\n" +" <myapp:Login/>\n" +" <Named>loginTime</Named>\n" +"</util:Date>\n" +"\n" +"<util:Date>\n" +" <ApplicationScoped/>\n" +" <myapp:SystemStart/>\n" +" <Named>systemStartTime</Named>\n" +"</util:Date>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:78 +#, no-c-format +msgid "" +"Where <literal>@Login</literal> and <literal>@SystemStart</literal> are " +"binding annotations types." +msgstr "" + +#. Tag: programlisting +#: xml.xml:81 +#, no-c-format +msgid "" +"<![CDATA[@Current Date currentTime;\n" +"@Login Date loginTime;\n" +"@SystemStart Date systemStartTime;]]>" +msgstr "" + +#. Tag: para +#: xml.xml:83 +#, no-c-format +msgid "As usual, a Web Bean may support multiple binding types:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:85 +#, no-c-format +msgid "" +"<![CDATA[<myapp:AsynchronousChequePaymentProcessor>\n" +" <myapp:PayByCheque/>\n" +" <myapp:Asynchronous/>\n" +"</myapp:AsynchronousChequePaymentProcessor>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:87 +#, no-c-format +msgid "" +"Interceptors and decorators are just simple Web Beans, so they may be " +"declared just like any other simple Web Bean:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:90 +#, no-c-format +msgid "" +"<![CDATA[<myfwk:TransactionInterceptor>\n" +" <Interceptor/>\n" +" <myfwk:Transactional/>\n" +"</myfwk:TransactionInterceptor>]]>" +msgstr "" + +#. Tag: title +#: xml.xml:95 +#, no-c-format +msgid "Declaring Web Bean members" +msgstr "" + +#. Tag: para +#: xml.xml:97 +#, no-c-format +msgid "TODO!" +msgstr "" + +#. Tag: title +#: xml.xml:104 +#, no-c-format +msgid "Declaring inline Web Beans" +msgstr "" + +#. Tag: para +#: xml.xml:106 +#, no-c-format +msgid "Web Beans lets us define a Web Bean at an injection point. For example:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:108 +#, no-c-format +msgid "" +"<![CDATA[<myapp:System>\n" +" <ApplicationScoped/>\n" +" <myapp:admin>\n" +" <myapp:Name>\n" +" <myapp:firstname>Gavin</myapp:firstname>\n" +" <myapp:lastname>King</myapp:lastname>\n" +" <myapp:email>gavin(a)hibernate.org</myapp:email>\n" +" </myapp:Name>\n" +" </myapp:admin>\n" +"</myapp:System>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:110 +#, no-c-format +msgid "" +"The <literal><Name></literal> element declares a simple Web Bean of " +"scope <literal>@Dependent</literal> and class <literal>Name</literal>, with " +"a set of initial field values. This Web Bean has a special, container-" +"generated binding and is therefore injectable only to the specific injection " +"point at which it is declared." +msgstr "" + +#. Tag: para +#: xml.xml:116 +#, no-c-format +msgid "" +"This simple but powerful feature allows the Web Beans XML format to be used " +"to specify whole graphs of Java objects. It's not quite a full databinding " +"solution, but it's close!" +msgstr "" + +#. Tag: title +#: xml.xml:123 +#, no-c-format +msgid "Using a schema" +msgstr "" + +#. Tag: para +#: xml.xml:125 +#, no-c-format +msgid "" +"If we want our XML document format to be authored by people who aren't Java " +"developers, or who don't have access to our code, we need to provide a " +"schema. There's nothing specific to Web Beans about writing or using the " +"schema." +msgstr "" + +#. Tag: programlisting +#: xml.xml:130 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans xmlns=\"urn:java:javax.webbeans\"\n" +" xmlns:myapp=\"urn:java:com.mydomain.myapp\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"urn:java:javax.webbeans http://java.sun.com/" +"jee/web-beans-1.0.xsd\n" +" urn:java:com.mydomain.myapp http://mydomain." +"com/xsd/myapp-1.2.xsd\">\n" +"\n" +" <myapp:System>\n" +" ...\n" +" </myapp:System>\n" +"\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:132 +#, no-c-format +msgid "" +"Writing an XML schema is quite tedious. Therefore, the Web Beans RI project " +"will provide a tool which automatically generates the XML schema from " +"compiled Java code." +msgstr "" Added: doc/trunk/reference/it-IT/Book_Info.po =================================================================== --- doc/trunk/reference/it-IT/Book_Info.po (rev 0) +++ doc/trunk/reference/it-IT/Book_Info.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,56 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: 2008-12-19 20:29+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: Book_Info.xml:6 +#, no-c-format +msgid "Introduction to Web Beans" +msgstr "" + +#. Tag: subtitle +#: Book_Info.xml:7 +#, no-c-format +msgid "" +"The new Java standard for dependency injection and contextual state " +"management" +msgstr "" + +#. Tag: author +#: Book_Info.xml:10 +#, no-c-format +msgid "<firstname>Gavin</firstname> <surname>King</surname>" +msgstr "" + +#. Tag: affiliation +#: Book_Info.xml:13 +#, no-c-format +msgid "" +"<jobtitle>Web Beans (JSR-299) specification lead</jobtitle> <orgname>Red Hat " +"Middleware LLC</orgname>" +msgstr "" + +#. Tag: author +#: Book_Info.xml:19 +#, no-c-format +msgid "<firstname>Pete</firstname> <surname>Muir</surname>" +msgstr "" + +#. Tag: affiliation +#: Book_Info.xml:22 +#, no-c-format +msgid "" +"<jobtitle>Web Beans (JSR-299) Reference Implementation lead</jobtitle> " +"<orgname>Red Hat Middleware LLC</orgname>" +msgstr "" Added: doc/trunk/reference/it-IT/master.po =================================================================== --- doc/trunk/reference/it-IT/master.po (rev 0) +++ doc/trunk/reference/it-IT/master.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,38 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: master.xml:12 +#, no-c-format +msgid "Using contextual objects" +msgstr "" + +#. Tag: title +#: master.xml:25 +#, no-c-format +msgid "Developing loosely-coupled code" +msgstr "" + +#. Tag: title +#: master.xml:35 +#, no-c-format +msgid "Making the most of strong typing" +msgstr "" + +#. Tag: title +#: master.xml:46 +#, no-c-format +msgid "Web Beans and the Java EE ecosystem" +msgstr "" Added: doc/trunk/reference/it-IT/modules/decorators.po =================================================================== --- doc/trunk/reference/it-IT/modules/decorators.po (rev 0) +++ doc/trunk/reference/it-IT/modules/decorators.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,243 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: decorators.xml:4 +#, no-c-format +msgid "Decorators" +msgstr "" + +#. Tag: para +#: decorators.xml:6 +#, no-c-format +msgid "" +"Interceptors are a powerful way to capture and separate concerns which are " +"<emphasis>orthogonal</emphasis> to the type system. Any interceptor is able " +"to intercept invocations of any Java type. This makes them perfect for " +"solving technical concerns such as transaction management and security. " +"However, by nature, interceptors are unaware of the actual semantics of the " +"events they intercept. Thus, interceptors aren't an appropriate tool for " +"separating business-related concerns." +msgstr "" + +#. Tag: para +#: decorators.xml:14 +#, no-c-format +msgid "" +"The reverse is true of <emphasis>decorators</emphasis>. A decorator " +"intercepts invocations only for a certain Java interface, and is therefore " +"aware of all the semantics attached to that interface. This makes decorators " +"a perfect tool for modeling some kinds of business concerns. It also means " +"that a decorator doesn't have the generality of an interceptor. Decorators " +"aren't able to solve technical concerns that cut across many disparate types." +msgstr "" + +#. Tag: para +#: decorators.xml:22 +#, no-c-format +msgid "Suppose we have an interface that represents accounts:" +msgstr "" + +#. Tag: programlisting +#: decorators.xml:24 +#, no-c-format +msgid "" +"<![CDATA[public interface Account {\n" +" public BigDecimal getBalance();\n" +" public User getOwner();\n" +" public void withdraw(BigDecimal amount);\n" +" public void deposit(BigDecimal amount);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:26 +#, no-c-format +msgid "" +"Several different Web Beans in our system implement the <literal>Account</" +"literal> interface. However, we have a common legal requirement that, for " +"any kind of account, large transactions must be recorded by the system in a " +"special log. This is a perfect job for a decorator." +msgstr "" + +#. Tag: para +#: decorators.xml:32 +#, no-c-format +msgid "" +"A decorator is a simple Web Bean that implements the type it decorates and " +"is annotated <literal>@Decorator</literal>." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:35 +#, no-c-format +msgid "" +"<![CDATA[@Decorator\n" +"public abstract class LargeTransactionDecorator \n" +" implements Account {\n" +" \n" +" @Decorates Account account;\n" +" \n" +" @PersistenceContext EntityManager em;\n" +" \n" +" public void withdraw(BigDecimal amount) {\n" +" account.withdraw(amount);\n" +" if ( amount.compareTo(LARGE_AMOUNT)>0 ) {\n" +" em.persist( new LoggedWithdrawl(amount) );\n" +" }\n" +" }\n" +" \n" +" public void deposit(BigDecimal amount);\n" +" account.deposit(amount);\n" +" if ( amount.compareTo(LARGE_AMOUNT)>0 ) {\n" +" em.persist( new LoggedDeposit(amount) );\n" +" }\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:37 +#, no-c-format +msgid "" +"Unlike other simple Web Beans, a decorator may be an abstract class. If " +"there's nothing special the decorator needs to do for a particular method of " +"the decorated interface, you don't need to implement that method." +msgstr "" + +#. Tag: title +#: decorators.xml:43 +#, no-c-format +msgid "Delegate attributes" +msgstr "" + +#. Tag: para +#: decorators.xml:45 +#, no-c-format +msgid "" +"All decorators have a <emphasis>delegate attribute</emphasis>. The type and " +"binding types of the delegate attribute determine which Web Beans the " +"decorator is bound to. The delegate attribute type must implement or extend " +"all interfaces implemented by the decorator." +msgstr "" + +#. Tag: para +#: decorators.xml:50 +#, no-c-format +msgid "" +"This delegate attribute specifies that the decorator is bound to all Web " +"Beans that implement <literal>Account</literal>:" +msgstr "" + +#. Tag: programlisting +#: decorators.xml:53 +#, no-c-format +msgid "<![CDATA[@Decorates Account account;]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:55 +#, no-c-format +msgid "" +"A delegate attribute may specify a binding annotation. Then the decorator " +"will only be bound to Web Beans with the same binding." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:58 +#, no-c-format +msgid "<![CDATA[@Decorates @Foreign Account account;]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:60 +#, no-c-format +msgid "A decorator is bound to any Web Bean which:" +msgstr "" + +#. Tag: para +#: decorators.xml:64 +#, no-c-format +msgid "has the type of the delegate attribute as an API type, and" +msgstr "" + +#. Tag: para +#: decorators.xml:67 +#, no-c-format +msgid "has all binding types that are declared by the delegate attribute." +msgstr "" + +#. Tag: para +#: decorators.xml:71 +#, no-c-format +msgid "" +"The decorator may invoke the delegate attribute, which has much the same " +"effect as calling <literal>InvocationContext.proceed()</literal> from an " +"interceptor." +msgstr "" + +#. Tag: title +#: decorators.xml:78 +#, no-c-format +msgid "Enabling decorators" +msgstr "" + +#. Tag: para +#: decorators.xml:80 +#, no-c-format +msgid "" +"We need to <emphasis>enable</emphasis> our decorator in <literal>web-beans." +"xml</literal>." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:83 +#, no-c-format +msgid "" +"<![CDATA[<Decorators>\n" +" <myapp:LargeTransactionDecorator/>\n" +"</Decorators>]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:85 +#, no-c-format +msgid "" +"This declaration serves the same purpose for decorators that the " +"<literal><Interceptors></literal> declaration serves for interceptors:" +msgstr "" + +#. Tag: para +#: decorators.xml:90 +#, no-c-format +msgid "" +"it enables us to specify a total ordering for all decorators in our system, " +"ensuring deterministic behavior, and" +msgstr "" + +#. Tag: para +#: decorators.xml:94 +#, no-c-format +msgid "it lets us enable or disable decorator classes at deployment time." +msgstr "" + +#. Tag: para +#: decorators.xml:98 +#, no-c-format +msgid "" +"Interceptors for a method are called before decorators that apply to that " +"method." +msgstr "" Added: doc/trunk/reference/it-IT/modules/ee.po =================================================================== --- doc/trunk/reference/it-IT/modules/ee.po (rev 0) +++ doc/trunk/reference/it-IT/modules/ee.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,329 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: ee.xml:4 +#, no-c-format +msgid "Java EE integration" +msgstr "" + +#. Tag: para +#: ee.xml:6 +#, no-c-format +msgid "" +"Web Beans is fully integrated into the Java EE environment. Web Beans have " +"access to Java EE resources and JPA persistence contexts. They may be used " +"in Unified EL expressions in JSF and JSP pages. They may even be injected " +"into some objects, such as Servlets and Message-Driven Beans, which are not " +"Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:12 +#, no-c-format +msgid "Injecting Java EE resources into a Web Bean" +msgstr "" + +#. Tag: para +#: ee.xml:14 +#, no-c-format +msgid "" +"All simple and enterprise Web Beans may take advantage of Java EE dependency " +"injection using <literal>@Resource</literal>, <literal>@EJB</literal> and " +"<literal>@PersistenceContext</literal>. We've already seen a couple of " +"examples of this, though we didn't pay much attention at the time:" +msgstr "" + +#. Tag: programlisting +#: ee.xml:19 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +"\n" +" @Resource Transaction transaction;\n" +"\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: ee.xml:21 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped\n" +"public class Login {\n" +"\n" +" @Current Credentials credentials;\n" +" @PersistenceContext EntityManager userDatabase;\n" +" \n" +" ...\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: ee.xml:23 +#, no-c-format +msgid "" +"The Java EE <literal>@PostConstruct</literal> and <literal>@PreDestroy</" +"literal> callbacks are also supported for all simple and enterprise Web " +"Beans. The <literal>@PostConstruct</literal> method is called after " +"<emphasis>all</emphasis> injection has been performed." +msgstr "" + +#. Tag: para +#: ee.xml:28 +#, no-c-format +msgid "" +"There is one restriction to be aware of here: <literal>@PersistenceContext" +"(type=EXTENDED)</literal> is not supported for simple Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:35 +#, no-c-format +msgid "Calling a Web Bean from a Servlet" +msgstr "" + +#. Tag: para +#: ee.xml:37 +#, no-c-format +msgid "" +"It's easy to use a Web Bean from a Servlet in Java EE 6. Simply inject the " +"Web Bean using Web Beans field or initializer method injection." +msgstr "" + +#. Tag: programlisting +#: ee.xml:40 +#, no-c-format +msgid "" +"public class Login extends HttpServlet {\n" +"\n" +" @Current Credentials credentials;\n" +" @Current Login login;\n" +"\n" +" @Override\n" +" public void service(HttpServletRequest request, HttpServletResponse " +"response)\n" +" throws ServletException, IOException {\n" +" credentials.setUsername( request.getAttribute(\"username\") ):\n" +" credentials.setPassword( request.getAttribute(\"password\") ):\n" +" login.login();\n" +" if ( login.isLoggedIn() ) {\n" +" response.sendRedirect(\"/home.jsp\");\n" +" }\n" +" else {\n" +" response.sendRedirect(\"/loginError.jsp\");\n" +" }\n" +" }\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:42 +#, no-c-format +msgid "" +"The Web Beans client proxy takes care of routing method invocations from the " +"Servlet to the correct instances of <literal>Credentials</literal> and " +"<literal>Login</literal> for the current request and HTTP session." +msgstr "" + +#. Tag: title +#: ee.xml:49 +#, no-c-format +msgid "Calling a Web Bean from a Message-Driven Bean" +msgstr "" + +#. Tag: para +#: ee.xml:51 +#, no-c-format +msgid "" +"Web Beans injection applies to all EJBs, even when they aren't under the " +"control of the Web Bean manager (if they were obtained by direct JNDI " +"lookup, or injection using <literal>@EJB</literal>, for example. In " +"particular, you can use Web Beans injection in Message-Driven Beans, which " +"are not considered Web Beans because you can't inject them." +msgstr "" + +#. Tag: para +#: ee.xml:57 +#, no-c-format +msgid "" +"You can even use Web Beans interceptor bindings for Message-Driven Beans." +msgstr "" + +#. Tag: programlisting +#: ee.xml:59 +#, no-c-format +msgid "" +"@Transactional @MessageDriven\n" +"public class ProcessOrder implements MessageListener {\n" +"\n" +" @Current Inventory inventory;\n" +" @PersistenceContext EntityManager em;\n" +"\n" +" public void onMessage(Message message) {\n" +" ...\n" +" }\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:61 +#, no-c-format +msgid "" +"Thus, receiving messages is super-easy in a Web Beans environment. But " +"beware that there is no session or conversation context available when a " +"message is delivered to a Message-Driven Bean. Only <literal>@RequestScoped</" +"literal> and <literal>@ApplicationScoped</literal> Web Beans are available." +msgstr "" + +#. Tag: para +#: ee.xml:66 +#, no-c-format +msgid "It's also easy to send messages using Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:71 +#, no-c-format +msgid "JMS endpoints" +msgstr "" + +#. Tag: para +#: ee.xml:73 +#, no-c-format +msgid "" +"Sending messages using JMS can be quite complex, because of the number of " +"different objects you need to deal with. For queues we have <literal>Queue</" +"literal>, <literal>QueueConnectionFactory</literal>, " +"<literal>QueueConnection</literal>, <literal>QueueSession</literal> and " +"<literal>QueueSender</literal>. For topics we have <literal>Topic</literal>, " +"<literal>TopicConnectionFactory</literal>, <literal>TopicConnection</" +"literal>, <literal>TopicSession</literal> and <literal>TopicPublisher</" +"literal>. Each of these objects has its own lifecycle and threading model " +"that we need to worry about." +msgstr "" + +#. Tag: para +#: ee.xml:82 +#, no-c-format +msgid "" +"Web Beans takes care of all this for us. All we need to do is declare the " +"queue or topic in <literal>web-beans.xml</literal>, specifying an associated " +"binding type and connection factory." +msgstr "" + +#. Tag: programlisting +#: ee.xml:86 +#, no-c-format +msgid "" +"<![CDATA[<Queue>\n" +" <destination>java:comp/env/jms/OrderQueue</destination>\n" +" <connectionFactory>java:comp/env/jms/QueueConnectionFactory</" +"connectionFactory>\n" +" <myapp:OrderProcessor/> \n" +"</Queue>]]>" +msgstr "" + +#. Tag: programlisting +#: ee.xml:88 +#, no-c-format +msgid "" +"<![CDATA[<Topic>\n" +" <destination>java:comp/env/jms/StockPrices</destination>\n" +" <connectionFactory>java:comp/env/jms/TopicConnectionFactory</" +"connectionFactory>\n" +" <myapp:StockPrices/> \n" +"</Topic>]]>" +msgstr "" + +#. Tag: para +#: ee.xml:90 +#, no-c-format +msgid "" +"Now we can just inject the <literal>Queue</literal>, " +"<literal>QueueConnection</literal>, <literal>QueueSession</literal> or " +"<literal>QueueSender</literal> for a queue, or the <literal>Topic</literal>, " +"<literal>TopicConnection</literal>, <literal>TopicSession</literal> or " +"<literal>TopicPublisher</literal> for a topic." +msgstr "" + +#. Tag: programlisting +#: ee.xml:96 +#, no-c-format +msgid "" +"@OrderProcessor QueueSender orderSender;\n" +"@OrderProcessor QueueSession orderSession;\n" +"\n" +"public void sendMessage() {\n" +" MapMessage msg = orderSession.createMapMessage();\n" +" ...\n" +" orderSender.send(msg);\n" +"}" +msgstr "" + +#. Tag: programlisting +#: ee.xml:98 +#, no-c-format +msgid "" +"@StockPrices TopicPublisher pricePublisher;\n" +"@StockPrices TopicSession priceSession;\n" +"\n" +"public void sendMessage(String price) {\n" +" pricePublisher.send( priceSession.createTextMessage(price) );\n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:100 +#, no-c-format +msgid "" +"The lifecycle of the injected JMS objects are completely controlled by the " +"Web Bean manager." +msgstr "" + +#. Tag: title +#: ee.xml:106 +#, no-c-format +msgid "Packaging and deployment" +msgstr "" + +#. Tag: para +#: ee.xml:108 +#, no-c-format +msgid "" +"Web Beans doesn't define any special deployment archive. You can package Web " +"Beans in JARs, EJB-JARs or WARsany deployment location in the " +"application classpath. However, each archive that contains Web Beans must " +"include a file named <literal>web-beans.xml</literal> in the <literal>META-" +"INF</literal> or <literal>WEB-INF</literal> directory. The file may be " +"empty. Web Beans deployed in archives that do not have a <literal>web-beans." +"xml</literal> file will not be available for use in the application." +msgstr "" + +#. Tag: para +#: ee.xml:116 +#, no-c-format +msgid "" +"For Java SE execution, Web Beans may be deployed in any location in which " +"EJBs may be deployed for execution by the embeddable EJB Lite container. " +"Again, each location must contain a <literal>web-beans.xml</literal> file." +msgstr "" Added: doc/trunk/reference/it-IT/modules/events.po =================================================================== --- doc/trunk/reference/it-IT/modules/events.po (rev 0) +++ doc/trunk/reference/it-IT/modules/events.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,649 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: events.xml:4 +#, no-c-format +msgid "Events" +msgstr "" + +#. Tag: para +#: events.xml:6 +#, no-c-format +msgid "" +"The Web Beans event notification facility allows Web Beans to interact in a " +"totally decoupled manner. Event <emphasis>producers</emphasis> raise events " +"that are then delivered to event <emphasis>observers</emphasis> by the Web " +"Bean manager. This basic schema might sound like the familiar observer/" +"observable pattern, but there are a couple of twists:" +msgstr "" + +#. Tag: para +#: events.xml:14 +#, no-c-format +msgid "" +"not only are event producers decoupled from observers; observers are " +"completely decoupled from producers," +msgstr "" + +#. Tag: para +#: events.xml:18 +#, no-c-format +msgid "" +"observers can specify a combination of \"selectors\" to narrow the set of " +"event notifications they will receive, and" +msgstr "" + +#. Tag: para +#: events.xml:22 +#, no-c-format +msgid "" +"observers can be notified immediately, or can specify that delivery of the " +"event should be delayed until the end of the current transaction" +msgstr "" + +#. Tag: title +#: events.xml:28 +#, no-c-format +msgid "Event observers" +msgstr "" + +#. Tag: para +#: events.xml:30 +#, no-c-format +msgid "" +"An <emphasis>observer method</emphasis> is a method of a Web Bean with a " +"parameter annotated <literal>@Observes</literal>." +msgstr "" + +#. Tag: programlisting +#: events.xml:33 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyDocumentEvent(@Observes Document document) " +"{ ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:35 +#, no-c-format +msgid "" +"The annotated parameter is called the <emphasis>event parameter</emphasis>. " +"The type of the event parameter is the observed <emphasis>event type</" +"emphasis>. Observer methods may also specify \"selectors\", which are just " +"instances of Web Beans binding types. When a binding type is used as an " +"event selector, it is called an <emphasis>event binding type</emphasis>." +msgstr "" + +#. Tag: programlisting +#: events.xml:41 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Target({PARAMETER, FIELD})\n" +"@Retention(RUNTIME)\n" +"public @interface Updated { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:43 +#, no-c-format +msgid "" +"We specify the event bindings of the observer method by annotating the event " +"parameter:" +msgstr "" + +#. Tag: programlisting +#: events.xml:46 events.xml:190 +#, no-c-format +msgid "" +"<![CDATA[public void afterDocumentUpdate(@Observes @Updated Document " +"document) { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:48 +#, no-c-format +msgid "" +"An observer method need not specify any event bindingsin this case it " +"is interested in <emphasis>all</emphasis> events of a particular type. If it " +"does specify event bindings, it is only interested in events which also have " +"those event bindings." +msgstr "" + +#. Tag: para +#: events.xml:53 +#, no-c-format +msgid "" +"The observer method may have additional parameters, which are injected " +"according to the usual Web Beans method parameter injection semantics:" +msgstr "" + +#. Tag: programlisting +#: events.xml:56 +#, no-c-format +msgid "" +"<![CDATA[public void afterDocumentUpdate(@Observes @Updated Document " +"document, User user) { ... }]]>" +msgstr "" + +#. Tag: title +#: events.xml:61 +#, no-c-format +msgid "Event producers" +msgstr "" + +#. Tag: para +#: events.xml:63 +#, no-c-format +msgid "" +"The event producer may obtain an <emphasis>event notifier</emphasis> object " +"by injection:" +msgstr "" + +#. Tag: programlisting +#: events.xml:66 +#, no-c-format +msgid "<![CDATA[@Observable Event<Document> documentEvent]]>" +msgstr "" + +#. Tag: para +#: events.xml:68 +#, no-c-format +msgid "" +"The <literal>@Observable</literal> annotation implicitly defines a Web Bean " +"with scope <literal>@Dependent</literal> and deployment type " +"<literal>@Standard</literal>, with an implementation provided by the Web " +"Bean manager." +msgstr "" + +#. Tag: para +#: events.xml:72 +#, no-c-format +msgid "" +"A producer raises events by calling the <literal>fire()</literal> method of " +"the <literal>Event</literal> interface, passing an <emphasis>event object</" +"emphasis>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:75 +#, no-c-format +msgid "<![CDATA[documentEvent.fire(document);]]>" +msgstr "" + +#. Tag: para +#: events.xml:77 +#, no-c-format +msgid "" +"An event object may be an instance of any Java class that has no type " +"variables or wildcard type parameters. The event will be delivered to every " +"observer method that:" +msgstr "" + +#. Tag: para +#: events.xml:83 events.xml:107 events.xml:126 +#, no-c-format +msgid "has an event parameter to which the event object is assignable, and" +msgstr "" + +#. Tag: para +#: events.xml:86 +#, no-c-format +msgid "specifies no event bindings." +msgstr "" + +#. Tag: para +#: events.xml:90 +#, no-c-format +msgid "" +"The Web Bean manager simply calls all the observer methods, passing the " +"event object as the value of the event parameter. If any observer method " +"throws an exception, the Web Bean manager stops calling observer methods, " +"and the exception is rethrown by the <literal>fire()</literal> method." +msgstr "" + +#. Tag: para +#: events.xml:95 +#, no-c-format +msgid "" +"To specify a \"selector\", the event producer may pass an instance of the " +"event binding type to the <literal>fire()</literal> method:" +msgstr "" + +#. Tag: programlisting +#: events.xml:98 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.fire( document, new AnnotationLiteral<Updated>()" +"{} );]]>" +msgstr "" + +#. Tag: para +#: events.xml:100 +#, no-c-format +msgid "" +"The helper class <literal>AnnotationLiteral</literal> makes it possible to " +"instantiate binding types inline, since this is otherwise difficult to do in " +"Java." +msgstr "" + +#. Tag: para +#: events.xml:103 +#, no-c-format +msgid "The event will be delivered to every observer method that:" +msgstr "" + +#. Tag: para +#: events.xml:110 +#, no-c-format +msgid "" +"does not specify any event binding <emphasis>except</emphasis> for the event " +"bindings passed to <literal>fire()</literal>." +msgstr "" + +#. Tag: para +#: events.xml:115 +#, no-c-format +msgid "" +"Alternatively, event bindings may be specified by annotating the event " +"notifier injection point:" +msgstr "" + +#. Tag: programlisting +#: events.xml:118 +#, no-c-format +msgid "<![CDATA[@Observable @Updated Event<Document> documentUpdatedEvent]]>" +msgstr "" + +#. Tag: para +#: events.xml:120 +#, no-c-format +msgid "" +"Then every event fired via this instance of <literal>Event</literal> has the " +"annotated event binding. The event will be delivered to every observer " +"method that:" +msgstr "" + +#. Tag: para +#: events.xml:129 +#, no-c-format +msgid "" +"does not specify any event binding <emphasis>except</emphasis> for the event " +"bindings passed to <literal>fire()</literal> or the annotated event bindings " +"of the event notifier injection point." +msgstr "" + +#. Tag: title +#: events.xml:138 +#, no-c-format +msgid "Registering observers dynamically" +msgstr "" + +#. Tag: para +#: events.xml:140 +#, no-c-format +msgid "" +"It's often useful to register an event observer dynamically. The application " +"may implement the <literal>Observer</literal> interface and register an " +"instance with an event notifier by calling the <literal>observe()</literal> " +"method." +msgstr "" + +#. Tag: programlisting +#: events.xml:144 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.observe( new Observer<Document>() { public void notify" +"(Document doc) { ... } } );]]>" +msgstr "" + +#. Tag: para +#: events.xml:146 +#, no-c-format +msgid "" +"Event binding types may be specified by the event notifier injection point " +"or by passing event binding type instances to the <literal>observe()</" +"literal> method:" +msgstr "" + +#. Tag: programlisting +#: events.xml:149 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.observe( new Observer<Document>() { public void notify" +"(Document doc) { ... } }, \n" +" new " +"AnnotationLiteral<Updated>(){} );]]>" +msgstr "" + +#. Tag: title +#: events.xml:154 +#, no-c-format +msgid "Event bindings with members" +msgstr "" + +#. Tag: para +#: events.xml:156 +#, no-c-format +msgid "An event binding type may have annotation members:" +msgstr "" + +#. Tag: programlisting +#: events.xml:158 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Target({PARAMETER, FIELD})\n" +"@Retention(RUNTIME)\n" +"public @interface Role {\n" +" RoleType value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:160 +#, no-c-format +msgid "" +"The member value is used to narrow the messages delivered to the observer:" +msgstr "" + +#. Tag: programlisting +#: events.xml:162 +#, no-c-format +msgid "" +"<![CDATA[public void adminLoggedIn(@Observes @Role(ADMIN) LoggedIn event) " +"{ ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:164 +#, no-c-format +msgid "" +"Event binding type members may be specified statically by the event " +"producer, via annotations at the event notifier injection point:" +msgstr "" + +#. Tag: programlisting +#: events.xml:167 +#, no-c-format +msgid "<![CDATA[@Observable @Role(ADMIN) Event<LoggedIn> LoggedInEvent;}}]]>" +msgstr "" + +#. Tag: para +#: events.xml:169 +#, no-c-format +msgid "" +"Alternatively, the value of the event binding type member may be determined " +"dynamically by the event producer. We start by writing an abstract subclass " +"of <literal>AnnotationLiteral</literal>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:172 +#, no-c-format +msgid "" +"<![CDATA[abstract class RoleBinding \n" +" extends AnnotationLiteral<Role> \n" +" implements Role {}]]>" +msgstr "" + +#. Tag: para +#: events.xml:174 +#, no-c-format +msgid "" +"The event producer passes an instance of this class to <literal>fire()</" +"literal>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:176 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.fire( document, new RoleBinding() { public void value" +"() { return user.getRole(); } } );]]>" +msgstr "" + +#. Tag: title +#: events.xml:181 +#, no-c-format +msgid "Multiple event bindings" +msgstr "" + +#. Tag: para +#: events.xml:183 +#, no-c-format +msgid "Event binding types may be combined, for example:" +msgstr "" + +#. Tag: programlisting +#: events.xml:185 +#, no-c-format +msgid "" +"<![CDATA[@Observable @Blog Event<Document> blogEvent;\n" +"...\n" +"if (document.isBlog()) blogEvent.fire(document, new " +"AnnotationLiteral<Updated>(){});]]>" +msgstr "" + +#. Tag: para +#: events.xml:187 +#, no-c-format +msgid "" +"When this event occurs, all of the following observer methods will be " +"notified:" +msgstr "" + +#. Tag: programlisting +#: events.xml:189 +#, no-c-format +msgid "" +"<![CDATA[public void afterBlogUpdate(@Observes @Updated @Blog Document " +"document) { ... }]]>" +msgstr "" + +#. Tag: programlisting +#: events.xml:191 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyBlogEvent(@Observes @Blog Document document) " +"{ ... }]]>" +msgstr "" + +#. Tag: programlisting +#: events.xml:192 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyDocumentEvent(@Observes Document document) " +"{ ... }}}]]>" +msgstr "" + +#. Tag: title +#: events.xml:197 +#, no-c-format +msgid "Transactional observers" +msgstr "" + +#. Tag: para +#: events.xml:199 +#, no-c-format +msgid "" +"Transactional observers receive their event notifications during the before " +"or after completion phase of the transaction in which the event was raised. " +"For example, the following observer method needs to refresh a query result " +"set that is cached in the application context, but only when transactions " +"that update the <literal>Category</literal> tree succeed:" +msgstr "" + +#. Tag: programlisting +#: events.xml:205 +#, no-c-format +msgid "" +"<![CDATA[public void refreshCategoryTree(@AfterTransactionSuccess @Observes " +"CategoryUpdateEvent event) { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:207 +#, no-c-format +msgid "There are three kinds of transactional observers:" +msgstr "" + +#. Tag: para +#: events.xml:211 +#, no-c-format +msgid "" +"<literal>@AfterTransactionSuccess</literal> observers are called during the " +"after completion phase of the transaction, but only if the transaction " +"completes successfully" +msgstr "" + +#. Tag: para +#: events.xml:216 +#, no-c-format +msgid "" +"<literal>@AfterTransactionFailure</literal> observers are called during the " +"after completion phase of the transaction, but only if the transaction fails " +"to complete successfully" +msgstr "" + +#. Tag: para +#: events.xml:221 +#, no-c-format +msgid "" +"<literal>@AfterTransactionCompletion</literal> observers are called during " +"the after completion phase of the transaction" +msgstr "" + +#. Tag: para +#: events.xml:225 +#, no-c-format +msgid "" +"<literal>@BeforeTransactionCompletion</literal> observers are called during " +"the before completion phase of the transaction" +msgstr "" + +#. Tag: para +#: events.xml:230 +#, no-c-format +msgid "" +"Transactional observers are very important in a stateful object model like " +"Web Beans, because state is often held for longer than a single atomic " +"transaction." +msgstr "" + +#. Tag: para +#: events.xml:233 +#, no-c-format +msgid "" +"Imagine that we have cached a JPA query result set in the application scope:" +msgstr "" + +#. Tag: programlisting +#: events.xml:235 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Singleton\n" +"public class Catalog {\n" +"\n" +" @PersistenceContext EntityManager em;\n" +" \n" +" List<Product> products;\n" +"\n" +" @Produces @Catalog \n" +" List<Product> getCatalog() {\n" +" if (products==null) {\n" +" products = em.createQuery(\"select p from Product p where p." +"deleted = false\")\n" +" .getResultList();\n" +" }\n" +" return products;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:237 +#, no-c-format +msgid "" +"From time to time, a <literal>Product</literal> is created or deleted. When " +"this occurs, we need to refresh the <literal>Product</literal> catalog. But " +"we should wait until <emphasis>after</emphasis> the transaction completes " +"successfully before performing this refresh!" +msgstr "" + +#. Tag: para +#: events.xml:242 +#, no-c-format +msgid "" +"The Web Bean that creates and deletes <literal>Product</literal>s could " +"raise events, for example:" +msgstr "" + +#. Tag: programlisting +#: events.xml:245 +#, no-c-format +msgid "" +"<![CDATA[@Stateless\n" +"public class ProductManager {\n" +"\n" +" @PersistenceContext EntityManager em;\n" +" @Observable Event<Product> productEvent;\n" +"\n" +" public void delete(Product product) {\n" +" em.delete(product);\n" +" productEvent.fire(product, new AnnotationLiteral<Deleted>(){});\n" +" }\n" +" \n" +" public void persist(Product product) {\n" +" em.persist(product);\n" +" productEvent.fire(product, new AnnotationLiteral<Created>(){});\n" +" }\n" +" \n" +" ...\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:247 +#, no-c-format +msgid "" +"And now <literal>Catalog</literal> can observe the events after successful " +"completion of the transaction:" +msgstr "" + +#. Tag: programlisting +#: events.xml:250 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Singleton\n" +"public class Catalog {\n" +"\n" +" ...\n" +" \n" +" void addProduct(@AfterTransactionSuccess @Observes @Created Product " +"product) {\n" +" products.add(product);\n" +" }\n" +" \n" +" void addProduct(@AfterTransactionSuccess @Observes @Deleted Product " +"product) {\n" +" products.remove(product);\n" +" }\n" +" \n" +"}]]>" +msgstr "" Added: doc/trunk/reference/it-IT/modules/example.po =================================================================== --- doc/trunk/reference/it-IT/modules/example.po (rev 0) +++ doc/trunk/reference/it-IT/modules/example.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,172 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: example.xml:4 +#, no-c-format +msgid "JSF web application example" +msgstr "" + +#. Tag: para +#: example.xml:6 +#, no-c-format +msgid "" +"Let's illustrate these ideas with a full example. We're going to implement " +"user login/logout for an application that uses JSF. First, we'll define a " +"Web Bean to hold the username and password entered during login:" +msgstr "" + +#. Tag: programlisting +#: example.xml:11 +#, no-c-format +msgid "" +"<![CDATA[@Named\n" +"public class Credentials {\n" +" \n" +" private String username;\n" +" private String password;\n" +" \n" +" public String getUsername() { return username; }\n" +" public void setUsername(String username) { this.username = username; }\n" +" \n" +" public String getPassword() { return password; }\n" +" public void setPassword(String password) { this.password = password; }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:13 +#, no-c-format +msgid "This Web Bean is bound to the login prompt in the following JSF form:" +msgstr "" + +#. Tag: programlisting +#: example.xml:15 +#, no-c-format +msgid "" +"<![CDATA[<f:form>\n" +" <h:panelGrid columns=\"2\" rendered=\"#{!login.loggedIn}\">\n" +" <h:outputLabel for=\"username\">Username:</h:outputLabel>\n" +" <h:inputText id=\"username\" value=\"#{credentials.username}\"/>\n" +" <h:outputLabel for=\"password\">Password:</h:outputLabel>\n" +" <h:inputText id=\"password\" value=\"#{credentials.password}\"/>\n" +" </h:panelGrid>\n" +" <h:commandButton value=\"Login\" action=\"#{login.login}\" rendered=\"#{!" +"login.loggedIn}\"/>\n" +" <h:commandButton value=\"Logout\" acion=\"#{login.logout}\" rendered=\"#" +"{login.loggedIn}\"/>\n" +"</f:form]]>" +msgstr "" + +#. Tag: para +#: example.xml:17 +#, no-c-format +msgid "" +"The actual work is done by a session scoped Web Bean that maintains " +"information about the currently logged-in user and exposes the " +"<literal>User</literal> entity to other Web Beans:" +msgstr "" + +#. Tag: programlisting +#: example.xml:21 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named\n" +"public class Login {\n" +"\n" +" @Current Credentials credentials;\n" +" @PersistenceContext EntityManager userDatabase;\n" +"\n" +" private User user;\n" +" \n" +" public void login() {\n" +" \n" +" List<User> results = userDatabase.createQuery(\n" +" \"select u from User u where u.username=:username and u.password=:" +"password\")\n" +" .setParameter(\"username\", credentials.getUsername())\n" +" .setParameter(\"password\", credentials.getPassword())\n" +" .getResultList();\n" +" \n" +" if ( !results.isEmpty() ) {\n" +" user = results.get(0);\n" +" }\n" +" \n" +" }\n" +" \n" +" public void logout() {\n" +" user = null;\n" +" }\n" +" \n" +" public boolean isLoggedIn() {\n" +" return user!=null;\n" +" }\n" +" \n" +" @Produces @LoggedIn User getCurrentUser() {\n" +" return user;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:23 +#, no-c-format +msgid "Of course, <literal>@LoggedIn</literal> is a binding annotation:" +msgstr "" + +#. Tag: programlisting +#: example.xml:25 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD})\n" +"@BindingType\n" +"public @interface LoggedIn {}]]>" +msgstr "" + +#. Tag: para +#: example.xml:27 +#, no-c-format +msgid "Now, any other Web Bean can easily inject the current user:" +msgstr "" + +#. Tag: programlisting +#: example.xml:29 +#, no-c-format +msgid "" +"<![CDATA[public class DocumentEditor {\n" +"\n" +" @Current Document document;\n" +" @LoggedIn User currentUser;\n" +" @PersistenceContext EntityManager docDatabase;\n" +" \n" +" public void save() {\n" +" document.setCreatedBy(currentUser);\n" +" docDatabase.persist(document);\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:31 +#, no-c-format +msgid "" +"Hopefully, this example gives a flavor of the Web Bean programming model. In " +"the next chapter, we'll explore Web Beans dependency injection in greater " +"depth." +msgstr "" Added: doc/trunk/reference/it-IT/modules/extend.po =================================================================== --- doc/trunk/reference/it-IT/modules/extend.po (rev 0) +++ doc/trunk/reference/it-IT/modules/extend.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,252 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: extend.xml:4 +#, no-c-format +msgid "Extending Web Beans" +msgstr "" + +#. Tag: para +#: extend.xml:6 +#, no-c-format +msgid "" +"Web Beans is intended to be a platform for frameworks, extensions and " +"integration with other technologies. Therefore, Web Beans exposes a set of " +"SPIs for the use of developers of portable extensions to Web Beans. For " +"example, the following kinds of extensions were envisaged by the designers " +"of Web Beans:" +msgstr "" + +#. Tag: para +#: extend.xml:14 +#, no-c-format +msgid "integration with Business Process Management engines," +msgstr "" + +#. Tag: para +#: extend.xml:17 +#, no-c-format +msgid "" +"integration with third-party frameworks such as Spring, Seam, GWT or Wicket, " +"and" +msgstr "" + +#. Tag: para +#: extend.xml:21 +#, no-c-format +msgid "new technology based upon the Web Beans programming model." +msgstr "" + +#. Tag: para +#: extend.xml:25 +#, no-c-format +msgid "" +"The nerve center for extending Web Beans is the <literal>Manager</literal> " +"object." +msgstr "" + +#. Tag: title +#: extend.xml:29 +#, no-c-format +msgid "The <literal>Manager</literal> object" +msgstr "" + +#. Tag: para +#: extend.xml:31 +#, no-c-format +msgid "" +"The <literal>Manager</literal> interface lets us register and obtain Web " +"Beans, interceptors, decorators, observers and contexts programatically." +msgstr "" + +#. Tag: programlisting +#: extend.xml:34 +#, no-c-format +msgid "" +"<![CDATA[public interface Manager\n" +"{\n" +"\n" +" public <T> Set<Bean<T>> resolveByType(Class<T> type, Annotation... " +"bindings);\n" +"\n" +" public <T> Set<Bean<T>> resolveByType(TypeLiteral<T> apiType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> T getInstanceByType(Class<T> type, Annotation... bindings);\n" +"\n" +" public <T> T getInstanceByType(TypeLiteral<T> type,\n" +" Annotation... bindings);\n" +"\n" +" public Set<Bean<?>> resolveByName(String name);\n" +"\n" +" public Object getInstanceByName(String name);\n" +"\n" +" public <T> T getInstance(Bean<T> bean);\n" +"\n" +" public void fireEvent(Object event, Annotation... bindings);\n" +"\n" +" public Context getContext(Class<? extends Annotation> scopeType);\n" +"\n" +" public Manager addContext(Context context);\n" +"\n" +" public Manager addBean(Bean<?> bean);\n" +"\n" +" public Manager addInterceptor(Interceptor interceptor);\n" +"\n" +" public Manager addDecorator(Decorator decorator);\n" +"\n" +" public <T> Manager addObserver(Observer<T> observer, Class<T> eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager addObserver(Observer<T> observer, TypeLiteral<T> " +"eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager removeObserver(Observer<T> observer, Class<T> " +"eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager removeObserver(Observer<T> observer,\n" +" TypeLiteral<T> eventType, Annotation... bindings);\n" +"\n" +" public <T> Set<Observer<T>> resolveObservers(T event, Annotation... " +"bindings);\n" +"\n" +" public List<Interceptor> resolveInterceptors(InterceptionType type,\n" +" Annotation... interceptorBindings);\n" +"\n" +" public List<Decorator> resolveDecorators(Set<Class<?>> types,\n" +" Annotation... bindings);\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: extend.xml:36 +#, no-c-format +msgid "We can obtain an instance of <literal>Manager</literal> via injection:" +msgstr "" + +#. Tag: programlisting +#: extend.xml:38 +#, no-c-format +msgid "@Current Manager manager" +msgstr "" + +#. Tag: title +#: extend.xml:43 +#, no-c-format +msgid "The <literal>Bean</literal> class" +msgstr "" + +#. Tag: para +#: extend.xml:45 +#, no-c-format +msgid "" +"Instances of the abstract class <literal>Bean</literal> represent Web Beans. " +"There is an instance of <literal>Bean</literal> registered with the " +"<literal>Manager</literal> object for every Web Bean in the application." +msgstr "" + +#. Tag: programlisting +#: extend.xml:50 +#, no-c-format +msgid "" +"public abstract class Bean<T> {\n" +" \n" +" private final Manager manager;\n" +" \n" +" protected Bean(Manager manager) {\n" +" this.manager=manager;\n" +" }\n" +" \n" +" protected Manager getManager() {\n" +" return manager;\n" +" }\n" +" \n" +" public abstract Set<Class> getTypes();\n" +" public abstract Set<Annotation> getBindingTypes();\n" +" public abstract Class<? extends Annotation> getScopeType();\n" +" public abstract Class<? extends Annotation> getDeploymentType(); \n" +" public abstract String getName();\n" +" \n" +" public abstract boolean isSerializable();\n" +" public abstract boolean isNullable();\n" +"\n" +" public abstract T create();\n" +" public abstract void destroy(T instance);\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: extend.xml:52 +#, no-c-format +msgid "" +"It's possible to extend the <literal>Bean</literal> class and register " +"instances by calling <literal>Manager.addBean()</literal> to provide support " +"for new kinds of Web Beans, beyond those defined by the Web Beans " +"specification (simple and enterprise Web Beans, producer methods and JMS " +"endpoints). For example, we could use the <literal>Bean</literal> class to " +"allow objects managed by another framework to be injected into Web Beans." +msgstr "" + +#. Tag: para +#: extend.xml:60 +#, no-c-format +msgid "" +"There are two subclasses of <literal>Bean</literal> defined by the Web Beans " +"specification: <literal>Interceptor</literal> and <literal>Decorator</" +"literal>." +msgstr "" + +#. Tag: title +#: extend.xml:67 +#, no-c-format +msgid "The <literal>Context</literal> interface" +msgstr "" + +#. Tag: para +#: extend.xml:69 +#, no-c-format +msgid "" +"The <literal>Context</literal> interface supports addition of new scopes to " +"Web Beans, or extension of the built-in scopes to new environments." +msgstr "" + +#. Tag: programlisting +#: extend.xml:72 +#, no-c-format +msgid "" +"public interface Context {\n" +" \n" +" public Class<? extends Annotation> getScopeType();\n" +" \n" +" public <T> T get(Bean<T> bean, boolean create);\n" +" \n" +" boolean isActive();\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: extend.xml:74 +#, no-c-format +msgid "" +"For example, we might implement <literal>Context</literal> to add a business " +"process scope to Web Beans, or to add support for the conversation scope to " +"an application that uses Wicket." +msgstr "" Added: doc/trunk/reference/it-IT/modules/injection.po =================================================================== --- doc/trunk/reference/it-IT/modules/injection.po (rev 0) +++ doc/trunk/reference/it-IT/modules/injection.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,1226 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: injection.xml:4 +#, no-c-format +msgid "Dependency injection" +msgstr "" + +#. Tag: para +#: injection.xml:6 +#, no-c-format +msgid "Web Beans supports three primary mechanisms for dependency injection:" +msgstr "" + +#. Tag: para +#: injection.xml:8 +#, no-c-format +msgid "Constructor parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:10 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +" \n" +" private final ShoppingCart cart;\n" +" \n" +" @Initializer\n" +" public Checkout(ShoppingCart cart) {\n" +" this.cart = cart;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:12 +#, no-c-format +msgid "<emphasis>Initializer</emphasis> method parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:14 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +" \n" +" private ShoppingCart cart;\n" +"\n" +" @Initializer \n" +" void setShoppingCart(ShoppingCart cart) {\n" +" this.cart = cart;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:16 +#, no-c-format +msgid "And direct field injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:18 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +"\n" +" private @Current ShoppingCart cart;\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:20 +#, no-c-format +msgid "" +"Dependency injection always occurs when the Web Bean instance is first " +"instantiated." +msgstr "" + +#. Tag: para +#: injection.xml:25 +#, no-c-format +msgid "" +"First, the Web Bean manager calls the Web Bean constructor, to obtain an " +"instance of the Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:29 +#, no-c-format +msgid "" +"Next, the Web Bean manager initializes the values of all injected fields of " +"the Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:33 +#, no-c-format +msgid "Next, the Web Bean manager calls all initializer methods of Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:37 +#, no-c-format +msgid "" +"Finally, the <literal>@PostConstruct</literal> method of the Web Bean, if " +"any, is called." +msgstr "" + +#. Tag: para +#: injection.xml:42 +#, no-c-format +msgid "" +"Constructor parameter injection is not supported for EJB beans, since the " +"EJB is instantiated by the EJB container, not the Web Bean manager." +msgstr "" + +#. Tag: para +#: injection.xml:45 +#, no-c-format +msgid "" +"Parameters of constructors and initializer methods need not be explicitly " +"annotated when the default binding type <literal>@Current</literal> applies. " +"Injected fields, however, <emphasis>must</emphasis> specify a binding type, " +"even when the default binding type applies. If the field does not specify a " +"binding type, it will not be injected." +msgstr "" + +#. Tag: para +#: injection.xml:51 +#, no-c-format +msgid "Producer methods also support parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:53 +#, no-c-format +msgid "" +"<![CDATA[@Produces Checkout createCheckout(ShoppingCart cart) {\n" +" return new Checkout(cart);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:55 +#, no-c-format +msgid "" +"Finally, observer methods (which we'll meet in <xref linkend=\"events\"/>), " +"disposal methods and destructor methods all support parameter injection." +msgstr "" + +#. Tag: para +#: injection.xml:58 +#, no-c-format +msgid "" +"The Web Beans specification defines a procedure, called the " +"<emphasis>typesafe resolution algorithm</emphasis>, that the Web Bean " +"manager follows when identifying the Web Bean to inject to an injection " +"point. This algorithm looks complex at first, but once you understand it, " +"it's really quite intuitive. Typesafe resolution is performed at system " +"initialization time, which means that the manager will inform the user " +"immediately if a Web Bean's dependencies cannot be satisfied, by throwing a " +"<literal>UnsatisfiedDependencyException</literal> or " +"<literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:67 +#, no-c-format +msgid "" +"The purpose of this algorithm is to allow multiple Web Beans to implement " +"the same API type and either:" +msgstr "" + +#. Tag: para +#: injection.xml:72 +#, no-c-format +msgid "" +"allow the client to select which implementation it requires using " +"<emphasis>binding annotations</emphasis>," +msgstr "" + +#. Tag: para +#: injection.xml:77 +#, no-c-format +msgid "" +"allow the application deployer to select which implementation is appropriate " +"for a particular deployment, without changes to the client, by enabling or " +"disabling <emphasis>deployment types</emphasis>, or" +msgstr "" + +#. Tag: para +#: injection.xml:82 +#, no-c-format +msgid "" +"allow one implementation of an API to override another implementation of the " +"same API at deployment time, without changes to the client, using " +"<emphasis>deployment type precedence</emphasis>." +msgstr "" + +#. Tag: para +#: injection.xml:88 +#, no-c-format +msgid "" +"Let's explore how the Web Beans manager determines a Web Bean to be injected." +msgstr "" + +#. Tag: title +#: injection.xml:91 +#, no-c-format +msgid "Binding annotations" +msgstr "" + +#. Tag: para +#: injection.xml:93 +#, no-c-format +msgid "" +"If we have more than one Web Bean that implements a particular API type, the " +"injection point can specify exactly which Web Bean should be injected using " +"a binding annotation. For example, there might be two implementations of " +"<literal>PaymentProcessor</literal>:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:98 +#, no-c-format +msgid "" +"<![CDATA[@PayByCheque\n" +"public class ChequePaymentProcessor implements PaymentProcessor {\n" +" public void process(Payment payment) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:100 +#, no-c-format +msgid "" +"<![CDATA[@PayByCreditCard\n" +"public class CreditCardPaymentProcessor implements PaymentProcessor {\n" +" public void process(Payment payment) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:102 +#, no-c-format +msgid "" +"Where <literal>@PayByCheque</literal> and <literal>@PayByCreditCard</" +"literal> are binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:105 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayByCheque {}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:107 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayByCreditCard {}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:109 +#, no-c-format +msgid "" +"A client Web Bean developer uses the binding annotation to specify exactly " +"which Web Bean should be injected." +msgstr "" + +#. Tag: para +#: injection.xml:112 +#, no-c-format +msgid "Using field injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:114 +#, no-c-format +msgid "" +"<![CDATA[@PayByCheque PaymentProcessor chequePaymentProcessor;\n" +"@PayByCreditCard PaymentProcessor creditCardPaymentProcessor;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:116 +#, no-c-format +msgid "Using initializer method injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:118 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public void setPaymentProcessors(@PayByCheque PaymentProcessor " +"chequePaymentProcessor, \n" +" @PayByCreditCard PaymentProcessor " +"creditCardPaymentProcessor) {\n" +" this.chequePaymentProcessor = chequePaymentProcessor;\n" +" this.creditCardPaymentProcessor = creditCardPaymentProcessor;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:120 +#, no-c-format +msgid "Or using constructor injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:122 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public Checkout(@PayByCheque PaymentProcessor chequePaymentProcessor, \n" +" @PayByCreditCard PaymentProcessor " +"creditCardPaymentProcessor) {\n" +" this.chequePaymentProcessor = chequePaymentProcessor;\n" +" this.creditCardPaymentProcessor = creditCardPaymentProcessor;\n" +"}]]>" +msgstr "" + +#. Tag: title +#: injection.xml:125 +#, no-c-format +msgid "Binding annotations with members" +msgstr "" + +#. Tag: para +#: injection.xml:127 +#, no-c-format +msgid "Binding annotations may have members:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:129 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayBy {\n" +" PaymentType value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:131 +#, no-c-format +msgid "In which case, the member value is significant:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:133 +#, no-c-format +msgid "" +"<![CDATA[@PayBy(CHEQUE) PaymentProcessor chequePaymentProcessor;\n" +"@PayBy(CREDIT_CARD) PaymentProcessor creditCardPaymentProcessor;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:135 +#, no-c-format +msgid "" +"You can tell the Web Bean manager to ignore a member of a binding annotation " +"type by annotating the member <literal>@NonBinding</literal>." +msgstr "" + +#. Tag: title +#: injection.xml:141 +#, no-c-format +msgid "Combinations of binding annnotations" +msgstr "" + +#. Tag: para +#: injection.xml:143 +#, no-c-format +msgid "An injection point may even specify multiple binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:145 +#, no-c-format +msgid "" +"<![CDATA[@Asynchronous @PayByCheque PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: injection.xml:147 +#, no-c-format +msgid "" +"In this case, only a Web Bean which has <emphasis>both</emphasis> binding " +"annotations would be eligible for injection." +msgstr "" + +#. Tag: title +#: injection.xml:153 +#, no-c-format +msgid "Binding annotations and producer methods" +msgstr "" + +#. Tag: para +#: injection.xml:155 +#, no-c-format +msgid "Even producer methods may specify binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:157 +#, no-c-format +msgid "" +"<![CDATA[@Produces \n" +"@Asynchronous @PayByCheque \n" +"PaymentProcessor createAsyncPaymentProcessor(@PayByCheque PaymentProcessor " +"processor) {\n" +" return new AsynchronousPaymentProcessor(processor);\n" +"}]]>" +msgstr "" + +#. Tag: title +#: injection.xml:162 +#, no-c-format +msgid "The default binding type" +msgstr "" + +#. Tag: para +#: injection.xml:164 +#, no-c-format +msgid "" +"Web Beans defines a binding type <literal>@Current</literal> that is the " +"default binding type for any injection point or Web Bean that does not " +"explicitly specify a binding type." +msgstr "" + +#. Tag: para +#: injection.xml:168 +#, no-c-format +msgid "" +"There are two common circumstances in which it is necessary to explicitly " +"specify <literal>@Current</literal>:" +msgstr "" + +#. Tag: para +#: injection.xml:173 +#, no-c-format +msgid "" +"on a field, in order to declare it as an injected field with the default " +"binding type, and" +msgstr "" + +#. Tag: para +#: injection.xml:177 +#, no-c-format +msgid "" +"on a Web Bean which has another binding type in addition to the default " +"binding type." +msgstr "" + +#. Tag: title +#: injection.xml:187 +#, no-c-format +msgid "Deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:189 +#, no-c-format +msgid "" +"All Web Beans have a <emphasis>deployment type</emphasis>. Each deployment " +"type identifies a set of Web Beans that should be conditionally installed in " +"some deployments of the system." +msgstr "" + +#. Tag: para +#: injection.xml:193 +#, no-c-format +msgid "" +"For example, we could define a deployment type named <literal>@Mock</" +"literal>, which would identify Web Beans that should only be installed when " +"the system executes inside an integration testing environment:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:197 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +" @Target({TYPE, METHOD})\n" +" @DeploymentType\n" +" public @interface Mock {}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:199 +#, no-c-format +msgid "" +"Suppose we had some Web Bean that interacted with an external system to " +"process payments:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:202 +#, no-c-format +msgid "" +"<![CDATA[public class ExternalPaymentProcessor {\n" +" \n" +" public void process(Payment p) {\n" +" ...\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:204 +#, no-c-format +msgid "" +"Since this Web Bean does not explicitly specify a deployment type, it has " +"the default deployment type <literal>@Production</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:207 +#, no-c-format +msgid "" +"For integration or unit testing, the external system is slow or unavailable. " +"So we would create a mock object:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:210 +#, no-c-format +msgid "" +"<![CDATA[@Mock \n" +"public class MockPaymentProcessor implements PaymentProcessor {\n" +"\n" +" @Override\n" +" public void process(Payment p) {\n" +" p.setSuccessful(true);\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:212 +#, no-c-format +msgid "" +"But how does the Web Bean manager determine which implementation to use in a " +"particular deployment?" +msgstr "" + +#. Tag: title +#: injection.xml:216 +#, no-c-format +msgid "Enabling deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:218 +#, no-c-format +msgid "" +"Web Beans defines two built-in deployment types: <literal>@Production</" +"literal> and <literal>@Standard</literal>. By default, only Web Beans with " +"the built-in deployment types are enabled when the system is deployed. We " +"can identify additional deployment types to be enabled in a particular " +"deployment by listing them in <literal>web-beans.xml</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:224 +#, no-c-format +msgid "" +"Going back to our example, when we deploy our integration tests, we want all " +"our <literal>@Mock</literal> objects to be installed:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:227 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans>\n" +" <Deploy>\n" +" <Standard/>\n" +" <Production/>\n" +" <test:Mock/>\n" +" </Deploy>\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: injection.xml:229 +#, no-c-format +msgid "" +"Now the Web Bean manager will identify and install all Web Beans annotated " +"<literal>@Production</literal>, <literal>@Standard</literal> or " +"<literal>@Mock</literal> at deployment time." +msgstr "" + +#. Tag: para +#: injection.xml:233 +#, no-c-format +msgid "" +"The deployment type <literal>@Standard</literal> is used only for certain " +"special Web Beans defined by the Web Beans specification. We can't use it " +"for our own Web Beans, and we can't disable it." +msgstr "" + +#. Tag: para +#: injection.xml:237 +#, no-c-format +msgid "" +"The deployment type <literal>@Production</literal> is the default deployment " +"type for Web Beans which don't explicitly declare a deployment type, and may " +"be disabled." +msgstr "" + +#. Tag: title +#: injection.xml:244 +#, no-c-format +msgid "Deployment type precedence" +msgstr "" + +#. Tag: para +#: injection.xml:246 +#, no-c-format +msgid "" +"If you've been paying attention, you're probably wondering how the Web Bean " +"manager decides which implementation<literal>ExternalPaymentProcessor</" +"literal> or <literal>MockPaymentProcessor</literal>to choose. Consider " +"what happens when the manager encounters this injection point:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:251 +#, no-c-format +msgid "<![CDATA[@Current PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: injection.xml:253 +#, no-c-format +msgid "" +"There are now two Web Beans which satisfy the <literal>PaymentProcessor</" +"literal> contract. Of course, we can't use a binding annotation to " +"disambiguate, since binding annotations are hard-coded into the source at " +"the injection point, and we want the manager to be able to decide at " +"deployment time!" +msgstr "" + +#. Tag: para +#: injection.xml:258 +#, no-c-format +msgid "" +"The solution to this problem is that each deployment type has a different " +"<emphasis>precedence</emphasis>. The precedence of the deployment types is " +"determined by the order in which they appear in <literal>web-beans.xml</" +"literal>. In our example, <literal>@Mock</literal> appears later than " +"<literal>@Production</literal> so it has a higher precedence." +msgstr "" + +#. Tag: para +#: injection.xml:264 +#, no-c-format +msgid "" +"Whenever the manager discovers that more than one Web Bean could satisfy the " +"contract (API type plus binding annotations) specified by an injection " +"point, it considers the relative precedence of the Web Beans. If one has a " +"higher precedence than the others, it chooses the higher precedence Web Bean " +"to inject. So, in our example, the Web Bean manager will inject " +"<literal>MockPaymentProcessor</literal> when executing in our integration " +"testing environment (which is exactly what we want)." +msgstr "" + +#. Tag: para +#: injection.xml:271 +#, no-c-format +msgid "" +"It's interesting to compare this facility to today's popular manager " +"architectures. Various \"lightweight\" containers also allow conditional " +"deployment of classes that exist in the classpath, but the classes that are " +"to be deployed must be explicity, individually, listed in configuration code " +"or in some XML configuration file. Web Beans does support Web Bean " +"definition and configuration via XML, but in the common case where no " +"complex configuration is required, deployment types allow a whole set of Web " +"Beans to be enabled with a single line of XML. Meanwhile, a developer " +"browsing the code can easily identify what deployment scenarios the Web Bean " +"will be used in." +msgstr "" + +#. Tag: title +#: injection.xml:284 +#, no-c-format +msgid "Example deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:286 +#, no-c-format +msgid "" +"Deployment types are useful for all kinds of things, here's some examples:" +msgstr "" + +#. Tag: para +#: injection.xml:290 +#, no-c-format +msgid "" +"<literal>@Mock</literal> and <literal>@Staging</literal> deployment types " +"for testing" +msgstr "" + +#. Tag: para +#: injection.xml:294 +#, no-c-format +msgid "<literal>@AustralianTaxLaw</literal> for site-specific Web Beans" +msgstr "" + +#. Tag: para +#: injection.xml:297 +#, no-c-format +msgid "" +"<literal>@SeamFramework</literal>, <literal>@Guice</literal> for third-party " +"frameworks which build on Web Beans" +msgstr "" + +#. Tag: para +#: injection.xml:301 +#, no-c-format +msgid "" +"<literal>@Standard</literal> for standard Web Beans defined by the Web Beans " +"specification" +msgstr "" + +#. Tag: para +#: injection.xml:306 +#, no-c-format +msgid "I'm sure you can think of more applications..." +msgstr "" + +#. Tag: title +#: injection.xml:313 +#, no-c-format +msgid "Fixing unsatisfied dependencies" +msgstr "" + +#. Tag: para +#: injection.xml:315 +#, no-c-format +msgid "" +"The typesafe resolution algorithm fails when, after considering the binding " +"annotations and and deployment types of all Web Beans that implement the API " +"type of an injection point, the Web Bean manager is unable to identify " +"exactly one Web Bean to inject." +msgstr "" + +#. Tag: para +#: injection.xml:320 +#, no-c-format +msgid "" +"It's usually easy to fix an <literal>UnsatisfiedDependencyException</" +"literal> or <literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:323 +#, no-c-format +msgid "" +"To fix an <literal>UnsatisfiedDependencyException</literal>, simply provide " +"a Web Bean which implements the API type and has the binding types of the " +"injection pointor enable the deployment type of a Web Bean that " +"already implements the API type and has the binding types." +msgstr "" + +#. Tag: para +#: injection.xml:328 +#, no-c-format +msgid "" +"To fix an <literal>AmbiguousDependencyException</literal>, introduce a " +"binding type to distinguish between the two implementations of the API type, " +"or change the deployment type of one of the implementations so that the Web " +"Bean manager can use deployment type precedence to choose between them. An " +"<literal>AmbiguousDependencyException</literal> can only occur if two Web " +"Beans share a binding type and have exactly the same deployment type." +msgstr "" + +#. Tag: para +#: injection.xml:335 +#, no-c-format +msgid "" +"There's one more issue you need to be aware of when using dependency " +"injection in Web Beans." +msgstr "" + +#. Tag: title +#: injection.xml:341 +#, no-c-format +msgid "Client proxies" +msgstr "" + +#. Tag: para +#: injection.xml:343 +#, no-c-format +msgid "" +"Clients of an injected Web Bean do not usually hold a direct reference to a " +"Web Bean instance." +msgstr "" + +#. Tag: para +#: injection.xml:346 +#, no-c-format +msgid "" +"Imagine that a Web Bean bound to the application scope held a direct " +"reference to a Web Bean bound to the request scope. The application scoped " +"Web Bean is shared between many different requests. However, each request " +"should see a different instance of the request scoped Web bean!" +msgstr "" + +#. Tag: para +#: injection.xml:351 +#, no-c-format +msgid "" +"Now imagine that a Web Bean bound to the session scope held a direct " +"reference to a Web Bean bound to the application scope. From time to time, " +"the session context is serialized to disk in order to use memory more " +"efficiently. However, the application scoped Web Bean instance should not be " +"serialized along with the session scoped Web Bean!" +msgstr "" + +#. Tag: para +#: injection.xml:357 +#, no-c-format +msgid "" +"Therefore, unless a Web Bean has the default scope <literal>@Dependent</" +"literal>, the Web Bean manager must indirect all injected references to the " +"Web Bean through a proxy object. This <emphasis>client proxy</emphasis> is " +"responsible for ensuring that the Web Bean instance that receives a method " +"invocation is the instance that is associated with the current context. The " +"client proxy also allows Web Beans bound to contexts such as the session " +"context to be serialized to disk without recursively serializing other " +"injected Web Beans." +msgstr "" + +#. Tag: para +#: injection.xml:365 +#, no-c-format +msgid "" +"Unfortunately, due to limitations of the Java language, some Java types " +"cannot be proxied by the Web Bean manager. Therefore, the Web Bean manager " +"throws an <literal>UnproxyableDependencyException</literal> if the type of " +"an injection point cannot be proxied." +msgstr "" + +#. Tag: para +#: injection.xml:370 +#, no-c-format +msgid "The following Java types cannot be proxied by the Web Bean manager:" +msgstr "" + +#. Tag: para +#: injection.xml:374 +#, no-c-format +msgid "" +"classes which are declared <literal>final</literal> or have a " +"<literal>final</literal> method," +msgstr "" + +#. Tag: para +#: injection.xml:378 +#, no-c-format +msgid "classes which have no non-private constructor with no parameters, and" +msgstr "" + +#. Tag: para +#: injection.xml:381 +#, no-c-format +msgid "arrays and primitive types." +msgstr "" + +#. Tag: para +#: injection.xml:385 +#, no-c-format +msgid "" +"It's usually very easy to fix an <literal>UnproxyableDependencyException</" +"literal>. Simply add a constructor with no parameters to the injected class, " +"introduce an interface, or change the scope of the injected Web Bean to " +"<literal>@Dependent</literal>." +msgstr "" + +#. Tag: title +#: injection.xml:392 +#, no-c-format +msgid "Obtaining a Web Bean by programatic lookup" +msgstr "" + +#. Tag: para +#: injection.xml:394 +#, no-c-format +msgid "" +"The application may obtain an instance of the interface <literal>Manager</" +"literal> by injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:397 +#, no-c-format +msgid "<![CDATA[@Current Manager manager;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:399 +#, no-c-format +msgid "" +"The <literal>Manager</literal> object provides a set of methods for " +"obtaining a Web Bean instance programatically." +msgstr "" + +#. Tag: programlisting +#: injection.xml:402 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class);]]>" +msgstr "" + +#. Tag: para +#: injection.xml:404 +#, no-c-format +msgid "" +"Binding annotations may be specified by subclassing the helper class " +"<literal>AnnotationLiteral</literal>, since it is otherwise difficult to " +"instantiate an annotation type in Java." +msgstr "" + +#. Tag: programlisting +#: injection.xml:408 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class, \n" +" new " +"AnnotationLiteral<CreditCard>(){});]]>" +msgstr "" + +#. Tag: para +#: injection.xml:410 +#, no-c-format +msgid "" +"If the binding type has an annotation member, we can't use an anonymous " +"subclass of <literal>AnnotationLiteral</literal>instead we'll need to " +"create a named subclass:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:413 +#, no-c-format +msgid "" +"<![CDATA[abstract class CreditCardBinding \n" +" extends AnnotationLiteral<CreditCard> \n" +" implements CreditCard {}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:415 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class, \n" +" new CreditCardBinding() { \n" +" public void value() " +"{ return paymentType; } \n" +" } );]]>" +msgstr "" + +#. Tag: title +#: injection.xml:419 +#, no-c-format +msgid "" +"Lifecycle callbacks, <literal>@Resource</literal>, <literal>@EJB</literal> " +"and <literal>@PersistenceContext</literal>" +msgstr "" + +#. Tag: para +#: injection.xml:422 +#, no-c-format +msgid "" +"Enterprise Web Beans support all the lifecycle callbacks defined by the EJB " +"specification: <literal>@PostConstruct</literal>, <literal>@PreDestroy</" +"literal>, <literal>@PrePassivate</literal> and <literal>@PostActivate</" +"literal>." +msgstr "" + +#. Tag: para +#: injection.xml:426 +#, no-c-format +msgid "" +"Simple Web Beans support only the <literal>@PostConstruct</literal> and " +"<literal>@PreDestroy</literal> callbacks." +msgstr "" + +#. Tag: para +#: injection.xml:429 +#, no-c-format +msgid "" +"Both enterprise and simple Web Beans support the use of <literal>@Resource</" +"literal>, <literal>@EJB</literal> and <literal>@PersistenceContext</literal> " +"for injection of Java EE resources, EJBs and JPA persistence contexts, " +"respectively. Simple Web Beans do not support the use of " +"<literal>@PersistenceContext(type=EXTENDED)</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:434 +#, no-c-format +msgid "" +"The <literal>@PostConstruct</literal> callback always occurs after all " +"dependencies have been injected." +msgstr "" + +#. Tag: title +#: injection.xml:440 +#, no-c-format +msgid "The <literal>InjectionPoint</literal> object" +msgstr "" + +#. Tag: para +#: injection.xml:442 +#, no-c-format +msgid "" +"There are certain kinds of dependent objectsWeb Beans with scope " +"<literal>@Dependent</literal>that need to know something about the " +"object or injection point into which they are injected in order to be able " +"to do what they do. For example:" +msgstr "" + +#. Tag: para +#: injection.xml:448 +#, no-c-format +msgid "" +"The log category for a <literal>Logger</literal> depends upon the class of " +"the object that owns it." +msgstr "" + +#. Tag: para +#: injection.xml:452 +#, no-c-format +msgid "" +"Injection of a HTTP parameter or header value depends upon what parameter or " +"header name was specified at the injection point." +msgstr "" + +#. Tag: para +#: injection.xml:456 +#, no-c-format +msgid "" +"Injection of the result of an EL expression evaluation depends upon the " +"expression that was specified at the injection point." +msgstr "" + +#. Tag: para +#: injection.xml:461 +#, no-c-format +msgid "" +"A Web Bean with scope <literal>@Dependent</literal> may inject an instance " +"of <literal>InjectionPoint</literal> and access metadata relating to the " +"injection point to which it belongs." +msgstr "" + +#. Tag: para +#: injection.xml:465 +#, no-c-format +msgid "" +"Let's look at an example. The following code is verbose, and vulnerable to " +"refactoring problems:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:468 +#, no-c-format +msgid "<![CDATA[Logger log = Logger.getLogger(MyClass.class.getName());]]>" +msgstr "" + +#. Tag: para +#: injection.xml:470 +#, no-c-format +msgid "" +"This clever little producer method lets you inject a JDK <literal>Logger</" +"literal> without explicitly specifying the log category:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:473 +#, no-c-format +msgid "" +"<![CDATA[class LogFactory {\n" +"\n" +" @Produces Logger createLogger(InjectionPoint injectionPoint) { \n" +" return Logger.getLogger(injectionPoint.getMember().getDeclaringClass()." +"getName()); \n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:475 +#, no-c-format +msgid "We can now write:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:477 +#, no-c-format +msgid "<![CDATA[@Current Logger log;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:479 +#, no-c-format +msgid "" +"Not convinced? Then here's a second example. To inject HTTP parameters, we " +"need to define a binding type:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:482 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"public @interface HttpParam {\n" +" @NonBinding public String value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:484 +#, no-c-format +msgid "We would use this binding type at injection points as follows:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:486 +#, no-c-format +msgid "" +"<![CDATA[@HttpParam(\"username\") String username;\n" +"@HttpParam(\"password\") String password;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:488 +#, no-c-format +msgid "The following producer method does the work:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:490 +#, no-c-format +msgid "" +"<![CDATA[class HttpParams\n" +"\n" +" @Produces @HttpParam(\"\")\n" +" String getParamValue(ServletRequest request, InjectionPoint ip) {\n" +" return request.getParameter(ip.getAnnotation(HttpParam.class).value" +"());\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:492 +#, no-c-format +msgid "" +"(Note that the <literal>value()</literal> member of the <literal>HttpParam</" +"literal> annotation is ignored by the Web Bean manager since it is annotated " +"<literal>@NonBinding.</literal>)" +msgstr "" + +#. Tag: para +#: injection.xml:495 +#, no-c-format +msgid "" +"The Web Bean manager provides a built-in Web Bean that implements the " +"<literal>InjectionPoint</literal> interface:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:498 +#, no-c-format +msgid "" +"<![CDATA[public interface InjectionPoint { \n" +" public Object getInstance(); \n" +" public Bean<?> getBean(); \n" +" public Member getMember(): \n" +" public <T extends Annotation> T getAnnotation(Class<T> annotation); \n" +" public Set<T extends Annotation> getAnnotations(); \n" +"}]]>" +msgstr "" Added: doc/trunk/reference/it-IT/modules/interceptors.po =================================================================== --- doc/trunk/reference/it-IT/modules/interceptors.po (rev 0) +++ doc/trunk/reference/it-IT/modules/interceptors.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,572 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: interceptors.xml:4 +#, no-c-format +msgid "Interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:6 +#, no-c-format +msgid "" +"Web Beans re-uses the basic interceptor architecture of EJB 3.0, extending " +"the functionality in two directions:" +msgstr "" + +#. Tag: para +#: interceptors.xml:11 +#, no-c-format +msgid "Any Web Bean may have interceptors, not just session beans." +msgstr "" + +#. Tag: para +#: interceptors.xml:14 +#, no-c-format +msgid "" +"Web Beans features a more sophisticated annotation-based approach to binding " +"interceptors to Web Beans." +msgstr "" + +#. Tag: para +#: interceptors.xml:22 +#, no-c-format +msgid "The EJB specification defines two kinds of interception points:" +msgstr "" + +#. Tag: para +#: interceptors.xml:26 +#, no-c-format +msgid "business method interception, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:29 +#, no-c-format +msgid "lifecycle callback interception." +msgstr "" + +#. Tag: para +#: interceptors.xml:33 +#, no-c-format +msgid "" +"A <emphasis>business method interceptor</emphasis> applies to invocations of " +"methods of the Web Bean by clients of the Web Bean:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:36 +#, no-c-format +msgid "" +"<![CDATA[public class TransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:38 +#, no-c-format +msgid "" +"A <emphasis>lifecycle callback interceptor</emphasis> applies to invocations " +"of lifecycle callbacks by the container:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:41 +#, no-c-format +msgid "" +"<![CDATA[public class DependencyInjectionInterceptor {\n" +" @PostConstruct public void injectDependencies(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:43 +#, no-c-format +msgid "" +"An interceptor class may intercept both lifecycle callbacks and business " +"methods." +msgstr "" + +#. Tag: title +#: interceptors.xml:49 +#, no-c-format +msgid "Interceptor bindings" +msgstr "" + +#. Tag: para +#: interceptors.xml:51 +#, no-c-format +msgid "" +"Suppose we want to declare that some of our Web Beans are transactional. The " +"first thing we need is an <emphasis>interceptor binding annotation</" +"emphasis> to specify exactly which Web Beans we're interested in:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:55 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Transactional {}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:57 +#, no-c-format +msgid "" +"Now we can easily specify that our <literal>ShoppingCart</literal> is a " +"transactional object:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:60 +#, no-c-format +msgid "" +"<![CDATA[@Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:62 +#, no-c-format +msgid "Or, if we prefer, we can specify that just one method is transactional:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:64 +#, no-c-format +msgid "" +"<![CDATA[public class ShoppingCart {\n" +" @Transactional public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:69 +#, no-c-format +msgid "Implementing interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:71 +#, no-c-format +msgid "" +"That's great, but somewhere along the line we're going to have to actually " +"implement the interceptor that provides this transaction management aspect. " +"All we need to do is create a standard EJB interceptor, and annotate it " +"<literal>@Interceptor</literal> and <literal>@Transactional</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:76 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:78 +#, no-c-format +msgid "" +"All Web Beans interceptors are simple Web Beans, and can take advantage of " +"dependency injection and contextual lifecycle management." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:81 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +"\n" +" @Resource Transaction transaction;\n" +"\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:83 +#, no-c-format +msgid "Multiple interceptors may use the same interceptor binding type." +msgstr "" + +#. Tag: title +#: interceptors.xml:88 +#, no-c-format +msgid "Enabling interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:90 +#, no-c-format +msgid "" +"Finally, we need to <emphasis>enable</emphasis> our interceptor in " +"<literal>web-beans.xml</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:93 +#, no-c-format +msgid "" +"<![CDATA[<Interceptors>\n" +" <tx:TransactionInterceptor/>\n" +"</Interceptors>]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:95 +#, no-c-format +msgid "Whoah! Why the angle bracket stew?" +msgstr "" + +#. Tag: para +#: interceptors.xml:97 +#, no-c-format +msgid "Well, the XML declaration solves two problems:" +msgstr "" + +#. Tag: para +#: interceptors.xml:101 +#, no-c-format +msgid "" +"it enables us to specify a total ordering for all the interceptors in our " +"system, ensuring deterministic behavior, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:105 +#, no-c-format +msgid "it lets us enable or disable interceptor classes at deployment time." +msgstr "" + +#. Tag: para +#: interceptors.xml:109 +#, no-c-format +msgid "" +"For example, we could specify that our security interceptor runs before our " +"<literal>TransactionInterceptor</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:112 +#, no-c-format +msgid "" +"<![CDATA[<Interceptors>\n" +" <sx:SecurityInterceptor/>\n" +" <tx:TransactionInterceptor/>\n" +"</Interceptors>]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:114 +#, no-c-format +msgid "Or we could turn them both off in our test environment!" +msgstr "" + +#. Tag: title +#: interceptors.xml:119 +#, no-c-format +msgid "Interceptor bindings with members" +msgstr "" + +#. Tag: para +#: interceptors.xml:121 +#, no-c-format +msgid "" +"Suppose we want to add some extra information to our " +"<literal>@Transactional</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:124 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Transactional {\n" +" boolean requiresNew() default false;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:126 +#, no-c-format +msgid "" +"Web Beans will use the value of <literal>requiresNew</literal> to choose " +"between two different interceptors, <literal>TransactionInterceptor</" +"literal> and <literal>RequiresNewTransactionInterceptor</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:130 +#, no-c-format +msgid "" +"<![CDATA[@Transactional(requiresNew=true) @Interceptor\n" +"public class RequiresNewTransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:132 +#, no-c-format +msgid "" +"Now we can use <literal>RequiresNewTransactionInterceptor</literal> like " +"this:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:134 +#, no-c-format +msgid "" +"<![CDATA[@Transactional(requiresNew=true)\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:136 +#, no-c-format +msgid "" +"But what if we only have one interceptor and we want the manager to ignore " +"the value of <literal>requiresNew</literal> when binding interceptors? We " +"can use the <literal>@NonBinding</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:140 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Secure {\n" +" @NonBinding String[] rolesAllowed() default {};\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:145 +#, no-c-format +msgid "Multiple interceptor binding annotations" +msgstr "" + +#. Tag: para +#: interceptors.xml:147 +#, no-c-format +msgid "" +"Usually we use combinations of interceptor bindings types to bind multiple " +"interceptors to a Web Bean. For example, the following declaration would be " +"used to bind <literal>TransactionInterceptor</literal> and " +"<literal>SecurityInterceptor</literal> to the same Web Bean:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:152 +#, no-c-format +msgid "" +"<![CDATA[@Secure(rolesAllowed=\"admin\") @Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:154 +#, no-c-format +msgid "" +"However, in very complex cases, an interceptor itself may specify some " +"combination of interceptor binding types:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:157 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure @Interceptor\n" +"public class TransactionalSecureInterceptor { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:159 +#, no-c-format +msgid "" +"Then this interceptor could be bound to the <literal>checkout()</literal> " +"method using any one of the following combinations:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:162 +#, no-c-format +msgid "" +"<![CDATA[public class ShoppingCart {\n" +" @Transactional @Secure public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:164 +#, no-c-format +msgid "" +"<![CDATA[@Secure\n" +"public class ShoppingCart {\n" +" @Transactional public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:166 +#, no-c-format +msgid "" +"<![CDATA[@Transactionl\n" +"public class ShoppingCart {\n" +" @Secure public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:168 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure\n" +"public class ShoppingCart {\n" +" public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:173 +#, no-c-format +msgid "Interceptor binding type inheritance" +msgstr "" + +#. Tag: para +#: interceptors.xml:175 +#, no-c-format +msgid "" +"One limitation of the Java language support for annotations is the lack of " +"annotation inheritance. Really, annotations should have reuse built in, to " +"allow this kind of thing to work:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:179 +#, no-c-format +msgid "" +"<![CDATA[public @interface Action extends Transactional, Secure { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:181 +#, no-c-format +msgid "" +"Well, fortunately, Web Beans works around this missing feature of Java. We " +"may annotate one interceptor binding type with other interceptor binding " +"types. The interceptor bindings are transitiveany Web Bean with the " +"first interceptor binding inherits the interceptor bindings declared as meta-" +"annotations." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:186 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure\n" +"@InterceptorBindingType\n" +"@Target(TYPE)\n" +"@Retention(RUNTIME)\n" +"public @interface Action { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:188 +#, no-c-format +msgid "" +"Any Web Bean annotated <literal>@Action</literal> will be bound to both " +"<literal>TransactionInterceptor</literal> and <literal>SecurityInterceptor</" +"literal>. (And even <literal>TransactionalSecureInterceptor</literal>, if it " +"exists.)" +msgstr "" + +#. Tag: title +#: interceptors.xml:195 +#, no-c-format +msgid "Use of <literal>@Interceptors</literal>" +msgstr "" + +#. Tag: para +#: interceptors.xml:197 +#, no-c-format +msgid "" +"The <literal>@Interceptors</literal> annotation defined by the EJB " +"specification is supported for both enterprise and simple Web Beans, for " +"example:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:200 +#, no-c-format +msgid "" +"<![CDATA[(a)Interceptors({TransactionInterceptor.class, @SecurityInterceptor." +"class})\n" +"public class ShoppingCart {\n" +" public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:202 +#, no-c-format +msgid "However, this approach suffers the following drawbacks:" +msgstr "" + +#. Tag: para +#: interceptors.xml:206 +#, no-c-format +msgid "the interceptor implementation is hardcoded in business code," +msgstr "" + +#. Tag: para +#: interceptors.xml:209 +#, no-c-format +msgid "interceptors may not be easily disabled at deployment time, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:212 +#, no-c-format +msgid "" +"the interceptor ordering is non-globalit is determined by the order in " +"which interceptors are listed at the class level." +msgstr "" + +#. Tag: para +#: interceptors.xml:217 +#, no-c-format +msgid "" +"Therefore, we recommend the use of Web Beans-style interceptor bindings." +msgstr "" Added: doc/trunk/reference/it-IT/modules/intro.po =================================================================== --- doc/trunk/reference/it-IT/modules/intro.po (rev 0) +++ doc/trunk/reference/it-IT/modules/intro.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,1075 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: intro.xml:4 +#, no-c-format +msgid "Getting started with Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:6 +#, no-c-format +msgid "" +"So you're already keen to get started writing your first Web Bean? Or " +"perhaps you're skeptical, wondering what kinds of hoops the Web Beans " +"specification will make you jump through! The good news is that you've " +"probably already written and used hundreds, perhaps thousands of Web Beans. " +"You might not even remember the first Web Bean you wrote." +msgstr "" + +#. Tag: title +#: intro.xml:13 +#, no-c-format +msgid "Your first Web Bean" +msgstr "" + +#. Tag: para +#: intro.xml:15 +#, no-c-format +msgid "" +"With certain, very special exceptions, every Java class with a constructor " +"that accepts no parameters is a Web Bean. That includes every JavaBean. " +"Furthermore, every EJB 3-style session bean is a Web Bean. Sure, the " +"JavaBeans and EJBs you've been writing every day have not been able to take " +"advantage of the new services defined by the Web Beans specification, but " +"you'll be able to use every one of them as Web Beansinjecting them " +"into other Web Beans, configuring them via the Web Beans XML configuration " +"facility, even adding interceptors and decorators to themwithout " +"touching your existing code." +msgstr "" + +#. Tag: para +#: intro.xml:25 +#, no-c-format +msgid "" +"Suppose that we have two existing Java classes, that we've been using for " +"years in various applications. The first class parses a string into a list " +"of sentences:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:29 +#, no-c-format +msgid "" +"<![CDATA[public class SentenceParser {\n" +" public List<String> parse(String text) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:31 +#, no-c-format +msgid "" +"The second existing class is a stateless session bean front-end for an " +"external system that is able to translate sentences from one language to " +"another:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:35 +#, no-c-format +msgid "" +"<![CDATA[@Stateless\n" +"public class SentenceTranslator implements Translator {\n" +" public String translate(String sentence) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:37 +#, no-c-format +msgid "Where <literal>Translator</literal> is the local interface:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:39 +#, no-c-format +msgid "" +"<![CDATA[@Local\n" +"public interface Translator {\n" +" public String translate(String sentence);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:41 +#, no-c-format +msgid "" +"Unfortunately, we don't have a preexisting class that translates whole text " +"documents. So let's write a Web Bean that does this job:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:44 +#, no-c-format +msgid "" +"<![CDATA[public class TextTranslator {\n" +" \n" +" private SentenceParser sentenceParser;\n" +" private Translator sentenceTranslator;\n" +" \n" +" @Initializer\n" +" TextTranslator(SentenceParser sentenceParser, Translator " +"sentenceTranslator) {\n" +" this.sentenceParser = sentenceParser;\n" +" this.sentenceTranslator = sentenceTranslator;\n" +" }\n" +" \n" +" public String translate(String text) {\n" +" StringBuilder sb = new StringBuilder();\n" +" for (String sentence: sentenceParser.parse(text)) {\n" +" sb.append(sentenceTranslator.translate(sentence));\n" +" }\n" +" return sb.toString();\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:46 +#, no-c-format +msgid "" +"We may obtain an instance of <literal>TextTranslator</literal> by injecting " +"it into a Web Bean, Servlet or EJB:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:49 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public setTextTranslator(TextTranslator textTranslator) {\n" +" this.textTranslator = textTranslator;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:51 +#, no-c-format +msgid "" +"Alternatively, we may obtain an instance by directly calling a method of the " +"Web Bean manager:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:54 +#, no-c-format +msgid "" +"<![CDATA[TextTranslator tt = manager.getInstanceByType(TextTranslator." +"class);]]>" +msgstr "" + +#. Tag: para +#: intro.xml:56 +#, no-c-format +msgid "" +"But wait: <literal>TextTranslator</literal> does not have a constructor with " +"no parameters! Is it still a Web Bean? Well, a class that does not have a " +"constructor with no parameters can still be a Web Bean if it has a " +"constructor annotated <literal>@Initializer</literal>." +msgstr "" + +#. Tag: para +#: intro.xml:61 +#, no-c-format +msgid "" +"As you've guessed, the <literal>@Initializer</literal> annotation has " +"something to do with dependency injection! <literal>@Initializer</literal> " +"may be applied to a constructor or method of a Web Bean, and tells the Web " +"Bean manager to call that constructor or method when instantiating the Web " +"Bean. The Web Bean manager will inject other Web Beans to the parameters of " +"the constructor or method." +msgstr "" + +#. Tag: para +#: intro.xml:68 +#, no-c-format +msgid "" +"At system initialization time, the Web Bean manager must validate that " +"exactly one Web Bean exists which satisfies each injection point. In our " +"example, if no implementation of <literal>Translator</literal> " +"availableif the <literal>SentenceTranslator</literal> EJB was not " +"deployedthe Web Bean manager would throw an " +"<literal>UnsatisfiedDependencyException</literal>. If more than one " +"implementation of <literal>Translator</literal> was available, the Web Bean " +"manager would throw an <literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: title +#: intro.xml:80 +#, no-c-format +msgid "What is a Web Bean?" +msgstr "" + +#. Tag: para +#: intro.xml:82 +#, no-c-format +msgid "So what, <emphasis>exactly</emphasis>, is a Web Bean?" +msgstr "" + +#. Tag: para +#: intro.xml:84 +#, no-c-format +msgid "" +"A Web Bean is an application class that contains business logic. A Web Bean " +"may be called directly from Java code, or it may be invoked via Unified EL. " +"A Web Bean may access transactional resources. Dependencies between Web " +"Beans are managed automatically by the Web Bean manager. Most Web Beans are " +"<emphasis>stateful</emphasis> and <emphasis>contextual</emphasis>. The " +"lifecycle of a Web Bean is always managed by the Web Bean manager." +msgstr "" + +#. Tag: para +#: intro.xml:91 +#, no-c-format +msgid "" +"Let's back up a second. What does it really mean to be \"contextual\"? Since " +"Web Beans may be stateful, it matters <emphasis>which</emphasis> bean " +"instance I have. Unlike a stateless component model (for example, stateless " +"session beans) or a singleton component model (such as servlets, or " +"singleton beans), different clients of a Web Bean see the Web Bean in " +"different states. The client-visible state depends upon which instance of " +"the Web Bean the client has a reference to." +msgstr "" + +#. Tag: para +#: intro.xml:98 +#, no-c-format +msgid "" +"However, like a stateless or singleton model, but <emphasis>unlike</" +"emphasis> stateful session beans, the client does not control the lifecycle " +"of the instance by explicitly creating and destroying it. Instead, the " +"<emphasis>scope</emphasis> of the Web Bean determines:" +msgstr "" + +#. Tag: para +#: intro.xml:105 +#, no-c-format +msgid "the lifecycle of each instance of the Web Bean and" +msgstr "" + +#. Tag: para +#: intro.xml:108 +#, no-c-format +msgid "" +"which clients share a reference to a particular instance of the Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:113 +#, no-c-format +msgid "" +"For a given thread in a Web Beans application, there may be an " +"<emphasis>active context</emphasis> associated with the scope of the Web " +"Bean. This context may be unique to the thread (for example, if the Web Bean " +"is request scoped), or it may be shared with certain other threads (for " +"example, if the Web Bean is session scoped) or even all other threads (if it " +"is application scoped)." +msgstr "" + +#. Tag: para +#: intro.xml:119 +#, no-c-format +msgid "" +"Clients (for example, other Web Beans) executing in the same context will " +"see the same instance of the Web Bean. But clients in a different context " +"will see a different instance." +msgstr "" + +#. Tag: para +#: intro.xml:123 +#, no-c-format +msgid "" +"One great advantage of the contextual model is that it allows stateful Web " +"Beans to be treated like services! The client need not concern itself with " +"managing the lifecycle of the Web Bean it is using, <emphasis>nor does it " +"even need to know what that lifecyle is.</emphasis> Web Beans interact by " +"passing messages, and the Web Bean implementations define the lifecycle of " +"their own state. The Web Beans are loosely coupled because:" +msgstr "" + +#. Tag: para +#: intro.xml:132 +#, no-c-format +msgid "they interact via well-defined public APIs" +msgstr "" + +#. Tag: para +#: intro.xml:135 +#, no-c-format +msgid "their lifecycles are completely decoupled" +msgstr "" + +#. Tag: para +#: intro.xml:139 +#, no-c-format +msgid "" +"We can replace one Web Bean with a different Web Bean that implements the " +"same API and has a different lifecycle (a different scope) without affecting " +"the other Web Bean implementation. In fact, Web Beans defines a " +"sophisticated facility for overriding Web Bean implementations at deployment " +"time, as we will see in <xref linkend=\"deploymenttypes\"/>." +msgstr "" + +#. Tag: para +#: intro.xml:145 +#, no-c-format +msgid "" +"Note that not all clients of a Web Bean are Web Beans. Other objects such as " +"Servlets or Message-Driven Beanswhich are by nature not injectable, " +"contextual objectsmay also obtain references to Web Beans by injection." +msgstr "" + +#. Tag: para +#: intro.xml:149 +#, no-c-format +msgid "Enough hand-waving. More formally, according to the spec:" +msgstr "" + +#. Tag: para +#: intro.xml:153 +#, no-c-format +msgid "A Web Bean comprises:" +msgstr "" + +#. Tag: para +#: intro.xml:156 +#, no-c-format +msgid "A (nonempty) set of API types" +msgstr "" + +#. Tag: para +#: intro.xml:157 +#, no-c-format +msgid "A (nonempty) set of binding annotation types" +msgstr "" + +#. Tag: para +#: intro.xml:158 +#, no-c-format +msgid "A scope" +msgstr "" + +#. Tag: para +#: intro.xml:159 +#, no-c-format +msgid "A deployment type" +msgstr "" + +#. Tag: para +#: intro.xml:160 +#, no-c-format +msgid "Optionally, a Web Bean name" +msgstr "" + +#. Tag: para +#: intro.xml:161 +#, no-c-format +msgid "A set of interceptor binding types" +msgstr "" + +#. Tag: para +#: intro.xml:162 +#, no-c-format +msgid "A Web Bean implementation" +msgstr "" + +#. Tag: para +#: intro.xml:167 +#, no-c-format +msgid "Let's see what some of these terms mean, to the Web Bean developer." +msgstr "" + +#. Tag: title +#: intro.xml:170 +#, no-c-format +msgid "API types, binding types and dependency injection" +msgstr "" + +#. Tag: para +#: intro.xml:172 +#, no-c-format +msgid "" +"Web Beans usually acquire references to other Web Beans via dependency " +"injection. Any injected attribute specifies a \"contract\" that must be " +"satisfied by the Web Bean to be injected. The contract is:" +msgstr "" + +#. Tag: para +#: intro.xml:177 +#, no-c-format +msgid "an API type, together with" +msgstr "" + +#. Tag: para +#: intro.xml:178 +#, no-c-format +msgid "a set of binding types." +msgstr "" + +#. Tag: para +#: intro.xml:181 +#, no-c-format +msgid "" +"An API is a user-defined class or interface. (If the Web Bean is an EJB " +"session bean, the API type is the <literal>@Local</literal> interface or " +"bean-class local view). A binding type represents some client-visible " +"semantic that is satisfied by some implementations of the API and not by " +"others." +msgstr "" + +#. Tag: para +#: intro.xml:186 +#, no-c-format +msgid "" +"Binding types are represented by user-defined annotations that are " +"themselves annotated <literal>@BindingType</literal>. For example, the " +"following injection point has API type <literal>PaymentProcessor</literal> " +"and binding type <literal>@CreditCard</literal>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:191 +#, no-c-format +msgid "<![CDATA[@CreditCard PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: intro.xml:193 +#, no-c-format +msgid "" +"If no binding type is explicitly specified at an injection point, the " +"default binding type <literal>@Current</literal> is assumed." +msgstr "" + +#. Tag: para +#: intro.xml:196 +#, no-c-format +msgid "" +"For each injection point, the Web Bean manager searches for a Web Bean which " +"satisfies the contract (implements the API, and has all the binding types), " +"and injects that Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:200 +#, no-c-format +msgid "" +"The following Web Bean has the binding type <literal>@CreditCard</literal> " +"and implements the API type <literal>PaymentProcessor</literal>. It could " +"therefore be injected to the example injection point:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:204 +#, no-c-format +msgid "" +"<![CDATA[@CreditCard\n" +"public class CreditCardPaymentProcessor \n" +" implements PaymentProcessor { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:206 +#, no-c-format +msgid "" +"If a Web Bean does not explicitly specify a set of binding types, it has " +"exactly one binding type: the default binding type <literal>@Current</" +"literal>." +msgstr "" + +#. Tag: para +#: intro.xml:209 +#, no-c-format +msgid "" +"Web Beans defines a sophisticated but intuitive <emphasis>resolution " +"algorithm</emphasis> that helps the container decide what to do if there is " +"more than one Web Bean that satisfies a particular contract. We'll get into " +"the details in <xref linkend=\"injection\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:217 +#, no-c-format +msgid "Deployment types" +msgstr "" + +#. Tag: para +#: intro.xml:219 +#, no-c-format +msgid "" +"<emphasis>Deployment types</emphasis> let us classify our Web Beans by " +"deployment scenario. A deployment type is an annotation that represents a " +"particular deployment scenario, for example <literal>@Mock</literal>, " +"<literal>@Staging</literal> or <literal>@AustralianTaxLaw</literal>. We " +"apply the annotation to Web Beans which should be deployed in that scenario. " +"A deployment type allows a whole set of Web Beans to be conditionally " +"deployed, with a just single line of configuration." +msgstr "" + +#. Tag: para +#: intro.xml:226 +#, no-c-format +msgid "" +"Many Web Beans just use the default deployment type <literal>@Production</" +"literal>, in which case no deployment type need be explicitly specified. All " +"three Web Bean in our example have the deployment type <literal>@Production</" +"literal>." +msgstr "" + +#. Tag: para +#: intro.xml:230 +#, no-c-format +msgid "" +"In a testing environment, we might want to replace the " +"<literal>SentenceTranslator</literal> Web Bean with a \"mock object\":" +msgstr "" + +#. Tag: programlisting +#: intro.xml:233 +#, no-c-format +msgid "" +"<![CDATA[@Mock\n" +"public class MockSentenceTranslator implements Translator {\n" +" public String translate(String sentence) {\n" +" return \"Lorem ipsum dolor sit amet\";\n" +" }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:236 +#, no-c-format +msgid "" +"We would enable the deployment type <literal>@Mock</literal> in our testing " +"environment, to indicate that <literal>MockSentenceTranslator</literal> and " +"any other Web Bean annotated <literal>@Mock</literal> should be used." +msgstr "" + +#. Tag: para +#: intro.xml:240 +#, no-c-format +msgid "" +"We'll talk more about this unique and powerful feature in <xref linkend=" +"\"deploymenttypes\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:246 +#, no-c-format +msgid "Scope" +msgstr "" + +#. Tag: para +#: intro.xml:248 +#, no-c-format +msgid "" +"The <emphasis>scope</emphasis> defines the lifecycle and visibility of " +"instances of the Web Bean. The Web Beans context model is extensible, " +"accommodating arbitrary scopes. However, certain important scopes are built-" +"in to the specification, and provided by the Web Bean manager. A scope is " +"represented by an annotation type." +msgstr "" + +#. Tag: para +#: intro.xml:254 +#, no-c-format +msgid "" +"For example, any web application may have <emphasis>session scoped</" +"emphasis> Web Beans:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:257 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:259 +#, no-c-format +msgid "" +"An instance of a session scoped Web Bean is bound to a user session and is " +"shared by all requests that execute in the context of that session." +msgstr "" + +#. Tag: para +#: intro.xml:262 +#, no-c-format +msgid "" +"By default, Web Beans belong to a special scope called the " +"<emphasis>dependent pseudo-scope</emphasis>. Web Beans with this scope are " +"pure dependent objects of the object into which they are injected, and their " +"lifecycle is bound to the lifecycle of that object." +msgstr "" + +#. Tag: para +#: intro.xml:267 +#, no-c-format +msgid "We'll talk more about scopes in <xref linkend=\"scopescontexts\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:272 +#, no-c-format +msgid "Web Bean names and Unified EL" +msgstr "" + +#. Tag: para +#: intro.xml:274 +#, no-c-format +msgid "" +"A Web Bean may have a <emphasis>name</emphasis>, allowing it to be used in " +"Unified EL expressions. It's easy to specify the name of a Web Bean:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:278 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named(\"cart\")\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:280 +#, no-c-format +msgid "Now we can easily use the Web Bean in any JSF or JSP page:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:282 +#, no-c-format +msgid "" +"<![CDATA[<h:dataTable value=\"#{cart.lineItems}\" var=\"item\">\n" +" ....\n" +"</h:dataTable>]]>" +msgstr "" + +#. Tag: para +#: intro.xml:284 +#, no-c-format +msgid "" +"It's even easier to just let the name be defaulted by the Web Bean manager:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:287 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:289 +#, no-c-format +msgid "" +"In this case, the name defaults to <literal>shoppingCart</literal>the " +"unqualified class name, with the first character changed to lowercase." +msgstr "" + +#. Tag: title +#: intro.xml:295 +#, no-c-format +msgid "Interceptor binding types" +msgstr "" + +#. Tag: para +#: intro.xml:297 +#, no-c-format +msgid "" +"Web Beans supports the interceptor functionality defined by EJB 3, not only " +"for EJB beans, but also for plain Java classes. In addition, Web Beans " +"provides a new approach to binding interceptors to EJB beans and other Web " +"Beans." +msgstr "" + +#. Tag: para +#: intro.xml:302 +#, no-c-format +msgid "" +"It remains possible to directly specify the interceptor class via use of the " +"<literal>@Interceptors</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:305 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped \n" +"@Interceptors(TransactionInterceptor.class)\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:307 +#, no-c-format +msgid "" +"However, it is more elegant, and better practice, to indirect the " +"interceptor binding through an <emphasis>interceptor binding type</emphasis>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:311 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:313 +#, no-c-format +msgid "" +"We'll discuss Web Beans interceptors and decorators in <xref linkend=" +"\"interceptors\"/> and <xref linkend=\"decorators\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:321 +#, no-c-format +msgid "What kinds of objects can be Web Beans?" +msgstr "" + +#. Tag: para +#: intro.xml:323 +#, no-c-format +msgid "" +"We've already seen that JavaBeans, EJBs and some other Java classes can be " +"Web Beans. But exactly what kinds of objects are Web Beans?" +msgstr "" + +#. Tag: title +#: intro.xml:327 +#, no-c-format +msgid "Simple Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:329 +#, no-c-format +msgid "" +"The Web Beans specification says that a concrete Java class is a " +"<emphasis>simple</emphasis> Web Bean if:" +msgstr "" + +#. Tag: para +#: intro.xml:334 +#, no-c-format +msgid "" +"it is not an EE container-managed component, like an EJB, a Servlet or a JPA " +"entity," +msgstr "" + +#. Tag: para +#: intro.xml:338 +#, no-c-format +msgid "it is not a non-static static inner class," +msgstr "" + +#. Tag: para +#: intro.xml:341 +#, no-c-format +msgid "it is not a parameterized type, and" +msgstr "" + +#. Tag: para +#: intro.xml:344 +#, no-c-format +msgid "" +"it has a constructor with no parameters, or a constructor annotated " +"<literal>@Initializer</literal>." +msgstr "" + +#. Tag: para +#: intro.xml:349 +#, no-c-format +msgid "Thus, almost every JavaBean is a simple Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:351 +#, no-c-format +msgid "" +"Every interface implemented directly or indirectly by a simple Web Bean is " +"an API type of the simple Web Bean. The class and its superclasses are also " +"API types." +msgstr "" + +#. Tag: title +#: intro.xml:358 +#, no-c-format +msgid "Enterprise Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:360 +#, no-c-format +msgid "" +"The specification says that all EJB 3-style session and singleton beans are " +"<emphasis>enterprise</emphasis> Web Beans. Message driven beans are not Web " +"Beanssince they are not intended to be injected into other " +"objectsbut they can take advantage of most of the functionality of Web " +"Beans, including dependency injection and interceptors." +msgstr "" + +#. Tag: para +#: intro.xml:366 +#, no-c-format +msgid "" +"Every local interface of an enterprise Web Bean that does not have a " +"wildcard type parameter or type variable, and every one of its " +"superinterfaces, is an API type of the enterprise Web Bean. If the EJB bean " +"has a bean class local view, the bean class, and every one of its " +"superclasses, is also an API type." +msgstr "" + +#. Tag: para +#: intro.xml:372 +#, no-c-format +msgid "" +"Stateful session beans should declare a remove method with no parameters or " +"a remove method annotated <literal>@Destructor</literal>. The Web Bean " +"manager calls this method to destroy the stateful session bean instance at " +"the end of its lifecycle. This method is called the <emphasis>destructor</" +"emphasis> method of the enterprise Web Bean." +msgstr "" + +#. Tag: programlisting +#: intro.xml:378 +#, no-c-format +msgid "" +"<![CDATA[@Stateful @SessionScoped\n" +"public class ShoppingCart {\n" +"\n" +" ...\n" +" \n" +" @Remove\n" +" public void destroy() {}\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:380 +#, no-c-format +msgid "" +"So when should we use an enterprise Web Bean instead of a simple Web Bean? " +"Well, whenever we need the advanced enterprise services offered by EJB, such " +"as:" +msgstr "" + +#. Tag: para +#: intro.xml:387 +#, no-c-format +msgid "method-level transaction management and security," +msgstr "" + +#. Tag: para +#: intro.xml:390 +#, no-c-format +msgid "concurrency management," +msgstr "" + +#. Tag: para +#: intro.xml:393 +#, no-c-format +msgid "" +"instance-level passivation for stateful session beans and instance-pooling " +"for stateless session beans," +msgstr "" + +#. Tag: para +#: intro.xml:397 +#, no-c-format +msgid "remote and web service invocation, and" +msgstr "" + +#. Tag: para +#: intro.xml:400 +#, no-c-format +msgid "timers and asynchronous methods," +msgstr "" + +#. Tag: para +#: intro.xml:404 +#, no-c-format +msgid "" +"we should use an enterprise Web Bean. When we don't need any of these " +"things, a simple Web Bean will serve just fine." +msgstr "" + +#. Tag: para +#: intro.xml:407 +#, no-c-format +msgid "" +"Many Web Beans (including any session or application scoped Web Bean) are " +"available for concurrent access. Therefore, the concurrency management " +"provided by EJB 3.1 is especially useful. Most session and application " +"scoped Web Beans should be EJBs." +msgstr "" + +#. Tag: para +#: intro.xml:412 +#, no-c-format +msgid "" +"Web Beans which hold references to heavy-weight resources, or hold a lot of " +"internal state benefit from the advanced container-managed lifecycle defined " +"by the EJB <literal>@Stateless</literal>/<literal>@Stateful</literal>/" +"<literal>@Singleton</literal> model, with its support for passivation and " +"instance pooling." +msgstr "" + +#. Tag: para +#: intro.xml:417 +#, no-c-format +msgid "" +"Finally, it's usually obvious when method-level transaction management, " +"method-level security, timers, remote methods or asynchronous methods are " +"needed." +msgstr "" + +#. Tag: para +#: intro.xml:420 +#, no-c-format +msgid "" +"It's usually easy to start with simple Web Bean, and then turn it into an " +"EJB, just by adding an annotation: <literal>@Stateless</literal>, " +"<literal>@Stateful</literal> or <literal>@Singleton</literal>." +msgstr "" + +#. Tag: title +#: intro.xml:427 +#, no-c-format +msgid "Producer methods" +msgstr "" + +#. Tag: para +#: intro.xml:429 +#, no-c-format +msgid "" +"A <emphasis>producer method</emphasis> is a method that is called by the Web " +"Bean manager to obtain an instance of the Web Bean when no instance exists " +"in the current context. A producer method lets the application take full " +"control of the instantiation process, instead of leaving instantiation to " +"the Web Bean manager. For example:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:435 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped\n" +"public class Generator {\n" +"\n" +" private Random random = new Random( System.currentTimeMillis() );\n" +" \n" +" @Produces @Random int next() {\n" +" return random.nextInt(100);\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:437 +#, no-c-format +msgid "" +"The result of a producer method is injected just like any other Web Bean." +msgstr "" + +#. Tag: programlisting +#: intro.xml:439 +#, no-c-format +msgid "<![CDATA[@Random int randomNumber]]>" +msgstr "" + +#. Tag: para +#: intro.xml:441 +#, no-c-format +msgid "" +"The method return type and all interfaces it extends/implements directly or " +"indirectly are API types of the producer method. If the return type is a " +"class, all superclasses are also API types." +msgstr "" + +#. Tag: para +#: intro.xml:445 +#, no-c-format +msgid "Some producer methods return objects that require explicit destruction:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:447 +#, no-c-format +msgid "" +"<![CDATA[@Produces @RequestScoped Connection connect(User user) {\n" +" return createConnection( user.getId(), user.getPassword() );\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:449 +#, no-c-format +msgid "" +"These producer methods may define matching <emphasis>disposal methods</" +"emphasis>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:451 +#, no-c-format +msgid "" +"<![CDATA[void close(@Disposes Connection connection) {\n" +" connection.close();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:453 +#, no-c-format +msgid "" +"This disposal method is called automatically by the Web Bean manager at the " +"end of the request." +msgstr "" + +#. Tag: para +#: intro.xml:456 +#, no-c-format +msgid "" +"We'll talk much more about producer methods in <xref linkend=" +"\"producermethods\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:461 +#, no-c-format +msgid "JMS endpoints" +msgstr "" + +#. Tag: para +#: intro.xml:463 +#, no-c-format +msgid "" +"Finally, a JMS queue or topic can be a Web Bean. Web Beans relieves the " +"developer from the tedium of managing the lifecycles of all the various JMS " +"objects required to send messages to queues and topics. We'll discuss JMS " +"endpoints in <xref linkend=\"jms\"/>." +msgstr "" Added: doc/trunk/reference/it-IT/modules/next.po =================================================================== --- doc/trunk/reference/it-IT/modules/next.po (rev 0) +++ doc/trunk/reference/it-IT/modules/next.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,49 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: next.xml:4 +#, no-c-format +msgid "Next steps" +msgstr "" + +#. Tag: para +#: next.xml:6 +#, no-c-format +msgid "" +"Because Web Beans is so new, there's not yet a lot of information available " +"online." +msgstr "" + +#. Tag: para +#: next.xml:9 +#, no-c-format +msgid "" +"Of course, the Web Beans specification is the best source of more " +"information about Web Beans. The spec is about 100 pages long, only twice " +"the length of this article, and almost as readable. But, of course, it " +"covers many details that we've skipped over. The spec is available from " +"<literal>http://jcp.org/en/jsr/detail?id=299</literal>." +msgstr "" + +#. Tag: para +#: next.xml:15 +#, no-c-format +msgid "" +"The Web Beans Reference implementation is being developed at <literal>http://" +"seamframework.org/WebBeans</literal>. The RI development team and the Web " +"Beans spec lead blog at <literal>http://in.relation.to</literal>. This " +"article is substantially based upon a series of blog entries published there." +msgstr "" Added: doc/trunk/reference/it-IT/modules/part1.po =================================================================== --- doc/trunk/reference/it-IT/modules/part1.po (rev 0) +++ doc/trunk/reference/it-IT/modules/part1.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,229 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part1.xml:5 +#, no-c-format +msgid "" +"The Web Beans (JSR-299) specification defines a set of services for the Java " +"EE environment that makes applications much easier to develop. Web Beans " +"layers an enhanced lifecycle and interaction model over existing Java " +"component types including JavaBeans and Enterprise Java Beans. As a " +"complement to the traditional Java EE programming model, the Web Beans " +"services provide:" +msgstr "" + +#. Tag: para +#: part1.xml:14 +#, no-c-format +msgid "" +"an improved lifecycle for stateful components, bound to well-defined " +"<emphasis>contexts</emphasis>," +msgstr "" + +#. Tag: para +#: part1.xml:18 +#, no-c-format +msgid "a typesafe approach to <emphasis>dependency injection</emphasis>," +msgstr "" + +#. Tag: para +#: part1.xml:21 +#, no-c-format +msgid "" +"interaction via an <emphasis>event notification</emphasis> facility, and" +msgstr "" + +#. Tag: para +#: part1.xml:25 +#, no-c-format +msgid "" +"a better approach to binding <emphasis>interceptors</emphasis> to " +"components, along with a new kind of interceptor, called a " +"<emphasis>decorator</emphasis>, that is more appropriate for use in solving " +"business problems." +msgstr "" + +#. Tag: para +#: part1.xml:32 +#, no-c-format +msgid "" +"Dependency injection, together with contextual lifecycle management, saves " +"the user of an unfamiliar API from having to ask and answer the following " +"questions:" +msgstr "" + +#. Tag: para +#: part1.xml:38 +#, no-c-format +msgid "what is the lifecycle of this object?" +msgstr "" + +#. Tag: para +#: part1.xml:41 +#, no-c-format +msgid "how many simultaneous clients can it have?" +msgstr "" + +#. Tag: para +#: part1.xml:44 +#, no-c-format +msgid "is it multithreaded?" +msgstr "" + +#. Tag: para +#: part1.xml:47 +#, no-c-format +msgid "where can I get one from?" +msgstr "" + +#. Tag: para +#: part1.xml:50 +#, no-c-format +msgid "do I need to explicitly destroy it?" +msgstr "" + +#. Tag: para +#: part1.xml:53 +#, no-c-format +msgid "where should I keep my reference to it when I'm not using it directly?" +msgstr "" + +#. Tag: para +#: part1.xml:57 +#, no-c-format +msgid "" +"how can I add an indirection layer, so that the implementation of this " +"object can vary at deployment time?" +msgstr "" + +#. Tag: para +#: part1.xml:61 +#, no-c-format +msgid "how should I go about sharing this object between other objects?" +msgstr "" + +#. Tag: para +#: part1.xml:65 +#, no-c-format +msgid "" +"A Web Bean specifies only the type and semantics of other Web Beans it " +"depends upon. It need not be aware of the actual lifecycle, concrete " +"implementation, threading model or other clients of any Web Bean it depends " +"upon. Even better, the concrete implementation, lifecycle and threading " +"model of a Web Bean it depends upon may vary according to the deployment " +"scenario, without affecting any client." +msgstr "" + +#. Tag: para +#: part1.xml:72 +#, no-c-format +msgid "" +"Events, interceptors and decorators enhance the <emphasis>loose-coupling</" +"emphasis> that is inherent in this model:" +msgstr "" + +#. Tag: para +#: part1.xml:77 +#, no-c-format +msgid "" +"<emphasis>event notifications</emphasis> decouple event producers from event " +"consumers," +msgstr "" + +#. Tag: para +#: part1.xml:81 +#, no-c-format +msgid "" +"<emphasis>interceptors</emphasis> decouple technical concerns from business " +"logic, and" +msgstr "" + +#. Tag: para +#: part1.xml:85 +#, no-c-format +msgid "" +"<emphasis>decorators</emphasis> allow business concerns to be " +"compartmentalized." +msgstr "" + +#. Tag: para +#: part1.xml:90 +#, no-c-format +msgid "" +"Most importantly, Web Beans provides all these facilities in a " +"<emphasis>typesafe</emphasis> way. Web Beans never uses string-based " +"identifiers to determine how collaborating objects fit together. And XML, " +"though it remains an option, is rarely used. Instead, Web Beans uses the " +"typing information that is already available in the Java object model, " +"together with a new pattern, called <emphasis>binding annotations</" +"emphasis>, to wire together Web Beans, their dependencies, their " +"interceptors and decorators and their event consumers." +msgstr "" + +#. Tag: para +#: part1.xml:100 +#, no-c-format +msgid "" +"The Web Beans services are general and apply to the following types of " +"components that exist in the Java EE environment:" +msgstr "" + +#. Tag: para +#: part1.xml:105 +#, no-c-format +msgid "all JavaBeans," +msgstr "" + +#. Tag: para +#: part1.xml:108 +#, no-c-format +msgid "all EJBs, and" +msgstr "" + +#. Tag: para +#: part1.xml:111 +#, no-c-format +msgid "all Servlets." +msgstr "" + +#. Tag: para +#: part1.xml:115 +#, no-c-format +msgid "" +"Web Beans even provides the necessary integration points so that other kinds " +"of components defined by future Java EE specifications or by non-standard " +"frameworks may be cleanly integrated with Web Beans, take advantage of the " +"Web Beans services, and interact with any other kind of Web Bean." +msgstr "" + +#. Tag: para +#: part1.xml:120 +#, no-c-format +msgid "" +"Web Beans was influenced by a number of existing Java frameworks, including " +"Seam, Guice and Spring. However, Web Beans has its own very distinct " +"character: more typesafe than Seam, more stateful and less XML-centric than " +"Spring, more web and enterprise-application capable than Guice." +msgstr "" + +#. Tag: para +#: part1.xml:125 +#, no-c-format +msgid "" +"Most importantly, Web Beans is a JCP standard that integrates cleanly with " +"Java EE, and with any Java SE environment where embeddable EJB Lite is " +"available." +msgstr "" Added: doc/trunk/reference/it-IT/modules/part2.po =================================================================== --- doc/trunk/reference/it-IT/modules/part2.po (rev 0) +++ doc/trunk/reference/it-IT/modules/part2.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,102 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part2.xml:5 +#, no-c-format +msgid "" +"The first major theme of Web Beans is <emphasis>loose coupling</emphasis>. " +"We've already seen three means of achieving loose coupling:" +msgstr "" + +#. Tag: para +#: part2.xml:10 +#, no-c-format +msgid "" +"<emphasis>deployment types</emphasis> enable deployment time polymorphism," +msgstr "" + +#. Tag: para +#: part2.xml:14 +#, no-c-format +msgid "<emphasis>producer methods</emphasis> enable runtime polymorphism, and" +msgstr "" + +#. Tag: para +#: part2.xml:18 +#, no-c-format +msgid "" +"<emphasis>contextual lifecycle management</emphasis> decouples Web Bean " +"lifecycles." +msgstr "" + +#. Tag: para +#: part2.xml:23 +#, no-c-format +msgid "" +"These techniques serve to enable loose coupling of client and server. The " +"client is no longer tightly bound to an implementation of an API, nor is it " +"required to manage the lifecycle of the server object. This approach lets " +"<emphasis>stateful objects interact as if they were services</emphasis>." +msgstr "" + +#. Tag: para +#: part2.xml:28 +#, no-c-format +msgid "" +"Loose coupling makes a system more <emphasis>dynamic</emphasis>. The system " +"can respond to change in a well-defined manner. In the past, frameworks that " +"attempted to provide the facilities listed above invariably did it by " +"sacrificing type safety. Web Beans is the first technology that achieves " +"this level of loose coupling in a typesafe way." +msgstr "" + +#. Tag: para +#: part2.xml:34 +#, no-c-format +msgid "" +"Web Beans provides three extra important facilities that further the goal of " +"loose coupling:" +msgstr "" + +#. Tag: para +#: part2.xml:39 +#, no-c-format +msgid "" +"<emphasis>interceptors</emphasis> decouple technical concerns from business " +"logic," +msgstr "" + +#. Tag: para +#: part2.xml:43 +#, no-c-format +msgid "" +"<emphasis>decorators</emphasis> may be used to decouple some business " +"concerns, and" +msgstr "" + +#. Tag: para +#: part2.xml:47 +#, no-c-format +msgid "" +"<emphasis>event notifications</emphasis> decouple event producers from event " +"consumers." +msgstr "" + +#. Tag: para +#: part2.xml:52 +#, no-c-format +msgid "Let's explore interceptors first." +msgstr "" Added: doc/trunk/reference/it-IT/modules/part3.po =================================================================== --- doc/trunk/reference/it-IT/modules/part3.po (rev 0) +++ doc/trunk/reference/it-IT/modules/part3.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,150 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part3.xml:5 +#, no-c-format +msgid "" +"The second major theme of Web Beans is <emphasis>strong typing</emphasis>. " +"The information about the dependencies, interceptors and decorators of a Web " +"Bean, and the information about event consumers for an event producer, is " +"contained in typesafe Java constructs that may be validated by the compiler." +msgstr "" + +#. Tag: para +#: part3.xml:10 +#, no-c-format +msgid "" +"You don't see string-based identifiers in Web Beans code, not because the " +"framework is hiding them from you using clever defaulting rulesso-" +"called \"configuration by convention\"but because there are simply no " +"strings there to begin with!" +msgstr "" + +#. Tag: para +#: part3.xml:15 +#, no-c-format +msgid "" +"The obvious benefit of this approach is that <emphasis>any</emphasis> IDE " +"can provide autocompletion, validation and refactoring without the need for " +"special tooling. But there is a second, less-immediately-obvious, benefit. " +"It turns out that when you start thinking of identifying objects, events or " +"interceptors via annotations instead of names, you have an opportunity to " +"lift the semantic level of your code." +msgstr "" + +#. Tag: para +#: part3.xml:21 +#, no-c-format +msgid "" +"Web Beans encourages you develop annotations that model concepts, for " +"example," +msgstr "" + +#. Tag: para +#: part3.xml:26 +#, no-c-format +msgid "<literal>@Asynchronous</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:29 +#, no-c-format +msgid "<literal>@Mock</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:32 +#, no-c-format +msgid "<literal>@Secure</literal> or" +msgstr "" + +#. Tag: para +#: part3.xml:35 +#, no-c-format +msgid "<literal>@Updated</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:39 +#, no-c-format +msgid "instead of using compound names like" +msgstr "" + +#. Tag: para +#: part3.xml:43 +#, no-c-format +msgid "<literal>asyncPaymentProcessor</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:46 +#, no-c-format +msgid "<literal>mockPaymentProcessor</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:49 +#, no-c-format +msgid "<literal>SecurityInterceptor</literal> or" +msgstr "" + +#. Tag: para +#: part3.xml:52 +#, no-c-format +msgid "<literal>DocumentUpdatedEvent</literal>." +msgstr "" + +#. Tag: para +#: part3.xml:56 +#, no-c-format +msgid "" +"The annotations are reusable. They help describe common qualities of " +"disparate parts of the system. They help us categorize and understand our " +"code. They help us deal with common concerns in a common way. They make our " +"code more literate and more understandable." +msgstr "" + +#. Tag: para +#: part3.xml:61 +#, no-c-format +msgid "" +"Web Beans <emphasis>stereotypes</emphasis> take this idea a step further. A " +"stereotype models a common <emphasis>role</emphasis> in your application " +"architecture. It encapsulates various properties of the role, including " +"scope, interceptor bindings, deployment type, etc, into a single reusable " +"package." +msgstr "" + +#. Tag: para +#: part3.xml:66 +#, no-c-format +msgid "" +"Even Web Beans XML metadata is strongly typed! There's no compiler for XML, " +"so Web Beans takes advantage of XML schemas to validate the Java types and " +"attributes that appear in XML. This approach turns out to make the XML more " +"literate, just like annotations made our Java code more literate." +msgstr "" + +#. Tag: para +#: part3.xml:71 +#, no-c-format +msgid "" +"We're now ready to meet some more advanced features of Web Beans. Bear in " +"mind that these features exist to make our code both easier to validate and " +"more understandable. Most of the time you don't ever really <emphasis>need</" +"emphasis> to use these features, but if you use them wisely, you'll come to " +"appreciate their power." +msgstr "" Added: doc/trunk/reference/it-IT/modules/part4.po =================================================================== --- doc/trunk/reference/it-IT/modules/part4.po (rev 0) +++ doc/trunk/reference/it-IT/modules/part4.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,52 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part4.xml:5 +#, no-c-format +msgid "" +"The third theme of Web Beans is <emphasis>integration</emphasis>. Web Beans " +"was designed to work in concert with other technologies, helping the " +"application developer fit the other technologies together. Web Beans is an " +"open technology. It forms a part of the Java EE ecosystem, and is itself the " +"foundation for a new ecosystem of portable extensions and integration with " +"existing frameworks and technologies." +msgstr "" + +#. Tag: para +#: part4.xml:12 +#, no-c-format +msgid "" +"We've already seen how Web Beans helps integrate EJB and JSF, allowing EJBs " +"to be bound directly to JSF pages. That's just the beginning. Web Beans " +"offers the same potential to diverse other technologies, such as Business " +"Process Management engines, other Web Frameworks, and third-party component " +"models. The Java EE platform will never be able to standardize all the " +"interesting technologies that are used in the world of Java application " +"development, but Web Beans makes it easier to use the technologies which are " +"not yet part of the platform seamlessly within the Java EE environment." +msgstr "" + +#. Tag: para +#: part4.xml:21 +#, no-c-format +msgid "" +"We're about to see how to take full advantage of the Java EE platform in an " +"application that uses Web Beans. We'll also briefly meet a set of SPIs that " +"are provided to support portable extensions to Web Beans. You might not ever " +"need to use these SPIs directly, but it's nice to know they are there if you " +"need them. Most importantly, you'll take advantage of them indirectly, every " +"time you use a third-party extension." +msgstr "" Added: doc/trunk/reference/it-IT/modules/producermethods.po =================================================================== --- doc/trunk/reference/it-IT/modules/producermethods.po (rev 0) +++ doc/trunk/reference/it-IT/modules/producermethods.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,246 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: producermethods.xml:5 +#, no-c-format +msgid "Producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:7 +#, no-c-format +msgid "" +"Producer methods let us overcome certain limitations that arise when the Web " +"Bean manager, instead of the application, is responsible for instantiating " +"objects. They're also the easiest way to integrate objects which are not Web " +"Beans into the Web Beans environment. (We'll meet a second approach in <xref " +"linkend=\"xml\"/>.)" +msgstr "" + +#. Tag: para +#: producermethods.xml:12 +#, no-c-format +msgid "According to the spec:" +msgstr "" + +#. Tag: chapter +#: producermethods.xml:12 +#, no-c-format +msgid "" +"<blockquote> <para>A Web Beans producer method acts as a source of objects " +"to be injected, where:</para> <itemizedlist> <listitem> <para>the objects to " +"be injected are not required to be instances of Web Beans,</para> </" +"listitem> <listitem> <para>the concrete type of the objects to be injected " +"may vary at runtime or</para> </listitem> <listitem> <para>the objects " +"require some custom initialization that is not performed by the Web Bean " +"constructor</para> </listitem> </itemizedlist> </blockquote> <para>For " +"example, producer methods let us:</para> <itemizedlist> <listitem> " +"<para>expose a JPA entity as a Web Bean,</para> </listitem> <listitem> " +"<para>expose any JDK class as a Web Bean,</para> </listitem> <listitem> " +"<para>define multiple Web Beans, with different scopes or initialization, " +"for the same implementation class, or</para> </listitem> <listitem> " +"<para>vary the implementation of an API type at runtime.</para> </listitem> " +"</itemizedlist> <para>In particular, producer methods let us use runtime " +"polymorphism with Web Beans. As we've seen, deployment types are a powerful " +"solution to the problem of deployment-time polymorphism. But once the system " +"is deployed, the Web Bean implementation is fixed. A producer method has no " +"such limitation:</para> <programlisting><![CDATA[@SessionScoped\n" +"public class Preferences {\n" +" \n" +" private PaymentStrategyType paymentStrategy;\n" +" \n" +" ...\n" +" \n" +" @Produces @Preferred \n" +" public PaymentStrategy getPaymentStrategy() {\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return new CreditCardPaymentStrategy();\n" +" case CHEQUE: return new ChequePaymentStrategy();\n" +" case PAYPAL: return new PayPalPaymentStrategy();\n" +" default: return null;\n" +" } \n" +" }\n" +" \n" +"}]]></programlisting> <para>Consider an injection point:</para> " +"<programlisting><![CDATA[@Preferred PaymentStrategy paymentStrat;]]></" +"programlisting> <para>This injection point has the same type and binding " +"annotations as the producer method, so it resolves to the producer method " +"using the usual Web Beans injection rules. The producer method will be " +"called by the Web Bean manager to obtain an instance to service this " +"injection point.</para>." +msgstr "" + +#. Tag: title +#: producermethods.xml:68 +#, no-c-format +msgid "Scope of a producer method" +msgstr "" + +#. Tag: para +#: producermethods.xml:70 +#, no-c-format +msgid "" +"The scope of the producer method defaults to <literal>@Dependent</literal>, " +"and so it will be called <emphasis>every time</emphasis> the Web Bean " +"manager injects this field or any other field that resolves to the same " +"producer method. Thus, there could be multiple instances of the " +"<literal>PaymentStrategy</literal> object for each user session." +msgstr "" + +#. Tag: para +#: producermethods.xml:75 +#, no-c-format +msgid "" +"To change this behavior, we can add a <literal>@SessionScoped</literal> " +"annotation to the method." +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:78 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy() {\n" +" ...\n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:80 +#, no-c-format +msgid "" +"Now, when the producer method is called, the returned " +"<literal>PaymentStrategy</literal> will be bound to the session context. The " +"producer method won't be called again in the same session." +msgstr "" + +#. Tag: title +#: producermethods.xml:87 +#, no-c-format +msgid "Injection into producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:89 +#, no-c-format +msgid "" +"There's one potential problem with the code above. The implementations of " +"<literal>CreditCardPaymentStrategy</literal> are instantiated using the Java " +"<literal>new</literal> operator. Objects instantiated directly by the " +"application can't take advantage of dependency injection and don't have " +"interceptors." +msgstr "" + +#. Tag: para +#: producermethods.xml:94 +#, no-c-format +msgid "" +"If this isn't what we want we can use dependency injection into the producer " +"method to obtain Web Bean instances:" +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:97 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy(CreditCardPaymentStrategy ccps,\n" +" ChequePaymentStrategy cps,\n" +" PayPalPaymentStrategy ppps) {\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return ccps;\n" +" case CHEQUE: return cps;\n" +" case PAYPAL: return ppps;\n" +" default: return null;\n" +" } \n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:99 +#, no-c-format +msgid "" +"Wait, what if <literal>CreditCardPaymentStrategy</literal> is a request " +"scoped Web Bean? Then the producer method has the effect of \"promoting\" " +"the current request scoped instance into session scope. This is almost " +"certainly a bug! The request scoped object will be destroyed by the Web Bean " +"manager before the session ends, but the reference to the object will be " +"left \"hanging\" in the session scope. This error will <emphasis>not</" +"emphasis> be detected by the Web Bean manager, so please take extra care " +"when returning Web Bean instances from producer methods!" +msgstr "" + +#. Tag: para +#: producermethods.xml:107 +#, no-c-format +msgid "" +"There's at least three ways we could go about fixing this bug. We could " +"change the scope of the <literal>CreditCardPaymentStrategy</literal> " +"implementation, but this would affect other clients of that Web Bean. A " +"better option would be to change the scope of the producer method to " +"<literal>@Dependent</literal> or <literal>@RequestScoped</literal>." +msgstr "" + +#. Tag: para +#: producermethods.xml:113 +#, no-c-format +msgid "" +"But a more common solution is to use the special <literal>@New</literal> " +"binding annotation." +msgstr "" + +#. Tag: title +#: producermethods.xml:119 +#, no-c-format +msgid "Use of <literal>@New</literal> with producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:121 +#, no-c-format +msgid "Consider the following producer method:" +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:123 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy(@New CreditCardPaymentStrategy " +"ccps,\n" +" @New ChequePaymentStrategy cps,\n" +" @New PayPalPaymentStrategy ppps) " +"{\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return ccps;\n" +" case CHEQUE: return cps;\n" +" case PAYPAL: return ppps;\n" +" default: return null;\n" +" } \n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:125 +#, no-c-format +msgid "" +"Then a new <emphasis>dependent</emphasis> instance of " +"<literal>CreditCardPaymentStrategy</literal> will be created, passed to the " +"producer method, returned by the producer method and finally bound to the " +"session context. The dependent object won't be destroyed until the " +"<literal>Preferences</literal> object is destroyed, at the end of the " +"session." +msgstr "" Added: doc/trunk/reference/it-IT/modules/ri.po =================================================================== --- doc/trunk/reference/it-IT/modules/ri.po (rev 0) +++ doc/trunk/reference/it-IT/modules/ri.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,898 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: ri.xml:4 +#, no-c-format +msgid "Using the Web Beans Reference Implementation" +msgstr "" + +#. Tag: para +#: ri.xml:6 +#, no-c-format +msgid "" +"The Web Beans RI comes with a two examples, <literal>webbeans-numberguess</" +"literal> (a war example, containing only simple beans) and <literal>webbeans-" +"translator</literal> (an ear example, containing enterprise beans)." +msgstr "" + +#. Tag: para +#: ri.xml:13 +#, no-c-format +msgid "" +"Currently, the Web Beans RI only runs on JBoss Application Server 5. You'll " +"need to download JBoss AS 5.0.0.GA from <ulink url=\"http://www.jboss.org/" +"jbossas/downloads/\">jboss.org</ulink>, and unzip it. For example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:20 +#, no-c-format +msgid "" +"<![CDATA[$ cd /Applications\n" +"$ unzip ~/jboss-5.0.0.GA.zip]]>" +msgstr "" + +#. Tag: para +#: ri.xml:22 +#, no-c-format +msgid "" +"Next, download the Web Beans RI from <ulink url=\"http://seamframework.org/" +"WebBeans\">seamframework.org</ulink>, and unzip it. For example" +msgstr "" + +#. Tag: programlisting +#: ri.xml:28 +#, no-c-format +msgid "" +"<![CDATA[$ cd ~/\n" +"$ unzip ~/webbeans-1.0.0.ALPHA1.zip]]>" +msgstr "" + +#. Tag: para +#: ri.xml:30 +#, no-c-format +msgid "" +"As Web Beans is a new piece of software, you need to update JBoss AS to run " +"the Web Beans RI. Future versions of JBoss AS will include these updates, " +"and this step won't be necessary." +msgstr "" + +#. Tag: para +#: ri.xml:37 +#, no-c-format +msgid "" +"Currently, two updates are needed. Firstly, a new deployer, " +"<literal>webbeans.deployer</literal> is added. This adds supports for Web " +"Bean archives to JBoss AS, and allows the Web Beans RI to query the EJB3 " +"container and discover which EJBs are installed in your application. " +"Secondly, an update to JBoss EJB3 is needed." +msgstr "" + +#. Tag: para +#: ri.xml:46 +#, no-c-format +msgid "" +"To install the update, you'll need ant 1.7.0 installed, and the " +"<literal>ANT_HOME</literal> environment variable set. For example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:51 +#, no-c-format +msgid "" +"$ unzip apache-ant-1.7.0.zip\n" +"$ export ANT_HOME=~/apache-ant-1.7.0" +msgstr "" + +#. Tag: para +#: ri.xml:53 +#, no-c-format +msgid "" +"Then, you can install the update. The update script will use Maven to " +"download the Web Beans and EJB3 automatically." +msgstr "" + +#. Tag: programlisting +#: ri.xml:58 +#, no-c-format +msgid "" +"$ cd webbeans-1.0.0.ALPHA1/jboss-as\n" +"$ ant update" +msgstr "" + +#. Tag: para +#: ri.xml:60 +#, no-c-format +msgid "Now, you're ready to deploy your first example!" +msgstr "" + +#. Tag: para +#: ri.xml:65 +#, no-c-format +msgid "" +"The build scripts for the examples offer a number of targets, these are:" +msgstr "" + +#. Tag: para +#: ri.xml:71 +#, no-c-format +msgid "<literal>ant restart</literal> - deploy the example in exploded format" +msgstr "" + +#. Tag: para +#: ri.xml:77 +#, no-c-format +msgid "" +"<literal>ant explode</literal> - update an exploded example, without " +"restarting the deployment" +msgstr "" + +#. Tag: para +#: ri.xml:83 +#, no-c-format +msgid "" +"<literal>ant deploy</literal> - deploy the example in compressed jar format" +msgstr "" + +#. Tag: para +#: ri.xml:88 +#, no-c-format +msgid "<literal>ant undeploy</literal> - remove the example from the server" +msgstr "" + +#. Tag: para +#: ri.xml:93 +#, no-c-format +msgid "<literal>ant clean</literal> - clean the example" +msgstr "" + +#. Tag: para +#: ri.xml:100 +#, no-c-format +msgid "To deploy the numberguess example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:104 +#, no-c-format +msgid "" +"$ cd examples/numberguess\n" +"ant deploy" +msgstr "" + +#. Tag: para +#: ri.xml:106 +#, no-c-format +msgid "" +"Wait for the application to deploy, and enjoy hours of fun at <ulink url=" +"\"http://localhost:8080/webbeans-numberguess\"></ulink>!" +msgstr "" + +#. Tag: para +#: ri.xml:111 +#, no-c-format +msgid "" +"The Web Beans RI includes a second simple example that will translate your " +"text into Latin. The numberguess example is a war example, and uses only " +"simple beans; the translator example is an ear example, and includes " +"enterprise beans, packaged in an EJB module. To try it out:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:118 +#, no-c-format +msgid "" +"$ cd examples/traslator\n" +"ant deploy" +msgstr "" + +#. Tag: para +#: ri.xml:120 +#, no-c-format +msgid "" +"Wait for the application to deploy, and visit <ulink url=\"http://" +"localhost:8080/webbeans-translator\"></ulink>!" +msgstr "" + +#. Tag: title +#: ri.xml:126 +#, no-c-format +msgid "The numberguess example" +msgstr "" + +#. Tag: para +#: ri.xml:128 +#, no-c-format +msgid "" +"In the numberguess application you get given 10 attempts to guess a number " +"between 1 and 100. After each attempt, you will be told whether you are too " +"high, or too low." +msgstr "" + +#. Tag: para +#: ri.xml:134 +#, no-c-format +msgid "" +"The numberguess example is comprised of a number of Web Beans, configuration " +"files, and Facelet JSF pages, packaged as a war. Let's start with the " +"configuration files." +msgstr "" + +#. Tag: para +#: ri.xml:140 +#, no-c-format +msgid "" +"All the configuration files for this example are located in <literal>WEB-INF/" +"</literal>, which is stored in <literal>WebContent</literal> in the source " +"tree. First, we have <literal>faces-config.xml</literal>, in which we tell " +"JSF to use Facelets:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:148 +#, no-c-format +msgid "" +"<![CDATA[<?xml version='1.0' encoding='UTF-8'?>\n" +"<faces-config version=\"1.2\"\n" +" xmlns=\"http://java.sun.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://" +"java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd\">\n" +" \n" +" <application>\n" +" <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>\n" +" </application>\n" +"\n" +"</faces-config>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:150 +#, no-c-format +msgid "" +"There is an empty <literal>web-beans.xml</literal> file, which marks this " +"application as a Web Beans application." +msgstr "" + +#. Tag: para +#: ri.xml:155 +#, no-c-format +msgid "Finally there is <literal>web.xml</literal>:" +msgstr "" + +#. Tag: section +#: ri.xml:157 +#, no-c-format +msgid "" +"<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> " +"<area id=\"faces.servlet.mapping\" coords=\"18\"/> <area id=\"faces.default." +"suffix\" coords=\"23\"/> <area id=\"session.timeout\" coords=\"28\"/> <area " +"id=\"webbeans.listener\" coords=\"32\"/> </areaspec> <programlisting><![CDATA" +"[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"\n" +"<web-app version=\"2.5\"\n" +" xmlns=\"http://java.sun.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun." +"com/xml/ns/javaee/web-app_2_5.xsd\">\n" +" \n" +" <display-name>Web Beans Numbergues example</display-name>\n" +"\n" +" \n" +"\n" +" <servlet>\n" +" <servlet-name>Faces Servlet</servlet-name>\n" +" <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>\n" +" <load-on-startup>1</load-on-startup>\n" +" </servlet>\n" +"\n" +" <servlet-mapping>\n" +" <servlet-name>Faces Servlet</servlet-name>\n" +" <url-pattern>*.jsf</url-pattern>\n" +" </servlet-mapping>\n" +" \n" +" <context-param>\n" +" <param-name>javax.faces.DEFAULT_SUFFIX</param-name>\n" +" <param-value>.xhtml</param-value>\n" +" </context-param>\n" +"\n" +" <session-config>\n" +" <session-timeout>10</session-timeout>\n" +" </session-config>\n" +" \n" +" <listener>\n" +" <listener-class>org.jboss.webbeans.servlet.WebBeansListener</listener-" +"class>\n" +" </listener>\n" +"\n" +"</web-app>]]></programlisting> <calloutlist> <callout arearefs=\"faces." +"servlet\"> <para> Enable and load the JSF servlet </para> </callout> " +"<callout arearefs=\"faces.servlet.mapping\"> <para> Configure requests to " +"<literal>.jsf</literal> pages to be handled by JSF </para> </callout> " +"<callout arearefs=\"faces.default.suffix\"> <para> Tell JSF that we will be " +"giving our source files (facelets) an extension of <literal>.jsf</literal> </" +"para> </callout> <callout arearefs=\"session.timeout\"> <para> Configure a " +"session timeout of 10 minutes </para> </callout> <callout arearefs=" +"\"webbeans.listener\"> <para> Configure the Web Beans listener, so that Web " +"Beans services can be used in the servlet request </para> </callout> </" +"calloutlist> </programlistingco> <note> <para> The only configuration " +"required by the Web Beans RI in <literal>web.xml</literal> is to add the Web " +"Beans listener. </para> <para> Whilst this demo is a JSF demo, you can use " +"the Web Beans RI with any Servlet based web framework; just configure the " +"Web Beans listener. </para> </note> <para> Let's take a look at the Facelet " +"view: </para> <programlistingco> <areaspec> <area id=\"template\" coords=\"8" +"\"/> <area id=\"messages\" coords=\"12\"/> <area id=\"instructions\" coords=" +"\"19\"/> <area id=\"guess\" coords=\"25\"/> <area id=\"validator\" coords=" +"\"29\"/> <area id=\"submit\" coords=\"32\"/> </areaspec> <programlisting><!" +"[CDATA[<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" " +"\"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\n" +"<html xmlns=\"http://www.w3.org/1999/xhtml\"\n" +" xmlns:ui=\"http://java.sun.com/jsf/facelets\"\n" +" xmlns:h=\"http://java.sun.com/jsf/html\"\n" +" xmlns:f=\"http://java.sun.com/jsf/core\"\n" +" xmlns:s=\"http://jboss.com/products/seam/taglib\">\n" +"\n" +" <ui:composition template=\"template.xhtml\">\n" +" <ui:define name=\"content\">\n" +" <h1>Guess a number...</h1>\n" +" <h:form id=\"NumberGuessMain\">\n" +" <div style=\"color: red\">\n" +" <h:messages id=\"messages\" globalOnly=\"false\"/>\n" +" <h:outputText id=\"Higher\" value=\"Higher!\" rendered=\"#{game." +"number gt game.guess}\"/>\n" +" <h:outputText id=\"Lower\" value=\"Lower!\" rendered=\"#{game." +"number lt game.guess}\"/>\n" +" </div>\n" +" \n" +" <div>\n" +" I'm thinking of a number between #{game.smallest} and #{game." +"biggest}.\n" +" You have #{game.remainingGuesses} guesses.\n" +" </div>\n" +" \n" +" <div>\n" +" Your guess: \n" +" <h:inputText id=\"inputGuess\" \n" +" value=\"#{game.guess}\" \n" +" required=\"true\" \n" +" size=\"3\">\n" +" <f:validateLongRange maximum=\"#{game.biggest}\" \n" +" minimum=\"#{game.smallest}\"/>\n" +" </h:inputText>\n" +" <h:commandButton id=\"GuessButton\" \n" +" value=\"Guess\" \n" +" action=\"#{game.check}\"/>\n" +" </div>\n" +" \n" +" </h:form>\n" +" </ui:define>\n" +" </ui:composition>\n" +"</html>]]></programlisting> <calloutlist> <callout arearefs=\"template\"> " +"<para> Facelets is a templating language for JSF, here we are wrapping our " +"page in a template which defines the header. </para> </callout> <callout " +"arearefs=\"messages\"> <para> There are a number of messages which can be " +"sent to the user, \"Higher!\", \"Lower!\" and \"Correct!\" </para> </" +"callout> <callout arearefs=\"instructions\"> <para> As the user guesses, the " +"range of numbers they can guess gets smaller - this sentance changes to make " +"sure they know what range to guess in. </para> </callout> <callout arearefs=" +"\"guess\"> <para> This input field is bound to a Web Bean, using the value " +"expression. </para> </callout> <callout arearefs=\"validator\"> <para> A " +"range validator is used to make sure the user doesn't accidentally input a " +"number outside of the range in which they can guess - if the validator " +"wasn't here, the user might use up a guess on an out of range number. </" +"para> </callout> <callout arearefs=\"submit\"> <para> And, of course, there " +"must be a way for the user to send their guess to the server. Here we bind " +"to an action method on the Web Bean. </para> </callout> </calloutlist> </" +"programlistingco>" +msgstr "" + +#. Tag: para +#: ri.xml:270 +#, no-c-format +msgid "" +"The example exists of 4 classes, the first two of which are binding types. " +"First, there is the <literal>@Random</literal> binding type, used for " +"injecting a random number:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:276 +#, no-c-format +msgid "" +"<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" +"@Retention(RUNTIME)\n" +"@Documented\n" +"@BindingType\n" +"public @interface Random {}]]>" +msgstr "" + +#. Tag: para +#: ri.xml:278 +#, no-c-format +msgid "" +"There is also the <literal>@MaxNumber</literal> binding type, used for " +"injecting the maximum number that can be injected:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:283 +#, no-c-format +msgid "" +"<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" +"@Retention(RUNTIME)\n" +"@Documented\n" +"@BindingType\n" +"public @interface MaxNumber {}\n" +"]]>" +msgstr "" + +#. Tag: para +#: ri.xml:285 +#, no-c-format +msgid "" +"The <literal>Generator</literal> class is responsible for creating the " +"random number, via a producer method. It also exposes the maximum possible " +"number via a producer method:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:291 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped\n" +"public class Generator {\n" +" \n" +" private java.util.Random random = new java.util.Random( System." +"currentTimeMillis() );\n" +" \n" +" private int maxNumber = 100;\n" +" \n" +" java.util.Random getRandom()\n" +" {\n" +" return random;\n" +" }\n" +" \n" +" @Produces @Random int next() { \n" +" return getRandom().nextInt(maxNumber); \n" +" }\n" +" \n" +" @Produces @MaxNumber int getMaxNumber()\n" +" {\n" +" return maxNumber;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: ri.xml:293 +#, no-c-format +msgid "" +"You'll notice that the <literal>Generator</literal> is application scoped; " +"therefore we don't get a different random each time." +msgstr "" + +#. Tag: para +#: ri.xml:298 +#, no-c-format +msgid "" +"The final Web Bean in the application is the session scoped <literal>Game</" +"literal>. By making <literal>Game</literal> session scoped, you can only " +"play the game once per browser session. You could easily add a reset button " +"- a good exercise for the reader :-)" +msgstr "" + +#. Tag: para +#: ri.xml:305 +#, no-c-format +msgid "" +"You'll also note that we've used the <literal>@Named</literal> annotation, " +"so that we can use the bean through EL in the JSF page. Finally, we've used " +"constructor injection to initialize the game with a random number. And of " +"course, we need to tell the player when they've won, so we give feedback " +"with a <literal>FacesMessage</literal>." +msgstr "" + +#. Tag: programlisting +#: ri.xml:313 +#, no-c-format +msgid "" +"<![CDATA[@Named\n" +"@SessionScoped\n" +"public class Game {\n" +" private int number;\n" +" \n" +" private int guess;\n" +" private int smallest;\n" +" private int biggest;\n" +" private int remainingGuesses;\n" +" \n" +" public Game() {}\n" +" \n" +" @Initializer\n" +" Game(@Random int number, @MaxNumber int maxNumber) {\n" +" this.number = number;\n" +" this.smallest = 1;\n" +" this.biggest = maxNumber;\n" +" this.remainingGuesses = 10;\n" +" }\n" +"\n" +" // Getters and setters for fields\n" +" \n" +" public String check() {\n" +" if (guess>number) {\n" +" biggest = guess - 1;\n" +" }\n" +" if (guess<number) {\n" +" smallest = guess + 1;\n" +" }\n" +" if (guess == number) {\n" +" FacesContext.getCurrentInstance().addMessage(null, new FacesMessage" +"(\"Correct!\"));\n" +" }\n" +" remainingGuesses--;\n" +" return null;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: title +#: ri.xml:317 +#, no-c-format +msgid "The translator example" +msgstr "" + +#. Tag: para +#: ri.xml:319 +#, no-c-format +msgid "" +"The translator example will take any sentences you enter, and translate them " +"to Latin." +msgstr "" + +#. Tag: para +#: ri.xml:324 +#, no-c-format +msgid "" +"The translator example is built as an ear, and contains EJBs and enterprise " +"beans. As a result, it's structure is more complex than the numberguess " +"example." +msgstr "" + +#. Tag: para +#: ri.xml:331 +#, no-c-format +msgid "" +"EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will make " +"this structure much simpler!" +msgstr "" + +#. Tag: para +#: ri.xml:337 +#, no-c-format +msgid "" +"First, let's take a look at the ear aggregator, which is located in " +"<literal>webbeans-translator-ear</literal> module. Maven automatically " +"generates the <literal>application.xml</literal> and <literal>jboss-app.xml</" +"literal> for us:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:344 +#, no-c-format +msgid "" +"<![CDATA[<plugin>\n" +" <groupId>org.apache.maven.plugins</groupId>\n" +" <artifactId>maven-ear-plugin</artifactId>\n" +" <configuration>\n" +" <modules>\n" +" <webModule>\n" +" <groupId>org.jboss.webbeans.examples.translator</groupId>\n" +" <artifactId>webbeans-translator-war</artifactId>\n" +" <contextRoot>/webbeans-translator</contextRoot>\n" +" </webModule>\n" +" </modules>\n" +" <jboss>\n" +" <loader-repository>webbeans.jboss.org:loader=webbeans-translator</" +"loader-repository>\n" +" </jboss>\n" +" </configuration>\n" +"</plugin>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:346 +#, no-c-format +msgid "" +"We're doing a couple of things here - firstly we set the context path, which " +"gives us a nice url (<ulink url=\"http://localhost:8080/webbeans-translator" +"\">http://localhost:8080/webbeans-translator</ulink>) and we also enable " +"class loader isolation for JBoss AS." +msgstr "" + +#. Tag: para +#: ri.xml:354 +#, no-c-format +msgid "" +"If you aren't using Maven to generate these files, you would need " +"<literal>META-INF/jboss-app.xml</literal>:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:359 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<!DOCTYPE jboss-app\n" +" PUBLIC \"-//JBoss//DTD J2EE Application 4.2//EN\"\n" +" \"http://www.jboss.org/j2ee/dtd/jboss-app_4_2.dtd\">\n" +"<jboss-app>\n" +" <loader-repository>webbeans.jboss.org:loader=webbeans-translator</loader-" +"repository>\n" +"</jboss-app>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:361 +#, no-c-format +msgid "and <literal>META-INF/application.xml</literal>:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:365 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<application xmlns=\"http://java.sun.com/xml/ns/javaee\" \n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://" +"java.sun.com/xml/ns/javaee/application_5.xsd\"\n" +" version=\"5\">\n" +" <display-name>webbeans-translator-ear</display-name>\n" +" <description>Ear Example for the reference implementation of JSR 299: Web " +"Beans</description>\n" +" \n" +" <module>\n" +" <web>\n" +" <web-uri>webbeans-translator.war</web-uri>\n" +" <context-root>/webbeans-translator</context-root>\n" +" </web>\n" +" </module>\n" +" <module>\n" +" <ejb>webbeans-translator.jar</ejb>\n" +" </module>\n" +"</application>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:368 +#, no-c-format +msgid "" +"Next, lets look at the war. Just as in the numberguess example, we have a " +"<literal>faces-config.xml</literal> (to enabled Facelets) and a <literal>web." +"xml</literal> (to enable JSF and attach Web Beans services to the servlet " +"container) in <literal>WebContent/WEB-INF</literal>." +msgstr "" + +#. Tag: para +#: ri.xml:375 +#, no-c-format +msgid "" +"More intersting is the facelet used to translate text. Just as in the " +"numberguess example we have a template, which surrounds the form (ommitted " +"here for brevity):" +msgstr "" + +#. Tag: programlisting +#: ri.xml:381 +#, no-c-format +msgid "" +"<![CDATA[<h:form id=\"NumberGuessMain\">\n" +" \n" +" <table>\n" +" <tr align=\"center\" style=\"font-weight: bold\" >\n" +" <td>\n" +" Your text\n" +" </td>\n" +" <td>\n" +" Translation\n" +" </td>\n" +" </tr>\n" +" <tr>\n" +" <td>\n" +" <h:inputTextarea id=\"text\" value=\"#{translator.text}\" " +"required=\"true\" rows=\"5\" cols=\"80\" />\n" +" </td>\n" +" <td>\n" +" <h:outputText value=\"#{translator.translatedText}\" />\n" +" </td>\n" +" </tr>\n" +" </table>\n" +" <div>\n" +" <h:commandButton id=\"button\" value=\"Translate\" action=\"#" +"{translator.translate}\"/>\n" +" </div>\n" +" \n" +"</h:form>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:383 +#, no-c-format +msgid "" +"The user can enter some text in the lefthand textarea, and hit the translate " +"button to see the result to the right." +msgstr "" + +#. Tag: para +#: ri.xml:388 +#, no-c-format +msgid "" +"Finally, let's look at the ejb module, <literal>webbeans-translator-ejb</" +"literal>. There are two configuration files in <literal>src/main/resources/" +"META-INF</literal>, an empty <literal>web-beans.xml</literal>, used to mark " +"the archive as containing Web Beans, and <literal>ejb-jar.xml</literal>. Web " +"Beans provides injection and initializtion services for all EJBs, and uses " +"<literal>ejb-jar.xml</literal> to enable this, you'll need this in any EJB " +"project which uses Web Beans:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:400 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar xmlns=\"http://java.sun.com/xml/ns/javaee\" \n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" \n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java." +"sun.com/xml/ns/javaee/ejb-jar_3_0.xsd\"\n" +" version=\"3.0\">\n" +" \n" +" <interceptors>\n" +" <interceptor>\n" +" <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</" +"interceptor-class>\n" +" </interceptor>\n" +" </interceptors>\n" +" \n" +" <assembly-descriptor>\n" +" <interceptor-binding>\n" +" <ejb-name>*</ejb-name>\n" +" <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</" +"interceptor-class>\n" +" </interceptor-binding>\n" +" </assembly-descriptor>\n" +" \n" +"</ejb-jar>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:402 +#, no-c-format +msgid "" +"We've saved the most interesting bit to last, the code! The project has two " +"simple beans, <literal>SentanceParser</literal> and <literal>TextTranslator</" +"literal> and two enterprise beans, <literal>TanslatorControllerBean</" +"literal> and <literal>SentenceTranslator</literal>. You should be getting " +"quite familiar with what a Web Bean looks like by now, so we'll just " +"highlight the most interesting bits here." +msgstr "" + +#. Tag: para +#: ri.xml:412 +#, no-c-format +msgid "" +"Both <literal>SentanceParser</literal> and <literal>TextTranslator</literal> " +"are dependent beans, and <literal>TextTranslator</literal> uses constructor " +"initialization:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:418 +#, no-c-format +msgid "" +"<![CDATA[public class TextTranslator { \n" +" private SentenceParser sentenceParser; \n" +" private Translator sentenceTranslator; \n" +" \n" +" @Initializer\n" +" TextTranslator(SentenceParser sentenceParser, Translator " +"sentenceTranslator) \n" +" { \n" +" this.sentenceParser = sentenceParser; \n" +" this.sentenceTranslator = sentenceTranslator;]]>" +msgstr "" + +#. Tag: para +#: ri.xml:420 +#, no-c-format +msgid "" +"<literal>TextTranslator</literal> is a stateless bean (with a local business " +"interface), where the magic happens - of course, we couldn't develop a full " +"translator, but we gave it a good go!" +msgstr "" + +#. Tag: para +#: ri.xml:426 +#, no-c-format +msgid "" +"Finally, there is UI orientated controller, that collects the text from the " +"user, and dispatches it to the translator. This is a request scoped, named, " +"stateful session bean, which injects the translator." +msgstr "" + +#. Tag: programlisting +#: ri.xml:432 +#, no-c-format +msgid "" +"<![CDATA[@Stateful\n" +"@RequestScoped\n" +"@Named(\"translator\")\n" +"public class TranslatorControllerBean implements TranslatorController\n" +"{\n" +" \n" +" @Current TextTranslator translator;]]>" +msgstr "" + +#. Tag: para +#: ri.xml:434 +#, no-c-format +msgid "The bean also has getters and setters for all the fields on the page." +msgstr "" + +#. Tag: para +#: ri.xml:438 +#, no-c-format +msgid "As this is a stateful session bean, we have to have a remove method:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:442 +#, no-c-format +msgid "" +"<![CDATA[ @Remove\n" +" public void remove()\n" +" {\n" +" \n" +" }]]>" +msgstr "" + +#. Tag: para +#: ri.xml:444 +#, no-c-format +msgid "" +"The Web Beans manager will call the remove method for you when the bean is " +"destroyed; in this case at the end of the request." +msgstr "" + +#. Tag: para +#: ri.xml:450 +#, no-c-format +msgid "" +"That concludes our short tour of the Web Beans RI examples. For more on the " +"RI, or to help out, please visit <ulink url=\"http://www.seamframework.org/" +"WebBeans/Development\">http://www.seamframework.org/WebBeans/Development</" +"ulink>." +msgstr "" + +#. Tag: para +#: ri.xml:456 +#, no-c-format +msgid "" +"We need help in all areas - bug fixing, writing new features, writing " +"examples and translating this reference guide." +msgstr "" Added: doc/trunk/reference/it-IT/modules/scopescontexts.po =================================================================== --- doc/trunk/reference/it-IT/modules/scopescontexts.po (rev 0) +++ doc/trunk/reference/it-IT/modules/scopescontexts.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,582 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: scopescontexts.xml:4 +#, no-c-format +msgid "Scopes and contexts" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:6 +#, no-c-format +msgid "" +"So far, we've seen a few examples of <emphasis>scope type annotations</" +"emphasis>. The scope of a Web Bean determines the lifecycle of instances of " +"the Web Bean. The scope also determines which clients refer to which " +"instances of the Web Bean. According to the Web Beans specification, a scope " +"determines:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:14 +#, no-c-format +msgid "When a new instance of any Web Bean with that scope is created" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:17 +#, no-c-format +msgid "When an existing instance of any Web Bean with that scope is destroyed" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:20 +#, no-c-format +msgid "" +"Which injected references refer to any instance of a Web Bean with that scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:25 +#, no-c-format +msgid "" +"For example, if we have a session scoped Web Bean, <literal>CurrentUser</" +"literal>, all Web Beans that are called in the context of the same " +"<literal>HttpSession</literal> will see the same instance of " +"<literal>CurrentUser</literal>. This instance will be automatically created " +"the first time a <literal>CurrentUser</literal> is needed in that session, " +"and automatically destroyed when the session ends." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:32 +#, no-c-format +msgid "Scope types" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:34 +#, no-c-format +msgid "" +"Web Beans features an <emphasis>extensible context model</emphasis>. It is " +"possible to define new scopes by creating a new scope type annotation:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:37 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD})\n" +"@ScopeType\n" +"public @interface ClusterScoped {}]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:39 +#, no-c-format +msgid "" +"Of course, that's the easy part of the job. For this scope type to be " +"useful, we will also need to define a <literal>Context</literal> object that " +"implements the scope! Implementing a <literal>Context</literal> is usually a " +"very technical task, intended for framework development only." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:44 +#, no-c-format +msgid "" +"We can apply a scope type annotation to a Web Bean implementation class to " +"specify the scope of the Web Bean:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:47 +#, no-c-format +msgid "" +"<![CDATA[@ClusterScoped\n" +"public class SecondLevelCache { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:58 +#, no-c-format +msgid "Usually, you'll use one of Web Beans' built-in scopes." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:63 +#, no-c-format +msgid "Built-in scopes" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:65 +#, no-c-format +msgid "Web Beans defines four built-in scopes:" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:69 +#, no-c-format +msgid "@RequestScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:72 +#, no-c-format +msgid "@SessionScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:75 +#, no-c-format +msgid "@ApplicationScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:78 +#, no-c-format +msgid "@ConversationScoped" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:82 +#, no-c-format +msgid "For a web application that uses Web Beans:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:86 +#, no-c-format +msgid "" +"any servlet request has access to active request, session and application " +"scopes, and, additionally" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:90 +#, no-c-format +msgid "any JSF request has access to an active conversation scope." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:94 +#, no-c-format +msgid "The request and application scopes are also active:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:98 +#, no-c-format +msgid "during invocations of EJB remote methods," +msgstr "" + +#. Tag: para +#: scopescontexts.xml:101 +#, no-c-format +msgid "during EJB timeouts," +msgstr "" + +#. Tag: para +#: scopescontexts.xml:104 +#, no-c-format +msgid "during message delivery to a message-driven bean, and" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:107 +#, no-c-format +msgid "during web service invocations." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:111 +#, no-c-format +msgid "" +"If the application tries to invoke a Web Bean with a scope that does not " +"have an active context, a <literal>ContextNotActiveException</literal> is " +"thrown by the Web Bean manager at runtime." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:115 +#, no-c-format +msgid "" +"Three of the four built-in scopes should be extremely familiar to every Java " +"EE developer, so let's not waste time discussing them here. One of the " +"scopes, however, is new." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:122 +#, no-c-format +msgid "The conversation scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:124 +#, no-c-format +msgid "" +"The Web Beans conversation scope is a bit like the traditional session scope " +"in that it holds state associated with a user of the system, and spans " +"multiple requests to the server. However, unlike the session scope, the " +"conversation scope:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:130 +#, no-c-format +msgid "is demarcated explicitly by the application, and" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:133 +#, no-c-format +msgid "" +"holds state associated with a particular web browser tab in a JSF " +"application." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:138 +#, no-c-format +msgid "" +"A conversation represents a task, a unit of work from the point of view of " +"the user. The conversation context holds state associated with what the user " +"is currently working on. If the user is doing multiple things at the same " +"time, there are multiple conversations." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:143 +#, no-c-format +msgid "" +"The conversation context is active during any JSF request. However, most " +"conversations are destroyed at the end of the request. If a conversation " +"should hold state across multiple requests, it must be explicitly promoted " +"to a <emphasis>long-running conversation</emphasis>." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:149 +#, no-c-format +msgid "Conversation demarcation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:151 +#, no-c-format +msgid "" +"Web Beans provides a built-in Web Bean for controlling the lifecyle of " +"conversations in a JSF application. This Web Bean may be obtained by " +"injection:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:154 +#, no-c-format +msgid "@Current Conversation conversation;" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:156 +#, no-c-format +msgid "" +"To promote the conversation associated with the current request to a long-" +"running conversation, call the <literal>begin()</literal> method from " +"application code. To schedule the current long-running conversation context " +"for destruction at the end of the current request, call <literal>end()</" +"literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:161 +#, no-c-format +msgid "" +"In the following example, a conversation-scoped Web Bean controls the " +"conversation with which it is associated:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:164 +#, no-c-format +msgid "" +"@ConversationScoped @Stateful\n" +"public class OrderBuilder {\n" +"\n" +" private Order order;\n" +" private @Current Conversation conversation;\n" +" private @PersistenceContext(type=EXTENDED) EntityManager em;\n" +" \n" +" @Produces public Order getOrder() {\n" +" return order;\n" +" }\n" +"\n" +" public Order createOrder() {\n" +" order = new Order();\n" +" conversation.begin();\n" +" return order;\n" +" }\n" +" \n" +" public void addLineItem(Product product, int quantity) {\n" +" order.add( new LineItem(product, quantity) );\n" +" }\n" +"\n" +" public void saveOrder(Order order) {\n" +" em.persist(order);\n" +" conversation.end();\n" +" }\n" +" \n" +" @Remove\n" +" public void destroy() {}\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:166 +#, no-c-format +msgid "" +"This Web Bean is able to control its own lifecycle through use of the " +"<literal>Conversation</literal> API. But some other Web Beans have a " +"lifecycle which depends completely upon another object." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:173 +#, no-c-format +msgid "Conversation propagation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:175 +#, no-c-format +msgid "" +"The conversation context automatically propagates with any JSF faces request " +"(JSF form submission). It does not automatically propagate with non-faces " +"requests, for example, navigation via a link." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:179 +#, no-c-format +msgid "" +"We can force the conversation to propagate with a non-faces request by " +"including the unique identifier of the conversation as a request parameter. " +"The Web Beans specification reserves the request parameter named " +"<literal>cid</literal> for this use. The unique identifier of the " +"conversation may be obtained from the <literal>Conversation</literal> " +"object, which has the Web Beans name <literal>conversation</literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:186 +#, no-c-format +msgid "Therefore, the following link propagates the conversation:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:188 +#, no-c-format +msgid "" +"<![CDATA[<a href=\"/addProduct.jsp?cid=#{conversation.id}\">Add Product</a>]]" +">" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:190 +#, no-c-format +msgid "" +"The Web Bean manager is also required to propagate conversations across any " +"redirect, even if the conversation is not marked long-running. This makes it " +"very easy to implement the common POST-then-redirect pattern, without resort " +"to fragile constructs such as a \"flash\" object. In this case, the Web Bean " +"manager automatically adds a request parameter to the redirect URL." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:200 +#, no-c-format +msgid "Conversation timeout" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:202 +#, no-c-format +msgid "" +"The Web Bean manager is permitted to destroy a conversation and all state " +"held in its context at any time in order to preserve resources. A Web Bean " +"manager implementation will normally do this on the basis of some kind of " +"timeoutthough this is not required by the Web Beans specification. The " +"timeout is the period of inactivity before the conversation is destroyed." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:208 +#, no-c-format +msgid "" +"The <literal>Conversation</literal> object provides a method to set the " +"timeout. This is a hint to the Web Bean manager, which is free to ignore the " +"setting." +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:212 +#, no-c-format +msgid "conversation.setTimeout(timeoutInMillis);" +msgstr "" + +#. Tag: title +#: scopescontexts.xml:219 +#, no-c-format +msgid "The dependent pseudo-scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:221 +#, no-c-format +msgid "" +"In addition to the four built-in scopes, Web Beans features the so-called " +"<emphasis>dependent pseudo-scope</emphasis>. This is the default scope for a " +"Web Bean which does not explicitly declare a scope type." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:225 +#, no-c-format +msgid "" +"For example, this Web Bean has the scope type <literal>@Dependent</literal>:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:227 +#, no-c-format +msgid "<![CDATA[public class Calculator { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:229 +#, no-c-format +msgid "" +"When an injection point of a Web Bean resolves to a dependent Web Bean, a " +"new instance of the dependent Web Bean is created every time the first Web " +"Bean is instantiated. Instances of dependent Web Beans are never shared " +"between different Web Beans or different injection points. They are " +"<emphasis>dependent objects</emphasis> of some other Web Bean instance." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:235 +#, no-c-format +msgid "" +"Dependent Web Bean instances are destroyed when the instance they depend " +"upon is destroyed." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:243 +#, no-c-format +msgid "" +"Web Beans makes it easy to obtain a dependent instance of a Java class or " +"EJB bean, even if the class or EJB bean is already declared as a Web Bean " +"with some other scope type." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:248 +#, no-c-format +msgid "The <literal>@New</literal> annotation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:250 +#, no-c-format +msgid "" +"The built-in <literal>@New</literal> binding annotation allows " +"<emphasis>implicit</emphasis> definition of a dependent Web Bean at an " +"injection point. Suppose we declare the following injected field:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:254 +#, no-c-format +msgid "<![CDATA[@New Calculator calculator;]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:256 +#, no-c-format +msgid "" +"Then a Web Bean with scope <literal>@Dependent</literal>, binding type " +"<literal>@New</literal>, API type <literal>Calculator</literal>, " +"implementation class <literal>Calculator</literal> and deployment type " +"<literal>@Standard</literal> is implicitly defined." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:261 +#, no-c-format +msgid "" +"This is true even if <literal>Calculator</literal> is <emphasis>already</" +"emphasis> declared with a different scope type, for example:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:264 +#, no-c-format +msgid "" +"<![CDATA[@ConversationScoped\n" +"public class Calculator { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:266 +#, no-c-format +msgid "" +"So the following injected attributes each get a different instance of " +"<literal>Calculator</literal>:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:269 +#, no-c-format +msgid "" +"<![CDATA[public class PaymentCalc {\n" +"\n" +" @Current Calculator calculator;\n" +" @New Calculator newCalculator;\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:271 +#, no-c-format +msgid "" +"The <literal>calculator</literal> field has a conversation-scoped instance " +"of <literal>Calculator</literal> injected. The <literal>newCalculator</" +"literal> field has a new instance of <literal>Calculator</literal> injected, " +"with a lifecycle that is bound to the owning <literal>PaymentCalc</literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:276 +#, no-c-format +msgid "" +"This feature is particularly useful with producer methods, as we'll see in " +"the next chapter." +msgstr "" Added: doc/trunk/reference/it-IT/modules/specialization.po =================================================================== --- doc/trunk/reference/it-IT/modules/specialization.po (rev 0) +++ doc/trunk/reference/it-IT/modules/specialization.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,291 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: specialization.xml:4 +#, no-c-format +msgid "Specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:6 +#, no-c-format +msgid "" +"We've already seen how the Web Beans dependency injection model lets us " +"<emphasis>override</emphasis> the implementation of an API at deployment " +"time. For example, the following enterprise Web Bean provides an " +"implementation of the API <literal>PaymentProcessor</literal> in production:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:11 +#, no-c-format +msgid "" +"@CreditCard @Stateless\n" +"public class CreditCardPaymentProcessor \n" +" implements PaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:13 +#, no-c-format +msgid "" +"But in our staging environment, we override that implementation of " +"<literal>PaymentProcessor</literal> with a different Web Bean:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:16 +#, no-c-format +msgid "" +"@CreditCard @Stateless @Staging\n" +"public class StagingCreditCardPaymentProcessor \n" +" implements PaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:18 +#, no-c-format +msgid "" +"What we've tried to do with <literal>StagingCreditCardPaymentProcessor</" +"literal> is to completely replace <literal>AsyncPaymentProcessor</literal> " +"in a particular deployment of the system. In that deployment, the deployment " +"type <literal>@Staging</literal> would have a higher priority than the " +"default deployment type <literal>@Production</literal>, and therefore " +"clients with the following injection point:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:24 +#, no-c-format +msgid "@CreditCard PaymentProcessor ccpp" +msgstr "" + +#. Tag: para +#: specialization.xml:26 +#, no-c-format +msgid "" +"Would receive an instance of <literal>StagingCreditCardPaymentProcessor</" +"literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:28 +#, no-c-format +msgid "Unfortunately, there are several traps we can easily fall into:" +msgstr "" + +#. Tag: para +#: specialization.xml:32 +#, no-c-format +msgid "" +"the higher-priority Web Bean may not implement all the API types of the Web " +"Bean that it attempts to override," +msgstr "" + +#. Tag: para +#: specialization.xml:36 +#, no-c-format +msgid "" +"the higher-priority Web Bean may not declare all the binding types of the " +"Web Bean that it attempts to override," +msgstr "" + +#. Tag: para +#: specialization.xml:40 +#, no-c-format +msgid "" +"the higher-priority Web Bean might not have the same name as the Web Bean " +"that it attempts to override, or" +msgstr "" + +#. Tag: para +#: specialization.xml:44 +#, no-c-format +msgid "" +"the Web Bean that it attempts to override might declare a producer method, " +"disposal method or observer method." +msgstr "" + +#. Tag: para +#: specialization.xml:49 +#, no-c-format +msgid "" +"In each of these cases, the Web Bean that we tried to override could still " +"be called at runtime. Therefore, overriding is somewhat prone to developer " +"error." +msgstr "" + +#. Tag: para +#: specialization.xml:52 +#, no-c-format +msgid "" +"Web Beans provides a special feature, called <emphasis>specialization</" +"emphasis>, that helps the developer avoid these traps. Specialization looks " +"a little esoteric at first, but it's easy to use in practice, and you'll " +"really appreciate the extra security it provides." +msgstr "" + +#. Tag: title +#: specialization.xml:58 +#, no-c-format +msgid "Using specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:60 +#, no-c-format +msgid "" +"Specialization is a feature that is specific to simple and enterprise Web " +"Beans. To make use of specialization, the higher-priority Web Bean must:" +msgstr "" + +#. Tag: para +#: specialization.xml:65 +#, no-c-format +msgid "be a direct subclass of the Web Bean it overrides, and" +msgstr "" + +#. Tag: para +#: specialization.xml:68 +#, no-c-format +msgid "" +"be a simple Web Bean if the Web Bean it overrides is a simple Web Bean or an " +"enterprise Web Bean if the Web Bean it overrides is an enterprise Web Bean, " +"and" +msgstr "" + +#. Tag: para +#: specialization.xml:73 +#, no-c-format +msgid "be annotated <literal>@Specializes</literal>." +msgstr "" + +#. Tag: programlisting +#: specialization.xml:77 +#, no-c-format +msgid "" +"@Stateless @Staging @Specializes\n" +"public class StagingCreditCardPaymentProcessor \n" +" extends CreditCardPaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:79 +#, no-c-format +msgid "" +"We say that the higher-priority Web Bean <emphasis>specializes</emphasis> " +"its superclass." +msgstr "" + +#. Tag: title +#: specialization.xml:85 +#, no-c-format +msgid "Advantages of specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:87 +#, no-c-format +msgid "When specialization is used:" +msgstr "" + +#. Tag: para +#: specialization.xml:91 +#, no-c-format +msgid "" +"the binding types of the superclass are automatically inherited by the Web " +"Bean annotated <literal>@Specializes</literal>, and" +msgstr "" + +#. Tag: para +#: specialization.xml:95 +#, no-c-format +msgid "" +"the Web Bean name of the superclass is automatically inherited by the Web " +"Bean annotated <literal>@Specializes</literal>, and" +msgstr "" + +#. Tag: para +#: specialization.xml:99 +#, no-c-format +msgid "" +"producer methods, disposal methods and observer methods declared by the " +"superclass are called upon an instance of the Web Bean annotated " +"<literal>@Specializes</literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:105 +#, no-c-format +msgid "" +"In our example, the binding type <literal>@CreditCard</literal> of " +"<literal>CreditCardPaymentProcessor</literal> is inherited by " +"<literal>StagingCreditCardPaymentProcessor</literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:109 +#, no-c-format +msgid "Furthermore, the Web Bean manager will validate that:" +msgstr "" + +#. Tag: para +#: specialization.xml:113 +#, no-c-format +msgid "" +"all API types of the superclass are API types of the Web Bean annotated " +"<literal>@Specializes</literal> (all local interfaces of the superclass " +"enterprise bean are also local interfaces of the subclass)," +msgstr "" + +#. Tag: para +#: specialization.xml:119 +#, no-c-format +msgid "" +"the deployment type of the Web Bean annotated <literal>@Specializes</" +"literal> has a higher precedence than the deployment type of the superclass, " +"and" +msgstr "" + +#. Tag: para +#: specialization.xml:124 +#, no-c-format +msgid "" +"there is no other enabled Web Bean that also specializes the superclass." +msgstr "" + +#. Tag: para +#: specialization.xml:129 +#, no-c-format +msgid "" +"If any of these conditions are violated, the Web Bean manager throws an " +"exception at initialization time." +msgstr "" + +#. Tag: para +#: specialization.xml:132 +#, no-c-format +msgid "" +"Therefore, we can be certain that the superclass with <emphasis>never</" +"emphasis> be called in any deployment of the system where the Web Bean " +"annotated <literal>@Specializes</literal> is deployed and enabled." +msgstr "" Added: doc/trunk/reference/it-IT/modules/stereotypes.po =================================================================== --- doc/trunk/reference/it-IT/modules/stereotypes.po (rev 0) +++ doc/trunk/reference/it-IT/modules/stereotypes.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,352 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: stereotypes.xml:4 +#, no-c-format +msgid "Stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:6 +#, no-c-format +msgid "According to the Web Beans specification:" +msgstr "" + +#. Tag: para +#: stereotypes.xml:10 +#, no-c-format +msgid "" +"In many systems, use of architectural patterns produces a set of recurring " +"Web Bean roles. A stereotype allows a framework developer to identify such a " +"role and declare some common metadata for Web Beans with that role in a " +"central place." +msgstr "" + +#. Tag: para +#: stereotypes.xml:14 +#, no-c-format +msgid "A stereotype encapsulates any combination of:" +msgstr "" + +#. Tag: para +#: stereotypes.xml:18 +#, no-c-format +msgid "a default deployment type," +msgstr "" + +#. Tag: para +#: stereotypes.xml:21 +#, no-c-format +msgid "a default scope type," +msgstr "" + +#. Tag: para +#: stereotypes.xml:24 +#, no-c-format +msgid "a restriction upon the Web Bean scope," +msgstr "" + +#. Tag: para +#: stereotypes.xml:27 +#, no-c-format +msgid "a requirement that the Web Bean implement or extend a certain type, and" +msgstr "" + +#. Tag: para +#: stereotypes.xml:30 +#, no-c-format +msgid "a set of interceptor binding annotations." +msgstr "" + +#. Tag: para +#: stereotypes.xml:34 +#, no-c-format +msgid "" +"A stereotype may also specify that all Web Beans with the stereotype have " +"defaulted Web Bean names." +msgstr "" + +#. Tag: para +#: stereotypes.xml:37 +#, no-c-format +msgid "A Web Bean may declare zero, one or multiple stereotypes." +msgstr "" + +#. Tag: para +#: stereotypes.xml:41 +#, no-c-format +msgid "" +"A stereotype is a Java annotation type. This stereotype identifies action " +"classes in some MVC framework:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:44 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:46 +#, no-c-format +msgid "We use the stereotype by applying the annotation to a Web Bean." +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:48 +#, no-c-format +msgid "" +"<![CDATA[@Action \n" +"public class LoginAction { ... }]]>" +msgstr "" + +#. Tag: title +#: stereotypes.xml:51 +#, no-c-format +msgid "Default scope and deployment type for a stereotype" +msgstr "" + +#. Tag: para +#: stereotypes.xml:53 +#, no-c-format +msgid "" +"A stereotype may specify a default scope and/or default deployment type for " +"Web Beans with that stereotype. For example, if the deployment type " +"<literal>@WebTier</literal> identifies Web Beans that should only be " +"deployed when the system executes as a web application, we might specify the " +"following defaults for action classes:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:59 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:61 +#, no-c-format +msgid "" +"Of course, a particular action may still override these defaults if " +"necessary:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:64 +#, no-c-format +msgid "" +"<![CDATA[@Dependent @Mock @Action \n" +"public class MockLoginAction { ... }]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:66 +#, no-c-format +msgid "" +"If we want to force all actions to a particular scope, we can do that too." +msgstr "" + +#. Tag: title +#: stereotypes.xml:72 +#, no-c-format +msgid "Restricting scope and type with a stereotype" +msgstr "" + +#. Tag: para +#: stereotypes.xml:74 +#, no-c-format +msgid "" +"Suppose that we wish to prevent actions from declaring certain scopes. Web " +"Beans lets us explicitly specify the set of allowed scopes for Web Beans " +"with a certain stereotype. For example:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:78 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype(supportedScopes=RequestScoped.class)\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:80 +#, no-c-format +msgid "" +"If a particular action class attempts to specify a scope other than the Web " +"Beans request scope, an exception will be thrown by the Web Bean manager at " +"initialization time." +msgstr "" + +#. Tag: para +#: stereotypes.xml:84 +#, no-c-format +msgid "" +"We can also force all Web Bean with a certain stereotype to implement an " +"interface or extend a class:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:87 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype(requiredTypes=AbstractAction.class)\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:89 +#, no-c-format +msgid "" +"If a particular action class does not extend the class " +"<literal>AbstractAction</literal>, an exception will be thrown by the Web " +"Bean manager at initialization time." +msgstr "" + +#. Tag: title +#: stereotypes.xml:96 +#, no-c-format +msgid "Interceptor bindings for stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:98 +#, no-c-format +msgid "" +"A stereotype may specify a set of interceptor bindings to be inherited by " +"all Web Beans with that stereotype." +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:101 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@Transactional(requiresNew=true)\n" +"@Secure\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:103 +#, no-c-format +msgid "" +"This helps us get technical concerns even further away from the business " +"code!" +msgstr "" + +#. Tag: title +#: stereotypes.xml:109 +#, no-c-format +msgid "Name defaulting with stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:111 +#, no-c-format +msgid "" +"Finally, we can specify that all Web Beans with a certain stereotype have a " +"Web Bean name, defaulted by the Web Bean manager. Actions are often " +"referenced in JSP pages, so they're a perfect use case for this feature. All " +"we need to do is add an empty <literal>@Named</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:116 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@Transactional(requiresNew=true)\n" +"@Secure\n" +"@Named\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:118 +#, no-c-format +msgid "" +"Now, <literal>LoginAction</literal> will have the name <literal>loginAction</" +"literal>." +msgstr "" + +#. Tag: title +#: stereotypes.xml:124 +#, no-c-format +msgid "Standard stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:126 +#, no-c-format +msgid "" +"We've already met two standard stereotypes defined by the Web Beans " +"specification: <literal>@Interceptor</literal> and <literal>@Decorator</" +"literal>." +msgstr "" + +#. Tag: para +#: stereotypes.xml:129 +#, no-c-format +msgid "Web Beans defines one further standard stereotype:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:131 +#, no-c-format +msgid "" +"<![CDATA[@Named \n" +"@RequestScoped \n" +"@Stereotype \n" +"@Target({TYPE, METHOD}) \n" +"@Retention(RUNTIME) \n" +"public @interface Model {} ]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:133 +#, no-c-format +msgid "" +"This stereotype is intended for use with JSF. Instead of using JSF managed " +"beans, just annotate a Web Bean <literal>@Model</literal>, and use it " +"directly in your JSF page." +msgstr "" Added: doc/trunk/reference/it-IT/modules/xml.po =================================================================== --- doc/trunk/reference/it-IT/modules/xml.po (rev 0) +++ doc/trunk/reference/it-IT/modules/xml.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,352 @@ +# Language it-IT translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: xml.xml:4 +#, no-c-format +msgid "Defining Web Beans using XML" +msgstr "" + +#. Tag: para +#: xml.xml:6 +#, no-c-format +msgid "" +"So far, we've seen plenty of examples of Web Beans declared using " +"annotations. However, there are a couple of occasions when we can't use " +"annotations to define the Web Bean:" +msgstr "" + +#. Tag: para +#: xml.xml:12 +#, no-c-format +msgid "when the implementation class comes from some preexisting library, or" +msgstr "" + +#. Tag: para +#: xml.xml:15 +#, no-c-format +msgid "" +"when there should be multiple Web Beans with the same implementation class." +msgstr "" + +#. Tag: para +#: xml.xml:20 +#, no-c-format +msgid "In either of these cases, Web Beans gives us two options:" +msgstr "" + +#. Tag: para +#: xml.xml:23 +#, no-c-format +msgid "write a producer method, or" +msgstr "" + +#. Tag: para +#: xml.xml:24 +#, no-c-format +msgid "declare the Web Bean using XML." +msgstr "" + +#. Tag: para +#: xml.xml:27 +#, no-c-format +msgid "" +"Many frameworks use XML to provide metadata relating to Java classes. " +"However, Web Beans uses a very different approach to specifying the names of " +"Java classes, fields or methods to most other frameworks. Instead of writing " +"class and member names as the string values of XML elements and attributes, " +"Web Beans lets you use the class or member name as the name of the XML " +"element." +msgstr "" + +#. Tag: para +#: xml.xml:33 +#, no-c-format +msgid "" +"The advantage of this approach is that you can write an XML schema that " +"prevents spelling errors in your XML document. It's even possible for a tool " +"to generate the XML schema automatically from the compiled Java code. Or, an " +"integrated development environment could perform the same validation without " +"the need for the explicit intermediate generation step." +msgstr "" + +#. Tag: title +#: xml.xml:40 +#, no-c-format +msgid "Declaring Web Bean classes" +msgstr "" + +#. Tag: para +#: xml.xml:42 +#, no-c-format +msgid "" +"For each Java package, Web Beans defines a corresponding XML namespace. The " +"namespace is formed by prepending <literal>urn:java:</literal> to the Java " +"package name. For the package <literal>com.mydomain.myapp</literal>, the XML " +"namespace is <literal>urn:java:com.mydomain.myapp</literal>." +msgstr "" + +#. Tag: para +#: xml.xml:47 +#, no-c-format +msgid "" +"Java types belonging to a package are referred to using an XML element in " +"the namespace corresponding to the package. The name of the element is the " +"name of the Java type. Fields and methods of the type are specified by child " +"elements in the same namespace. If the type is an annotation, members are " +"specified by attributes of the element." +msgstr "" + +#. Tag: para +#: xml.xml:53 +#, no-c-format +msgid "" +"For example, the element <literal><util:Date/></literal> in the " +"following XML fragment refers to the class <literal>java.util.Date</literal>:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:56 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans xmlns=\"urn:java:javax.webbeans\"\n" +" xmlns:util=\"urn:java:java.util\">\n" +"\n" +" <util:Date/>\n" +"\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:58 +#, no-c-format +msgid "" +"And this is all the code we need to declare that <literal>Date</literal> is " +"a simple Web Bean! An instance of <literal>Date</literal> may now be " +"injected by any other Web Bean:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:62 +#, no-c-format +msgid "<![CDATA[@Current Date date]]>" +msgstr "" + +#. Tag: title +#: xml.xml:67 +#, no-c-format +msgid "Declaring Web Bean metadata" +msgstr "" + +#. Tag: para +#: xml.xml:69 +#, no-c-format +msgid "" +"We can declare the scope, deployment type and interceptor binding types " +"using direct child elements of the Web Bean declaration:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:72 +#, no-c-format +msgid "" +"<![CDATA[<myapp:ShoppingCart>\n" +" <SessionScoped/>\n" +" <myfwk:Transactional requiresNew=\"true\"/>\n" +" <myfwk:Secure/>\n" +"</myapp:ShoppingCart>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:74 +#, no-c-format +msgid "We use exactly the same approach to specify names and binding type:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:76 +#, no-c-format +msgid "" +"<![CDATA[<util:Date>\n" +" <Named>currentTime</Named>\n" +"</util:Date>\n" +"\n" +"<util:Date>\n" +" <SessionScoped/>\n" +" <myapp:Login/>\n" +" <Named>loginTime</Named>\n" +"</util:Date>\n" +"\n" +"<util:Date>\n" +" <ApplicationScoped/>\n" +" <myapp:SystemStart/>\n" +" <Named>systemStartTime</Named>\n" +"</util:Date>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:78 +#, no-c-format +msgid "" +"Where <literal>@Login</literal> and <literal>@SystemStart</literal> are " +"binding annotations types." +msgstr "" + +#. Tag: programlisting +#: xml.xml:81 +#, no-c-format +msgid "" +"<![CDATA[@Current Date currentTime;\n" +"@Login Date loginTime;\n" +"@SystemStart Date systemStartTime;]]>" +msgstr "" + +#. Tag: para +#: xml.xml:83 +#, no-c-format +msgid "As usual, a Web Bean may support multiple binding types:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:85 +#, no-c-format +msgid "" +"<![CDATA[<myapp:AsynchronousChequePaymentProcessor>\n" +" <myapp:PayByCheque/>\n" +" <myapp:Asynchronous/>\n" +"</myapp:AsynchronousChequePaymentProcessor>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:87 +#, no-c-format +msgid "" +"Interceptors and decorators are just simple Web Beans, so they may be " +"declared just like any other simple Web Bean:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:90 +#, no-c-format +msgid "" +"<![CDATA[<myfwk:TransactionInterceptor>\n" +" <Interceptor/>\n" +" <myfwk:Transactional/>\n" +"</myfwk:TransactionInterceptor>]]>" +msgstr "" + +#. Tag: title +#: xml.xml:95 +#, no-c-format +msgid "Declaring Web Bean members" +msgstr "" + +#. Tag: para +#: xml.xml:97 +#, no-c-format +msgid "TODO!" +msgstr "" + +#. Tag: title +#: xml.xml:104 +#, no-c-format +msgid "Declaring inline Web Beans" +msgstr "" + +#. Tag: para +#: xml.xml:106 +#, no-c-format +msgid "Web Beans lets us define a Web Bean at an injection point. For example:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:108 +#, no-c-format +msgid "" +"<![CDATA[<myapp:System>\n" +" <ApplicationScoped/>\n" +" <myapp:admin>\n" +" <myapp:Name>\n" +" <myapp:firstname>Gavin</myapp:firstname>\n" +" <myapp:lastname>King</myapp:lastname>\n" +" <myapp:email>gavin(a)hibernate.org</myapp:email>\n" +" </myapp:Name>\n" +" </myapp:admin>\n" +"</myapp:System>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:110 +#, no-c-format +msgid "" +"The <literal><Name></literal> element declares a simple Web Bean of " +"scope <literal>@Dependent</literal> and class <literal>Name</literal>, with " +"a set of initial field values. This Web Bean has a special, container-" +"generated binding and is therefore injectable only to the specific injection " +"point at which it is declared." +msgstr "" + +#. Tag: para +#: xml.xml:116 +#, no-c-format +msgid "" +"This simple but powerful feature allows the Web Beans XML format to be used " +"to specify whole graphs of Java objects. It's not quite a full databinding " +"solution, but it's close!" +msgstr "" + +#. Tag: title +#: xml.xml:123 +#, no-c-format +msgid "Using a schema" +msgstr "" + +#. Tag: para +#: xml.xml:125 +#, no-c-format +msgid "" +"If we want our XML document format to be authored by people who aren't Java " +"developers, or who don't have access to our code, we need to provide a " +"schema. There's nothing specific to Web Beans about writing or using the " +"schema." +msgstr "" + +#. Tag: programlisting +#: xml.xml:130 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans xmlns=\"urn:java:javax.webbeans\"\n" +" xmlns:myapp=\"urn:java:com.mydomain.myapp\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"urn:java:javax.webbeans http://java.sun.com/" +"jee/web-beans-1.0.xsd\n" +" urn:java:com.mydomain.myapp http://mydomain." +"com/xsd/myapp-1.2.xsd\">\n" +"\n" +" <myapp:System>\n" +" ...\n" +" </myapp:System>\n" +"\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:132 +#, no-c-format +msgid "" +"Writing an XML schema is quite tedious. Therefore, the Web Beans RI project " +"will provide a tool which automatically generates the XML schema from " +"compiled Java code." +msgstr "" Added: doc/trunk/reference/ja-JP/Book_Info.po =================================================================== --- doc/trunk/reference/ja-JP/Book_Info.po (rev 0) +++ doc/trunk/reference/ja-JP/Book_Info.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,56 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: 2008-12-19 20:29+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: Book_Info.xml:6 +#, no-c-format +msgid "Introduction to Web Beans" +msgstr "" + +#. Tag: subtitle +#: Book_Info.xml:7 +#, no-c-format +msgid "" +"The new Java standard for dependency injection and contextual state " +"management" +msgstr "" + +#. Tag: author +#: Book_Info.xml:10 +#, no-c-format +msgid "<firstname>Gavin</firstname> <surname>King</surname>" +msgstr "" + +#. Tag: affiliation +#: Book_Info.xml:13 +#, no-c-format +msgid "" +"<jobtitle>Web Beans (JSR-299) specification lead</jobtitle> <orgname>Red Hat " +"Middleware LLC</orgname>" +msgstr "" + +#. Tag: author +#: Book_Info.xml:19 +#, no-c-format +msgid "<firstname>Pete</firstname> <surname>Muir</surname>" +msgstr "" + +#. Tag: affiliation +#: Book_Info.xml:22 +#, no-c-format +msgid "" +"<jobtitle>Web Beans (JSR-299) Reference Implementation lead</jobtitle> " +"<orgname>Red Hat Middleware LLC</orgname>" +msgstr "" Added: doc/trunk/reference/ja-JP/master.po =================================================================== --- doc/trunk/reference/ja-JP/master.po (rev 0) +++ doc/trunk/reference/ja-JP/master.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,38 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: master.xml:12 +#, no-c-format +msgid "Using contextual objects" +msgstr "" + +#. Tag: title +#: master.xml:25 +#, no-c-format +msgid "Developing loosely-coupled code" +msgstr "" + +#. Tag: title +#: master.xml:35 +#, no-c-format +msgid "Making the most of strong typing" +msgstr "" + +#. Tag: title +#: master.xml:46 +#, no-c-format +msgid "Web Beans and the Java EE ecosystem" +msgstr "" Added: doc/trunk/reference/ja-JP/modules/decorators.po =================================================================== --- doc/trunk/reference/ja-JP/modules/decorators.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/decorators.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,243 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: decorators.xml:4 +#, no-c-format +msgid "Decorators" +msgstr "" + +#. Tag: para +#: decorators.xml:6 +#, no-c-format +msgid "" +"Interceptors are a powerful way to capture and separate concerns which are " +"<emphasis>orthogonal</emphasis> to the type system. Any interceptor is able " +"to intercept invocations of any Java type. This makes them perfect for " +"solving technical concerns such as transaction management and security. " +"However, by nature, interceptors are unaware of the actual semantics of the " +"events they intercept. Thus, interceptors aren't an appropriate tool for " +"separating business-related concerns." +msgstr "" + +#. Tag: para +#: decorators.xml:14 +#, no-c-format +msgid "" +"The reverse is true of <emphasis>decorators</emphasis>. A decorator " +"intercepts invocations only for a certain Java interface, and is therefore " +"aware of all the semantics attached to that interface. This makes decorators " +"a perfect tool for modeling some kinds of business concerns. It also means " +"that a decorator doesn't have the generality of an interceptor. Decorators " +"aren't able to solve technical concerns that cut across many disparate types." +msgstr "" + +#. Tag: para +#: decorators.xml:22 +#, no-c-format +msgid "Suppose we have an interface that represents accounts:" +msgstr "" + +#. Tag: programlisting +#: decorators.xml:24 +#, no-c-format +msgid "" +"<![CDATA[public interface Account {\n" +" public BigDecimal getBalance();\n" +" public User getOwner();\n" +" public void withdraw(BigDecimal amount);\n" +" public void deposit(BigDecimal amount);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:26 +#, no-c-format +msgid "" +"Several different Web Beans in our system implement the <literal>Account</" +"literal> interface. However, we have a common legal requirement that, for " +"any kind of account, large transactions must be recorded by the system in a " +"special log. This is a perfect job for a decorator." +msgstr "" + +#. Tag: para +#: decorators.xml:32 +#, no-c-format +msgid "" +"A decorator is a simple Web Bean that implements the type it decorates and " +"is annotated <literal>@Decorator</literal>." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:35 +#, no-c-format +msgid "" +"<![CDATA[@Decorator\n" +"public abstract class LargeTransactionDecorator \n" +" implements Account {\n" +" \n" +" @Decorates Account account;\n" +" \n" +" @PersistenceContext EntityManager em;\n" +" \n" +" public void withdraw(BigDecimal amount) {\n" +" account.withdraw(amount);\n" +" if ( amount.compareTo(LARGE_AMOUNT)>0 ) {\n" +" em.persist( new LoggedWithdrawl(amount) );\n" +" }\n" +" }\n" +" \n" +" public void deposit(BigDecimal amount);\n" +" account.deposit(amount);\n" +" if ( amount.compareTo(LARGE_AMOUNT)>0 ) {\n" +" em.persist( new LoggedDeposit(amount) );\n" +" }\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:37 +#, no-c-format +msgid "" +"Unlike other simple Web Beans, a decorator may be an abstract class. If " +"there's nothing special the decorator needs to do for a particular method of " +"the decorated interface, you don't need to implement that method." +msgstr "" + +#. Tag: title +#: decorators.xml:43 +#, no-c-format +msgid "Delegate attributes" +msgstr "" + +#. Tag: para +#: decorators.xml:45 +#, no-c-format +msgid "" +"All decorators have a <emphasis>delegate attribute</emphasis>. The type and " +"binding types of the delegate attribute determine which Web Beans the " +"decorator is bound to. The delegate attribute type must implement or extend " +"all interfaces implemented by the decorator." +msgstr "" + +#. Tag: para +#: decorators.xml:50 +#, no-c-format +msgid "" +"This delegate attribute specifies that the decorator is bound to all Web " +"Beans that implement <literal>Account</literal>:" +msgstr "" + +#. Tag: programlisting +#: decorators.xml:53 +#, no-c-format +msgid "<![CDATA[@Decorates Account account;]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:55 +#, no-c-format +msgid "" +"A delegate attribute may specify a binding annotation. Then the decorator " +"will only be bound to Web Beans with the same binding." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:58 +#, no-c-format +msgid "<![CDATA[@Decorates @Foreign Account account;]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:60 +#, no-c-format +msgid "A decorator is bound to any Web Bean which:" +msgstr "" + +#. Tag: para +#: decorators.xml:64 +#, no-c-format +msgid "has the type of the delegate attribute as an API type, and" +msgstr "" + +#. Tag: para +#: decorators.xml:67 +#, no-c-format +msgid "has all binding types that are declared by the delegate attribute." +msgstr "" + +#. Tag: para +#: decorators.xml:71 +#, no-c-format +msgid "" +"The decorator may invoke the delegate attribute, which has much the same " +"effect as calling <literal>InvocationContext.proceed()</literal> from an " +"interceptor." +msgstr "" + +#. Tag: title +#: decorators.xml:78 +#, no-c-format +msgid "Enabling decorators" +msgstr "" + +#. Tag: para +#: decorators.xml:80 +#, no-c-format +msgid "" +"We need to <emphasis>enable</emphasis> our decorator in <literal>web-beans." +"xml</literal>." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:83 +#, no-c-format +msgid "" +"<![CDATA[<Decorators>\n" +" <myapp:LargeTransactionDecorator/>\n" +"</Decorators>]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:85 +#, no-c-format +msgid "" +"This declaration serves the same purpose for decorators that the " +"<literal><Interceptors></literal> declaration serves for interceptors:" +msgstr "" + +#. Tag: para +#: decorators.xml:90 +#, no-c-format +msgid "" +"it enables us to specify a total ordering for all decorators in our system, " +"ensuring deterministic behavior, and" +msgstr "" + +#. Tag: para +#: decorators.xml:94 +#, no-c-format +msgid "it lets us enable or disable decorator classes at deployment time." +msgstr "" + +#. Tag: para +#: decorators.xml:98 +#, no-c-format +msgid "" +"Interceptors for a method are called before decorators that apply to that " +"method." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/ee.po =================================================================== --- doc/trunk/reference/ja-JP/modules/ee.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/ee.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,329 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: ee.xml:4 +#, no-c-format +msgid "Java EE integration" +msgstr "" + +#. Tag: para +#: ee.xml:6 +#, no-c-format +msgid "" +"Web Beans is fully integrated into the Java EE environment. Web Beans have " +"access to Java EE resources and JPA persistence contexts. They may be used " +"in Unified EL expressions in JSF and JSP pages. They may even be injected " +"into some objects, such as Servlets and Message-Driven Beans, which are not " +"Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:12 +#, no-c-format +msgid "Injecting Java EE resources into a Web Bean" +msgstr "" + +#. Tag: para +#: ee.xml:14 +#, no-c-format +msgid "" +"All simple and enterprise Web Beans may take advantage of Java EE dependency " +"injection using <literal>@Resource</literal>, <literal>@EJB</literal> and " +"<literal>@PersistenceContext</literal>. We've already seen a couple of " +"examples of this, though we didn't pay much attention at the time:" +msgstr "" + +#. Tag: programlisting +#: ee.xml:19 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +"\n" +" @Resource Transaction transaction;\n" +"\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: ee.xml:21 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped\n" +"public class Login {\n" +"\n" +" @Current Credentials credentials;\n" +" @PersistenceContext EntityManager userDatabase;\n" +" \n" +" ...\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: ee.xml:23 +#, no-c-format +msgid "" +"The Java EE <literal>@PostConstruct</literal> and <literal>@PreDestroy</" +"literal> callbacks are also supported for all simple and enterprise Web " +"Beans. The <literal>@PostConstruct</literal> method is called after " +"<emphasis>all</emphasis> injection has been performed." +msgstr "" + +#. Tag: para +#: ee.xml:28 +#, no-c-format +msgid "" +"There is one restriction to be aware of here: <literal>@PersistenceContext" +"(type=EXTENDED)</literal> is not supported for simple Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:35 +#, no-c-format +msgid "Calling a Web Bean from a Servlet" +msgstr "" + +#. Tag: para +#: ee.xml:37 +#, no-c-format +msgid "" +"It's easy to use a Web Bean from a Servlet in Java EE 6. Simply inject the " +"Web Bean using Web Beans field or initializer method injection." +msgstr "" + +#. Tag: programlisting +#: ee.xml:40 +#, no-c-format +msgid "" +"public class Login extends HttpServlet {\n" +"\n" +" @Current Credentials credentials;\n" +" @Current Login login;\n" +"\n" +" @Override\n" +" public void service(HttpServletRequest request, HttpServletResponse " +"response)\n" +" throws ServletException, IOException {\n" +" credentials.setUsername( request.getAttribute(\"username\") ):\n" +" credentials.setPassword( request.getAttribute(\"password\") ):\n" +" login.login();\n" +" if ( login.isLoggedIn() ) {\n" +" response.sendRedirect(\"/home.jsp\");\n" +" }\n" +" else {\n" +" response.sendRedirect(\"/loginError.jsp\");\n" +" }\n" +" }\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:42 +#, no-c-format +msgid "" +"The Web Beans client proxy takes care of routing method invocations from the " +"Servlet to the correct instances of <literal>Credentials</literal> and " +"<literal>Login</literal> for the current request and HTTP session." +msgstr "" + +#. Tag: title +#: ee.xml:49 +#, no-c-format +msgid "Calling a Web Bean from a Message-Driven Bean" +msgstr "" + +#. Tag: para +#: ee.xml:51 +#, no-c-format +msgid "" +"Web Beans injection applies to all EJBs, even when they aren't under the " +"control of the Web Bean manager (if they were obtained by direct JNDI " +"lookup, or injection using <literal>@EJB</literal>, for example. In " +"particular, you can use Web Beans injection in Message-Driven Beans, which " +"are not considered Web Beans because you can't inject them." +msgstr "" + +#. Tag: para +#: ee.xml:57 +#, no-c-format +msgid "" +"You can even use Web Beans interceptor bindings for Message-Driven Beans." +msgstr "" + +#. Tag: programlisting +#: ee.xml:59 +#, no-c-format +msgid "" +"@Transactional @MessageDriven\n" +"public class ProcessOrder implements MessageListener {\n" +"\n" +" @Current Inventory inventory;\n" +" @PersistenceContext EntityManager em;\n" +"\n" +" public void onMessage(Message message) {\n" +" ...\n" +" }\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:61 +#, no-c-format +msgid "" +"Thus, receiving messages is super-easy in a Web Beans environment. But " +"beware that there is no session or conversation context available when a " +"message is delivered to a Message-Driven Bean. Only <literal>@RequestScoped</" +"literal> and <literal>@ApplicationScoped</literal> Web Beans are available." +msgstr "" + +#. Tag: para +#: ee.xml:66 +#, no-c-format +msgid "It's also easy to send messages using Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:71 +#, no-c-format +msgid "JMS endpoints" +msgstr "" + +#. Tag: para +#: ee.xml:73 +#, no-c-format +msgid "" +"Sending messages using JMS can be quite complex, because of the number of " +"different objects you need to deal with. For queues we have <literal>Queue</" +"literal>, <literal>QueueConnectionFactory</literal>, " +"<literal>QueueConnection</literal>, <literal>QueueSession</literal> and " +"<literal>QueueSender</literal>. For topics we have <literal>Topic</literal>, " +"<literal>TopicConnectionFactory</literal>, <literal>TopicConnection</" +"literal>, <literal>TopicSession</literal> and <literal>TopicPublisher</" +"literal>. Each of these objects has its own lifecycle and threading model " +"that we need to worry about." +msgstr "" + +#. Tag: para +#: ee.xml:82 +#, no-c-format +msgid "" +"Web Beans takes care of all this for us. All we need to do is declare the " +"queue or topic in <literal>web-beans.xml</literal>, specifying an associated " +"binding type and connection factory." +msgstr "" + +#. Tag: programlisting +#: ee.xml:86 +#, no-c-format +msgid "" +"<![CDATA[<Queue>\n" +" <destination>java:comp/env/jms/OrderQueue</destination>\n" +" <connectionFactory>java:comp/env/jms/QueueConnectionFactory</" +"connectionFactory>\n" +" <myapp:OrderProcessor/> \n" +"</Queue>]]>" +msgstr "" + +#. Tag: programlisting +#: ee.xml:88 +#, no-c-format +msgid "" +"<![CDATA[<Topic>\n" +" <destination>java:comp/env/jms/StockPrices</destination>\n" +" <connectionFactory>java:comp/env/jms/TopicConnectionFactory</" +"connectionFactory>\n" +" <myapp:StockPrices/> \n" +"</Topic>]]>" +msgstr "" + +#. Tag: para +#: ee.xml:90 +#, no-c-format +msgid "" +"Now we can just inject the <literal>Queue</literal>, " +"<literal>QueueConnection</literal>, <literal>QueueSession</literal> or " +"<literal>QueueSender</literal> for a queue, or the <literal>Topic</literal>, " +"<literal>TopicConnection</literal>, <literal>TopicSession</literal> or " +"<literal>TopicPublisher</literal> for a topic." +msgstr "" + +#. Tag: programlisting +#: ee.xml:96 +#, no-c-format +msgid "" +"@OrderProcessor QueueSender orderSender;\n" +"@OrderProcessor QueueSession orderSession;\n" +"\n" +"public void sendMessage() {\n" +" MapMessage msg = orderSession.createMapMessage();\n" +" ...\n" +" orderSender.send(msg);\n" +"}" +msgstr "" + +#. Tag: programlisting +#: ee.xml:98 +#, no-c-format +msgid "" +"@StockPrices TopicPublisher pricePublisher;\n" +"@StockPrices TopicSession priceSession;\n" +"\n" +"public void sendMessage(String price) {\n" +" pricePublisher.send( priceSession.createTextMessage(price) );\n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:100 +#, no-c-format +msgid "" +"The lifecycle of the injected JMS objects are completely controlled by the " +"Web Bean manager." +msgstr "" + +#. Tag: title +#: ee.xml:106 +#, no-c-format +msgid "Packaging and deployment" +msgstr "" + +#. Tag: para +#: ee.xml:108 +#, no-c-format +msgid "" +"Web Beans doesn't define any special deployment archive. You can package Web " +"Beans in JARs, EJB-JARs or WARsany deployment location in the " +"application classpath. However, each archive that contains Web Beans must " +"include a file named <literal>web-beans.xml</literal> in the <literal>META-" +"INF</literal> or <literal>WEB-INF</literal> directory. The file may be " +"empty. Web Beans deployed in archives that do not have a <literal>web-beans." +"xml</literal> file will not be available for use in the application." +msgstr "" + +#. Tag: para +#: ee.xml:116 +#, no-c-format +msgid "" +"For Java SE execution, Web Beans may be deployed in any location in which " +"EJBs may be deployed for execution by the embeddable EJB Lite container. " +"Again, each location must contain a <literal>web-beans.xml</literal> file." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/events.po =================================================================== --- doc/trunk/reference/ja-JP/modules/events.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/events.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,649 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: events.xml:4 +#, no-c-format +msgid "Events" +msgstr "" + +#. Tag: para +#: events.xml:6 +#, no-c-format +msgid "" +"The Web Beans event notification facility allows Web Beans to interact in a " +"totally decoupled manner. Event <emphasis>producers</emphasis> raise events " +"that are then delivered to event <emphasis>observers</emphasis> by the Web " +"Bean manager. This basic schema might sound like the familiar observer/" +"observable pattern, but there are a couple of twists:" +msgstr "" + +#. Tag: para +#: events.xml:14 +#, no-c-format +msgid "" +"not only are event producers decoupled from observers; observers are " +"completely decoupled from producers," +msgstr "" + +#. Tag: para +#: events.xml:18 +#, no-c-format +msgid "" +"observers can specify a combination of \"selectors\" to narrow the set of " +"event notifications they will receive, and" +msgstr "" + +#. Tag: para +#: events.xml:22 +#, no-c-format +msgid "" +"observers can be notified immediately, or can specify that delivery of the " +"event should be delayed until the end of the current transaction" +msgstr "" + +#. Tag: title +#: events.xml:28 +#, no-c-format +msgid "Event observers" +msgstr "" + +#. Tag: para +#: events.xml:30 +#, no-c-format +msgid "" +"An <emphasis>observer method</emphasis> is a method of a Web Bean with a " +"parameter annotated <literal>@Observes</literal>." +msgstr "" + +#. Tag: programlisting +#: events.xml:33 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyDocumentEvent(@Observes Document document) " +"{ ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:35 +#, no-c-format +msgid "" +"The annotated parameter is called the <emphasis>event parameter</emphasis>. " +"The type of the event parameter is the observed <emphasis>event type</" +"emphasis>. Observer methods may also specify \"selectors\", which are just " +"instances of Web Beans binding types. When a binding type is used as an " +"event selector, it is called an <emphasis>event binding type</emphasis>." +msgstr "" + +#. Tag: programlisting +#: events.xml:41 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Target({PARAMETER, FIELD})\n" +"@Retention(RUNTIME)\n" +"public @interface Updated { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:43 +#, no-c-format +msgid "" +"We specify the event bindings of the observer method by annotating the event " +"parameter:" +msgstr "" + +#. Tag: programlisting +#: events.xml:46 events.xml:190 +#, no-c-format +msgid "" +"<![CDATA[public void afterDocumentUpdate(@Observes @Updated Document " +"document) { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:48 +#, no-c-format +msgid "" +"An observer method need not specify any event bindingsin this case it " +"is interested in <emphasis>all</emphasis> events of a particular type. If it " +"does specify event bindings, it is only interested in events which also have " +"those event bindings." +msgstr "" + +#. Tag: para +#: events.xml:53 +#, no-c-format +msgid "" +"The observer method may have additional parameters, which are injected " +"according to the usual Web Beans method parameter injection semantics:" +msgstr "" + +#. Tag: programlisting +#: events.xml:56 +#, no-c-format +msgid "" +"<![CDATA[public void afterDocumentUpdate(@Observes @Updated Document " +"document, User user) { ... }]]>" +msgstr "" + +#. Tag: title +#: events.xml:61 +#, no-c-format +msgid "Event producers" +msgstr "" + +#. Tag: para +#: events.xml:63 +#, no-c-format +msgid "" +"The event producer may obtain an <emphasis>event notifier</emphasis> object " +"by injection:" +msgstr "" + +#. Tag: programlisting +#: events.xml:66 +#, no-c-format +msgid "<![CDATA[@Observable Event<Document> documentEvent]]>" +msgstr "" + +#. Tag: para +#: events.xml:68 +#, no-c-format +msgid "" +"The <literal>@Observable</literal> annotation implicitly defines a Web Bean " +"with scope <literal>@Dependent</literal> and deployment type " +"<literal>@Standard</literal>, with an implementation provided by the Web " +"Bean manager." +msgstr "" + +#. Tag: para +#: events.xml:72 +#, no-c-format +msgid "" +"A producer raises events by calling the <literal>fire()</literal> method of " +"the <literal>Event</literal> interface, passing an <emphasis>event object</" +"emphasis>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:75 +#, no-c-format +msgid "<![CDATA[documentEvent.fire(document);]]>" +msgstr "" + +#. Tag: para +#: events.xml:77 +#, no-c-format +msgid "" +"An event object may be an instance of any Java class that has no type " +"variables or wildcard type parameters. The event will be delivered to every " +"observer method that:" +msgstr "" + +#. Tag: para +#: events.xml:83 events.xml:107 events.xml:126 +#, no-c-format +msgid "has an event parameter to which the event object is assignable, and" +msgstr "" + +#. Tag: para +#: events.xml:86 +#, no-c-format +msgid "specifies no event bindings." +msgstr "" + +#. Tag: para +#: events.xml:90 +#, no-c-format +msgid "" +"The Web Bean manager simply calls all the observer methods, passing the " +"event object as the value of the event parameter. If any observer method " +"throws an exception, the Web Bean manager stops calling observer methods, " +"and the exception is rethrown by the <literal>fire()</literal> method." +msgstr "" + +#. Tag: para +#: events.xml:95 +#, no-c-format +msgid "" +"To specify a \"selector\", the event producer may pass an instance of the " +"event binding type to the <literal>fire()</literal> method:" +msgstr "" + +#. Tag: programlisting +#: events.xml:98 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.fire( document, new AnnotationLiteral<Updated>()" +"{} );]]>" +msgstr "" + +#. Tag: para +#: events.xml:100 +#, no-c-format +msgid "" +"The helper class <literal>AnnotationLiteral</literal> makes it possible to " +"instantiate binding types inline, since this is otherwise difficult to do in " +"Java." +msgstr "" + +#. Tag: para +#: events.xml:103 +#, no-c-format +msgid "The event will be delivered to every observer method that:" +msgstr "" + +#. Tag: para +#: events.xml:110 +#, no-c-format +msgid "" +"does not specify any event binding <emphasis>except</emphasis> for the event " +"bindings passed to <literal>fire()</literal>." +msgstr "" + +#. Tag: para +#: events.xml:115 +#, no-c-format +msgid "" +"Alternatively, event bindings may be specified by annotating the event " +"notifier injection point:" +msgstr "" + +#. Tag: programlisting +#: events.xml:118 +#, no-c-format +msgid "<![CDATA[@Observable @Updated Event<Document> documentUpdatedEvent]]>" +msgstr "" + +#. Tag: para +#: events.xml:120 +#, no-c-format +msgid "" +"Then every event fired via this instance of <literal>Event</literal> has the " +"annotated event binding. The event will be delivered to every observer " +"method that:" +msgstr "" + +#. Tag: para +#: events.xml:129 +#, no-c-format +msgid "" +"does not specify any event binding <emphasis>except</emphasis> for the event " +"bindings passed to <literal>fire()</literal> or the annotated event bindings " +"of the event notifier injection point." +msgstr "" + +#. Tag: title +#: events.xml:138 +#, no-c-format +msgid "Registering observers dynamically" +msgstr "" + +#. Tag: para +#: events.xml:140 +#, no-c-format +msgid "" +"It's often useful to register an event observer dynamically. The application " +"may implement the <literal>Observer</literal> interface and register an " +"instance with an event notifier by calling the <literal>observe()</literal> " +"method." +msgstr "" + +#. Tag: programlisting +#: events.xml:144 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.observe( new Observer<Document>() { public void notify" +"(Document doc) { ... } } );]]>" +msgstr "" + +#. Tag: para +#: events.xml:146 +#, no-c-format +msgid "" +"Event binding types may be specified by the event notifier injection point " +"or by passing event binding type instances to the <literal>observe()</" +"literal> method:" +msgstr "" + +#. Tag: programlisting +#: events.xml:149 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.observe( new Observer<Document>() { public void notify" +"(Document doc) { ... } }, \n" +" new " +"AnnotationLiteral<Updated>(){} );]]>" +msgstr "" + +#. Tag: title +#: events.xml:154 +#, no-c-format +msgid "Event bindings with members" +msgstr "" + +#. Tag: para +#: events.xml:156 +#, no-c-format +msgid "An event binding type may have annotation members:" +msgstr "" + +#. Tag: programlisting +#: events.xml:158 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Target({PARAMETER, FIELD})\n" +"@Retention(RUNTIME)\n" +"public @interface Role {\n" +" RoleType value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:160 +#, no-c-format +msgid "" +"The member value is used to narrow the messages delivered to the observer:" +msgstr "" + +#. Tag: programlisting +#: events.xml:162 +#, no-c-format +msgid "" +"<![CDATA[public void adminLoggedIn(@Observes @Role(ADMIN) LoggedIn event) " +"{ ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:164 +#, no-c-format +msgid "" +"Event binding type members may be specified statically by the event " +"producer, via annotations at the event notifier injection point:" +msgstr "" + +#. Tag: programlisting +#: events.xml:167 +#, no-c-format +msgid "<![CDATA[@Observable @Role(ADMIN) Event<LoggedIn> LoggedInEvent;}}]]>" +msgstr "" + +#. Tag: para +#: events.xml:169 +#, no-c-format +msgid "" +"Alternatively, the value of the event binding type member may be determined " +"dynamically by the event producer. We start by writing an abstract subclass " +"of <literal>AnnotationLiteral</literal>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:172 +#, no-c-format +msgid "" +"<![CDATA[abstract class RoleBinding \n" +" extends AnnotationLiteral<Role> \n" +" implements Role {}]]>" +msgstr "" + +#. Tag: para +#: events.xml:174 +#, no-c-format +msgid "" +"The event producer passes an instance of this class to <literal>fire()</" +"literal>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:176 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.fire( document, new RoleBinding() { public void value" +"() { return user.getRole(); } } );]]>" +msgstr "" + +#. Tag: title +#: events.xml:181 +#, no-c-format +msgid "Multiple event bindings" +msgstr "" + +#. Tag: para +#: events.xml:183 +#, no-c-format +msgid "Event binding types may be combined, for example:" +msgstr "" + +#. Tag: programlisting +#: events.xml:185 +#, no-c-format +msgid "" +"<![CDATA[@Observable @Blog Event<Document> blogEvent;\n" +"...\n" +"if (document.isBlog()) blogEvent.fire(document, new " +"AnnotationLiteral<Updated>(){});]]>" +msgstr "" + +#. Tag: para +#: events.xml:187 +#, no-c-format +msgid "" +"When this event occurs, all of the following observer methods will be " +"notified:" +msgstr "" + +#. Tag: programlisting +#: events.xml:189 +#, no-c-format +msgid "" +"<![CDATA[public void afterBlogUpdate(@Observes @Updated @Blog Document " +"document) { ... }]]>" +msgstr "" + +#. Tag: programlisting +#: events.xml:191 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyBlogEvent(@Observes @Blog Document document) " +"{ ... }]]>" +msgstr "" + +#. Tag: programlisting +#: events.xml:192 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyDocumentEvent(@Observes Document document) " +"{ ... }}}]]>" +msgstr "" + +#. Tag: title +#: events.xml:197 +#, no-c-format +msgid "Transactional observers" +msgstr "" + +#. Tag: para +#: events.xml:199 +#, no-c-format +msgid "" +"Transactional observers receive their event notifications during the before " +"or after completion phase of the transaction in which the event was raised. " +"For example, the following observer method needs to refresh a query result " +"set that is cached in the application context, but only when transactions " +"that update the <literal>Category</literal> tree succeed:" +msgstr "" + +#. Tag: programlisting +#: events.xml:205 +#, no-c-format +msgid "" +"<![CDATA[public void refreshCategoryTree(@AfterTransactionSuccess @Observes " +"CategoryUpdateEvent event) { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:207 +#, no-c-format +msgid "There are three kinds of transactional observers:" +msgstr "" + +#. Tag: para +#: events.xml:211 +#, no-c-format +msgid "" +"<literal>@AfterTransactionSuccess</literal> observers are called during the " +"after completion phase of the transaction, but only if the transaction " +"completes successfully" +msgstr "" + +#. Tag: para +#: events.xml:216 +#, no-c-format +msgid "" +"<literal>@AfterTransactionFailure</literal> observers are called during the " +"after completion phase of the transaction, but only if the transaction fails " +"to complete successfully" +msgstr "" + +#. Tag: para +#: events.xml:221 +#, no-c-format +msgid "" +"<literal>@AfterTransactionCompletion</literal> observers are called during " +"the after completion phase of the transaction" +msgstr "" + +#. Tag: para +#: events.xml:225 +#, no-c-format +msgid "" +"<literal>@BeforeTransactionCompletion</literal> observers are called during " +"the before completion phase of the transaction" +msgstr "" + +#. Tag: para +#: events.xml:230 +#, no-c-format +msgid "" +"Transactional observers are very important in a stateful object model like " +"Web Beans, because state is often held for longer than a single atomic " +"transaction." +msgstr "" + +#. Tag: para +#: events.xml:233 +#, no-c-format +msgid "" +"Imagine that we have cached a JPA query result set in the application scope:" +msgstr "" + +#. Tag: programlisting +#: events.xml:235 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Singleton\n" +"public class Catalog {\n" +"\n" +" @PersistenceContext EntityManager em;\n" +" \n" +" List<Product> products;\n" +"\n" +" @Produces @Catalog \n" +" List<Product> getCatalog() {\n" +" if (products==null) {\n" +" products = em.createQuery(\"select p from Product p where p." +"deleted = false\")\n" +" .getResultList();\n" +" }\n" +" return products;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:237 +#, no-c-format +msgid "" +"From time to time, a <literal>Product</literal> is created or deleted. When " +"this occurs, we need to refresh the <literal>Product</literal> catalog. But " +"we should wait until <emphasis>after</emphasis> the transaction completes " +"successfully before performing this refresh!" +msgstr "" + +#. Tag: para +#: events.xml:242 +#, no-c-format +msgid "" +"The Web Bean that creates and deletes <literal>Product</literal>s could " +"raise events, for example:" +msgstr "" + +#. Tag: programlisting +#: events.xml:245 +#, no-c-format +msgid "" +"<![CDATA[@Stateless\n" +"public class ProductManager {\n" +"\n" +" @PersistenceContext EntityManager em;\n" +" @Observable Event<Product> productEvent;\n" +"\n" +" public void delete(Product product) {\n" +" em.delete(product);\n" +" productEvent.fire(product, new AnnotationLiteral<Deleted>(){});\n" +" }\n" +" \n" +" public void persist(Product product) {\n" +" em.persist(product);\n" +" productEvent.fire(product, new AnnotationLiteral<Created>(){});\n" +" }\n" +" \n" +" ...\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:247 +#, no-c-format +msgid "" +"And now <literal>Catalog</literal> can observe the events after successful " +"completion of the transaction:" +msgstr "" + +#. Tag: programlisting +#: events.xml:250 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Singleton\n" +"public class Catalog {\n" +"\n" +" ...\n" +" \n" +" void addProduct(@AfterTransactionSuccess @Observes @Created Product " +"product) {\n" +" products.add(product);\n" +" }\n" +" \n" +" void addProduct(@AfterTransactionSuccess @Observes @Deleted Product " +"product) {\n" +" products.remove(product);\n" +" }\n" +" \n" +"}]]>" +msgstr "" Added: doc/trunk/reference/ja-JP/modules/example.po =================================================================== --- doc/trunk/reference/ja-JP/modules/example.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/example.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,172 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: example.xml:4 +#, no-c-format +msgid "JSF web application example" +msgstr "" + +#. Tag: para +#: example.xml:6 +#, no-c-format +msgid "" +"Let's illustrate these ideas with a full example. We're going to implement " +"user login/logout for an application that uses JSF. First, we'll define a " +"Web Bean to hold the username and password entered during login:" +msgstr "" + +#. Tag: programlisting +#: example.xml:11 +#, no-c-format +msgid "" +"<![CDATA[@Named\n" +"public class Credentials {\n" +" \n" +" private String username;\n" +" private String password;\n" +" \n" +" public String getUsername() { return username; }\n" +" public void setUsername(String username) { this.username = username; }\n" +" \n" +" public String getPassword() { return password; }\n" +" public void setPassword(String password) { this.password = password; }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:13 +#, no-c-format +msgid "This Web Bean is bound to the login prompt in the following JSF form:" +msgstr "" + +#. Tag: programlisting +#: example.xml:15 +#, no-c-format +msgid "" +"<![CDATA[<f:form>\n" +" <h:panelGrid columns=\"2\" rendered=\"#{!login.loggedIn}\">\n" +" <h:outputLabel for=\"username\">Username:</h:outputLabel>\n" +" <h:inputText id=\"username\" value=\"#{credentials.username}\"/>\n" +" <h:outputLabel for=\"password\">Password:</h:outputLabel>\n" +" <h:inputText id=\"password\" value=\"#{credentials.password}\"/>\n" +" </h:panelGrid>\n" +" <h:commandButton value=\"Login\" action=\"#{login.login}\" rendered=\"#{!" +"login.loggedIn}\"/>\n" +" <h:commandButton value=\"Logout\" acion=\"#{login.logout}\" rendered=\"#" +"{login.loggedIn}\"/>\n" +"</f:form]]>" +msgstr "" + +#. Tag: para +#: example.xml:17 +#, no-c-format +msgid "" +"The actual work is done by a session scoped Web Bean that maintains " +"information about the currently logged-in user and exposes the " +"<literal>User</literal> entity to other Web Beans:" +msgstr "" + +#. Tag: programlisting +#: example.xml:21 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named\n" +"public class Login {\n" +"\n" +" @Current Credentials credentials;\n" +" @PersistenceContext EntityManager userDatabase;\n" +"\n" +" private User user;\n" +" \n" +" public void login() {\n" +" \n" +" List<User> results = userDatabase.createQuery(\n" +" \"select u from User u where u.username=:username and u.password=:" +"password\")\n" +" .setParameter(\"username\", credentials.getUsername())\n" +" .setParameter(\"password\", credentials.getPassword())\n" +" .getResultList();\n" +" \n" +" if ( !results.isEmpty() ) {\n" +" user = results.get(0);\n" +" }\n" +" \n" +" }\n" +" \n" +" public void logout() {\n" +" user = null;\n" +" }\n" +" \n" +" public boolean isLoggedIn() {\n" +" return user!=null;\n" +" }\n" +" \n" +" @Produces @LoggedIn User getCurrentUser() {\n" +" return user;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:23 +#, no-c-format +msgid "Of course, <literal>@LoggedIn</literal> is a binding annotation:" +msgstr "" + +#. Tag: programlisting +#: example.xml:25 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD})\n" +"@BindingType\n" +"public @interface LoggedIn {}]]>" +msgstr "" + +#. Tag: para +#: example.xml:27 +#, no-c-format +msgid "Now, any other Web Bean can easily inject the current user:" +msgstr "" + +#. Tag: programlisting +#: example.xml:29 +#, no-c-format +msgid "" +"<![CDATA[public class DocumentEditor {\n" +"\n" +" @Current Document document;\n" +" @LoggedIn User currentUser;\n" +" @PersistenceContext EntityManager docDatabase;\n" +" \n" +" public void save() {\n" +" document.setCreatedBy(currentUser);\n" +" docDatabase.persist(document);\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:31 +#, no-c-format +msgid "" +"Hopefully, this example gives a flavor of the Web Bean programming model. In " +"the next chapter, we'll explore Web Beans dependency injection in greater " +"depth." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/extend.po =================================================================== --- doc/trunk/reference/ja-JP/modules/extend.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/extend.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,252 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: extend.xml:4 +#, no-c-format +msgid "Extending Web Beans" +msgstr "" + +#. Tag: para +#: extend.xml:6 +#, no-c-format +msgid "" +"Web Beans is intended to be a platform for frameworks, extensions and " +"integration with other technologies. Therefore, Web Beans exposes a set of " +"SPIs for the use of developers of portable extensions to Web Beans. For " +"example, the following kinds of extensions were envisaged by the designers " +"of Web Beans:" +msgstr "" + +#. Tag: para +#: extend.xml:14 +#, no-c-format +msgid "integration with Business Process Management engines," +msgstr "" + +#. Tag: para +#: extend.xml:17 +#, no-c-format +msgid "" +"integration with third-party frameworks such as Spring, Seam, GWT or Wicket, " +"and" +msgstr "" + +#. Tag: para +#: extend.xml:21 +#, no-c-format +msgid "new technology based upon the Web Beans programming model." +msgstr "" + +#. Tag: para +#: extend.xml:25 +#, no-c-format +msgid "" +"The nerve center for extending Web Beans is the <literal>Manager</literal> " +"object." +msgstr "" + +#. Tag: title +#: extend.xml:29 +#, no-c-format +msgid "The <literal>Manager</literal> object" +msgstr "" + +#. Tag: para +#: extend.xml:31 +#, no-c-format +msgid "" +"The <literal>Manager</literal> interface lets us register and obtain Web " +"Beans, interceptors, decorators, observers and contexts programatically." +msgstr "" + +#. Tag: programlisting +#: extend.xml:34 +#, no-c-format +msgid "" +"<![CDATA[public interface Manager\n" +"{\n" +"\n" +" public <T> Set<Bean<T>> resolveByType(Class<T> type, Annotation... " +"bindings);\n" +"\n" +" public <T> Set<Bean<T>> resolveByType(TypeLiteral<T> apiType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> T getInstanceByType(Class<T> type, Annotation... bindings);\n" +"\n" +" public <T> T getInstanceByType(TypeLiteral<T> type,\n" +" Annotation... bindings);\n" +"\n" +" public Set<Bean<?>> resolveByName(String name);\n" +"\n" +" public Object getInstanceByName(String name);\n" +"\n" +" public <T> T getInstance(Bean<T> bean);\n" +"\n" +" public void fireEvent(Object event, Annotation... bindings);\n" +"\n" +" public Context getContext(Class<? extends Annotation> scopeType);\n" +"\n" +" public Manager addContext(Context context);\n" +"\n" +" public Manager addBean(Bean<?> bean);\n" +"\n" +" public Manager addInterceptor(Interceptor interceptor);\n" +"\n" +" public Manager addDecorator(Decorator decorator);\n" +"\n" +" public <T> Manager addObserver(Observer<T> observer, Class<T> eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager addObserver(Observer<T> observer, TypeLiteral<T> " +"eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager removeObserver(Observer<T> observer, Class<T> " +"eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager removeObserver(Observer<T> observer,\n" +" TypeLiteral<T> eventType, Annotation... bindings);\n" +"\n" +" public <T> Set<Observer<T>> resolveObservers(T event, Annotation... " +"bindings);\n" +"\n" +" public List<Interceptor> resolveInterceptors(InterceptionType type,\n" +" Annotation... interceptorBindings);\n" +"\n" +" public List<Decorator> resolveDecorators(Set<Class<?>> types,\n" +" Annotation... bindings);\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: extend.xml:36 +#, no-c-format +msgid "We can obtain an instance of <literal>Manager</literal> via injection:" +msgstr "" + +#. Tag: programlisting +#: extend.xml:38 +#, no-c-format +msgid "@Current Manager manager" +msgstr "" + +#. Tag: title +#: extend.xml:43 +#, no-c-format +msgid "The <literal>Bean</literal> class" +msgstr "" + +#. Tag: para +#: extend.xml:45 +#, no-c-format +msgid "" +"Instances of the abstract class <literal>Bean</literal> represent Web Beans. " +"There is an instance of <literal>Bean</literal> registered with the " +"<literal>Manager</literal> object for every Web Bean in the application." +msgstr "" + +#. Tag: programlisting +#: extend.xml:50 +#, no-c-format +msgid "" +"public abstract class Bean<T> {\n" +" \n" +" private final Manager manager;\n" +" \n" +" protected Bean(Manager manager) {\n" +" this.manager=manager;\n" +" }\n" +" \n" +" protected Manager getManager() {\n" +" return manager;\n" +" }\n" +" \n" +" public abstract Set<Class> getTypes();\n" +" public abstract Set<Annotation> getBindingTypes();\n" +" public abstract Class<? extends Annotation> getScopeType();\n" +" public abstract Class<? extends Annotation> getDeploymentType(); \n" +" public abstract String getName();\n" +" \n" +" public abstract boolean isSerializable();\n" +" public abstract boolean isNullable();\n" +"\n" +" public abstract T create();\n" +" public abstract void destroy(T instance);\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: extend.xml:52 +#, no-c-format +msgid "" +"It's possible to extend the <literal>Bean</literal> class and register " +"instances by calling <literal>Manager.addBean()</literal> to provide support " +"for new kinds of Web Beans, beyond those defined by the Web Beans " +"specification (simple and enterprise Web Beans, producer methods and JMS " +"endpoints). For example, we could use the <literal>Bean</literal> class to " +"allow objects managed by another framework to be injected into Web Beans." +msgstr "" + +#. Tag: para +#: extend.xml:60 +#, no-c-format +msgid "" +"There are two subclasses of <literal>Bean</literal> defined by the Web Beans " +"specification: <literal>Interceptor</literal> and <literal>Decorator</" +"literal>." +msgstr "" + +#. Tag: title +#: extend.xml:67 +#, no-c-format +msgid "The <literal>Context</literal> interface" +msgstr "" + +#. Tag: para +#: extend.xml:69 +#, no-c-format +msgid "" +"The <literal>Context</literal> interface supports addition of new scopes to " +"Web Beans, or extension of the built-in scopes to new environments." +msgstr "" + +#. Tag: programlisting +#: extend.xml:72 +#, no-c-format +msgid "" +"public interface Context {\n" +" \n" +" public Class<? extends Annotation> getScopeType();\n" +" \n" +" public <T> T get(Bean<T> bean, boolean create);\n" +" \n" +" boolean isActive();\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: extend.xml:74 +#, no-c-format +msgid "" +"For example, we might implement <literal>Context</literal> to add a business " +"process scope to Web Beans, or to add support for the conversation scope to " +"an application that uses Wicket." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/injection.po =================================================================== --- doc/trunk/reference/ja-JP/modules/injection.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/injection.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,1226 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: injection.xml:4 +#, no-c-format +msgid "Dependency injection" +msgstr "" + +#. Tag: para +#: injection.xml:6 +#, no-c-format +msgid "Web Beans supports three primary mechanisms for dependency injection:" +msgstr "" + +#. Tag: para +#: injection.xml:8 +#, no-c-format +msgid "Constructor parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:10 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +" \n" +" private final ShoppingCart cart;\n" +" \n" +" @Initializer\n" +" public Checkout(ShoppingCart cart) {\n" +" this.cart = cart;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:12 +#, no-c-format +msgid "<emphasis>Initializer</emphasis> method parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:14 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +" \n" +" private ShoppingCart cart;\n" +"\n" +" @Initializer \n" +" void setShoppingCart(ShoppingCart cart) {\n" +" this.cart = cart;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:16 +#, no-c-format +msgid "And direct field injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:18 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +"\n" +" private @Current ShoppingCart cart;\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:20 +#, no-c-format +msgid "" +"Dependency injection always occurs when the Web Bean instance is first " +"instantiated." +msgstr "" + +#. Tag: para +#: injection.xml:25 +#, no-c-format +msgid "" +"First, the Web Bean manager calls the Web Bean constructor, to obtain an " +"instance of the Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:29 +#, no-c-format +msgid "" +"Next, the Web Bean manager initializes the values of all injected fields of " +"the Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:33 +#, no-c-format +msgid "Next, the Web Bean manager calls all initializer methods of Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:37 +#, no-c-format +msgid "" +"Finally, the <literal>@PostConstruct</literal> method of the Web Bean, if " +"any, is called." +msgstr "" + +#. Tag: para +#: injection.xml:42 +#, no-c-format +msgid "" +"Constructor parameter injection is not supported for EJB beans, since the " +"EJB is instantiated by the EJB container, not the Web Bean manager." +msgstr "" + +#. Tag: para +#: injection.xml:45 +#, no-c-format +msgid "" +"Parameters of constructors and initializer methods need not be explicitly " +"annotated when the default binding type <literal>@Current</literal> applies. " +"Injected fields, however, <emphasis>must</emphasis> specify a binding type, " +"even when the default binding type applies. If the field does not specify a " +"binding type, it will not be injected." +msgstr "" + +#. Tag: para +#: injection.xml:51 +#, no-c-format +msgid "Producer methods also support parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:53 +#, no-c-format +msgid "" +"<![CDATA[@Produces Checkout createCheckout(ShoppingCart cart) {\n" +" return new Checkout(cart);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:55 +#, no-c-format +msgid "" +"Finally, observer methods (which we'll meet in <xref linkend=\"events\"/>), " +"disposal methods and destructor methods all support parameter injection." +msgstr "" + +#. Tag: para +#: injection.xml:58 +#, no-c-format +msgid "" +"The Web Beans specification defines a procedure, called the " +"<emphasis>typesafe resolution algorithm</emphasis>, that the Web Bean " +"manager follows when identifying the Web Bean to inject to an injection " +"point. This algorithm looks complex at first, but once you understand it, " +"it's really quite intuitive. Typesafe resolution is performed at system " +"initialization time, which means that the manager will inform the user " +"immediately if a Web Bean's dependencies cannot be satisfied, by throwing a " +"<literal>UnsatisfiedDependencyException</literal> or " +"<literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:67 +#, no-c-format +msgid "" +"The purpose of this algorithm is to allow multiple Web Beans to implement " +"the same API type and either:" +msgstr "" + +#. Tag: para +#: injection.xml:72 +#, no-c-format +msgid "" +"allow the client to select which implementation it requires using " +"<emphasis>binding annotations</emphasis>," +msgstr "" + +#. Tag: para +#: injection.xml:77 +#, no-c-format +msgid "" +"allow the application deployer to select which implementation is appropriate " +"for a particular deployment, without changes to the client, by enabling or " +"disabling <emphasis>deployment types</emphasis>, or" +msgstr "" + +#. Tag: para +#: injection.xml:82 +#, no-c-format +msgid "" +"allow one implementation of an API to override another implementation of the " +"same API at deployment time, without changes to the client, using " +"<emphasis>deployment type precedence</emphasis>." +msgstr "" + +#. Tag: para +#: injection.xml:88 +#, no-c-format +msgid "" +"Let's explore how the Web Beans manager determines a Web Bean to be injected." +msgstr "" + +#. Tag: title +#: injection.xml:91 +#, no-c-format +msgid "Binding annotations" +msgstr "" + +#. Tag: para +#: injection.xml:93 +#, no-c-format +msgid "" +"If we have more than one Web Bean that implements a particular API type, the " +"injection point can specify exactly which Web Bean should be injected using " +"a binding annotation. For example, there might be two implementations of " +"<literal>PaymentProcessor</literal>:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:98 +#, no-c-format +msgid "" +"<![CDATA[@PayByCheque\n" +"public class ChequePaymentProcessor implements PaymentProcessor {\n" +" public void process(Payment payment) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:100 +#, no-c-format +msgid "" +"<![CDATA[@PayByCreditCard\n" +"public class CreditCardPaymentProcessor implements PaymentProcessor {\n" +" public void process(Payment payment) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:102 +#, no-c-format +msgid "" +"Where <literal>@PayByCheque</literal> and <literal>@PayByCreditCard</" +"literal> are binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:105 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayByCheque {}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:107 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayByCreditCard {}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:109 +#, no-c-format +msgid "" +"A client Web Bean developer uses the binding annotation to specify exactly " +"which Web Bean should be injected." +msgstr "" + +#. Tag: para +#: injection.xml:112 +#, no-c-format +msgid "Using field injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:114 +#, no-c-format +msgid "" +"<![CDATA[@PayByCheque PaymentProcessor chequePaymentProcessor;\n" +"@PayByCreditCard PaymentProcessor creditCardPaymentProcessor;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:116 +#, no-c-format +msgid "Using initializer method injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:118 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public void setPaymentProcessors(@PayByCheque PaymentProcessor " +"chequePaymentProcessor, \n" +" @PayByCreditCard PaymentProcessor " +"creditCardPaymentProcessor) {\n" +" this.chequePaymentProcessor = chequePaymentProcessor;\n" +" this.creditCardPaymentProcessor = creditCardPaymentProcessor;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:120 +#, no-c-format +msgid "Or using constructor injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:122 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public Checkout(@PayByCheque PaymentProcessor chequePaymentProcessor, \n" +" @PayByCreditCard PaymentProcessor " +"creditCardPaymentProcessor) {\n" +" this.chequePaymentProcessor = chequePaymentProcessor;\n" +" this.creditCardPaymentProcessor = creditCardPaymentProcessor;\n" +"}]]>" +msgstr "" + +#. Tag: title +#: injection.xml:125 +#, no-c-format +msgid "Binding annotations with members" +msgstr "" + +#. Tag: para +#: injection.xml:127 +#, no-c-format +msgid "Binding annotations may have members:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:129 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayBy {\n" +" PaymentType value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:131 +#, no-c-format +msgid "In which case, the member value is significant:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:133 +#, no-c-format +msgid "" +"<![CDATA[@PayBy(CHEQUE) PaymentProcessor chequePaymentProcessor;\n" +"@PayBy(CREDIT_CARD) PaymentProcessor creditCardPaymentProcessor;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:135 +#, no-c-format +msgid "" +"You can tell the Web Bean manager to ignore a member of a binding annotation " +"type by annotating the member <literal>@NonBinding</literal>." +msgstr "" + +#. Tag: title +#: injection.xml:141 +#, no-c-format +msgid "Combinations of binding annnotations" +msgstr "" + +#. Tag: para +#: injection.xml:143 +#, no-c-format +msgid "An injection point may even specify multiple binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:145 +#, no-c-format +msgid "" +"<![CDATA[@Asynchronous @PayByCheque PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: injection.xml:147 +#, no-c-format +msgid "" +"In this case, only a Web Bean which has <emphasis>both</emphasis> binding " +"annotations would be eligible for injection." +msgstr "" + +#. Tag: title +#: injection.xml:153 +#, no-c-format +msgid "Binding annotations and producer methods" +msgstr "" + +#. Tag: para +#: injection.xml:155 +#, no-c-format +msgid "Even producer methods may specify binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:157 +#, no-c-format +msgid "" +"<![CDATA[@Produces \n" +"@Asynchronous @PayByCheque \n" +"PaymentProcessor createAsyncPaymentProcessor(@PayByCheque PaymentProcessor " +"processor) {\n" +" return new AsynchronousPaymentProcessor(processor);\n" +"}]]>" +msgstr "" + +#. Tag: title +#: injection.xml:162 +#, no-c-format +msgid "The default binding type" +msgstr "" + +#. Tag: para +#: injection.xml:164 +#, no-c-format +msgid "" +"Web Beans defines a binding type <literal>@Current</literal> that is the " +"default binding type for any injection point or Web Bean that does not " +"explicitly specify a binding type." +msgstr "" + +#. Tag: para +#: injection.xml:168 +#, no-c-format +msgid "" +"There are two common circumstances in which it is necessary to explicitly " +"specify <literal>@Current</literal>:" +msgstr "" + +#. Tag: para +#: injection.xml:173 +#, no-c-format +msgid "" +"on a field, in order to declare it as an injected field with the default " +"binding type, and" +msgstr "" + +#. Tag: para +#: injection.xml:177 +#, no-c-format +msgid "" +"on a Web Bean which has another binding type in addition to the default " +"binding type." +msgstr "" + +#. Tag: title +#: injection.xml:187 +#, no-c-format +msgid "Deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:189 +#, no-c-format +msgid "" +"All Web Beans have a <emphasis>deployment type</emphasis>. Each deployment " +"type identifies a set of Web Beans that should be conditionally installed in " +"some deployments of the system." +msgstr "" + +#. Tag: para +#: injection.xml:193 +#, no-c-format +msgid "" +"For example, we could define a deployment type named <literal>@Mock</" +"literal>, which would identify Web Beans that should only be installed when " +"the system executes inside an integration testing environment:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:197 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +" @Target({TYPE, METHOD})\n" +" @DeploymentType\n" +" public @interface Mock {}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:199 +#, no-c-format +msgid "" +"Suppose we had some Web Bean that interacted with an external system to " +"process payments:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:202 +#, no-c-format +msgid "" +"<![CDATA[public class ExternalPaymentProcessor {\n" +" \n" +" public void process(Payment p) {\n" +" ...\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:204 +#, no-c-format +msgid "" +"Since this Web Bean does not explicitly specify a deployment type, it has " +"the default deployment type <literal>@Production</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:207 +#, no-c-format +msgid "" +"For integration or unit testing, the external system is slow or unavailable. " +"So we would create a mock object:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:210 +#, no-c-format +msgid "" +"<![CDATA[@Mock \n" +"public class MockPaymentProcessor implements PaymentProcessor {\n" +"\n" +" @Override\n" +" public void process(Payment p) {\n" +" p.setSuccessful(true);\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:212 +#, no-c-format +msgid "" +"But how does the Web Bean manager determine which implementation to use in a " +"particular deployment?" +msgstr "" + +#. Tag: title +#: injection.xml:216 +#, no-c-format +msgid "Enabling deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:218 +#, no-c-format +msgid "" +"Web Beans defines two built-in deployment types: <literal>@Production</" +"literal> and <literal>@Standard</literal>. By default, only Web Beans with " +"the built-in deployment types are enabled when the system is deployed. We " +"can identify additional deployment types to be enabled in a particular " +"deployment by listing them in <literal>web-beans.xml</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:224 +#, no-c-format +msgid "" +"Going back to our example, when we deploy our integration tests, we want all " +"our <literal>@Mock</literal> objects to be installed:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:227 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans>\n" +" <Deploy>\n" +" <Standard/>\n" +" <Production/>\n" +" <test:Mock/>\n" +" </Deploy>\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: injection.xml:229 +#, no-c-format +msgid "" +"Now the Web Bean manager will identify and install all Web Beans annotated " +"<literal>@Production</literal>, <literal>@Standard</literal> or " +"<literal>@Mock</literal> at deployment time." +msgstr "" + +#. Tag: para +#: injection.xml:233 +#, no-c-format +msgid "" +"The deployment type <literal>@Standard</literal> is used only for certain " +"special Web Beans defined by the Web Beans specification. We can't use it " +"for our own Web Beans, and we can't disable it." +msgstr "" + +#. Tag: para +#: injection.xml:237 +#, no-c-format +msgid "" +"The deployment type <literal>@Production</literal> is the default deployment " +"type for Web Beans which don't explicitly declare a deployment type, and may " +"be disabled." +msgstr "" + +#. Tag: title +#: injection.xml:244 +#, no-c-format +msgid "Deployment type precedence" +msgstr "" + +#. Tag: para +#: injection.xml:246 +#, no-c-format +msgid "" +"If you've been paying attention, you're probably wondering how the Web Bean " +"manager decides which implementation<literal>ExternalPaymentProcessor</" +"literal> or <literal>MockPaymentProcessor</literal>to choose. Consider " +"what happens when the manager encounters this injection point:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:251 +#, no-c-format +msgid "<![CDATA[@Current PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: injection.xml:253 +#, no-c-format +msgid "" +"There are now two Web Beans which satisfy the <literal>PaymentProcessor</" +"literal> contract. Of course, we can't use a binding annotation to " +"disambiguate, since binding annotations are hard-coded into the source at " +"the injection point, and we want the manager to be able to decide at " +"deployment time!" +msgstr "" + +#. Tag: para +#: injection.xml:258 +#, no-c-format +msgid "" +"The solution to this problem is that each deployment type has a different " +"<emphasis>precedence</emphasis>. The precedence of the deployment types is " +"determined by the order in which they appear in <literal>web-beans.xml</" +"literal>. In our example, <literal>@Mock</literal> appears later than " +"<literal>@Production</literal> so it has a higher precedence." +msgstr "" + +#. Tag: para +#: injection.xml:264 +#, no-c-format +msgid "" +"Whenever the manager discovers that more than one Web Bean could satisfy the " +"contract (API type plus binding annotations) specified by an injection " +"point, it considers the relative precedence of the Web Beans. If one has a " +"higher precedence than the others, it chooses the higher precedence Web Bean " +"to inject. So, in our example, the Web Bean manager will inject " +"<literal>MockPaymentProcessor</literal> when executing in our integration " +"testing environment (which is exactly what we want)." +msgstr "" + +#. Tag: para +#: injection.xml:271 +#, no-c-format +msgid "" +"It's interesting to compare this facility to today's popular manager " +"architectures. Various \"lightweight\" containers also allow conditional " +"deployment of classes that exist in the classpath, but the classes that are " +"to be deployed must be explicity, individually, listed in configuration code " +"or in some XML configuration file. Web Beans does support Web Bean " +"definition and configuration via XML, but in the common case where no " +"complex configuration is required, deployment types allow a whole set of Web " +"Beans to be enabled with a single line of XML. Meanwhile, a developer " +"browsing the code can easily identify what deployment scenarios the Web Bean " +"will be used in." +msgstr "" + +#. Tag: title +#: injection.xml:284 +#, no-c-format +msgid "Example deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:286 +#, no-c-format +msgid "" +"Deployment types are useful for all kinds of things, here's some examples:" +msgstr "" + +#. Tag: para +#: injection.xml:290 +#, no-c-format +msgid "" +"<literal>@Mock</literal> and <literal>@Staging</literal> deployment types " +"for testing" +msgstr "" + +#. Tag: para +#: injection.xml:294 +#, no-c-format +msgid "<literal>@AustralianTaxLaw</literal> for site-specific Web Beans" +msgstr "" + +#. Tag: para +#: injection.xml:297 +#, no-c-format +msgid "" +"<literal>@SeamFramework</literal>, <literal>@Guice</literal> for third-party " +"frameworks which build on Web Beans" +msgstr "" + +#. Tag: para +#: injection.xml:301 +#, no-c-format +msgid "" +"<literal>@Standard</literal> for standard Web Beans defined by the Web Beans " +"specification" +msgstr "" + +#. Tag: para +#: injection.xml:306 +#, no-c-format +msgid "I'm sure you can think of more applications..." +msgstr "" + +#. Tag: title +#: injection.xml:313 +#, no-c-format +msgid "Fixing unsatisfied dependencies" +msgstr "" + +#. Tag: para +#: injection.xml:315 +#, no-c-format +msgid "" +"The typesafe resolution algorithm fails when, after considering the binding " +"annotations and and deployment types of all Web Beans that implement the API " +"type of an injection point, the Web Bean manager is unable to identify " +"exactly one Web Bean to inject." +msgstr "" + +#. Tag: para +#: injection.xml:320 +#, no-c-format +msgid "" +"It's usually easy to fix an <literal>UnsatisfiedDependencyException</" +"literal> or <literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:323 +#, no-c-format +msgid "" +"To fix an <literal>UnsatisfiedDependencyException</literal>, simply provide " +"a Web Bean which implements the API type and has the binding types of the " +"injection pointor enable the deployment type of a Web Bean that " +"already implements the API type and has the binding types." +msgstr "" + +#. Tag: para +#: injection.xml:328 +#, no-c-format +msgid "" +"To fix an <literal>AmbiguousDependencyException</literal>, introduce a " +"binding type to distinguish between the two implementations of the API type, " +"or change the deployment type of one of the implementations so that the Web " +"Bean manager can use deployment type precedence to choose between them. An " +"<literal>AmbiguousDependencyException</literal> can only occur if two Web " +"Beans share a binding type and have exactly the same deployment type." +msgstr "" + +#. Tag: para +#: injection.xml:335 +#, no-c-format +msgid "" +"There's one more issue you need to be aware of when using dependency " +"injection in Web Beans." +msgstr "" + +#. Tag: title +#: injection.xml:341 +#, no-c-format +msgid "Client proxies" +msgstr "" + +#. Tag: para +#: injection.xml:343 +#, no-c-format +msgid "" +"Clients of an injected Web Bean do not usually hold a direct reference to a " +"Web Bean instance." +msgstr "" + +#. Tag: para +#: injection.xml:346 +#, no-c-format +msgid "" +"Imagine that a Web Bean bound to the application scope held a direct " +"reference to a Web Bean bound to the request scope. The application scoped " +"Web Bean is shared between many different requests. However, each request " +"should see a different instance of the request scoped Web bean!" +msgstr "" + +#. Tag: para +#: injection.xml:351 +#, no-c-format +msgid "" +"Now imagine that a Web Bean bound to the session scope held a direct " +"reference to a Web Bean bound to the application scope. From time to time, " +"the session context is serialized to disk in order to use memory more " +"efficiently. However, the application scoped Web Bean instance should not be " +"serialized along with the session scoped Web Bean!" +msgstr "" + +#. Tag: para +#: injection.xml:357 +#, no-c-format +msgid "" +"Therefore, unless a Web Bean has the default scope <literal>@Dependent</" +"literal>, the Web Bean manager must indirect all injected references to the " +"Web Bean through a proxy object. This <emphasis>client proxy</emphasis> is " +"responsible for ensuring that the Web Bean instance that receives a method " +"invocation is the instance that is associated with the current context. The " +"client proxy also allows Web Beans bound to contexts such as the session " +"context to be serialized to disk without recursively serializing other " +"injected Web Beans." +msgstr "" + +#. Tag: para +#: injection.xml:365 +#, no-c-format +msgid "" +"Unfortunately, due to limitations of the Java language, some Java types " +"cannot be proxied by the Web Bean manager. Therefore, the Web Bean manager " +"throws an <literal>UnproxyableDependencyException</literal> if the type of " +"an injection point cannot be proxied." +msgstr "" + +#. Tag: para +#: injection.xml:370 +#, no-c-format +msgid "The following Java types cannot be proxied by the Web Bean manager:" +msgstr "" + +#. Tag: para +#: injection.xml:374 +#, no-c-format +msgid "" +"classes which are declared <literal>final</literal> or have a " +"<literal>final</literal> method," +msgstr "" + +#. Tag: para +#: injection.xml:378 +#, no-c-format +msgid "classes which have no non-private constructor with no parameters, and" +msgstr "" + +#. Tag: para +#: injection.xml:381 +#, no-c-format +msgid "arrays and primitive types." +msgstr "" + +#. Tag: para +#: injection.xml:385 +#, no-c-format +msgid "" +"It's usually very easy to fix an <literal>UnproxyableDependencyException</" +"literal>. Simply add a constructor with no parameters to the injected class, " +"introduce an interface, or change the scope of the injected Web Bean to " +"<literal>@Dependent</literal>." +msgstr "" + +#. Tag: title +#: injection.xml:392 +#, no-c-format +msgid "Obtaining a Web Bean by programatic lookup" +msgstr "" + +#. Tag: para +#: injection.xml:394 +#, no-c-format +msgid "" +"The application may obtain an instance of the interface <literal>Manager</" +"literal> by injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:397 +#, no-c-format +msgid "<![CDATA[@Current Manager manager;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:399 +#, no-c-format +msgid "" +"The <literal>Manager</literal> object provides a set of methods for " +"obtaining a Web Bean instance programatically." +msgstr "" + +#. Tag: programlisting +#: injection.xml:402 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class);]]>" +msgstr "" + +#. Tag: para +#: injection.xml:404 +#, no-c-format +msgid "" +"Binding annotations may be specified by subclassing the helper class " +"<literal>AnnotationLiteral</literal>, since it is otherwise difficult to " +"instantiate an annotation type in Java." +msgstr "" + +#. Tag: programlisting +#: injection.xml:408 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class, \n" +" new " +"AnnotationLiteral<CreditCard>(){});]]>" +msgstr "" + +#. Tag: para +#: injection.xml:410 +#, no-c-format +msgid "" +"If the binding type has an annotation member, we can't use an anonymous " +"subclass of <literal>AnnotationLiteral</literal>instead we'll need to " +"create a named subclass:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:413 +#, no-c-format +msgid "" +"<![CDATA[abstract class CreditCardBinding \n" +" extends AnnotationLiteral<CreditCard> \n" +" implements CreditCard {}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:415 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class, \n" +" new CreditCardBinding() { \n" +" public void value() " +"{ return paymentType; } \n" +" } );]]>" +msgstr "" + +#. Tag: title +#: injection.xml:419 +#, no-c-format +msgid "" +"Lifecycle callbacks, <literal>@Resource</literal>, <literal>@EJB</literal> " +"and <literal>@PersistenceContext</literal>" +msgstr "" + +#. Tag: para +#: injection.xml:422 +#, no-c-format +msgid "" +"Enterprise Web Beans support all the lifecycle callbacks defined by the EJB " +"specification: <literal>@PostConstruct</literal>, <literal>@PreDestroy</" +"literal>, <literal>@PrePassivate</literal> and <literal>@PostActivate</" +"literal>." +msgstr "" + +#. Tag: para +#: injection.xml:426 +#, no-c-format +msgid "" +"Simple Web Beans support only the <literal>@PostConstruct</literal> and " +"<literal>@PreDestroy</literal> callbacks." +msgstr "" + +#. Tag: para +#: injection.xml:429 +#, no-c-format +msgid "" +"Both enterprise and simple Web Beans support the use of <literal>@Resource</" +"literal>, <literal>@EJB</literal> and <literal>@PersistenceContext</literal> " +"for injection of Java EE resources, EJBs and JPA persistence contexts, " +"respectively. Simple Web Beans do not support the use of " +"<literal>@PersistenceContext(type=EXTENDED)</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:434 +#, no-c-format +msgid "" +"The <literal>@PostConstruct</literal> callback always occurs after all " +"dependencies have been injected." +msgstr "" + +#. Tag: title +#: injection.xml:440 +#, no-c-format +msgid "The <literal>InjectionPoint</literal> object" +msgstr "" + +#. Tag: para +#: injection.xml:442 +#, no-c-format +msgid "" +"There are certain kinds of dependent objectsWeb Beans with scope " +"<literal>@Dependent</literal>that need to know something about the " +"object or injection point into which they are injected in order to be able " +"to do what they do. For example:" +msgstr "" + +#. Tag: para +#: injection.xml:448 +#, no-c-format +msgid "" +"The log category for a <literal>Logger</literal> depends upon the class of " +"the object that owns it." +msgstr "" + +#. Tag: para +#: injection.xml:452 +#, no-c-format +msgid "" +"Injection of a HTTP parameter or header value depends upon what parameter or " +"header name was specified at the injection point." +msgstr "" + +#. Tag: para +#: injection.xml:456 +#, no-c-format +msgid "" +"Injection of the result of an EL expression evaluation depends upon the " +"expression that was specified at the injection point." +msgstr "" + +#. Tag: para +#: injection.xml:461 +#, no-c-format +msgid "" +"A Web Bean with scope <literal>@Dependent</literal> may inject an instance " +"of <literal>InjectionPoint</literal> and access metadata relating to the " +"injection point to which it belongs." +msgstr "" + +#. Tag: para +#: injection.xml:465 +#, no-c-format +msgid "" +"Let's look at an example. The following code is verbose, and vulnerable to " +"refactoring problems:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:468 +#, no-c-format +msgid "<![CDATA[Logger log = Logger.getLogger(MyClass.class.getName());]]>" +msgstr "" + +#. Tag: para +#: injection.xml:470 +#, no-c-format +msgid "" +"This clever little producer method lets you inject a JDK <literal>Logger</" +"literal> without explicitly specifying the log category:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:473 +#, no-c-format +msgid "" +"<![CDATA[class LogFactory {\n" +"\n" +" @Produces Logger createLogger(InjectionPoint injectionPoint) { \n" +" return Logger.getLogger(injectionPoint.getMember().getDeclaringClass()." +"getName()); \n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:475 +#, no-c-format +msgid "We can now write:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:477 +#, no-c-format +msgid "<![CDATA[@Current Logger log;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:479 +#, no-c-format +msgid "" +"Not convinced? Then here's a second example. To inject HTTP parameters, we " +"need to define a binding type:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:482 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"public @interface HttpParam {\n" +" @NonBinding public String value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:484 +#, no-c-format +msgid "We would use this binding type at injection points as follows:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:486 +#, no-c-format +msgid "" +"<![CDATA[@HttpParam(\"username\") String username;\n" +"@HttpParam(\"password\") String password;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:488 +#, no-c-format +msgid "The following producer method does the work:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:490 +#, no-c-format +msgid "" +"<![CDATA[class HttpParams\n" +"\n" +" @Produces @HttpParam(\"\")\n" +" String getParamValue(ServletRequest request, InjectionPoint ip) {\n" +" return request.getParameter(ip.getAnnotation(HttpParam.class).value" +"());\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:492 +#, no-c-format +msgid "" +"(Note that the <literal>value()</literal> member of the <literal>HttpParam</" +"literal> annotation is ignored by the Web Bean manager since it is annotated " +"<literal>@NonBinding.</literal>)" +msgstr "" + +#. Tag: para +#: injection.xml:495 +#, no-c-format +msgid "" +"The Web Bean manager provides a built-in Web Bean that implements the " +"<literal>InjectionPoint</literal> interface:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:498 +#, no-c-format +msgid "" +"<![CDATA[public interface InjectionPoint { \n" +" public Object getInstance(); \n" +" public Bean<?> getBean(); \n" +" public Member getMember(): \n" +" public <T extends Annotation> T getAnnotation(Class<T> annotation); \n" +" public Set<T extends Annotation> getAnnotations(); \n" +"}]]>" +msgstr "" Added: doc/trunk/reference/ja-JP/modules/interceptors.po =================================================================== --- doc/trunk/reference/ja-JP/modules/interceptors.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/interceptors.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,572 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: interceptors.xml:4 +#, no-c-format +msgid "Interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:6 +#, no-c-format +msgid "" +"Web Beans re-uses the basic interceptor architecture of EJB 3.0, extending " +"the functionality in two directions:" +msgstr "" + +#. Tag: para +#: interceptors.xml:11 +#, no-c-format +msgid "Any Web Bean may have interceptors, not just session beans." +msgstr "" + +#. Tag: para +#: interceptors.xml:14 +#, no-c-format +msgid "" +"Web Beans features a more sophisticated annotation-based approach to binding " +"interceptors to Web Beans." +msgstr "" + +#. Tag: para +#: interceptors.xml:22 +#, no-c-format +msgid "The EJB specification defines two kinds of interception points:" +msgstr "" + +#. Tag: para +#: interceptors.xml:26 +#, no-c-format +msgid "business method interception, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:29 +#, no-c-format +msgid "lifecycle callback interception." +msgstr "" + +#. Tag: para +#: interceptors.xml:33 +#, no-c-format +msgid "" +"A <emphasis>business method interceptor</emphasis> applies to invocations of " +"methods of the Web Bean by clients of the Web Bean:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:36 +#, no-c-format +msgid "" +"<![CDATA[public class TransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:38 +#, no-c-format +msgid "" +"A <emphasis>lifecycle callback interceptor</emphasis> applies to invocations " +"of lifecycle callbacks by the container:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:41 +#, no-c-format +msgid "" +"<![CDATA[public class DependencyInjectionInterceptor {\n" +" @PostConstruct public void injectDependencies(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:43 +#, no-c-format +msgid "" +"An interceptor class may intercept both lifecycle callbacks and business " +"methods." +msgstr "" + +#. Tag: title +#: interceptors.xml:49 +#, no-c-format +msgid "Interceptor bindings" +msgstr "" + +#. Tag: para +#: interceptors.xml:51 +#, no-c-format +msgid "" +"Suppose we want to declare that some of our Web Beans are transactional. The " +"first thing we need is an <emphasis>interceptor binding annotation</" +"emphasis> to specify exactly which Web Beans we're interested in:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:55 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Transactional {}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:57 +#, no-c-format +msgid "" +"Now we can easily specify that our <literal>ShoppingCart</literal> is a " +"transactional object:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:60 +#, no-c-format +msgid "" +"<![CDATA[@Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:62 +#, no-c-format +msgid "Or, if we prefer, we can specify that just one method is transactional:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:64 +#, no-c-format +msgid "" +"<![CDATA[public class ShoppingCart {\n" +" @Transactional public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:69 +#, no-c-format +msgid "Implementing interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:71 +#, no-c-format +msgid "" +"That's great, but somewhere along the line we're going to have to actually " +"implement the interceptor that provides this transaction management aspect. " +"All we need to do is create a standard EJB interceptor, and annotate it " +"<literal>@Interceptor</literal> and <literal>@Transactional</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:76 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:78 +#, no-c-format +msgid "" +"All Web Beans interceptors are simple Web Beans, and can take advantage of " +"dependency injection and contextual lifecycle management." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:81 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +"\n" +" @Resource Transaction transaction;\n" +"\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:83 +#, no-c-format +msgid "Multiple interceptors may use the same interceptor binding type." +msgstr "" + +#. Tag: title +#: interceptors.xml:88 +#, no-c-format +msgid "Enabling interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:90 +#, no-c-format +msgid "" +"Finally, we need to <emphasis>enable</emphasis> our interceptor in " +"<literal>web-beans.xml</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:93 +#, no-c-format +msgid "" +"<![CDATA[<Interceptors>\n" +" <tx:TransactionInterceptor/>\n" +"</Interceptors>]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:95 +#, no-c-format +msgid "Whoah! Why the angle bracket stew?" +msgstr "" + +#. Tag: para +#: interceptors.xml:97 +#, no-c-format +msgid "Well, the XML declaration solves two problems:" +msgstr "" + +#. Tag: para +#: interceptors.xml:101 +#, no-c-format +msgid "" +"it enables us to specify a total ordering for all the interceptors in our " +"system, ensuring deterministic behavior, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:105 +#, no-c-format +msgid "it lets us enable or disable interceptor classes at deployment time." +msgstr "" + +#. Tag: para +#: interceptors.xml:109 +#, no-c-format +msgid "" +"For example, we could specify that our security interceptor runs before our " +"<literal>TransactionInterceptor</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:112 +#, no-c-format +msgid "" +"<![CDATA[<Interceptors>\n" +" <sx:SecurityInterceptor/>\n" +" <tx:TransactionInterceptor/>\n" +"</Interceptors>]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:114 +#, no-c-format +msgid "Or we could turn them both off in our test environment!" +msgstr "" + +#. Tag: title +#: interceptors.xml:119 +#, no-c-format +msgid "Interceptor bindings with members" +msgstr "" + +#. Tag: para +#: interceptors.xml:121 +#, no-c-format +msgid "" +"Suppose we want to add some extra information to our " +"<literal>@Transactional</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:124 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Transactional {\n" +" boolean requiresNew() default false;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:126 +#, no-c-format +msgid "" +"Web Beans will use the value of <literal>requiresNew</literal> to choose " +"between two different interceptors, <literal>TransactionInterceptor</" +"literal> and <literal>RequiresNewTransactionInterceptor</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:130 +#, no-c-format +msgid "" +"<![CDATA[@Transactional(requiresNew=true) @Interceptor\n" +"public class RequiresNewTransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:132 +#, no-c-format +msgid "" +"Now we can use <literal>RequiresNewTransactionInterceptor</literal> like " +"this:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:134 +#, no-c-format +msgid "" +"<![CDATA[@Transactional(requiresNew=true)\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:136 +#, no-c-format +msgid "" +"But what if we only have one interceptor and we want the manager to ignore " +"the value of <literal>requiresNew</literal> when binding interceptors? We " +"can use the <literal>@NonBinding</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:140 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Secure {\n" +" @NonBinding String[] rolesAllowed() default {};\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:145 +#, no-c-format +msgid "Multiple interceptor binding annotations" +msgstr "" + +#. Tag: para +#: interceptors.xml:147 +#, no-c-format +msgid "" +"Usually we use combinations of interceptor bindings types to bind multiple " +"interceptors to a Web Bean. For example, the following declaration would be " +"used to bind <literal>TransactionInterceptor</literal> and " +"<literal>SecurityInterceptor</literal> to the same Web Bean:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:152 +#, no-c-format +msgid "" +"<![CDATA[@Secure(rolesAllowed=\"admin\") @Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:154 +#, no-c-format +msgid "" +"However, in very complex cases, an interceptor itself may specify some " +"combination of interceptor binding types:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:157 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure @Interceptor\n" +"public class TransactionalSecureInterceptor { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:159 +#, no-c-format +msgid "" +"Then this interceptor could be bound to the <literal>checkout()</literal> " +"method using any one of the following combinations:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:162 +#, no-c-format +msgid "" +"<![CDATA[public class ShoppingCart {\n" +" @Transactional @Secure public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:164 +#, no-c-format +msgid "" +"<![CDATA[@Secure\n" +"public class ShoppingCart {\n" +" @Transactional public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:166 +#, no-c-format +msgid "" +"<![CDATA[@Transactionl\n" +"public class ShoppingCart {\n" +" @Secure public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:168 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure\n" +"public class ShoppingCart {\n" +" public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:173 +#, no-c-format +msgid "Interceptor binding type inheritance" +msgstr "" + +#. Tag: para +#: interceptors.xml:175 +#, no-c-format +msgid "" +"One limitation of the Java language support for annotations is the lack of " +"annotation inheritance. Really, annotations should have reuse built in, to " +"allow this kind of thing to work:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:179 +#, no-c-format +msgid "" +"<![CDATA[public @interface Action extends Transactional, Secure { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:181 +#, no-c-format +msgid "" +"Well, fortunately, Web Beans works around this missing feature of Java. We " +"may annotate one interceptor binding type with other interceptor binding " +"types. The interceptor bindings are transitiveany Web Bean with the " +"first interceptor binding inherits the interceptor bindings declared as meta-" +"annotations." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:186 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure\n" +"@InterceptorBindingType\n" +"@Target(TYPE)\n" +"@Retention(RUNTIME)\n" +"public @interface Action { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:188 +#, no-c-format +msgid "" +"Any Web Bean annotated <literal>@Action</literal> will be bound to both " +"<literal>TransactionInterceptor</literal> and <literal>SecurityInterceptor</" +"literal>. (And even <literal>TransactionalSecureInterceptor</literal>, if it " +"exists.)" +msgstr "" + +#. Tag: title +#: interceptors.xml:195 +#, no-c-format +msgid "Use of <literal>@Interceptors</literal>" +msgstr "" + +#. Tag: para +#: interceptors.xml:197 +#, no-c-format +msgid "" +"The <literal>@Interceptors</literal> annotation defined by the EJB " +"specification is supported for both enterprise and simple Web Beans, for " +"example:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:200 +#, no-c-format +msgid "" +"<![CDATA[(a)Interceptors({TransactionInterceptor.class, @SecurityInterceptor." +"class})\n" +"public class ShoppingCart {\n" +" public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:202 +#, no-c-format +msgid "However, this approach suffers the following drawbacks:" +msgstr "" + +#. Tag: para +#: interceptors.xml:206 +#, no-c-format +msgid "the interceptor implementation is hardcoded in business code," +msgstr "" + +#. Tag: para +#: interceptors.xml:209 +#, no-c-format +msgid "interceptors may not be easily disabled at deployment time, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:212 +#, no-c-format +msgid "" +"the interceptor ordering is non-globalit is determined by the order in " +"which interceptors are listed at the class level." +msgstr "" + +#. Tag: para +#: interceptors.xml:217 +#, no-c-format +msgid "" +"Therefore, we recommend the use of Web Beans-style interceptor bindings." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/intro.po =================================================================== --- doc/trunk/reference/ja-JP/modules/intro.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/intro.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,1075 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: intro.xml:4 +#, no-c-format +msgid "Getting started with Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:6 +#, no-c-format +msgid "" +"So you're already keen to get started writing your first Web Bean? Or " +"perhaps you're skeptical, wondering what kinds of hoops the Web Beans " +"specification will make you jump through! The good news is that you've " +"probably already written and used hundreds, perhaps thousands of Web Beans. " +"You might not even remember the first Web Bean you wrote." +msgstr "" + +#. Tag: title +#: intro.xml:13 +#, no-c-format +msgid "Your first Web Bean" +msgstr "" + +#. Tag: para +#: intro.xml:15 +#, no-c-format +msgid "" +"With certain, very special exceptions, every Java class with a constructor " +"that accepts no parameters is a Web Bean. That includes every JavaBean. " +"Furthermore, every EJB 3-style session bean is a Web Bean. Sure, the " +"JavaBeans and EJBs you've been writing every day have not been able to take " +"advantage of the new services defined by the Web Beans specification, but " +"you'll be able to use every one of them as Web Beansinjecting them " +"into other Web Beans, configuring them via the Web Beans XML configuration " +"facility, even adding interceptors and decorators to themwithout " +"touching your existing code." +msgstr "" + +#. Tag: para +#: intro.xml:25 +#, no-c-format +msgid "" +"Suppose that we have two existing Java classes, that we've been using for " +"years in various applications. The first class parses a string into a list " +"of sentences:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:29 +#, no-c-format +msgid "" +"<![CDATA[public class SentenceParser {\n" +" public List<String> parse(String text) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:31 +#, no-c-format +msgid "" +"The second existing class is a stateless session bean front-end for an " +"external system that is able to translate sentences from one language to " +"another:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:35 +#, no-c-format +msgid "" +"<![CDATA[@Stateless\n" +"public class SentenceTranslator implements Translator {\n" +" public String translate(String sentence) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:37 +#, no-c-format +msgid "Where <literal>Translator</literal> is the local interface:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:39 +#, no-c-format +msgid "" +"<![CDATA[@Local\n" +"public interface Translator {\n" +" public String translate(String sentence);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:41 +#, no-c-format +msgid "" +"Unfortunately, we don't have a preexisting class that translates whole text " +"documents. So let's write a Web Bean that does this job:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:44 +#, no-c-format +msgid "" +"<![CDATA[public class TextTranslator {\n" +" \n" +" private SentenceParser sentenceParser;\n" +" private Translator sentenceTranslator;\n" +" \n" +" @Initializer\n" +" TextTranslator(SentenceParser sentenceParser, Translator " +"sentenceTranslator) {\n" +" this.sentenceParser = sentenceParser;\n" +" this.sentenceTranslator = sentenceTranslator;\n" +" }\n" +" \n" +" public String translate(String text) {\n" +" StringBuilder sb = new StringBuilder();\n" +" for (String sentence: sentenceParser.parse(text)) {\n" +" sb.append(sentenceTranslator.translate(sentence));\n" +" }\n" +" return sb.toString();\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:46 +#, no-c-format +msgid "" +"We may obtain an instance of <literal>TextTranslator</literal> by injecting " +"it into a Web Bean, Servlet or EJB:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:49 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public setTextTranslator(TextTranslator textTranslator) {\n" +" this.textTranslator = textTranslator;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:51 +#, no-c-format +msgid "" +"Alternatively, we may obtain an instance by directly calling a method of the " +"Web Bean manager:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:54 +#, no-c-format +msgid "" +"<![CDATA[TextTranslator tt = manager.getInstanceByType(TextTranslator." +"class);]]>" +msgstr "" + +#. Tag: para +#: intro.xml:56 +#, no-c-format +msgid "" +"But wait: <literal>TextTranslator</literal> does not have a constructor with " +"no parameters! Is it still a Web Bean? Well, a class that does not have a " +"constructor with no parameters can still be a Web Bean if it has a " +"constructor annotated <literal>@Initializer</literal>." +msgstr "" + +#. Tag: para +#: intro.xml:61 +#, no-c-format +msgid "" +"As you've guessed, the <literal>@Initializer</literal> annotation has " +"something to do with dependency injection! <literal>@Initializer</literal> " +"may be applied to a constructor or method of a Web Bean, and tells the Web " +"Bean manager to call that constructor or method when instantiating the Web " +"Bean. The Web Bean manager will inject other Web Beans to the parameters of " +"the constructor or method." +msgstr "" + +#. Tag: para +#: intro.xml:68 +#, no-c-format +msgid "" +"At system initialization time, the Web Bean manager must validate that " +"exactly one Web Bean exists which satisfies each injection point. In our " +"example, if no implementation of <literal>Translator</literal> " +"availableif the <literal>SentenceTranslator</literal> EJB was not " +"deployedthe Web Bean manager would throw an " +"<literal>UnsatisfiedDependencyException</literal>. If more than one " +"implementation of <literal>Translator</literal> was available, the Web Bean " +"manager would throw an <literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: title +#: intro.xml:80 +#, no-c-format +msgid "What is a Web Bean?" +msgstr "" + +#. Tag: para +#: intro.xml:82 +#, no-c-format +msgid "So what, <emphasis>exactly</emphasis>, is a Web Bean?" +msgstr "" + +#. Tag: para +#: intro.xml:84 +#, no-c-format +msgid "" +"A Web Bean is an application class that contains business logic. A Web Bean " +"may be called directly from Java code, or it may be invoked via Unified EL. " +"A Web Bean may access transactional resources. Dependencies between Web " +"Beans are managed automatically by the Web Bean manager. Most Web Beans are " +"<emphasis>stateful</emphasis> and <emphasis>contextual</emphasis>. The " +"lifecycle of a Web Bean is always managed by the Web Bean manager." +msgstr "" + +#. Tag: para +#: intro.xml:91 +#, no-c-format +msgid "" +"Let's back up a second. What does it really mean to be \"contextual\"? Since " +"Web Beans may be stateful, it matters <emphasis>which</emphasis> bean " +"instance I have. Unlike a stateless component model (for example, stateless " +"session beans) or a singleton component model (such as servlets, or " +"singleton beans), different clients of a Web Bean see the Web Bean in " +"different states. The client-visible state depends upon which instance of " +"the Web Bean the client has a reference to." +msgstr "" + +#. Tag: para +#: intro.xml:98 +#, no-c-format +msgid "" +"However, like a stateless or singleton model, but <emphasis>unlike</" +"emphasis> stateful session beans, the client does not control the lifecycle " +"of the instance by explicitly creating and destroying it. Instead, the " +"<emphasis>scope</emphasis> of the Web Bean determines:" +msgstr "" + +#. Tag: para +#: intro.xml:105 +#, no-c-format +msgid "the lifecycle of each instance of the Web Bean and" +msgstr "" + +#. Tag: para +#: intro.xml:108 +#, no-c-format +msgid "" +"which clients share a reference to a particular instance of the Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:113 +#, no-c-format +msgid "" +"For a given thread in a Web Beans application, there may be an " +"<emphasis>active context</emphasis> associated with the scope of the Web " +"Bean. This context may be unique to the thread (for example, if the Web Bean " +"is request scoped), or it may be shared with certain other threads (for " +"example, if the Web Bean is session scoped) or even all other threads (if it " +"is application scoped)." +msgstr "" + +#. Tag: para +#: intro.xml:119 +#, no-c-format +msgid "" +"Clients (for example, other Web Beans) executing in the same context will " +"see the same instance of the Web Bean. But clients in a different context " +"will see a different instance." +msgstr "" + +#. Tag: para +#: intro.xml:123 +#, no-c-format +msgid "" +"One great advantage of the contextual model is that it allows stateful Web " +"Beans to be treated like services! The client need not concern itself with " +"managing the lifecycle of the Web Bean it is using, <emphasis>nor does it " +"even need to know what that lifecyle is.</emphasis> Web Beans interact by " +"passing messages, and the Web Bean implementations define the lifecycle of " +"their own state. The Web Beans are loosely coupled because:" +msgstr "" + +#. Tag: para +#: intro.xml:132 +#, no-c-format +msgid "they interact via well-defined public APIs" +msgstr "" + +#. Tag: para +#: intro.xml:135 +#, no-c-format +msgid "their lifecycles are completely decoupled" +msgstr "" + +#. Tag: para +#: intro.xml:139 +#, no-c-format +msgid "" +"We can replace one Web Bean with a different Web Bean that implements the " +"same API and has a different lifecycle (a different scope) without affecting " +"the other Web Bean implementation. In fact, Web Beans defines a " +"sophisticated facility for overriding Web Bean implementations at deployment " +"time, as we will see in <xref linkend=\"deploymenttypes\"/>." +msgstr "" + +#. Tag: para +#: intro.xml:145 +#, no-c-format +msgid "" +"Note that not all clients of a Web Bean are Web Beans. Other objects such as " +"Servlets or Message-Driven Beanswhich are by nature not injectable, " +"contextual objectsmay also obtain references to Web Beans by injection." +msgstr "" + +#. Tag: para +#: intro.xml:149 +#, no-c-format +msgid "Enough hand-waving. More formally, according to the spec:" +msgstr "" + +#. Tag: para +#: intro.xml:153 +#, no-c-format +msgid "A Web Bean comprises:" +msgstr "" + +#. Tag: para +#: intro.xml:156 +#, no-c-format +msgid "A (nonempty) set of API types" +msgstr "" + +#. Tag: para +#: intro.xml:157 +#, no-c-format +msgid "A (nonempty) set of binding annotation types" +msgstr "" + +#. Tag: para +#: intro.xml:158 +#, no-c-format +msgid "A scope" +msgstr "" + +#. Tag: para +#: intro.xml:159 +#, no-c-format +msgid "A deployment type" +msgstr "" + +#. Tag: para +#: intro.xml:160 +#, no-c-format +msgid "Optionally, a Web Bean name" +msgstr "" + +#. Tag: para +#: intro.xml:161 +#, no-c-format +msgid "A set of interceptor binding types" +msgstr "" + +#. Tag: para +#: intro.xml:162 +#, no-c-format +msgid "A Web Bean implementation" +msgstr "" + +#. Tag: para +#: intro.xml:167 +#, no-c-format +msgid "Let's see what some of these terms mean, to the Web Bean developer." +msgstr "" + +#. Tag: title +#: intro.xml:170 +#, no-c-format +msgid "API types, binding types and dependency injection" +msgstr "" + +#. Tag: para +#: intro.xml:172 +#, no-c-format +msgid "" +"Web Beans usually acquire references to other Web Beans via dependency " +"injection. Any injected attribute specifies a \"contract\" that must be " +"satisfied by the Web Bean to be injected. The contract is:" +msgstr "" + +#. Tag: para +#: intro.xml:177 +#, no-c-format +msgid "an API type, together with" +msgstr "" + +#. Tag: para +#: intro.xml:178 +#, no-c-format +msgid "a set of binding types." +msgstr "" + +#. Tag: para +#: intro.xml:181 +#, no-c-format +msgid "" +"An API is a user-defined class or interface. (If the Web Bean is an EJB " +"session bean, the API type is the <literal>@Local</literal> interface or " +"bean-class local view). A binding type represents some client-visible " +"semantic that is satisfied by some implementations of the API and not by " +"others." +msgstr "" + +#. Tag: para +#: intro.xml:186 +#, no-c-format +msgid "" +"Binding types are represented by user-defined annotations that are " +"themselves annotated <literal>@BindingType</literal>. For example, the " +"following injection point has API type <literal>PaymentProcessor</literal> " +"and binding type <literal>@CreditCard</literal>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:191 +#, no-c-format +msgid "<![CDATA[@CreditCard PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: intro.xml:193 +#, no-c-format +msgid "" +"If no binding type is explicitly specified at an injection point, the " +"default binding type <literal>@Current</literal> is assumed." +msgstr "" + +#. Tag: para +#: intro.xml:196 +#, no-c-format +msgid "" +"For each injection point, the Web Bean manager searches for a Web Bean which " +"satisfies the contract (implements the API, and has all the binding types), " +"and injects that Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:200 +#, no-c-format +msgid "" +"The following Web Bean has the binding type <literal>@CreditCard</literal> " +"and implements the API type <literal>PaymentProcessor</literal>. It could " +"therefore be injected to the example injection point:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:204 +#, no-c-format +msgid "" +"<![CDATA[@CreditCard\n" +"public class CreditCardPaymentProcessor \n" +" implements PaymentProcessor { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:206 +#, no-c-format +msgid "" +"If a Web Bean does not explicitly specify a set of binding types, it has " +"exactly one binding type: the default binding type <literal>@Current</" +"literal>." +msgstr "" + +#. Tag: para +#: intro.xml:209 +#, no-c-format +msgid "" +"Web Beans defines a sophisticated but intuitive <emphasis>resolution " +"algorithm</emphasis> that helps the container decide what to do if there is " +"more than one Web Bean that satisfies a particular contract. We'll get into " +"the details in <xref linkend=\"injection\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:217 +#, no-c-format +msgid "Deployment types" +msgstr "" + +#. Tag: para +#: intro.xml:219 +#, no-c-format +msgid "" +"<emphasis>Deployment types</emphasis> let us classify our Web Beans by " +"deployment scenario. A deployment type is an annotation that represents a " +"particular deployment scenario, for example <literal>@Mock</literal>, " +"<literal>@Staging</literal> or <literal>@AustralianTaxLaw</literal>. We " +"apply the annotation to Web Beans which should be deployed in that scenario. " +"A deployment type allows a whole set of Web Beans to be conditionally " +"deployed, with a just single line of configuration." +msgstr "" + +#. Tag: para +#: intro.xml:226 +#, no-c-format +msgid "" +"Many Web Beans just use the default deployment type <literal>@Production</" +"literal>, in which case no deployment type need be explicitly specified. All " +"three Web Bean in our example have the deployment type <literal>@Production</" +"literal>." +msgstr "" + +#. Tag: para +#: intro.xml:230 +#, no-c-format +msgid "" +"In a testing environment, we might want to replace the " +"<literal>SentenceTranslator</literal> Web Bean with a \"mock object\":" +msgstr "" + +#. Tag: programlisting +#: intro.xml:233 +#, no-c-format +msgid "" +"<![CDATA[@Mock\n" +"public class MockSentenceTranslator implements Translator {\n" +" public String translate(String sentence) {\n" +" return \"Lorem ipsum dolor sit amet\";\n" +" }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:236 +#, no-c-format +msgid "" +"We would enable the deployment type <literal>@Mock</literal> in our testing " +"environment, to indicate that <literal>MockSentenceTranslator</literal> and " +"any other Web Bean annotated <literal>@Mock</literal> should be used." +msgstr "" + +#. Tag: para +#: intro.xml:240 +#, no-c-format +msgid "" +"We'll talk more about this unique and powerful feature in <xref linkend=" +"\"deploymenttypes\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:246 +#, no-c-format +msgid "Scope" +msgstr "" + +#. Tag: para +#: intro.xml:248 +#, no-c-format +msgid "" +"The <emphasis>scope</emphasis> defines the lifecycle and visibility of " +"instances of the Web Bean. The Web Beans context model is extensible, " +"accommodating arbitrary scopes. However, certain important scopes are built-" +"in to the specification, and provided by the Web Bean manager. A scope is " +"represented by an annotation type." +msgstr "" + +#. Tag: para +#: intro.xml:254 +#, no-c-format +msgid "" +"For example, any web application may have <emphasis>session scoped</" +"emphasis> Web Beans:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:257 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:259 +#, no-c-format +msgid "" +"An instance of a session scoped Web Bean is bound to a user session and is " +"shared by all requests that execute in the context of that session." +msgstr "" + +#. Tag: para +#: intro.xml:262 +#, no-c-format +msgid "" +"By default, Web Beans belong to a special scope called the " +"<emphasis>dependent pseudo-scope</emphasis>. Web Beans with this scope are " +"pure dependent objects of the object into which they are injected, and their " +"lifecycle is bound to the lifecycle of that object." +msgstr "" + +#. Tag: para +#: intro.xml:267 +#, no-c-format +msgid "We'll talk more about scopes in <xref linkend=\"scopescontexts\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:272 +#, no-c-format +msgid "Web Bean names and Unified EL" +msgstr "" + +#. Tag: para +#: intro.xml:274 +#, no-c-format +msgid "" +"A Web Bean may have a <emphasis>name</emphasis>, allowing it to be used in " +"Unified EL expressions. It's easy to specify the name of a Web Bean:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:278 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named(\"cart\")\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:280 +#, no-c-format +msgid "Now we can easily use the Web Bean in any JSF or JSP page:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:282 +#, no-c-format +msgid "" +"<![CDATA[<h:dataTable value=\"#{cart.lineItems}\" var=\"item\">\n" +" ....\n" +"</h:dataTable>]]>" +msgstr "" + +#. Tag: para +#: intro.xml:284 +#, no-c-format +msgid "" +"It's even easier to just let the name be defaulted by the Web Bean manager:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:287 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:289 +#, no-c-format +msgid "" +"In this case, the name defaults to <literal>shoppingCart</literal>the " +"unqualified class name, with the first character changed to lowercase." +msgstr "" + +#. Tag: title +#: intro.xml:295 +#, no-c-format +msgid "Interceptor binding types" +msgstr "" + +#. Tag: para +#: intro.xml:297 +#, no-c-format +msgid "" +"Web Beans supports the interceptor functionality defined by EJB 3, not only " +"for EJB beans, but also for plain Java classes. In addition, Web Beans " +"provides a new approach to binding interceptors to EJB beans and other Web " +"Beans." +msgstr "" + +#. Tag: para +#: intro.xml:302 +#, no-c-format +msgid "" +"It remains possible to directly specify the interceptor class via use of the " +"<literal>@Interceptors</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:305 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped \n" +"@Interceptors(TransactionInterceptor.class)\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:307 +#, no-c-format +msgid "" +"However, it is more elegant, and better practice, to indirect the " +"interceptor binding through an <emphasis>interceptor binding type</emphasis>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:311 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:313 +#, no-c-format +msgid "" +"We'll discuss Web Beans interceptors and decorators in <xref linkend=" +"\"interceptors\"/> and <xref linkend=\"decorators\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:321 +#, no-c-format +msgid "What kinds of objects can be Web Beans?" +msgstr "" + +#. Tag: para +#: intro.xml:323 +#, no-c-format +msgid "" +"We've already seen that JavaBeans, EJBs and some other Java classes can be " +"Web Beans. But exactly what kinds of objects are Web Beans?" +msgstr "" + +#. Tag: title +#: intro.xml:327 +#, no-c-format +msgid "Simple Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:329 +#, no-c-format +msgid "" +"The Web Beans specification says that a concrete Java class is a " +"<emphasis>simple</emphasis> Web Bean if:" +msgstr "" + +#. Tag: para +#: intro.xml:334 +#, no-c-format +msgid "" +"it is not an EE container-managed component, like an EJB, a Servlet or a JPA " +"entity," +msgstr "" + +#. Tag: para +#: intro.xml:338 +#, no-c-format +msgid "it is not a non-static static inner class," +msgstr "" + +#. Tag: para +#: intro.xml:341 +#, no-c-format +msgid "it is not a parameterized type, and" +msgstr "" + +#. Tag: para +#: intro.xml:344 +#, no-c-format +msgid "" +"it has a constructor with no parameters, or a constructor annotated " +"<literal>@Initializer</literal>." +msgstr "" + +#. Tag: para +#: intro.xml:349 +#, no-c-format +msgid "Thus, almost every JavaBean is a simple Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:351 +#, no-c-format +msgid "" +"Every interface implemented directly or indirectly by a simple Web Bean is " +"an API type of the simple Web Bean. The class and its superclasses are also " +"API types." +msgstr "" + +#. Tag: title +#: intro.xml:358 +#, no-c-format +msgid "Enterprise Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:360 +#, no-c-format +msgid "" +"The specification says that all EJB 3-style session and singleton beans are " +"<emphasis>enterprise</emphasis> Web Beans. Message driven beans are not Web " +"Beanssince they are not intended to be injected into other " +"objectsbut they can take advantage of most of the functionality of Web " +"Beans, including dependency injection and interceptors." +msgstr "" + +#. Tag: para +#: intro.xml:366 +#, no-c-format +msgid "" +"Every local interface of an enterprise Web Bean that does not have a " +"wildcard type parameter or type variable, and every one of its " +"superinterfaces, is an API type of the enterprise Web Bean. If the EJB bean " +"has a bean class local view, the bean class, and every one of its " +"superclasses, is also an API type." +msgstr "" + +#. Tag: para +#: intro.xml:372 +#, no-c-format +msgid "" +"Stateful session beans should declare a remove method with no parameters or " +"a remove method annotated <literal>@Destructor</literal>. The Web Bean " +"manager calls this method to destroy the stateful session bean instance at " +"the end of its lifecycle. This method is called the <emphasis>destructor</" +"emphasis> method of the enterprise Web Bean." +msgstr "" + +#. Tag: programlisting +#: intro.xml:378 +#, no-c-format +msgid "" +"<![CDATA[@Stateful @SessionScoped\n" +"public class ShoppingCart {\n" +"\n" +" ...\n" +" \n" +" @Remove\n" +" public void destroy() {}\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:380 +#, no-c-format +msgid "" +"So when should we use an enterprise Web Bean instead of a simple Web Bean? " +"Well, whenever we need the advanced enterprise services offered by EJB, such " +"as:" +msgstr "" + +#. Tag: para +#: intro.xml:387 +#, no-c-format +msgid "method-level transaction management and security," +msgstr "" + +#. Tag: para +#: intro.xml:390 +#, no-c-format +msgid "concurrency management," +msgstr "" + +#. Tag: para +#: intro.xml:393 +#, no-c-format +msgid "" +"instance-level passivation for stateful session beans and instance-pooling " +"for stateless session beans," +msgstr "" + +#. Tag: para +#: intro.xml:397 +#, no-c-format +msgid "remote and web service invocation, and" +msgstr "" + +#. Tag: para +#: intro.xml:400 +#, no-c-format +msgid "timers and asynchronous methods," +msgstr "" + +#. Tag: para +#: intro.xml:404 +#, no-c-format +msgid "" +"we should use an enterprise Web Bean. When we don't need any of these " +"things, a simple Web Bean will serve just fine." +msgstr "" + +#. Tag: para +#: intro.xml:407 +#, no-c-format +msgid "" +"Many Web Beans (including any session or application scoped Web Bean) are " +"available for concurrent access. Therefore, the concurrency management " +"provided by EJB 3.1 is especially useful. Most session and application " +"scoped Web Beans should be EJBs." +msgstr "" + +#. Tag: para +#: intro.xml:412 +#, no-c-format +msgid "" +"Web Beans which hold references to heavy-weight resources, or hold a lot of " +"internal state benefit from the advanced container-managed lifecycle defined " +"by the EJB <literal>@Stateless</literal>/<literal>@Stateful</literal>/" +"<literal>@Singleton</literal> model, with its support for passivation and " +"instance pooling." +msgstr "" + +#. Tag: para +#: intro.xml:417 +#, no-c-format +msgid "" +"Finally, it's usually obvious when method-level transaction management, " +"method-level security, timers, remote methods or asynchronous methods are " +"needed." +msgstr "" + +#. Tag: para +#: intro.xml:420 +#, no-c-format +msgid "" +"It's usually easy to start with simple Web Bean, and then turn it into an " +"EJB, just by adding an annotation: <literal>@Stateless</literal>, " +"<literal>@Stateful</literal> or <literal>@Singleton</literal>." +msgstr "" + +#. Tag: title +#: intro.xml:427 +#, no-c-format +msgid "Producer methods" +msgstr "" + +#. Tag: para +#: intro.xml:429 +#, no-c-format +msgid "" +"A <emphasis>producer method</emphasis> is a method that is called by the Web " +"Bean manager to obtain an instance of the Web Bean when no instance exists " +"in the current context. A producer method lets the application take full " +"control of the instantiation process, instead of leaving instantiation to " +"the Web Bean manager. For example:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:435 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped\n" +"public class Generator {\n" +"\n" +" private Random random = new Random( System.currentTimeMillis() );\n" +" \n" +" @Produces @Random int next() {\n" +" return random.nextInt(100);\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:437 +#, no-c-format +msgid "" +"The result of a producer method is injected just like any other Web Bean." +msgstr "" + +#. Tag: programlisting +#: intro.xml:439 +#, no-c-format +msgid "<![CDATA[@Random int randomNumber]]>" +msgstr "" + +#. Tag: para +#: intro.xml:441 +#, no-c-format +msgid "" +"The method return type and all interfaces it extends/implements directly or " +"indirectly are API types of the producer method. If the return type is a " +"class, all superclasses are also API types." +msgstr "" + +#. Tag: para +#: intro.xml:445 +#, no-c-format +msgid "Some producer methods return objects that require explicit destruction:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:447 +#, no-c-format +msgid "" +"<![CDATA[@Produces @RequestScoped Connection connect(User user) {\n" +" return createConnection( user.getId(), user.getPassword() );\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:449 +#, no-c-format +msgid "" +"These producer methods may define matching <emphasis>disposal methods</" +"emphasis>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:451 +#, no-c-format +msgid "" +"<![CDATA[void close(@Disposes Connection connection) {\n" +" connection.close();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:453 +#, no-c-format +msgid "" +"This disposal method is called automatically by the Web Bean manager at the " +"end of the request." +msgstr "" + +#. Tag: para +#: intro.xml:456 +#, no-c-format +msgid "" +"We'll talk much more about producer methods in <xref linkend=" +"\"producermethods\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:461 +#, no-c-format +msgid "JMS endpoints" +msgstr "" + +#. Tag: para +#: intro.xml:463 +#, no-c-format +msgid "" +"Finally, a JMS queue or topic can be a Web Bean. Web Beans relieves the " +"developer from the tedium of managing the lifecycles of all the various JMS " +"objects required to send messages to queues and topics. We'll discuss JMS " +"endpoints in <xref linkend=\"jms\"/>." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/next.po =================================================================== --- doc/trunk/reference/ja-JP/modules/next.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/next.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,49 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: next.xml:4 +#, no-c-format +msgid "Next steps" +msgstr "" + +#. Tag: para +#: next.xml:6 +#, no-c-format +msgid "" +"Because Web Beans is so new, there's not yet a lot of information available " +"online." +msgstr "" + +#. Tag: para +#: next.xml:9 +#, no-c-format +msgid "" +"Of course, the Web Beans specification is the best source of more " +"information about Web Beans. The spec is about 100 pages long, only twice " +"the length of this article, and almost as readable. But, of course, it " +"covers many details that we've skipped over. The spec is available from " +"<literal>http://jcp.org/en/jsr/detail?id=299</literal>." +msgstr "" + +#. Tag: para +#: next.xml:15 +#, no-c-format +msgid "" +"The Web Beans Reference implementation is being developed at <literal>http://" +"seamframework.org/WebBeans</literal>. The RI development team and the Web " +"Beans spec lead blog at <literal>http://in.relation.to</literal>. This " +"article is substantially based upon a series of blog entries published there." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/part1.po =================================================================== --- doc/trunk/reference/ja-JP/modules/part1.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/part1.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,229 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part1.xml:5 +#, no-c-format +msgid "" +"The Web Beans (JSR-299) specification defines a set of services for the Java " +"EE environment that makes applications much easier to develop. Web Beans " +"layers an enhanced lifecycle and interaction model over existing Java " +"component types including JavaBeans and Enterprise Java Beans. As a " +"complement to the traditional Java EE programming model, the Web Beans " +"services provide:" +msgstr "" + +#. Tag: para +#: part1.xml:14 +#, no-c-format +msgid "" +"an improved lifecycle for stateful components, bound to well-defined " +"<emphasis>contexts</emphasis>," +msgstr "" + +#. Tag: para +#: part1.xml:18 +#, no-c-format +msgid "a typesafe approach to <emphasis>dependency injection</emphasis>," +msgstr "" + +#. Tag: para +#: part1.xml:21 +#, no-c-format +msgid "" +"interaction via an <emphasis>event notification</emphasis> facility, and" +msgstr "" + +#. Tag: para +#: part1.xml:25 +#, no-c-format +msgid "" +"a better approach to binding <emphasis>interceptors</emphasis> to " +"components, along with a new kind of interceptor, called a " +"<emphasis>decorator</emphasis>, that is more appropriate for use in solving " +"business problems." +msgstr "" + +#. Tag: para +#: part1.xml:32 +#, no-c-format +msgid "" +"Dependency injection, together with contextual lifecycle management, saves " +"the user of an unfamiliar API from having to ask and answer the following " +"questions:" +msgstr "" + +#. Tag: para +#: part1.xml:38 +#, no-c-format +msgid "what is the lifecycle of this object?" +msgstr "" + +#. Tag: para +#: part1.xml:41 +#, no-c-format +msgid "how many simultaneous clients can it have?" +msgstr "" + +#. Tag: para +#: part1.xml:44 +#, no-c-format +msgid "is it multithreaded?" +msgstr "" + +#. Tag: para +#: part1.xml:47 +#, no-c-format +msgid "where can I get one from?" +msgstr "" + +#. Tag: para +#: part1.xml:50 +#, no-c-format +msgid "do I need to explicitly destroy it?" +msgstr "" + +#. Tag: para +#: part1.xml:53 +#, no-c-format +msgid "where should I keep my reference to it when I'm not using it directly?" +msgstr "" + +#. Tag: para +#: part1.xml:57 +#, no-c-format +msgid "" +"how can I add an indirection layer, so that the implementation of this " +"object can vary at deployment time?" +msgstr "" + +#. Tag: para +#: part1.xml:61 +#, no-c-format +msgid "how should I go about sharing this object between other objects?" +msgstr "" + +#. Tag: para +#: part1.xml:65 +#, no-c-format +msgid "" +"A Web Bean specifies only the type and semantics of other Web Beans it " +"depends upon. It need not be aware of the actual lifecycle, concrete " +"implementation, threading model or other clients of any Web Bean it depends " +"upon. Even better, the concrete implementation, lifecycle and threading " +"model of a Web Bean it depends upon may vary according to the deployment " +"scenario, without affecting any client." +msgstr "" + +#. Tag: para +#: part1.xml:72 +#, no-c-format +msgid "" +"Events, interceptors and decorators enhance the <emphasis>loose-coupling</" +"emphasis> that is inherent in this model:" +msgstr "" + +#. Tag: para +#: part1.xml:77 +#, no-c-format +msgid "" +"<emphasis>event notifications</emphasis> decouple event producers from event " +"consumers," +msgstr "" + +#. Tag: para +#: part1.xml:81 +#, no-c-format +msgid "" +"<emphasis>interceptors</emphasis> decouple technical concerns from business " +"logic, and" +msgstr "" + +#. Tag: para +#: part1.xml:85 +#, no-c-format +msgid "" +"<emphasis>decorators</emphasis> allow business concerns to be " +"compartmentalized." +msgstr "" + +#. Tag: para +#: part1.xml:90 +#, no-c-format +msgid "" +"Most importantly, Web Beans provides all these facilities in a " +"<emphasis>typesafe</emphasis> way. Web Beans never uses string-based " +"identifiers to determine how collaborating objects fit together. And XML, " +"though it remains an option, is rarely used. Instead, Web Beans uses the " +"typing information that is already available in the Java object model, " +"together with a new pattern, called <emphasis>binding annotations</" +"emphasis>, to wire together Web Beans, their dependencies, their " +"interceptors and decorators and their event consumers." +msgstr "" + +#. Tag: para +#: part1.xml:100 +#, no-c-format +msgid "" +"The Web Beans services are general and apply to the following types of " +"components that exist in the Java EE environment:" +msgstr "" + +#. Tag: para +#: part1.xml:105 +#, no-c-format +msgid "all JavaBeans," +msgstr "" + +#. Tag: para +#: part1.xml:108 +#, no-c-format +msgid "all EJBs, and" +msgstr "" + +#. Tag: para +#: part1.xml:111 +#, no-c-format +msgid "all Servlets." +msgstr "" + +#. Tag: para +#: part1.xml:115 +#, no-c-format +msgid "" +"Web Beans even provides the necessary integration points so that other kinds " +"of components defined by future Java EE specifications or by non-standard " +"frameworks may be cleanly integrated with Web Beans, take advantage of the " +"Web Beans services, and interact with any other kind of Web Bean." +msgstr "" + +#. Tag: para +#: part1.xml:120 +#, no-c-format +msgid "" +"Web Beans was influenced by a number of existing Java frameworks, including " +"Seam, Guice and Spring. However, Web Beans has its own very distinct " +"character: more typesafe than Seam, more stateful and less XML-centric than " +"Spring, more web and enterprise-application capable than Guice." +msgstr "" + +#. Tag: para +#: part1.xml:125 +#, no-c-format +msgid "" +"Most importantly, Web Beans is a JCP standard that integrates cleanly with " +"Java EE, and with any Java SE environment where embeddable EJB Lite is " +"available." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/part2.po =================================================================== --- doc/trunk/reference/ja-JP/modules/part2.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/part2.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,102 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part2.xml:5 +#, no-c-format +msgid "" +"The first major theme of Web Beans is <emphasis>loose coupling</emphasis>. " +"We've already seen three means of achieving loose coupling:" +msgstr "" + +#. Tag: para +#: part2.xml:10 +#, no-c-format +msgid "" +"<emphasis>deployment types</emphasis> enable deployment time polymorphism," +msgstr "" + +#. Tag: para +#: part2.xml:14 +#, no-c-format +msgid "<emphasis>producer methods</emphasis> enable runtime polymorphism, and" +msgstr "" + +#. Tag: para +#: part2.xml:18 +#, no-c-format +msgid "" +"<emphasis>contextual lifecycle management</emphasis> decouples Web Bean " +"lifecycles." +msgstr "" + +#. Tag: para +#: part2.xml:23 +#, no-c-format +msgid "" +"These techniques serve to enable loose coupling of client and server. The " +"client is no longer tightly bound to an implementation of an API, nor is it " +"required to manage the lifecycle of the server object. This approach lets " +"<emphasis>stateful objects interact as if they were services</emphasis>." +msgstr "" + +#. Tag: para +#: part2.xml:28 +#, no-c-format +msgid "" +"Loose coupling makes a system more <emphasis>dynamic</emphasis>. The system " +"can respond to change in a well-defined manner. In the past, frameworks that " +"attempted to provide the facilities listed above invariably did it by " +"sacrificing type safety. Web Beans is the first technology that achieves " +"this level of loose coupling in a typesafe way." +msgstr "" + +#. Tag: para +#: part2.xml:34 +#, no-c-format +msgid "" +"Web Beans provides three extra important facilities that further the goal of " +"loose coupling:" +msgstr "" + +#. Tag: para +#: part2.xml:39 +#, no-c-format +msgid "" +"<emphasis>interceptors</emphasis> decouple technical concerns from business " +"logic," +msgstr "" + +#. Tag: para +#: part2.xml:43 +#, no-c-format +msgid "" +"<emphasis>decorators</emphasis> may be used to decouple some business " +"concerns, and" +msgstr "" + +#. Tag: para +#: part2.xml:47 +#, no-c-format +msgid "" +"<emphasis>event notifications</emphasis> decouple event producers from event " +"consumers." +msgstr "" + +#. Tag: para +#: part2.xml:52 +#, no-c-format +msgid "Let's explore interceptors first." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/part3.po =================================================================== --- doc/trunk/reference/ja-JP/modules/part3.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/part3.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,150 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part3.xml:5 +#, no-c-format +msgid "" +"The second major theme of Web Beans is <emphasis>strong typing</emphasis>. " +"The information about the dependencies, interceptors and decorators of a Web " +"Bean, and the information about event consumers for an event producer, is " +"contained in typesafe Java constructs that may be validated by the compiler." +msgstr "" + +#. Tag: para +#: part3.xml:10 +#, no-c-format +msgid "" +"You don't see string-based identifiers in Web Beans code, not because the " +"framework is hiding them from you using clever defaulting rulesso-" +"called \"configuration by convention\"but because there are simply no " +"strings there to begin with!" +msgstr "" + +#. Tag: para +#: part3.xml:15 +#, no-c-format +msgid "" +"The obvious benefit of this approach is that <emphasis>any</emphasis> IDE " +"can provide autocompletion, validation and refactoring without the need for " +"special tooling. But there is a second, less-immediately-obvious, benefit. " +"It turns out that when you start thinking of identifying objects, events or " +"interceptors via annotations instead of names, you have an opportunity to " +"lift the semantic level of your code." +msgstr "" + +#. Tag: para +#: part3.xml:21 +#, no-c-format +msgid "" +"Web Beans encourages you develop annotations that model concepts, for " +"example," +msgstr "" + +#. Tag: para +#: part3.xml:26 +#, no-c-format +msgid "<literal>@Asynchronous</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:29 +#, no-c-format +msgid "<literal>@Mock</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:32 +#, no-c-format +msgid "<literal>@Secure</literal> or" +msgstr "" + +#. Tag: para +#: part3.xml:35 +#, no-c-format +msgid "<literal>@Updated</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:39 +#, no-c-format +msgid "instead of using compound names like" +msgstr "" + +#. Tag: para +#: part3.xml:43 +#, no-c-format +msgid "<literal>asyncPaymentProcessor</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:46 +#, no-c-format +msgid "<literal>mockPaymentProcessor</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:49 +#, no-c-format +msgid "<literal>SecurityInterceptor</literal> or" +msgstr "" + +#. Tag: para +#: part3.xml:52 +#, no-c-format +msgid "<literal>DocumentUpdatedEvent</literal>." +msgstr "" + +#. Tag: para +#: part3.xml:56 +#, no-c-format +msgid "" +"The annotations are reusable. They help describe common qualities of " +"disparate parts of the system. They help us categorize and understand our " +"code. They help us deal with common concerns in a common way. They make our " +"code more literate and more understandable." +msgstr "" + +#. Tag: para +#: part3.xml:61 +#, no-c-format +msgid "" +"Web Beans <emphasis>stereotypes</emphasis> take this idea a step further. A " +"stereotype models a common <emphasis>role</emphasis> in your application " +"architecture. It encapsulates various properties of the role, including " +"scope, interceptor bindings, deployment type, etc, into a single reusable " +"package." +msgstr "" + +#. Tag: para +#: part3.xml:66 +#, no-c-format +msgid "" +"Even Web Beans XML metadata is strongly typed! There's no compiler for XML, " +"so Web Beans takes advantage of XML schemas to validate the Java types and " +"attributes that appear in XML. This approach turns out to make the XML more " +"literate, just like annotations made our Java code more literate." +msgstr "" + +#. Tag: para +#: part3.xml:71 +#, no-c-format +msgid "" +"We're now ready to meet some more advanced features of Web Beans. Bear in " +"mind that these features exist to make our code both easier to validate and " +"more understandable. Most of the time you don't ever really <emphasis>need</" +"emphasis> to use these features, but if you use them wisely, you'll come to " +"appreciate their power." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/part4.po =================================================================== --- doc/trunk/reference/ja-JP/modules/part4.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/part4.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,52 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part4.xml:5 +#, no-c-format +msgid "" +"The third theme of Web Beans is <emphasis>integration</emphasis>. Web Beans " +"was designed to work in concert with other technologies, helping the " +"application developer fit the other technologies together. Web Beans is an " +"open technology. It forms a part of the Java EE ecosystem, and is itself the " +"foundation for a new ecosystem of portable extensions and integration with " +"existing frameworks and technologies." +msgstr "" + +#. Tag: para +#: part4.xml:12 +#, no-c-format +msgid "" +"We've already seen how Web Beans helps integrate EJB and JSF, allowing EJBs " +"to be bound directly to JSF pages. That's just the beginning. Web Beans " +"offers the same potential to diverse other technologies, such as Business " +"Process Management engines, other Web Frameworks, and third-party component " +"models. The Java EE platform will never be able to standardize all the " +"interesting technologies that are used in the world of Java application " +"development, but Web Beans makes it easier to use the technologies which are " +"not yet part of the platform seamlessly within the Java EE environment." +msgstr "" + +#. Tag: para +#: part4.xml:21 +#, no-c-format +msgid "" +"We're about to see how to take full advantage of the Java EE platform in an " +"application that uses Web Beans. We'll also briefly meet a set of SPIs that " +"are provided to support portable extensions to Web Beans. You might not ever " +"need to use these SPIs directly, but it's nice to know they are there if you " +"need them. Most importantly, you'll take advantage of them indirectly, every " +"time you use a third-party extension." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/producermethods.po =================================================================== --- doc/trunk/reference/ja-JP/modules/producermethods.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/producermethods.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,246 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: producermethods.xml:5 +#, no-c-format +msgid "Producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:7 +#, no-c-format +msgid "" +"Producer methods let us overcome certain limitations that arise when the Web " +"Bean manager, instead of the application, is responsible for instantiating " +"objects. They're also the easiest way to integrate objects which are not Web " +"Beans into the Web Beans environment. (We'll meet a second approach in <xref " +"linkend=\"xml\"/>.)" +msgstr "" + +#. Tag: para +#: producermethods.xml:12 +#, no-c-format +msgid "According to the spec:" +msgstr "" + +#. Tag: chapter +#: producermethods.xml:12 +#, no-c-format +msgid "" +"<blockquote> <para>A Web Beans producer method acts as a source of objects " +"to be injected, where:</para> <itemizedlist> <listitem> <para>the objects to " +"be injected are not required to be instances of Web Beans,</para> </" +"listitem> <listitem> <para>the concrete type of the objects to be injected " +"may vary at runtime or</para> </listitem> <listitem> <para>the objects " +"require some custom initialization that is not performed by the Web Bean " +"constructor</para> </listitem> </itemizedlist> </blockquote> <para>For " +"example, producer methods let us:</para> <itemizedlist> <listitem> " +"<para>expose a JPA entity as a Web Bean,</para> </listitem> <listitem> " +"<para>expose any JDK class as a Web Bean,</para> </listitem> <listitem> " +"<para>define multiple Web Beans, with different scopes or initialization, " +"for the same implementation class, or</para> </listitem> <listitem> " +"<para>vary the implementation of an API type at runtime.</para> </listitem> " +"</itemizedlist> <para>In particular, producer methods let us use runtime " +"polymorphism with Web Beans. As we've seen, deployment types are a powerful " +"solution to the problem of deployment-time polymorphism. But once the system " +"is deployed, the Web Bean implementation is fixed. A producer method has no " +"such limitation:</para> <programlisting><![CDATA[@SessionScoped\n" +"public class Preferences {\n" +" \n" +" private PaymentStrategyType paymentStrategy;\n" +" \n" +" ...\n" +" \n" +" @Produces @Preferred \n" +" public PaymentStrategy getPaymentStrategy() {\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return new CreditCardPaymentStrategy();\n" +" case CHEQUE: return new ChequePaymentStrategy();\n" +" case PAYPAL: return new PayPalPaymentStrategy();\n" +" default: return null;\n" +" } \n" +" }\n" +" \n" +"}]]></programlisting> <para>Consider an injection point:</para> " +"<programlisting><![CDATA[@Preferred PaymentStrategy paymentStrat;]]></" +"programlisting> <para>This injection point has the same type and binding " +"annotations as the producer method, so it resolves to the producer method " +"using the usual Web Beans injection rules. The producer method will be " +"called by the Web Bean manager to obtain an instance to service this " +"injection point.</para>." +msgstr "" + +#. Tag: title +#: producermethods.xml:68 +#, no-c-format +msgid "Scope of a producer method" +msgstr "" + +#. Tag: para +#: producermethods.xml:70 +#, no-c-format +msgid "" +"The scope of the producer method defaults to <literal>@Dependent</literal>, " +"and so it will be called <emphasis>every time</emphasis> the Web Bean " +"manager injects this field or any other field that resolves to the same " +"producer method. Thus, there could be multiple instances of the " +"<literal>PaymentStrategy</literal> object for each user session." +msgstr "" + +#. Tag: para +#: producermethods.xml:75 +#, no-c-format +msgid "" +"To change this behavior, we can add a <literal>@SessionScoped</literal> " +"annotation to the method." +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:78 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy() {\n" +" ...\n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:80 +#, no-c-format +msgid "" +"Now, when the producer method is called, the returned " +"<literal>PaymentStrategy</literal> will be bound to the session context. The " +"producer method won't be called again in the same session." +msgstr "" + +#. Tag: title +#: producermethods.xml:87 +#, no-c-format +msgid "Injection into producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:89 +#, no-c-format +msgid "" +"There's one potential problem with the code above. The implementations of " +"<literal>CreditCardPaymentStrategy</literal> are instantiated using the Java " +"<literal>new</literal> operator. Objects instantiated directly by the " +"application can't take advantage of dependency injection and don't have " +"interceptors." +msgstr "" + +#. Tag: para +#: producermethods.xml:94 +#, no-c-format +msgid "" +"If this isn't what we want we can use dependency injection into the producer " +"method to obtain Web Bean instances:" +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:97 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy(CreditCardPaymentStrategy ccps,\n" +" ChequePaymentStrategy cps,\n" +" PayPalPaymentStrategy ppps) {\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return ccps;\n" +" case CHEQUE: return cps;\n" +" case PAYPAL: return ppps;\n" +" default: return null;\n" +" } \n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:99 +#, no-c-format +msgid "" +"Wait, what if <literal>CreditCardPaymentStrategy</literal> is a request " +"scoped Web Bean? Then the producer method has the effect of \"promoting\" " +"the current request scoped instance into session scope. This is almost " +"certainly a bug! The request scoped object will be destroyed by the Web Bean " +"manager before the session ends, but the reference to the object will be " +"left \"hanging\" in the session scope. This error will <emphasis>not</" +"emphasis> be detected by the Web Bean manager, so please take extra care " +"when returning Web Bean instances from producer methods!" +msgstr "" + +#. Tag: para +#: producermethods.xml:107 +#, no-c-format +msgid "" +"There's at least three ways we could go about fixing this bug. We could " +"change the scope of the <literal>CreditCardPaymentStrategy</literal> " +"implementation, but this would affect other clients of that Web Bean. A " +"better option would be to change the scope of the producer method to " +"<literal>@Dependent</literal> or <literal>@RequestScoped</literal>." +msgstr "" + +#. Tag: para +#: producermethods.xml:113 +#, no-c-format +msgid "" +"But a more common solution is to use the special <literal>@New</literal> " +"binding annotation." +msgstr "" + +#. Tag: title +#: producermethods.xml:119 +#, no-c-format +msgid "Use of <literal>@New</literal> with producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:121 +#, no-c-format +msgid "Consider the following producer method:" +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:123 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy(@New CreditCardPaymentStrategy " +"ccps,\n" +" @New ChequePaymentStrategy cps,\n" +" @New PayPalPaymentStrategy ppps) " +"{\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return ccps;\n" +" case CHEQUE: return cps;\n" +" case PAYPAL: return ppps;\n" +" default: return null;\n" +" } \n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:125 +#, no-c-format +msgid "" +"Then a new <emphasis>dependent</emphasis> instance of " +"<literal>CreditCardPaymentStrategy</literal> will be created, passed to the " +"producer method, returned by the producer method and finally bound to the " +"session context. The dependent object won't be destroyed until the " +"<literal>Preferences</literal> object is destroyed, at the end of the " +"session." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/ri.po =================================================================== --- doc/trunk/reference/ja-JP/modules/ri.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/ri.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,898 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: ri.xml:4 +#, no-c-format +msgid "Using the Web Beans Reference Implementation" +msgstr "" + +#. Tag: para +#: ri.xml:6 +#, no-c-format +msgid "" +"The Web Beans RI comes with a two examples, <literal>webbeans-numberguess</" +"literal> (a war example, containing only simple beans) and <literal>webbeans-" +"translator</literal> (an ear example, containing enterprise beans)." +msgstr "" + +#. Tag: para +#: ri.xml:13 +#, no-c-format +msgid "" +"Currently, the Web Beans RI only runs on JBoss Application Server 5. You'll " +"need to download JBoss AS 5.0.0.GA from <ulink url=\"http://www.jboss.org/" +"jbossas/downloads/\">jboss.org</ulink>, and unzip it. For example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:20 +#, no-c-format +msgid "" +"<![CDATA[$ cd /Applications\n" +"$ unzip ~/jboss-5.0.0.GA.zip]]>" +msgstr "" + +#. Tag: para +#: ri.xml:22 +#, no-c-format +msgid "" +"Next, download the Web Beans RI from <ulink url=\"http://seamframework.org/" +"WebBeans\">seamframework.org</ulink>, and unzip it. For example" +msgstr "" + +#. Tag: programlisting +#: ri.xml:28 +#, no-c-format +msgid "" +"<![CDATA[$ cd ~/\n" +"$ unzip ~/webbeans-1.0.0.ALPHA1.zip]]>" +msgstr "" + +#. Tag: para +#: ri.xml:30 +#, no-c-format +msgid "" +"As Web Beans is a new piece of software, you need to update JBoss AS to run " +"the Web Beans RI. Future versions of JBoss AS will include these updates, " +"and this step won't be necessary." +msgstr "" + +#. Tag: para +#: ri.xml:37 +#, no-c-format +msgid "" +"Currently, two updates are needed. Firstly, a new deployer, " +"<literal>webbeans.deployer</literal> is added. This adds supports for Web " +"Bean archives to JBoss AS, and allows the Web Beans RI to query the EJB3 " +"container and discover which EJBs are installed in your application. " +"Secondly, an update to JBoss EJB3 is needed." +msgstr "" + +#. Tag: para +#: ri.xml:46 +#, no-c-format +msgid "" +"To install the update, you'll need ant 1.7.0 installed, and the " +"<literal>ANT_HOME</literal> environment variable set. For example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:51 +#, no-c-format +msgid "" +"$ unzip apache-ant-1.7.0.zip\n" +"$ export ANT_HOME=~/apache-ant-1.7.0" +msgstr "" + +#. Tag: para +#: ri.xml:53 +#, no-c-format +msgid "" +"Then, you can install the update. The update script will use Maven to " +"download the Web Beans and EJB3 automatically." +msgstr "" + +#. Tag: programlisting +#: ri.xml:58 +#, no-c-format +msgid "" +"$ cd webbeans-1.0.0.ALPHA1/jboss-as\n" +"$ ant update" +msgstr "" + +#. Tag: para +#: ri.xml:60 +#, no-c-format +msgid "Now, you're ready to deploy your first example!" +msgstr "" + +#. Tag: para +#: ri.xml:65 +#, no-c-format +msgid "" +"The build scripts for the examples offer a number of targets, these are:" +msgstr "" + +#. Tag: para +#: ri.xml:71 +#, no-c-format +msgid "<literal>ant restart</literal> - deploy the example in exploded format" +msgstr "" + +#. Tag: para +#: ri.xml:77 +#, no-c-format +msgid "" +"<literal>ant explode</literal> - update an exploded example, without " +"restarting the deployment" +msgstr "" + +#. Tag: para +#: ri.xml:83 +#, no-c-format +msgid "" +"<literal>ant deploy</literal> - deploy the example in compressed jar format" +msgstr "" + +#. Tag: para +#: ri.xml:88 +#, no-c-format +msgid "<literal>ant undeploy</literal> - remove the example from the server" +msgstr "" + +#. Tag: para +#: ri.xml:93 +#, no-c-format +msgid "<literal>ant clean</literal> - clean the example" +msgstr "" + +#. Tag: para +#: ri.xml:100 +#, no-c-format +msgid "To deploy the numberguess example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:104 +#, no-c-format +msgid "" +"$ cd examples/numberguess\n" +"ant deploy" +msgstr "" + +#. Tag: para +#: ri.xml:106 +#, no-c-format +msgid "" +"Wait for the application to deploy, and enjoy hours of fun at <ulink url=" +"\"http://localhost:8080/webbeans-numberguess\"></ulink>!" +msgstr "" + +#. Tag: para +#: ri.xml:111 +#, no-c-format +msgid "" +"The Web Beans RI includes a second simple example that will translate your " +"text into Latin. The numberguess example is a war example, and uses only " +"simple beans; the translator example is an ear example, and includes " +"enterprise beans, packaged in an EJB module. To try it out:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:118 +#, no-c-format +msgid "" +"$ cd examples/traslator\n" +"ant deploy" +msgstr "" + +#. Tag: para +#: ri.xml:120 +#, no-c-format +msgid "" +"Wait for the application to deploy, and visit <ulink url=\"http://" +"localhost:8080/webbeans-translator\"></ulink>!" +msgstr "" + +#. Tag: title +#: ri.xml:126 +#, no-c-format +msgid "The numberguess example" +msgstr "" + +#. Tag: para +#: ri.xml:128 +#, no-c-format +msgid "" +"In the numberguess application you get given 10 attempts to guess a number " +"between 1 and 100. After each attempt, you will be told whether you are too " +"high, or too low." +msgstr "" + +#. Tag: para +#: ri.xml:134 +#, no-c-format +msgid "" +"The numberguess example is comprised of a number of Web Beans, configuration " +"files, and Facelet JSF pages, packaged as a war. Let's start with the " +"configuration files." +msgstr "" + +#. Tag: para +#: ri.xml:140 +#, no-c-format +msgid "" +"All the configuration files for this example are located in <literal>WEB-INF/" +"</literal>, which is stored in <literal>WebContent</literal> in the source " +"tree. First, we have <literal>faces-config.xml</literal>, in which we tell " +"JSF to use Facelets:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:148 +#, no-c-format +msgid "" +"<![CDATA[<?xml version='1.0' encoding='UTF-8'?>\n" +"<faces-config version=\"1.2\"\n" +" xmlns=\"http://java.sun.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://" +"java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd\">\n" +" \n" +" <application>\n" +" <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>\n" +" </application>\n" +"\n" +"</faces-config>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:150 +#, no-c-format +msgid "" +"There is an empty <literal>web-beans.xml</literal> file, which marks this " +"application as a Web Beans application." +msgstr "" + +#. Tag: para +#: ri.xml:155 +#, no-c-format +msgid "Finally there is <literal>web.xml</literal>:" +msgstr "" + +#. Tag: section +#: ri.xml:157 +#, no-c-format +msgid "" +"<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> " +"<area id=\"faces.servlet.mapping\" coords=\"18\"/> <area id=\"faces.default." +"suffix\" coords=\"23\"/> <area id=\"session.timeout\" coords=\"28\"/> <area " +"id=\"webbeans.listener\" coords=\"32\"/> </areaspec> <programlisting><![CDATA" +"[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"\n" +"<web-app version=\"2.5\"\n" +" xmlns=\"http://java.sun.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun." +"com/xml/ns/javaee/web-app_2_5.xsd\">\n" +" \n" +" <display-name>Web Beans Numbergues example</display-name>\n" +"\n" +" \n" +"\n" +" <servlet>\n" +" <servlet-name>Faces Servlet</servlet-name>\n" +" <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>\n" +" <load-on-startup>1</load-on-startup>\n" +" </servlet>\n" +"\n" +" <servlet-mapping>\n" +" <servlet-name>Faces Servlet</servlet-name>\n" +" <url-pattern>*.jsf</url-pattern>\n" +" </servlet-mapping>\n" +" \n" +" <context-param>\n" +" <param-name>javax.faces.DEFAULT_SUFFIX</param-name>\n" +" <param-value>.xhtml</param-value>\n" +" </context-param>\n" +"\n" +" <session-config>\n" +" <session-timeout>10</session-timeout>\n" +" </session-config>\n" +" \n" +" <listener>\n" +" <listener-class>org.jboss.webbeans.servlet.WebBeansListener</listener-" +"class>\n" +" </listener>\n" +"\n" +"</web-app>]]></programlisting> <calloutlist> <callout arearefs=\"faces." +"servlet\"> <para> Enable and load the JSF servlet </para> </callout> " +"<callout arearefs=\"faces.servlet.mapping\"> <para> Configure requests to " +"<literal>.jsf</literal> pages to be handled by JSF </para> </callout> " +"<callout arearefs=\"faces.default.suffix\"> <para> Tell JSF that we will be " +"giving our source files (facelets) an extension of <literal>.jsf</literal> </" +"para> </callout> <callout arearefs=\"session.timeout\"> <para> Configure a " +"session timeout of 10 minutes </para> </callout> <callout arearefs=" +"\"webbeans.listener\"> <para> Configure the Web Beans listener, so that Web " +"Beans services can be used in the servlet request </para> </callout> </" +"calloutlist> </programlistingco> <note> <para> The only configuration " +"required by the Web Beans RI in <literal>web.xml</literal> is to add the Web " +"Beans listener. </para> <para> Whilst this demo is a JSF demo, you can use " +"the Web Beans RI with any Servlet based web framework; just configure the " +"Web Beans listener. </para> </note> <para> Let's take a look at the Facelet " +"view: </para> <programlistingco> <areaspec> <area id=\"template\" coords=\"8" +"\"/> <area id=\"messages\" coords=\"12\"/> <area id=\"instructions\" coords=" +"\"19\"/> <area id=\"guess\" coords=\"25\"/> <area id=\"validator\" coords=" +"\"29\"/> <area id=\"submit\" coords=\"32\"/> </areaspec> <programlisting><!" +"[CDATA[<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" " +"\"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\n" +"<html xmlns=\"http://www.w3.org/1999/xhtml\"\n" +" xmlns:ui=\"http://java.sun.com/jsf/facelets\"\n" +" xmlns:h=\"http://java.sun.com/jsf/html\"\n" +" xmlns:f=\"http://java.sun.com/jsf/core\"\n" +" xmlns:s=\"http://jboss.com/products/seam/taglib\">\n" +"\n" +" <ui:composition template=\"template.xhtml\">\n" +" <ui:define name=\"content\">\n" +" <h1>Guess a number...</h1>\n" +" <h:form id=\"NumberGuessMain\">\n" +" <div style=\"color: red\">\n" +" <h:messages id=\"messages\" globalOnly=\"false\"/>\n" +" <h:outputText id=\"Higher\" value=\"Higher!\" rendered=\"#{game." +"number gt game.guess}\"/>\n" +" <h:outputText id=\"Lower\" value=\"Lower!\" rendered=\"#{game." +"number lt game.guess}\"/>\n" +" </div>\n" +" \n" +" <div>\n" +" I'm thinking of a number between #{game.smallest} and #{game." +"biggest}.\n" +" You have #{game.remainingGuesses} guesses.\n" +" </div>\n" +" \n" +" <div>\n" +" Your guess: \n" +" <h:inputText id=\"inputGuess\" \n" +" value=\"#{game.guess}\" \n" +" required=\"true\" \n" +" size=\"3\">\n" +" <f:validateLongRange maximum=\"#{game.biggest}\" \n" +" minimum=\"#{game.smallest}\"/>\n" +" </h:inputText>\n" +" <h:commandButton id=\"GuessButton\" \n" +" value=\"Guess\" \n" +" action=\"#{game.check}\"/>\n" +" </div>\n" +" \n" +" </h:form>\n" +" </ui:define>\n" +" </ui:composition>\n" +"</html>]]></programlisting> <calloutlist> <callout arearefs=\"template\"> " +"<para> Facelets is a templating language for JSF, here we are wrapping our " +"page in a template which defines the header. </para> </callout> <callout " +"arearefs=\"messages\"> <para> There are a number of messages which can be " +"sent to the user, \"Higher!\", \"Lower!\" and \"Correct!\" </para> </" +"callout> <callout arearefs=\"instructions\"> <para> As the user guesses, the " +"range of numbers they can guess gets smaller - this sentance changes to make " +"sure they know what range to guess in. </para> </callout> <callout arearefs=" +"\"guess\"> <para> This input field is bound to a Web Bean, using the value " +"expression. </para> </callout> <callout arearefs=\"validator\"> <para> A " +"range validator is used to make sure the user doesn't accidentally input a " +"number outside of the range in which they can guess - if the validator " +"wasn't here, the user might use up a guess on an out of range number. </" +"para> </callout> <callout arearefs=\"submit\"> <para> And, of course, there " +"must be a way for the user to send their guess to the server. Here we bind " +"to an action method on the Web Bean. </para> </callout> </calloutlist> </" +"programlistingco>" +msgstr "" + +#. Tag: para +#: ri.xml:270 +#, no-c-format +msgid "" +"The example exists of 4 classes, the first two of which are binding types. " +"First, there is the <literal>@Random</literal> binding type, used for " +"injecting a random number:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:276 +#, no-c-format +msgid "" +"<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" +"@Retention(RUNTIME)\n" +"@Documented\n" +"@BindingType\n" +"public @interface Random {}]]>" +msgstr "" + +#. Tag: para +#: ri.xml:278 +#, no-c-format +msgid "" +"There is also the <literal>@MaxNumber</literal> binding type, used for " +"injecting the maximum number that can be injected:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:283 +#, no-c-format +msgid "" +"<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" +"@Retention(RUNTIME)\n" +"@Documented\n" +"@BindingType\n" +"public @interface MaxNumber {}\n" +"]]>" +msgstr "" + +#. Tag: para +#: ri.xml:285 +#, no-c-format +msgid "" +"The <literal>Generator</literal> class is responsible for creating the " +"random number, via a producer method. It also exposes the maximum possible " +"number via a producer method:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:291 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped\n" +"public class Generator {\n" +" \n" +" private java.util.Random random = new java.util.Random( System." +"currentTimeMillis() );\n" +" \n" +" private int maxNumber = 100;\n" +" \n" +" java.util.Random getRandom()\n" +" {\n" +" return random;\n" +" }\n" +" \n" +" @Produces @Random int next() { \n" +" return getRandom().nextInt(maxNumber); \n" +" }\n" +" \n" +" @Produces @MaxNumber int getMaxNumber()\n" +" {\n" +" return maxNumber;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: ri.xml:293 +#, no-c-format +msgid "" +"You'll notice that the <literal>Generator</literal> is application scoped; " +"therefore we don't get a different random each time." +msgstr "" + +#. Tag: para +#: ri.xml:298 +#, no-c-format +msgid "" +"The final Web Bean in the application is the session scoped <literal>Game</" +"literal>. By making <literal>Game</literal> session scoped, you can only " +"play the game once per browser session. You could easily add a reset button " +"- a good exercise for the reader :-)" +msgstr "" + +#. Tag: para +#: ri.xml:305 +#, no-c-format +msgid "" +"You'll also note that we've used the <literal>@Named</literal> annotation, " +"so that we can use the bean through EL in the JSF page. Finally, we've used " +"constructor injection to initialize the game with a random number. And of " +"course, we need to tell the player when they've won, so we give feedback " +"with a <literal>FacesMessage</literal>." +msgstr "" + +#. Tag: programlisting +#: ri.xml:313 +#, no-c-format +msgid "" +"<![CDATA[@Named\n" +"@SessionScoped\n" +"public class Game {\n" +" private int number;\n" +" \n" +" private int guess;\n" +" private int smallest;\n" +" private int biggest;\n" +" private int remainingGuesses;\n" +" \n" +" public Game() {}\n" +" \n" +" @Initializer\n" +" Game(@Random int number, @MaxNumber int maxNumber) {\n" +" this.number = number;\n" +" this.smallest = 1;\n" +" this.biggest = maxNumber;\n" +" this.remainingGuesses = 10;\n" +" }\n" +"\n" +" // Getters and setters for fields\n" +" \n" +" public String check() {\n" +" if (guess>number) {\n" +" biggest = guess - 1;\n" +" }\n" +" if (guess<number) {\n" +" smallest = guess + 1;\n" +" }\n" +" if (guess == number) {\n" +" FacesContext.getCurrentInstance().addMessage(null, new FacesMessage" +"(\"Correct!\"));\n" +" }\n" +" remainingGuesses--;\n" +" return null;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: title +#: ri.xml:317 +#, no-c-format +msgid "The translator example" +msgstr "" + +#. Tag: para +#: ri.xml:319 +#, no-c-format +msgid "" +"The translator example will take any sentences you enter, and translate them " +"to Latin." +msgstr "" + +#. Tag: para +#: ri.xml:324 +#, no-c-format +msgid "" +"The translator example is built as an ear, and contains EJBs and enterprise " +"beans. As a result, it's structure is more complex than the numberguess " +"example." +msgstr "" + +#. Tag: para +#: ri.xml:331 +#, no-c-format +msgid "" +"EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will make " +"this structure much simpler!" +msgstr "" + +#. Tag: para +#: ri.xml:337 +#, no-c-format +msgid "" +"First, let's take a look at the ear aggregator, which is located in " +"<literal>webbeans-translator-ear</literal> module. Maven automatically " +"generates the <literal>application.xml</literal> and <literal>jboss-app.xml</" +"literal> for us:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:344 +#, no-c-format +msgid "" +"<![CDATA[<plugin>\n" +" <groupId>org.apache.maven.plugins</groupId>\n" +" <artifactId>maven-ear-plugin</artifactId>\n" +" <configuration>\n" +" <modules>\n" +" <webModule>\n" +" <groupId>org.jboss.webbeans.examples.translator</groupId>\n" +" <artifactId>webbeans-translator-war</artifactId>\n" +" <contextRoot>/webbeans-translator</contextRoot>\n" +" </webModule>\n" +" </modules>\n" +" <jboss>\n" +" <loader-repository>webbeans.jboss.org:loader=webbeans-translator</" +"loader-repository>\n" +" </jboss>\n" +" </configuration>\n" +"</plugin>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:346 +#, no-c-format +msgid "" +"We're doing a couple of things here - firstly we set the context path, which " +"gives us a nice url (<ulink url=\"http://localhost:8080/webbeans-translator" +"\">http://localhost:8080/webbeans-translator</ulink>) and we also enable " +"class loader isolation for JBoss AS." +msgstr "" + +#. Tag: para +#: ri.xml:354 +#, no-c-format +msgid "" +"If you aren't using Maven to generate these files, you would need " +"<literal>META-INF/jboss-app.xml</literal>:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:359 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<!DOCTYPE jboss-app\n" +" PUBLIC \"-//JBoss//DTD J2EE Application 4.2//EN\"\n" +" \"http://www.jboss.org/j2ee/dtd/jboss-app_4_2.dtd\">\n" +"<jboss-app>\n" +" <loader-repository>webbeans.jboss.org:loader=webbeans-translator</loader-" +"repository>\n" +"</jboss-app>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:361 +#, no-c-format +msgid "and <literal>META-INF/application.xml</literal>:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:365 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<application xmlns=\"http://java.sun.com/xml/ns/javaee\" \n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://" +"java.sun.com/xml/ns/javaee/application_5.xsd\"\n" +" version=\"5\">\n" +" <display-name>webbeans-translator-ear</display-name>\n" +" <description>Ear Example for the reference implementation of JSR 299: Web " +"Beans</description>\n" +" \n" +" <module>\n" +" <web>\n" +" <web-uri>webbeans-translator.war</web-uri>\n" +" <context-root>/webbeans-translator</context-root>\n" +" </web>\n" +" </module>\n" +" <module>\n" +" <ejb>webbeans-translator.jar</ejb>\n" +" </module>\n" +"</application>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:368 +#, no-c-format +msgid "" +"Next, lets look at the war. Just as in the numberguess example, we have a " +"<literal>faces-config.xml</literal> (to enabled Facelets) and a <literal>web." +"xml</literal> (to enable JSF and attach Web Beans services to the servlet " +"container) in <literal>WebContent/WEB-INF</literal>." +msgstr "" + +#. Tag: para +#: ri.xml:375 +#, no-c-format +msgid "" +"More intersting is the facelet used to translate text. Just as in the " +"numberguess example we have a template, which surrounds the form (ommitted " +"here for brevity):" +msgstr "" + +#. Tag: programlisting +#: ri.xml:381 +#, no-c-format +msgid "" +"<![CDATA[<h:form id=\"NumberGuessMain\">\n" +" \n" +" <table>\n" +" <tr align=\"center\" style=\"font-weight: bold\" >\n" +" <td>\n" +" Your text\n" +" </td>\n" +" <td>\n" +" Translation\n" +" </td>\n" +" </tr>\n" +" <tr>\n" +" <td>\n" +" <h:inputTextarea id=\"text\" value=\"#{translator.text}\" " +"required=\"true\" rows=\"5\" cols=\"80\" />\n" +" </td>\n" +" <td>\n" +" <h:outputText value=\"#{translator.translatedText}\" />\n" +" </td>\n" +" </tr>\n" +" </table>\n" +" <div>\n" +" <h:commandButton id=\"button\" value=\"Translate\" action=\"#" +"{translator.translate}\"/>\n" +" </div>\n" +" \n" +"</h:form>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:383 +#, no-c-format +msgid "" +"The user can enter some text in the lefthand textarea, and hit the translate " +"button to see the result to the right." +msgstr "" + +#. Tag: para +#: ri.xml:388 +#, no-c-format +msgid "" +"Finally, let's look at the ejb module, <literal>webbeans-translator-ejb</" +"literal>. There are two configuration files in <literal>src/main/resources/" +"META-INF</literal>, an empty <literal>web-beans.xml</literal>, used to mark " +"the archive as containing Web Beans, and <literal>ejb-jar.xml</literal>. Web " +"Beans provides injection and initializtion services for all EJBs, and uses " +"<literal>ejb-jar.xml</literal> to enable this, you'll need this in any EJB " +"project which uses Web Beans:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:400 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar xmlns=\"http://java.sun.com/xml/ns/javaee\" \n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" \n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java." +"sun.com/xml/ns/javaee/ejb-jar_3_0.xsd\"\n" +" version=\"3.0\">\n" +" \n" +" <interceptors>\n" +" <interceptor>\n" +" <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</" +"interceptor-class>\n" +" </interceptor>\n" +" </interceptors>\n" +" \n" +" <assembly-descriptor>\n" +" <interceptor-binding>\n" +" <ejb-name>*</ejb-name>\n" +" <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</" +"interceptor-class>\n" +" </interceptor-binding>\n" +" </assembly-descriptor>\n" +" \n" +"</ejb-jar>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:402 +#, no-c-format +msgid "" +"We've saved the most interesting bit to last, the code! The project has two " +"simple beans, <literal>SentanceParser</literal> and <literal>TextTranslator</" +"literal> and two enterprise beans, <literal>TanslatorControllerBean</" +"literal> and <literal>SentenceTranslator</literal>. You should be getting " +"quite familiar with what a Web Bean looks like by now, so we'll just " +"highlight the most interesting bits here." +msgstr "" + +#. Tag: para +#: ri.xml:412 +#, no-c-format +msgid "" +"Both <literal>SentanceParser</literal> and <literal>TextTranslator</literal> " +"are dependent beans, and <literal>TextTranslator</literal> uses constructor " +"initialization:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:418 +#, no-c-format +msgid "" +"<![CDATA[public class TextTranslator { \n" +" private SentenceParser sentenceParser; \n" +" private Translator sentenceTranslator; \n" +" \n" +" @Initializer\n" +" TextTranslator(SentenceParser sentenceParser, Translator " +"sentenceTranslator) \n" +" { \n" +" this.sentenceParser = sentenceParser; \n" +" this.sentenceTranslator = sentenceTranslator;]]>" +msgstr "" + +#. Tag: para +#: ri.xml:420 +#, no-c-format +msgid "" +"<literal>TextTranslator</literal> is a stateless bean (with a local business " +"interface), where the magic happens - of course, we couldn't develop a full " +"translator, but we gave it a good go!" +msgstr "" + +#. Tag: para +#: ri.xml:426 +#, no-c-format +msgid "" +"Finally, there is UI orientated controller, that collects the text from the " +"user, and dispatches it to the translator. This is a request scoped, named, " +"stateful session bean, which injects the translator." +msgstr "" + +#. Tag: programlisting +#: ri.xml:432 +#, no-c-format +msgid "" +"<![CDATA[@Stateful\n" +"@RequestScoped\n" +"@Named(\"translator\")\n" +"public class TranslatorControllerBean implements TranslatorController\n" +"{\n" +" \n" +" @Current TextTranslator translator;]]>" +msgstr "" + +#. Tag: para +#: ri.xml:434 +#, no-c-format +msgid "The bean also has getters and setters for all the fields on the page." +msgstr "" + +#. Tag: para +#: ri.xml:438 +#, no-c-format +msgid "As this is a stateful session bean, we have to have a remove method:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:442 +#, no-c-format +msgid "" +"<![CDATA[ @Remove\n" +" public void remove()\n" +" {\n" +" \n" +" }]]>" +msgstr "" + +#. Tag: para +#: ri.xml:444 +#, no-c-format +msgid "" +"The Web Beans manager will call the remove method for you when the bean is " +"destroyed; in this case at the end of the request." +msgstr "" + +#. Tag: para +#: ri.xml:450 +#, no-c-format +msgid "" +"That concludes our short tour of the Web Beans RI examples. For more on the " +"RI, or to help out, please visit <ulink url=\"http://www.seamframework.org/" +"WebBeans/Development\">http://www.seamframework.org/WebBeans/Development</" +"ulink>." +msgstr "" + +#. Tag: para +#: ri.xml:456 +#, no-c-format +msgid "" +"We need help in all areas - bug fixing, writing new features, writing " +"examples and translating this reference guide." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/scopescontexts.po =================================================================== --- doc/trunk/reference/ja-JP/modules/scopescontexts.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/scopescontexts.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,582 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: scopescontexts.xml:4 +#, no-c-format +msgid "Scopes and contexts" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:6 +#, no-c-format +msgid "" +"So far, we've seen a few examples of <emphasis>scope type annotations</" +"emphasis>. The scope of a Web Bean determines the lifecycle of instances of " +"the Web Bean. The scope also determines which clients refer to which " +"instances of the Web Bean. According to the Web Beans specification, a scope " +"determines:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:14 +#, no-c-format +msgid "When a new instance of any Web Bean with that scope is created" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:17 +#, no-c-format +msgid "When an existing instance of any Web Bean with that scope is destroyed" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:20 +#, no-c-format +msgid "" +"Which injected references refer to any instance of a Web Bean with that scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:25 +#, no-c-format +msgid "" +"For example, if we have a session scoped Web Bean, <literal>CurrentUser</" +"literal>, all Web Beans that are called in the context of the same " +"<literal>HttpSession</literal> will see the same instance of " +"<literal>CurrentUser</literal>. This instance will be automatically created " +"the first time a <literal>CurrentUser</literal> is needed in that session, " +"and automatically destroyed when the session ends." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:32 +#, no-c-format +msgid "Scope types" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:34 +#, no-c-format +msgid "" +"Web Beans features an <emphasis>extensible context model</emphasis>. It is " +"possible to define new scopes by creating a new scope type annotation:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:37 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD})\n" +"@ScopeType\n" +"public @interface ClusterScoped {}]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:39 +#, no-c-format +msgid "" +"Of course, that's the easy part of the job. For this scope type to be " +"useful, we will also need to define a <literal>Context</literal> object that " +"implements the scope! Implementing a <literal>Context</literal> is usually a " +"very technical task, intended for framework development only." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:44 +#, no-c-format +msgid "" +"We can apply a scope type annotation to a Web Bean implementation class to " +"specify the scope of the Web Bean:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:47 +#, no-c-format +msgid "" +"<![CDATA[@ClusterScoped\n" +"public class SecondLevelCache { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:58 +#, no-c-format +msgid "Usually, you'll use one of Web Beans' built-in scopes." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:63 +#, no-c-format +msgid "Built-in scopes" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:65 +#, no-c-format +msgid "Web Beans defines four built-in scopes:" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:69 +#, no-c-format +msgid "@RequestScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:72 +#, no-c-format +msgid "@SessionScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:75 +#, no-c-format +msgid "@ApplicationScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:78 +#, no-c-format +msgid "@ConversationScoped" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:82 +#, no-c-format +msgid "For a web application that uses Web Beans:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:86 +#, no-c-format +msgid "" +"any servlet request has access to active request, session and application " +"scopes, and, additionally" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:90 +#, no-c-format +msgid "any JSF request has access to an active conversation scope." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:94 +#, no-c-format +msgid "The request and application scopes are also active:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:98 +#, no-c-format +msgid "during invocations of EJB remote methods," +msgstr "" + +#. Tag: para +#: scopescontexts.xml:101 +#, no-c-format +msgid "during EJB timeouts," +msgstr "" + +#. Tag: para +#: scopescontexts.xml:104 +#, no-c-format +msgid "during message delivery to a message-driven bean, and" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:107 +#, no-c-format +msgid "during web service invocations." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:111 +#, no-c-format +msgid "" +"If the application tries to invoke a Web Bean with a scope that does not " +"have an active context, a <literal>ContextNotActiveException</literal> is " +"thrown by the Web Bean manager at runtime." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:115 +#, no-c-format +msgid "" +"Three of the four built-in scopes should be extremely familiar to every Java " +"EE developer, so let's not waste time discussing them here. One of the " +"scopes, however, is new." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:122 +#, no-c-format +msgid "The conversation scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:124 +#, no-c-format +msgid "" +"The Web Beans conversation scope is a bit like the traditional session scope " +"in that it holds state associated with a user of the system, and spans " +"multiple requests to the server. However, unlike the session scope, the " +"conversation scope:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:130 +#, no-c-format +msgid "is demarcated explicitly by the application, and" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:133 +#, no-c-format +msgid "" +"holds state associated with a particular web browser tab in a JSF " +"application." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:138 +#, no-c-format +msgid "" +"A conversation represents a task, a unit of work from the point of view of " +"the user. The conversation context holds state associated with what the user " +"is currently working on. If the user is doing multiple things at the same " +"time, there are multiple conversations." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:143 +#, no-c-format +msgid "" +"The conversation context is active during any JSF request. However, most " +"conversations are destroyed at the end of the request. If a conversation " +"should hold state across multiple requests, it must be explicitly promoted " +"to a <emphasis>long-running conversation</emphasis>." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:149 +#, no-c-format +msgid "Conversation demarcation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:151 +#, no-c-format +msgid "" +"Web Beans provides a built-in Web Bean for controlling the lifecyle of " +"conversations in a JSF application. This Web Bean may be obtained by " +"injection:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:154 +#, no-c-format +msgid "@Current Conversation conversation;" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:156 +#, no-c-format +msgid "" +"To promote the conversation associated with the current request to a long-" +"running conversation, call the <literal>begin()</literal> method from " +"application code. To schedule the current long-running conversation context " +"for destruction at the end of the current request, call <literal>end()</" +"literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:161 +#, no-c-format +msgid "" +"In the following example, a conversation-scoped Web Bean controls the " +"conversation with which it is associated:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:164 +#, no-c-format +msgid "" +"@ConversationScoped @Stateful\n" +"public class OrderBuilder {\n" +"\n" +" private Order order;\n" +" private @Current Conversation conversation;\n" +" private @PersistenceContext(type=EXTENDED) EntityManager em;\n" +" \n" +" @Produces public Order getOrder() {\n" +" return order;\n" +" }\n" +"\n" +" public Order createOrder() {\n" +" order = new Order();\n" +" conversation.begin();\n" +" return order;\n" +" }\n" +" \n" +" public void addLineItem(Product product, int quantity) {\n" +" order.add( new LineItem(product, quantity) );\n" +" }\n" +"\n" +" public void saveOrder(Order order) {\n" +" em.persist(order);\n" +" conversation.end();\n" +" }\n" +" \n" +" @Remove\n" +" public void destroy() {}\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:166 +#, no-c-format +msgid "" +"This Web Bean is able to control its own lifecycle through use of the " +"<literal>Conversation</literal> API. But some other Web Beans have a " +"lifecycle which depends completely upon another object." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:173 +#, no-c-format +msgid "Conversation propagation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:175 +#, no-c-format +msgid "" +"The conversation context automatically propagates with any JSF faces request " +"(JSF form submission). It does not automatically propagate with non-faces " +"requests, for example, navigation via a link." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:179 +#, no-c-format +msgid "" +"We can force the conversation to propagate with a non-faces request by " +"including the unique identifier of the conversation as a request parameter. " +"The Web Beans specification reserves the request parameter named " +"<literal>cid</literal> for this use. The unique identifier of the " +"conversation may be obtained from the <literal>Conversation</literal> " +"object, which has the Web Beans name <literal>conversation</literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:186 +#, no-c-format +msgid "Therefore, the following link propagates the conversation:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:188 +#, no-c-format +msgid "" +"<![CDATA[<a href=\"/addProduct.jsp?cid=#{conversation.id}\">Add Product</a>]]" +">" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:190 +#, no-c-format +msgid "" +"The Web Bean manager is also required to propagate conversations across any " +"redirect, even if the conversation is not marked long-running. This makes it " +"very easy to implement the common POST-then-redirect pattern, without resort " +"to fragile constructs such as a \"flash\" object. In this case, the Web Bean " +"manager automatically adds a request parameter to the redirect URL." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:200 +#, no-c-format +msgid "Conversation timeout" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:202 +#, no-c-format +msgid "" +"The Web Bean manager is permitted to destroy a conversation and all state " +"held in its context at any time in order to preserve resources. A Web Bean " +"manager implementation will normally do this on the basis of some kind of " +"timeoutthough this is not required by the Web Beans specification. The " +"timeout is the period of inactivity before the conversation is destroyed." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:208 +#, no-c-format +msgid "" +"The <literal>Conversation</literal> object provides a method to set the " +"timeout. This is a hint to the Web Bean manager, which is free to ignore the " +"setting." +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:212 +#, no-c-format +msgid "conversation.setTimeout(timeoutInMillis);" +msgstr "" + +#. Tag: title +#: scopescontexts.xml:219 +#, no-c-format +msgid "The dependent pseudo-scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:221 +#, no-c-format +msgid "" +"In addition to the four built-in scopes, Web Beans features the so-called " +"<emphasis>dependent pseudo-scope</emphasis>. This is the default scope for a " +"Web Bean which does not explicitly declare a scope type." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:225 +#, no-c-format +msgid "" +"For example, this Web Bean has the scope type <literal>@Dependent</literal>:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:227 +#, no-c-format +msgid "<![CDATA[public class Calculator { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:229 +#, no-c-format +msgid "" +"When an injection point of a Web Bean resolves to a dependent Web Bean, a " +"new instance of the dependent Web Bean is created every time the first Web " +"Bean is instantiated. Instances of dependent Web Beans are never shared " +"between different Web Beans or different injection points. They are " +"<emphasis>dependent objects</emphasis> of some other Web Bean instance." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:235 +#, no-c-format +msgid "" +"Dependent Web Bean instances are destroyed when the instance they depend " +"upon is destroyed." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:243 +#, no-c-format +msgid "" +"Web Beans makes it easy to obtain a dependent instance of a Java class or " +"EJB bean, even if the class or EJB bean is already declared as a Web Bean " +"with some other scope type." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:248 +#, no-c-format +msgid "The <literal>@New</literal> annotation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:250 +#, no-c-format +msgid "" +"The built-in <literal>@New</literal> binding annotation allows " +"<emphasis>implicit</emphasis> definition of a dependent Web Bean at an " +"injection point. Suppose we declare the following injected field:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:254 +#, no-c-format +msgid "<![CDATA[@New Calculator calculator;]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:256 +#, no-c-format +msgid "" +"Then a Web Bean with scope <literal>@Dependent</literal>, binding type " +"<literal>@New</literal>, API type <literal>Calculator</literal>, " +"implementation class <literal>Calculator</literal> and deployment type " +"<literal>@Standard</literal> is implicitly defined." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:261 +#, no-c-format +msgid "" +"This is true even if <literal>Calculator</literal> is <emphasis>already</" +"emphasis> declared with a different scope type, for example:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:264 +#, no-c-format +msgid "" +"<![CDATA[@ConversationScoped\n" +"public class Calculator { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:266 +#, no-c-format +msgid "" +"So the following injected attributes each get a different instance of " +"<literal>Calculator</literal>:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:269 +#, no-c-format +msgid "" +"<![CDATA[public class PaymentCalc {\n" +"\n" +" @Current Calculator calculator;\n" +" @New Calculator newCalculator;\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:271 +#, no-c-format +msgid "" +"The <literal>calculator</literal> field has a conversation-scoped instance " +"of <literal>Calculator</literal> injected. The <literal>newCalculator</" +"literal> field has a new instance of <literal>Calculator</literal> injected, " +"with a lifecycle that is bound to the owning <literal>PaymentCalc</literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:276 +#, no-c-format +msgid "" +"This feature is particularly useful with producer methods, as we'll see in " +"the next chapter." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/specialization.po =================================================================== --- doc/trunk/reference/ja-JP/modules/specialization.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/specialization.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,291 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: specialization.xml:4 +#, no-c-format +msgid "Specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:6 +#, no-c-format +msgid "" +"We've already seen how the Web Beans dependency injection model lets us " +"<emphasis>override</emphasis> the implementation of an API at deployment " +"time. For example, the following enterprise Web Bean provides an " +"implementation of the API <literal>PaymentProcessor</literal> in production:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:11 +#, no-c-format +msgid "" +"@CreditCard @Stateless\n" +"public class CreditCardPaymentProcessor \n" +" implements PaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:13 +#, no-c-format +msgid "" +"But in our staging environment, we override that implementation of " +"<literal>PaymentProcessor</literal> with a different Web Bean:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:16 +#, no-c-format +msgid "" +"@CreditCard @Stateless @Staging\n" +"public class StagingCreditCardPaymentProcessor \n" +" implements PaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:18 +#, no-c-format +msgid "" +"What we've tried to do with <literal>StagingCreditCardPaymentProcessor</" +"literal> is to completely replace <literal>AsyncPaymentProcessor</literal> " +"in a particular deployment of the system. In that deployment, the deployment " +"type <literal>@Staging</literal> would have a higher priority than the " +"default deployment type <literal>@Production</literal>, and therefore " +"clients with the following injection point:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:24 +#, no-c-format +msgid "@CreditCard PaymentProcessor ccpp" +msgstr "" + +#. Tag: para +#: specialization.xml:26 +#, no-c-format +msgid "" +"Would receive an instance of <literal>StagingCreditCardPaymentProcessor</" +"literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:28 +#, no-c-format +msgid "Unfortunately, there are several traps we can easily fall into:" +msgstr "" + +#. Tag: para +#: specialization.xml:32 +#, no-c-format +msgid "" +"the higher-priority Web Bean may not implement all the API types of the Web " +"Bean that it attempts to override," +msgstr "" + +#. Tag: para +#: specialization.xml:36 +#, no-c-format +msgid "" +"the higher-priority Web Bean may not declare all the binding types of the " +"Web Bean that it attempts to override," +msgstr "" + +#. Tag: para +#: specialization.xml:40 +#, no-c-format +msgid "" +"the higher-priority Web Bean might not have the same name as the Web Bean " +"that it attempts to override, or" +msgstr "" + +#. Tag: para +#: specialization.xml:44 +#, no-c-format +msgid "" +"the Web Bean that it attempts to override might declare a producer method, " +"disposal method or observer method." +msgstr "" + +#. Tag: para +#: specialization.xml:49 +#, no-c-format +msgid "" +"In each of these cases, the Web Bean that we tried to override could still " +"be called at runtime. Therefore, overriding is somewhat prone to developer " +"error." +msgstr "" + +#. Tag: para +#: specialization.xml:52 +#, no-c-format +msgid "" +"Web Beans provides a special feature, called <emphasis>specialization</" +"emphasis>, that helps the developer avoid these traps. Specialization looks " +"a little esoteric at first, but it's easy to use in practice, and you'll " +"really appreciate the extra security it provides." +msgstr "" + +#. Tag: title +#: specialization.xml:58 +#, no-c-format +msgid "Using specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:60 +#, no-c-format +msgid "" +"Specialization is a feature that is specific to simple and enterprise Web " +"Beans. To make use of specialization, the higher-priority Web Bean must:" +msgstr "" + +#. Tag: para +#: specialization.xml:65 +#, no-c-format +msgid "be a direct subclass of the Web Bean it overrides, and" +msgstr "" + +#. Tag: para +#: specialization.xml:68 +#, no-c-format +msgid "" +"be a simple Web Bean if the Web Bean it overrides is a simple Web Bean or an " +"enterprise Web Bean if the Web Bean it overrides is an enterprise Web Bean, " +"and" +msgstr "" + +#. Tag: para +#: specialization.xml:73 +#, no-c-format +msgid "be annotated <literal>@Specializes</literal>." +msgstr "" + +#. Tag: programlisting +#: specialization.xml:77 +#, no-c-format +msgid "" +"@Stateless @Staging @Specializes\n" +"public class StagingCreditCardPaymentProcessor \n" +" extends CreditCardPaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:79 +#, no-c-format +msgid "" +"We say that the higher-priority Web Bean <emphasis>specializes</emphasis> " +"its superclass." +msgstr "" + +#. Tag: title +#: specialization.xml:85 +#, no-c-format +msgid "Advantages of specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:87 +#, no-c-format +msgid "When specialization is used:" +msgstr "" + +#. Tag: para +#: specialization.xml:91 +#, no-c-format +msgid "" +"the binding types of the superclass are automatically inherited by the Web " +"Bean annotated <literal>@Specializes</literal>, and" +msgstr "" + +#. Tag: para +#: specialization.xml:95 +#, no-c-format +msgid "" +"the Web Bean name of the superclass is automatically inherited by the Web " +"Bean annotated <literal>@Specializes</literal>, and" +msgstr "" + +#. Tag: para +#: specialization.xml:99 +#, no-c-format +msgid "" +"producer methods, disposal methods and observer methods declared by the " +"superclass are called upon an instance of the Web Bean annotated " +"<literal>@Specializes</literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:105 +#, no-c-format +msgid "" +"In our example, the binding type <literal>@CreditCard</literal> of " +"<literal>CreditCardPaymentProcessor</literal> is inherited by " +"<literal>StagingCreditCardPaymentProcessor</literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:109 +#, no-c-format +msgid "Furthermore, the Web Bean manager will validate that:" +msgstr "" + +#. Tag: para +#: specialization.xml:113 +#, no-c-format +msgid "" +"all API types of the superclass are API types of the Web Bean annotated " +"<literal>@Specializes</literal> (all local interfaces of the superclass " +"enterprise bean are also local interfaces of the subclass)," +msgstr "" + +#. Tag: para +#: specialization.xml:119 +#, no-c-format +msgid "" +"the deployment type of the Web Bean annotated <literal>@Specializes</" +"literal> has a higher precedence than the deployment type of the superclass, " +"and" +msgstr "" + +#. Tag: para +#: specialization.xml:124 +#, no-c-format +msgid "" +"there is no other enabled Web Bean that also specializes the superclass." +msgstr "" + +#. Tag: para +#: specialization.xml:129 +#, no-c-format +msgid "" +"If any of these conditions are violated, the Web Bean manager throws an " +"exception at initialization time." +msgstr "" + +#. Tag: para +#: specialization.xml:132 +#, no-c-format +msgid "" +"Therefore, we can be certain that the superclass with <emphasis>never</" +"emphasis> be called in any deployment of the system where the Web Bean " +"annotated <literal>@Specializes</literal> is deployed and enabled." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/stereotypes.po =================================================================== --- doc/trunk/reference/ja-JP/modules/stereotypes.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/stereotypes.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,352 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: stereotypes.xml:4 +#, no-c-format +msgid "Stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:6 +#, no-c-format +msgid "According to the Web Beans specification:" +msgstr "" + +#. Tag: para +#: stereotypes.xml:10 +#, no-c-format +msgid "" +"In many systems, use of architectural patterns produces a set of recurring " +"Web Bean roles. A stereotype allows a framework developer to identify such a " +"role and declare some common metadata for Web Beans with that role in a " +"central place." +msgstr "" + +#. Tag: para +#: stereotypes.xml:14 +#, no-c-format +msgid "A stereotype encapsulates any combination of:" +msgstr "" + +#. Tag: para +#: stereotypes.xml:18 +#, no-c-format +msgid "a default deployment type," +msgstr "" + +#. Tag: para +#: stereotypes.xml:21 +#, no-c-format +msgid "a default scope type," +msgstr "" + +#. Tag: para +#: stereotypes.xml:24 +#, no-c-format +msgid "a restriction upon the Web Bean scope," +msgstr "" + +#. Tag: para +#: stereotypes.xml:27 +#, no-c-format +msgid "a requirement that the Web Bean implement or extend a certain type, and" +msgstr "" + +#. Tag: para +#: stereotypes.xml:30 +#, no-c-format +msgid "a set of interceptor binding annotations." +msgstr "" + +#. Tag: para +#: stereotypes.xml:34 +#, no-c-format +msgid "" +"A stereotype may also specify that all Web Beans with the stereotype have " +"defaulted Web Bean names." +msgstr "" + +#. Tag: para +#: stereotypes.xml:37 +#, no-c-format +msgid "A Web Bean may declare zero, one or multiple stereotypes." +msgstr "" + +#. Tag: para +#: stereotypes.xml:41 +#, no-c-format +msgid "" +"A stereotype is a Java annotation type. This stereotype identifies action " +"classes in some MVC framework:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:44 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:46 +#, no-c-format +msgid "We use the stereotype by applying the annotation to a Web Bean." +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:48 +#, no-c-format +msgid "" +"<![CDATA[@Action \n" +"public class LoginAction { ... }]]>" +msgstr "" + +#. Tag: title +#: stereotypes.xml:51 +#, no-c-format +msgid "Default scope and deployment type for a stereotype" +msgstr "" + +#. Tag: para +#: stereotypes.xml:53 +#, no-c-format +msgid "" +"A stereotype may specify a default scope and/or default deployment type for " +"Web Beans with that stereotype. For example, if the deployment type " +"<literal>@WebTier</literal> identifies Web Beans that should only be " +"deployed when the system executes as a web application, we might specify the " +"following defaults for action classes:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:59 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:61 +#, no-c-format +msgid "" +"Of course, a particular action may still override these defaults if " +"necessary:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:64 +#, no-c-format +msgid "" +"<![CDATA[@Dependent @Mock @Action \n" +"public class MockLoginAction { ... }]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:66 +#, no-c-format +msgid "" +"If we want to force all actions to a particular scope, we can do that too." +msgstr "" + +#. Tag: title +#: stereotypes.xml:72 +#, no-c-format +msgid "Restricting scope and type with a stereotype" +msgstr "" + +#. Tag: para +#: stereotypes.xml:74 +#, no-c-format +msgid "" +"Suppose that we wish to prevent actions from declaring certain scopes. Web " +"Beans lets us explicitly specify the set of allowed scopes for Web Beans " +"with a certain stereotype. For example:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:78 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype(supportedScopes=RequestScoped.class)\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:80 +#, no-c-format +msgid "" +"If a particular action class attempts to specify a scope other than the Web " +"Beans request scope, an exception will be thrown by the Web Bean manager at " +"initialization time." +msgstr "" + +#. Tag: para +#: stereotypes.xml:84 +#, no-c-format +msgid "" +"We can also force all Web Bean with a certain stereotype to implement an " +"interface or extend a class:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:87 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype(requiredTypes=AbstractAction.class)\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:89 +#, no-c-format +msgid "" +"If a particular action class does not extend the class " +"<literal>AbstractAction</literal>, an exception will be thrown by the Web " +"Bean manager at initialization time." +msgstr "" + +#. Tag: title +#: stereotypes.xml:96 +#, no-c-format +msgid "Interceptor bindings for stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:98 +#, no-c-format +msgid "" +"A stereotype may specify a set of interceptor bindings to be inherited by " +"all Web Beans with that stereotype." +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:101 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@Transactional(requiresNew=true)\n" +"@Secure\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:103 +#, no-c-format +msgid "" +"This helps us get technical concerns even further away from the business " +"code!" +msgstr "" + +#. Tag: title +#: stereotypes.xml:109 +#, no-c-format +msgid "Name defaulting with stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:111 +#, no-c-format +msgid "" +"Finally, we can specify that all Web Beans with a certain stereotype have a " +"Web Bean name, defaulted by the Web Bean manager. Actions are often " +"referenced in JSP pages, so they're a perfect use case for this feature. All " +"we need to do is add an empty <literal>@Named</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:116 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@Transactional(requiresNew=true)\n" +"@Secure\n" +"@Named\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:118 +#, no-c-format +msgid "" +"Now, <literal>LoginAction</literal> will have the name <literal>loginAction</" +"literal>." +msgstr "" + +#. Tag: title +#: stereotypes.xml:124 +#, no-c-format +msgid "Standard stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:126 +#, no-c-format +msgid "" +"We've already met two standard stereotypes defined by the Web Beans " +"specification: <literal>@Interceptor</literal> and <literal>@Decorator</" +"literal>." +msgstr "" + +#. Tag: para +#: stereotypes.xml:129 +#, no-c-format +msgid "Web Beans defines one further standard stereotype:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:131 +#, no-c-format +msgid "" +"<![CDATA[@Named \n" +"@RequestScoped \n" +"@Stereotype \n" +"@Target({TYPE, METHOD}) \n" +"@Retention(RUNTIME) \n" +"public @interface Model {} ]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:133 +#, no-c-format +msgid "" +"This stereotype is intended for use with JSF. Instead of using JSF managed " +"beans, just annotate a Web Bean <literal>@Model</literal>, and use it " +"directly in your JSF page." +msgstr "" Added: doc/trunk/reference/ja-JP/modules/xml.po =================================================================== --- doc/trunk/reference/ja-JP/modules/xml.po (rev 0) +++ doc/trunk/reference/ja-JP/modules/xml.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,352 @@ +# Language ja-JP translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: xml.xml:4 +#, no-c-format +msgid "Defining Web Beans using XML" +msgstr "" + +#. Tag: para +#: xml.xml:6 +#, no-c-format +msgid "" +"So far, we've seen plenty of examples of Web Beans declared using " +"annotations. However, there are a couple of occasions when we can't use " +"annotations to define the Web Bean:" +msgstr "" + +#. Tag: para +#: xml.xml:12 +#, no-c-format +msgid "when the implementation class comes from some preexisting library, or" +msgstr "" + +#. Tag: para +#: xml.xml:15 +#, no-c-format +msgid "" +"when there should be multiple Web Beans with the same implementation class." +msgstr "" + +#. Tag: para +#: xml.xml:20 +#, no-c-format +msgid "In either of these cases, Web Beans gives us two options:" +msgstr "" + +#. Tag: para +#: xml.xml:23 +#, no-c-format +msgid "write a producer method, or" +msgstr "" + +#. Tag: para +#: xml.xml:24 +#, no-c-format +msgid "declare the Web Bean using XML." +msgstr "" + +#. Tag: para +#: xml.xml:27 +#, no-c-format +msgid "" +"Many frameworks use XML to provide metadata relating to Java classes. " +"However, Web Beans uses a very different approach to specifying the names of " +"Java classes, fields or methods to most other frameworks. Instead of writing " +"class and member names as the string values of XML elements and attributes, " +"Web Beans lets you use the class or member name as the name of the XML " +"element." +msgstr "" + +#. Tag: para +#: xml.xml:33 +#, no-c-format +msgid "" +"The advantage of this approach is that you can write an XML schema that " +"prevents spelling errors in your XML document. It's even possible for a tool " +"to generate the XML schema automatically from the compiled Java code. Or, an " +"integrated development environment could perform the same validation without " +"the need for the explicit intermediate generation step." +msgstr "" + +#. Tag: title +#: xml.xml:40 +#, no-c-format +msgid "Declaring Web Bean classes" +msgstr "" + +#. Tag: para +#: xml.xml:42 +#, no-c-format +msgid "" +"For each Java package, Web Beans defines a corresponding XML namespace. The " +"namespace is formed by prepending <literal>urn:java:</literal> to the Java " +"package name. For the package <literal>com.mydomain.myapp</literal>, the XML " +"namespace is <literal>urn:java:com.mydomain.myapp</literal>." +msgstr "" + +#. Tag: para +#: xml.xml:47 +#, no-c-format +msgid "" +"Java types belonging to a package are referred to using an XML element in " +"the namespace corresponding to the package. The name of the element is the " +"name of the Java type. Fields and methods of the type are specified by child " +"elements in the same namespace. If the type is an annotation, members are " +"specified by attributes of the element." +msgstr "" + +#. Tag: para +#: xml.xml:53 +#, no-c-format +msgid "" +"For example, the element <literal><util:Date/></literal> in the " +"following XML fragment refers to the class <literal>java.util.Date</literal>:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:56 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans xmlns=\"urn:java:javax.webbeans\"\n" +" xmlns:util=\"urn:java:java.util\">\n" +"\n" +" <util:Date/>\n" +"\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:58 +#, no-c-format +msgid "" +"And this is all the code we need to declare that <literal>Date</literal> is " +"a simple Web Bean! An instance of <literal>Date</literal> may now be " +"injected by any other Web Bean:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:62 +#, no-c-format +msgid "<![CDATA[@Current Date date]]>" +msgstr "" + +#. Tag: title +#: xml.xml:67 +#, no-c-format +msgid "Declaring Web Bean metadata" +msgstr "" + +#. Tag: para +#: xml.xml:69 +#, no-c-format +msgid "" +"We can declare the scope, deployment type and interceptor binding types " +"using direct child elements of the Web Bean declaration:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:72 +#, no-c-format +msgid "" +"<![CDATA[<myapp:ShoppingCart>\n" +" <SessionScoped/>\n" +" <myfwk:Transactional requiresNew=\"true\"/>\n" +" <myfwk:Secure/>\n" +"</myapp:ShoppingCart>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:74 +#, no-c-format +msgid "We use exactly the same approach to specify names and binding type:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:76 +#, no-c-format +msgid "" +"<![CDATA[<util:Date>\n" +" <Named>currentTime</Named>\n" +"</util:Date>\n" +"\n" +"<util:Date>\n" +" <SessionScoped/>\n" +" <myapp:Login/>\n" +" <Named>loginTime</Named>\n" +"</util:Date>\n" +"\n" +"<util:Date>\n" +" <ApplicationScoped/>\n" +" <myapp:SystemStart/>\n" +" <Named>systemStartTime</Named>\n" +"</util:Date>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:78 +#, no-c-format +msgid "" +"Where <literal>@Login</literal> and <literal>@SystemStart</literal> are " +"binding annotations types." +msgstr "" + +#. Tag: programlisting +#: xml.xml:81 +#, no-c-format +msgid "" +"<![CDATA[@Current Date currentTime;\n" +"@Login Date loginTime;\n" +"@SystemStart Date systemStartTime;]]>" +msgstr "" + +#. Tag: para +#: xml.xml:83 +#, no-c-format +msgid "As usual, a Web Bean may support multiple binding types:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:85 +#, no-c-format +msgid "" +"<![CDATA[<myapp:AsynchronousChequePaymentProcessor>\n" +" <myapp:PayByCheque/>\n" +" <myapp:Asynchronous/>\n" +"</myapp:AsynchronousChequePaymentProcessor>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:87 +#, no-c-format +msgid "" +"Interceptors and decorators are just simple Web Beans, so they may be " +"declared just like any other simple Web Bean:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:90 +#, no-c-format +msgid "" +"<![CDATA[<myfwk:TransactionInterceptor>\n" +" <Interceptor/>\n" +" <myfwk:Transactional/>\n" +"</myfwk:TransactionInterceptor>]]>" +msgstr "" + +#. Tag: title +#: xml.xml:95 +#, no-c-format +msgid "Declaring Web Bean members" +msgstr "" + +#. Tag: para +#: xml.xml:97 +#, no-c-format +msgid "TODO!" +msgstr "" + +#. Tag: title +#: xml.xml:104 +#, no-c-format +msgid "Declaring inline Web Beans" +msgstr "" + +#. Tag: para +#: xml.xml:106 +#, no-c-format +msgid "Web Beans lets us define a Web Bean at an injection point. For example:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:108 +#, no-c-format +msgid "" +"<![CDATA[<myapp:System>\n" +" <ApplicationScoped/>\n" +" <myapp:admin>\n" +" <myapp:Name>\n" +" <myapp:firstname>Gavin</myapp:firstname>\n" +" <myapp:lastname>King</myapp:lastname>\n" +" <myapp:email>gavin(a)hibernate.org</myapp:email>\n" +" </myapp:Name>\n" +" </myapp:admin>\n" +"</myapp:System>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:110 +#, no-c-format +msgid "" +"The <literal><Name></literal> element declares a simple Web Bean of " +"scope <literal>@Dependent</literal> and class <literal>Name</literal>, with " +"a set of initial field values. This Web Bean has a special, container-" +"generated binding and is therefore injectable only to the specific injection " +"point at which it is declared." +msgstr "" + +#. Tag: para +#: xml.xml:116 +#, no-c-format +msgid "" +"This simple but powerful feature allows the Web Beans XML format to be used " +"to specify whole graphs of Java objects. It's not quite a full databinding " +"solution, but it's close!" +msgstr "" + +#. Tag: title +#: xml.xml:123 +#, no-c-format +msgid "Using a schema" +msgstr "" + +#. Tag: para +#: xml.xml:125 +#, no-c-format +msgid "" +"If we want our XML document format to be authored by people who aren't Java " +"developers, or who don't have access to our code, we need to provide a " +"schema. There's nothing specific to Web Beans about writing or using the " +"schema." +msgstr "" + +#. Tag: programlisting +#: xml.xml:130 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans xmlns=\"urn:java:javax.webbeans\"\n" +" xmlns:myapp=\"urn:java:com.mydomain.myapp\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"urn:java:javax.webbeans http://java.sun.com/" +"jee/web-beans-1.0.xsd\n" +" urn:java:com.mydomain.myapp http://mydomain." +"com/xsd/myapp-1.2.xsd\">\n" +"\n" +" <myapp:System>\n" +" ...\n" +" </myapp:System>\n" +"\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:132 +#, no-c-format +msgid "" +"Writing an XML schema is quite tedious. Therefore, the Web Beans RI project " +"will provide a tool which automatically generates the XML schema from " +"compiled Java code." +msgstr "" Added: doc/trunk/reference/pot/Book_Info.pot =================================================================== --- doc/trunk/reference/pot/Book_Info.pot (rev 0) +++ doc/trunk/reference/pot/Book_Info.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,57 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: Book_Info.xml:6 +#, no-c-format +msgid "Introduction to Web Beans" +msgstr "" + +#. Tag: subtitle +#: Book_Info.xml:7 +#, no-c-format +msgid "" +"The new Java standard for dependency injection and contextual state " +"management" +msgstr "" + +#. Tag: author +#: Book_Info.xml:10 +#, no-c-format +msgid "<firstname>Gavin</firstname> <surname>King</surname>" +msgstr "" + +#. Tag: affiliation +#: Book_Info.xml:13 +#, no-c-format +msgid "" +"<jobtitle>Web Beans (JSR-299) specification lead</jobtitle> <orgname>Red Hat " +"Middleware LLC</orgname>" +msgstr "" + +#. Tag: author +#: Book_Info.xml:19 +#, no-c-format +msgid "<firstname>Pete</firstname> <surname>Muir</surname>" +msgstr "" + +#. Tag: affiliation +#: Book_Info.xml:22 +#, no-c-format +msgid "" +"<jobtitle>Web Beans (JSR-299) Reference Implementation lead</jobtitle> " +"<orgname>Red Hat Middleware LLC</orgname>" +msgstr "" Added: doc/trunk/reference/pot/master.pot =================================================================== --- doc/trunk/reference/pot/master.pot (rev 0) +++ doc/trunk/reference/pot/master.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,39 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: master.xml:12 +#, no-c-format +msgid "Using contextual objects" +msgstr "" + +#. Tag: title +#: master.xml:25 +#, no-c-format +msgid "Developing loosely-coupled code" +msgstr "" + +#. Tag: title +#: master.xml:35 +#, no-c-format +msgid "Making the most of strong typing" +msgstr "" + +#. Tag: title +#: master.xml:46 +#, no-c-format +msgid "Web Beans and the Java EE ecosystem" +msgstr "" Added: doc/trunk/reference/pot/messages.mo =================================================================== (Binary files differ) Property changes on: doc/trunk/reference/pot/messages.mo ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: doc/trunk/reference/pot/modules/decorators.pot =================================================================== --- doc/trunk/reference/pot/modules/decorators.pot (rev 0) +++ doc/trunk/reference/pot/modules/decorators.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,244 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: decorators.xml:4 +#, no-c-format +msgid "Decorators" +msgstr "" + +#. Tag: para +#: decorators.xml:6 +#, no-c-format +msgid "" +"Interceptors are a powerful way to capture and separate concerns which are " +"<emphasis>orthogonal</emphasis> to the type system. Any interceptor is able " +"to intercept invocations of any Java type. This makes them perfect for " +"solving technical concerns such as transaction management and security. " +"However, by nature, interceptors are unaware of the actual semantics of the " +"events they intercept. Thus, interceptors aren't an appropriate tool for " +"separating business-related concerns." +msgstr "" + +#. Tag: para +#: decorators.xml:14 +#, no-c-format +msgid "" +"The reverse is true of <emphasis>decorators</emphasis>. A decorator " +"intercepts invocations only for a certain Java interface, and is therefore " +"aware of all the semantics attached to that interface. This makes decorators " +"a perfect tool for modeling some kinds of business concerns. It also means " +"that a decorator doesn't have the generality of an interceptor. Decorators " +"aren't able to solve technical concerns that cut across many disparate types." +msgstr "" + +#. Tag: para +#: decorators.xml:22 +#, no-c-format +msgid "Suppose we have an interface that represents accounts:" +msgstr "" + +#. Tag: programlisting +#: decorators.xml:24 +#, no-c-format +msgid "" +"<![CDATA[public interface Account {\n" +" public BigDecimal getBalance();\n" +" public User getOwner();\n" +" public void withdraw(BigDecimal amount);\n" +" public void deposit(BigDecimal amount);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:26 +#, no-c-format +msgid "" +"Several different Web Beans in our system implement the <literal>Account</" +"literal> interface. However, we have a common legal requirement that, for " +"any kind of account, large transactions must be recorded by the system in a " +"special log. This is a perfect job for a decorator." +msgstr "" + +#. Tag: para +#: decorators.xml:32 +#, no-c-format +msgid "" +"A decorator is a simple Web Bean that implements the type it decorates and " +"is annotated <literal>@Decorator</literal>." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:35 +#, no-c-format +msgid "" +"<![CDATA[@Decorator\n" +"public abstract class LargeTransactionDecorator \n" +" implements Account {\n" +" \n" +" @Decorates Account account;\n" +" \n" +" @PersistenceContext EntityManager em;\n" +" \n" +" public void withdraw(BigDecimal amount) {\n" +" account.withdraw(amount);\n" +" if ( amount.compareTo(LARGE_AMOUNT)>0 ) {\n" +" em.persist( new LoggedWithdrawl(amount) );\n" +" }\n" +" }\n" +" \n" +" public void deposit(BigDecimal amount);\n" +" account.deposit(amount);\n" +" if ( amount.compareTo(LARGE_AMOUNT)>0 ) {\n" +" em.persist( new LoggedDeposit(amount) );\n" +" }\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:37 +#, no-c-format +msgid "" +"Unlike other simple Web Beans, a decorator may be an abstract class. If " +"there's nothing special the decorator needs to do for a particular method of " +"the decorated interface, you don't need to implement that method." +msgstr "" + +#. Tag: title +#: decorators.xml:43 +#, no-c-format +msgid "Delegate attributes" +msgstr "" + +#. Tag: para +#: decorators.xml:45 +#, no-c-format +msgid "" +"All decorators have a <emphasis>delegate attribute</emphasis>. The type and " +"binding types of the delegate attribute determine which Web Beans the " +"decorator is bound to. The delegate attribute type must implement or extend " +"all interfaces implemented by the decorator." +msgstr "" + +#. Tag: para +#: decorators.xml:50 +#, no-c-format +msgid "" +"This delegate attribute specifies that the decorator is bound to all Web " +"Beans that implement <literal>Account</literal>:" +msgstr "" + +#. Tag: programlisting +#: decorators.xml:53 +#, no-c-format +msgid "<![CDATA[@Decorates Account account;]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:55 +#, no-c-format +msgid "" +"A delegate attribute may specify a binding annotation. Then the decorator " +"will only be bound to Web Beans with the same binding." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:58 +#, no-c-format +msgid "<![CDATA[@Decorates @Foreign Account account;]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:60 +#, no-c-format +msgid "A decorator is bound to any Web Bean which:" +msgstr "" + +#. Tag: para +#: decorators.xml:64 +#, no-c-format +msgid "has the type of the delegate attribute as an API type, and" +msgstr "" + +#. Tag: para +#: decorators.xml:67 +#, no-c-format +msgid "has all binding types that are declared by the delegate attribute." +msgstr "" + +#. Tag: para +#: decorators.xml:71 +#, no-c-format +msgid "" +"The decorator may invoke the delegate attribute, which has much the same " +"effect as calling <literal>InvocationContext.proceed()</literal> from an " +"interceptor." +msgstr "" + +#. Tag: title +#: decorators.xml:78 +#, no-c-format +msgid "Enabling decorators" +msgstr "" + +#. Tag: para +#: decorators.xml:80 +#, no-c-format +msgid "" +"We need to <emphasis>enable</emphasis> our decorator in <literal>web-beans." +"xml</literal>." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:83 +#, no-c-format +msgid "" +"<![CDATA[<Decorators>\n" +" <myapp:LargeTransactionDecorator/>\n" +"</Decorators>]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:85 +#, no-c-format +msgid "" +"This declaration serves the same purpose for decorators that the " +"<literal><Interceptors></literal> declaration serves for interceptors:" +msgstr "" + +#. Tag: para +#: decorators.xml:90 +#, no-c-format +msgid "" +"it enables us to specify a total ordering for all decorators in our system, " +"ensuring deterministic behavior, and" +msgstr "" + +#. Tag: para +#: decorators.xml:94 +#, no-c-format +msgid "it lets us enable or disable decorator classes at deployment time." +msgstr "" + +#. Tag: para +#: decorators.xml:98 +#, no-c-format +msgid "" +"Interceptors for a method are called before decorators that apply to that " +"method." +msgstr "" Added: doc/trunk/reference/pot/modules/ee.pot =================================================================== --- doc/trunk/reference/pot/modules/ee.pot (rev 0) +++ doc/trunk/reference/pot/modules/ee.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,330 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: ee.xml:4 +#, no-c-format +msgid "Java EE integration" +msgstr "" + +#. Tag: para +#: ee.xml:6 +#, no-c-format +msgid "" +"Web Beans is fully integrated into the Java EE environment. Web Beans have " +"access to Java EE resources and JPA persistence contexts. They may be used " +"in Unified EL expressions in JSF and JSP pages. They may even be injected " +"into some objects, such as Servlets and Message-Driven Beans, which are not " +"Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:12 +#, no-c-format +msgid "Injecting Java EE resources into a Web Bean" +msgstr "" + +#. Tag: para +#: ee.xml:14 +#, no-c-format +msgid "" +"All simple and enterprise Web Beans may take advantage of Java EE dependency " +"injection using <literal>@Resource</literal>, <literal>@EJB</literal> and " +"<literal>@PersistenceContext</literal>. We've already seen a couple of " +"examples of this, though we didn't pay much attention at the time:" +msgstr "" + +#. Tag: programlisting +#: ee.xml:19 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +"\n" +" @Resource Transaction transaction;\n" +"\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: ee.xml:21 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped\n" +"public class Login {\n" +"\n" +" @Current Credentials credentials;\n" +" @PersistenceContext EntityManager userDatabase;\n" +" \n" +" ...\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: ee.xml:23 +#, no-c-format +msgid "" +"The Java EE <literal>@PostConstruct</literal> and <literal>@PreDestroy</" +"literal> callbacks are also supported for all simple and enterprise Web " +"Beans. The <literal>@PostConstruct</literal> method is called after " +"<emphasis>all</emphasis> injection has been performed." +msgstr "" + +#. Tag: para +#: ee.xml:28 +#, no-c-format +msgid "" +"There is one restriction to be aware of here: <literal>@PersistenceContext" +"(type=EXTENDED)</literal> is not supported for simple Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:35 +#, no-c-format +msgid "Calling a Web Bean from a Servlet" +msgstr "" + +#. Tag: para +#: ee.xml:37 +#, no-c-format +msgid "" +"It's easy to use a Web Bean from a Servlet in Java EE 6. Simply inject the " +"Web Bean using Web Beans field or initializer method injection." +msgstr "" + +#. Tag: programlisting +#: ee.xml:40 +#, no-c-format +msgid "" +"public class Login extends HttpServlet {\n" +"\n" +" @Current Credentials credentials;\n" +" @Current Login login;\n" +"\n" +" @Override\n" +" public void service(HttpServletRequest request, HttpServletResponse " +"response)\n" +" throws ServletException, IOException {\n" +" credentials.setUsername( request.getAttribute(\"username\") ):\n" +" credentials.setPassword( request.getAttribute(\"password\") ):\n" +" login.login();\n" +" if ( login.isLoggedIn() ) {\n" +" response.sendRedirect(\"/home.jsp\");\n" +" }\n" +" else {\n" +" response.sendRedirect(\"/loginError.jsp\");\n" +" }\n" +" }\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:42 +#, no-c-format +msgid "" +"The Web Beans client proxy takes care of routing method invocations from the " +"Servlet to the correct instances of <literal>Credentials</literal> and " +"<literal>Login</literal> for the current request and HTTP session." +msgstr "" + +#. Tag: title +#: ee.xml:49 +#, no-c-format +msgid "Calling a Web Bean from a Message-Driven Bean" +msgstr "" + +#. Tag: para +#: ee.xml:51 +#, no-c-format +msgid "" +"Web Beans injection applies to all EJBs, even when they aren't under the " +"control of the Web Bean manager (if they were obtained by direct JNDI " +"lookup, or injection using <literal>@EJB</literal>, for example. In " +"particular, you can use Web Beans injection in Message-Driven Beans, which " +"are not considered Web Beans because you can't inject them." +msgstr "" + +#. Tag: para +#: ee.xml:57 +#, no-c-format +msgid "" +"You can even use Web Beans interceptor bindings for Message-Driven Beans." +msgstr "" + +#. Tag: programlisting +#: ee.xml:59 +#, no-c-format +msgid "" +"@Transactional @MessageDriven\n" +"public class ProcessOrder implements MessageListener {\n" +"\n" +" @Current Inventory inventory;\n" +" @PersistenceContext EntityManager em;\n" +"\n" +" public void onMessage(Message message) {\n" +" ...\n" +" }\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:61 +#, no-c-format +msgid "" +"Thus, receiving messages is super-easy in a Web Beans environment. But " +"beware that there is no session or conversation context available when a " +"message is delivered to a Message-Driven Bean. Only <literal>@RequestScoped</" +"literal> and <literal>@ApplicationScoped</literal> Web Beans are available." +msgstr "" + +#. Tag: para +#: ee.xml:66 +#, no-c-format +msgid "It's also easy to send messages using Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:71 +#, no-c-format +msgid "JMS endpoints" +msgstr "" + +#. Tag: para +#: ee.xml:73 +#, no-c-format +msgid "" +"Sending messages using JMS can be quite complex, because of the number of " +"different objects you need to deal with. For queues we have <literal>Queue</" +"literal>, <literal>QueueConnectionFactory</literal>, " +"<literal>QueueConnection</literal>, <literal>QueueSession</literal> and " +"<literal>QueueSender</literal>. For topics we have <literal>Topic</literal>, " +"<literal>TopicConnectionFactory</literal>, <literal>TopicConnection</" +"literal>, <literal>TopicSession</literal> and <literal>TopicPublisher</" +"literal>. Each of these objects has its own lifecycle and threading model " +"that we need to worry about." +msgstr "" + +#. Tag: para +#: ee.xml:82 +#, no-c-format +msgid "" +"Web Beans takes care of all this for us. All we need to do is declare the " +"queue or topic in <literal>web-beans.xml</literal>, specifying an associated " +"binding type and connection factory." +msgstr "" + +#. Tag: programlisting +#: ee.xml:86 +#, no-c-format +msgid "" +"<![CDATA[<Queue>\n" +" <destination>java:comp/env/jms/OrderQueue</destination>\n" +" <connectionFactory>java:comp/env/jms/QueueConnectionFactory</" +"connectionFactory>\n" +" <myapp:OrderProcessor/> \n" +"</Queue>]]>" +msgstr "" + +#. Tag: programlisting +#: ee.xml:88 +#, no-c-format +msgid "" +"<![CDATA[<Topic>\n" +" <destination>java:comp/env/jms/StockPrices</destination>\n" +" <connectionFactory>java:comp/env/jms/TopicConnectionFactory</" +"connectionFactory>\n" +" <myapp:StockPrices/> \n" +"</Topic>]]>" +msgstr "" + +#. Tag: para +#: ee.xml:90 +#, no-c-format +msgid "" +"Now we can just inject the <literal>Queue</literal>, " +"<literal>QueueConnection</literal>, <literal>QueueSession</literal> or " +"<literal>QueueSender</literal> for a queue, or the <literal>Topic</literal>, " +"<literal>TopicConnection</literal>, <literal>TopicSession</literal> or " +"<literal>TopicPublisher</literal> for a topic." +msgstr "" + +#. Tag: programlisting +#: ee.xml:96 +#, no-c-format +msgid "" +"@OrderProcessor QueueSender orderSender;\n" +"@OrderProcessor QueueSession orderSession;\n" +"\n" +"public void sendMessage() {\n" +" MapMessage msg = orderSession.createMapMessage();\n" +" ...\n" +" orderSender.send(msg);\n" +"}" +msgstr "" + +#. Tag: programlisting +#: ee.xml:98 +#, no-c-format +msgid "" +"@StockPrices TopicPublisher pricePublisher;\n" +"@StockPrices TopicSession priceSession;\n" +"\n" +"public void sendMessage(String price) {\n" +" pricePublisher.send( priceSession.createTextMessage(price) );\n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:100 +#, no-c-format +msgid "" +"The lifecycle of the injected JMS objects are completely controlled by the " +"Web Bean manager." +msgstr "" + +#. Tag: title +#: ee.xml:106 +#, no-c-format +msgid "Packaging and deployment" +msgstr "" + +#. Tag: para +#: ee.xml:108 +#, no-c-format +msgid "" +"Web Beans doesn't define any special deployment archive. You can package Web " +"Beans in JARs, EJB-JARs or WARsany deployment location in the " +"application classpath. However, each archive that contains Web Beans must " +"include a file named <literal>web-beans.xml</literal> in the <literal>META-" +"INF</literal> or <literal>WEB-INF</literal> directory. The file may be " +"empty. Web Beans deployed in archives that do not have a <literal>web-beans." +"xml</literal> file will not be available for use in the application." +msgstr "" + +#. Tag: para +#: ee.xml:116 +#, no-c-format +msgid "" +"For Java SE execution, Web Beans may be deployed in any location in which " +"EJBs may be deployed for execution by the embeddable EJB Lite container. " +"Again, each location must contain a <literal>web-beans.xml</literal> file." +msgstr "" Added: doc/trunk/reference/pot/modules/events.pot =================================================================== --- doc/trunk/reference/pot/modules/events.pot (rev 0) +++ doc/trunk/reference/pot/modules/events.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,650 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: events.xml:4 +#, no-c-format +msgid "Events" +msgstr "" + +#. Tag: para +#: events.xml:6 +#, no-c-format +msgid "" +"The Web Beans event notification facility allows Web Beans to interact in a " +"totally decoupled manner. Event <emphasis>producers</emphasis> raise events " +"that are then delivered to event <emphasis>observers</emphasis> by the Web " +"Bean manager. This basic schema might sound like the familiar observer/" +"observable pattern, but there are a couple of twists:" +msgstr "" + +#. Tag: para +#: events.xml:14 +#, no-c-format +msgid "" +"not only are event producers decoupled from observers; observers are " +"completely decoupled from producers," +msgstr "" + +#. Tag: para +#: events.xml:18 +#, no-c-format +msgid "" +"observers can specify a combination of \"selectors\" to narrow the set of " +"event notifications they will receive, and" +msgstr "" + +#. Tag: para +#: events.xml:22 +#, no-c-format +msgid "" +"observers can be notified immediately, or can specify that delivery of the " +"event should be delayed until the end of the current transaction" +msgstr "" + +#. Tag: title +#: events.xml:28 +#, no-c-format +msgid "Event observers" +msgstr "" + +#. Tag: para +#: events.xml:30 +#, no-c-format +msgid "" +"An <emphasis>observer method</emphasis> is a method of a Web Bean with a " +"parameter annotated <literal>@Observes</literal>." +msgstr "" + +#. Tag: programlisting +#: events.xml:33 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyDocumentEvent(@Observes Document document) " +"{ ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:35 +#, no-c-format +msgid "" +"The annotated parameter is called the <emphasis>event parameter</emphasis>. " +"The type of the event parameter is the observed <emphasis>event type</" +"emphasis>. Observer methods may also specify \"selectors\", which are just " +"instances of Web Beans binding types. When a binding type is used as an " +"event selector, it is called an <emphasis>event binding type</emphasis>." +msgstr "" + +#. Tag: programlisting +#: events.xml:41 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Target({PARAMETER, FIELD})\n" +"@Retention(RUNTIME)\n" +"public @interface Updated { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:43 +#, no-c-format +msgid "" +"We specify the event bindings of the observer method by annotating the event " +"parameter:" +msgstr "" + +#. Tag: programlisting +#: events.xml:46 events.xml:190 +#, no-c-format +msgid "" +"<![CDATA[public void afterDocumentUpdate(@Observes @Updated Document " +"document) { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:48 +#, no-c-format +msgid "" +"An observer method need not specify any event bindingsin this case it " +"is interested in <emphasis>all</emphasis> events of a particular type. If it " +"does specify event bindings, it is only interested in events which also have " +"those event bindings." +msgstr "" + +#. Tag: para +#: events.xml:53 +#, no-c-format +msgid "" +"The observer method may have additional parameters, which are injected " +"according to the usual Web Beans method parameter injection semantics:" +msgstr "" + +#. Tag: programlisting +#: events.xml:56 +#, no-c-format +msgid "" +"<![CDATA[public void afterDocumentUpdate(@Observes @Updated Document " +"document, User user) { ... }]]>" +msgstr "" + +#. Tag: title +#: events.xml:61 +#, no-c-format +msgid "Event producers" +msgstr "" + +#. Tag: para +#: events.xml:63 +#, no-c-format +msgid "" +"The event producer may obtain an <emphasis>event notifier</emphasis> object " +"by injection:" +msgstr "" + +#. Tag: programlisting +#: events.xml:66 +#, no-c-format +msgid "<![CDATA[@Observable Event<Document> documentEvent]]>" +msgstr "" + +#. Tag: para +#: events.xml:68 +#, no-c-format +msgid "" +"The <literal>@Observable</literal> annotation implicitly defines a Web Bean " +"with scope <literal>@Dependent</literal> and deployment type " +"<literal>@Standard</literal>, with an implementation provided by the Web " +"Bean manager." +msgstr "" + +#. Tag: para +#: events.xml:72 +#, no-c-format +msgid "" +"A producer raises events by calling the <literal>fire()</literal> method of " +"the <literal>Event</literal> interface, passing an <emphasis>event object</" +"emphasis>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:75 +#, no-c-format +msgid "<![CDATA[documentEvent.fire(document);]]>" +msgstr "" + +#. Tag: para +#: events.xml:77 +#, no-c-format +msgid "" +"An event object may be an instance of any Java class that has no type " +"variables or wildcard type parameters. The event will be delivered to every " +"observer method that:" +msgstr "" + +#. Tag: para +#: events.xml:83 events.xml:107 events.xml:126 +#, no-c-format +msgid "has an event parameter to which the event object is assignable, and" +msgstr "" + +#. Tag: para +#: events.xml:86 +#, no-c-format +msgid "specifies no event bindings." +msgstr "" + +#. Tag: para +#: events.xml:90 +#, no-c-format +msgid "" +"The Web Bean manager simply calls all the observer methods, passing the " +"event object as the value of the event parameter. If any observer method " +"throws an exception, the Web Bean manager stops calling observer methods, " +"and the exception is rethrown by the <literal>fire()</literal> method." +msgstr "" + +#. Tag: para +#: events.xml:95 +#, no-c-format +msgid "" +"To specify a \"selector\", the event producer may pass an instance of the " +"event binding type to the <literal>fire()</literal> method:" +msgstr "" + +#. Tag: programlisting +#: events.xml:98 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.fire( document, new AnnotationLiteral<Updated>()" +"{} );]]>" +msgstr "" + +#. Tag: para +#: events.xml:100 +#, no-c-format +msgid "" +"The helper class <literal>AnnotationLiteral</literal> makes it possible to " +"instantiate binding types inline, since this is otherwise difficult to do in " +"Java." +msgstr "" + +#. Tag: para +#: events.xml:103 +#, no-c-format +msgid "The event will be delivered to every observer method that:" +msgstr "" + +#. Tag: para +#: events.xml:110 +#, no-c-format +msgid "" +"does not specify any event binding <emphasis>except</emphasis> for the event " +"bindings passed to <literal>fire()</literal>." +msgstr "" + +#. Tag: para +#: events.xml:115 +#, no-c-format +msgid "" +"Alternatively, event bindings may be specified by annotating the event " +"notifier injection point:" +msgstr "" + +#. Tag: programlisting +#: events.xml:118 +#, no-c-format +msgid "<![CDATA[@Observable @Updated Event<Document> documentUpdatedEvent]]>" +msgstr "" + +#. Tag: para +#: events.xml:120 +#, no-c-format +msgid "" +"Then every event fired via this instance of <literal>Event</literal> has the " +"annotated event binding. The event will be delivered to every observer " +"method that:" +msgstr "" + +#. Tag: para +#: events.xml:129 +#, no-c-format +msgid "" +"does not specify any event binding <emphasis>except</emphasis> for the event " +"bindings passed to <literal>fire()</literal> or the annotated event bindings " +"of the event notifier injection point." +msgstr "" + +#. Tag: title +#: events.xml:138 +#, no-c-format +msgid "Registering observers dynamically" +msgstr "" + +#. Tag: para +#: events.xml:140 +#, no-c-format +msgid "" +"It's often useful to register an event observer dynamically. The application " +"may implement the <literal>Observer</literal> interface and register an " +"instance with an event notifier by calling the <literal>observe()</literal> " +"method." +msgstr "" + +#. Tag: programlisting +#: events.xml:144 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.observe( new Observer<Document>() { public void notify" +"(Document doc) { ... } } );]]>" +msgstr "" + +#. Tag: para +#: events.xml:146 +#, no-c-format +msgid "" +"Event binding types may be specified by the event notifier injection point " +"or by passing event binding type instances to the <literal>observe()</" +"literal> method:" +msgstr "" + +#. Tag: programlisting +#: events.xml:149 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.observe( new Observer<Document>() { public void notify" +"(Document doc) { ... } }, \n" +" new " +"AnnotationLiteral<Updated>(){} );]]>" +msgstr "" + +#. Tag: title +#: events.xml:154 +#, no-c-format +msgid "Event bindings with members" +msgstr "" + +#. Tag: para +#: events.xml:156 +#, no-c-format +msgid "An event binding type may have annotation members:" +msgstr "" + +#. Tag: programlisting +#: events.xml:158 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Target({PARAMETER, FIELD})\n" +"@Retention(RUNTIME)\n" +"public @interface Role {\n" +" RoleType value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:160 +#, no-c-format +msgid "" +"The member value is used to narrow the messages delivered to the observer:" +msgstr "" + +#. Tag: programlisting +#: events.xml:162 +#, no-c-format +msgid "" +"<![CDATA[public void adminLoggedIn(@Observes @Role(ADMIN) LoggedIn event) " +"{ ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:164 +#, no-c-format +msgid "" +"Event binding type members may be specified statically by the event " +"producer, via annotations at the event notifier injection point:" +msgstr "" + +#. Tag: programlisting +#: events.xml:167 +#, no-c-format +msgid "<![CDATA[@Observable @Role(ADMIN) Event<LoggedIn> LoggedInEvent;}}]]>" +msgstr "" + +#. Tag: para +#: events.xml:169 +#, no-c-format +msgid "" +"Alternatively, the value of the event binding type member may be determined " +"dynamically by the event producer. We start by writing an abstract subclass " +"of <literal>AnnotationLiteral</literal>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:172 +#, no-c-format +msgid "" +"<![CDATA[abstract class RoleBinding \n" +" extends AnnotationLiteral<Role> \n" +" implements Role {}]]>" +msgstr "" + +#. Tag: para +#: events.xml:174 +#, no-c-format +msgid "" +"The event producer passes an instance of this class to <literal>fire()</" +"literal>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:176 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.fire( document, new RoleBinding() { public void value" +"() { return user.getRole(); } } );]]>" +msgstr "" + +#. Tag: title +#: events.xml:181 +#, no-c-format +msgid "Multiple event bindings" +msgstr "" + +#. Tag: para +#: events.xml:183 +#, no-c-format +msgid "Event binding types may be combined, for example:" +msgstr "" + +#. Tag: programlisting +#: events.xml:185 +#, no-c-format +msgid "" +"<![CDATA[@Observable @Blog Event<Document> blogEvent;\n" +"...\n" +"if (document.isBlog()) blogEvent.fire(document, new " +"AnnotationLiteral<Updated>(){});]]>" +msgstr "" + +#. Tag: para +#: events.xml:187 +#, no-c-format +msgid "" +"When this event occurs, all of the following observer methods will be " +"notified:" +msgstr "" + +#. Tag: programlisting +#: events.xml:189 +#, no-c-format +msgid "" +"<![CDATA[public void afterBlogUpdate(@Observes @Updated @Blog Document " +"document) { ... }]]>" +msgstr "" + +#. Tag: programlisting +#: events.xml:191 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyBlogEvent(@Observes @Blog Document document) " +"{ ... }]]>" +msgstr "" + +#. Tag: programlisting +#: events.xml:192 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyDocumentEvent(@Observes Document document) " +"{ ... }}}]]>" +msgstr "" + +#. Tag: title +#: events.xml:197 +#, no-c-format +msgid "Transactional observers" +msgstr "" + +#. Tag: para +#: events.xml:199 +#, no-c-format +msgid "" +"Transactional observers receive their event notifications during the before " +"or after completion phase of the transaction in which the event was raised. " +"For example, the following observer method needs to refresh a query result " +"set that is cached in the application context, but only when transactions " +"that update the <literal>Category</literal> tree succeed:" +msgstr "" + +#. Tag: programlisting +#: events.xml:205 +#, no-c-format +msgid "" +"<![CDATA[public void refreshCategoryTree(@AfterTransactionSuccess @Observes " +"CategoryUpdateEvent event) { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:207 +#, no-c-format +msgid "There are three kinds of transactional observers:" +msgstr "" + +#. Tag: para +#: events.xml:211 +#, no-c-format +msgid "" +"<literal>@AfterTransactionSuccess</literal> observers are called during the " +"after completion phase of the transaction, but only if the transaction " +"completes successfully" +msgstr "" + +#. Tag: para +#: events.xml:216 +#, no-c-format +msgid "" +"<literal>@AfterTransactionFailure</literal> observers are called during the " +"after completion phase of the transaction, but only if the transaction fails " +"to complete successfully" +msgstr "" + +#. Tag: para +#: events.xml:221 +#, no-c-format +msgid "" +"<literal>@AfterTransactionCompletion</literal> observers are called during " +"the after completion phase of the transaction" +msgstr "" + +#. Tag: para +#: events.xml:225 +#, no-c-format +msgid "" +"<literal>@BeforeTransactionCompletion</literal> observers are called during " +"the before completion phase of the transaction" +msgstr "" + +#. Tag: para +#: events.xml:230 +#, no-c-format +msgid "" +"Transactional observers are very important in a stateful object model like " +"Web Beans, because state is often held for longer than a single atomic " +"transaction." +msgstr "" + +#. Tag: para +#: events.xml:233 +#, no-c-format +msgid "" +"Imagine that we have cached a JPA query result set in the application scope:" +msgstr "" + +#. Tag: programlisting +#: events.xml:235 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Singleton\n" +"public class Catalog {\n" +"\n" +" @PersistenceContext EntityManager em;\n" +" \n" +" List<Product> products;\n" +"\n" +" @Produces @Catalog \n" +" List<Product> getCatalog() {\n" +" if (products==null) {\n" +" products = em.createQuery(\"select p from Product p where p." +"deleted = false\")\n" +" .getResultList();\n" +" }\n" +" return products;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:237 +#, no-c-format +msgid "" +"From time to time, a <literal>Product</literal> is created or deleted. When " +"this occurs, we need to refresh the <literal>Product</literal> catalog. But " +"we should wait until <emphasis>after</emphasis> the transaction completes " +"successfully before performing this refresh!" +msgstr "" + +#. Tag: para +#: events.xml:242 +#, no-c-format +msgid "" +"The Web Bean that creates and deletes <literal>Product</literal>s could " +"raise events, for example:" +msgstr "" + +#. Tag: programlisting +#: events.xml:245 +#, no-c-format +msgid "" +"<![CDATA[@Stateless\n" +"public class ProductManager {\n" +"\n" +" @PersistenceContext EntityManager em;\n" +" @Observable Event<Product> productEvent;\n" +"\n" +" public void delete(Product product) {\n" +" em.delete(product);\n" +" productEvent.fire(product, new AnnotationLiteral<Deleted>(){});\n" +" }\n" +" \n" +" public void persist(Product product) {\n" +" em.persist(product);\n" +" productEvent.fire(product, new AnnotationLiteral<Created>(){});\n" +" }\n" +" \n" +" ...\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:247 +#, no-c-format +msgid "" +"And now <literal>Catalog</literal> can observe the events after successful " +"completion of the transaction:" +msgstr "" + +#. Tag: programlisting +#: events.xml:250 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Singleton\n" +"public class Catalog {\n" +"\n" +" ...\n" +" \n" +" void addProduct(@AfterTransactionSuccess @Observes @Created Product " +"product) {\n" +" products.add(product);\n" +" }\n" +" \n" +" void addProduct(@AfterTransactionSuccess @Observes @Deleted Product " +"product) {\n" +" products.remove(product);\n" +" }\n" +" \n" +"}]]>" +msgstr "" Added: doc/trunk/reference/pot/modules/example.pot =================================================================== --- doc/trunk/reference/pot/modules/example.pot (rev 0) +++ doc/trunk/reference/pot/modules/example.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,173 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: example.xml:4 +#, no-c-format +msgid "JSF web application example" +msgstr "" + +#. Tag: para +#: example.xml:6 +#, no-c-format +msgid "" +"Let's illustrate these ideas with a full example. We're going to implement " +"user login/logout for an application that uses JSF. First, we'll define a " +"Web Bean to hold the username and password entered during login:" +msgstr "" + +#. Tag: programlisting +#: example.xml:11 +#, no-c-format +msgid "" +"<![CDATA[@Named\n" +"public class Credentials {\n" +" \n" +" private String username;\n" +" private String password;\n" +" \n" +" public String getUsername() { return username; }\n" +" public void setUsername(String username) { this.username = username; }\n" +" \n" +" public String getPassword() { return password; }\n" +" public void setPassword(String password) { this.password = password; }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:13 +#, no-c-format +msgid "This Web Bean is bound to the login prompt in the following JSF form:" +msgstr "" + +#. Tag: programlisting +#: example.xml:15 +#, no-c-format +msgid "" +"<![CDATA[<f:form>\n" +" <h:panelGrid columns=\"2\" rendered=\"#{!login.loggedIn}\">\n" +" <h:outputLabel for=\"username\">Username:</h:outputLabel>\n" +" <h:inputText id=\"username\" value=\"#{credentials.username}\"/>\n" +" <h:outputLabel for=\"password\">Password:</h:outputLabel>\n" +" <h:inputText id=\"password\" value=\"#{credentials.password}\"/>\n" +" </h:panelGrid>\n" +" <h:commandButton value=\"Login\" action=\"#{login.login}\" rendered=\"#{!" +"login.loggedIn}\"/>\n" +" <h:commandButton value=\"Logout\" acion=\"#{login.logout}\" rendered=\"#" +"{login.loggedIn}\"/>\n" +"</f:form]]>" +msgstr "" + +#. Tag: para +#: example.xml:17 +#, no-c-format +msgid "" +"The actual work is done by a session scoped Web Bean that maintains " +"information about the currently logged-in user and exposes the " +"<literal>User</literal> entity to other Web Beans:" +msgstr "" + +#. Tag: programlisting +#: example.xml:21 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named\n" +"public class Login {\n" +"\n" +" @Current Credentials credentials;\n" +" @PersistenceContext EntityManager userDatabase;\n" +"\n" +" private User user;\n" +" \n" +" public void login() {\n" +" \n" +" List<User> results = userDatabase.createQuery(\n" +" \"select u from User u where u.username=:username and u.password=:" +"password\")\n" +" .setParameter(\"username\", credentials.getUsername())\n" +" .setParameter(\"password\", credentials.getPassword())\n" +" .getResultList();\n" +" \n" +" if ( !results.isEmpty() ) {\n" +" user = results.get(0);\n" +" }\n" +" \n" +" }\n" +" \n" +" public void logout() {\n" +" user = null;\n" +" }\n" +" \n" +" public boolean isLoggedIn() {\n" +" return user!=null;\n" +" }\n" +" \n" +" @Produces @LoggedIn User getCurrentUser() {\n" +" return user;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:23 +#, no-c-format +msgid "Of course, <literal>@LoggedIn</literal> is a binding annotation:" +msgstr "" + +#. Tag: programlisting +#: example.xml:25 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD})\n" +"@BindingType\n" +"public @interface LoggedIn {}]]>" +msgstr "" + +#. Tag: para +#: example.xml:27 +#, no-c-format +msgid "Now, any other Web Bean can easily inject the current user:" +msgstr "" + +#. Tag: programlisting +#: example.xml:29 +#, no-c-format +msgid "" +"<![CDATA[public class DocumentEditor {\n" +"\n" +" @Current Document document;\n" +" @LoggedIn User currentUser;\n" +" @PersistenceContext EntityManager docDatabase;\n" +" \n" +" public void save() {\n" +" document.setCreatedBy(currentUser);\n" +" docDatabase.persist(document);\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:31 +#, no-c-format +msgid "" +"Hopefully, this example gives a flavor of the Web Bean programming model. In " +"the next chapter, we'll explore Web Beans dependency injection in greater " +"depth." +msgstr "" Added: doc/trunk/reference/pot/modules/extend.pot =================================================================== --- doc/trunk/reference/pot/modules/extend.pot (rev 0) +++ doc/trunk/reference/pot/modules/extend.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,253 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: extend.xml:4 +#, no-c-format +msgid "Extending Web Beans" +msgstr "" + +#. Tag: para +#: extend.xml:6 +#, no-c-format +msgid "" +"Web Beans is intended to be a platform for frameworks, extensions and " +"integration with other technologies. Therefore, Web Beans exposes a set of " +"SPIs for the use of developers of portable extensions to Web Beans. For " +"example, the following kinds of extensions were envisaged by the designers " +"of Web Beans:" +msgstr "" + +#. Tag: para +#: extend.xml:14 +#, no-c-format +msgid "integration with Business Process Management engines," +msgstr "" + +#. Tag: para +#: extend.xml:17 +#, no-c-format +msgid "" +"integration with third-party frameworks such as Spring, Seam, GWT or Wicket, " +"and" +msgstr "" + +#. Tag: para +#: extend.xml:21 +#, no-c-format +msgid "new technology based upon the Web Beans programming model." +msgstr "" + +#. Tag: para +#: extend.xml:25 +#, no-c-format +msgid "" +"The nerve center for extending Web Beans is the <literal>Manager</literal> " +"object." +msgstr "" + +#. Tag: title +#: extend.xml:29 +#, no-c-format +msgid "The <literal>Manager</literal> object" +msgstr "" + +#. Tag: para +#: extend.xml:31 +#, no-c-format +msgid "" +"The <literal>Manager</literal> interface lets us register and obtain Web " +"Beans, interceptors, decorators, observers and contexts programatically." +msgstr "" + +#. Tag: programlisting +#: extend.xml:34 +#, no-c-format +msgid "" +"<![CDATA[public interface Manager\n" +"{\n" +"\n" +" public <T> Set<Bean<T>> resolveByType(Class<T> type, Annotation... " +"bindings);\n" +"\n" +" public <T> Set<Bean<T>> resolveByType(TypeLiteral<T> apiType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> T getInstanceByType(Class<T> type, Annotation... bindings);\n" +"\n" +" public <T> T getInstanceByType(TypeLiteral<T> type,\n" +" Annotation... bindings);\n" +"\n" +" public Set<Bean<?>> resolveByName(String name);\n" +"\n" +" public Object getInstanceByName(String name);\n" +"\n" +" public <T> T getInstance(Bean<T> bean);\n" +"\n" +" public void fireEvent(Object event, Annotation... bindings);\n" +"\n" +" public Context getContext(Class<? extends Annotation> scopeType);\n" +"\n" +" public Manager addContext(Context context);\n" +"\n" +" public Manager addBean(Bean<?> bean);\n" +"\n" +" public Manager addInterceptor(Interceptor interceptor);\n" +"\n" +" public Manager addDecorator(Decorator decorator);\n" +"\n" +" public <T> Manager addObserver(Observer<T> observer, Class<T> eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager addObserver(Observer<T> observer, TypeLiteral<T> " +"eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager removeObserver(Observer<T> observer, Class<T> " +"eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager removeObserver(Observer<T> observer,\n" +" TypeLiteral<T> eventType, Annotation... bindings);\n" +"\n" +" public <T> Set<Observer<T>> resolveObservers(T event, Annotation... " +"bindings);\n" +"\n" +" public List<Interceptor> resolveInterceptors(InterceptionType type,\n" +" Annotation... interceptorBindings);\n" +"\n" +" public List<Decorator> resolveDecorators(Set<Class<?>> types,\n" +" Annotation... bindings);\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: extend.xml:36 +#, no-c-format +msgid "We can obtain an instance of <literal>Manager</literal> via injection:" +msgstr "" + +#. Tag: programlisting +#: extend.xml:38 +#, no-c-format +msgid "@Current Manager manager" +msgstr "" + +#. Tag: title +#: extend.xml:43 +#, no-c-format +msgid "The <literal>Bean</literal> class" +msgstr "" + +#. Tag: para +#: extend.xml:45 +#, no-c-format +msgid "" +"Instances of the abstract class <literal>Bean</literal> represent Web Beans. " +"There is an instance of <literal>Bean</literal> registered with the " +"<literal>Manager</literal> object for every Web Bean in the application." +msgstr "" + +#. Tag: programlisting +#: extend.xml:50 +#, no-c-format +msgid "" +"public abstract class Bean<T> {\n" +" \n" +" private final Manager manager;\n" +" \n" +" protected Bean(Manager manager) {\n" +" this.manager=manager;\n" +" }\n" +" \n" +" protected Manager getManager() {\n" +" return manager;\n" +" }\n" +" \n" +" public abstract Set<Class> getTypes();\n" +" public abstract Set<Annotation> getBindingTypes();\n" +" public abstract Class<? extends Annotation> getScopeType();\n" +" public abstract Class<? extends Annotation> getDeploymentType(); \n" +" public abstract String getName();\n" +" \n" +" public abstract boolean isSerializable();\n" +" public abstract boolean isNullable();\n" +"\n" +" public abstract T create();\n" +" public abstract void destroy(T instance);\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: extend.xml:52 +#, no-c-format +msgid "" +"It's possible to extend the <literal>Bean</literal> class and register " +"instances by calling <literal>Manager.addBean()</literal> to provide support " +"for new kinds of Web Beans, beyond those defined by the Web Beans " +"specification (simple and enterprise Web Beans, producer methods and JMS " +"endpoints). For example, we could use the <literal>Bean</literal> class to " +"allow objects managed by another framework to be injected into Web Beans." +msgstr "" + +#. Tag: para +#: extend.xml:60 +#, no-c-format +msgid "" +"There are two subclasses of <literal>Bean</literal> defined by the Web Beans " +"specification: <literal>Interceptor</literal> and <literal>Decorator</" +"literal>." +msgstr "" + +#. Tag: title +#: extend.xml:67 +#, no-c-format +msgid "The <literal>Context</literal> interface" +msgstr "" + +#. Tag: para +#: extend.xml:69 +#, no-c-format +msgid "" +"The <literal>Context</literal> interface supports addition of new scopes to " +"Web Beans, or extension of the built-in scopes to new environments." +msgstr "" + +#. Tag: programlisting +#: extend.xml:72 +#, no-c-format +msgid "" +"public interface Context {\n" +" \n" +" public Class<? extends Annotation> getScopeType();\n" +" \n" +" public <T> T get(Bean<T> bean, boolean create);\n" +" \n" +" boolean isActive();\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: extend.xml:74 +#, no-c-format +msgid "" +"For example, we might implement <literal>Context</literal> to add a business " +"process scope to Web Beans, or to add support for the conversation scope to " +"an application that uses Wicket." +msgstr "" Added: doc/trunk/reference/pot/modules/injection.pot =================================================================== --- doc/trunk/reference/pot/modules/injection.pot (rev 0) +++ doc/trunk/reference/pot/modules/injection.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,1227 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: injection.xml:4 +#, no-c-format +msgid "Dependency injection" +msgstr "" + +#. Tag: para +#: injection.xml:6 +#, no-c-format +msgid "Web Beans supports three primary mechanisms for dependency injection:" +msgstr "" + +#. Tag: para +#: injection.xml:8 +#, no-c-format +msgid "Constructor parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:10 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +" \n" +" private final ShoppingCart cart;\n" +" \n" +" @Initializer\n" +" public Checkout(ShoppingCart cart) {\n" +" this.cart = cart;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:12 +#, no-c-format +msgid "<emphasis>Initializer</emphasis> method parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:14 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +" \n" +" private ShoppingCart cart;\n" +"\n" +" @Initializer \n" +" void setShoppingCart(ShoppingCart cart) {\n" +" this.cart = cart;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:16 +#, no-c-format +msgid "And direct field injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:18 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +"\n" +" private @Current ShoppingCart cart;\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:20 +#, no-c-format +msgid "" +"Dependency injection always occurs when the Web Bean instance is first " +"instantiated." +msgstr "" + +#. Tag: para +#: injection.xml:25 +#, no-c-format +msgid "" +"First, the Web Bean manager calls the Web Bean constructor, to obtain an " +"instance of the Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:29 +#, no-c-format +msgid "" +"Next, the Web Bean manager initializes the values of all injected fields of " +"the Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:33 +#, no-c-format +msgid "Next, the Web Bean manager calls all initializer methods of Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:37 +#, no-c-format +msgid "" +"Finally, the <literal>@PostConstruct</literal> method of the Web Bean, if " +"any, is called." +msgstr "" + +#. Tag: para +#: injection.xml:42 +#, no-c-format +msgid "" +"Constructor parameter injection is not supported for EJB beans, since the " +"EJB is instantiated by the EJB container, not the Web Bean manager." +msgstr "" + +#. Tag: para +#: injection.xml:45 +#, no-c-format +msgid "" +"Parameters of constructors and initializer methods need not be explicitly " +"annotated when the default binding type <literal>@Current</literal> applies. " +"Injected fields, however, <emphasis>must</emphasis> specify a binding type, " +"even when the default binding type applies. If the field does not specify a " +"binding type, it will not be injected." +msgstr "" + +#. Tag: para +#: injection.xml:51 +#, no-c-format +msgid "Producer methods also support parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:53 +#, no-c-format +msgid "" +"<![CDATA[@Produces Checkout createCheckout(ShoppingCart cart) {\n" +" return new Checkout(cart);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:55 +#, no-c-format +msgid "" +"Finally, observer methods (which we'll meet in <xref linkend=\"events\"/>), " +"disposal methods and destructor methods all support parameter injection." +msgstr "" + +#. Tag: para +#: injection.xml:58 +#, no-c-format +msgid "" +"The Web Beans specification defines a procedure, called the " +"<emphasis>typesafe resolution algorithm</emphasis>, that the Web Bean " +"manager follows when identifying the Web Bean to inject to an injection " +"point. This algorithm looks complex at first, but once you understand it, " +"it's really quite intuitive. Typesafe resolution is performed at system " +"initialization time, which means that the manager will inform the user " +"immediately if a Web Bean's dependencies cannot be satisfied, by throwing a " +"<literal>UnsatisfiedDependencyException</literal> or " +"<literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:67 +#, no-c-format +msgid "" +"The purpose of this algorithm is to allow multiple Web Beans to implement " +"the same API type and either:" +msgstr "" + +#. Tag: para +#: injection.xml:72 +#, no-c-format +msgid "" +"allow the client to select which implementation it requires using " +"<emphasis>binding annotations</emphasis>," +msgstr "" + +#. Tag: para +#: injection.xml:77 +#, no-c-format +msgid "" +"allow the application deployer to select which implementation is appropriate " +"for a particular deployment, without changes to the client, by enabling or " +"disabling <emphasis>deployment types</emphasis>, or" +msgstr "" + +#. Tag: para +#: injection.xml:82 +#, no-c-format +msgid "" +"allow one implementation of an API to override another implementation of the " +"same API at deployment time, without changes to the client, using " +"<emphasis>deployment type precedence</emphasis>." +msgstr "" + +#. Tag: para +#: injection.xml:88 +#, no-c-format +msgid "" +"Let's explore how the Web Beans manager determines a Web Bean to be injected." +msgstr "" + +#. Tag: title +#: injection.xml:91 +#, no-c-format +msgid "Binding annotations" +msgstr "" + +#. Tag: para +#: injection.xml:93 +#, no-c-format +msgid "" +"If we have more than one Web Bean that implements a particular API type, the " +"injection point can specify exactly which Web Bean should be injected using " +"a binding annotation. For example, there might be two implementations of " +"<literal>PaymentProcessor</literal>:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:98 +#, no-c-format +msgid "" +"<![CDATA[@PayByCheque\n" +"public class ChequePaymentProcessor implements PaymentProcessor {\n" +" public void process(Payment payment) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:100 +#, no-c-format +msgid "" +"<![CDATA[@PayByCreditCard\n" +"public class CreditCardPaymentProcessor implements PaymentProcessor {\n" +" public void process(Payment payment) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:102 +#, no-c-format +msgid "" +"Where <literal>@PayByCheque</literal> and <literal>@PayByCreditCard</" +"literal> are binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:105 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayByCheque {}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:107 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayByCreditCard {}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:109 +#, no-c-format +msgid "" +"A client Web Bean developer uses the binding annotation to specify exactly " +"which Web Bean should be injected." +msgstr "" + +#. Tag: para +#: injection.xml:112 +#, no-c-format +msgid "Using field injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:114 +#, no-c-format +msgid "" +"<![CDATA[@PayByCheque PaymentProcessor chequePaymentProcessor;\n" +"@PayByCreditCard PaymentProcessor creditCardPaymentProcessor;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:116 +#, no-c-format +msgid "Using initializer method injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:118 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public void setPaymentProcessors(@PayByCheque PaymentProcessor " +"chequePaymentProcessor, \n" +" @PayByCreditCard PaymentProcessor " +"creditCardPaymentProcessor) {\n" +" this.chequePaymentProcessor = chequePaymentProcessor;\n" +" this.creditCardPaymentProcessor = creditCardPaymentProcessor;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:120 +#, no-c-format +msgid "Or using constructor injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:122 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public Checkout(@PayByCheque PaymentProcessor chequePaymentProcessor, \n" +" @PayByCreditCard PaymentProcessor " +"creditCardPaymentProcessor) {\n" +" this.chequePaymentProcessor = chequePaymentProcessor;\n" +" this.creditCardPaymentProcessor = creditCardPaymentProcessor;\n" +"}]]>" +msgstr "" + +#. Tag: title +#: injection.xml:125 +#, no-c-format +msgid "Binding annotations with members" +msgstr "" + +#. Tag: para +#: injection.xml:127 +#, no-c-format +msgid "Binding annotations may have members:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:129 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayBy {\n" +" PaymentType value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:131 +#, no-c-format +msgid "In which case, the member value is significant:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:133 +#, no-c-format +msgid "" +"<![CDATA[@PayBy(CHEQUE) PaymentProcessor chequePaymentProcessor;\n" +"@PayBy(CREDIT_CARD) PaymentProcessor creditCardPaymentProcessor;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:135 +#, no-c-format +msgid "" +"You can tell the Web Bean manager to ignore a member of a binding annotation " +"type by annotating the member <literal>@NonBinding</literal>." +msgstr "" + +#. Tag: title +#: injection.xml:141 +#, no-c-format +msgid "Combinations of binding annnotations" +msgstr "" + +#. Tag: para +#: injection.xml:143 +#, no-c-format +msgid "An injection point may even specify multiple binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:145 +#, no-c-format +msgid "" +"<![CDATA[@Asynchronous @PayByCheque PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: injection.xml:147 +#, no-c-format +msgid "" +"In this case, only a Web Bean which has <emphasis>both</emphasis> binding " +"annotations would be eligible for injection." +msgstr "" + +#. Tag: title +#: injection.xml:153 +#, no-c-format +msgid "Binding annotations and producer methods" +msgstr "" + +#. Tag: para +#: injection.xml:155 +#, no-c-format +msgid "Even producer methods may specify binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:157 +#, no-c-format +msgid "" +"<![CDATA[@Produces \n" +"@Asynchronous @PayByCheque \n" +"PaymentProcessor createAsyncPaymentProcessor(@PayByCheque PaymentProcessor " +"processor) {\n" +" return new AsynchronousPaymentProcessor(processor);\n" +"}]]>" +msgstr "" + +#. Tag: title +#: injection.xml:162 +#, no-c-format +msgid "The default binding type" +msgstr "" + +#. Tag: para +#: injection.xml:164 +#, no-c-format +msgid "" +"Web Beans defines a binding type <literal>@Current</literal> that is the " +"default binding type for any injection point or Web Bean that does not " +"explicitly specify a binding type." +msgstr "" + +#. Tag: para +#: injection.xml:168 +#, no-c-format +msgid "" +"There are two common circumstances in which it is necessary to explicitly " +"specify <literal>@Current</literal>:" +msgstr "" + +#. Tag: para +#: injection.xml:173 +#, no-c-format +msgid "" +"on a field, in order to declare it as an injected field with the default " +"binding type, and" +msgstr "" + +#. Tag: para +#: injection.xml:177 +#, no-c-format +msgid "" +"on a Web Bean which has another binding type in addition to the default " +"binding type." +msgstr "" + +#. Tag: title +#: injection.xml:187 +#, no-c-format +msgid "Deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:189 +#, no-c-format +msgid "" +"All Web Beans have a <emphasis>deployment type</emphasis>. Each deployment " +"type identifies a set of Web Beans that should be conditionally installed in " +"some deployments of the system." +msgstr "" + +#. Tag: para +#: injection.xml:193 +#, no-c-format +msgid "" +"For example, we could define a deployment type named <literal>@Mock</" +"literal>, which would identify Web Beans that should only be installed when " +"the system executes inside an integration testing environment:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:197 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +" @Target({TYPE, METHOD})\n" +" @DeploymentType\n" +" public @interface Mock {}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:199 +#, no-c-format +msgid "" +"Suppose we had some Web Bean that interacted with an external system to " +"process payments:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:202 +#, no-c-format +msgid "" +"<![CDATA[public class ExternalPaymentProcessor {\n" +" \n" +" public void process(Payment p) {\n" +" ...\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:204 +#, no-c-format +msgid "" +"Since this Web Bean does not explicitly specify a deployment type, it has " +"the default deployment type <literal>@Production</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:207 +#, no-c-format +msgid "" +"For integration or unit testing, the external system is slow or unavailable. " +"So we would create a mock object:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:210 +#, no-c-format +msgid "" +"<![CDATA[@Mock \n" +"public class MockPaymentProcessor implements PaymentProcessor {\n" +"\n" +" @Override\n" +" public void process(Payment p) {\n" +" p.setSuccessful(true);\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:212 +#, no-c-format +msgid "" +"But how does the Web Bean manager determine which implementation to use in a " +"particular deployment?" +msgstr "" + +#. Tag: title +#: injection.xml:216 +#, no-c-format +msgid "Enabling deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:218 +#, no-c-format +msgid "" +"Web Beans defines two built-in deployment types: <literal>@Production</" +"literal> and <literal>@Standard</literal>. By default, only Web Beans with " +"the built-in deployment types are enabled when the system is deployed. We " +"can identify additional deployment types to be enabled in a particular " +"deployment by listing them in <literal>web-beans.xml</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:224 +#, no-c-format +msgid "" +"Going back to our example, when we deploy our integration tests, we want all " +"our <literal>@Mock</literal> objects to be installed:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:227 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans>\n" +" <Deploy>\n" +" <Standard/>\n" +" <Production/>\n" +" <test:Mock/>\n" +" </Deploy>\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: injection.xml:229 +#, no-c-format +msgid "" +"Now the Web Bean manager will identify and install all Web Beans annotated " +"<literal>@Production</literal>, <literal>@Standard</literal> or " +"<literal>@Mock</literal> at deployment time." +msgstr "" + +#. Tag: para +#: injection.xml:233 +#, no-c-format +msgid "" +"The deployment type <literal>@Standard</literal> is used only for certain " +"special Web Beans defined by the Web Beans specification. We can't use it " +"for our own Web Beans, and we can't disable it." +msgstr "" + +#. Tag: para +#: injection.xml:237 +#, no-c-format +msgid "" +"The deployment type <literal>@Production</literal> is the default deployment " +"type for Web Beans which don't explicitly declare a deployment type, and may " +"be disabled." +msgstr "" + +#. Tag: title +#: injection.xml:244 +#, no-c-format +msgid "Deployment type precedence" +msgstr "" + +#. Tag: para +#: injection.xml:246 +#, no-c-format +msgid "" +"If you've been paying attention, you're probably wondering how the Web Bean " +"manager decides which implementation<literal>ExternalPaymentProcessor</" +"literal> or <literal>MockPaymentProcessor</literal>to choose. Consider " +"what happens when the manager encounters this injection point:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:251 +#, no-c-format +msgid "<![CDATA[@Current PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: injection.xml:253 +#, no-c-format +msgid "" +"There are now two Web Beans which satisfy the <literal>PaymentProcessor</" +"literal> contract. Of course, we can't use a binding annotation to " +"disambiguate, since binding annotations are hard-coded into the source at " +"the injection point, and we want the manager to be able to decide at " +"deployment time!" +msgstr "" + +#. Tag: para +#: injection.xml:258 +#, no-c-format +msgid "" +"The solution to this problem is that each deployment type has a different " +"<emphasis>precedence</emphasis>. The precedence of the deployment types is " +"determined by the order in which they appear in <literal>web-beans.xml</" +"literal>. In our example, <literal>@Mock</literal> appears later than " +"<literal>@Production</literal> so it has a higher precedence." +msgstr "" + +#. Tag: para +#: injection.xml:264 +#, no-c-format +msgid "" +"Whenever the manager discovers that more than one Web Bean could satisfy the " +"contract (API type plus binding annotations) specified by an injection " +"point, it considers the relative precedence of the Web Beans. If one has a " +"higher precedence than the others, it chooses the higher precedence Web Bean " +"to inject. So, in our example, the Web Bean manager will inject " +"<literal>MockPaymentProcessor</literal> when executing in our integration " +"testing environment (which is exactly what we want)." +msgstr "" + +#. Tag: para +#: injection.xml:271 +#, no-c-format +msgid "" +"It's interesting to compare this facility to today's popular manager " +"architectures. Various \"lightweight\" containers also allow conditional " +"deployment of classes that exist in the classpath, but the classes that are " +"to be deployed must be explicity, individually, listed in configuration code " +"or in some XML configuration file. Web Beans does support Web Bean " +"definition and configuration via XML, but in the common case where no " +"complex configuration is required, deployment types allow a whole set of Web " +"Beans to be enabled with a single line of XML. Meanwhile, a developer " +"browsing the code can easily identify what deployment scenarios the Web Bean " +"will be used in." +msgstr "" + +#. Tag: title +#: injection.xml:284 +#, no-c-format +msgid "Example deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:286 +#, no-c-format +msgid "" +"Deployment types are useful for all kinds of things, here's some examples:" +msgstr "" + +#. Tag: para +#: injection.xml:290 +#, no-c-format +msgid "" +"<literal>@Mock</literal> and <literal>@Staging</literal> deployment types " +"for testing" +msgstr "" + +#. Tag: para +#: injection.xml:294 +#, no-c-format +msgid "<literal>@AustralianTaxLaw</literal> for site-specific Web Beans" +msgstr "" + +#. Tag: para +#: injection.xml:297 +#, no-c-format +msgid "" +"<literal>@SeamFramework</literal>, <literal>@Guice</literal> for third-party " +"frameworks which build on Web Beans" +msgstr "" + +#. Tag: para +#: injection.xml:301 +#, no-c-format +msgid "" +"<literal>@Standard</literal> for standard Web Beans defined by the Web Beans " +"specification" +msgstr "" + +#. Tag: para +#: injection.xml:306 +#, no-c-format +msgid "I'm sure you can think of more applications..." +msgstr "" + +#. Tag: title +#: injection.xml:313 +#, no-c-format +msgid "Fixing unsatisfied dependencies" +msgstr "" + +#. Tag: para +#: injection.xml:315 +#, no-c-format +msgid "" +"The typesafe resolution algorithm fails when, after considering the binding " +"annotations and and deployment types of all Web Beans that implement the API " +"type of an injection point, the Web Bean manager is unable to identify " +"exactly one Web Bean to inject." +msgstr "" + +#. Tag: para +#: injection.xml:320 +#, no-c-format +msgid "" +"It's usually easy to fix an <literal>UnsatisfiedDependencyException</" +"literal> or <literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:323 +#, no-c-format +msgid "" +"To fix an <literal>UnsatisfiedDependencyException</literal>, simply provide " +"a Web Bean which implements the API type and has the binding types of the " +"injection pointor enable the deployment type of a Web Bean that " +"already implements the API type and has the binding types." +msgstr "" + +#. Tag: para +#: injection.xml:328 +#, no-c-format +msgid "" +"To fix an <literal>AmbiguousDependencyException</literal>, introduce a " +"binding type to distinguish between the two implementations of the API type, " +"or change the deployment type of one of the implementations so that the Web " +"Bean manager can use deployment type precedence to choose between them. An " +"<literal>AmbiguousDependencyException</literal> can only occur if two Web " +"Beans share a binding type and have exactly the same deployment type." +msgstr "" + +#. Tag: para +#: injection.xml:335 +#, no-c-format +msgid "" +"There's one more issue you need to be aware of when using dependency " +"injection in Web Beans." +msgstr "" + +#. Tag: title +#: injection.xml:341 +#, no-c-format +msgid "Client proxies" +msgstr "" + +#. Tag: para +#: injection.xml:343 +#, no-c-format +msgid "" +"Clients of an injected Web Bean do not usually hold a direct reference to a " +"Web Bean instance." +msgstr "" + +#. Tag: para +#: injection.xml:346 +#, no-c-format +msgid "" +"Imagine that a Web Bean bound to the application scope held a direct " +"reference to a Web Bean bound to the request scope. The application scoped " +"Web Bean is shared between many different requests. However, each request " +"should see a different instance of the request scoped Web bean!" +msgstr "" + +#. Tag: para +#: injection.xml:351 +#, no-c-format +msgid "" +"Now imagine that a Web Bean bound to the session scope held a direct " +"reference to a Web Bean bound to the application scope. From time to time, " +"the session context is serialized to disk in order to use memory more " +"efficiently. However, the application scoped Web Bean instance should not be " +"serialized along with the session scoped Web Bean!" +msgstr "" + +#. Tag: para +#: injection.xml:357 +#, no-c-format +msgid "" +"Therefore, unless a Web Bean has the default scope <literal>@Dependent</" +"literal>, the Web Bean manager must indirect all injected references to the " +"Web Bean through a proxy object. This <emphasis>client proxy</emphasis> is " +"responsible for ensuring that the Web Bean instance that receives a method " +"invocation is the instance that is associated with the current context. The " +"client proxy also allows Web Beans bound to contexts such as the session " +"context to be serialized to disk without recursively serializing other " +"injected Web Beans." +msgstr "" + +#. Tag: para +#: injection.xml:365 +#, no-c-format +msgid "" +"Unfortunately, due to limitations of the Java language, some Java types " +"cannot be proxied by the Web Bean manager. Therefore, the Web Bean manager " +"throws an <literal>UnproxyableDependencyException</literal> if the type of " +"an injection point cannot be proxied." +msgstr "" + +#. Tag: para +#: injection.xml:370 +#, no-c-format +msgid "The following Java types cannot be proxied by the Web Bean manager:" +msgstr "" + +#. Tag: para +#: injection.xml:374 +#, no-c-format +msgid "" +"classes which are declared <literal>final</literal> or have a " +"<literal>final</literal> method," +msgstr "" + +#. Tag: para +#: injection.xml:378 +#, no-c-format +msgid "classes which have no non-private constructor with no parameters, and" +msgstr "" + +#. Tag: para +#: injection.xml:381 +#, no-c-format +msgid "arrays and primitive types." +msgstr "" + +#. Tag: para +#: injection.xml:385 +#, no-c-format +msgid "" +"It's usually very easy to fix an <literal>UnproxyableDependencyException</" +"literal>. Simply add a constructor with no parameters to the injected class, " +"introduce an interface, or change the scope of the injected Web Bean to " +"<literal>@Dependent</literal>." +msgstr "" + +#. Tag: title +#: injection.xml:392 +#, no-c-format +msgid "Obtaining a Web Bean by programatic lookup" +msgstr "" + +#. Tag: para +#: injection.xml:394 +#, no-c-format +msgid "" +"The application may obtain an instance of the interface <literal>Manager</" +"literal> by injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:397 +#, no-c-format +msgid "<![CDATA[@Current Manager manager;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:399 +#, no-c-format +msgid "" +"The <literal>Manager</literal> object provides a set of methods for " +"obtaining a Web Bean instance programatically." +msgstr "" + +#. Tag: programlisting +#: injection.xml:402 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class);]]>" +msgstr "" + +#. Tag: para +#: injection.xml:404 +#, no-c-format +msgid "" +"Binding annotations may be specified by subclassing the helper class " +"<literal>AnnotationLiteral</literal>, since it is otherwise difficult to " +"instantiate an annotation type in Java." +msgstr "" + +#. Tag: programlisting +#: injection.xml:408 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class, \n" +" new " +"AnnotationLiteral<CreditCard>(){});]]>" +msgstr "" + +#. Tag: para +#: injection.xml:410 +#, no-c-format +msgid "" +"If the binding type has an annotation member, we can't use an anonymous " +"subclass of <literal>AnnotationLiteral</literal>instead we'll need to " +"create a named subclass:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:413 +#, no-c-format +msgid "" +"<![CDATA[abstract class CreditCardBinding \n" +" extends AnnotationLiteral<CreditCard> \n" +" implements CreditCard {}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:415 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class, \n" +" new CreditCardBinding() { \n" +" public void value() " +"{ return paymentType; } \n" +" } );]]>" +msgstr "" + +#. Tag: title +#: injection.xml:419 +#, no-c-format +msgid "" +"Lifecycle callbacks, <literal>@Resource</literal>, <literal>@EJB</literal> " +"and <literal>@PersistenceContext</literal>" +msgstr "" + +#. Tag: para +#: injection.xml:422 +#, no-c-format +msgid "" +"Enterprise Web Beans support all the lifecycle callbacks defined by the EJB " +"specification: <literal>@PostConstruct</literal>, <literal>@PreDestroy</" +"literal>, <literal>@PrePassivate</literal> and <literal>@PostActivate</" +"literal>." +msgstr "" + +#. Tag: para +#: injection.xml:426 +#, no-c-format +msgid "" +"Simple Web Beans support only the <literal>@PostConstruct</literal> and " +"<literal>@PreDestroy</literal> callbacks." +msgstr "" + +#. Tag: para +#: injection.xml:429 +#, no-c-format +msgid "" +"Both enterprise and simple Web Beans support the use of <literal>@Resource</" +"literal>, <literal>@EJB</literal> and <literal>@PersistenceContext</literal> " +"for injection of Java EE resources, EJBs and JPA persistence contexts, " +"respectively. Simple Web Beans do not support the use of " +"<literal>@PersistenceContext(type=EXTENDED)</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:434 +#, no-c-format +msgid "" +"The <literal>@PostConstruct</literal> callback always occurs after all " +"dependencies have been injected." +msgstr "" + +#. Tag: title +#: injection.xml:440 +#, no-c-format +msgid "The <literal>InjectionPoint</literal> object" +msgstr "" + +#. Tag: para +#: injection.xml:442 +#, no-c-format +msgid "" +"There are certain kinds of dependent objectsWeb Beans with scope " +"<literal>@Dependent</literal>that need to know something about the " +"object or injection point into which they are injected in order to be able " +"to do what they do. For example:" +msgstr "" + +#. Tag: para +#: injection.xml:448 +#, no-c-format +msgid "" +"The log category for a <literal>Logger</literal> depends upon the class of " +"the object that owns it." +msgstr "" + +#. Tag: para +#: injection.xml:452 +#, no-c-format +msgid "" +"Injection of a HTTP parameter or header value depends upon what parameter or " +"header name was specified at the injection point." +msgstr "" + +#. Tag: para +#: injection.xml:456 +#, no-c-format +msgid "" +"Injection of the result of an EL expression evaluation depends upon the " +"expression that was specified at the injection point." +msgstr "" + +#. Tag: para +#: injection.xml:461 +#, no-c-format +msgid "" +"A Web Bean with scope <literal>@Dependent</literal> may inject an instance " +"of <literal>InjectionPoint</literal> and access metadata relating to the " +"injection point to which it belongs." +msgstr "" + +#. Tag: para +#: injection.xml:465 +#, no-c-format +msgid "" +"Let's look at an example. The following code is verbose, and vulnerable to " +"refactoring problems:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:468 +#, no-c-format +msgid "<![CDATA[Logger log = Logger.getLogger(MyClass.class.getName());]]>" +msgstr "" + +#. Tag: para +#: injection.xml:470 +#, no-c-format +msgid "" +"This clever little producer method lets you inject a JDK <literal>Logger</" +"literal> without explicitly specifying the log category:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:473 +#, no-c-format +msgid "" +"<![CDATA[class LogFactory {\n" +"\n" +" @Produces Logger createLogger(InjectionPoint injectionPoint) { \n" +" return Logger.getLogger(injectionPoint.getMember().getDeclaringClass()." +"getName()); \n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:475 +#, no-c-format +msgid "We can now write:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:477 +#, no-c-format +msgid "<![CDATA[@Current Logger log;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:479 +#, no-c-format +msgid "" +"Not convinced? Then here's a second example. To inject HTTP parameters, we " +"need to define a binding type:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:482 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"public @interface HttpParam {\n" +" @NonBinding public String value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:484 +#, no-c-format +msgid "We would use this binding type at injection points as follows:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:486 +#, no-c-format +msgid "" +"<![CDATA[@HttpParam(\"username\") String username;\n" +"@HttpParam(\"password\") String password;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:488 +#, no-c-format +msgid "The following producer method does the work:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:490 +#, no-c-format +msgid "" +"<![CDATA[class HttpParams\n" +"\n" +" @Produces @HttpParam(\"\")\n" +" String getParamValue(ServletRequest request, InjectionPoint ip) {\n" +" return request.getParameter(ip.getAnnotation(HttpParam.class).value" +"());\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:492 +#, no-c-format +msgid "" +"(Note that the <literal>value()</literal> member of the <literal>HttpParam</" +"literal> annotation is ignored by the Web Bean manager since it is annotated " +"<literal>@NonBinding.</literal>)" +msgstr "" + +#. Tag: para +#: injection.xml:495 +#, no-c-format +msgid "" +"The Web Bean manager provides a built-in Web Bean that implements the " +"<literal>InjectionPoint</literal> interface:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:498 +#, no-c-format +msgid "" +"<![CDATA[public interface InjectionPoint { \n" +" public Object getInstance(); \n" +" public Bean<?> getBean(); \n" +" public Member getMember(): \n" +" public <T extends Annotation> T getAnnotation(Class<T> annotation); \n" +" public Set<T extends Annotation> getAnnotations(); \n" +"}]]>" +msgstr "" Added: doc/trunk/reference/pot/modules/interceptors.pot =================================================================== --- doc/trunk/reference/pot/modules/interceptors.pot (rev 0) +++ doc/trunk/reference/pot/modules/interceptors.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,573 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: interceptors.xml:4 +#, no-c-format +msgid "Interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:6 +#, no-c-format +msgid "" +"Web Beans re-uses the basic interceptor architecture of EJB 3.0, extending " +"the functionality in two directions:" +msgstr "" + +#. Tag: para +#: interceptors.xml:11 +#, no-c-format +msgid "Any Web Bean may have interceptors, not just session beans." +msgstr "" + +#. Tag: para +#: interceptors.xml:14 +#, no-c-format +msgid "" +"Web Beans features a more sophisticated annotation-based approach to binding " +"interceptors to Web Beans." +msgstr "" + +#. Tag: para +#: interceptors.xml:22 +#, no-c-format +msgid "The EJB specification defines two kinds of interception points:" +msgstr "" + +#. Tag: para +#: interceptors.xml:26 +#, no-c-format +msgid "business method interception, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:29 +#, no-c-format +msgid "lifecycle callback interception." +msgstr "" + +#. Tag: para +#: interceptors.xml:33 +#, no-c-format +msgid "" +"A <emphasis>business method interceptor</emphasis> applies to invocations of " +"methods of the Web Bean by clients of the Web Bean:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:36 +#, no-c-format +msgid "" +"<![CDATA[public class TransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:38 +#, no-c-format +msgid "" +"A <emphasis>lifecycle callback interceptor</emphasis> applies to invocations " +"of lifecycle callbacks by the container:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:41 +#, no-c-format +msgid "" +"<![CDATA[public class DependencyInjectionInterceptor {\n" +" @PostConstruct public void injectDependencies(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:43 +#, no-c-format +msgid "" +"An interceptor class may intercept both lifecycle callbacks and business " +"methods." +msgstr "" + +#. Tag: title +#: interceptors.xml:49 +#, no-c-format +msgid "Interceptor bindings" +msgstr "" + +#. Tag: para +#: interceptors.xml:51 +#, no-c-format +msgid "" +"Suppose we want to declare that some of our Web Beans are transactional. The " +"first thing we need is an <emphasis>interceptor binding annotation</" +"emphasis> to specify exactly which Web Beans we're interested in:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:55 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Transactional {}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:57 +#, no-c-format +msgid "" +"Now we can easily specify that our <literal>ShoppingCart</literal> is a " +"transactional object:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:60 +#, no-c-format +msgid "" +"<![CDATA[@Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:62 +#, no-c-format +msgid "Or, if we prefer, we can specify that just one method is transactional:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:64 +#, no-c-format +msgid "" +"<![CDATA[public class ShoppingCart {\n" +" @Transactional public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:69 +#, no-c-format +msgid "Implementing interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:71 +#, no-c-format +msgid "" +"That's great, but somewhere along the line we're going to have to actually " +"implement the interceptor that provides this transaction management aspect. " +"All we need to do is create a standard EJB interceptor, and annotate it " +"<literal>@Interceptor</literal> and <literal>@Transactional</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:76 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:78 +#, no-c-format +msgid "" +"All Web Beans interceptors are simple Web Beans, and can take advantage of " +"dependency injection and contextual lifecycle management." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:81 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +"\n" +" @Resource Transaction transaction;\n" +"\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:83 +#, no-c-format +msgid "Multiple interceptors may use the same interceptor binding type." +msgstr "" + +#. Tag: title +#: interceptors.xml:88 +#, no-c-format +msgid "Enabling interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:90 +#, no-c-format +msgid "" +"Finally, we need to <emphasis>enable</emphasis> our interceptor in " +"<literal>web-beans.xml</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:93 +#, no-c-format +msgid "" +"<![CDATA[<Interceptors>\n" +" <tx:TransactionInterceptor/>\n" +"</Interceptors>]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:95 +#, no-c-format +msgid "Whoah! Why the angle bracket stew?" +msgstr "" + +#. Tag: para +#: interceptors.xml:97 +#, no-c-format +msgid "Well, the XML declaration solves two problems:" +msgstr "" + +#. Tag: para +#: interceptors.xml:101 +#, no-c-format +msgid "" +"it enables us to specify a total ordering for all the interceptors in our " +"system, ensuring deterministic behavior, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:105 +#, no-c-format +msgid "it lets us enable or disable interceptor classes at deployment time." +msgstr "" + +#. Tag: para +#: interceptors.xml:109 +#, no-c-format +msgid "" +"For example, we could specify that our security interceptor runs before our " +"<literal>TransactionInterceptor</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:112 +#, no-c-format +msgid "" +"<![CDATA[<Interceptors>\n" +" <sx:SecurityInterceptor/>\n" +" <tx:TransactionInterceptor/>\n" +"</Interceptors>]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:114 +#, no-c-format +msgid "Or we could turn them both off in our test environment!" +msgstr "" + +#. Tag: title +#: interceptors.xml:119 +#, no-c-format +msgid "Interceptor bindings with members" +msgstr "" + +#. Tag: para +#: interceptors.xml:121 +#, no-c-format +msgid "" +"Suppose we want to add some extra information to our " +"<literal>@Transactional</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:124 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Transactional {\n" +" boolean requiresNew() default false;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:126 +#, no-c-format +msgid "" +"Web Beans will use the value of <literal>requiresNew</literal> to choose " +"between two different interceptors, <literal>TransactionInterceptor</" +"literal> and <literal>RequiresNewTransactionInterceptor</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:130 +#, no-c-format +msgid "" +"<![CDATA[@Transactional(requiresNew=true) @Interceptor\n" +"public class RequiresNewTransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:132 +#, no-c-format +msgid "" +"Now we can use <literal>RequiresNewTransactionInterceptor</literal> like " +"this:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:134 +#, no-c-format +msgid "" +"<![CDATA[@Transactional(requiresNew=true)\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:136 +#, no-c-format +msgid "" +"But what if we only have one interceptor and we want the manager to ignore " +"the value of <literal>requiresNew</literal> when binding interceptors? We " +"can use the <literal>@NonBinding</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:140 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Secure {\n" +" @NonBinding String[] rolesAllowed() default {};\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:145 +#, no-c-format +msgid "Multiple interceptor binding annotations" +msgstr "" + +#. Tag: para +#: interceptors.xml:147 +#, no-c-format +msgid "" +"Usually we use combinations of interceptor bindings types to bind multiple " +"interceptors to a Web Bean. For example, the following declaration would be " +"used to bind <literal>TransactionInterceptor</literal> and " +"<literal>SecurityInterceptor</literal> to the same Web Bean:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:152 +#, no-c-format +msgid "" +"<![CDATA[@Secure(rolesAllowed=\"admin\") @Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:154 +#, no-c-format +msgid "" +"However, in very complex cases, an interceptor itself may specify some " +"combination of interceptor binding types:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:157 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure @Interceptor\n" +"public class TransactionalSecureInterceptor { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:159 +#, no-c-format +msgid "" +"Then this interceptor could be bound to the <literal>checkout()</literal> " +"method using any one of the following combinations:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:162 +#, no-c-format +msgid "" +"<![CDATA[public class ShoppingCart {\n" +" @Transactional @Secure public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:164 +#, no-c-format +msgid "" +"<![CDATA[@Secure\n" +"public class ShoppingCart {\n" +" @Transactional public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:166 +#, no-c-format +msgid "" +"<![CDATA[@Transactionl\n" +"public class ShoppingCart {\n" +" @Secure public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:168 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure\n" +"public class ShoppingCart {\n" +" public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:173 +#, no-c-format +msgid "Interceptor binding type inheritance" +msgstr "" + +#. Tag: para +#: interceptors.xml:175 +#, no-c-format +msgid "" +"One limitation of the Java language support for annotations is the lack of " +"annotation inheritance. Really, annotations should have reuse built in, to " +"allow this kind of thing to work:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:179 +#, no-c-format +msgid "" +"<![CDATA[public @interface Action extends Transactional, Secure { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:181 +#, no-c-format +msgid "" +"Well, fortunately, Web Beans works around this missing feature of Java. We " +"may annotate one interceptor binding type with other interceptor binding " +"types. The interceptor bindings are transitiveany Web Bean with the " +"first interceptor binding inherits the interceptor bindings declared as meta-" +"annotations." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:186 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure\n" +"@InterceptorBindingType\n" +"@Target(TYPE)\n" +"@Retention(RUNTIME)\n" +"public @interface Action { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:188 +#, no-c-format +msgid "" +"Any Web Bean annotated <literal>@Action</literal> will be bound to both " +"<literal>TransactionInterceptor</literal> and <literal>SecurityInterceptor</" +"literal>. (And even <literal>TransactionalSecureInterceptor</literal>, if it " +"exists.)" +msgstr "" + +#. Tag: title +#: interceptors.xml:195 +#, no-c-format +msgid "Use of <literal>@Interceptors</literal>" +msgstr "" + +#. Tag: para +#: interceptors.xml:197 +#, no-c-format +msgid "" +"The <literal>@Interceptors</literal> annotation defined by the EJB " +"specification is supported for both enterprise and simple Web Beans, for " +"example:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:200 +#, no-c-format +msgid "" +"<![CDATA[(a)Interceptors({TransactionInterceptor.class, @SecurityInterceptor." +"class})\n" +"public class ShoppingCart {\n" +" public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:202 +#, no-c-format +msgid "However, this approach suffers the following drawbacks:" +msgstr "" + +#. Tag: para +#: interceptors.xml:206 +#, no-c-format +msgid "the interceptor implementation is hardcoded in business code," +msgstr "" + +#. Tag: para +#: interceptors.xml:209 +#, no-c-format +msgid "interceptors may not be easily disabled at deployment time, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:212 +#, no-c-format +msgid "" +"the interceptor ordering is non-globalit is determined by the order in " +"which interceptors are listed at the class level." +msgstr "" + +#. Tag: para +#: interceptors.xml:217 +#, no-c-format +msgid "" +"Therefore, we recommend the use of Web Beans-style interceptor bindings." +msgstr "" Added: doc/trunk/reference/pot/modules/intro.pot =================================================================== --- doc/trunk/reference/pot/modules/intro.pot (rev 0) +++ doc/trunk/reference/pot/modules/intro.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,1076 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: intro.xml:4 +#, no-c-format +msgid "Getting started with Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:6 +#, no-c-format +msgid "" +"So you're already keen to get started writing your first Web Bean? Or " +"perhaps you're skeptical, wondering what kinds of hoops the Web Beans " +"specification will make you jump through! The good news is that you've " +"probably already written and used hundreds, perhaps thousands of Web Beans. " +"You might not even remember the first Web Bean you wrote." +msgstr "" + +#. Tag: title +#: intro.xml:13 +#, no-c-format +msgid "Your first Web Bean" +msgstr "" + +#. Tag: para +#: intro.xml:15 +#, no-c-format +msgid "" +"With certain, very special exceptions, every Java class with a constructor " +"that accepts no parameters is a Web Bean. That includes every JavaBean. " +"Furthermore, every EJB 3-style session bean is a Web Bean. Sure, the " +"JavaBeans and EJBs you've been writing every day have not been able to take " +"advantage of the new services defined by the Web Beans specification, but " +"you'll be able to use every one of them as Web Beansinjecting them " +"into other Web Beans, configuring them via the Web Beans XML configuration " +"facility, even adding interceptors and decorators to themwithout " +"touching your existing code." +msgstr "" + +#. Tag: para +#: intro.xml:25 +#, no-c-format +msgid "" +"Suppose that we have two existing Java classes, that we've been using for " +"years in various applications. The first class parses a string into a list " +"of sentences:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:29 +#, no-c-format +msgid "" +"<![CDATA[public class SentenceParser {\n" +" public List<String> parse(String text) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:31 +#, no-c-format +msgid "" +"The second existing class is a stateless session bean front-end for an " +"external system that is able to translate sentences from one language to " +"another:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:35 +#, no-c-format +msgid "" +"<![CDATA[@Stateless\n" +"public class SentenceTranslator implements Translator {\n" +" public String translate(String sentence) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:37 +#, no-c-format +msgid "Where <literal>Translator</literal> is the local interface:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:39 +#, no-c-format +msgid "" +"<![CDATA[@Local\n" +"public interface Translator {\n" +" public String translate(String sentence);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:41 +#, no-c-format +msgid "" +"Unfortunately, we don't have a preexisting class that translates whole text " +"documents. So let's write a Web Bean that does this job:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:44 +#, no-c-format +msgid "" +"<![CDATA[public class TextTranslator {\n" +" \n" +" private SentenceParser sentenceParser;\n" +" private Translator sentenceTranslator;\n" +" \n" +" @Initializer\n" +" TextTranslator(SentenceParser sentenceParser, Translator " +"sentenceTranslator) {\n" +" this.sentenceParser = sentenceParser;\n" +" this.sentenceTranslator = sentenceTranslator;\n" +" }\n" +" \n" +" public String translate(String text) {\n" +" StringBuilder sb = new StringBuilder();\n" +" for (String sentence: sentenceParser.parse(text)) {\n" +" sb.append(sentenceTranslator.translate(sentence));\n" +" }\n" +" return sb.toString();\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:46 +#, no-c-format +msgid "" +"We may obtain an instance of <literal>TextTranslator</literal> by injecting " +"it into a Web Bean, Servlet or EJB:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:49 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public setTextTranslator(TextTranslator textTranslator) {\n" +" this.textTranslator = textTranslator;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:51 +#, no-c-format +msgid "" +"Alternatively, we may obtain an instance by directly calling a method of the " +"Web Bean manager:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:54 +#, no-c-format +msgid "" +"<![CDATA[TextTranslator tt = manager.getInstanceByType(TextTranslator." +"class);]]>" +msgstr "" + +#. Tag: para +#: intro.xml:56 +#, no-c-format +msgid "" +"But wait: <literal>TextTranslator</literal> does not have a constructor with " +"no parameters! Is it still a Web Bean? Well, a class that does not have a " +"constructor with no parameters can still be a Web Bean if it has a " +"constructor annotated <literal>@Initializer</literal>." +msgstr "" + +#. Tag: para +#: intro.xml:61 +#, no-c-format +msgid "" +"As you've guessed, the <literal>@Initializer</literal> annotation has " +"something to do with dependency injection! <literal>@Initializer</literal> " +"may be applied to a constructor or method of a Web Bean, and tells the Web " +"Bean manager to call that constructor or method when instantiating the Web " +"Bean. The Web Bean manager will inject other Web Beans to the parameters of " +"the constructor or method." +msgstr "" + +#. Tag: para +#: intro.xml:68 +#, no-c-format +msgid "" +"At system initialization time, the Web Bean manager must validate that " +"exactly one Web Bean exists which satisfies each injection point. In our " +"example, if no implementation of <literal>Translator</literal> " +"availableif the <literal>SentenceTranslator</literal> EJB was not " +"deployedthe Web Bean manager would throw an " +"<literal>UnsatisfiedDependencyException</literal>. If more than one " +"implementation of <literal>Translator</literal> was available, the Web Bean " +"manager would throw an <literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: title +#: intro.xml:80 +#, no-c-format +msgid "What is a Web Bean?" +msgstr "" + +#. Tag: para +#: intro.xml:82 +#, no-c-format +msgid "So what, <emphasis>exactly</emphasis>, is a Web Bean?" +msgstr "" + +#. Tag: para +#: intro.xml:84 +#, no-c-format +msgid "" +"A Web Bean is an application class that contains business logic. A Web Bean " +"may be called directly from Java code, or it may be invoked via Unified EL. " +"A Web Bean may access transactional resources. Dependencies between Web " +"Beans are managed automatically by the Web Bean manager. Most Web Beans are " +"<emphasis>stateful</emphasis> and <emphasis>contextual</emphasis>. The " +"lifecycle of a Web Bean is always managed by the Web Bean manager." +msgstr "" + +#. Tag: para +#: intro.xml:91 +#, no-c-format +msgid "" +"Let's back up a second. What does it really mean to be \"contextual\"? Since " +"Web Beans may be stateful, it matters <emphasis>which</emphasis> bean " +"instance I have. Unlike a stateless component model (for example, stateless " +"session beans) or a singleton component model (such as servlets, or " +"singleton beans), different clients of a Web Bean see the Web Bean in " +"different states. The client-visible state depends upon which instance of " +"the Web Bean the client has a reference to." +msgstr "" + +#. Tag: para +#: intro.xml:98 +#, no-c-format +msgid "" +"However, like a stateless or singleton model, but <emphasis>unlike</" +"emphasis> stateful session beans, the client does not control the lifecycle " +"of the instance by explicitly creating and destroying it. Instead, the " +"<emphasis>scope</emphasis> of the Web Bean determines:" +msgstr "" + +#. Tag: para +#: intro.xml:105 +#, no-c-format +msgid "the lifecycle of each instance of the Web Bean and" +msgstr "" + +#. Tag: para +#: intro.xml:108 +#, no-c-format +msgid "" +"which clients share a reference to a particular instance of the Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:113 +#, no-c-format +msgid "" +"For a given thread in a Web Beans application, there may be an " +"<emphasis>active context</emphasis> associated with the scope of the Web " +"Bean. This context may be unique to the thread (for example, if the Web Bean " +"is request scoped), or it may be shared with certain other threads (for " +"example, if the Web Bean is session scoped) or even all other threads (if it " +"is application scoped)." +msgstr "" + +#. Tag: para +#: intro.xml:119 +#, no-c-format +msgid "" +"Clients (for example, other Web Beans) executing in the same context will " +"see the same instance of the Web Bean. But clients in a different context " +"will see a different instance." +msgstr "" + +#. Tag: para +#: intro.xml:123 +#, no-c-format +msgid "" +"One great advantage of the contextual model is that it allows stateful Web " +"Beans to be treated like services! The client need not concern itself with " +"managing the lifecycle of the Web Bean it is using, <emphasis>nor does it " +"even need to know what that lifecyle is.</emphasis> Web Beans interact by " +"passing messages, and the Web Bean implementations define the lifecycle of " +"their own state. The Web Beans are loosely coupled because:" +msgstr "" + +#. Tag: para +#: intro.xml:132 +#, no-c-format +msgid "they interact via well-defined public APIs" +msgstr "" + +#. Tag: para +#: intro.xml:135 +#, no-c-format +msgid "their lifecycles are completely decoupled" +msgstr "" + +#. Tag: para +#: intro.xml:139 +#, no-c-format +msgid "" +"We can replace one Web Bean with a different Web Bean that implements the " +"same API and has a different lifecycle (a different scope) without affecting " +"the other Web Bean implementation. In fact, Web Beans defines a " +"sophisticated facility for overriding Web Bean implementations at deployment " +"time, as we will see in <xref linkend=\"deploymenttypes\"/>." +msgstr "" + +#. Tag: para +#: intro.xml:145 +#, no-c-format +msgid "" +"Note that not all clients of a Web Bean are Web Beans. Other objects such as " +"Servlets or Message-Driven Beanswhich are by nature not injectable, " +"contextual objectsmay also obtain references to Web Beans by injection." +msgstr "" + +#. Tag: para +#: intro.xml:149 +#, no-c-format +msgid "Enough hand-waving. More formally, according to the spec:" +msgstr "" + +#. Tag: para +#: intro.xml:153 +#, no-c-format +msgid "A Web Bean comprises:" +msgstr "" + +#. Tag: para +#: intro.xml:156 +#, no-c-format +msgid "A (nonempty) set of API types" +msgstr "" + +#. Tag: para +#: intro.xml:157 +#, no-c-format +msgid "A (nonempty) set of binding annotation types" +msgstr "" + +#. Tag: para +#: intro.xml:158 +#, no-c-format +msgid "A scope" +msgstr "" + +#. Tag: para +#: intro.xml:159 +#, no-c-format +msgid "A deployment type" +msgstr "" + +#. Tag: para +#: intro.xml:160 +#, no-c-format +msgid "Optionally, a Web Bean name" +msgstr "" + +#. Tag: para +#: intro.xml:161 +#, no-c-format +msgid "A set of interceptor binding types" +msgstr "" + +#. Tag: para +#: intro.xml:162 +#, no-c-format +msgid "A Web Bean implementation" +msgstr "" + +#. Tag: para +#: intro.xml:167 +#, no-c-format +msgid "Let's see what some of these terms mean, to the Web Bean developer." +msgstr "" + +#. Tag: title +#: intro.xml:170 +#, no-c-format +msgid "API types, binding types and dependency injection" +msgstr "" + +#. Tag: para +#: intro.xml:172 +#, no-c-format +msgid "" +"Web Beans usually acquire references to other Web Beans via dependency " +"injection. Any injected attribute specifies a \"contract\" that must be " +"satisfied by the Web Bean to be injected. The contract is:" +msgstr "" + +#. Tag: para +#: intro.xml:177 +#, no-c-format +msgid "an API type, together with" +msgstr "" + +#. Tag: para +#: intro.xml:178 +#, no-c-format +msgid "a set of binding types." +msgstr "" + +#. Tag: para +#: intro.xml:181 +#, no-c-format +msgid "" +"An API is a user-defined class or interface. (If the Web Bean is an EJB " +"session bean, the API type is the <literal>@Local</literal> interface or " +"bean-class local view). A binding type represents some client-visible " +"semantic that is satisfied by some implementations of the API and not by " +"others." +msgstr "" + +#. Tag: para +#: intro.xml:186 +#, no-c-format +msgid "" +"Binding types are represented by user-defined annotations that are " +"themselves annotated <literal>@BindingType</literal>. For example, the " +"following injection point has API type <literal>PaymentProcessor</literal> " +"and binding type <literal>@CreditCard</literal>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:191 +#, no-c-format +msgid "<![CDATA[@CreditCard PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: intro.xml:193 +#, no-c-format +msgid "" +"If no binding type is explicitly specified at an injection point, the " +"default binding type <literal>@Current</literal> is assumed." +msgstr "" + +#. Tag: para +#: intro.xml:196 +#, no-c-format +msgid "" +"For each injection point, the Web Bean manager searches for a Web Bean which " +"satisfies the contract (implements the API, and has all the binding types), " +"and injects that Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:200 +#, no-c-format +msgid "" +"The following Web Bean has the binding type <literal>@CreditCard</literal> " +"and implements the API type <literal>PaymentProcessor</literal>. It could " +"therefore be injected to the example injection point:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:204 +#, no-c-format +msgid "" +"<![CDATA[@CreditCard\n" +"public class CreditCardPaymentProcessor \n" +" implements PaymentProcessor { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:206 +#, no-c-format +msgid "" +"If a Web Bean does not explicitly specify a set of binding types, it has " +"exactly one binding type: the default binding type <literal>@Current</" +"literal>." +msgstr "" + +#. Tag: para +#: intro.xml:209 +#, no-c-format +msgid "" +"Web Beans defines a sophisticated but intuitive <emphasis>resolution " +"algorithm</emphasis> that helps the container decide what to do if there is " +"more than one Web Bean that satisfies a particular contract. We'll get into " +"the details in <xref linkend=\"injection\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:217 +#, no-c-format +msgid "Deployment types" +msgstr "" + +#. Tag: para +#: intro.xml:219 +#, no-c-format +msgid "" +"<emphasis>Deployment types</emphasis> let us classify our Web Beans by " +"deployment scenario. A deployment type is an annotation that represents a " +"particular deployment scenario, for example <literal>@Mock</literal>, " +"<literal>@Staging</literal> or <literal>@AustralianTaxLaw</literal>. We " +"apply the annotation to Web Beans which should be deployed in that scenario. " +"A deployment type allows a whole set of Web Beans to be conditionally " +"deployed, with a just single line of configuration." +msgstr "" + +#. Tag: para +#: intro.xml:226 +#, no-c-format +msgid "" +"Many Web Beans just use the default deployment type <literal>@Production</" +"literal>, in which case no deployment type need be explicitly specified. All " +"three Web Bean in our example have the deployment type <literal>@Production</" +"literal>." +msgstr "" + +#. Tag: para +#: intro.xml:230 +#, no-c-format +msgid "" +"In a testing environment, we might want to replace the " +"<literal>SentenceTranslator</literal> Web Bean with a \"mock object\":" +msgstr "" + +#. Tag: programlisting +#: intro.xml:233 +#, no-c-format +msgid "" +"<![CDATA[@Mock\n" +"public class MockSentenceTranslator implements Translator {\n" +" public String translate(String sentence) {\n" +" return \"Lorem ipsum dolor sit amet\";\n" +" }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:236 +#, no-c-format +msgid "" +"We would enable the deployment type <literal>@Mock</literal> in our testing " +"environment, to indicate that <literal>MockSentenceTranslator</literal> and " +"any other Web Bean annotated <literal>@Mock</literal> should be used." +msgstr "" + +#. Tag: para +#: intro.xml:240 +#, no-c-format +msgid "" +"We'll talk more about this unique and powerful feature in <xref linkend=" +"\"deploymenttypes\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:246 +#, no-c-format +msgid "Scope" +msgstr "" + +#. Tag: para +#: intro.xml:248 +#, no-c-format +msgid "" +"The <emphasis>scope</emphasis> defines the lifecycle and visibility of " +"instances of the Web Bean. The Web Beans context model is extensible, " +"accommodating arbitrary scopes. However, certain important scopes are built-" +"in to the specification, and provided by the Web Bean manager. A scope is " +"represented by an annotation type." +msgstr "" + +#. Tag: para +#: intro.xml:254 +#, no-c-format +msgid "" +"For example, any web application may have <emphasis>session scoped</" +"emphasis> Web Beans:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:257 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:259 +#, no-c-format +msgid "" +"An instance of a session scoped Web Bean is bound to a user session and is " +"shared by all requests that execute in the context of that session." +msgstr "" + +#. Tag: para +#: intro.xml:262 +#, no-c-format +msgid "" +"By default, Web Beans belong to a special scope called the " +"<emphasis>dependent pseudo-scope</emphasis>. Web Beans with this scope are " +"pure dependent objects of the object into which they are injected, and their " +"lifecycle is bound to the lifecycle of that object." +msgstr "" + +#. Tag: para +#: intro.xml:267 +#, no-c-format +msgid "We'll talk more about scopes in <xref linkend=\"scopescontexts\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:272 +#, no-c-format +msgid "Web Bean names and Unified EL" +msgstr "" + +#. Tag: para +#: intro.xml:274 +#, no-c-format +msgid "" +"A Web Bean may have a <emphasis>name</emphasis>, allowing it to be used in " +"Unified EL expressions. It's easy to specify the name of a Web Bean:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:278 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named(\"cart\")\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:280 +#, no-c-format +msgid "Now we can easily use the Web Bean in any JSF or JSP page:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:282 +#, no-c-format +msgid "" +"<![CDATA[<h:dataTable value=\"#{cart.lineItems}\" var=\"item\">\n" +" ....\n" +"</h:dataTable>]]>" +msgstr "" + +#. Tag: para +#: intro.xml:284 +#, no-c-format +msgid "" +"It's even easier to just let the name be defaulted by the Web Bean manager:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:287 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:289 +#, no-c-format +msgid "" +"In this case, the name defaults to <literal>shoppingCart</literal>the " +"unqualified class name, with the first character changed to lowercase." +msgstr "" + +#. Tag: title +#: intro.xml:295 +#, no-c-format +msgid "Interceptor binding types" +msgstr "" + +#. Tag: para +#: intro.xml:297 +#, no-c-format +msgid "" +"Web Beans supports the interceptor functionality defined by EJB 3, not only " +"for EJB beans, but also for plain Java classes. In addition, Web Beans " +"provides a new approach to binding interceptors to EJB beans and other Web " +"Beans." +msgstr "" + +#. Tag: para +#: intro.xml:302 +#, no-c-format +msgid "" +"It remains possible to directly specify the interceptor class via use of the " +"<literal>@Interceptors</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:305 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped \n" +"@Interceptors(TransactionInterceptor.class)\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:307 +#, no-c-format +msgid "" +"However, it is more elegant, and better practice, to indirect the " +"interceptor binding through an <emphasis>interceptor binding type</emphasis>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:311 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:313 +#, no-c-format +msgid "" +"We'll discuss Web Beans interceptors and decorators in <xref linkend=" +"\"interceptors\"/> and <xref linkend=\"decorators\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:321 +#, no-c-format +msgid "What kinds of objects can be Web Beans?" +msgstr "" + +#. Tag: para +#: intro.xml:323 +#, no-c-format +msgid "" +"We've already seen that JavaBeans, EJBs and some other Java classes can be " +"Web Beans. But exactly what kinds of objects are Web Beans?" +msgstr "" + +#. Tag: title +#: intro.xml:327 +#, no-c-format +msgid "Simple Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:329 +#, no-c-format +msgid "" +"The Web Beans specification says that a concrete Java class is a " +"<emphasis>simple</emphasis> Web Bean if:" +msgstr "" + +#. Tag: para +#: intro.xml:334 +#, no-c-format +msgid "" +"it is not an EE container-managed component, like an EJB, a Servlet or a JPA " +"entity," +msgstr "" + +#. Tag: para +#: intro.xml:338 +#, no-c-format +msgid "it is not a non-static static inner class," +msgstr "" + +#. Tag: para +#: intro.xml:341 +#, no-c-format +msgid "it is not a parameterized type, and" +msgstr "" + +#. Tag: para +#: intro.xml:344 +#, no-c-format +msgid "" +"it has a constructor with no parameters, or a constructor annotated " +"<literal>@Initializer</literal>." +msgstr "" + +#. Tag: para +#: intro.xml:349 +#, no-c-format +msgid "Thus, almost every JavaBean is a simple Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:351 +#, no-c-format +msgid "" +"Every interface implemented directly or indirectly by a simple Web Bean is " +"an API type of the simple Web Bean. The class and its superclasses are also " +"API types." +msgstr "" + +#. Tag: title +#: intro.xml:358 +#, no-c-format +msgid "Enterprise Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:360 +#, no-c-format +msgid "" +"The specification says that all EJB 3-style session and singleton beans are " +"<emphasis>enterprise</emphasis> Web Beans. Message driven beans are not Web " +"Beanssince they are not intended to be injected into other " +"objectsbut they can take advantage of most of the functionality of Web " +"Beans, including dependency injection and interceptors." +msgstr "" + +#. Tag: para +#: intro.xml:366 +#, no-c-format +msgid "" +"Every local interface of an enterprise Web Bean that does not have a " +"wildcard type parameter or type variable, and every one of its " +"superinterfaces, is an API type of the enterprise Web Bean. If the EJB bean " +"has a bean class local view, the bean class, and every one of its " +"superclasses, is also an API type." +msgstr "" + +#. Tag: para +#: intro.xml:372 +#, no-c-format +msgid "" +"Stateful session beans should declare a remove method with no parameters or " +"a remove method annotated <literal>@Destructor</literal>. The Web Bean " +"manager calls this method to destroy the stateful session bean instance at " +"the end of its lifecycle. This method is called the <emphasis>destructor</" +"emphasis> method of the enterprise Web Bean." +msgstr "" + +#. Tag: programlisting +#: intro.xml:378 +#, no-c-format +msgid "" +"<![CDATA[@Stateful @SessionScoped\n" +"public class ShoppingCart {\n" +"\n" +" ...\n" +" \n" +" @Remove\n" +" public void destroy() {}\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:380 +#, no-c-format +msgid "" +"So when should we use an enterprise Web Bean instead of a simple Web Bean? " +"Well, whenever we need the advanced enterprise services offered by EJB, such " +"as:" +msgstr "" + +#. Tag: para +#: intro.xml:387 +#, no-c-format +msgid "method-level transaction management and security," +msgstr "" + +#. Tag: para +#: intro.xml:390 +#, no-c-format +msgid "concurrency management," +msgstr "" + +#. Tag: para +#: intro.xml:393 +#, no-c-format +msgid "" +"instance-level passivation for stateful session beans and instance-pooling " +"for stateless session beans," +msgstr "" + +#. Tag: para +#: intro.xml:397 +#, no-c-format +msgid "remote and web service invocation, and" +msgstr "" + +#. Tag: para +#: intro.xml:400 +#, no-c-format +msgid "timers and asynchronous methods," +msgstr "" + +#. Tag: para +#: intro.xml:404 +#, no-c-format +msgid "" +"we should use an enterprise Web Bean. When we don't need any of these " +"things, a simple Web Bean will serve just fine." +msgstr "" + +#. Tag: para +#: intro.xml:407 +#, no-c-format +msgid "" +"Many Web Beans (including any session or application scoped Web Bean) are " +"available for concurrent access. Therefore, the concurrency management " +"provided by EJB 3.1 is especially useful. Most session and application " +"scoped Web Beans should be EJBs." +msgstr "" + +#. Tag: para +#: intro.xml:412 +#, no-c-format +msgid "" +"Web Beans which hold references to heavy-weight resources, or hold a lot of " +"internal state benefit from the advanced container-managed lifecycle defined " +"by the EJB <literal>@Stateless</literal>/<literal>@Stateful</literal>/" +"<literal>@Singleton</literal> model, with its support for passivation and " +"instance pooling." +msgstr "" + +#. Tag: para +#: intro.xml:417 +#, no-c-format +msgid "" +"Finally, it's usually obvious when method-level transaction management, " +"method-level security, timers, remote methods or asynchronous methods are " +"needed." +msgstr "" + +#. Tag: para +#: intro.xml:420 +#, no-c-format +msgid "" +"It's usually easy to start with simple Web Bean, and then turn it into an " +"EJB, just by adding an annotation: <literal>@Stateless</literal>, " +"<literal>@Stateful</literal> or <literal>@Singleton</literal>." +msgstr "" + +#. Tag: title +#: intro.xml:427 +#, no-c-format +msgid "Producer methods" +msgstr "" + +#. Tag: para +#: intro.xml:429 +#, no-c-format +msgid "" +"A <emphasis>producer method</emphasis> is a method that is called by the Web " +"Bean manager to obtain an instance of the Web Bean when no instance exists " +"in the current context. A producer method lets the application take full " +"control of the instantiation process, instead of leaving instantiation to " +"the Web Bean manager. For example:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:435 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped\n" +"public class Generator {\n" +"\n" +" private Random random = new Random( System.currentTimeMillis() );\n" +" \n" +" @Produces @Random int next() {\n" +" return random.nextInt(100);\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:437 +#, no-c-format +msgid "" +"The result of a producer method is injected just like any other Web Bean." +msgstr "" + +#. Tag: programlisting +#: intro.xml:439 +#, no-c-format +msgid "<![CDATA[@Random int randomNumber]]>" +msgstr "" + +#. Tag: para +#: intro.xml:441 +#, no-c-format +msgid "" +"The method return type and all interfaces it extends/implements directly or " +"indirectly are API types of the producer method. If the return type is a " +"class, all superclasses are also API types." +msgstr "" + +#. Tag: para +#: intro.xml:445 +#, no-c-format +msgid "Some producer methods return objects that require explicit destruction:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:447 +#, no-c-format +msgid "" +"<![CDATA[@Produces @RequestScoped Connection connect(User user) {\n" +" return createConnection( user.getId(), user.getPassword() );\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:449 +#, no-c-format +msgid "" +"These producer methods may define matching <emphasis>disposal methods</" +"emphasis>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:451 +#, no-c-format +msgid "" +"<![CDATA[void close(@Disposes Connection connection) {\n" +" connection.close();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:453 +#, no-c-format +msgid "" +"This disposal method is called automatically by the Web Bean manager at the " +"end of the request." +msgstr "" + +#. Tag: para +#: intro.xml:456 +#, no-c-format +msgid "" +"We'll talk much more about producer methods in <xref linkend=" +"\"producermethods\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:461 +#, no-c-format +msgid "JMS endpoints" +msgstr "" + +#. Tag: para +#: intro.xml:463 +#, no-c-format +msgid "" +"Finally, a JMS queue or topic can be a Web Bean. Web Beans relieves the " +"developer from the tedium of managing the lifecycles of all the various JMS " +"objects required to send messages to queues and topics. We'll discuss JMS " +"endpoints in <xref linkend=\"jms\"/>." +msgstr "" Added: doc/trunk/reference/pot/modules/next.pot =================================================================== --- doc/trunk/reference/pot/modules/next.pot (rev 0) +++ doc/trunk/reference/pot/modules/next.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,50 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: next.xml:4 +#, no-c-format +msgid "Next steps" +msgstr "" + +#. Tag: para +#: next.xml:6 +#, no-c-format +msgid "" +"Because Web Beans is so new, there's not yet a lot of information available " +"online." +msgstr "" + +#. Tag: para +#: next.xml:9 +#, no-c-format +msgid "" +"Of course, the Web Beans specification is the best source of more " +"information about Web Beans. The spec is about 100 pages long, only twice " +"the length of this article, and almost as readable. But, of course, it " +"covers many details that we've skipped over. The spec is available from " +"<literal>http://jcp.org/en/jsr/detail?id=299</literal>." +msgstr "" + +#. Tag: para +#: next.xml:15 +#, no-c-format +msgid "" +"The Web Beans Reference implementation is being developed at <literal>http://" +"seamframework.org/WebBeans</literal>. The RI development team and the Web " +"Beans spec lead blog at <literal>http://in.relation.to</literal>. This " +"article is substantially based upon a series of blog entries published there." +msgstr "" Added: doc/trunk/reference/pot/modules/part1.pot =================================================================== --- doc/trunk/reference/pot/modules/part1.pot (rev 0) +++ doc/trunk/reference/pot/modules/part1.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,230 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part1.xml:5 +#, no-c-format +msgid "" +"The Web Beans (JSR-299) specification defines a set of services for the Java " +"EE environment that makes applications much easier to develop. Web Beans " +"layers an enhanced lifecycle and interaction model over existing Java " +"component types including JavaBeans and Enterprise Java Beans. As a " +"complement to the traditional Java EE programming model, the Web Beans " +"services provide:" +msgstr "" + +#. Tag: para +#: part1.xml:14 +#, no-c-format +msgid "" +"an improved lifecycle for stateful components, bound to well-defined " +"<emphasis>contexts</emphasis>," +msgstr "" + +#. Tag: para +#: part1.xml:18 +#, no-c-format +msgid "a typesafe approach to <emphasis>dependency injection</emphasis>," +msgstr "" + +#. Tag: para +#: part1.xml:21 +#, no-c-format +msgid "" +"interaction via an <emphasis>event notification</emphasis> facility, and" +msgstr "" + +#. Tag: para +#: part1.xml:25 +#, no-c-format +msgid "" +"a better approach to binding <emphasis>interceptors</emphasis> to " +"components, along with a new kind of interceptor, called a " +"<emphasis>decorator</emphasis>, that is more appropriate for use in solving " +"business problems." +msgstr "" + +#. Tag: para +#: part1.xml:32 +#, no-c-format +msgid "" +"Dependency injection, together with contextual lifecycle management, saves " +"the user of an unfamiliar API from having to ask and answer the following " +"questions:" +msgstr "" + +#. Tag: para +#: part1.xml:38 +#, no-c-format +msgid "what is the lifecycle of this object?" +msgstr "" + +#. Tag: para +#: part1.xml:41 +#, no-c-format +msgid "how many simultaneous clients can it have?" +msgstr "" + +#. Tag: para +#: part1.xml:44 +#, no-c-format +msgid "is it multithreaded?" +msgstr "" + +#. Tag: para +#: part1.xml:47 +#, no-c-format +msgid "where can I get one from?" +msgstr "" + +#. Tag: para +#: part1.xml:50 +#, no-c-format +msgid "do I need to explicitly destroy it?" +msgstr "" + +#. Tag: para +#: part1.xml:53 +#, no-c-format +msgid "where should I keep my reference to it when I'm not using it directly?" +msgstr "" + +#. Tag: para +#: part1.xml:57 +#, no-c-format +msgid "" +"how can I add an indirection layer, so that the implementation of this " +"object can vary at deployment time?" +msgstr "" + +#. Tag: para +#: part1.xml:61 +#, no-c-format +msgid "how should I go about sharing this object between other objects?" +msgstr "" + +#. Tag: para +#: part1.xml:65 +#, no-c-format +msgid "" +"A Web Bean specifies only the type and semantics of other Web Beans it " +"depends upon. It need not be aware of the actual lifecycle, concrete " +"implementation, threading model or other clients of any Web Bean it depends " +"upon. Even better, the concrete implementation, lifecycle and threading " +"model of a Web Bean it depends upon may vary according to the deployment " +"scenario, without affecting any client." +msgstr "" + +#. Tag: para +#: part1.xml:72 +#, no-c-format +msgid "" +"Events, interceptors and decorators enhance the <emphasis>loose-coupling</" +"emphasis> that is inherent in this model:" +msgstr "" + +#. Tag: para +#: part1.xml:77 +#, no-c-format +msgid "" +"<emphasis>event notifications</emphasis> decouple event producers from event " +"consumers," +msgstr "" + +#. Tag: para +#: part1.xml:81 +#, no-c-format +msgid "" +"<emphasis>interceptors</emphasis> decouple technical concerns from business " +"logic, and" +msgstr "" + +#. Tag: para +#: part1.xml:85 +#, no-c-format +msgid "" +"<emphasis>decorators</emphasis> allow business concerns to be " +"compartmentalized." +msgstr "" + +#. Tag: para +#: part1.xml:90 +#, no-c-format +msgid "" +"Most importantly, Web Beans provides all these facilities in a " +"<emphasis>typesafe</emphasis> way. Web Beans never uses string-based " +"identifiers to determine how collaborating objects fit together. And XML, " +"though it remains an option, is rarely used. Instead, Web Beans uses the " +"typing information that is already available in the Java object model, " +"together with a new pattern, called <emphasis>binding annotations</" +"emphasis>, to wire together Web Beans, their dependencies, their " +"interceptors and decorators and their event consumers." +msgstr "" + +#. Tag: para +#: part1.xml:100 +#, no-c-format +msgid "" +"The Web Beans services are general and apply to the following types of " +"components that exist in the Java EE environment:" +msgstr "" + +#. Tag: para +#: part1.xml:105 +#, no-c-format +msgid "all JavaBeans," +msgstr "" + +#. Tag: para +#: part1.xml:108 +#, no-c-format +msgid "all EJBs, and" +msgstr "" + +#. Tag: para +#: part1.xml:111 +#, no-c-format +msgid "all Servlets." +msgstr "" + +#. Tag: para +#: part1.xml:115 +#, no-c-format +msgid "" +"Web Beans even provides the necessary integration points so that other kinds " +"of components defined by future Java EE specifications or by non-standard " +"frameworks may be cleanly integrated with Web Beans, take advantage of the " +"Web Beans services, and interact with any other kind of Web Bean." +msgstr "" + +#. Tag: para +#: part1.xml:120 +#, no-c-format +msgid "" +"Web Beans was influenced by a number of existing Java frameworks, including " +"Seam, Guice and Spring. However, Web Beans has its own very distinct " +"character: more typesafe than Seam, more stateful and less XML-centric than " +"Spring, more web and enterprise-application capable than Guice." +msgstr "" + +#. Tag: para +#: part1.xml:125 +#, no-c-format +msgid "" +"Most importantly, Web Beans is a JCP standard that integrates cleanly with " +"Java EE, and with any Java SE environment where embeddable EJB Lite is " +"available." +msgstr "" Added: doc/trunk/reference/pot/modules/part2.pot =================================================================== --- doc/trunk/reference/pot/modules/part2.pot (rev 0) +++ doc/trunk/reference/pot/modules/part2.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,103 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part2.xml:5 +#, no-c-format +msgid "" +"The first major theme of Web Beans is <emphasis>loose coupling</emphasis>. " +"We've already seen three means of achieving loose coupling:" +msgstr "" + +#. Tag: para +#: part2.xml:10 +#, no-c-format +msgid "" +"<emphasis>deployment types</emphasis> enable deployment time polymorphism," +msgstr "" + +#. Tag: para +#: part2.xml:14 +#, no-c-format +msgid "<emphasis>producer methods</emphasis> enable runtime polymorphism, and" +msgstr "" + +#. Tag: para +#: part2.xml:18 +#, no-c-format +msgid "" +"<emphasis>contextual lifecycle management</emphasis> decouples Web Bean " +"lifecycles." +msgstr "" + +#. Tag: para +#: part2.xml:23 +#, no-c-format +msgid "" +"These techniques serve to enable loose coupling of client and server. The " +"client is no longer tightly bound to an implementation of an API, nor is it " +"required to manage the lifecycle of the server object. This approach lets " +"<emphasis>stateful objects interact as if they were services</emphasis>." +msgstr "" + +#. Tag: para +#: part2.xml:28 +#, no-c-format +msgid "" +"Loose coupling makes a system more <emphasis>dynamic</emphasis>. The system " +"can respond to change in a well-defined manner. In the past, frameworks that " +"attempted to provide the facilities listed above invariably did it by " +"sacrificing type safety. Web Beans is the first technology that achieves " +"this level of loose coupling in a typesafe way." +msgstr "" + +#. Tag: para +#: part2.xml:34 +#, no-c-format +msgid "" +"Web Beans provides three extra important facilities that further the goal of " +"loose coupling:" +msgstr "" + +#. Tag: para +#: part2.xml:39 +#, no-c-format +msgid "" +"<emphasis>interceptors</emphasis> decouple technical concerns from business " +"logic," +msgstr "" + +#. Tag: para +#: part2.xml:43 +#, no-c-format +msgid "" +"<emphasis>decorators</emphasis> may be used to decouple some business " +"concerns, and" +msgstr "" + +#. Tag: para +#: part2.xml:47 +#, no-c-format +msgid "" +"<emphasis>event notifications</emphasis> decouple event producers from event " +"consumers." +msgstr "" + +#. Tag: para +#: part2.xml:52 +#, no-c-format +msgid "Let's explore interceptors first." +msgstr "" Added: doc/trunk/reference/pot/modules/part3.pot =================================================================== --- doc/trunk/reference/pot/modules/part3.pot (rev 0) +++ doc/trunk/reference/pot/modules/part3.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,151 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part3.xml:5 +#, no-c-format +msgid "" +"The second major theme of Web Beans is <emphasis>strong typing</emphasis>. " +"The information about the dependencies, interceptors and decorators of a Web " +"Bean, and the information about event consumers for an event producer, is " +"contained in typesafe Java constructs that may be validated by the compiler." +msgstr "" + +#. Tag: para +#: part3.xml:10 +#, no-c-format +msgid "" +"You don't see string-based identifiers in Web Beans code, not because the " +"framework is hiding them from you using clever defaulting rulesso-" +"called \"configuration by convention\"but because there are simply no " +"strings there to begin with!" +msgstr "" + +#. Tag: para +#: part3.xml:15 +#, no-c-format +msgid "" +"The obvious benefit of this approach is that <emphasis>any</emphasis> IDE " +"can provide autocompletion, validation and refactoring without the need for " +"special tooling. But there is a second, less-immediately-obvious, benefit. " +"It turns out that when you start thinking of identifying objects, events or " +"interceptors via annotations instead of names, you have an opportunity to " +"lift the semantic level of your code." +msgstr "" + +#. Tag: para +#: part3.xml:21 +#, no-c-format +msgid "" +"Web Beans encourages you develop annotations that model concepts, for " +"example," +msgstr "" + +#. Tag: para +#: part3.xml:26 +#, no-c-format +msgid "<literal>@Asynchronous</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:29 +#, no-c-format +msgid "<literal>@Mock</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:32 +#, no-c-format +msgid "<literal>@Secure</literal> or" +msgstr "" + +#. Tag: para +#: part3.xml:35 +#, no-c-format +msgid "<literal>@Updated</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:39 +#, no-c-format +msgid "instead of using compound names like" +msgstr "" + +#. Tag: para +#: part3.xml:43 +#, no-c-format +msgid "<literal>asyncPaymentProcessor</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:46 +#, no-c-format +msgid "<literal>mockPaymentProcessor</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:49 +#, no-c-format +msgid "<literal>SecurityInterceptor</literal> or" +msgstr "" + +#. Tag: para +#: part3.xml:52 +#, no-c-format +msgid "<literal>DocumentUpdatedEvent</literal>." +msgstr "" + +#. Tag: para +#: part3.xml:56 +#, no-c-format +msgid "" +"The annotations are reusable. They help describe common qualities of " +"disparate parts of the system. They help us categorize and understand our " +"code. They help us deal with common concerns in a common way. They make our " +"code more literate and more understandable." +msgstr "" + +#. Tag: para +#: part3.xml:61 +#, no-c-format +msgid "" +"Web Beans <emphasis>stereotypes</emphasis> take this idea a step further. A " +"stereotype models a common <emphasis>role</emphasis> in your application " +"architecture. It encapsulates various properties of the role, including " +"scope, interceptor bindings, deployment type, etc, into a single reusable " +"package." +msgstr "" + +#. Tag: para +#: part3.xml:66 +#, no-c-format +msgid "" +"Even Web Beans XML metadata is strongly typed! There's no compiler for XML, " +"so Web Beans takes advantage of XML schemas to validate the Java types and " +"attributes that appear in XML. This approach turns out to make the XML more " +"literate, just like annotations made our Java code more literate." +msgstr "" + +#. Tag: para +#: part3.xml:71 +#, no-c-format +msgid "" +"We're now ready to meet some more advanced features of Web Beans. Bear in " +"mind that these features exist to make our code both easier to validate and " +"more understandable. Most of the time you don't ever really <emphasis>need</" +"emphasis> to use these features, but if you use them wisely, you'll come to " +"appreciate their power." +msgstr "" Added: doc/trunk/reference/pot/modules/part4.pot =================================================================== --- doc/trunk/reference/pot/modules/part4.pot (rev 0) +++ doc/trunk/reference/pot/modules/part4.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,53 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part4.xml:5 +#, no-c-format +msgid "" +"The third theme of Web Beans is <emphasis>integration</emphasis>. Web Beans " +"was designed to work in concert with other technologies, helping the " +"application developer fit the other technologies together. Web Beans is an " +"open technology. It forms a part of the Java EE ecosystem, and is itself the " +"foundation for a new ecosystem of portable extensions and integration with " +"existing frameworks and technologies." +msgstr "" + +#. Tag: para +#: part4.xml:12 +#, no-c-format +msgid "" +"We've already seen how Web Beans helps integrate EJB and JSF, allowing EJBs " +"to be bound directly to JSF pages. That's just the beginning. Web Beans " +"offers the same potential to diverse other technologies, such as Business " +"Process Management engines, other Web Frameworks, and third-party component " +"models. The Java EE platform will never be able to standardize all the " +"interesting technologies that are used in the world of Java application " +"development, but Web Beans makes it easier to use the technologies which are " +"not yet part of the platform seamlessly within the Java EE environment." +msgstr "" + +#. Tag: para +#: part4.xml:21 +#, no-c-format +msgid "" +"We're about to see how to take full advantage of the Java EE platform in an " +"application that uses Web Beans. We'll also briefly meet a set of SPIs that " +"are provided to support portable extensions to Web Beans. You might not ever " +"need to use these SPIs directly, but it's nice to know they are there if you " +"need them. Most importantly, you'll take advantage of them indirectly, every " +"time you use a third-party extension." +msgstr "" Added: doc/trunk/reference/pot/modules/producermethods.pot =================================================================== --- doc/trunk/reference/pot/modules/producermethods.pot (rev 0) +++ doc/trunk/reference/pot/modules/producermethods.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,247 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: producermethods.xml:5 +#, no-c-format +msgid "Producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:7 +#, no-c-format +msgid "" +"Producer methods let us overcome certain limitations that arise when the Web " +"Bean manager, instead of the application, is responsible for instantiating " +"objects. They're also the easiest way to integrate objects which are not Web " +"Beans into the Web Beans environment. (We'll meet a second approach in <xref " +"linkend=\"xml\"/>.)" +msgstr "" + +#. Tag: para +#: producermethods.xml:12 +#, no-c-format +msgid "According to the spec:" +msgstr "" + +#. Tag: chapter +#: producermethods.xml:12 +#, no-c-format +msgid "" +"<blockquote> <para>A Web Beans producer method acts as a source of objects " +"to be injected, where:</para> <itemizedlist> <listitem> <para>the objects to " +"be injected are not required to be instances of Web Beans,</para> </" +"listitem> <listitem> <para>the concrete type of the objects to be injected " +"may vary at runtime or</para> </listitem> <listitem> <para>the objects " +"require some custom initialization that is not performed by the Web Bean " +"constructor</para> </listitem> </itemizedlist> </blockquote> <para>For " +"example, producer methods let us:</para> <itemizedlist> <listitem> " +"<para>expose a JPA entity as a Web Bean,</para> </listitem> <listitem> " +"<para>expose any JDK class as a Web Bean,</para> </listitem> <listitem> " +"<para>define multiple Web Beans, with different scopes or initialization, " +"for the same implementation class, or</para> </listitem> <listitem> " +"<para>vary the implementation of an API type at runtime.</para> </listitem> " +"</itemizedlist> <para>In particular, producer methods let us use runtime " +"polymorphism with Web Beans. As we've seen, deployment types are a powerful " +"solution to the problem of deployment-time polymorphism. But once the system " +"is deployed, the Web Bean implementation is fixed. A producer method has no " +"such limitation:</para> <programlisting><![CDATA[@SessionScoped\n" +"public class Preferences {\n" +" \n" +" private PaymentStrategyType paymentStrategy;\n" +" \n" +" ...\n" +" \n" +" @Produces @Preferred \n" +" public PaymentStrategy getPaymentStrategy() {\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return new CreditCardPaymentStrategy();\n" +" case CHEQUE: return new ChequePaymentStrategy();\n" +" case PAYPAL: return new PayPalPaymentStrategy();\n" +" default: return null;\n" +" } \n" +" }\n" +" \n" +"}]]></programlisting> <para>Consider an injection point:</para> " +"<programlisting><![CDATA[@Preferred PaymentStrategy paymentStrat;]]></" +"programlisting> <para>This injection point has the same type and binding " +"annotations as the producer method, so it resolves to the producer method " +"using the usual Web Beans injection rules. The producer method will be " +"called by the Web Bean manager to obtain an instance to service this " +"injection point.</para>." +msgstr "" + +#. Tag: title +#: producermethods.xml:68 +#, no-c-format +msgid "Scope of a producer method" +msgstr "" + +#. Tag: para +#: producermethods.xml:70 +#, no-c-format +msgid "" +"The scope of the producer method defaults to <literal>@Dependent</literal>, " +"and so it will be called <emphasis>every time</emphasis> the Web Bean " +"manager injects this field or any other field that resolves to the same " +"producer method. Thus, there could be multiple instances of the " +"<literal>PaymentStrategy</literal> object for each user session." +msgstr "" + +#. Tag: para +#: producermethods.xml:75 +#, no-c-format +msgid "" +"To change this behavior, we can add a <literal>@SessionScoped</literal> " +"annotation to the method." +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:78 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy() {\n" +" ...\n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:80 +#, no-c-format +msgid "" +"Now, when the producer method is called, the returned " +"<literal>PaymentStrategy</literal> will be bound to the session context. The " +"producer method won't be called again in the same session." +msgstr "" + +#. Tag: title +#: producermethods.xml:87 +#, no-c-format +msgid "Injection into producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:89 +#, no-c-format +msgid "" +"There's one potential problem with the code above. The implementations of " +"<literal>CreditCardPaymentStrategy</literal> are instantiated using the Java " +"<literal>new</literal> operator. Objects instantiated directly by the " +"application can't take advantage of dependency injection and don't have " +"interceptors." +msgstr "" + +#. Tag: para +#: producermethods.xml:94 +#, no-c-format +msgid "" +"If this isn't what we want we can use dependency injection into the producer " +"method to obtain Web Bean instances:" +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:97 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy(CreditCardPaymentStrategy ccps,\n" +" ChequePaymentStrategy cps,\n" +" PayPalPaymentStrategy ppps) {\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return ccps;\n" +" case CHEQUE: return cps;\n" +" case PAYPAL: return ppps;\n" +" default: return null;\n" +" } \n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:99 +#, no-c-format +msgid "" +"Wait, what if <literal>CreditCardPaymentStrategy</literal> is a request " +"scoped Web Bean? Then the producer method has the effect of \"promoting\" " +"the current request scoped instance into session scope. This is almost " +"certainly a bug! The request scoped object will be destroyed by the Web Bean " +"manager before the session ends, but the reference to the object will be " +"left \"hanging\" in the session scope. This error will <emphasis>not</" +"emphasis> be detected by the Web Bean manager, so please take extra care " +"when returning Web Bean instances from producer methods!" +msgstr "" + +#. Tag: para +#: producermethods.xml:107 +#, no-c-format +msgid "" +"There's at least three ways we could go about fixing this bug. We could " +"change the scope of the <literal>CreditCardPaymentStrategy</literal> " +"implementation, but this would affect other clients of that Web Bean. A " +"better option would be to change the scope of the producer method to " +"<literal>@Dependent</literal> or <literal>@RequestScoped</literal>." +msgstr "" + +#. Tag: para +#: producermethods.xml:113 +#, no-c-format +msgid "" +"But a more common solution is to use the special <literal>@New</literal> " +"binding annotation." +msgstr "" + +#. Tag: title +#: producermethods.xml:119 +#, no-c-format +msgid "Use of <literal>@New</literal> with producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:121 +#, no-c-format +msgid "Consider the following producer method:" +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:123 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy(@New CreditCardPaymentStrategy " +"ccps,\n" +" @New ChequePaymentStrategy cps,\n" +" @New PayPalPaymentStrategy ppps) " +"{\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return ccps;\n" +" case CHEQUE: return cps;\n" +" case PAYPAL: return ppps;\n" +" default: return null;\n" +" } \n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:125 +#, no-c-format +msgid "" +"Then a new <emphasis>dependent</emphasis> instance of " +"<literal>CreditCardPaymentStrategy</literal> will be created, passed to the " +"producer method, returned by the producer method and finally bound to the " +"session context. The dependent object won't be destroyed until the " +"<literal>Preferences</literal> object is destroyed, at the end of the " +"session." +msgstr "" Added: doc/trunk/reference/pot/modules/ri.pot =================================================================== --- doc/trunk/reference/pot/modules/ri.pot (rev 0) +++ doc/trunk/reference/pot/modules/ri.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,899 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: ri.xml:4 +#, no-c-format +msgid "Using the Web Beans Reference Implementation" +msgstr "" + +#. Tag: para +#: ri.xml:6 +#, no-c-format +msgid "" +"The Web Beans RI comes with a two examples, <literal>webbeans-numberguess</" +"literal> (a war example, containing only simple beans) and <literal>webbeans-" +"translator</literal> (an ear example, containing enterprise beans)." +msgstr "" + +#. Tag: para +#: ri.xml:13 +#, no-c-format +msgid "" +"Currently, the Web Beans RI only runs on JBoss Application Server 5. You'll " +"need to download JBoss AS 5.0.0.GA from <ulink url=\"http://www.jboss.org/" +"jbossas/downloads/\">jboss.org</ulink>, and unzip it. For example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:20 +#, no-c-format +msgid "" +"<![CDATA[$ cd /Applications\n" +"$ unzip ~/jboss-5.0.0.GA.zip]]>" +msgstr "" + +#. Tag: para +#: ri.xml:22 +#, no-c-format +msgid "" +"Next, download the Web Beans RI from <ulink url=\"http://seamframework.org/" +"WebBeans\">seamframework.org</ulink>, and unzip it. For example" +msgstr "" + +#. Tag: programlisting +#: ri.xml:28 +#, no-c-format +msgid "" +"<![CDATA[$ cd ~/\n" +"$ unzip ~/webbeans-1.0.0.ALPHA1.zip]]>" +msgstr "" + +#. Tag: para +#: ri.xml:30 +#, no-c-format +msgid "" +"As Web Beans is a new piece of software, you need to update JBoss AS to run " +"the Web Beans RI. Future versions of JBoss AS will include these updates, " +"and this step won't be necessary." +msgstr "" + +#. Tag: para +#: ri.xml:37 +#, no-c-format +msgid "" +"Currently, two updates are needed. Firstly, a new deployer, " +"<literal>webbeans.deployer</literal> is added. This adds supports for Web " +"Bean archives to JBoss AS, and allows the Web Beans RI to query the EJB3 " +"container and discover which EJBs are installed in your application. " +"Secondly, an update to JBoss EJB3 is needed." +msgstr "" + +#. Tag: para +#: ri.xml:46 +#, no-c-format +msgid "" +"To install the update, you'll need ant 1.7.0 installed, and the " +"<literal>ANT_HOME</literal> environment variable set. For example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:51 +#, no-c-format +msgid "" +"$ unzip apache-ant-1.7.0.zip\n" +"$ export ANT_HOME=~/apache-ant-1.7.0" +msgstr "" + +#. Tag: para +#: ri.xml:53 +#, no-c-format +msgid "" +"Then, you can install the update. The update script will use Maven to " +"download the Web Beans and EJB3 automatically." +msgstr "" + +#. Tag: programlisting +#: ri.xml:58 +#, no-c-format +msgid "" +"$ cd webbeans-1.0.0.ALPHA1/jboss-as\n" +"$ ant update" +msgstr "" + +#. Tag: para +#: ri.xml:60 +#, no-c-format +msgid "Now, you're ready to deploy your first example!" +msgstr "" + +#. Tag: para +#: ri.xml:65 +#, no-c-format +msgid "" +"The build scripts for the examples offer a number of targets, these are:" +msgstr "" + +#. Tag: para +#: ri.xml:71 +#, no-c-format +msgid "<literal>ant restart</literal> - deploy the example in exploded format" +msgstr "" + +#. Tag: para +#: ri.xml:77 +#, no-c-format +msgid "" +"<literal>ant explode</literal> - update an exploded example, without " +"restarting the deployment" +msgstr "" + +#. Tag: para +#: ri.xml:83 +#, no-c-format +msgid "" +"<literal>ant deploy</literal> - deploy the example in compressed jar format" +msgstr "" + +#. Tag: para +#: ri.xml:88 +#, no-c-format +msgid "<literal>ant undeploy</literal> - remove the example from the server" +msgstr "" + +#. Tag: para +#: ri.xml:93 +#, no-c-format +msgid "<literal>ant clean</literal> - clean the example" +msgstr "" + +#. Tag: para +#: ri.xml:100 +#, no-c-format +msgid "To deploy the numberguess example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:104 +#, no-c-format +msgid "" +"$ cd examples/numberguess\n" +"ant deploy" +msgstr "" + +#. Tag: para +#: ri.xml:106 +#, no-c-format +msgid "" +"Wait for the application to deploy, and enjoy hours of fun at <ulink url=" +"\"http://localhost:8080/webbeans-numberguess\"></ulink>!" +msgstr "" + +#. Tag: para +#: ri.xml:111 +#, no-c-format +msgid "" +"The Web Beans RI includes a second simple example that will translate your " +"text into Latin. The numberguess example is a war example, and uses only " +"simple beans; the translator example is an ear example, and includes " +"enterprise beans, packaged in an EJB module. To try it out:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:118 +#, no-c-format +msgid "" +"$ cd examples/traslator\n" +"ant deploy" +msgstr "" + +#. Tag: para +#: ri.xml:120 +#, no-c-format +msgid "" +"Wait for the application to deploy, and visit <ulink url=\"http://" +"localhost:8080/webbeans-translator\"></ulink>!" +msgstr "" + +#. Tag: title +#: ri.xml:126 +#, no-c-format +msgid "The numberguess example" +msgstr "" + +#. Tag: para +#: ri.xml:128 +#, no-c-format +msgid "" +"In the numberguess application you get given 10 attempts to guess a number " +"between 1 and 100. After each attempt, you will be told whether you are too " +"high, or too low." +msgstr "" + +#. Tag: para +#: ri.xml:134 +#, no-c-format +msgid "" +"The numberguess example is comprised of a number of Web Beans, configuration " +"files, and Facelet JSF pages, packaged as a war. Let's start with the " +"configuration files." +msgstr "" + +#. Tag: para +#: ri.xml:140 +#, no-c-format +msgid "" +"All the configuration files for this example are located in <literal>WEB-INF/" +"</literal>, which is stored in <literal>WebContent</literal> in the source " +"tree. First, we have <literal>faces-config.xml</literal>, in which we tell " +"JSF to use Facelets:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:148 +#, no-c-format +msgid "" +"<![CDATA[<?xml version='1.0' encoding='UTF-8'?>\n" +"<faces-config version=\"1.2\"\n" +" xmlns=\"http://java.sun.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://" +"java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd\">\n" +" \n" +" <application>\n" +" <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>\n" +" </application>\n" +"\n" +"</faces-config>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:150 +#, no-c-format +msgid "" +"There is an empty <literal>web-beans.xml</literal> file, which marks this " +"application as a Web Beans application." +msgstr "" + +#. Tag: para +#: ri.xml:155 +#, no-c-format +msgid "Finally there is <literal>web.xml</literal>:" +msgstr "" + +#. Tag: section +#: ri.xml:157 +#, no-c-format +msgid "" +"<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> " +"<area id=\"faces.servlet.mapping\" coords=\"18\"/> <area id=\"faces.default." +"suffix\" coords=\"23\"/> <area id=\"session.timeout\" coords=\"28\"/> <area " +"id=\"webbeans.listener\" coords=\"32\"/> </areaspec> <programlisting><![CDATA" +"[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"\n" +"<web-app version=\"2.5\"\n" +" xmlns=\"http://java.sun.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun." +"com/xml/ns/javaee/web-app_2_5.xsd\">\n" +" \n" +" <display-name>Web Beans Numbergues example</display-name>\n" +"\n" +" \n" +"\n" +" <servlet>\n" +" <servlet-name>Faces Servlet</servlet-name>\n" +" <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>\n" +" <load-on-startup>1</load-on-startup>\n" +" </servlet>\n" +"\n" +" <servlet-mapping>\n" +" <servlet-name>Faces Servlet</servlet-name>\n" +" <url-pattern>*.jsf</url-pattern>\n" +" </servlet-mapping>\n" +" \n" +" <context-param>\n" +" <param-name>javax.faces.DEFAULT_SUFFIX</param-name>\n" +" <param-value>.xhtml</param-value>\n" +" </context-param>\n" +"\n" +" <session-config>\n" +" <session-timeout>10</session-timeout>\n" +" </session-config>\n" +" \n" +" <listener>\n" +" <listener-class>org.jboss.webbeans.servlet.WebBeansListener</listener-" +"class>\n" +" </listener>\n" +"\n" +"</web-app>]]></programlisting> <calloutlist> <callout arearefs=\"faces." +"servlet\"> <para> Enable and load the JSF servlet </para> </callout> " +"<callout arearefs=\"faces.servlet.mapping\"> <para> Configure requests to " +"<literal>.jsf</literal> pages to be handled by JSF </para> </callout> " +"<callout arearefs=\"faces.default.suffix\"> <para> Tell JSF that we will be " +"giving our source files (facelets) an extension of <literal>.jsf</literal> </" +"para> </callout> <callout arearefs=\"session.timeout\"> <para> Configure a " +"session timeout of 10 minutes </para> </callout> <callout arearefs=" +"\"webbeans.listener\"> <para> Configure the Web Beans listener, so that Web " +"Beans services can be used in the servlet request </para> </callout> </" +"calloutlist> </programlistingco> <note> <para> The only configuration " +"required by the Web Beans RI in <literal>web.xml</literal> is to add the Web " +"Beans listener. </para> <para> Whilst this demo is a JSF demo, you can use " +"the Web Beans RI with any Servlet based web framework; just configure the " +"Web Beans listener. </para> </note> <para> Let's take a look at the Facelet " +"view: </para> <programlistingco> <areaspec> <area id=\"template\" coords=\"8" +"\"/> <area id=\"messages\" coords=\"12\"/> <area id=\"instructions\" coords=" +"\"19\"/> <area id=\"guess\" coords=\"25\"/> <area id=\"validator\" coords=" +"\"29\"/> <area id=\"submit\" coords=\"32\"/> </areaspec> <programlisting><!" +"[CDATA[<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" " +"\"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\n" +"<html xmlns=\"http://www.w3.org/1999/xhtml\"\n" +" xmlns:ui=\"http://java.sun.com/jsf/facelets\"\n" +" xmlns:h=\"http://java.sun.com/jsf/html\"\n" +" xmlns:f=\"http://java.sun.com/jsf/core\"\n" +" xmlns:s=\"http://jboss.com/products/seam/taglib\">\n" +"\n" +" <ui:composition template=\"template.xhtml\">\n" +" <ui:define name=\"content\">\n" +" <h1>Guess a number...</h1>\n" +" <h:form id=\"NumberGuessMain\">\n" +" <div style=\"color: red\">\n" +" <h:messages id=\"messages\" globalOnly=\"false\"/>\n" +" <h:outputText id=\"Higher\" value=\"Higher!\" rendered=\"#{game." +"number gt game.guess}\"/>\n" +" <h:outputText id=\"Lower\" value=\"Lower!\" rendered=\"#{game." +"number lt game.guess}\"/>\n" +" </div>\n" +" \n" +" <div>\n" +" I'm thinking of a number between #{game.smallest} and #{game." +"biggest}.\n" +" You have #{game.remainingGuesses} guesses.\n" +" </div>\n" +" \n" +" <div>\n" +" Your guess: \n" +" <h:inputText id=\"inputGuess\" \n" +" value=\"#{game.guess}\" \n" +" required=\"true\" \n" +" size=\"3\">\n" +" <f:validateLongRange maximum=\"#{game.biggest}\" \n" +" minimum=\"#{game.smallest}\"/>\n" +" </h:inputText>\n" +" <h:commandButton id=\"GuessButton\" \n" +" value=\"Guess\" \n" +" action=\"#{game.check}\"/>\n" +" </div>\n" +" \n" +" </h:form>\n" +" </ui:define>\n" +" </ui:composition>\n" +"</html>]]></programlisting> <calloutlist> <callout arearefs=\"template\"> " +"<para> Facelets is a templating language for JSF, here we are wrapping our " +"page in a template which defines the header. </para> </callout> <callout " +"arearefs=\"messages\"> <para> There are a number of messages which can be " +"sent to the user, \"Higher!\", \"Lower!\" and \"Correct!\" </para> </" +"callout> <callout arearefs=\"instructions\"> <para> As the user guesses, the " +"range of numbers they can guess gets smaller - this sentance changes to make " +"sure they know what range to guess in. </para> </callout> <callout arearefs=" +"\"guess\"> <para> This input field is bound to a Web Bean, using the value " +"expression. </para> </callout> <callout arearefs=\"validator\"> <para> A " +"range validator is used to make sure the user doesn't accidentally input a " +"number outside of the range in which they can guess - if the validator " +"wasn't here, the user might use up a guess on an out of range number. </" +"para> </callout> <callout arearefs=\"submit\"> <para> And, of course, there " +"must be a way for the user to send their guess to the server. Here we bind " +"to an action method on the Web Bean. </para> </callout> </calloutlist> </" +"programlistingco>" +msgstr "" + +#. Tag: para +#: ri.xml:270 +#, no-c-format +msgid "" +"The example exists of 4 classes, the first two of which are binding types. " +"First, there is the <literal>@Random</literal> binding type, used for " +"injecting a random number:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:276 +#, no-c-format +msgid "" +"<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" +"@Retention(RUNTIME)\n" +"@Documented\n" +"@BindingType\n" +"public @interface Random {}]]>" +msgstr "" + +#. Tag: para +#: ri.xml:278 +#, no-c-format +msgid "" +"There is also the <literal>@MaxNumber</literal> binding type, used for " +"injecting the maximum number that can be injected:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:283 +#, no-c-format +msgid "" +"<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" +"@Retention(RUNTIME)\n" +"@Documented\n" +"@BindingType\n" +"public @interface MaxNumber {}\n" +"]]>" +msgstr "" + +#. Tag: para +#: ri.xml:285 +#, no-c-format +msgid "" +"The <literal>Generator</literal> class is responsible for creating the " +"random number, via a producer method. It also exposes the maximum possible " +"number via a producer method:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:291 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped\n" +"public class Generator {\n" +" \n" +" private java.util.Random random = new java.util.Random( System." +"currentTimeMillis() );\n" +" \n" +" private int maxNumber = 100;\n" +" \n" +" java.util.Random getRandom()\n" +" {\n" +" return random;\n" +" }\n" +" \n" +" @Produces @Random int next() { \n" +" return getRandom().nextInt(maxNumber); \n" +" }\n" +" \n" +" @Produces @MaxNumber int getMaxNumber()\n" +" {\n" +" return maxNumber;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: ri.xml:293 +#, no-c-format +msgid "" +"You'll notice that the <literal>Generator</literal> is application scoped; " +"therefore we don't get a different random each time." +msgstr "" + +#. Tag: para +#: ri.xml:298 +#, no-c-format +msgid "" +"The final Web Bean in the application is the session scoped <literal>Game</" +"literal>. By making <literal>Game</literal> session scoped, you can only " +"play the game once per browser session. You could easily add a reset button " +"- a good exercise for the reader :-)" +msgstr "" + +#. Tag: para +#: ri.xml:305 +#, no-c-format +msgid "" +"You'll also note that we've used the <literal>@Named</literal> annotation, " +"so that we can use the bean through EL in the JSF page. Finally, we've used " +"constructor injection to initialize the game with a random number. And of " +"course, we need to tell the player when they've won, so we give feedback " +"with a <literal>FacesMessage</literal>." +msgstr "" + +#. Tag: programlisting +#: ri.xml:313 +#, no-c-format +msgid "" +"<![CDATA[@Named\n" +"@SessionScoped\n" +"public class Game {\n" +" private int number;\n" +" \n" +" private int guess;\n" +" private int smallest;\n" +" private int biggest;\n" +" private int remainingGuesses;\n" +" \n" +" public Game() {}\n" +" \n" +" @Initializer\n" +" Game(@Random int number, @MaxNumber int maxNumber) {\n" +" this.number = number;\n" +" this.smallest = 1;\n" +" this.biggest = maxNumber;\n" +" this.remainingGuesses = 10;\n" +" }\n" +"\n" +" // Getters and setters for fields\n" +" \n" +" public String check() {\n" +" if (guess>number) {\n" +" biggest = guess - 1;\n" +" }\n" +" if (guess<number) {\n" +" smallest = guess + 1;\n" +" }\n" +" if (guess == number) {\n" +" FacesContext.getCurrentInstance().addMessage(null, new FacesMessage" +"(\"Correct!\"));\n" +" }\n" +" remainingGuesses--;\n" +" return null;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: title +#: ri.xml:317 +#, no-c-format +msgid "The translator example" +msgstr "" + +#. Tag: para +#: ri.xml:319 +#, no-c-format +msgid "" +"The translator example will take any sentences you enter, and translate them " +"to Latin." +msgstr "" + +#. Tag: para +#: ri.xml:324 +#, no-c-format +msgid "" +"The translator example is built as an ear, and contains EJBs and enterprise " +"beans. As a result, it's structure is more complex than the numberguess " +"example." +msgstr "" + +#. Tag: para +#: ri.xml:331 +#, no-c-format +msgid "" +"EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will make " +"this structure much simpler!" +msgstr "" + +#. Tag: para +#: ri.xml:337 +#, no-c-format +msgid "" +"First, let's take a look at the ear aggregator, which is located in " +"<literal>webbeans-translator-ear</literal> module. Maven automatically " +"generates the <literal>application.xml</literal> and <literal>jboss-app.xml</" +"literal> for us:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:344 +#, no-c-format +msgid "" +"<![CDATA[<plugin>\n" +" <groupId>org.apache.maven.plugins</groupId>\n" +" <artifactId>maven-ear-plugin</artifactId>\n" +" <configuration>\n" +" <modules>\n" +" <webModule>\n" +" <groupId>org.jboss.webbeans.examples.translator</groupId>\n" +" <artifactId>webbeans-translator-war</artifactId>\n" +" <contextRoot>/webbeans-translator</contextRoot>\n" +" </webModule>\n" +" </modules>\n" +" <jboss>\n" +" <loader-repository>webbeans.jboss.org:loader=webbeans-translator</" +"loader-repository>\n" +" </jboss>\n" +" </configuration>\n" +"</plugin>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:346 +#, no-c-format +msgid "" +"We're doing a couple of things here - firstly we set the context path, which " +"gives us a nice url (<ulink url=\"http://localhost:8080/webbeans-translator" +"\">http://localhost:8080/webbeans-translator</ulink>) and we also enable " +"class loader isolation for JBoss AS." +msgstr "" + +#. Tag: para +#: ri.xml:354 +#, no-c-format +msgid "" +"If you aren't using Maven to generate these files, you would need " +"<literal>META-INF/jboss-app.xml</literal>:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:359 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<!DOCTYPE jboss-app\n" +" PUBLIC \"-//JBoss//DTD J2EE Application 4.2//EN\"\n" +" \"http://www.jboss.org/j2ee/dtd/jboss-app_4_2.dtd\">\n" +"<jboss-app>\n" +" <loader-repository>webbeans.jboss.org:loader=webbeans-translator</loader-" +"repository>\n" +"</jboss-app>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:361 +#, no-c-format +msgid "and <literal>META-INF/application.xml</literal>:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:365 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<application xmlns=\"http://java.sun.com/xml/ns/javaee\" \n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://" +"java.sun.com/xml/ns/javaee/application_5.xsd\"\n" +" version=\"5\">\n" +" <display-name>webbeans-translator-ear</display-name>\n" +" <description>Ear Example for the reference implementation of JSR 299: Web " +"Beans</description>\n" +" \n" +" <module>\n" +" <web>\n" +" <web-uri>webbeans-translator.war</web-uri>\n" +" <context-root>/webbeans-translator</context-root>\n" +" </web>\n" +" </module>\n" +" <module>\n" +" <ejb>webbeans-translator.jar</ejb>\n" +" </module>\n" +"</application>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:368 +#, no-c-format +msgid "" +"Next, lets look at the war. Just as in the numberguess example, we have a " +"<literal>faces-config.xml</literal> (to enabled Facelets) and a <literal>web." +"xml</literal> (to enable JSF and attach Web Beans services to the servlet " +"container) in <literal>WebContent/WEB-INF</literal>." +msgstr "" + +#. Tag: para +#: ri.xml:375 +#, no-c-format +msgid "" +"More intersting is the facelet used to translate text. Just as in the " +"numberguess example we have a template, which surrounds the form (ommitted " +"here for brevity):" +msgstr "" + +#. Tag: programlisting +#: ri.xml:381 +#, no-c-format +msgid "" +"<![CDATA[<h:form id=\"NumberGuessMain\">\n" +" \n" +" <table>\n" +" <tr align=\"center\" style=\"font-weight: bold\" >\n" +" <td>\n" +" Your text\n" +" </td>\n" +" <td>\n" +" Translation\n" +" </td>\n" +" </tr>\n" +" <tr>\n" +" <td>\n" +" <h:inputTextarea id=\"text\" value=\"#{translator.text}\" " +"required=\"true\" rows=\"5\" cols=\"80\" />\n" +" </td>\n" +" <td>\n" +" <h:outputText value=\"#{translator.translatedText}\" />\n" +" </td>\n" +" </tr>\n" +" </table>\n" +" <div>\n" +" <h:commandButton id=\"button\" value=\"Translate\" action=\"#" +"{translator.translate}\"/>\n" +" </div>\n" +" \n" +"</h:form>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:383 +#, no-c-format +msgid "" +"The user can enter some text in the lefthand textarea, and hit the translate " +"button to see the result to the right." +msgstr "" + +#. Tag: para +#: ri.xml:388 +#, no-c-format +msgid "" +"Finally, let's look at the ejb module, <literal>webbeans-translator-ejb</" +"literal>. There are two configuration files in <literal>src/main/resources/" +"META-INF</literal>, an empty <literal>web-beans.xml</literal>, used to mark " +"the archive as containing Web Beans, and <literal>ejb-jar.xml</literal>. Web " +"Beans provides injection and initializtion services for all EJBs, and uses " +"<literal>ejb-jar.xml</literal> to enable this, you'll need this in any EJB " +"project which uses Web Beans:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:400 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar xmlns=\"http://java.sun.com/xml/ns/javaee\" \n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" \n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java." +"sun.com/xml/ns/javaee/ejb-jar_3_0.xsd\"\n" +" version=\"3.0\">\n" +" \n" +" <interceptors>\n" +" <interceptor>\n" +" <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</" +"interceptor-class>\n" +" </interceptor>\n" +" </interceptors>\n" +" \n" +" <assembly-descriptor>\n" +" <interceptor-binding>\n" +" <ejb-name>*</ejb-name>\n" +" <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</" +"interceptor-class>\n" +" </interceptor-binding>\n" +" </assembly-descriptor>\n" +" \n" +"</ejb-jar>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:402 +#, no-c-format +msgid "" +"We've saved the most interesting bit to last, the code! The project has two " +"simple beans, <literal>SentanceParser</literal> and <literal>TextTranslator</" +"literal> and two enterprise beans, <literal>TanslatorControllerBean</" +"literal> and <literal>SentenceTranslator</literal>. You should be getting " +"quite familiar with what a Web Bean looks like by now, so we'll just " +"highlight the most interesting bits here." +msgstr "" + +#. Tag: para +#: ri.xml:412 +#, no-c-format +msgid "" +"Both <literal>SentanceParser</literal> and <literal>TextTranslator</literal> " +"are dependent beans, and <literal>TextTranslator</literal> uses constructor " +"initialization:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:418 +#, no-c-format +msgid "" +"<![CDATA[public class TextTranslator { \n" +" private SentenceParser sentenceParser; \n" +" private Translator sentenceTranslator; \n" +" \n" +" @Initializer\n" +" TextTranslator(SentenceParser sentenceParser, Translator " +"sentenceTranslator) \n" +" { \n" +" this.sentenceParser = sentenceParser; \n" +" this.sentenceTranslator = sentenceTranslator;]]>" +msgstr "" + +#. Tag: para +#: ri.xml:420 +#, no-c-format +msgid "" +"<literal>TextTranslator</literal> is a stateless bean (with a local business " +"interface), where the magic happens - of course, we couldn't develop a full " +"translator, but we gave it a good go!" +msgstr "" + +#. Tag: para +#: ri.xml:426 +#, no-c-format +msgid "" +"Finally, there is UI orientated controller, that collects the text from the " +"user, and dispatches it to the translator. This is a request scoped, named, " +"stateful session bean, which injects the translator." +msgstr "" + +#. Tag: programlisting +#: ri.xml:432 +#, no-c-format +msgid "" +"<![CDATA[@Stateful\n" +"@RequestScoped\n" +"@Named(\"translator\")\n" +"public class TranslatorControllerBean implements TranslatorController\n" +"{\n" +" \n" +" @Current TextTranslator translator;]]>" +msgstr "" + +#. Tag: para +#: ri.xml:434 +#, no-c-format +msgid "The bean also has getters and setters for all the fields on the page." +msgstr "" + +#. Tag: para +#: ri.xml:438 +#, no-c-format +msgid "As this is a stateful session bean, we have to have a remove method:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:442 +#, no-c-format +msgid "" +"<![CDATA[ @Remove\n" +" public void remove()\n" +" {\n" +" \n" +" }]]>" +msgstr "" + +#. Tag: para +#: ri.xml:444 +#, no-c-format +msgid "" +"The Web Beans manager will call the remove method for you when the bean is " +"destroyed; in this case at the end of the request." +msgstr "" + +#. Tag: para +#: ri.xml:450 +#, no-c-format +msgid "" +"That concludes our short tour of the Web Beans RI examples. For more on the " +"RI, or to help out, please visit <ulink url=\"http://www.seamframework.org/" +"WebBeans/Development\">http://www.seamframework.org/WebBeans/Development</" +"ulink>." +msgstr "" + +#. Tag: para +#: ri.xml:456 +#, no-c-format +msgid "" +"We need help in all areas - bug fixing, writing new features, writing " +"examples and translating this reference guide." +msgstr "" Added: doc/trunk/reference/pot/modules/scopescontexts.pot =================================================================== --- doc/trunk/reference/pot/modules/scopescontexts.pot (rev 0) +++ doc/trunk/reference/pot/modules/scopescontexts.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,583 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: scopescontexts.xml:4 +#, no-c-format +msgid "Scopes and contexts" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:6 +#, no-c-format +msgid "" +"So far, we've seen a few examples of <emphasis>scope type annotations</" +"emphasis>. The scope of a Web Bean determines the lifecycle of instances of " +"the Web Bean. The scope also determines which clients refer to which " +"instances of the Web Bean. According to the Web Beans specification, a scope " +"determines:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:14 +#, no-c-format +msgid "When a new instance of any Web Bean with that scope is created" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:17 +#, no-c-format +msgid "When an existing instance of any Web Bean with that scope is destroyed" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:20 +#, no-c-format +msgid "" +"Which injected references refer to any instance of a Web Bean with that scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:25 +#, no-c-format +msgid "" +"For example, if we have a session scoped Web Bean, <literal>CurrentUser</" +"literal>, all Web Beans that are called in the context of the same " +"<literal>HttpSession</literal> will see the same instance of " +"<literal>CurrentUser</literal>. This instance will be automatically created " +"the first time a <literal>CurrentUser</literal> is needed in that session, " +"and automatically destroyed when the session ends." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:32 +#, no-c-format +msgid "Scope types" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:34 +#, no-c-format +msgid "" +"Web Beans features an <emphasis>extensible context model</emphasis>. It is " +"possible to define new scopes by creating a new scope type annotation:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:37 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD})\n" +"@ScopeType\n" +"public @interface ClusterScoped {}]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:39 +#, no-c-format +msgid "" +"Of course, that's the easy part of the job. For this scope type to be " +"useful, we will also need to define a <literal>Context</literal> object that " +"implements the scope! Implementing a <literal>Context</literal> is usually a " +"very technical task, intended for framework development only." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:44 +#, no-c-format +msgid "" +"We can apply a scope type annotation to a Web Bean implementation class to " +"specify the scope of the Web Bean:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:47 +#, no-c-format +msgid "" +"<![CDATA[@ClusterScoped\n" +"public class SecondLevelCache { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:58 +#, no-c-format +msgid "Usually, you'll use one of Web Beans' built-in scopes." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:63 +#, no-c-format +msgid "Built-in scopes" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:65 +#, no-c-format +msgid "Web Beans defines four built-in scopes:" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:69 +#, no-c-format +msgid "@RequestScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:72 +#, no-c-format +msgid "@SessionScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:75 +#, no-c-format +msgid "@ApplicationScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:78 +#, no-c-format +msgid "@ConversationScoped" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:82 +#, no-c-format +msgid "For a web application that uses Web Beans:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:86 +#, no-c-format +msgid "" +"any servlet request has access to active request, session and application " +"scopes, and, additionally" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:90 +#, no-c-format +msgid "any JSF request has access to an active conversation scope." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:94 +#, no-c-format +msgid "The request and application scopes are also active:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:98 +#, no-c-format +msgid "during invocations of EJB remote methods," +msgstr "" + +#. Tag: para +#: scopescontexts.xml:101 +#, no-c-format +msgid "during EJB timeouts," +msgstr "" + +#. Tag: para +#: scopescontexts.xml:104 +#, no-c-format +msgid "during message delivery to a message-driven bean, and" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:107 +#, no-c-format +msgid "during web service invocations." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:111 +#, no-c-format +msgid "" +"If the application tries to invoke a Web Bean with a scope that does not " +"have an active context, a <literal>ContextNotActiveException</literal> is " +"thrown by the Web Bean manager at runtime." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:115 +#, no-c-format +msgid "" +"Three of the four built-in scopes should be extremely familiar to every Java " +"EE developer, so let's not waste time discussing them here. One of the " +"scopes, however, is new." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:122 +#, no-c-format +msgid "The conversation scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:124 +#, no-c-format +msgid "" +"The Web Beans conversation scope is a bit like the traditional session scope " +"in that it holds state associated with a user of the system, and spans " +"multiple requests to the server. However, unlike the session scope, the " +"conversation scope:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:130 +#, no-c-format +msgid "is demarcated explicitly by the application, and" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:133 +#, no-c-format +msgid "" +"holds state associated with a particular web browser tab in a JSF " +"application." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:138 +#, no-c-format +msgid "" +"A conversation represents a task, a unit of work from the point of view of " +"the user. The conversation context holds state associated with what the user " +"is currently working on. If the user is doing multiple things at the same " +"time, there are multiple conversations." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:143 +#, no-c-format +msgid "" +"The conversation context is active during any JSF request. However, most " +"conversations are destroyed at the end of the request. If a conversation " +"should hold state across multiple requests, it must be explicitly promoted " +"to a <emphasis>long-running conversation</emphasis>." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:149 +#, no-c-format +msgid "Conversation demarcation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:151 +#, no-c-format +msgid "" +"Web Beans provides a built-in Web Bean for controlling the lifecyle of " +"conversations in a JSF application. This Web Bean may be obtained by " +"injection:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:154 +#, no-c-format +msgid "@Current Conversation conversation;" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:156 +#, no-c-format +msgid "" +"To promote the conversation associated with the current request to a long-" +"running conversation, call the <literal>begin()</literal> method from " +"application code. To schedule the current long-running conversation context " +"for destruction at the end of the current request, call <literal>end()</" +"literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:161 +#, no-c-format +msgid "" +"In the following example, a conversation-scoped Web Bean controls the " +"conversation with which it is associated:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:164 +#, no-c-format +msgid "" +"@ConversationScoped @Stateful\n" +"public class OrderBuilder {\n" +"\n" +" private Order order;\n" +" private @Current Conversation conversation;\n" +" private @PersistenceContext(type=EXTENDED) EntityManager em;\n" +" \n" +" @Produces public Order getOrder() {\n" +" return order;\n" +" }\n" +"\n" +" public Order createOrder() {\n" +" order = new Order();\n" +" conversation.begin();\n" +" return order;\n" +" }\n" +" \n" +" public void addLineItem(Product product, int quantity) {\n" +" order.add( new LineItem(product, quantity) );\n" +" }\n" +"\n" +" public void saveOrder(Order order) {\n" +" em.persist(order);\n" +" conversation.end();\n" +" }\n" +" \n" +" @Remove\n" +" public void destroy() {}\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:166 +#, no-c-format +msgid "" +"This Web Bean is able to control its own lifecycle through use of the " +"<literal>Conversation</literal> API. But some other Web Beans have a " +"lifecycle which depends completely upon another object." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:173 +#, no-c-format +msgid "Conversation propagation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:175 +#, no-c-format +msgid "" +"The conversation context automatically propagates with any JSF faces request " +"(JSF form submission). It does not automatically propagate with non-faces " +"requests, for example, navigation via a link." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:179 +#, no-c-format +msgid "" +"We can force the conversation to propagate with a non-faces request by " +"including the unique identifier of the conversation as a request parameter. " +"The Web Beans specification reserves the request parameter named " +"<literal>cid</literal> for this use. The unique identifier of the " +"conversation may be obtained from the <literal>Conversation</literal> " +"object, which has the Web Beans name <literal>conversation</literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:186 +#, no-c-format +msgid "Therefore, the following link propagates the conversation:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:188 +#, no-c-format +msgid "" +"<![CDATA[<a href=\"/addProduct.jsp?cid=#{conversation.id}\">Add Product</a>]]" +">" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:190 +#, no-c-format +msgid "" +"The Web Bean manager is also required to propagate conversations across any " +"redirect, even if the conversation is not marked long-running. This makes it " +"very easy to implement the common POST-then-redirect pattern, without resort " +"to fragile constructs such as a \"flash\" object. In this case, the Web Bean " +"manager automatically adds a request parameter to the redirect URL." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:200 +#, no-c-format +msgid "Conversation timeout" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:202 +#, no-c-format +msgid "" +"The Web Bean manager is permitted to destroy a conversation and all state " +"held in its context at any time in order to preserve resources. A Web Bean " +"manager implementation will normally do this on the basis of some kind of " +"timeoutthough this is not required by the Web Beans specification. The " +"timeout is the period of inactivity before the conversation is destroyed." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:208 +#, no-c-format +msgid "" +"The <literal>Conversation</literal> object provides a method to set the " +"timeout. This is a hint to the Web Bean manager, which is free to ignore the " +"setting." +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:212 +#, no-c-format +msgid "conversation.setTimeout(timeoutInMillis);" +msgstr "" + +#. Tag: title +#: scopescontexts.xml:219 +#, no-c-format +msgid "The dependent pseudo-scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:221 +#, no-c-format +msgid "" +"In addition to the four built-in scopes, Web Beans features the so-called " +"<emphasis>dependent pseudo-scope</emphasis>. This is the default scope for a " +"Web Bean which does not explicitly declare a scope type." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:225 +#, no-c-format +msgid "" +"For example, this Web Bean has the scope type <literal>@Dependent</literal>:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:227 +#, no-c-format +msgid "<![CDATA[public class Calculator { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:229 +#, no-c-format +msgid "" +"When an injection point of a Web Bean resolves to a dependent Web Bean, a " +"new instance of the dependent Web Bean is created every time the first Web " +"Bean is instantiated. Instances of dependent Web Beans are never shared " +"between different Web Beans or different injection points. They are " +"<emphasis>dependent objects</emphasis> of some other Web Bean instance." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:235 +#, no-c-format +msgid "" +"Dependent Web Bean instances are destroyed when the instance they depend " +"upon is destroyed." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:243 +#, no-c-format +msgid "" +"Web Beans makes it easy to obtain a dependent instance of a Java class or " +"EJB bean, even if the class or EJB bean is already declared as a Web Bean " +"with some other scope type." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:248 +#, no-c-format +msgid "The <literal>@New</literal> annotation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:250 +#, no-c-format +msgid "" +"The built-in <literal>@New</literal> binding annotation allows " +"<emphasis>implicit</emphasis> definition of a dependent Web Bean at an " +"injection point. Suppose we declare the following injected field:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:254 +#, no-c-format +msgid "<![CDATA[@New Calculator calculator;]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:256 +#, no-c-format +msgid "" +"Then a Web Bean with scope <literal>@Dependent</literal>, binding type " +"<literal>@New</literal>, API type <literal>Calculator</literal>, " +"implementation class <literal>Calculator</literal> and deployment type " +"<literal>@Standard</literal> is implicitly defined." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:261 +#, no-c-format +msgid "" +"This is true even if <literal>Calculator</literal> is <emphasis>already</" +"emphasis> declared with a different scope type, for example:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:264 +#, no-c-format +msgid "" +"<![CDATA[@ConversationScoped\n" +"public class Calculator { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:266 +#, no-c-format +msgid "" +"So the following injected attributes each get a different instance of " +"<literal>Calculator</literal>:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:269 +#, no-c-format +msgid "" +"<![CDATA[public class PaymentCalc {\n" +"\n" +" @Current Calculator calculator;\n" +" @New Calculator newCalculator;\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:271 +#, no-c-format +msgid "" +"The <literal>calculator</literal> field has a conversation-scoped instance " +"of <literal>Calculator</literal> injected. The <literal>newCalculator</" +"literal> field has a new instance of <literal>Calculator</literal> injected, " +"with a lifecycle that is bound to the owning <literal>PaymentCalc</literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:276 +#, no-c-format +msgid "" +"This feature is particularly useful with producer methods, as we'll see in " +"the next chapter." +msgstr "" Added: doc/trunk/reference/pot/modules/specialization.pot =================================================================== --- doc/trunk/reference/pot/modules/specialization.pot (rev 0) +++ doc/trunk/reference/pot/modules/specialization.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,292 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: specialization.xml:4 +#, no-c-format +msgid "Specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:6 +#, no-c-format +msgid "" +"We've already seen how the Web Beans dependency injection model lets us " +"<emphasis>override</emphasis> the implementation of an API at deployment " +"time. For example, the following enterprise Web Bean provides an " +"implementation of the API <literal>PaymentProcessor</literal> in production:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:11 +#, no-c-format +msgid "" +"@CreditCard @Stateless\n" +"public class CreditCardPaymentProcessor \n" +" implements PaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:13 +#, no-c-format +msgid "" +"But in our staging environment, we override that implementation of " +"<literal>PaymentProcessor</literal> with a different Web Bean:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:16 +#, no-c-format +msgid "" +"@CreditCard @Stateless @Staging\n" +"public class StagingCreditCardPaymentProcessor \n" +" implements PaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:18 +#, no-c-format +msgid "" +"What we've tried to do with <literal>StagingCreditCardPaymentProcessor</" +"literal> is to completely replace <literal>AsyncPaymentProcessor</literal> " +"in a particular deployment of the system. In that deployment, the deployment " +"type <literal>@Staging</literal> would have a higher priority than the " +"default deployment type <literal>@Production</literal>, and therefore " +"clients with the following injection point:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:24 +#, no-c-format +msgid "@CreditCard PaymentProcessor ccpp" +msgstr "" + +#. Tag: para +#: specialization.xml:26 +#, no-c-format +msgid "" +"Would receive an instance of <literal>StagingCreditCardPaymentProcessor</" +"literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:28 +#, no-c-format +msgid "Unfortunately, there are several traps we can easily fall into:" +msgstr "" + +#. Tag: para +#: specialization.xml:32 +#, no-c-format +msgid "" +"the higher-priority Web Bean may not implement all the API types of the Web " +"Bean that it attempts to override," +msgstr "" + +#. Tag: para +#: specialization.xml:36 +#, no-c-format +msgid "" +"the higher-priority Web Bean may not declare all the binding types of the " +"Web Bean that it attempts to override," +msgstr "" + +#. Tag: para +#: specialization.xml:40 +#, no-c-format +msgid "" +"the higher-priority Web Bean might not have the same name as the Web Bean " +"that it attempts to override, or" +msgstr "" + +#. Tag: para +#: specialization.xml:44 +#, no-c-format +msgid "" +"the Web Bean that it attempts to override might declare a producer method, " +"disposal method or observer method." +msgstr "" + +#. Tag: para +#: specialization.xml:49 +#, no-c-format +msgid "" +"In each of these cases, the Web Bean that we tried to override could still " +"be called at runtime. Therefore, overriding is somewhat prone to developer " +"error." +msgstr "" + +#. Tag: para +#: specialization.xml:52 +#, no-c-format +msgid "" +"Web Beans provides a special feature, called <emphasis>specialization</" +"emphasis>, that helps the developer avoid these traps. Specialization looks " +"a little esoteric at first, but it's easy to use in practice, and you'll " +"really appreciate the extra security it provides." +msgstr "" + +#. Tag: title +#: specialization.xml:58 +#, no-c-format +msgid "Using specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:60 +#, no-c-format +msgid "" +"Specialization is a feature that is specific to simple and enterprise Web " +"Beans. To make use of specialization, the higher-priority Web Bean must:" +msgstr "" + +#. Tag: para +#: specialization.xml:65 +#, no-c-format +msgid "be a direct subclass of the Web Bean it overrides, and" +msgstr "" + +#. Tag: para +#: specialization.xml:68 +#, no-c-format +msgid "" +"be a simple Web Bean if the Web Bean it overrides is a simple Web Bean or an " +"enterprise Web Bean if the Web Bean it overrides is an enterprise Web Bean, " +"and" +msgstr "" + +#. Tag: para +#: specialization.xml:73 +#, no-c-format +msgid "be annotated <literal>@Specializes</literal>." +msgstr "" + +#. Tag: programlisting +#: specialization.xml:77 +#, no-c-format +msgid "" +"@Stateless @Staging @Specializes\n" +"public class StagingCreditCardPaymentProcessor \n" +" extends CreditCardPaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:79 +#, no-c-format +msgid "" +"We say that the higher-priority Web Bean <emphasis>specializes</emphasis> " +"its superclass." +msgstr "" + +#. Tag: title +#: specialization.xml:85 +#, no-c-format +msgid "Advantages of specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:87 +#, no-c-format +msgid "When specialization is used:" +msgstr "" + +#. Tag: para +#: specialization.xml:91 +#, no-c-format +msgid "" +"the binding types of the superclass are automatically inherited by the Web " +"Bean annotated <literal>@Specializes</literal>, and" +msgstr "" + +#. Tag: para +#: specialization.xml:95 +#, no-c-format +msgid "" +"the Web Bean name of the superclass is automatically inherited by the Web " +"Bean annotated <literal>@Specializes</literal>, and" +msgstr "" + +#. Tag: para +#: specialization.xml:99 +#, no-c-format +msgid "" +"producer methods, disposal methods and observer methods declared by the " +"superclass are called upon an instance of the Web Bean annotated " +"<literal>@Specializes</literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:105 +#, no-c-format +msgid "" +"In our example, the binding type <literal>@CreditCard</literal> of " +"<literal>CreditCardPaymentProcessor</literal> is inherited by " +"<literal>StagingCreditCardPaymentProcessor</literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:109 +#, no-c-format +msgid "Furthermore, the Web Bean manager will validate that:" +msgstr "" + +#. Tag: para +#: specialization.xml:113 +#, no-c-format +msgid "" +"all API types of the superclass are API types of the Web Bean annotated " +"<literal>@Specializes</literal> (all local interfaces of the superclass " +"enterprise bean are also local interfaces of the subclass)," +msgstr "" + +#. Tag: para +#: specialization.xml:119 +#, no-c-format +msgid "" +"the deployment type of the Web Bean annotated <literal>@Specializes</" +"literal> has a higher precedence than the deployment type of the superclass, " +"and" +msgstr "" + +#. Tag: para +#: specialization.xml:124 +#, no-c-format +msgid "" +"there is no other enabled Web Bean that also specializes the superclass." +msgstr "" + +#. Tag: para +#: specialization.xml:129 +#, no-c-format +msgid "" +"If any of these conditions are violated, the Web Bean manager throws an " +"exception at initialization time." +msgstr "" + +#. Tag: para +#: specialization.xml:132 +#, no-c-format +msgid "" +"Therefore, we can be certain that the superclass with <emphasis>never</" +"emphasis> be called in any deployment of the system where the Web Bean " +"annotated <literal>@Specializes</literal> is deployed and enabled." +msgstr "" Added: doc/trunk/reference/pot/modules/stereotypes.pot =================================================================== --- doc/trunk/reference/pot/modules/stereotypes.pot (rev 0) +++ doc/trunk/reference/pot/modules/stereotypes.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,353 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: stereotypes.xml:4 +#, no-c-format +msgid "Stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:6 +#, no-c-format +msgid "According to the Web Beans specification:" +msgstr "" + +#. Tag: para +#: stereotypes.xml:10 +#, no-c-format +msgid "" +"In many systems, use of architectural patterns produces a set of recurring " +"Web Bean roles. A stereotype allows a framework developer to identify such a " +"role and declare some common metadata for Web Beans with that role in a " +"central place." +msgstr "" + +#. Tag: para +#: stereotypes.xml:14 +#, no-c-format +msgid "A stereotype encapsulates any combination of:" +msgstr "" + +#. Tag: para +#: stereotypes.xml:18 +#, no-c-format +msgid "a default deployment type," +msgstr "" + +#. Tag: para +#: stereotypes.xml:21 +#, no-c-format +msgid "a default scope type," +msgstr "" + +#. Tag: para +#: stereotypes.xml:24 +#, no-c-format +msgid "a restriction upon the Web Bean scope," +msgstr "" + +#. Tag: para +#: stereotypes.xml:27 +#, no-c-format +msgid "a requirement that the Web Bean implement or extend a certain type, and" +msgstr "" + +#. Tag: para +#: stereotypes.xml:30 +#, no-c-format +msgid "a set of interceptor binding annotations." +msgstr "" + +#. Tag: para +#: stereotypes.xml:34 +#, no-c-format +msgid "" +"A stereotype may also specify that all Web Beans with the stereotype have " +"defaulted Web Bean names." +msgstr "" + +#. Tag: para +#: stereotypes.xml:37 +#, no-c-format +msgid "A Web Bean may declare zero, one or multiple stereotypes." +msgstr "" + +#. Tag: para +#: stereotypes.xml:41 +#, no-c-format +msgid "" +"A stereotype is a Java annotation type. This stereotype identifies action " +"classes in some MVC framework:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:44 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:46 +#, no-c-format +msgid "We use the stereotype by applying the annotation to a Web Bean." +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:48 +#, no-c-format +msgid "" +"<![CDATA[@Action \n" +"public class LoginAction { ... }]]>" +msgstr "" + +#. Tag: title +#: stereotypes.xml:51 +#, no-c-format +msgid "Default scope and deployment type for a stereotype" +msgstr "" + +#. Tag: para +#: stereotypes.xml:53 +#, no-c-format +msgid "" +"A stereotype may specify a default scope and/or default deployment type for " +"Web Beans with that stereotype. For example, if the deployment type " +"<literal>@WebTier</literal> identifies Web Beans that should only be " +"deployed when the system executes as a web application, we might specify the " +"following defaults for action classes:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:59 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:61 +#, no-c-format +msgid "" +"Of course, a particular action may still override these defaults if " +"necessary:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:64 +#, no-c-format +msgid "" +"<![CDATA[@Dependent @Mock @Action \n" +"public class MockLoginAction { ... }]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:66 +#, no-c-format +msgid "" +"If we want to force all actions to a particular scope, we can do that too." +msgstr "" + +#. Tag: title +#: stereotypes.xml:72 +#, no-c-format +msgid "Restricting scope and type with a stereotype" +msgstr "" + +#. Tag: para +#: stereotypes.xml:74 +#, no-c-format +msgid "" +"Suppose that we wish to prevent actions from declaring certain scopes. Web " +"Beans lets us explicitly specify the set of allowed scopes for Web Beans " +"with a certain stereotype. For example:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:78 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype(supportedScopes=RequestScoped.class)\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:80 +#, no-c-format +msgid "" +"If a particular action class attempts to specify a scope other than the Web " +"Beans request scope, an exception will be thrown by the Web Bean manager at " +"initialization time." +msgstr "" + +#. Tag: para +#: stereotypes.xml:84 +#, no-c-format +msgid "" +"We can also force all Web Bean with a certain stereotype to implement an " +"interface or extend a class:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:87 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype(requiredTypes=AbstractAction.class)\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:89 +#, no-c-format +msgid "" +"If a particular action class does not extend the class " +"<literal>AbstractAction</literal>, an exception will be thrown by the Web " +"Bean manager at initialization time." +msgstr "" + +#. Tag: title +#: stereotypes.xml:96 +#, no-c-format +msgid "Interceptor bindings for stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:98 +#, no-c-format +msgid "" +"A stereotype may specify a set of interceptor bindings to be inherited by " +"all Web Beans with that stereotype." +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:101 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@Transactional(requiresNew=true)\n" +"@Secure\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:103 +#, no-c-format +msgid "" +"This helps us get technical concerns even further away from the business " +"code!" +msgstr "" + +#. Tag: title +#: stereotypes.xml:109 +#, no-c-format +msgid "Name defaulting with stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:111 +#, no-c-format +msgid "" +"Finally, we can specify that all Web Beans with a certain stereotype have a " +"Web Bean name, defaulted by the Web Bean manager. Actions are often " +"referenced in JSP pages, so they're a perfect use case for this feature. All " +"we need to do is add an empty <literal>@Named</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:116 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@Transactional(requiresNew=true)\n" +"@Secure\n" +"@Named\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:118 +#, no-c-format +msgid "" +"Now, <literal>LoginAction</literal> will have the name <literal>loginAction</" +"literal>." +msgstr "" + +#. Tag: title +#: stereotypes.xml:124 +#, no-c-format +msgid "Standard stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:126 +#, no-c-format +msgid "" +"We've already met two standard stereotypes defined by the Web Beans " +"specification: <literal>@Interceptor</literal> and <literal>@Decorator</" +"literal>." +msgstr "" + +#. Tag: para +#: stereotypes.xml:129 +#, no-c-format +msgid "Web Beans defines one further standard stereotype:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:131 +#, no-c-format +msgid "" +"<![CDATA[@Named \n" +"@RequestScoped \n" +"@Stereotype \n" +"@Target({TYPE, METHOD}) \n" +"@Retention(RUNTIME) \n" +"public @interface Model {} ]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:133 +#, no-c-format +msgid "" +"This stereotype is intended for use with JSF. Instead of using JSF managed " +"beans, just annotate a Web Bean <literal>@Model</literal>, and use it " +"directly in your JSF page." +msgstr "" Added: doc/trunk/reference/pot/modules/xml.pot =================================================================== --- doc/trunk/reference/pot/modules/xml.pot (rev 0) +++ doc/trunk/reference/pot/modules/xml.pot 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,353 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: xml.xml:4 +#, no-c-format +msgid "Defining Web Beans using XML" +msgstr "" + +#. Tag: para +#: xml.xml:6 +#, no-c-format +msgid "" +"So far, we've seen plenty of examples of Web Beans declared using " +"annotations. However, there are a couple of occasions when we can't use " +"annotations to define the Web Bean:" +msgstr "" + +#. Tag: para +#: xml.xml:12 +#, no-c-format +msgid "when the implementation class comes from some preexisting library, or" +msgstr "" + +#. Tag: para +#: xml.xml:15 +#, no-c-format +msgid "" +"when there should be multiple Web Beans with the same implementation class." +msgstr "" + +#. Tag: para +#: xml.xml:20 +#, no-c-format +msgid "In either of these cases, Web Beans gives us two options:" +msgstr "" + +#. Tag: para +#: xml.xml:23 +#, no-c-format +msgid "write a producer method, or" +msgstr "" + +#. Tag: para +#: xml.xml:24 +#, no-c-format +msgid "declare the Web Bean using XML." +msgstr "" + +#. Tag: para +#: xml.xml:27 +#, no-c-format +msgid "" +"Many frameworks use XML to provide metadata relating to Java classes. " +"However, Web Beans uses a very different approach to specifying the names of " +"Java classes, fields or methods to most other frameworks. Instead of writing " +"class and member names as the string values of XML elements and attributes, " +"Web Beans lets you use the class or member name as the name of the XML " +"element." +msgstr "" + +#. Tag: para +#: xml.xml:33 +#, no-c-format +msgid "" +"The advantage of this approach is that you can write an XML schema that " +"prevents spelling errors in your XML document. It's even possible for a tool " +"to generate the XML schema automatically from the compiled Java code. Or, an " +"integrated development environment could perform the same validation without " +"the need for the explicit intermediate generation step." +msgstr "" + +#. Tag: title +#: xml.xml:40 +#, no-c-format +msgid "Declaring Web Bean classes" +msgstr "" + +#. Tag: para +#: xml.xml:42 +#, no-c-format +msgid "" +"For each Java package, Web Beans defines a corresponding XML namespace. The " +"namespace is formed by prepending <literal>urn:java:</literal> to the Java " +"package name. For the package <literal>com.mydomain.myapp</literal>, the XML " +"namespace is <literal>urn:java:com.mydomain.myapp</literal>." +msgstr "" + +#. Tag: para +#: xml.xml:47 +#, no-c-format +msgid "" +"Java types belonging to a package are referred to using an XML element in " +"the namespace corresponding to the package. The name of the element is the " +"name of the Java type. Fields and methods of the type are specified by child " +"elements in the same namespace. If the type is an annotation, members are " +"specified by attributes of the element." +msgstr "" + +#. Tag: para +#: xml.xml:53 +#, no-c-format +msgid "" +"For example, the element <literal><util:Date/></literal> in the " +"following XML fragment refers to the class <literal>java.util.Date</literal>:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:56 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans xmlns=\"urn:java:javax.webbeans\"\n" +" xmlns:util=\"urn:java:java.util\">\n" +"\n" +" <util:Date/>\n" +"\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:58 +#, no-c-format +msgid "" +"And this is all the code we need to declare that <literal>Date</literal> is " +"a simple Web Bean! An instance of <literal>Date</literal> may now be " +"injected by any other Web Bean:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:62 +#, no-c-format +msgid "<![CDATA[@Current Date date]]>" +msgstr "" + +#. Tag: title +#: xml.xml:67 +#, no-c-format +msgid "Declaring Web Bean metadata" +msgstr "" + +#. Tag: para +#: xml.xml:69 +#, no-c-format +msgid "" +"We can declare the scope, deployment type and interceptor binding types " +"using direct child elements of the Web Bean declaration:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:72 +#, no-c-format +msgid "" +"<![CDATA[<myapp:ShoppingCart>\n" +" <SessionScoped/>\n" +" <myfwk:Transactional requiresNew=\"true\"/>\n" +" <myfwk:Secure/>\n" +"</myapp:ShoppingCart>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:74 +#, no-c-format +msgid "We use exactly the same approach to specify names and binding type:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:76 +#, no-c-format +msgid "" +"<![CDATA[<util:Date>\n" +" <Named>currentTime</Named>\n" +"</util:Date>\n" +"\n" +"<util:Date>\n" +" <SessionScoped/>\n" +" <myapp:Login/>\n" +" <Named>loginTime</Named>\n" +"</util:Date>\n" +"\n" +"<util:Date>\n" +" <ApplicationScoped/>\n" +" <myapp:SystemStart/>\n" +" <Named>systemStartTime</Named>\n" +"</util:Date>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:78 +#, no-c-format +msgid "" +"Where <literal>@Login</literal> and <literal>@SystemStart</literal> are " +"binding annotations types." +msgstr "" + +#. Tag: programlisting +#: xml.xml:81 +#, no-c-format +msgid "" +"<![CDATA[@Current Date currentTime;\n" +"@Login Date loginTime;\n" +"@SystemStart Date systemStartTime;]]>" +msgstr "" + +#. Tag: para +#: xml.xml:83 +#, no-c-format +msgid "As usual, a Web Bean may support multiple binding types:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:85 +#, no-c-format +msgid "" +"<![CDATA[<myapp:AsynchronousChequePaymentProcessor>\n" +" <myapp:PayByCheque/>\n" +" <myapp:Asynchronous/>\n" +"</myapp:AsynchronousChequePaymentProcessor>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:87 +#, no-c-format +msgid "" +"Interceptors and decorators are just simple Web Beans, so they may be " +"declared just like any other simple Web Bean:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:90 +#, no-c-format +msgid "" +"<![CDATA[<myfwk:TransactionInterceptor>\n" +" <Interceptor/>\n" +" <myfwk:Transactional/>\n" +"</myfwk:TransactionInterceptor>]]>" +msgstr "" + +#. Tag: title +#: xml.xml:95 +#, no-c-format +msgid "Declaring Web Bean members" +msgstr "" + +#. Tag: para +#: xml.xml:97 +#, no-c-format +msgid "TODO!" +msgstr "" + +#. Tag: title +#: xml.xml:104 +#, no-c-format +msgid "Declaring inline Web Beans" +msgstr "" + +#. Tag: para +#: xml.xml:106 +#, no-c-format +msgid "Web Beans lets us define a Web Bean at an injection point. For example:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:108 +#, no-c-format +msgid "" +"<![CDATA[<myapp:System>\n" +" <ApplicationScoped/>\n" +" <myapp:admin>\n" +" <myapp:Name>\n" +" <myapp:firstname>Gavin</myapp:firstname>\n" +" <myapp:lastname>King</myapp:lastname>\n" +" <myapp:email>gavin(a)hibernate.org</myapp:email>\n" +" </myapp:Name>\n" +" </myapp:admin>\n" +"</myapp:System>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:110 +#, no-c-format +msgid "" +"The <literal><Name></literal> element declares a simple Web Bean of " +"scope <literal>@Dependent</literal> and class <literal>Name</literal>, with " +"a set of initial field values. This Web Bean has a special, container-" +"generated binding and is therefore injectable only to the specific injection " +"point at which it is declared." +msgstr "" + +#. Tag: para +#: xml.xml:116 +#, no-c-format +msgid "" +"This simple but powerful feature allows the Web Beans XML format to be used " +"to specify whole graphs of Java objects. It's not quite a full databinding " +"solution, but it's close!" +msgstr "" + +#. Tag: title +#: xml.xml:123 +#, no-c-format +msgid "Using a schema" +msgstr "" + +#. Tag: para +#: xml.xml:125 +#, no-c-format +msgid "" +"If we want our XML document format to be authored by people who aren't Java " +"developers, or who don't have access to our code, we need to provide a " +"schema. There's nothing specific to Web Beans about writing or using the " +"schema." +msgstr "" + +#. Tag: programlisting +#: xml.xml:130 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans xmlns=\"urn:java:javax.webbeans\"\n" +" xmlns:myapp=\"urn:java:com.mydomain.myapp\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"urn:java:javax.webbeans http://java.sun.com/" +"jee/web-beans-1.0.xsd\n" +" urn:java:com.mydomain.myapp http://mydomain." +"com/xsd/myapp-1.2.xsd\">\n" +"\n" +" <myapp:System>\n" +" ...\n" +" </myapp:System>\n" +"\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:132 +#, no-c-format +msgid "" +"Writing an XML schema is quite tedious. Therefore, the Web Beans RI project " +"will provide a tool which automatically generates the XML schema from " +"compiled Java code." +msgstr "" Added: doc/trunk/reference/zh-CN/Book_Info.po =================================================================== --- doc/trunk/reference/zh-CN/Book_Info.po (rev 0) +++ doc/trunk/reference/zh-CN/Book_Info.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,56 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: 2008-12-19 20:29+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: Book_Info.xml:6 +#, no-c-format +msgid "Introduction to Web Beans" +msgstr "" + +#. Tag: subtitle +#: Book_Info.xml:7 +#, no-c-format +msgid "" +"The new Java standard for dependency injection and contextual state " +"management" +msgstr "" + +#. Tag: author +#: Book_Info.xml:10 +#, no-c-format +msgid "<firstname>Gavin</firstname> <surname>King</surname>" +msgstr "" + +#. Tag: affiliation +#: Book_Info.xml:13 +#, no-c-format +msgid "" +"<jobtitle>Web Beans (JSR-299) specification lead</jobtitle> <orgname>Red Hat " +"Middleware LLC</orgname>" +msgstr "" + +#. Tag: author +#: Book_Info.xml:19 +#, no-c-format +msgid "<firstname>Pete</firstname> <surname>Muir</surname>" +msgstr "" + +#. Tag: affiliation +#: Book_Info.xml:22 +#, no-c-format +msgid "" +"<jobtitle>Web Beans (JSR-299) Reference Implementation lead</jobtitle> " +"<orgname>Red Hat Middleware LLC</orgname>" +msgstr "" Added: doc/trunk/reference/zh-CN/master.po =================================================================== --- doc/trunk/reference/zh-CN/master.po (rev 0) +++ doc/trunk/reference/zh-CN/master.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,38 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:29+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: master.xml:12 +#, no-c-format +msgid "Using contextual objects" +msgstr "" + +#. Tag: title +#: master.xml:25 +#, no-c-format +msgid "Developing loosely-coupled code" +msgstr "" + +#. Tag: title +#: master.xml:35 +#, no-c-format +msgid "Making the most of strong typing" +msgstr "" + +#. Tag: title +#: master.xml:46 +#, no-c-format +msgid "Web Beans and the Java EE ecosystem" +msgstr "" Added: doc/trunk/reference/zh-CN/modules/decorators.po =================================================================== --- doc/trunk/reference/zh-CN/modules/decorators.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/decorators.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,243 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: decorators.xml:4 +#, no-c-format +msgid "Decorators" +msgstr "" + +#. Tag: para +#: decorators.xml:6 +#, no-c-format +msgid "" +"Interceptors are a powerful way to capture and separate concerns which are " +"<emphasis>orthogonal</emphasis> to the type system. Any interceptor is able " +"to intercept invocations of any Java type. This makes them perfect for " +"solving technical concerns such as transaction management and security. " +"However, by nature, interceptors are unaware of the actual semantics of the " +"events they intercept. Thus, interceptors aren't an appropriate tool for " +"separating business-related concerns." +msgstr "" + +#. Tag: para +#: decorators.xml:14 +#, no-c-format +msgid "" +"The reverse is true of <emphasis>decorators</emphasis>. A decorator " +"intercepts invocations only for a certain Java interface, and is therefore " +"aware of all the semantics attached to that interface. This makes decorators " +"a perfect tool for modeling some kinds of business concerns. It also means " +"that a decorator doesn't have the generality of an interceptor. Decorators " +"aren't able to solve technical concerns that cut across many disparate types." +msgstr "" + +#. Tag: para +#: decorators.xml:22 +#, no-c-format +msgid "Suppose we have an interface that represents accounts:" +msgstr "" + +#. Tag: programlisting +#: decorators.xml:24 +#, no-c-format +msgid "" +"<![CDATA[public interface Account {\n" +" public BigDecimal getBalance();\n" +" public User getOwner();\n" +" public void withdraw(BigDecimal amount);\n" +" public void deposit(BigDecimal amount);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:26 +#, no-c-format +msgid "" +"Several different Web Beans in our system implement the <literal>Account</" +"literal> interface. However, we have a common legal requirement that, for " +"any kind of account, large transactions must be recorded by the system in a " +"special log. This is a perfect job for a decorator." +msgstr "" + +#. Tag: para +#: decorators.xml:32 +#, no-c-format +msgid "" +"A decorator is a simple Web Bean that implements the type it decorates and " +"is annotated <literal>@Decorator</literal>." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:35 +#, no-c-format +msgid "" +"<![CDATA[@Decorator\n" +"public abstract class LargeTransactionDecorator \n" +" implements Account {\n" +" \n" +" @Decorates Account account;\n" +" \n" +" @PersistenceContext EntityManager em;\n" +" \n" +" public void withdraw(BigDecimal amount) {\n" +" account.withdraw(amount);\n" +" if ( amount.compareTo(LARGE_AMOUNT)>0 ) {\n" +" em.persist( new LoggedWithdrawl(amount) );\n" +" }\n" +" }\n" +" \n" +" public void deposit(BigDecimal amount);\n" +" account.deposit(amount);\n" +" if ( amount.compareTo(LARGE_AMOUNT)>0 ) {\n" +" em.persist( new LoggedDeposit(amount) );\n" +" }\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:37 +#, no-c-format +msgid "" +"Unlike other simple Web Beans, a decorator may be an abstract class. If " +"there's nothing special the decorator needs to do for a particular method of " +"the decorated interface, you don't need to implement that method." +msgstr "" + +#. Tag: title +#: decorators.xml:43 +#, no-c-format +msgid "Delegate attributes" +msgstr "" + +#. Tag: para +#: decorators.xml:45 +#, no-c-format +msgid "" +"All decorators have a <emphasis>delegate attribute</emphasis>. The type and " +"binding types of the delegate attribute determine which Web Beans the " +"decorator is bound to. The delegate attribute type must implement or extend " +"all interfaces implemented by the decorator." +msgstr "" + +#. Tag: para +#: decorators.xml:50 +#, no-c-format +msgid "" +"This delegate attribute specifies that the decorator is bound to all Web " +"Beans that implement <literal>Account</literal>:" +msgstr "" + +#. Tag: programlisting +#: decorators.xml:53 +#, no-c-format +msgid "<![CDATA[@Decorates Account account;]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:55 +#, no-c-format +msgid "" +"A delegate attribute may specify a binding annotation. Then the decorator " +"will only be bound to Web Beans with the same binding." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:58 +#, no-c-format +msgid "<![CDATA[@Decorates @Foreign Account account;]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:60 +#, no-c-format +msgid "A decorator is bound to any Web Bean which:" +msgstr "" + +#. Tag: para +#: decorators.xml:64 +#, no-c-format +msgid "has the type of the delegate attribute as an API type, and" +msgstr "" + +#. Tag: para +#: decorators.xml:67 +#, no-c-format +msgid "has all binding types that are declared by the delegate attribute." +msgstr "" + +#. Tag: para +#: decorators.xml:71 +#, no-c-format +msgid "" +"The decorator may invoke the delegate attribute, which has much the same " +"effect as calling <literal>InvocationContext.proceed()</literal> from an " +"interceptor." +msgstr "" + +#. Tag: title +#: decorators.xml:78 +#, no-c-format +msgid "Enabling decorators" +msgstr "" + +#. Tag: para +#: decorators.xml:80 +#, no-c-format +msgid "" +"We need to <emphasis>enable</emphasis> our decorator in <literal>web-beans." +"xml</literal>." +msgstr "" + +#. Tag: programlisting +#: decorators.xml:83 +#, no-c-format +msgid "" +"<![CDATA[<Decorators>\n" +" <myapp:LargeTransactionDecorator/>\n" +"</Decorators>]]>" +msgstr "" + +#. Tag: para +#: decorators.xml:85 +#, no-c-format +msgid "" +"This declaration serves the same purpose for decorators that the " +"<literal><Interceptors></literal> declaration serves for interceptors:" +msgstr "" + +#. Tag: para +#: decorators.xml:90 +#, no-c-format +msgid "" +"it enables us to specify a total ordering for all decorators in our system, " +"ensuring deterministic behavior, and" +msgstr "" + +#. Tag: para +#: decorators.xml:94 +#, no-c-format +msgid "it lets us enable or disable decorator classes at deployment time." +msgstr "" + +#. Tag: para +#: decorators.xml:98 +#, no-c-format +msgid "" +"Interceptors for a method are called before decorators that apply to that " +"method." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/ee.po =================================================================== --- doc/trunk/reference/zh-CN/modules/ee.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/ee.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,329 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: ee.xml:4 +#, no-c-format +msgid "Java EE integration" +msgstr "" + +#. Tag: para +#: ee.xml:6 +#, no-c-format +msgid "" +"Web Beans is fully integrated into the Java EE environment. Web Beans have " +"access to Java EE resources and JPA persistence contexts. They may be used " +"in Unified EL expressions in JSF and JSP pages. They may even be injected " +"into some objects, such as Servlets and Message-Driven Beans, which are not " +"Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:12 +#, no-c-format +msgid "Injecting Java EE resources into a Web Bean" +msgstr "" + +#. Tag: para +#: ee.xml:14 +#, no-c-format +msgid "" +"All simple and enterprise Web Beans may take advantage of Java EE dependency " +"injection using <literal>@Resource</literal>, <literal>@EJB</literal> and " +"<literal>@PersistenceContext</literal>. We've already seen a couple of " +"examples of this, though we didn't pay much attention at the time:" +msgstr "" + +#. Tag: programlisting +#: ee.xml:19 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +"\n" +" @Resource Transaction transaction;\n" +"\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: ee.xml:21 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped\n" +"public class Login {\n" +"\n" +" @Current Credentials credentials;\n" +" @PersistenceContext EntityManager userDatabase;\n" +" \n" +" ...\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: ee.xml:23 +#, no-c-format +msgid "" +"The Java EE <literal>@PostConstruct</literal> and <literal>@PreDestroy</" +"literal> callbacks are also supported for all simple and enterprise Web " +"Beans. The <literal>@PostConstruct</literal> method is called after " +"<emphasis>all</emphasis> injection has been performed." +msgstr "" + +#. Tag: para +#: ee.xml:28 +#, no-c-format +msgid "" +"There is one restriction to be aware of here: <literal>@PersistenceContext" +"(type=EXTENDED)</literal> is not supported for simple Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:35 +#, no-c-format +msgid "Calling a Web Bean from a Servlet" +msgstr "" + +#. Tag: para +#: ee.xml:37 +#, no-c-format +msgid "" +"It's easy to use a Web Bean from a Servlet in Java EE 6. Simply inject the " +"Web Bean using Web Beans field or initializer method injection." +msgstr "" + +#. Tag: programlisting +#: ee.xml:40 +#, no-c-format +msgid "" +"public class Login extends HttpServlet {\n" +"\n" +" @Current Credentials credentials;\n" +" @Current Login login;\n" +"\n" +" @Override\n" +" public void service(HttpServletRequest request, HttpServletResponse " +"response)\n" +" throws ServletException, IOException {\n" +" credentials.setUsername( request.getAttribute(\"username\") ):\n" +" credentials.setPassword( request.getAttribute(\"password\") ):\n" +" login.login();\n" +" if ( login.isLoggedIn() ) {\n" +" response.sendRedirect(\"/home.jsp\");\n" +" }\n" +" else {\n" +" response.sendRedirect(\"/loginError.jsp\");\n" +" }\n" +" }\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:42 +#, no-c-format +msgid "" +"The Web Beans client proxy takes care of routing method invocations from the " +"Servlet to the correct instances of <literal>Credentials</literal> and " +"<literal>Login</literal> for the current request and HTTP session." +msgstr "" + +#. Tag: title +#: ee.xml:49 +#, no-c-format +msgid "Calling a Web Bean from a Message-Driven Bean" +msgstr "" + +#. Tag: para +#: ee.xml:51 +#, no-c-format +msgid "" +"Web Beans injection applies to all EJBs, even when they aren't under the " +"control of the Web Bean manager (if they were obtained by direct JNDI " +"lookup, or injection using <literal>@EJB</literal>, for example. In " +"particular, you can use Web Beans injection in Message-Driven Beans, which " +"are not considered Web Beans because you can't inject them." +msgstr "" + +#. Tag: para +#: ee.xml:57 +#, no-c-format +msgid "" +"You can even use Web Beans interceptor bindings for Message-Driven Beans." +msgstr "" + +#. Tag: programlisting +#: ee.xml:59 +#, no-c-format +msgid "" +"@Transactional @MessageDriven\n" +"public class ProcessOrder implements MessageListener {\n" +"\n" +" @Current Inventory inventory;\n" +" @PersistenceContext EntityManager em;\n" +"\n" +" public void onMessage(Message message) {\n" +" ...\n" +" }\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:61 +#, no-c-format +msgid "" +"Thus, receiving messages is super-easy in a Web Beans environment. But " +"beware that there is no session or conversation context available when a " +"message is delivered to a Message-Driven Bean. Only <literal>@RequestScoped</" +"literal> and <literal>@ApplicationScoped</literal> Web Beans are available." +msgstr "" + +#. Tag: para +#: ee.xml:66 +#, no-c-format +msgid "It's also easy to send messages using Web Beans." +msgstr "" + +#. Tag: title +#: ee.xml:71 +#, no-c-format +msgid "JMS endpoints" +msgstr "" + +#. Tag: para +#: ee.xml:73 +#, no-c-format +msgid "" +"Sending messages using JMS can be quite complex, because of the number of " +"different objects you need to deal with. For queues we have <literal>Queue</" +"literal>, <literal>QueueConnectionFactory</literal>, " +"<literal>QueueConnection</literal>, <literal>QueueSession</literal> and " +"<literal>QueueSender</literal>. For topics we have <literal>Topic</literal>, " +"<literal>TopicConnectionFactory</literal>, <literal>TopicConnection</" +"literal>, <literal>TopicSession</literal> and <literal>TopicPublisher</" +"literal>. Each of these objects has its own lifecycle and threading model " +"that we need to worry about." +msgstr "" + +#. Tag: para +#: ee.xml:82 +#, no-c-format +msgid "" +"Web Beans takes care of all this for us. All we need to do is declare the " +"queue or topic in <literal>web-beans.xml</literal>, specifying an associated " +"binding type and connection factory." +msgstr "" + +#. Tag: programlisting +#: ee.xml:86 +#, no-c-format +msgid "" +"<![CDATA[<Queue>\n" +" <destination>java:comp/env/jms/OrderQueue</destination>\n" +" <connectionFactory>java:comp/env/jms/QueueConnectionFactory</" +"connectionFactory>\n" +" <myapp:OrderProcessor/> \n" +"</Queue>]]>" +msgstr "" + +#. Tag: programlisting +#: ee.xml:88 +#, no-c-format +msgid "" +"<![CDATA[<Topic>\n" +" <destination>java:comp/env/jms/StockPrices</destination>\n" +" <connectionFactory>java:comp/env/jms/TopicConnectionFactory</" +"connectionFactory>\n" +" <myapp:StockPrices/> \n" +"</Topic>]]>" +msgstr "" + +#. Tag: para +#: ee.xml:90 +#, no-c-format +msgid "" +"Now we can just inject the <literal>Queue</literal>, " +"<literal>QueueConnection</literal>, <literal>QueueSession</literal> or " +"<literal>QueueSender</literal> for a queue, or the <literal>Topic</literal>, " +"<literal>TopicConnection</literal>, <literal>TopicSession</literal> or " +"<literal>TopicPublisher</literal> for a topic." +msgstr "" + +#. Tag: programlisting +#: ee.xml:96 +#, no-c-format +msgid "" +"@OrderProcessor QueueSender orderSender;\n" +"@OrderProcessor QueueSession orderSession;\n" +"\n" +"public void sendMessage() {\n" +" MapMessage msg = orderSession.createMapMessage();\n" +" ...\n" +" orderSender.send(msg);\n" +"}" +msgstr "" + +#. Tag: programlisting +#: ee.xml:98 +#, no-c-format +msgid "" +"@StockPrices TopicPublisher pricePublisher;\n" +"@StockPrices TopicSession priceSession;\n" +"\n" +"public void sendMessage(String price) {\n" +" pricePublisher.send( priceSession.createTextMessage(price) );\n" +"}" +msgstr "" + +#. Tag: para +#: ee.xml:100 +#, no-c-format +msgid "" +"The lifecycle of the injected JMS objects are completely controlled by the " +"Web Bean manager." +msgstr "" + +#. Tag: title +#: ee.xml:106 +#, no-c-format +msgid "Packaging and deployment" +msgstr "" + +#. Tag: para +#: ee.xml:108 +#, no-c-format +msgid "" +"Web Beans doesn't define any special deployment archive. You can package Web " +"Beans in JARs, EJB-JARs or WARsany deployment location in the " +"application classpath. However, each archive that contains Web Beans must " +"include a file named <literal>web-beans.xml</literal> in the <literal>META-" +"INF</literal> or <literal>WEB-INF</literal> directory. The file may be " +"empty. Web Beans deployed in archives that do not have a <literal>web-beans." +"xml</literal> file will not be available for use in the application." +msgstr "" + +#. Tag: para +#: ee.xml:116 +#, no-c-format +msgid "" +"For Java SE execution, Web Beans may be deployed in any location in which " +"EJBs may be deployed for execution by the embeddable EJB Lite container. " +"Again, each location must contain a <literal>web-beans.xml</literal> file." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/events.po =================================================================== --- doc/trunk/reference/zh-CN/modules/events.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/events.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,649 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: events.xml:4 +#, no-c-format +msgid "Events" +msgstr "" + +#. Tag: para +#: events.xml:6 +#, no-c-format +msgid "" +"The Web Beans event notification facility allows Web Beans to interact in a " +"totally decoupled manner. Event <emphasis>producers</emphasis> raise events " +"that are then delivered to event <emphasis>observers</emphasis> by the Web " +"Bean manager. This basic schema might sound like the familiar observer/" +"observable pattern, but there are a couple of twists:" +msgstr "" + +#. Tag: para +#: events.xml:14 +#, no-c-format +msgid "" +"not only are event producers decoupled from observers; observers are " +"completely decoupled from producers," +msgstr "" + +#. Tag: para +#: events.xml:18 +#, no-c-format +msgid "" +"observers can specify a combination of \"selectors\" to narrow the set of " +"event notifications they will receive, and" +msgstr "" + +#. Tag: para +#: events.xml:22 +#, no-c-format +msgid "" +"observers can be notified immediately, or can specify that delivery of the " +"event should be delayed until the end of the current transaction" +msgstr "" + +#. Tag: title +#: events.xml:28 +#, no-c-format +msgid "Event observers" +msgstr "" + +#. Tag: para +#: events.xml:30 +#, no-c-format +msgid "" +"An <emphasis>observer method</emphasis> is a method of a Web Bean with a " +"parameter annotated <literal>@Observes</literal>." +msgstr "" + +#. Tag: programlisting +#: events.xml:33 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyDocumentEvent(@Observes Document document) " +"{ ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:35 +#, no-c-format +msgid "" +"The annotated parameter is called the <emphasis>event parameter</emphasis>. " +"The type of the event parameter is the observed <emphasis>event type</" +"emphasis>. Observer methods may also specify \"selectors\", which are just " +"instances of Web Beans binding types. When a binding type is used as an " +"event selector, it is called an <emphasis>event binding type</emphasis>." +msgstr "" + +#. Tag: programlisting +#: events.xml:41 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Target({PARAMETER, FIELD})\n" +"@Retention(RUNTIME)\n" +"public @interface Updated { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:43 +#, no-c-format +msgid "" +"We specify the event bindings of the observer method by annotating the event " +"parameter:" +msgstr "" + +#. Tag: programlisting +#: events.xml:46 events.xml:190 +#, no-c-format +msgid "" +"<![CDATA[public void afterDocumentUpdate(@Observes @Updated Document " +"document) { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:48 +#, no-c-format +msgid "" +"An observer method need not specify any event bindingsin this case it " +"is interested in <emphasis>all</emphasis> events of a particular type. If it " +"does specify event bindings, it is only interested in events which also have " +"those event bindings." +msgstr "" + +#. Tag: para +#: events.xml:53 +#, no-c-format +msgid "" +"The observer method may have additional parameters, which are injected " +"according to the usual Web Beans method parameter injection semantics:" +msgstr "" + +#. Tag: programlisting +#: events.xml:56 +#, no-c-format +msgid "" +"<![CDATA[public void afterDocumentUpdate(@Observes @Updated Document " +"document, User user) { ... }]]>" +msgstr "" + +#. Tag: title +#: events.xml:61 +#, no-c-format +msgid "Event producers" +msgstr "" + +#. Tag: para +#: events.xml:63 +#, no-c-format +msgid "" +"The event producer may obtain an <emphasis>event notifier</emphasis> object " +"by injection:" +msgstr "" + +#. Tag: programlisting +#: events.xml:66 +#, no-c-format +msgid "<![CDATA[@Observable Event<Document> documentEvent]]>" +msgstr "" + +#. Tag: para +#: events.xml:68 +#, no-c-format +msgid "" +"The <literal>@Observable</literal> annotation implicitly defines a Web Bean " +"with scope <literal>@Dependent</literal> and deployment type " +"<literal>@Standard</literal>, with an implementation provided by the Web " +"Bean manager." +msgstr "" + +#. Tag: para +#: events.xml:72 +#, no-c-format +msgid "" +"A producer raises events by calling the <literal>fire()</literal> method of " +"the <literal>Event</literal> interface, passing an <emphasis>event object</" +"emphasis>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:75 +#, no-c-format +msgid "<![CDATA[documentEvent.fire(document);]]>" +msgstr "" + +#. Tag: para +#: events.xml:77 +#, no-c-format +msgid "" +"An event object may be an instance of any Java class that has no type " +"variables or wildcard type parameters. The event will be delivered to every " +"observer method that:" +msgstr "" + +#. Tag: para +#: events.xml:83 events.xml:107 events.xml:126 +#, no-c-format +msgid "has an event parameter to which the event object is assignable, and" +msgstr "" + +#. Tag: para +#: events.xml:86 +#, no-c-format +msgid "specifies no event bindings." +msgstr "" + +#. Tag: para +#: events.xml:90 +#, no-c-format +msgid "" +"The Web Bean manager simply calls all the observer methods, passing the " +"event object as the value of the event parameter. If any observer method " +"throws an exception, the Web Bean manager stops calling observer methods, " +"and the exception is rethrown by the <literal>fire()</literal> method." +msgstr "" + +#. Tag: para +#: events.xml:95 +#, no-c-format +msgid "" +"To specify a \"selector\", the event producer may pass an instance of the " +"event binding type to the <literal>fire()</literal> method:" +msgstr "" + +#. Tag: programlisting +#: events.xml:98 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.fire( document, new AnnotationLiteral<Updated>()" +"{} );]]>" +msgstr "" + +#. Tag: para +#: events.xml:100 +#, no-c-format +msgid "" +"The helper class <literal>AnnotationLiteral</literal> makes it possible to " +"instantiate binding types inline, since this is otherwise difficult to do in " +"Java." +msgstr "" + +#. Tag: para +#: events.xml:103 +#, no-c-format +msgid "The event will be delivered to every observer method that:" +msgstr "" + +#. Tag: para +#: events.xml:110 +#, no-c-format +msgid "" +"does not specify any event binding <emphasis>except</emphasis> for the event " +"bindings passed to <literal>fire()</literal>." +msgstr "" + +#. Tag: para +#: events.xml:115 +#, no-c-format +msgid "" +"Alternatively, event bindings may be specified by annotating the event " +"notifier injection point:" +msgstr "" + +#. Tag: programlisting +#: events.xml:118 +#, no-c-format +msgid "<![CDATA[@Observable @Updated Event<Document> documentUpdatedEvent]]>" +msgstr "" + +#. Tag: para +#: events.xml:120 +#, no-c-format +msgid "" +"Then every event fired via this instance of <literal>Event</literal> has the " +"annotated event binding. The event will be delivered to every observer " +"method that:" +msgstr "" + +#. Tag: para +#: events.xml:129 +#, no-c-format +msgid "" +"does not specify any event binding <emphasis>except</emphasis> for the event " +"bindings passed to <literal>fire()</literal> or the annotated event bindings " +"of the event notifier injection point." +msgstr "" + +#. Tag: title +#: events.xml:138 +#, no-c-format +msgid "Registering observers dynamically" +msgstr "" + +#. Tag: para +#: events.xml:140 +#, no-c-format +msgid "" +"It's often useful to register an event observer dynamically. The application " +"may implement the <literal>Observer</literal> interface and register an " +"instance with an event notifier by calling the <literal>observe()</literal> " +"method." +msgstr "" + +#. Tag: programlisting +#: events.xml:144 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.observe( new Observer<Document>() { public void notify" +"(Document doc) { ... } } );]]>" +msgstr "" + +#. Tag: para +#: events.xml:146 +#, no-c-format +msgid "" +"Event binding types may be specified by the event notifier injection point " +"or by passing event binding type instances to the <literal>observe()</" +"literal> method:" +msgstr "" + +#. Tag: programlisting +#: events.xml:149 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.observe( new Observer<Document>() { public void notify" +"(Document doc) { ... } }, \n" +" new " +"AnnotationLiteral<Updated>(){} );]]>" +msgstr "" + +#. Tag: title +#: events.xml:154 +#, no-c-format +msgid "Event bindings with members" +msgstr "" + +#. Tag: para +#: events.xml:156 +#, no-c-format +msgid "An event binding type may have annotation members:" +msgstr "" + +#. Tag: programlisting +#: events.xml:158 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Target({PARAMETER, FIELD})\n" +"@Retention(RUNTIME)\n" +"public @interface Role {\n" +" RoleType value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:160 +#, no-c-format +msgid "" +"The member value is used to narrow the messages delivered to the observer:" +msgstr "" + +#. Tag: programlisting +#: events.xml:162 +#, no-c-format +msgid "" +"<![CDATA[public void adminLoggedIn(@Observes @Role(ADMIN) LoggedIn event) " +"{ ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:164 +#, no-c-format +msgid "" +"Event binding type members may be specified statically by the event " +"producer, via annotations at the event notifier injection point:" +msgstr "" + +#. Tag: programlisting +#: events.xml:167 +#, no-c-format +msgid "<![CDATA[@Observable @Role(ADMIN) Event<LoggedIn> LoggedInEvent;}}]]>" +msgstr "" + +#. Tag: para +#: events.xml:169 +#, no-c-format +msgid "" +"Alternatively, the value of the event binding type member may be determined " +"dynamically by the event producer. We start by writing an abstract subclass " +"of <literal>AnnotationLiteral</literal>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:172 +#, no-c-format +msgid "" +"<![CDATA[abstract class RoleBinding \n" +" extends AnnotationLiteral<Role> \n" +" implements Role {}]]>" +msgstr "" + +#. Tag: para +#: events.xml:174 +#, no-c-format +msgid "" +"The event producer passes an instance of this class to <literal>fire()</" +"literal>:" +msgstr "" + +#. Tag: programlisting +#: events.xml:176 +#, no-c-format +msgid "" +"<![CDATA[documentEvent.fire( document, new RoleBinding() { public void value" +"() { return user.getRole(); } } );]]>" +msgstr "" + +#. Tag: title +#: events.xml:181 +#, no-c-format +msgid "Multiple event bindings" +msgstr "" + +#. Tag: para +#: events.xml:183 +#, no-c-format +msgid "Event binding types may be combined, for example:" +msgstr "" + +#. Tag: programlisting +#: events.xml:185 +#, no-c-format +msgid "" +"<![CDATA[@Observable @Blog Event<Document> blogEvent;\n" +"...\n" +"if (document.isBlog()) blogEvent.fire(document, new " +"AnnotationLiteral<Updated>(){});]]>" +msgstr "" + +#. Tag: para +#: events.xml:187 +#, no-c-format +msgid "" +"When this event occurs, all of the following observer methods will be " +"notified:" +msgstr "" + +#. Tag: programlisting +#: events.xml:189 +#, no-c-format +msgid "" +"<![CDATA[public void afterBlogUpdate(@Observes @Updated @Blog Document " +"document) { ... }]]>" +msgstr "" + +#. Tag: programlisting +#: events.xml:191 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyBlogEvent(@Observes @Blog Document document) " +"{ ... }]]>" +msgstr "" + +#. Tag: programlisting +#: events.xml:192 +#, no-c-format +msgid "" +"<![CDATA[public void onAnyDocumentEvent(@Observes Document document) " +"{ ... }}}]]>" +msgstr "" + +#. Tag: title +#: events.xml:197 +#, no-c-format +msgid "Transactional observers" +msgstr "" + +#. Tag: para +#: events.xml:199 +#, no-c-format +msgid "" +"Transactional observers receive their event notifications during the before " +"or after completion phase of the transaction in which the event was raised. " +"For example, the following observer method needs to refresh a query result " +"set that is cached in the application context, but only when transactions " +"that update the <literal>Category</literal> tree succeed:" +msgstr "" + +#. Tag: programlisting +#: events.xml:205 +#, no-c-format +msgid "" +"<![CDATA[public void refreshCategoryTree(@AfterTransactionSuccess @Observes " +"CategoryUpdateEvent event) { ... }]]>" +msgstr "" + +#. Tag: para +#: events.xml:207 +#, no-c-format +msgid "There are three kinds of transactional observers:" +msgstr "" + +#. Tag: para +#: events.xml:211 +#, no-c-format +msgid "" +"<literal>@AfterTransactionSuccess</literal> observers are called during the " +"after completion phase of the transaction, but only if the transaction " +"completes successfully" +msgstr "" + +#. Tag: para +#: events.xml:216 +#, no-c-format +msgid "" +"<literal>@AfterTransactionFailure</literal> observers are called during the " +"after completion phase of the transaction, but only if the transaction fails " +"to complete successfully" +msgstr "" + +#. Tag: para +#: events.xml:221 +#, no-c-format +msgid "" +"<literal>@AfterTransactionCompletion</literal> observers are called during " +"the after completion phase of the transaction" +msgstr "" + +#. Tag: para +#: events.xml:225 +#, no-c-format +msgid "" +"<literal>@BeforeTransactionCompletion</literal> observers are called during " +"the before completion phase of the transaction" +msgstr "" + +#. Tag: para +#: events.xml:230 +#, no-c-format +msgid "" +"Transactional observers are very important in a stateful object model like " +"Web Beans, because state is often held for longer than a single atomic " +"transaction." +msgstr "" + +#. Tag: para +#: events.xml:233 +#, no-c-format +msgid "" +"Imagine that we have cached a JPA query result set in the application scope:" +msgstr "" + +#. Tag: programlisting +#: events.xml:235 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Singleton\n" +"public class Catalog {\n" +"\n" +" @PersistenceContext EntityManager em;\n" +" \n" +" List<Product> products;\n" +"\n" +" @Produces @Catalog \n" +" List<Product> getCatalog() {\n" +" if (products==null) {\n" +" products = em.createQuery(\"select p from Product p where p." +"deleted = false\")\n" +" .getResultList();\n" +" }\n" +" return products;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:237 +#, no-c-format +msgid "" +"From time to time, a <literal>Product</literal> is created or deleted. When " +"this occurs, we need to refresh the <literal>Product</literal> catalog. But " +"we should wait until <emphasis>after</emphasis> the transaction completes " +"successfully before performing this refresh!" +msgstr "" + +#. Tag: para +#: events.xml:242 +#, no-c-format +msgid "" +"The Web Bean that creates and deletes <literal>Product</literal>s could " +"raise events, for example:" +msgstr "" + +#. Tag: programlisting +#: events.xml:245 +#, no-c-format +msgid "" +"<![CDATA[@Stateless\n" +"public class ProductManager {\n" +"\n" +" @PersistenceContext EntityManager em;\n" +" @Observable Event<Product> productEvent;\n" +"\n" +" public void delete(Product product) {\n" +" em.delete(product);\n" +" productEvent.fire(product, new AnnotationLiteral<Deleted>(){});\n" +" }\n" +" \n" +" public void persist(Product product) {\n" +" em.persist(product);\n" +" productEvent.fire(product, new AnnotationLiteral<Created>(){});\n" +" }\n" +" \n" +" ...\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: events.xml:247 +#, no-c-format +msgid "" +"And now <literal>Catalog</literal> can observe the events after successful " +"completion of the transaction:" +msgstr "" + +#. Tag: programlisting +#: events.xml:250 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Singleton\n" +"public class Catalog {\n" +"\n" +" ...\n" +" \n" +" void addProduct(@AfterTransactionSuccess @Observes @Created Product " +"product) {\n" +" products.add(product);\n" +" }\n" +" \n" +" void addProduct(@AfterTransactionSuccess @Observes @Deleted Product " +"product) {\n" +" products.remove(product);\n" +" }\n" +" \n" +"}]]>" +msgstr "" Added: doc/trunk/reference/zh-CN/modules/example.po =================================================================== --- doc/trunk/reference/zh-CN/modules/example.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/example.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,172 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: example.xml:4 +#, no-c-format +msgid "JSF web application example" +msgstr "" + +#. Tag: para +#: example.xml:6 +#, no-c-format +msgid "" +"Let's illustrate these ideas with a full example. We're going to implement " +"user login/logout for an application that uses JSF. First, we'll define a " +"Web Bean to hold the username and password entered during login:" +msgstr "" + +#. Tag: programlisting +#: example.xml:11 +#, no-c-format +msgid "" +"<![CDATA[@Named\n" +"public class Credentials {\n" +" \n" +" private String username;\n" +" private String password;\n" +" \n" +" public String getUsername() { return username; }\n" +" public void setUsername(String username) { this.username = username; }\n" +" \n" +" public String getPassword() { return password; }\n" +" public void setPassword(String password) { this.password = password; }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:13 +#, no-c-format +msgid "This Web Bean is bound to the login prompt in the following JSF form:" +msgstr "" + +#. Tag: programlisting +#: example.xml:15 +#, no-c-format +msgid "" +"<![CDATA[<f:form>\n" +" <h:panelGrid columns=\"2\" rendered=\"#{!login.loggedIn}\">\n" +" <h:outputLabel for=\"username\">Username:</h:outputLabel>\n" +" <h:inputText id=\"username\" value=\"#{credentials.username}\"/>\n" +" <h:outputLabel for=\"password\">Password:</h:outputLabel>\n" +" <h:inputText id=\"password\" value=\"#{credentials.password}\"/>\n" +" </h:panelGrid>\n" +" <h:commandButton value=\"Login\" action=\"#{login.login}\" rendered=\"#{!" +"login.loggedIn}\"/>\n" +" <h:commandButton value=\"Logout\" acion=\"#{login.logout}\" rendered=\"#" +"{login.loggedIn}\"/>\n" +"</f:form]]>" +msgstr "" + +#. Tag: para +#: example.xml:17 +#, no-c-format +msgid "" +"The actual work is done by a session scoped Web Bean that maintains " +"information about the currently logged-in user and exposes the " +"<literal>User</literal> entity to other Web Beans:" +msgstr "" + +#. Tag: programlisting +#: example.xml:21 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named\n" +"public class Login {\n" +"\n" +" @Current Credentials credentials;\n" +" @PersistenceContext EntityManager userDatabase;\n" +"\n" +" private User user;\n" +" \n" +" public void login() {\n" +" \n" +" List<User> results = userDatabase.createQuery(\n" +" \"select u from User u where u.username=:username and u.password=:" +"password\")\n" +" .setParameter(\"username\", credentials.getUsername())\n" +" .setParameter(\"password\", credentials.getPassword())\n" +" .getResultList();\n" +" \n" +" if ( !results.isEmpty() ) {\n" +" user = results.get(0);\n" +" }\n" +" \n" +" }\n" +" \n" +" public void logout() {\n" +" user = null;\n" +" }\n" +" \n" +" public boolean isLoggedIn() {\n" +" return user!=null;\n" +" }\n" +" \n" +" @Produces @LoggedIn User getCurrentUser() {\n" +" return user;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:23 +#, no-c-format +msgid "Of course, <literal>@LoggedIn</literal> is a binding annotation:" +msgstr "" + +#. Tag: programlisting +#: example.xml:25 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD})\n" +"@BindingType\n" +"public @interface LoggedIn {}]]>" +msgstr "" + +#. Tag: para +#: example.xml:27 +#, no-c-format +msgid "Now, any other Web Bean can easily inject the current user:" +msgstr "" + +#. Tag: programlisting +#: example.xml:29 +#, no-c-format +msgid "" +"<![CDATA[public class DocumentEditor {\n" +"\n" +" @Current Document document;\n" +" @LoggedIn User currentUser;\n" +" @PersistenceContext EntityManager docDatabase;\n" +" \n" +" public void save() {\n" +" document.setCreatedBy(currentUser);\n" +" docDatabase.persist(document);\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: example.xml:31 +#, no-c-format +msgid "" +"Hopefully, this example gives a flavor of the Web Bean programming model. In " +"the next chapter, we'll explore Web Beans dependency injection in greater " +"depth." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/extend.po =================================================================== --- doc/trunk/reference/zh-CN/modules/extend.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/extend.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,252 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: extend.xml:4 +#, no-c-format +msgid "Extending Web Beans" +msgstr "" + +#. Tag: para +#: extend.xml:6 +#, no-c-format +msgid "" +"Web Beans is intended to be a platform for frameworks, extensions and " +"integration with other technologies. Therefore, Web Beans exposes a set of " +"SPIs for the use of developers of portable extensions to Web Beans. For " +"example, the following kinds of extensions were envisaged by the designers " +"of Web Beans:" +msgstr "" + +#. Tag: para +#: extend.xml:14 +#, no-c-format +msgid "integration with Business Process Management engines," +msgstr "" + +#. Tag: para +#: extend.xml:17 +#, no-c-format +msgid "" +"integration with third-party frameworks such as Spring, Seam, GWT or Wicket, " +"and" +msgstr "" + +#. Tag: para +#: extend.xml:21 +#, no-c-format +msgid "new technology based upon the Web Beans programming model." +msgstr "" + +#. Tag: para +#: extend.xml:25 +#, no-c-format +msgid "" +"The nerve center for extending Web Beans is the <literal>Manager</literal> " +"object." +msgstr "" + +#. Tag: title +#: extend.xml:29 +#, no-c-format +msgid "The <literal>Manager</literal> object" +msgstr "" + +#. Tag: para +#: extend.xml:31 +#, no-c-format +msgid "" +"The <literal>Manager</literal> interface lets us register and obtain Web " +"Beans, interceptors, decorators, observers and contexts programatically." +msgstr "" + +#. Tag: programlisting +#: extend.xml:34 +#, no-c-format +msgid "" +"<![CDATA[public interface Manager\n" +"{\n" +"\n" +" public <T> Set<Bean<T>> resolveByType(Class<T> type, Annotation... " +"bindings);\n" +"\n" +" public <T> Set<Bean<T>> resolveByType(TypeLiteral<T> apiType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> T getInstanceByType(Class<T> type, Annotation... bindings);\n" +"\n" +" public <T> T getInstanceByType(TypeLiteral<T> type,\n" +" Annotation... bindings);\n" +"\n" +" public Set<Bean<?>> resolveByName(String name);\n" +"\n" +" public Object getInstanceByName(String name);\n" +"\n" +" public <T> T getInstance(Bean<T> bean);\n" +"\n" +" public void fireEvent(Object event, Annotation... bindings);\n" +"\n" +" public Context getContext(Class<? extends Annotation> scopeType);\n" +"\n" +" public Manager addContext(Context context);\n" +"\n" +" public Manager addBean(Bean<?> bean);\n" +"\n" +" public Manager addInterceptor(Interceptor interceptor);\n" +"\n" +" public Manager addDecorator(Decorator decorator);\n" +"\n" +" public <T> Manager addObserver(Observer<T> observer, Class<T> eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager addObserver(Observer<T> observer, TypeLiteral<T> " +"eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager removeObserver(Observer<T> observer, Class<T> " +"eventType,\n" +" Annotation... bindings);\n" +"\n" +" public <T> Manager removeObserver(Observer<T> observer,\n" +" TypeLiteral<T> eventType, Annotation... bindings);\n" +"\n" +" public <T> Set<Observer<T>> resolveObservers(T event, Annotation... " +"bindings);\n" +"\n" +" public List<Interceptor> resolveInterceptors(InterceptionType type,\n" +" Annotation... interceptorBindings);\n" +"\n" +" public List<Decorator> resolveDecorators(Set<Class<?>> types,\n" +" Annotation... bindings);\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: extend.xml:36 +#, no-c-format +msgid "We can obtain an instance of <literal>Manager</literal> via injection:" +msgstr "" + +#. Tag: programlisting +#: extend.xml:38 +#, no-c-format +msgid "@Current Manager manager" +msgstr "" + +#. Tag: title +#: extend.xml:43 +#, no-c-format +msgid "The <literal>Bean</literal> class" +msgstr "" + +#. Tag: para +#: extend.xml:45 +#, no-c-format +msgid "" +"Instances of the abstract class <literal>Bean</literal> represent Web Beans. " +"There is an instance of <literal>Bean</literal> registered with the " +"<literal>Manager</literal> object for every Web Bean in the application." +msgstr "" + +#. Tag: programlisting +#: extend.xml:50 +#, no-c-format +msgid "" +"public abstract class Bean<T> {\n" +" \n" +" private final Manager manager;\n" +" \n" +" protected Bean(Manager manager) {\n" +" this.manager=manager;\n" +" }\n" +" \n" +" protected Manager getManager() {\n" +" return manager;\n" +" }\n" +" \n" +" public abstract Set<Class> getTypes();\n" +" public abstract Set<Annotation> getBindingTypes();\n" +" public abstract Class<? extends Annotation> getScopeType();\n" +" public abstract Class<? extends Annotation> getDeploymentType(); \n" +" public abstract String getName();\n" +" \n" +" public abstract boolean isSerializable();\n" +" public abstract boolean isNullable();\n" +"\n" +" public abstract T create();\n" +" public abstract void destroy(T instance);\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: extend.xml:52 +#, no-c-format +msgid "" +"It's possible to extend the <literal>Bean</literal> class and register " +"instances by calling <literal>Manager.addBean()</literal> to provide support " +"for new kinds of Web Beans, beyond those defined by the Web Beans " +"specification (simple and enterprise Web Beans, producer methods and JMS " +"endpoints). For example, we could use the <literal>Bean</literal> class to " +"allow objects managed by another framework to be injected into Web Beans." +msgstr "" + +#. Tag: para +#: extend.xml:60 +#, no-c-format +msgid "" +"There are two subclasses of <literal>Bean</literal> defined by the Web Beans " +"specification: <literal>Interceptor</literal> and <literal>Decorator</" +"literal>." +msgstr "" + +#. Tag: title +#: extend.xml:67 +#, no-c-format +msgid "The <literal>Context</literal> interface" +msgstr "" + +#. Tag: para +#: extend.xml:69 +#, no-c-format +msgid "" +"The <literal>Context</literal> interface supports addition of new scopes to " +"Web Beans, or extension of the built-in scopes to new environments." +msgstr "" + +#. Tag: programlisting +#: extend.xml:72 +#, no-c-format +msgid "" +"public interface Context {\n" +" \n" +" public Class<? extends Annotation> getScopeType();\n" +" \n" +" public <T> T get(Bean<T> bean, boolean create);\n" +" \n" +" boolean isActive();\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: extend.xml:74 +#, no-c-format +msgid "" +"For example, we might implement <literal>Context</literal> to add a business " +"process scope to Web Beans, or to add support for the conversation scope to " +"an application that uses Wicket." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/injection.po =================================================================== --- doc/trunk/reference/zh-CN/modules/injection.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/injection.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,1226 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: injection.xml:4 +#, no-c-format +msgid "Dependency injection" +msgstr "" + +#. Tag: para +#: injection.xml:6 +#, no-c-format +msgid "Web Beans supports three primary mechanisms for dependency injection:" +msgstr "" + +#. Tag: para +#: injection.xml:8 +#, no-c-format +msgid "Constructor parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:10 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +" \n" +" private final ShoppingCart cart;\n" +" \n" +" @Initializer\n" +" public Checkout(ShoppingCart cart) {\n" +" this.cart = cart;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:12 +#, no-c-format +msgid "<emphasis>Initializer</emphasis> method parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:14 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +" \n" +" private ShoppingCart cart;\n" +"\n" +" @Initializer \n" +" void setShoppingCart(ShoppingCart cart) {\n" +" this.cart = cart;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:16 +#, no-c-format +msgid "And direct field injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:18 +#, no-c-format +msgid "" +"<![CDATA[public class Checkout {\n" +"\n" +" private @Current ShoppingCart cart;\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:20 +#, no-c-format +msgid "" +"Dependency injection always occurs when the Web Bean instance is first " +"instantiated." +msgstr "" + +#. Tag: para +#: injection.xml:25 +#, no-c-format +msgid "" +"First, the Web Bean manager calls the Web Bean constructor, to obtain an " +"instance of the Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:29 +#, no-c-format +msgid "" +"Next, the Web Bean manager initializes the values of all injected fields of " +"the Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:33 +#, no-c-format +msgid "Next, the Web Bean manager calls all initializer methods of Web Bean." +msgstr "" + +#. Tag: para +#: injection.xml:37 +#, no-c-format +msgid "" +"Finally, the <literal>@PostConstruct</literal> method of the Web Bean, if " +"any, is called." +msgstr "" + +#. Tag: para +#: injection.xml:42 +#, no-c-format +msgid "" +"Constructor parameter injection is not supported for EJB beans, since the " +"EJB is instantiated by the EJB container, not the Web Bean manager." +msgstr "" + +#. Tag: para +#: injection.xml:45 +#, no-c-format +msgid "" +"Parameters of constructors and initializer methods need not be explicitly " +"annotated when the default binding type <literal>@Current</literal> applies. " +"Injected fields, however, <emphasis>must</emphasis> specify a binding type, " +"even when the default binding type applies. If the field does not specify a " +"binding type, it will not be injected." +msgstr "" + +#. Tag: para +#: injection.xml:51 +#, no-c-format +msgid "Producer methods also support parameter injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:53 +#, no-c-format +msgid "" +"<![CDATA[@Produces Checkout createCheckout(ShoppingCart cart) {\n" +" return new Checkout(cart);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:55 +#, no-c-format +msgid "" +"Finally, observer methods (which we'll meet in <xref linkend=\"events\"/>), " +"disposal methods and destructor methods all support parameter injection." +msgstr "" + +#. Tag: para +#: injection.xml:58 +#, no-c-format +msgid "" +"The Web Beans specification defines a procedure, called the " +"<emphasis>typesafe resolution algorithm</emphasis>, that the Web Bean " +"manager follows when identifying the Web Bean to inject to an injection " +"point. This algorithm looks complex at first, but once you understand it, " +"it's really quite intuitive. Typesafe resolution is performed at system " +"initialization time, which means that the manager will inform the user " +"immediately if a Web Bean's dependencies cannot be satisfied, by throwing a " +"<literal>UnsatisfiedDependencyException</literal> or " +"<literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:67 +#, no-c-format +msgid "" +"The purpose of this algorithm is to allow multiple Web Beans to implement " +"the same API type and either:" +msgstr "" + +#. Tag: para +#: injection.xml:72 +#, no-c-format +msgid "" +"allow the client to select which implementation it requires using " +"<emphasis>binding annotations</emphasis>," +msgstr "" + +#. Tag: para +#: injection.xml:77 +#, no-c-format +msgid "" +"allow the application deployer to select which implementation is appropriate " +"for a particular deployment, without changes to the client, by enabling or " +"disabling <emphasis>deployment types</emphasis>, or" +msgstr "" + +#. Tag: para +#: injection.xml:82 +#, no-c-format +msgid "" +"allow one implementation of an API to override another implementation of the " +"same API at deployment time, without changes to the client, using " +"<emphasis>deployment type precedence</emphasis>." +msgstr "" + +#. Tag: para +#: injection.xml:88 +#, no-c-format +msgid "" +"Let's explore how the Web Beans manager determines a Web Bean to be injected." +msgstr "" + +#. Tag: title +#: injection.xml:91 +#, no-c-format +msgid "Binding annotations" +msgstr "" + +#. Tag: para +#: injection.xml:93 +#, no-c-format +msgid "" +"If we have more than one Web Bean that implements a particular API type, the " +"injection point can specify exactly which Web Bean should be injected using " +"a binding annotation. For example, there might be two implementations of " +"<literal>PaymentProcessor</literal>:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:98 +#, no-c-format +msgid "" +"<![CDATA[@PayByCheque\n" +"public class ChequePaymentProcessor implements PaymentProcessor {\n" +" public void process(Payment payment) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:100 +#, no-c-format +msgid "" +"<![CDATA[@PayByCreditCard\n" +"public class CreditCardPaymentProcessor implements PaymentProcessor {\n" +" public void process(Payment payment) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:102 +#, no-c-format +msgid "" +"Where <literal>@PayByCheque</literal> and <literal>@PayByCreditCard</" +"literal> are binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:105 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayByCheque {}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:107 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayByCreditCard {}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:109 +#, no-c-format +msgid "" +"A client Web Bean developer uses the binding annotation to specify exactly " +"which Web Bean should be injected." +msgstr "" + +#. Tag: para +#: injection.xml:112 +#, no-c-format +msgid "Using field injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:114 +#, no-c-format +msgid "" +"<![CDATA[@PayByCheque PaymentProcessor chequePaymentProcessor;\n" +"@PayByCreditCard PaymentProcessor creditCardPaymentProcessor;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:116 +#, no-c-format +msgid "Using initializer method injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:118 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public void setPaymentProcessors(@PayByCheque PaymentProcessor " +"chequePaymentProcessor, \n" +" @PayByCreditCard PaymentProcessor " +"creditCardPaymentProcessor) {\n" +" this.chequePaymentProcessor = chequePaymentProcessor;\n" +" this.creditCardPaymentProcessor = creditCardPaymentProcessor;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:120 +#, no-c-format +msgid "Or using constructor injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:122 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public Checkout(@PayByCheque PaymentProcessor chequePaymentProcessor, \n" +" @PayByCreditCard PaymentProcessor " +"creditCardPaymentProcessor) {\n" +" this.chequePaymentProcessor = chequePaymentProcessor;\n" +" this.creditCardPaymentProcessor = creditCardPaymentProcessor;\n" +"}]]>" +msgstr "" + +#. Tag: title +#: injection.xml:125 +#, no-c-format +msgid "Binding annotations with members" +msgstr "" + +#. Tag: para +#: injection.xml:127 +#, no-c-format +msgid "Binding annotations may have members:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:129 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"@BindingType\n" +"public @interface PayBy {\n" +" PaymentType value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:131 +#, no-c-format +msgid "In which case, the member value is significant:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:133 +#, no-c-format +msgid "" +"<![CDATA[@PayBy(CHEQUE) PaymentProcessor chequePaymentProcessor;\n" +"@PayBy(CREDIT_CARD) PaymentProcessor creditCardPaymentProcessor;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:135 +#, no-c-format +msgid "" +"You can tell the Web Bean manager to ignore a member of a binding annotation " +"type by annotating the member <literal>@NonBinding</literal>." +msgstr "" + +#. Tag: title +#: injection.xml:141 +#, no-c-format +msgid "Combinations of binding annnotations" +msgstr "" + +#. Tag: para +#: injection.xml:143 +#, no-c-format +msgid "An injection point may even specify multiple binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:145 +#, no-c-format +msgid "" +"<![CDATA[@Asynchronous @PayByCheque PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: injection.xml:147 +#, no-c-format +msgid "" +"In this case, only a Web Bean which has <emphasis>both</emphasis> binding " +"annotations would be eligible for injection." +msgstr "" + +#. Tag: title +#: injection.xml:153 +#, no-c-format +msgid "Binding annotations and producer methods" +msgstr "" + +#. Tag: para +#: injection.xml:155 +#, no-c-format +msgid "Even producer methods may specify binding annotations:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:157 +#, no-c-format +msgid "" +"<![CDATA[@Produces \n" +"@Asynchronous @PayByCheque \n" +"PaymentProcessor createAsyncPaymentProcessor(@PayByCheque PaymentProcessor " +"processor) {\n" +" return new AsynchronousPaymentProcessor(processor);\n" +"}]]>" +msgstr "" + +#. Tag: title +#: injection.xml:162 +#, no-c-format +msgid "The default binding type" +msgstr "" + +#. Tag: para +#: injection.xml:164 +#, no-c-format +msgid "" +"Web Beans defines a binding type <literal>@Current</literal> that is the " +"default binding type for any injection point or Web Bean that does not " +"explicitly specify a binding type." +msgstr "" + +#. Tag: para +#: injection.xml:168 +#, no-c-format +msgid "" +"There are two common circumstances in which it is necessary to explicitly " +"specify <literal>@Current</literal>:" +msgstr "" + +#. Tag: para +#: injection.xml:173 +#, no-c-format +msgid "" +"on a field, in order to declare it as an injected field with the default " +"binding type, and" +msgstr "" + +#. Tag: para +#: injection.xml:177 +#, no-c-format +msgid "" +"on a Web Bean which has another binding type in addition to the default " +"binding type." +msgstr "" + +#. Tag: title +#: injection.xml:187 +#, no-c-format +msgid "Deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:189 +#, no-c-format +msgid "" +"All Web Beans have a <emphasis>deployment type</emphasis>. Each deployment " +"type identifies a set of Web Beans that should be conditionally installed in " +"some deployments of the system." +msgstr "" + +#. Tag: para +#: injection.xml:193 +#, no-c-format +msgid "" +"For example, we could define a deployment type named <literal>@Mock</" +"literal>, which would identify Web Beans that should only be installed when " +"the system executes inside an integration testing environment:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:197 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +" @Target({TYPE, METHOD})\n" +" @DeploymentType\n" +" public @interface Mock {}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:199 +#, no-c-format +msgid "" +"Suppose we had some Web Bean that interacted with an external system to " +"process payments:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:202 +#, no-c-format +msgid "" +"<![CDATA[public class ExternalPaymentProcessor {\n" +" \n" +" public void process(Payment p) {\n" +" ...\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:204 +#, no-c-format +msgid "" +"Since this Web Bean does not explicitly specify a deployment type, it has " +"the default deployment type <literal>@Production</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:207 +#, no-c-format +msgid "" +"For integration or unit testing, the external system is slow or unavailable. " +"So we would create a mock object:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:210 +#, no-c-format +msgid "" +"<![CDATA[@Mock \n" +"public class MockPaymentProcessor implements PaymentProcessor {\n" +"\n" +" @Override\n" +" public void process(Payment p) {\n" +" p.setSuccessful(true);\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:212 +#, no-c-format +msgid "" +"But how does the Web Bean manager determine which implementation to use in a " +"particular deployment?" +msgstr "" + +#. Tag: title +#: injection.xml:216 +#, no-c-format +msgid "Enabling deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:218 +#, no-c-format +msgid "" +"Web Beans defines two built-in deployment types: <literal>@Production</" +"literal> and <literal>@Standard</literal>. By default, only Web Beans with " +"the built-in deployment types are enabled when the system is deployed. We " +"can identify additional deployment types to be enabled in a particular " +"deployment by listing them in <literal>web-beans.xml</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:224 +#, no-c-format +msgid "" +"Going back to our example, when we deploy our integration tests, we want all " +"our <literal>@Mock</literal> objects to be installed:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:227 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans>\n" +" <Deploy>\n" +" <Standard/>\n" +" <Production/>\n" +" <test:Mock/>\n" +" </Deploy>\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: injection.xml:229 +#, no-c-format +msgid "" +"Now the Web Bean manager will identify and install all Web Beans annotated " +"<literal>@Production</literal>, <literal>@Standard</literal> or " +"<literal>@Mock</literal> at deployment time." +msgstr "" + +#. Tag: para +#: injection.xml:233 +#, no-c-format +msgid "" +"The deployment type <literal>@Standard</literal> is used only for certain " +"special Web Beans defined by the Web Beans specification. We can't use it " +"for our own Web Beans, and we can't disable it." +msgstr "" + +#. Tag: para +#: injection.xml:237 +#, no-c-format +msgid "" +"The deployment type <literal>@Production</literal> is the default deployment " +"type for Web Beans which don't explicitly declare a deployment type, and may " +"be disabled." +msgstr "" + +#. Tag: title +#: injection.xml:244 +#, no-c-format +msgid "Deployment type precedence" +msgstr "" + +#. Tag: para +#: injection.xml:246 +#, no-c-format +msgid "" +"If you've been paying attention, you're probably wondering how the Web Bean " +"manager decides which implementation<literal>ExternalPaymentProcessor</" +"literal> or <literal>MockPaymentProcessor</literal>to choose. Consider " +"what happens when the manager encounters this injection point:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:251 +#, no-c-format +msgid "<![CDATA[@Current PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: injection.xml:253 +#, no-c-format +msgid "" +"There are now two Web Beans which satisfy the <literal>PaymentProcessor</" +"literal> contract. Of course, we can't use a binding annotation to " +"disambiguate, since binding annotations are hard-coded into the source at " +"the injection point, and we want the manager to be able to decide at " +"deployment time!" +msgstr "" + +#. Tag: para +#: injection.xml:258 +#, no-c-format +msgid "" +"The solution to this problem is that each deployment type has a different " +"<emphasis>precedence</emphasis>. The precedence of the deployment types is " +"determined by the order in which they appear in <literal>web-beans.xml</" +"literal>. In our example, <literal>@Mock</literal> appears later than " +"<literal>@Production</literal> so it has a higher precedence." +msgstr "" + +#. Tag: para +#: injection.xml:264 +#, no-c-format +msgid "" +"Whenever the manager discovers that more than one Web Bean could satisfy the " +"contract (API type plus binding annotations) specified by an injection " +"point, it considers the relative precedence of the Web Beans. If one has a " +"higher precedence than the others, it chooses the higher precedence Web Bean " +"to inject. So, in our example, the Web Bean manager will inject " +"<literal>MockPaymentProcessor</literal> when executing in our integration " +"testing environment (which is exactly what we want)." +msgstr "" + +#. Tag: para +#: injection.xml:271 +#, no-c-format +msgid "" +"It's interesting to compare this facility to today's popular manager " +"architectures. Various \"lightweight\" containers also allow conditional " +"deployment of classes that exist in the classpath, but the classes that are " +"to be deployed must be explicity, individually, listed in configuration code " +"or in some XML configuration file. Web Beans does support Web Bean " +"definition and configuration via XML, but in the common case where no " +"complex configuration is required, deployment types allow a whole set of Web " +"Beans to be enabled with a single line of XML. Meanwhile, a developer " +"browsing the code can easily identify what deployment scenarios the Web Bean " +"will be used in." +msgstr "" + +#. Tag: title +#: injection.xml:284 +#, no-c-format +msgid "Example deployment types" +msgstr "" + +#. Tag: para +#: injection.xml:286 +#, no-c-format +msgid "" +"Deployment types are useful for all kinds of things, here's some examples:" +msgstr "" + +#. Tag: para +#: injection.xml:290 +#, no-c-format +msgid "" +"<literal>@Mock</literal> and <literal>@Staging</literal> deployment types " +"for testing" +msgstr "" + +#. Tag: para +#: injection.xml:294 +#, no-c-format +msgid "<literal>@AustralianTaxLaw</literal> for site-specific Web Beans" +msgstr "" + +#. Tag: para +#: injection.xml:297 +#, no-c-format +msgid "" +"<literal>@SeamFramework</literal>, <literal>@Guice</literal> for third-party " +"frameworks which build on Web Beans" +msgstr "" + +#. Tag: para +#: injection.xml:301 +#, no-c-format +msgid "" +"<literal>@Standard</literal> for standard Web Beans defined by the Web Beans " +"specification" +msgstr "" + +#. Tag: para +#: injection.xml:306 +#, no-c-format +msgid "I'm sure you can think of more applications..." +msgstr "" + +#. Tag: title +#: injection.xml:313 +#, no-c-format +msgid "Fixing unsatisfied dependencies" +msgstr "" + +#. Tag: para +#: injection.xml:315 +#, no-c-format +msgid "" +"The typesafe resolution algorithm fails when, after considering the binding " +"annotations and and deployment types of all Web Beans that implement the API " +"type of an injection point, the Web Bean manager is unable to identify " +"exactly one Web Bean to inject." +msgstr "" + +#. Tag: para +#: injection.xml:320 +#, no-c-format +msgid "" +"It's usually easy to fix an <literal>UnsatisfiedDependencyException</" +"literal> or <literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:323 +#, no-c-format +msgid "" +"To fix an <literal>UnsatisfiedDependencyException</literal>, simply provide " +"a Web Bean which implements the API type and has the binding types of the " +"injection pointor enable the deployment type of a Web Bean that " +"already implements the API type and has the binding types." +msgstr "" + +#. Tag: para +#: injection.xml:328 +#, no-c-format +msgid "" +"To fix an <literal>AmbiguousDependencyException</literal>, introduce a " +"binding type to distinguish between the two implementations of the API type, " +"or change the deployment type of one of the implementations so that the Web " +"Bean manager can use deployment type precedence to choose between them. An " +"<literal>AmbiguousDependencyException</literal> can only occur if two Web " +"Beans share a binding type and have exactly the same deployment type." +msgstr "" + +#. Tag: para +#: injection.xml:335 +#, no-c-format +msgid "" +"There's one more issue you need to be aware of when using dependency " +"injection in Web Beans." +msgstr "" + +#. Tag: title +#: injection.xml:341 +#, no-c-format +msgid "Client proxies" +msgstr "" + +#. Tag: para +#: injection.xml:343 +#, no-c-format +msgid "" +"Clients of an injected Web Bean do not usually hold a direct reference to a " +"Web Bean instance." +msgstr "" + +#. Tag: para +#: injection.xml:346 +#, no-c-format +msgid "" +"Imagine that a Web Bean bound to the application scope held a direct " +"reference to a Web Bean bound to the request scope. The application scoped " +"Web Bean is shared between many different requests. However, each request " +"should see a different instance of the request scoped Web bean!" +msgstr "" + +#. Tag: para +#: injection.xml:351 +#, no-c-format +msgid "" +"Now imagine that a Web Bean bound to the session scope held a direct " +"reference to a Web Bean bound to the application scope. From time to time, " +"the session context is serialized to disk in order to use memory more " +"efficiently. However, the application scoped Web Bean instance should not be " +"serialized along with the session scoped Web Bean!" +msgstr "" + +#. Tag: para +#: injection.xml:357 +#, no-c-format +msgid "" +"Therefore, unless a Web Bean has the default scope <literal>@Dependent</" +"literal>, the Web Bean manager must indirect all injected references to the " +"Web Bean through a proxy object. This <emphasis>client proxy</emphasis> is " +"responsible for ensuring that the Web Bean instance that receives a method " +"invocation is the instance that is associated with the current context. The " +"client proxy also allows Web Beans bound to contexts such as the session " +"context to be serialized to disk without recursively serializing other " +"injected Web Beans." +msgstr "" + +#. Tag: para +#: injection.xml:365 +#, no-c-format +msgid "" +"Unfortunately, due to limitations of the Java language, some Java types " +"cannot be proxied by the Web Bean manager. Therefore, the Web Bean manager " +"throws an <literal>UnproxyableDependencyException</literal> if the type of " +"an injection point cannot be proxied." +msgstr "" + +#. Tag: para +#: injection.xml:370 +#, no-c-format +msgid "The following Java types cannot be proxied by the Web Bean manager:" +msgstr "" + +#. Tag: para +#: injection.xml:374 +#, no-c-format +msgid "" +"classes which are declared <literal>final</literal> or have a " +"<literal>final</literal> method," +msgstr "" + +#. Tag: para +#: injection.xml:378 +#, no-c-format +msgid "classes which have no non-private constructor with no parameters, and" +msgstr "" + +#. Tag: para +#: injection.xml:381 +#, no-c-format +msgid "arrays and primitive types." +msgstr "" + +#. Tag: para +#: injection.xml:385 +#, no-c-format +msgid "" +"It's usually very easy to fix an <literal>UnproxyableDependencyException</" +"literal>. Simply add a constructor with no parameters to the injected class, " +"introduce an interface, or change the scope of the injected Web Bean to " +"<literal>@Dependent</literal>." +msgstr "" + +#. Tag: title +#: injection.xml:392 +#, no-c-format +msgid "Obtaining a Web Bean by programatic lookup" +msgstr "" + +#. Tag: para +#: injection.xml:394 +#, no-c-format +msgid "" +"The application may obtain an instance of the interface <literal>Manager</" +"literal> by injection:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:397 +#, no-c-format +msgid "<![CDATA[@Current Manager manager;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:399 +#, no-c-format +msgid "" +"The <literal>Manager</literal> object provides a set of methods for " +"obtaining a Web Bean instance programatically." +msgstr "" + +#. Tag: programlisting +#: injection.xml:402 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class);]]>" +msgstr "" + +#. Tag: para +#: injection.xml:404 +#, no-c-format +msgid "" +"Binding annotations may be specified by subclassing the helper class " +"<literal>AnnotationLiteral</literal>, since it is otherwise difficult to " +"instantiate an annotation type in Java." +msgstr "" + +#. Tag: programlisting +#: injection.xml:408 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class, \n" +" new " +"AnnotationLiteral<CreditCard>(){});]]>" +msgstr "" + +#. Tag: para +#: injection.xml:410 +#, no-c-format +msgid "" +"If the binding type has an annotation member, we can't use an anonymous " +"subclass of <literal>AnnotationLiteral</literal>instead we'll need to " +"create a named subclass:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:413 +#, no-c-format +msgid "" +"<![CDATA[abstract class CreditCardBinding \n" +" extends AnnotationLiteral<CreditCard> \n" +" implements CreditCard {}]]>" +msgstr "" + +#. Tag: programlisting +#: injection.xml:415 +#, no-c-format +msgid "" +"<![CDATA[PaymentProcessor p = manager.getInstanceByType(PaymentProcessor." +"class, \n" +" new CreditCardBinding() { \n" +" public void value() " +"{ return paymentType; } \n" +" } );]]>" +msgstr "" + +#. Tag: title +#: injection.xml:419 +#, no-c-format +msgid "" +"Lifecycle callbacks, <literal>@Resource</literal>, <literal>@EJB</literal> " +"and <literal>@PersistenceContext</literal>" +msgstr "" + +#. Tag: para +#: injection.xml:422 +#, no-c-format +msgid "" +"Enterprise Web Beans support all the lifecycle callbacks defined by the EJB " +"specification: <literal>@PostConstruct</literal>, <literal>@PreDestroy</" +"literal>, <literal>@PrePassivate</literal> and <literal>@PostActivate</" +"literal>." +msgstr "" + +#. Tag: para +#: injection.xml:426 +#, no-c-format +msgid "" +"Simple Web Beans support only the <literal>@PostConstruct</literal> and " +"<literal>@PreDestroy</literal> callbacks." +msgstr "" + +#. Tag: para +#: injection.xml:429 +#, no-c-format +msgid "" +"Both enterprise and simple Web Beans support the use of <literal>@Resource</" +"literal>, <literal>@EJB</literal> and <literal>@PersistenceContext</literal> " +"for injection of Java EE resources, EJBs and JPA persistence contexts, " +"respectively. Simple Web Beans do not support the use of " +"<literal>@PersistenceContext(type=EXTENDED)</literal>." +msgstr "" + +#. Tag: para +#: injection.xml:434 +#, no-c-format +msgid "" +"The <literal>@PostConstruct</literal> callback always occurs after all " +"dependencies have been injected." +msgstr "" + +#. Tag: title +#: injection.xml:440 +#, no-c-format +msgid "The <literal>InjectionPoint</literal> object" +msgstr "" + +#. Tag: para +#: injection.xml:442 +#, no-c-format +msgid "" +"There are certain kinds of dependent objectsWeb Beans with scope " +"<literal>@Dependent</literal>that need to know something about the " +"object or injection point into which they are injected in order to be able " +"to do what they do. For example:" +msgstr "" + +#. Tag: para +#: injection.xml:448 +#, no-c-format +msgid "" +"The log category for a <literal>Logger</literal> depends upon the class of " +"the object that owns it." +msgstr "" + +#. Tag: para +#: injection.xml:452 +#, no-c-format +msgid "" +"Injection of a HTTP parameter or header value depends upon what parameter or " +"header name was specified at the injection point." +msgstr "" + +#. Tag: para +#: injection.xml:456 +#, no-c-format +msgid "" +"Injection of the result of an EL expression evaluation depends upon the " +"expression that was specified at the injection point." +msgstr "" + +#. Tag: para +#: injection.xml:461 +#, no-c-format +msgid "" +"A Web Bean with scope <literal>@Dependent</literal> may inject an instance " +"of <literal>InjectionPoint</literal> and access metadata relating to the " +"injection point to which it belongs." +msgstr "" + +#. Tag: para +#: injection.xml:465 +#, no-c-format +msgid "" +"Let's look at an example. The following code is verbose, and vulnerable to " +"refactoring problems:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:468 +#, no-c-format +msgid "<![CDATA[Logger log = Logger.getLogger(MyClass.class.getName());]]>" +msgstr "" + +#. Tag: para +#: injection.xml:470 +#, no-c-format +msgid "" +"This clever little producer method lets you inject a JDK <literal>Logger</" +"literal> without explicitly specifying the log category:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:473 +#, no-c-format +msgid "" +"<![CDATA[class LogFactory {\n" +"\n" +" @Produces Logger createLogger(InjectionPoint injectionPoint) { \n" +" return Logger.getLogger(injectionPoint.getMember().getDeclaringClass()." +"getName()); \n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:475 +#, no-c-format +msgid "We can now write:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:477 +#, no-c-format +msgid "<![CDATA[@Current Logger log;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:479 +#, no-c-format +msgid "" +"Not convinced? Then here's a second example. To inject HTTP parameters, we " +"need to define a binding type:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:482 +#, no-c-format +msgid "" +"<![CDATA[@BindingType\n" +"@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD, FIELD, PARAMETER})\n" +"public @interface HttpParam {\n" +" @NonBinding public String value();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:484 +#, no-c-format +msgid "We would use this binding type at injection points as follows:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:486 +#, no-c-format +msgid "" +"<![CDATA[@HttpParam(\"username\") String username;\n" +"@HttpParam(\"password\") String password;]]>" +msgstr "" + +#. Tag: para +#: injection.xml:488 +#, no-c-format +msgid "The following producer method does the work:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:490 +#, no-c-format +msgid "" +"<![CDATA[class HttpParams\n" +"\n" +" @Produces @HttpParam(\"\")\n" +" String getParamValue(ServletRequest request, InjectionPoint ip) {\n" +" return request.getParameter(ip.getAnnotation(HttpParam.class).value" +"());\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: injection.xml:492 +#, no-c-format +msgid "" +"(Note that the <literal>value()</literal> member of the <literal>HttpParam</" +"literal> annotation is ignored by the Web Bean manager since it is annotated " +"<literal>@NonBinding.</literal>)" +msgstr "" + +#. Tag: para +#: injection.xml:495 +#, no-c-format +msgid "" +"The Web Bean manager provides a built-in Web Bean that implements the " +"<literal>InjectionPoint</literal> interface:" +msgstr "" + +#. Tag: programlisting +#: injection.xml:498 +#, no-c-format +msgid "" +"<![CDATA[public interface InjectionPoint { \n" +" public Object getInstance(); \n" +" public Bean<?> getBean(); \n" +" public Member getMember(): \n" +" public <T extends Annotation> T getAnnotation(Class<T> annotation); \n" +" public Set<T extends Annotation> getAnnotations(); \n" +"}]]>" +msgstr "" Added: doc/trunk/reference/zh-CN/modules/interceptors.po =================================================================== --- doc/trunk/reference/zh-CN/modules/interceptors.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/interceptors.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,572 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: interceptors.xml:4 +#, no-c-format +msgid "Interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:6 +#, no-c-format +msgid "" +"Web Beans re-uses the basic interceptor architecture of EJB 3.0, extending " +"the functionality in two directions:" +msgstr "" + +#. Tag: para +#: interceptors.xml:11 +#, no-c-format +msgid "Any Web Bean may have interceptors, not just session beans." +msgstr "" + +#. Tag: para +#: interceptors.xml:14 +#, no-c-format +msgid "" +"Web Beans features a more sophisticated annotation-based approach to binding " +"interceptors to Web Beans." +msgstr "" + +#. Tag: para +#: interceptors.xml:22 +#, no-c-format +msgid "The EJB specification defines two kinds of interception points:" +msgstr "" + +#. Tag: para +#: interceptors.xml:26 +#, no-c-format +msgid "business method interception, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:29 +#, no-c-format +msgid "lifecycle callback interception." +msgstr "" + +#. Tag: para +#: interceptors.xml:33 +#, no-c-format +msgid "" +"A <emphasis>business method interceptor</emphasis> applies to invocations of " +"methods of the Web Bean by clients of the Web Bean:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:36 +#, no-c-format +msgid "" +"<![CDATA[public class TransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:38 +#, no-c-format +msgid "" +"A <emphasis>lifecycle callback interceptor</emphasis> applies to invocations " +"of lifecycle callbacks by the container:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:41 +#, no-c-format +msgid "" +"<![CDATA[public class DependencyInjectionInterceptor {\n" +" @PostConstruct public void injectDependencies(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:43 +#, no-c-format +msgid "" +"An interceptor class may intercept both lifecycle callbacks and business " +"methods." +msgstr "" + +#. Tag: title +#: interceptors.xml:49 +#, no-c-format +msgid "Interceptor bindings" +msgstr "" + +#. Tag: para +#: interceptors.xml:51 +#, no-c-format +msgid "" +"Suppose we want to declare that some of our Web Beans are transactional. The " +"first thing we need is an <emphasis>interceptor binding annotation</" +"emphasis> to specify exactly which Web Beans we're interested in:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:55 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Transactional {}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:57 +#, no-c-format +msgid "" +"Now we can easily specify that our <literal>ShoppingCart</literal> is a " +"transactional object:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:60 +#, no-c-format +msgid "" +"<![CDATA[@Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:62 +#, no-c-format +msgid "Or, if we prefer, we can specify that just one method is transactional:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:64 +#, no-c-format +msgid "" +"<![CDATA[public class ShoppingCart {\n" +" @Transactional public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:69 +#, no-c-format +msgid "Implementing interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:71 +#, no-c-format +msgid "" +"That's great, but somewhere along the line we're going to have to actually " +"implement the interceptor that provides this transaction management aspect. " +"All we need to do is create a standard EJB interceptor, and annotate it " +"<literal>@Interceptor</literal> and <literal>@Transactional</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:76 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:78 +#, no-c-format +msgid "" +"All Web Beans interceptors are simple Web Beans, and can take advantage of " +"dependency injection and contextual lifecycle management." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:81 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped @Transactional @Interceptor\n" +"public class TransactionInterceptor {\n" +"\n" +" @Resource Transaction transaction;\n" +"\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:83 +#, no-c-format +msgid "Multiple interceptors may use the same interceptor binding type." +msgstr "" + +#. Tag: title +#: interceptors.xml:88 +#, no-c-format +msgid "Enabling interceptors" +msgstr "" + +#. Tag: para +#: interceptors.xml:90 +#, no-c-format +msgid "" +"Finally, we need to <emphasis>enable</emphasis> our interceptor in " +"<literal>web-beans.xml</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:93 +#, no-c-format +msgid "" +"<![CDATA[<Interceptors>\n" +" <tx:TransactionInterceptor/>\n" +"</Interceptors>]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:95 +#, no-c-format +msgid "Whoah! Why the angle bracket stew?" +msgstr "" + +#. Tag: para +#: interceptors.xml:97 +#, no-c-format +msgid "Well, the XML declaration solves two problems:" +msgstr "" + +#. Tag: para +#: interceptors.xml:101 +#, no-c-format +msgid "" +"it enables us to specify a total ordering for all the interceptors in our " +"system, ensuring deterministic behavior, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:105 +#, no-c-format +msgid "it lets us enable or disable interceptor classes at deployment time." +msgstr "" + +#. Tag: para +#: interceptors.xml:109 +#, no-c-format +msgid "" +"For example, we could specify that our security interceptor runs before our " +"<literal>TransactionInterceptor</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:112 +#, no-c-format +msgid "" +"<![CDATA[<Interceptors>\n" +" <sx:SecurityInterceptor/>\n" +" <tx:TransactionInterceptor/>\n" +"</Interceptors>]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:114 +#, no-c-format +msgid "Or we could turn them both off in our test environment!" +msgstr "" + +#. Tag: title +#: interceptors.xml:119 +#, no-c-format +msgid "Interceptor bindings with members" +msgstr "" + +#. Tag: para +#: interceptors.xml:121 +#, no-c-format +msgid "" +"Suppose we want to add some extra information to our " +"<literal>@Transactional</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:124 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Transactional {\n" +" boolean requiresNew() default false;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:126 +#, no-c-format +msgid "" +"Web Beans will use the value of <literal>requiresNew</literal> to choose " +"between two different interceptors, <literal>TransactionInterceptor</" +"literal> and <literal>RequiresNewTransactionInterceptor</literal>." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:130 +#, no-c-format +msgid "" +"<![CDATA[@Transactional(requiresNew=true) @Interceptor\n" +"public class RequiresNewTransactionInterceptor {\n" +" @AroundInvoke public Object manageTransaction(InvocationContext ctx) " +"{ ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:132 +#, no-c-format +msgid "" +"Now we can use <literal>RequiresNewTransactionInterceptor</literal> like " +"this:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:134 +#, no-c-format +msgid "" +"<![CDATA[@Transactional(requiresNew=true)\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:136 +#, no-c-format +msgid "" +"But what if we only have one interceptor and we want the manager to ignore " +"the value of <literal>requiresNew</literal> when binding interceptors? We " +"can use the <literal>@NonBinding</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:140 +#, no-c-format +msgid "" +"<![CDATA[@InterceptorBindingType\n" +"@Target({METHOD, TYPE})\n" +"@Retention(RUNTIME)\n" +"public @interface Secure {\n" +" @NonBinding String[] rolesAllowed() default {};\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:145 +#, no-c-format +msgid "Multiple interceptor binding annotations" +msgstr "" + +#. Tag: para +#: interceptors.xml:147 +#, no-c-format +msgid "" +"Usually we use combinations of interceptor bindings types to bind multiple " +"interceptors to a Web Bean. For example, the following declaration would be " +"used to bind <literal>TransactionInterceptor</literal> and " +"<literal>SecurityInterceptor</literal> to the same Web Bean:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:152 +#, no-c-format +msgid "" +"<![CDATA[@Secure(rolesAllowed=\"admin\") @Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:154 +#, no-c-format +msgid "" +"However, in very complex cases, an interceptor itself may specify some " +"combination of interceptor binding types:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:157 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure @Interceptor\n" +"public class TransactionalSecureInterceptor { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:159 +#, no-c-format +msgid "" +"Then this interceptor could be bound to the <literal>checkout()</literal> " +"method using any one of the following combinations:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:162 +#, no-c-format +msgid "" +"<![CDATA[public class ShoppingCart {\n" +" @Transactional @Secure public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:164 +#, no-c-format +msgid "" +"<![CDATA[@Secure\n" +"public class ShoppingCart {\n" +" @Transactional public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:166 +#, no-c-format +msgid "" +"<![CDATA[@Transactionl\n" +"public class ShoppingCart {\n" +" @Secure public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:168 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure\n" +"public class ShoppingCart {\n" +" public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: title +#: interceptors.xml:173 +#, no-c-format +msgid "Interceptor binding type inheritance" +msgstr "" + +#. Tag: para +#: interceptors.xml:175 +#, no-c-format +msgid "" +"One limitation of the Java language support for annotations is the lack of " +"annotation inheritance. Really, annotations should have reuse built in, to " +"allow this kind of thing to work:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:179 +#, no-c-format +msgid "" +"<![CDATA[public @interface Action extends Transactional, Secure { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:181 +#, no-c-format +msgid "" +"Well, fortunately, Web Beans works around this missing feature of Java. We " +"may annotate one interceptor binding type with other interceptor binding " +"types. The interceptor bindings are transitiveany Web Bean with the " +"first interceptor binding inherits the interceptor bindings declared as meta-" +"annotations." +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:186 +#, no-c-format +msgid "" +"<![CDATA[@Transactional @Secure\n" +"@InterceptorBindingType\n" +"@Target(TYPE)\n" +"@Retention(RUNTIME)\n" +"public @interface Action { ... }]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:188 +#, no-c-format +msgid "" +"Any Web Bean annotated <literal>@Action</literal> will be bound to both " +"<literal>TransactionInterceptor</literal> and <literal>SecurityInterceptor</" +"literal>. (And even <literal>TransactionalSecureInterceptor</literal>, if it " +"exists.)" +msgstr "" + +#. Tag: title +#: interceptors.xml:195 +#, no-c-format +msgid "Use of <literal>@Interceptors</literal>" +msgstr "" + +#. Tag: para +#: interceptors.xml:197 +#, no-c-format +msgid "" +"The <literal>@Interceptors</literal> annotation defined by the EJB " +"specification is supported for both enterprise and simple Web Beans, for " +"example:" +msgstr "" + +#. Tag: programlisting +#: interceptors.xml:200 +#, no-c-format +msgid "" +"<![CDATA[(a)Interceptors({TransactionInterceptor.class, @SecurityInterceptor." +"class})\n" +"public class ShoppingCart {\n" +" public void checkout() { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: interceptors.xml:202 +#, no-c-format +msgid "However, this approach suffers the following drawbacks:" +msgstr "" + +#. Tag: para +#: interceptors.xml:206 +#, no-c-format +msgid "the interceptor implementation is hardcoded in business code," +msgstr "" + +#. Tag: para +#: interceptors.xml:209 +#, no-c-format +msgid "interceptors may not be easily disabled at deployment time, and" +msgstr "" + +#. Tag: para +#: interceptors.xml:212 +#, no-c-format +msgid "" +"the interceptor ordering is non-globalit is determined by the order in " +"which interceptors are listed at the class level." +msgstr "" + +#. Tag: para +#: interceptors.xml:217 +#, no-c-format +msgid "" +"Therefore, we recommend the use of Web Beans-style interceptor bindings." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/intro.po =================================================================== --- doc/trunk/reference/zh-CN/modules/intro.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/intro.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,1075 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: intro.xml:4 +#, no-c-format +msgid "Getting started with Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:6 +#, no-c-format +msgid "" +"So you're already keen to get started writing your first Web Bean? Or " +"perhaps you're skeptical, wondering what kinds of hoops the Web Beans " +"specification will make you jump through! The good news is that you've " +"probably already written and used hundreds, perhaps thousands of Web Beans. " +"You might not even remember the first Web Bean you wrote." +msgstr "" + +#. Tag: title +#: intro.xml:13 +#, no-c-format +msgid "Your first Web Bean" +msgstr "" + +#. Tag: para +#: intro.xml:15 +#, no-c-format +msgid "" +"With certain, very special exceptions, every Java class with a constructor " +"that accepts no parameters is a Web Bean. That includes every JavaBean. " +"Furthermore, every EJB 3-style session bean is a Web Bean. Sure, the " +"JavaBeans and EJBs you've been writing every day have not been able to take " +"advantage of the new services defined by the Web Beans specification, but " +"you'll be able to use every one of them as Web Beansinjecting them " +"into other Web Beans, configuring them via the Web Beans XML configuration " +"facility, even adding interceptors and decorators to themwithout " +"touching your existing code." +msgstr "" + +#. Tag: para +#: intro.xml:25 +#, no-c-format +msgid "" +"Suppose that we have two existing Java classes, that we've been using for " +"years in various applications. The first class parses a string into a list " +"of sentences:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:29 +#, no-c-format +msgid "" +"<![CDATA[public class SentenceParser {\n" +" public List<String> parse(String text) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:31 +#, no-c-format +msgid "" +"The second existing class is a stateless session bean front-end for an " +"external system that is able to translate sentences from one language to " +"another:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:35 +#, no-c-format +msgid "" +"<![CDATA[@Stateless\n" +"public class SentenceTranslator implements Translator {\n" +" public String translate(String sentence) { ... }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:37 +#, no-c-format +msgid "Where <literal>Translator</literal> is the local interface:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:39 +#, no-c-format +msgid "" +"<![CDATA[@Local\n" +"public interface Translator {\n" +" public String translate(String sentence);\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:41 +#, no-c-format +msgid "" +"Unfortunately, we don't have a preexisting class that translates whole text " +"documents. So let's write a Web Bean that does this job:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:44 +#, no-c-format +msgid "" +"<![CDATA[public class TextTranslator {\n" +" \n" +" private SentenceParser sentenceParser;\n" +" private Translator sentenceTranslator;\n" +" \n" +" @Initializer\n" +" TextTranslator(SentenceParser sentenceParser, Translator " +"sentenceTranslator) {\n" +" this.sentenceParser = sentenceParser;\n" +" this.sentenceTranslator = sentenceTranslator;\n" +" }\n" +" \n" +" public String translate(String text) {\n" +" StringBuilder sb = new StringBuilder();\n" +" for (String sentence: sentenceParser.parse(text)) {\n" +" sb.append(sentenceTranslator.translate(sentence));\n" +" }\n" +" return sb.toString();\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:46 +#, no-c-format +msgid "" +"We may obtain an instance of <literal>TextTranslator</literal> by injecting " +"it into a Web Bean, Servlet or EJB:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:49 +#, no-c-format +msgid "" +"<![CDATA[@Initializer\n" +"public setTextTranslator(TextTranslator textTranslator) {\n" +" this.textTranslator = textTranslator;\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:51 +#, no-c-format +msgid "" +"Alternatively, we may obtain an instance by directly calling a method of the " +"Web Bean manager:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:54 +#, no-c-format +msgid "" +"<![CDATA[TextTranslator tt = manager.getInstanceByType(TextTranslator." +"class);]]>" +msgstr "" + +#. Tag: para +#: intro.xml:56 +#, no-c-format +msgid "" +"But wait: <literal>TextTranslator</literal> does not have a constructor with " +"no parameters! Is it still a Web Bean? Well, a class that does not have a " +"constructor with no parameters can still be a Web Bean if it has a " +"constructor annotated <literal>@Initializer</literal>." +msgstr "" + +#. Tag: para +#: intro.xml:61 +#, no-c-format +msgid "" +"As you've guessed, the <literal>@Initializer</literal> annotation has " +"something to do with dependency injection! <literal>@Initializer</literal> " +"may be applied to a constructor or method of a Web Bean, and tells the Web " +"Bean manager to call that constructor or method when instantiating the Web " +"Bean. The Web Bean manager will inject other Web Beans to the parameters of " +"the constructor or method." +msgstr "" + +#. Tag: para +#: intro.xml:68 +#, no-c-format +msgid "" +"At system initialization time, the Web Bean manager must validate that " +"exactly one Web Bean exists which satisfies each injection point. In our " +"example, if no implementation of <literal>Translator</literal> " +"availableif the <literal>SentenceTranslator</literal> EJB was not " +"deployedthe Web Bean manager would throw an " +"<literal>UnsatisfiedDependencyException</literal>. If more than one " +"implementation of <literal>Translator</literal> was available, the Web Bean " +"manager would throw an <literal>AmbiguousDependencyException</literal>." +msgstr "" + +#. Tag: title +#: intro.xml:80 +#, no-c-format +msgid "What is a Web Bean?" +msgstr "" + +#. Tag: para +#: intro.xml:82 +#, no-c-format +msgid "So what, <emphasis>exactly</emphasis>, is a Web Bean?" +msgstr "" + +#. Tag: para +#: intro.xml:84 +#, no-c-format +msgid "" +"A Web Bean is an application class that contains business logic. A Web Bean " +"may be called directly from Java code, or it may be invoked via Unified EL. " +"A Web Bean may access transactional resources. Dependencies between Web " +"Beans are managed automatically by the Web Bean manager. Most Web Beans are " +"<emphasis>stateful</emphasis> and <emphasis>contextual</emphasis>. The " +"lifecycle of a Web Bean is always managed by the Web Bean manager." +msgstr "" + +#. Tag: para +#: intro.xml:91 +#, no-c-format +msgid "" +"Let's back up a second. What does it really mean to be \"contextual\"? Since " +"Web Beans may be stateful, it matters <emphasis>which</emphasis> bean " +"instance I have. Unlike a stateless component model (for example, stateless " +"session beans) or a singleton component model (such as servlets, or " +"singleton beans), different clients of a Web Bean see the Web Bean in " +"different states. The client-visible state depends upon which instance of " +"the Web Bean the client has a reference to." +msgstr "" + +#. Tag: para +#: intro.xml:98 +#, no-c-format +msgid "" +"However, like a stateless or singleton model, but <emphasis>unlike</" +"emphasis> stateful session beans, the client does not control the lifecycle " +"of the instance by explicitly creating and destroying it. Instead, the " +"<emphasis>scope</emphasis> of the Web Bean determines:" +msgstr "" + +#. Tag: para +#: intro.xml:105 +#, no-c-format +msgid "the lifecycle of each instance of the Web Bean and" +msgstr "" + +#. Tag: para +#: intro.xml:108 +#, no-c-format +msgid "" +"which clients share a reference to a particular instance of the Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:113 +#, no-c-format +msgid "" +"For a given thread in a Web Beans application, there may be an " +"<emphasis>active context</emphasis> associated with the scope of the Web " +"Bean. This context may be unique to the thread (for example, if the Web Bean " +"is request scoped), or it may be shared with certain other threads (for " +"example, if the Web Bean is session scoped) or even all other threads (if it " +"is application scoped)." +msgstr "" + +#. Tag: para +#: intro.xml:119 +#, no-c-format +msgid "" +"Clients (for example, other Web Beans) executing in the same context will " +"see the same instance of the Web Bean. But clients in a different context " +"will see a different instance." +msgstr "" + +#. Tag: para +#: intro.xml:123 +#, no-c-format +msgid "" +"One great advantage of the contextual model is that it allows stateful Web " +"Beans to be treated like services! The client need not concern itself with " +"managing the lifecycle of the Web Bean it is using, <emphasis>nor does it " +"even need to know what that lifecyle is.</emphasis> Web Beans interact by " +"passing messages, and the Web Bean implementations define the lifecycle of " +"their own state. The Web Beans are loosely coupled because:" +msgstr "" + +#. Tag: para +#: intro.xml:132 +#, no-c-format +msgid "they interact via well-defined public APIs" +msgstr "" + +#. Tag: para +#: intro.xml:135 +#, no-c-format +msgid "their lifecycles are completely decoupled" +msgstr "" + +#. Tag: para +#: intro.xml:139 +#, no-c-format +msgid "" +"We can replace one Web Bean with a different Web Bean that implements the " +"same API and has a different lifecycle (a different scope) without affecting " +"the other Web Bean implementation. In fact, Web Beans defines a " +"sophisticated facility for overriding Web Bean implementations at deployment " +"time, as we will see in <xref linkend=\"deploymenttypes\"/>." +msgstr "" + +#. Tag: para +#: intro.xml:145 +#, no-c-format +msgid "" +"Note that not all clients of a Web Bean are Web Beans. Other objects such as " +"Servlets or Message-Driven Beanswhich are by nature not injectable, " +"contextual objectsmay also obtain references to Web Beans by injection." +msgstr "" + +#. Tag: para +#: intro.xml:149 +#, no-c-format +msgid "Enough hand-waving. More formally, according to the spec:" +msgstr "" + +#. Tag: para +#: intro.xml:153 +#, no-c-format +msgid "A Web Bean comprises:" +msgstr "" + +#. Tag: para +#: intro.xml:156 +#, no-c-format +msgid "A (nonempty) set of API types" +msgstr "" + +#. Tag: para +#: intro.xml:157 +#, no-c-format +msgid "A (nonempty) set of binding annotation types" +msgstr "" + +#. Tag: para +#: intro.xml:158 +#, no-c-format +msgid "A scope" +msgstr "" + +#. Tag: para +#: intro.xml:159 +#, no-c-format +msgid "A deployment type" +msgstr "" + +#. Tag: para +#: intro.xml:160 +#, no-c-format +msgid "Optionally, a Web Bean name" +msgstr "" + +#. Tag: para +#: intro.xml:161 +#, no-c-format +msgid "A set of interceptor binding types" +msgstr "" + +#. Tag: para +#: intro.xml:162 +#, no-c-format +msgid "A Web Bean implementation" +msgstr "" + +#. Tag: para +#: intro.xml:167 +#, no-c-format +msgid "Let's see what some of these terms mean, to the Web Bean developer." +msgstr "" + +#. Tag: title +#: intro.xml:170 +#, no-c-format +msgid "API types, binding types and dependency injection" +msgstr "" + +#. Tag: para +#: intro.xml:172 +#, no-c-format +msgid "" +"Web Beans usually acquire references to other Web Beans via dependency " +"injection. Any injected attribute specifies a \"contract\" that must be " +"satisfied by the Web Bean to be injected. The contract is:" +msgstr "" + +#. Tag: para +#: intro.xml:177 +#, no-c-format +msgid "an API type, together with" +msgstr "" + +#. Tag: para +#: intro.xml:178 +#, no-c-format +msgid "a set of binding types." +msgstr "" + +#. Tag: para +#: intro.xml:181 +#, no-c-format +msgid "" +"An API is a user-defined class or interface. (If the Web Bean is an EJB " +"session bean, the API type is the <literal>@Local</literal> interface or " +"bean-class local view). A binding type represents some client-visible " +"semantic that is satisfied by some implementations of the API and not by " +"others." +msgstr "" + +#. Tag: para +#: intro.xml:186 +#, no-c-format +msgid "" +"Binding types are represented by user-defined annotations that are " +"themselves annotated <literal>@BindingType</literal>. For example, the " +"following injection point has API type <literal>PaymentProcessor</literal> " +"and binding type <literal>@CreditCard</literal>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:191 +#, no-c-format +msgid "<![CDATA[@CreditCard PaymentProcessor paymentProcessor]]>" +msgstr "" + +#. Tag: para +#: intro.xml:193 +#, no-c-format +msgid "" +"If no binding type is explicitly specified at an injection point, the " +"default binding type <literal>@Current</literal> is assumed." +msgstr "" + +#. Tag: para +#: intro.xml:196 +#, no-c-format +msgid "" +"For each injection point, the Web Bean manager searches for a Web Bean which " +"satisfies the contract (implements the API, and has all the binding types), " +"and injects that Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:200 +#, no-c-format +msgid "" +"The following Web Bean has the binding type <literal>@CreditCard</literal> " +"and implements the API type <literal>PaymentProcessor</literal>. It could " +"therefore be injected to the example injection point:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:204 +#, no-c-format +msgid "" +"<![CDATA[@CreditCard\n" +"public class CreditCardPaymentProcessor \n" +" implements PaymentProcessor { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:206 +#, no-c-format +msgid "" +"If a Web Bean does not explicitly specify a set of binding types, it has " +"exactly one binding type: the default binding type <literal>@Current</" +"literal>." +msgstr "" + +#. Tag: para +#: intro.xml:209 +#, no-c-format +msgid "" +"Web Beans defines a sophisticated but intuitive <emphasis>resolution " +"algorithm</emphasis> that helps the container decide what to do if there is " +"more than one Web Bean that satisfies a particular contract. We'll get into " +"the details in <xref linkend=\"injection\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:217 +#, no-c-format +msgid "Deployment types" +msgstr "" + +#. Tag: para +#: intro.xml:219 +#, no-c-format +msgid "" +"<emphasis>Deployment types</emphasis> let us classify our Web Beans by " +"deployment scenario. A deployment type is an annotation that represents a " +"particular deployment scenario, for example <literal>@Mock</literal>, " +"<literal>@Staging</literal> or <literal>@AustralianTaxLaw</literal>. We " +"apply the annotation to Web Beans which should be deployed in that scenario. " +"A deployment type allows a whole set of Web Beans to be conditionally " +"deployed, with a just single line of configuration." +msgstr "" + +#. Tag: para +#: intro.xml:226 +#, no-c-format +msgid "" +"Many Web Beans just use the default deployment type <literal>@Production</" +"literal>, in which case no deployment type need be explicitly specified. All " +"three Web Bean in our example have the deployment type <literal>@Production</" +"literal>." +msgstr "" + +#. Tag: para +#: intro.xml:230 +#, no-c-format +msgid "" +"In a testing environment, we might want to replace the " +"<literal>SentenceTranslator</literal> Web Bean with a \"mock object\":" +msgstr "" + +#. Tag: programlisting +#: intro.xml:233 +#, no-c-format +msgid "" +"<![CDATA[@Mock\n" +"public class MockSentenceTranslator implements Translator {\n" +" public String translate(String sentence) {\n" +" return \"Lorem ipsum dolor sit amet\";\n" +" }\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:236 +#, no-c-format +msgid "" +"We would enable the deployment type <literal>@Mock</literal> in our testing " +"environment, to indicate that <literal>MockSentenceTranslator</literal> and " +"any other Web Bean annotated <literal>@Mock</literal> should be used." +msgstr "" + +#. Tag: para +#: intro.xml:240 +#, no-c-format +msgid "" +"We'll talk more about this unique and powerful feature in <xref linkend=" +"\"deploymenttypes\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:246 +#, no-c-format +msgid "Scope" +msgstr "" + +#. Tag: para +#: intro.xml:248 +#, no-c-format +msgid "" +"The <emphasis>scope</emphasis> defines the lifecycle and visibility of " +"instances of the Web Bean. The Web Beans context model is extensible, " +"accommodating arbitrary scopes. However, certain important scopes are built-" +"in to the specification, and provided by the Web Bean manager. A scope is " +"represented by an annotation type." +msgstr "" + +#. Tag: para +#: intro.xml:254 +#, no-c-format +msgid "" +"For example, any web application may have <emphasis>session scoped</" +"emphasis> Web Beans:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:257 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:259 +#, no-c-format +msgid "" +"An instance of a session scoped Web Bean is bound to a user session and is " +"shared by all requests that execute in the context of that session." +msgstr "" + +#. Tag: para +#: intro.xml:262 +#, no-c-format +msgid "" +"By default, Web Beans belong to a special scope called the " +"<emphasis>dependent pseudo-scope</emphasis>. Web Beans with this scope are " +"pure dependent objects of the object into which they are injected, and their " +"lifecycle is bound to the lifecycle of that object." +msgstr "" + +#. Tag: para +#: intro.xml:267 +#, no-c-format +msgid "We'll talk more about scopes in <xref linkend=\"scopescontexts\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:272 +#, no-c-format +msgid "Web Bean names and Unified EL" +msgstr "" + +#. Tag: para +#: intro.xml:274 +#, no-c-format +msgid "" +"A Web Bean may have a <emphasis>name</emphasis>, allowing it to be used in " +"Unified EL expressions. It's easy to specify the name of a Web Bean:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:278 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named(\"cart\")\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:280 +#, no-c-format +msgid "Now we can easily use the Web Bean in any JSF or JSP page:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:282 +#, no-c-format +msgid "" +"<![CDATA[<h:dataTable value=\"#{cart.lineItems}\" var=\"item\">\n" +" ....\n" +"</h:dataTable>]]>" +msgstr "" + +#. Tag: para +#: intro.xml:284 +#, no-c-format +msgid "" +"It's even easier to just let the name be defaulted by the Web Bean manager:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:287 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Named\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:289 +#, no-c-format +msgid "" +"In this case, the name defaults to <literal>shoppingCart</literal>the " +"unqualified class name, with the first character changed to lowercase." +msgstr "" + +#. Tag: title +#: intro.xml:295 +#, no-c-format +msgid "Interceptor binding types" +msgstr "" + +#. Tag: para +#: intro.xml:297 +#, no-c-format +msgid "" +"Web Beans supports the interceptor functionality defined by EJB 3, not only " +"for EJB beans, but also for plain Java classes. In addition, Web Beans " +"provides a new approach to binding interceptors to EJB beans and other Web " +"Beans." +msgstr "" + +#. Tag: para +#: intro.xml:302 +#, no-c-format +msgid "" +"It remains possible to directly specify the interceptor class via use of the " +"<literal>@Interceptors</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:305 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped \n" +"@Interceptors(TransactionInterceptor.class)\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:307 +#, no-c-format +msgid "" +"However, it is more elegant, and better practice, to indirect the " +"interceptor binding through an <emphasis>interceptor binding type</emphasis>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:311 +#, no-c-format +msgid "" +"<![CDATA[@SessionScoped @Transactional\n" +"public class ShoppingCart { ... }]]>" +msgstr "" + +#. Tag: para +#: intro.xml:313 +#, no-c-format +msgid "" +"We'll discuss Web Beans interceptors and decorators in <xref linkend=" +"\"interceptors\"/> and <xref linkend=\"decorators\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:321 +#, no-c-format +msgid "What kinds of objects can be Web Beans?" +msgstr "" + +#. Tag: para +#: intro.xml:323 +#, no-c-format +msgid "" +"We've already seen that JavaBeans, EJBs and some other Java classes can be " +"Web Beans. But exactly what kinds of objects are Web Beans?" +msgstr "" + +#. Tag: title +#: intro.xml:327 +#, no-c-format +msgid "Simple Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:329 +#, no-c-format +msgid "" +"The Web Beans specification says that a concrete Java class is a " +"<emphasis>simple</emphasis> Web Bean if:" +msgstr "" + +#. Tag: para +#: intro.xml:334 +#, no-c-format +msgid "" +"it is not an EE container-managed component, like an EJB, a Servlet or a JPA " +"entity," +msgstr "" + +#. Tag: para +#: intro.xml:338 +#, no-c-format +msgid "it is not a non-static static inner class," +msgstr "" + +#. Tag: para +#: intro.xml:341 +#, no-c-format +msgid "it is not a parameterized type, and" +msgstr "" + +#. Tag: para +#: intro.xml:344 +#, no-c-format +msgid "" +"it has a constructor with no parameters, or a constructor annotated " +"<literal>@Initializer</literal>." +msgstr "" + +#. Tag: para +#: intro.xml:349 +#, no-c-format +msgid "Thus, almost every JavaBean is a simple Web Bean." +msgstr "" + +#. Tag: para +#: intro.xml:351 +#, no-c-format +msgid "" +"Every interface implemented directly or indirectly by a simple Web Bean is " +"an API type of the simple Web Bean. The class and its superclasses are also " +"API types." +msgstr "" + +#. Tag: title +#: intro.xml:358 +#, no-c-format +msgid "Enterprise Web Beans" +msgstr "" + +#. Tag: para +#: intro.xml:360 +#, no-c-format +msgid "" +"The specification says that all EJB 3-style session and singleton beans are " +"<emphasis>enterprise</emphasis> Web Beans. Message driven beans are not Web " +"Beanssince they are not intended to be injected into other " +"objectsbut they can take advantage of most of the functionality of Web " +"Beans, including dependency injection and interceptors." +msgstr "" + +#. Tag: para +#: intro.xml:366 +#, no-c-format +msgid "" +"Every local interface of an enterprise Web Bean that does not have a " +"wildcard type parameter or type variable, and every one of its " +"superinterfaces, is an API type of the enterprise Web Bean. If the EJB bean " +"has a bean class local view, the bean class, and every one of its " +"superclasses, is also an API type." +msgstr "" + +#. Tag: para +#: intro.xml:372 +#, no-c-format +msgid "" +"Stateful session beans should declare a remove method with no parameters or " +"a remove method annotated <literal>@Destructor</literal>. The Web Bean " +"manager calls this method to destroy the stateful session bean instance at " +"the end of its lifecycle. This method is called the <emphasis>destructor</" +"emphasis> method of the enterprise Web Bean." +msgstr "" + +#. Tag: programlisting +#: intro.xml:378 +#, no-c-format +msgid "" +"<![CDATA[@Stateful @SessionScoped\n" +"public class ShoppingCart {\n" +"\n" +" ...\n" +" \n" +" @Remove\n" +" public void destroy() {}\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:380 +#, no-c-format +msgid "" +"So when should we use an enterprise Web Bean instead of a simple Web Bean? " +"Well, whenever we need the advanced enterprise services offered by EJB, such " +"as:" +msgstr "" + +#. Tag: para +#: intro.xml:387 +#, no-c-format +msgid "method-level transaction management and security," +msgstr "" + +#. Tag: para +#: intro.xml:390 +#, no-c-format +msgid "concurrency management," +msgstr "" + +#. Tag: para +#: intro.xml:393 +#, no-c-format +msgid "" +"instance-level passivation for stateful session beans and instance-pooling " +"for stateless session beans," +msgstr "" + +#. Tag: para +#: intro.xml:397 +#, no-c-format +msgid "remote and web service invocation, and" +msgstr "" + +#. Tag: para +#: intro.xml:400 +#, no-c-format +msgid "timers and asynchronous methods," +msgstr "" + +#. Tag: para +#: intro.xml:404 +#, no-c-format +msgid "" +"we should use an enterprise Web Bean. When we don't need any of these " +"things, a simple Web Bean will serve just fine." +msgstr "" + +#. Tag: para +#: intro.xml:407 +#, no-c-format +msgid "" +"Many Web Beans (including any session or application scoped Web Bean) are " +"available for concurrent access. Therefore, the concurrency management " +"provided by EJB 3.1 is especially useful. Most session and application " +"scoped Web Beans should be EJBs." +msgstr "" + +#. Tag: para +#: intro.xml:412 +#, no-c-format +msgid "" +"Web Beans which hold references to heavy-weight resources, or hold a lot of " +"internal state benefit from the advanced container-managed lifecycle defined " +"by the EJB <literal>@Stateless</literal>/<literal>@Stateful</literal>/" +"<literal>@Singleton</literal> model, with its support for passivation and " +"instance pooling." +msgstr "" + +#. Tag: para +#: intro.xml:417 +#, no-c-format +msgid "" +"Finally, it's usually obvious when method-level transaction management, " +"method-level security, timers, remote methods or asynchronous methods are " +"needed." +msgstr "" + +#. Tag: para +#: intro.xml:420 +#, no-c-format +msgid "" +"It's usually easy to start with simple Web Bean, and then turn it into an " +"EJB, just by adding an annotation: <literal>@Stateless</literal>, " +"<literal>@Stateful</literal> or <literal>@Singleton</literal>." +msgstr "" + +#. Tag: title +#: intro.xml:427 +#, no-c-format +msgid "Producer methods" +msgstr "" + +#. Tag: para +#: intro.xml:429 +#, no-c-format +msgid "" +"A <emphasis>producer method</emphasis> is a method that is called by the Web " +"Bean manager to obtain an instance of the Web Bean when no instance exists " +"in the current context. A producer method lets the application take full " +"control of the instantiation process, instead of leaving instantiation to " +"the Web Bean manager. For example:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:435 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped\n" +"public class Generator {\n" +"\n" +" private Random random = new Random( System.currentTimeMillis() );\n" +" \n" +" @Produces @Random int next() {\n" +" return random.nextInt(100);\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:437 +#, no-c-format +msgid "" +"The result of a producer method is injected just like any other Web Bean." +msgstr "" + +#. Tag: programlisting +#: intro.xml:439 +#, no-c-format +msgid "<![CDATA[@Random int randomNumber]]>" +msgstr "" + +#. Tag: para +#: intro.xml:441 +#, no-c-format +msgid "" +"The method return type and all interfaces it extends/implements directly or " +"indirectly are API types of the producer method. If the return type is a " +"class, all superclasses are also API types." +msgstr "" + +#. Tag: para +#: intro.xml:445 +#, no-c-format +msgid "Some producer methods return objects that require explicit destruction:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:447 +#, no-c-format +msgid "" +"<![CDATA[@Produces @RequestScoped Connection connect(User user) {\n" +" return createConnection( user.getId(), user.getPassword() );\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:449 +#, no-c-format +msgid "" +"These producer methods may define matching <emphasis>disposal methods</" +"emphasis>:" +msgstr "" + +#. Tag: programlisting +#: intro.xml:451 +#, no-c-format +msgid "" +"<![CDATA[void close(@Disposes Connection connection) {\n" +" connection.close();\n" +"}]]>" +msgstr "" + +#. Tag: para +#: intro.xml:453 +#, no-c-format +msgid "" +"This disposal method is called automatically by the Web Bean manager at the " +"end of the request." +msgstr "" + +#. Tag: para +#: intro.xml:456 +#, no-c-format +msgid "" +"We'll talk much more about producer methods in <xref linkend=" +"\"producermethods\"/>." +msgstr "" + +#. Tag: title +#: intro.xml:461 +#, no-c-format +msgid "JMS endpoints" +msgstr "" + +#. Tag: para +#: intro.xml:463 +#, no-c-format +msgid "" +"Finally, a JMS queue or topic can be a Web Bean. Web Beans relieves the " +"developer from the tedium of managing the lifecycles of all the various JMS " +"objects required to send messages to queues and topics. We'll discuss JMS " +"endpoints in <xref linkend=\"jms\"/>." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/next.po =================================================================== --- doc/trunk/reference/zh-CN/modules/next.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/next.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,49 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: next.xml:4 +#, no-c-format +msgid "Next steps" +msgstr "" + +#. Tag: para +#: next.xml:6 +#, no-c-format +msgid "" +"Because Web Beans is so new, there's not yet a lot of information available " +"online." +msgstr "" + +#. Tag: para +#: next.xml:9 +#, no-c-format +msgid "" +"Of course, the Web Beans specification is the best source of more " +"information about Web Beans. The spec is about 100 pages long, only twice " +"the length of this article, and almost as readable. But, of course, it " +"covers many details that we've skipped over. The spec is available from " +"<literal>http://jcp.org/en/jsr/detail?id=299</literal>." +msgstr "" + +#. Tag: para +#: next.xml:15 +#, no-c-format +msgid "" +"The Web Beans Reference implementation is being developed at <literal>http://" +"seamframework.org/WebBeans</literal>. The RI development team and the Web " +"Beans spec lead blog at <literal>http://in.relation.to</literal>. This " +"article is substantially based upon a series of blog entries published there." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/part1.po =================================================================== --- doc/trunk/reference/zh-CN/modules/part1.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/part1.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,229 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part1.xml:5 +#, no-c-format +msgid "" +"The Web Beans (JSR-299) specification defines a set of services for the Java " +"EE environment that makes applications much easier to develop. Web Beans " +"layers an enhanced lifecycle and interaction model over existing Java " +"component types including JavaBeans and Enterprise Java Beans. As a " +"complement to the traditional Java EE programming model, the Web Beans " +"services provide:" +msgstr "" + +#. Tag: para +#: part1.xml:14 +#, no-c-format +msgid "" +"an improved lifecycle for stateful components, bound to well-defined " +"<emphasis>contexts</emphasis>," +msgstr "" + +#. Tag: para +#: part1.xml:18 +#, no-c-format +msgid "a typesafe approach to <emphasis>dependency injection</emphasis>," +msgstr "" + +#. Tag: para +#: part1.xml:21 +#, no-c-format +msgid "" +"interaction via an <emphasis>event notification</emphasis> facility, and" +msgstr "" + +#. Tag: para +#: part1.xml:25 +#, no-c-format +msgid "" +"a better approach to binding <emphasis>interceptors</emphasis> to " +"components, along with a new kind of interceptor, called a " +"<emphasis>decorator</emphasis>, that is more appropriate for use in solving " +"business problems." +msgstr "" + +#. Tag: para +#: part1.xml:32 +#, no-c-format +msgid "" +"Dependency injection, together with contextual lifecycle management, saves " +"the user of an unfamiliar API from having to ask and answer the following " +"questions:" +msgstr "" + +#. Tag: para +#: part1.xml:38 +#, no-c-format +msgid "what is the lifecycle of this object?" +msgstr "" + +#. Tag: para +#: part1.xml:41 +#, no-c-format +msgid "how many simultaneous clients can it have?" +msgstr "" + +#. Tag: para +#: part1.xml:44 +#, no-c-format +msgid "is it multithreaded?" +msgstr "" + +#. Tag: para +#: part1.xml:47 +#, no-c-format +msgid "where can I get one from?" +msgstr "" + +#. Tag: para +#: part1.xml:50 +#, no-c-format +msgid "do I need to explicitly destroy it?" +msgstr "" + +#. Tag: para +#: part1.xml:53 +#, no-c-format +msgid "where should I keep my reference to it when I'm not using it directly?" +msgstr "" + +#. Tag: para +#: part1.xml:57 +#, no-c-format +msgid "" +"how can I add an indirection layer, so that the implementation of this " +"object can vary at deployment time?" +msgstr "" + +#. Tag: para +#: part1.xml:61 +#, no-c-format +msgid "how should I go about sharing this object between other objects?" +msgstr "" + +#. Tag: para +#: part1.xml:65 +#, no-c-format +msgid "" +"A Web Bean specifies only the type and semantics of other Web Beans it " +"depends upon. It need not be aware of the actual lifecycle, concrete " +"implementation, threading model or other clients of any Web Bean it depends " +"upon. Even better, the concrete implementation, lifecycle and threading " +"model of a Web Bean it depends upon may vary according to the deployment " +"scenario, without affecting any client." +msgstr "" + +#. Tag: para +#: part1.xml:72 +#, no-c-format +msgid "" +"Events, interceptors and decorators enhance the <emphasis>loose-coupling</" +"emphasis> that is inherent in this model:" +msgstr "" + +#. Tag: para +#: part1.xml:77 +#, no-c-format +msgid "" +"<emphasis>event notifications</emphasis> decouple event producers from event " +"consumers," +msgstr "" + +#. Tag: para +#: part1.xml:81 +#, no-c-format +msgid "" +"<emphasis>interceptors</emphasis> decouple technical concerns from business " +"logic, and" +msgstr "" + +#. Tag: para +#: part1.xml:85 +#, no-c-format +msgid "" +"<emphasis>decorators</emphasis> allow business concerns to be " +"compartmentalized." +msgstr "" + +#. Tag: para +#: part1.xml:90 +#, no-c-format +msgid "" +"Most importantly, Web Beans provides all these facilities in a " +"<emphasis>typesafe</emphasis> way. Web Beans never uses string-based " +"identifiers to determine how collaborating objects fit together. And XML, " +"though it remains an option, is rarely used. Instead, Web Beans uses the " +"typing information that is already available in the Java object model, " +"together with a new pattern, called <emphasis>binding annotations</" +"emphasis>, to wire together Web Beans, their dependencies, their " +"interceptors and decorators and their event consumers." +msgstr "" + +#. Tag: para +#: part1.xml:100 +#, no-c-format +msgid "" +"The Web Beans services are general and apply to the following types of " +"components that exist in the Java EE environment:" +msgstr "" + +#. Tag: para +#: part1.xml:105 +#, no-c-format +msgid "all JavaBeans," +msgstr "" + +#. Tag: para +#: part1.xml:108 +#, no-c-format +msgid "all EJBs, and" +msgstr "" + +#. Tag: para +#: part1.xml:111 +#, no-c-format +msgid "all Servlets." +msgstr "" + +#. Tag: para +#: part1.xml:115 +#, no-c-format +msgid "" +"Web Beans even provides the necessary integration points so that other kinds " +"of components defined by future Java EE specifications or by non-standard " +"frameworks may be cleanly integrated with Web Beans, take advantage of the " +"Web Beans services, and interact with any other kind of Web Bean." +msgstr "" + +#. Tag: para +#: part1.xml:120 +#, no-c-format +msgid "" +"Web Beans was influenced by a number of existing Java frameworks, including " +"Seam, Guice and Spring. However, Web Beans has its own very distinct " +"character: more typesafe than Seam, more stateful and less XML-centric than " +"Spring, more web and enterprise-application capable than Guice." +msgstr "" + +#. Tag: para +#: part1.xml:125 +#, no-c-format +msgid "" +"Most importantly, Web Beans is a JCP standard that integrates cleanly with " +"Java EE, and with any Java SE environment where embeddable EJB Lite is " +"available." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/part2.po =================================================================== --- doc/trunk/reference/zh-CN/modules/part2.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/part2.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,102 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part2.xml:5 +#, no-c-format +msgid "" +"The first major theme of Web Beans is <emphasis>loose coupling</emphasis>. " +"We've already seen three means of achieving loose coupling:" +msgstr "" + +#. Tag: para +#: part2.xml:10 +#, no-c-format +msgid "" +"<emphasis>deployment types</emphasis> enable deployment time polymorphism," +msgstr "" + +#. Tag: para +#: part2.xml:14 +#, no-c-format +msgid "<emphasis>producer methods</emphasis> enable runtime polymorphism, and" +msgstr "" + +#. Tag: para +#: part2.xml:18 +#, no-c-format +msgid "" +"<emphasis>contextual lifecycle management</emphasis> decouples Web Bean " +"lifecycles." +msgstr "" + +#. Tag: para +#: part2.xml:23 +#, no-c-format +msgid "" +"These techniques serve to enable loose coupling of client and server. The " +"client is no longer tightly bound to an implementation of an API, nor is it " +"required to manage the lifecycle of the server object. This approach lets " +"<emphasis>stateful objects interact as if they were services</emphasis>." +msgstr "" + +#. Tag: para +#: part2.xml:28 +#, no-c-format +msgid "" +"Loose coupling makes a system more <emphasis>dynamic</emphasis>. The system " +"can respond to change in a well-defined manner. In the past, frameworks that " +"attempted to provide the facilities listed above invariably did it by " +"sacrificing type safety. Web Beans is the first technology that achieves " +"this level of loose coupling in a typesafe way." +msgstr "" + +#. Tag: para +#: part2.xml:34 +#, no-c-format +msgid "" +"Web Beans provides three extra important facilities that further the goal of " +"loose coupling:" +msgstr "" + +#. Tag: para +#: part2.xml:39 +#, no-c-format +msgid "" +"<emphasis>interceptors</emphasis> decouple technical concerns from business " +"logic," +msgstr "" + +#. Tag: para +#: part2.xml:43 +#, no-c-format +msgid "" +"<emphasis>decorators</emphasis> may be used to decouple some business " +"concerns, and" +msgstr "" + +#. Tag: para +#: part2.xml:47 +#, no-c-format +msgid "" +"<emphasis>event notifications</emphasis> decouple event producers from event " +"consumers." +msgstr "" + +#. Tag: para +#: part2.xml:52 +#, no-c-format +msgid "Let's explore interceptors first." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/part3.po =================================================================== --- doc/trunk/reference/zh-CN/modules/part3.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/part3.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,150 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part3.xml:5 +#, no-c-format +msgid "" +"The second major theme of Web Beans is <emphasis>strong typing</emphasis>. " +"The information about the dependencies, interceptors and decorators of a Web " +"Bean, and the information about event consumers for an event producer, is " +"contained in typesafe Java constructs that may be validated by the compiler." +msgstr "" + +#. Tag: para +#: part3.xml:10 +#, no-c-format +msgid "" +"You don't see string-based identifiers in Web Beans code, not because the " +"framework is hiding them from you using clever defaulting rulesso-" +"called \"configuration by convention\"but because there are simply no " +"strings there to begin with!" +msgstr "" + +#. Tag: para +#: part3.xml:15 +#, no-c-format +msgid "" +"The obvious benefit of this approach is that <emphasis>any</emphasis> IDE " +"can provide autocompletion, validation and refactoring without the need for " +"special tooling. But there is a second, less-immediately-obvious, benefit. " +"It turns out that when you start thinking of identifying objects, events or " +"interceptors via annotations instead of names, you have an opportunity to " +"lift the semantic level of your code." +msgstr "" + +#. Tag: para +#: part3.xml:21 +#, no-c-format +msgid "" +"Web Beans encourages you develop annotations that model concepts, for " +"example," +msgstr "" + +#. Tag: para +#: part3.xml:26 +#, no-c-format +msgid "<literal>@Asynchronous</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:29 +#, no-c-format +msgid "<literal>@Mock</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:32 +#, no-c-format +msgid "<literal>@Secure</literal> or" +msgstr "" + +#. Tag: para +#: part3.xml:35 +#, no-c-format +msgid "<literal>@Updated</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:39 +#, no-c-format +msgid "instead of using compound names like" +msgstr "" + +#. Tag: para +#: part3.xml:43 +#, no-c-format +msgid "<literal>asyncPaymentProcessor</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:46 +#, no-c-format +msgid "<literal>mockPaymentProcessor</literal>," +msgstr "" + +#. Tag: para +#: part3.xml:49 +#, no-c-format +msgid "<literal>SecurityInterceptor</literal> or" +msgstr "" + +#. Tag: para +#: part3.xml:52 +#, no-c-format +msgid "<literal>DocumentUpdatedEvent</literal>." +msgstr "" + +#. Tag: para +#: part3.xml:56 +#, no-c-format +msgid "" +"The annotations are reusable. They help describe common qualities of " +"disparate parts of the system. They help us categorize and understand our " +"code. They help us deal with common concerns in a common way. They make our " +"code more literate and more understandable." +msgstr "" + +#. Tag: para +#: part3.xml:61 +#, no-c-format +msgid "" +"Web Beans <emphasis>stereotypes</emphasis> take this idea a step further. A " +"stereotype models a common <emphasis>role</emphasis> in your application " +"architecture. It encapsulates various properties of the role, including " +"scope, interceptor bindings, deployment type, etc, into a single reusable " +"package." +msgstr "" + +#. Tag: para +#: part3.xml:66 +#, no-c-format +msgid "" +"Even Web Beans XML metadata is strongly typed! There's no compiler for XML, " +"so Web Beans takes advantage of XML schemas to validate the Java types and " +"attributes that appear in XML. This approach turns out to make the XML more " +"literate, just like annotations made our Java code more literate." +msgstr "" + +#. Tag: para +#: part3.xml:71 +#, no-c-format +msgid "" +"We're now ready to meet some more advanced features of Web Beans. Bear in " +"mind that these features exist to make our code both easier to validate and " +"more understandable. Most of the time you don't ever really <emphasis>need</" +"emphasis> to use these features, but if you use them wisely, you'll come to " +"appreciate their power." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/part4.po =================================================================== --- doc/trunk/reference/zh-CN/modules/part4.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/part4.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,52 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: part4.xml:5 +#, no-c-format +msgid "" +"The third theme of Web Beans is <emphasis>integration</emphasis>. Web Beans " +"was designed to work in concert with other technologies, helping the " +"application developer fit the other technologies together. Web Beans is an " +"open technology. It forms a part of the Java EE ecosystem, and is itself the " +"foundation for a new ecosystem of portable extensions and integration with " +"existing frameworks and technologies." +msgstr "" + +#. Tag: para +#: part4.xml:12 +#, no-c-format +msgid "" +"We've already seen how Web Beans helps integrate EJB and JSF, allowing EJBs " +"to be bound directly to JSF pages. That's just the beginning. Web Beans " +"offers the same potential to diverse other technologies, such as Business " +"Process Management engines, other Web Frameworks, and third-party component " +"models. The Java EE platform will never be able to standardize all the " +"interesting technologies that are used in the world of Java application " +"development, but Web Beans makes it easier to use the technologies which are " +"not yet part of the platform seamlessly within the Java EE environment." +msgstr "" + +#. Tag: para +#: part4.xml:21 +#, no-c-format +msgid "" +"We're about to see how to take full advantage of the Java EE platform in an " +"application that uses Web Beans. We'll also briefly meet a set of SPIs that " +"are provided to support portable extensions to Web Beans. You might not ever " +"need to use these SPIs directly, but it's nice to know they are there if you " +"need them. Most importantly, you'll take advantage of them indirectly, every " +"time you use a third-party extension." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/producermethods.po =================================================================== --- doc/trunk/reference/zh-CN/modules/producermethods.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/producermethods.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,246 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: producermethods.xml:5 +#, no-c-format +msgid "Producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:7 +#, no-c-format +msgid "" +"Producer methods let us overcome certain limitations that arise when the Web " +"Bean manager, instead of the application, is responsible for instantiating " +"objects. They're also the easiest way to integrate objects which are not Web " +"Beans into the Web Beans environment. (We'll meet a second approach in <xref " +"linkend=\"xml\"/>.)" +msgstr "" + +#. Tag: para +#: producermethods.xml:12 +#, no-c-format +msgid "According to the spec:" +msgstr "" + +#. Tag: chapter +#: producermethods.xml:12 +#, no-c-format +msgid "" +"<blockquote> <para>A Web Beans producer method acts as a source of objects " +"to be injected, where:</para> <itemizedlist> <listitem> <para>the objects to " +"be injected are not required to be instances of Web Beans,</para> </" +"listitem> <listitem> <para>the concrete type of the objects to be injected " +"may vary at runtime or</para> </listitem> <listitem> <para>the objects " +"require some custom initialization that is not performed by the Web Bean " +"constructor</para> </listitem> </itemizedlist> </blockquote> <para>For " +"example, producer methods let us:</para> <itemizedlist> <listitem> " +"<para>expose a JPA entity as a Web Bean,</para> </listitem> <listitem> " +"<para>expose any JDK class as a Web Bean,</para> </listitem> <listitem> " +"<para>define multiple Web Beans, with different scopes or initialization, " +"for the same implementation class, or</para> </listitem> <listitem> " +"<para>vary the implementation of an API type at runtime.</para> </listitem> " +"</itemizedlist> <para>In particular, producer methods let us use runtime " +"polymorphism with Web Beans. As we've seen, deployment types are a powerful " +"solution to the problem of deployment-time polymorphism. But once the system " +"is deployed, the Web Bean implementation is fixed. A producer method has no " +"such limitation:</para> <programlisting><![CDATA[@SessionScoped\n" +"public class Preferences {\n" +" \n" +" private PaymentStrategyType paymentStrategy;\n" +" \n" +" ...\n" +" \n" +" @Produces @Preferred \n" +" public PaymentStrategy getPaymentStrategy() {\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return new CreditCardPaymentStrategy();\n" +" case CHEQUE: return new ChequePaymentStrategy();\n" +" case PAYPAL: return new PayPalPaymentStrategy();\n" +" default: return null;\n" +" } \n" +" }\n" +" \n" +"}]]></programlisting> <para>Consider an injection point:</para> " +"<programlisting><![CDATA[@Preferred PaymentStrategy paymentStrat;]]></" +"programlisting> <para>This injection point has the same type and binding " +"annotations as the producer method, so it resolves to the producer method " +"using the usual Web Beans injection rules. The producer method will be " +"called by the Web Bean manager to obtain an instance to service this " +"injection point.</para>." +msgstr "" + +#. Tag: title +#: producermethods.xml:68 +#, no-c-format +msgid "Scope of a producer method" +msgstr "" + +#. Tag: para +#: producermethods.xml:70 +#, no-c-format +msgid "" +"The scope of the producer method defaults to <literal>@Dependent</literal>, " +"and so it will be called <emphasis>every time</emphasis> the Web Bean " +"manager injects this field or any other field that resolves to the same " +"producer method. Thus, there could be multiple instances of the " +"<literal>PaymentStrategy</literal> object for each user session." +msgstr "" + +#. Tag: para +#: producermethods.xml:75 +#, no-c-format +msgid "" +"To change this behavior, we can add a <literal>@SessionScoped</literal> " +"annotation to the method." +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:78 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy() {\n" +" ...\n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:80 +#, no-c-format +msgid "" +"Now, when the producer method is called, the returned " +"<literal>PaymentStrategy</literal> will be bound to the session context. The " +"producer method won't be called again in the same session." +msgstr "" + +#. Tag: title +#: producermethods.xml:87 +#, no-c-format +msgid "Injection into producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:89 +#, no-c-format +msgid "" +"There's one potential problem with the code above. The implementations of " +"<literal>CreditCardPaymentStrategy</literal> are instantiated using the Java " +"<literal>new</literal> operator. Objects instantiated directly by the " +"application can't take advantage of dependency injection and don't have " +"interceptors." +msgstr "" + +#. Tag: para +#: producermethods.xml:94 +#, no-c-format +msgid "" +"If this isn't what we want we can use dependency injection into the producer " +"method to obtain Web Bean instances:" +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:97 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy(CreditCardPaymentStrategy ccps,\n" +" ChequePaymentStrategy cps,\n" +" PayPalPaymentStrategy ppps) {\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return ccps;\n" +" case CHEQUE: return cps;\n" +" case PAYPAL: return ppps;\n" +" default: return null;\n" +" } \n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:99 +#, no-c-format +msgid "" +"Wait, what if <literal>CreditCardPaymentStrategy</literal> is a request " +"scoped Web Bean? Then the producer method has the effect of \"promoting\" " +"the current request scoped instance into session scope. This is almost " +"certainly a bug! The request scoped object will be destroyed by the Web Bean " +"manager before the session ends, but the reference to the object will be " +"left \"hanging\" in the session scope. This error will <emphasis>not</" +"emphasis> be detected by the Web Bean manager, so please take extra care " +"when returning Web Bean instances from producer methods!" +msgstr "" + +#. Tag: para +#: producermethods.xml:107 +#, no-c-format +msgid "" +"There's at least three ways we could go about fixing this bug. We could " +"change the scope of the <literal>CreditCardPaymentStrategy</literal> " +"implementation, but this would affect other clients of that Web Bean. A " +"better option would be to change the scope of the producer method to " +"<literal>@Dependent</literal> or <literal>@RequestScoped</literal>." +msgstr "" + +#. Tag: para +#: producermethods.xml:113 +#, no-c-format +msgid "" +"But a more common solution is to use the special <literal>@New</literal> " +"binding annotation." +msgstr "" + +#. Tag: title +#: producermethods.xml:119 +#, no-c-format +msgid "Use of <literal>@New</literal> with producer methods" +msgstr "" + +#. Tag: para +#: producermethods.xml:121 +#, no-c-format +msgid "Consider the following producer method:" +msgstr "" + +#. Tag: programlisting +#: producermethods.xml:123 +#, no-c-format +msgid "" +"<![CDATA[@Produces @Preferred @SessionScoped\n" +"public PaymentStrategy getPaymentStrategy(@New CreditCardPaymentStrategy " +"ccps,\n" +" @New ChequePaymentStrategy cps,\n" +" @New PayPalPaymentStrategy ppps) " +"{\n" +" switch (paymentStrategy) {\n" +" case CREDIT_CARD: return ccps;\n" +" case CHEQUE: return cps;\n" +" case PAYPAL: return ppps;\n" +" default: return null;\n" +" } \n" +"}]]>" +msgstr "" + +#. Tag: para +#: producermethods.xml:125 +#, no-c-format +msgid "" +"Then a new <emphasis>dependent</emphasis> instance of " +"<literal>CreditCardPaymentStrategy</literal> will be created, passed to the " +"producer method, returned by the producer method and finally bound to the " +"session context. The dependent object won't be destroyed until the " +"<literal>Preferences</literal> object is destroyed, at the end of the " +"session." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/ri.po =================================================================== --- doc/trunk/reference/zh-CN/modules/ri.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/ri.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,898 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: ri.xml:4 +#, no-c-format +msgid "Using the Web Beans Reference Implementation" +msgstr "" + +#. Tag: para +#: ri.xml:6 +#, no-c-format +msgid "" +"The Web Beans RI comes with a two examples, <literal>webbeans-numberguess</" +"literal> (a war example, containing only simple beans) and <literal>webbeans-" +"translator</literal> (an ear example, containing enterprise beans)." +msgstr "" + +#. Tag: para +#: ri.xml:13 +#, no-c-format +msgid "" +"Currently, the Web Beans RI only runs on JBoss Application Server 5. You'll " +"need to download JBoss AS 5.0.0.GA from <ulink url=\"http://www.jboss.org/" +"jbossas/downloads/\">jboss.org</ulink>, and unzip it. For example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:20 +#, no-c-format +msgid "" +"<![CDATA[$ cd /Applications\n" +"$ unzip ~/jboss-5.0.0.GA.zip]]>" +msgstr "" + +#. Tag: para +#: ri.xml:22 +#, no-c-format +msgid "" +"Next, download the Web Beans RI from <ulink url=\"http://seamframework.org/" +"WebBeans\">seamframework.org</ulink>, and unzip it. For example" +msgstr "" + +#. Tag: programlisting +#: ri.xml:28 +#, no-c-format +msgid "" +"<![CDATA[$ cd ~/\n" +"$ unzip ~/webbeans-1.0.0.ALPHA1.zip]]>" +msgstr "" + +#. Tag: para +#: ri.xml:30 +#, no-c-format +msgid "" +"As Web Beans is a new piece of software, you need to update JBoss AS to run " +"the Web Beans RI. Future versions of JBoss AS will include these updates, " +"and this step won't be necessary." +msgstr "" + +#. Tag: para +#: ri.xml:37 +#, no-c-format +msgid "" +"Currently, two updates are needed. Firstly, a new deployer, " +"<literal>webbeans.deployer</literal> is added. This adds supports for Web " +"Bean archives to JBoss AS, and allows the Web Beans RI to query the EJB3 " +"container and discover which EJBs are installed in your application. " +"Secondly, an update to JBoss EJB3 is needed." +msgstr "" + +#. Tag: para +#: ri.xml:46 +#, no-c-format +msgid "" +"To install the update, you'll need ant 1.7.0 installed, and the " +"<literal>ANT_HOME</literal> environment variable set. For example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:51 +#, no-c-format +msgid "" +"$ unzip apache-ant-1.7.0.zip\n" +"$ export ANT_HOME=~/apache-ant-1.7.0" +msgstr "" + +#. Tag: para +#: ri.xml:53 +#, no-c-format +msgid "" +"Then, you can install the update. The update script will use Maven to " +"download the Web Beans and EJB3 automatically." +msgstr "" + +#. Tag: programlisting +#: ri.xml:58 +#, no-c-format +msgid "" +"$ cd webbeans-1.0.0.ALPHA1/jboss-as\n" +"$ ant update" +msgstr "" + +#. Tag: para +#: ri.xml:60 +#, no-c-format +msgid "Now, you're ready to deploy your first example!" +msgstr "" + +#. Tag: para +#: ri.xml:65 +#, no-c-format +msgid "" +"The build scripts for the examples offer a number of targets, these are:" +msgstr "" + +#. Tag: para +#: ri.xml:71 +#, no-c-format +msgid "<literal>ant restart</literal> - deploy the example in exploded format" +msgstr "" + +#. Tag: para +#: ri.xml:77 +#, no-c-format +msgid "" +"<literal>ant explode</literal> - update an exploded example, without " +"restarting the deployment" +msgstr "" + +#. Tag: para +#: ri.xml:83 +#, no-c-format +msgid "" +"<literal>ant deploy</literal> - deploy the example in compressed jar format" +msgstr "" + +#. Tag: para +#: ri.xml:88 +#, no-c-format +msgid "<literal>ant undeploy</literal> - remove the example from the server" +msgstr "" + +#. Tag: para +#: ri.xml:93 +#, no-c-format +msgid "<literal>ant clean</literal> - clean the example" +msgstr "" + +#. Tag: para +#: ri.xml:100 +#, no-c-format +msgid "To deploy the numberguess example:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:104 +#, no-c-format +msgid "" +"$ cd examples/numberguess\n" +"ant deploy" +msgstr "" + +#. Tag: para +#: ri.xml:106 +#, no-c-format +msgid "" +"Wait for the application to deploy, and enjoy hours of fun at <ulink url=" +"\"http://localhost:8080/webbeans-numberguess\"></ulink>!" +msgstr "" + +#. Tag: para +#: ri.xml:111 +#, no-c-format +msgid "" +"The Web Beans RI includes a second simple example that will translate your " +"text into Latin. The numberguess example is a war example, and uses only " +"simple beans; the translator example is an ear example, and includes " +"enterprise beans, packaged in an EJB module. To try it out:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:118 +#, no-c-format +msgid "" +"$ cd examples/traslator\n" +"ant deploy" +msgstr "" + +#. Tag: para +#: ri.xml:120 +#, no-c-format +msgid "" +"Wait for the application to deploy, and visit <ulink url=\"http://" +"localhost:8080/webbeans-translator\"></ulink>!" +msgstr "" + +#. Tag: title +#: ri.xml:126 +#, no-c-format +msgid "The numberguess example" +msgstr "" + +#. Tag: para +#: ri.xml:128 +#, no-c-format +msgid "" +"In the numberguess application you get given 10 attempts to guess a number " +"between 1 and 100. After each attempt, you will be told whether you are too " +"high, or too low." +msgstr "" + +#. Tag: para +#: ri.xml:134 +#, no-c-format +msgid "" +"The numberguess example is comprised of a number of Web Beans, configuration " +"files, and Facelet JSF pages, packaged as a war. Let's start with the " +"configuration files." +msgstr "" + +#. Tag: para +#: ri.xml:140 +#, no-c-format +msgid "" +"All the configuration files for this example are located in <literal>WEB-INF/" +"</literal>, which is stored in <literal>WebContent</literal> in the source " +"tree. First, we have <literal>faces-config.xml</literal>, in which we tell " +"JSF to use Facelets:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:148 +#, no-c-format +msgid "" +"<![CDATA[<?xml version='1.0' encoding='UTF-8'?>\n" +"<faces-config version=\"1.2\"\n" +" xmlns=\"http://java.sun.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://" +"java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd\">\n" +" \n" +" <application>\n" +" <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>\n" +" </application>\n" +"\n" +"</faces-config>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:150 +#, no-c-format +msgid "" +"There is an empty <literal>web-beans.xml</literal> file, which marks this " +"application as a Web Beans application." +msgstr "" + +#. Tag: para +#: ri.xml:155 +#, no-c-format +msgid "Finally there is <literal>web.xml</literal>:" +msgstr "" + +#. Tag: section +#: ri.xml:157 +#, no-c-format +msgid "" +"<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> " +"<area id=\"faces.servlet.mapping\" coords=\"18\"/> <area id=\"faces.default." +"suffix\" coords=\"23\"/> <area id=\"session.timeout\" coords=\"28\"/> <area " +"id=\"webbeans.listener\" coords=\"32\"/> </areaspec> <programlisting><![CDATA" +"[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"\n" +"<web-app version=\"2.5\"\n" +" xmlns=\"http://java.sun.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun." +"com/xml/ns/javaee/web-app_2_5.xsd\">\n" +" \n" +" <display-name>Web Beans Numbergues example</display-name>\n" +"\n" +" \n" +"\n" +" <servlet>\n" +" <servlet-name>Faces Servlet</servlet-name>\n" +" <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>\n" +" <load-on-startup>1</load-on-startup>\n" +" </servlet>\n" +"\n" +" <servlet-mapping>\n" +" <servlet-name>Faces Servlet</servlet-name>\n" +" <url-pattern>*.jsf</url-pattern>\n" +" </servlet-mapping>\n" +" \n" +" <context-param>\n" +" <param-name>javax.faces.DEFAULT_SUFFIX</param-name>\n" +" <param-value>.xhtml</param-value>\n" +" </context-param>\n" +"\n" +" <session-config>\n" +" <session-timeout>10</session-timeout>\n" +" </session-config>\n" +" \n" +" <listener>\n" +" <listener-class>org.jboss.webbeans.servlet.WebBeansListener</listener-" +"class>\n" +" </listener>\n" +"\n" +"</web-app>]]></programlisting> <calloutlist> <callout arearefs=\"faces." +"servlet\"> <para> Enable and load the JSF servlet </para> </callout> " +"<callout arearefs=\"faces.servlet.mapping\"> <para> Configure requests to " +"<literal>.jsf</literal> pages to be handled by JSF </para> </callout> " +"<callout arearefs=\"faces.default.suffix\"> <para> Tell JSF that we will be " +"giving our source files (facelets) an extension of <literal>.jsf</literal> </" +"para> </callout> <callout arearefs=\"session.timeout\"> <para> Configure a " +"session timeout of 10 minutes </para> </callout> <callout arearefs=" +"\"webbeans.listener\"> <para> Configure the Web Beans listener, so that Web " +"Beans services can be used in the servlet request </para> </callout> </" +"calloutlist> </programlistingco> <note> <para> The only configuration " +"required by the Web Beans RI in <literal>web.xml</literal> is to add the Web " +"Beans listener. </para> <para> Whilst this demo is a JSF demo, you can use " +"the Web Beans RI with any Servlet based web framework; just configure the " +"Web Beans listener. </para> </note> <para> Let's take a look at the Facelet " +"view: </para> <programlistingco> <areaspec> <area id=\"template\" coords=\"8" +"\"/> <area id=\"messages\" coords=\"12\"/> <area id=\"instructions\" coords=" +"\"19\"/> <area id=\"guess\" coords=\"25\"/> <area id=\"validator\" coords=" +"\"29\"/> <area id=\"submit\" coords=\"32\"/> </areaspec> <programlisting><!" +"[CDATA[<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" " +"\"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\n" +"<html xmlns=\"http://www.w3.org/1999/xhtml\"\n" +" xmlns:ui=\"http://java.sun.com/jsf/facelets\"\n" +" xmlns:h=\"http://java.sun.com/jsf/html\"\n" +" xmlns:f=\"http://java.sun.com/jsf/core\"\n" +" xmlns:s=\"http://jboss.com/products/seam/taglib\">\n" +"\n" +" <ui:composition template=\"template.xhtml\">\n" +" <ui:define name=\"content\">\n" +" <h1>Guess a number...</h1>\n" +" <h:form id=\"NumberGuessMain\">\n" +" <div style=\"color: red\">\n" +" <h:messages id=\"messages\" globalOnly=\"false\"/>\n" +" <h:outputText id=\"Higher\" value=\"Higher!\" rendered=\"#{game." +"number gt game.guess}\"/>\n" +" <h:outputText id=\"Lower\" value=\"Lower!\" rendered=\"#{game." +"number lt game.guess}\"/>\n" +" </div>\n" +" \n" +" <div>\n" +" I'm thinking of a number between #{game.smallest} and #{game." +"biggest}.\n" +" You have #{game.remainingGuesses} guesses.\n" +" </div>\n" +" \n" +" <div>\n" +" Your guess: \n" +" <h:inputText id=\"inputGuess\" \n" +" value=\"#{game.guess}\" \n" +" required=\"true\" \n" +" size=\"3\">\n" +" <f:validateLongRange maximum=\"#{game.biggest}\" \n" +" minimum=\"#{game.smallest}\"/>\n" +" </h:inputText>\n" +" <h:commandButton id=\"GuessButton\" \n" +" value=\"Guess\" \n" +" action=\"#{game.check}\"/>\n" +" </div>\n" +" \n" +" </h:form>\n" +" </ui:define>\n" +" </ui:composition>\n" +"</html>]]></programlisting> <calloutlist> <callout arearefs=\"template\"> " +"<para> Facelets is a templating language for JSF, here we are wrapping our " +"page in a template which defines the header. </para> </callout> <callout " +"arearefs=\"messages\"> <para> There are a number of messages which can be " +"sent to the user, \"Higher!\", \"Lower!\" and \"Correct!\" </para> </" +"callout> <callout arearefs=\"instructions\"> <para> As the user guesses, the " +"range of numbers they can guess gets smaller - this sentance changes to make " +"sure they know what range to guess in. </para> </callout> <callout arearefs=" +"\"guess\"> <para> This input field is bound to a Web Bean, using the value " +"expression. </para> </callout> <callout arearefs=\"validator\"> <para> A " +"range validator is used to make sure the user doesn't accidentally input a " +"number outside of the range in which they can guess - if the validator " +"wasn't here, the user might use up a guess on an out of range number. </" +"para> </callout> <callout arearefs=\"submit\"> <para> And, of course, there " +"must be a way for the user to send their guess to the server. Here we bind " +"to an action method on the Web Bean. </para> </callout> </calloutlist> </" +"programlistingco>" +msgstr "" + +#. Tag: para +#: ri.xml:270 +#, no-c-format +msgid "" +"The example exists of 4 classes, the first two of which are binding types. " +"First, there is the <literal>@Random</literal> binding type, used for " +"injecting a random number:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:276 +#, no-c-format +msgid "" +"<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" +"@Retention(RUNTIME)\n" +"@Documented\n" +"@BindingType\n" +"public @interface Random {}]]>" +msgstr "" + +#. Tag: para +#: ri.xml:278 +#, no-c-format +msgid "" +"There is also the <literal>@MaxNumber</literal> binding type, used for " +"injecting the maximum number that can be injected:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:283 +#, no-c-format +msgid "" +"<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" +"@Retention(RUNTIME)\n" +"@Documented\n" +"@BindingType\n" +"public @interface MaxNumber {}\n" +"]]>" +msgstr "" + +#. Tag: para +#: ri.xml:285 +#, no-c-format +msgid "" +"The <literal>Generator</literal> class is responsible for creating the " +"random number, via a producer method. It also exposes the maximum possible " +"number via a producer method:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:291 +#, no-c-format +msgid "" +"<![CDATA[@ApplicationScoped\n" +"public class Generator {\n" +" \n" +" private java.util.Random random = new java.util.Random( System." +"currentTimeMillis() );\n" +" \n" +" private int maxNumber = 100;\n" +" \n" +" java.util.Random getRandom()\n" +" {\n" +" return random;\n" +" }\n" +" \n" +" @Produces @Random int next() { \n" +" return getRandom().nextInt(maxNumber); \n" +" }\n" +" \n" +" @Produces @MaxNumber int getMaxNumber()\n" +" {\n" +" return maxNumber;\n" +" }\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: ri.xml:293 +#, no-c-format +msgid "" +"You'll notice that the <literal>Generator</literal> is application scoped; " +"therefore we don't get a different random each time." +msgstr "" + +#. Tag: para +#: ri.xml:298 +#, no-c-format +msgid "" +"The final Web Bean in the application is the session scoped <literal>Game</" +"literal>. By making <literal>Game</literal> session scoped, you can only " +"play the game once per browser session. You could easily add a reset button " +"- a good exercise for the reader :-)" +msgstr "" + +#. Tag: para +#: ri.xml:305 +#, no-c-format +msgid "" +"You'll also note that we've used the <literal>@Named</literal> annotation, " +"so that we can use the bean through EL in the JSF page. Finally, we've used " +"constructor injection to initialize the game with a random number. And of " +"course, we need to tell the player when they've won, so we give feedback " +"with a <literal>FacesMessage</literal>." +msgstr "" + +#. Tag: programlisting +#: ri.xml:313 +#, no-c-format +msgid "" +"<![CDATA[@Named\n" +"@SessionScoped\n" +"public class Game {\n" +" private int number;\n" +" \n" +" private int guess;\n" +" private int smallest;\n" +" private int biggest;\n" +" private int remainingGuesses;\n" +" \n" +" public Game() {}\n" +" \n" +" @Initializer\n" +" Game(@Random int number, @MaxNumber int maxNumber) {\n" +" this.number = number;\n" +" this.smallest = 1;\n" +" this.biggest = maxNumber;\n" +" this.remainingGuesses = 10;\n" +" }\n" +"\n" +" // Getters and setters for fields\n" +" \n" +" public String check() {\n" +" if (guess>number) {\n" +" biggest = guess - 1;\n" +" }\n" +" if (guess<number) {\n" +" smallest = guess + 1;\n" +" }\n" +" if (guess == number) {\n" +" FacesContext.getCurrentInstance().addMessage(null, new FacesMessage" +"(\"Correct!\"));\n" +" }\n" +" remainingGuesses--;\n" +" return null;\n" +" }\n" +" \n" +"}]]>" +msgstr "" + +#. Tag: title +#: ri.xml:317 +#, no-c-format +msgid "The translator example" +msgstr "" + +#. Tag: para +#: ri.xml:319 +#, no-c-format +msgid "" +"The translator example will take any sentences you enter, and translate them " +"to Latin." +msgstr "" + +#. Tag: para +#: ri.xml:324 +#, no-c-format +msgid "" +"The translator example is built as an ear, and contains EJBs and enterprise " +"beans. As a result, it's structure is more complex than the numberguess " +"example." +msgstr "" + +#. Tag: para +#: ri.xml:331 +#, no-c-format +msgid "" +"EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will make " +"this structure much simpler!" +msgstr "" + +#. Tag: para +#: ri.xml:337 +#, no-c-format +msgid "" +"First, let's take a look at the ear aggregator, which is located in " +"<literal>webbeans-translator-ear</literal> module. Maven automatically " +"generates the <literal>application.xml</literal> and <literal>jboss-app.xml</" +"literal> for us:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:344 +#, no-c-format +msgid "" +"<![CDATA[<plugin>\n" +" <groupId>org.apache.maven.plugins</groupId>\n" +" <artifactId>maven-ear-plugin</artifactId>\n" +" <configuration>\n" +" <modules>\n" +" <webModule>\n" +" <groupId>org.jboss.webbeans.examples.translator</groupId>\n" +" <artifactId>webbeans-translator-war</artifactId>\n" +" <contextRoot>/webbeans-translator</contextRoot>\n" +" </webModule>\n" +" </modules>\n" +" <jboss>\n" +" <loader-repository>webbeans.jboss.org:loader=webbeans-translator</" +"loader-repository>\n" +" </jboss>\n" +" </configuration>\n" +"</plugin>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:346 +#, no-c-format +msgid "" +"We're doing a couple of things here - firstly we set the context path, which " +"gives us a nice url (<ulink url=\"http://localhost:8080/webbeans-translator" +"\">http://localhost:8080/webbeans-translator</ulink>) and we also enable " +"class loader isolation for JBoss AS." +msgstr "" + +#. Tag: para +#: ri.xml:354 +#, no-c-format +msgid "" +"If you aren't using Maven to generate these files, you would need " +"<literal>META-INF/jboss-app.xml</literal>:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:359 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<!DOCTYPE jboss-app\n" +" PUBLIC \"-//JBoss//DTD J2EE Application 4.2//EN\"\n" +" \"http://www.jboss.org/j2ee/dtd/jboss-app_4_2.dtd\">\n" +"<jboss-app>\n" +" <loader-repository>webbeans.jboss.org:loader=webbeans-translator</loader-" +"repository>\n" +"</jboss-app>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:361 +#, no-c-format +msgid "and <literal>META-INF/application.xml</literal>:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:365 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<application xmlns=\"http://java.sun.com/xml/ns/javaee\" \n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://" +"java.sun.com/xml/ns/javaee/application_5.xsd\"\n" +" version=\"5\">\n" +" <display-name>webbeans-translator-ear</display-name>\n" +" <description>Ear Example for the reference implementation of JSR 299: Web " +"Beans</description>\n" +" \n" +" <module>\n" +" <web>\n" +" <web-uri>webbeans-translator.war</web-uri>\n" +" <context-root>/webbeans-translator</context-root>\n" +" </web>\n" +" </module>\n" +" <module>\n" +" <ejb>webbeans-translator.jar</ejb>\n" +" </module>\n" +"</application>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:368 +#, no-c-format +msgid "" +"Next, lets look at the war. Just as in the numberguess example, we have a " +"<literal>faces-config.xml</literal> (to enabled Facelets) and a <literal>web." +"xml</literal> (to enable JSF and attach Web Beans services to the servlet " +"container) in <literal>WebContent/WEB-INF</literal>." +msgstr "" + +#. Tag: para +#: ri.xml:375 +#, no-c-format +msgid "" +"More intersting is the facelet used to translate text. Just as in the " +"numberguess example we have a template, which surrounds the form (ommitted " +"here for brevity):" +msgstr "" + +#. Tag: programlisting +#: ri.xml:381 +#, no-c-format +msgid "" +"<![CDATA[<h:form id=\"NumberGuessMain\">\n" +" \n" +" <table>\n" +" <tr align=\"center\" style=\"font-weight: bold\" >\n" +" <td>\n" +" Your text\n" +" </td>\n" +" <td>\n" +" Translation\n" +" </td>\n" +" </tr>\n" +" <tr>\n" +" <td>\n" +" <h:inputTextarea id=\"text\" value=\"#{translator.text}\" " +"required=\"true\" rows=\"5\" cols=\"80\" />\n" +" </td>\n" +" <td>\n" +" <h:outputText value=\"#{translator.translatedText}\" />\n" +" </td>\n" +" </tr>\n" +" </table>\n" +" <div>\n" +" <h:commandButton id=\"button\" value=\"Translate\" action=\"#" +"{translator.translate}\"/>\n" +" </div>\n" +" \n" +"</h:form>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:383 +#, no-c-format +msgid "" +"The user can enter some text in the lefthand textarea, and hit the translate " +"button to see the result to the right." +msgstr "" + +#. Tag: para +#: ri.xml:388 +#, no-c-format +msgid "" +"Finally, let's look at the ejb module, <literal>webbeans-translator-ejb</" +"literal>. There are two configuration files in <literal>src/main/resources/" +"META-INF</literal>, an empty <literal>web-beans.xml</literal>, used to mark " +"the archive as containing Web Beans, and <literal>ejb-jar.xml</literal>. Web " +"Beans provides injection and initializtion services for all EJBs, and uses " +"<literal>ejb-jar.xml</literal> to enable this, you'll need this in any EJB " +"project which uses Web Beans:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:400 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar xmlns=\"http://java.sun.com/xml/ns/javaee\" \n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" \n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java." +"sun.com/xml/ns/javaee/ejb-jar_3_0.xsd\"\n" +" version=\"3.0\">\n" +" \n" +" <interceptors>\n" +" <interceptor>\n" +" <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</" +"interceptor-class>\n" +" </interceptor>\n" +" </interceptors>\n" +" \n" +" <assembly-descriptor>\n" +" <interceptor-binding>\n" +" <ejb-name>*</ejb-name>\n" +" <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</" +"interceptor-class>\n" +" </interceptor-binding>\n" +" </assembly-descriptor>\n" +" \n" +"</ejb-jar>]]>" +msgstr "" + +#. Tag: para +#: ri.xml:402 +#, no-c-format +msgid "" +"We've saved the most interesting bit to last, the code! The project has two " +"simple beans, <literal>SentanceParser</literal> and <literal>TextTranslator</" +"literal> and two enterprise beans, <literal>TanslatorControllerBean</" +"literal> and <literal>SentenceTranslator</literal>. You should be getting " +"quite familiar with what a Web Bean looks like by now, so we'll just " +"highlight the most interesting bits here." +msgstr "" + +#. Tag: para +#: ri.xml:412 +#, no-c-format +msgid "" +"Both <literal>SentanceParser</literal> and <literal>TextTranslator</literal> " +"are dependent beans, and <literal>TextTranslator</literal> uses constructor " +"initialization:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:418 +#, no-c-format +msgid "" +"<![CDATA[public class TextTranslator { \n" +" private SentenceParser sentenceParser; \n" +" private Translator sentenceTranslator; \n" +" \n" +" @Initializer\n" +" TextTranslator(SentenceParser sentenceParser, Translator " +"sentenceTranslator) \n" +" { \n" +" this.sentenceParser = sentenceParser; \n" +" this.sentenceTranslator = sentenceTranslator;]]>" +msgstr "" + +#. Tag: para +#: ri.xml:420 +#, no-c-format +msgid "" +"<literal>TextTranslator</literal> is a stateless bean (with a local business " +"interface), where the magic happens - of course, we couldn't develop a full " +"translator, but we gave it a good go!" +msgstr "" + +#. Tag: para +#: ri.xml:426 +#, no-c-format +msgid "" +"Finally, there is UI orientated controller, that collects the text from the " +"user, and dispatches it to the translator. This is a request scoped, named, " +"stateful session bean, which injects the translator." +msgstr "" + +#. Tag: programlisting +#: ri.xml:432 +#, no-c-format +msgid "" +"<![CDATA[@Stateful\n" +"@RequestScoped\n" +"@Named(\"translator\")\n" +"public class TranslatorControllerBean implements TranslatorController\n" +"{\n" +" \n" +" @Current TextTranslator translator;]]>" +msgstr "" + +#. Tag: para +#: ri.xml:434 +#, no-c-format +msgid "The bean also has getters and setters for all the fields on the page." +msgstr "" + +#. Tag: para +#: ri.xml:438 +#, no-c-format +msgid "As this is a stateful session bean, we have to have a remove method:" +msgstr "" + +#. Tag: programlisting +#: ri.xml:442 +#, no-c-format +msgid "" +"<![CDATA[ @Remove\n" +" public void remove()\n" +" {\n" +" \n" +" }]]>" +msgstr "" + +#. Tag: para +#: ri.xml:444 +#, no-c-format +msgid "" +"The Web Beans manager will call the remove method for you when the bean is " +"destroyed; in this case at the end of the request." +msgstr "" + +#. Tag: para +#: ri.xml:450 +#, no-c-format +msgid "" +"That concludes our short tour of the Web Beans RI examples. For more on the " +"RI, or to help out, please visit <ulink url=\"http://www.seamframework.org/" +"WebBeans/Development\">http://www.seamframework.org/WebBeans/Development</" +"ulink>." +msgstr "" + +#. Tag: para +#: ri.xml:456 +#, no-c-format +msgid "" +"We need help in all areas - bug fixing, writing new features, writing " +"examples and translating this reference guide." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/scopescontexts.po =================================================================== --- doc/trunk/reference/zh-CN/modules/scopescontexts.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/scopescontexts.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,582 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: scopescontexts.xml:4 +#, no-c-format +msgid "Scopes and contexts" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:6 +#, no-c-format +msgid "" +"So far, we've seen a few examples of <emphasis>scope type annotations</" +"emphasis>. The scope of a Web Bean determines the lifecycle of instances of " +"the Web Bean. The scope also determines which clients refer to which " +"instances of the Web Bean. According to the Web Beans specification, a scope " +"determines:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:14 +#, no-c-format +msgid "When a new instance of any Web Bean with that scope is created" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:17 +#, no-c-format +msgid "When an existing instance of any Web Bean with that scope is destroyed" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:20 +#, no-c-format +msgid "" +"Which injected references refer to any instance of a Web Bean with that scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:25 +#, no-c-format +msgid "" +"For example, if we have a session scoped Web Bean, <literal>CurrentUser</" +"literal>, all Web Beans that are called in the context of the same " +"<literal>HttpSession</literal> will see the same instance of " +"<literal>CurrentUser</literal>. This instance will be automatically created " +"the first time a <literal>CurrentUser</literal> is needed in that session, " +"and automatically destroyed when the session ends." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:32 +#, no-c-format +msgid "Scope types" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:34 +#, no-c-format +msgid "" +"Web Beans features an <emphasis>extensible context model</emphasis>. It is " +"possible to define new scopes by creating a new scope type annotation:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:37 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target({TYPE, METHOD})\n" +"@ScopeType\n" +"public @interface ClusterScoped {}]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:39 +#, no-c-format +msgid "" +"Of course, that's the easy part of the job. For this scope type to be " +"useful, we will also need to define a <literal>Context</literal> object that " +"implements the scope! Implementing a <literal>Context</literal> is usually a " +"very technical task, intended for framework development only." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:44 +#, no-c-format +msgid "" +"We can apply a scope type annotation to a Web Bean implementation class to " +"specify the scope of the Web Bean:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:47 +#, no-c-format +msgid "" +"<![CDATA[@ClusterScoped\n" +"public class SecondLevelCache { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:58 +#, no-c-format +msgid "Usually, you'll use one of Web Beans' built-in scopes." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:63 +#, no-c-format +msgid "Built-in scopes" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:65 +#, no-c-format +msgid "Web Beans defines four built-in scopes:" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:69 +#, no-c-format +msgid "@RequestScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:72 +#, no-c-format +msgid "@SessionScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:75 +#, no-c-format +msgid "@ApplicationScoped" +msgstr "" + +#. Tag: literal +#: scopescontexts.xml:78 +#, no-c-format +msgid "@ConversationScoped" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:82 +#, no-c-format +msgid "For a web application that uses Web Beans:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:86 +#, no-c-format +msgid "" +"any servlet request has access to active request, session and application " +"scopes, and, additionally" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:90 +#, no-c-format +msgid "any JSF request has access to an active conversation scope." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:94 +#, no-c-format +msgid "The request and application scopes are also active:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:98 +#, no-c-format +msgid "during invocations of EJB remote methods," +msgstr "" + +#. Tag: para +#: scopescontexts.xml:101 +#, no-c-format +msgid "during EJB timeouts," +msgstr "" + +#. Tag: para +#: scopescontexts.xml:104 +#, no-c-format +msgid "during message delivery to a message-driven bean, and" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:107 +#, no-c-format +msgid "during web service invocations." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:111 +#, no-c-format +msgid "" +"If the application tries to invoke a Web Bean with a scope that does not " +"have an active context, a <literal>ContextNotActiveException</literal> is " +"thrown by the Web Bean manager at runtime." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:115 +#, no-c-format +msgid "" +"Three of the four built-in scopes should be extremely familiar to every Java " +"EE developer, so let's not waste time discussing them here. One of the " +"scopes, however, is new." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:122 +#, no-c-format +msgid "The conversation scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:124 +#, no-c-format +msgid "" +"The Web Beans conversation scope is a bit like the traditional session scope " +"in that it holds state associated with a user of the system, and spans " +"multiple requests to the server. However, unlike the session scope, the " +"conversation scope:" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:130 +#, no-c-format +msgid "is demarcated explicitly by the application, and" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:133 +#, no-c-format +msgid "" +"holds state associated with a particular web browser tab in a JSF " +"application." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:138 +#, no-c-format +msgid "" +"A conversation represents a task, a unit of work from the point of view of " +"the user. The conversation context holds state associated with what the user " +"is currently working on. If the user is doing multiple things at the same " +"time, there are multiple conversations." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:143 +#, no-c-format +msgid "" +"The conversation context is active during any JSF request. However, most " +"conversations are destroyed at the end of the request. If a conversation " +"should hold state across multiple requests, it must be explicitly promoted " +"to a <emphasis>long-running conversation</emphasis>." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:149 +#, no-c-format +msgid "Conversation demarcation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:151 +#, no-c-format +msgid "" +"Web Beans provides a built-in Web Bean for controlling the lifecyle of " +"conversations in a JSF application. This Web Bean may be obtained by " +"injection:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:154 +#, no-c-format +msgid "@Current Conversation conversation;" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:156 +#, no-c-format +msgid "" +"To promote the conversation associated with the current request to a long-" +"running conversation, call the <literal>begin()</literal> method from " +"application code. To schedule the current long-running conversation context " +"for destruction at the end of the current request, call <literal>end()</" +"literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:161 +#, no-c-format +msgid "" +"In the following example, a conversation-scoped Web Bean controls the " +"conversation with which it is associated:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:164 +#, no-c-format +msgid "" +"@ConversationScoped @Stateful\n" +"public class OrderBuilder {\n" +"\n" +" private Order order;\n" +" private @Current Conversation conversation;\n" +" private @PersistenceContext(type=EXTENDED) EntityManager em;\n" +" \n" +" @Produces public Order getOrder() {\n" +" return order;\n" +" }\n" +"\n" +" public Order createOrder() {\n" +" order = new Order();\n" +" conversation.begin();\n" +" return order;\n" +" }\n" +" \n" +" public void addLineItem(Product product, int quantity) {\n" +" order.add( new LineItem(product, quantity) );\n" +" }\n" +"\n" +" public void saveOrder(Order order) {\n" +" em.persist(order);\n" +" conversation.end();\n" +" }\n" +" \n" +" @Remove\n" +" public void destroy() {}\n" +" \n" +"}" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:166 +#, no-c-format +msgid "" +"This Web Bean is able to control its own lifecycle through use of the " +"<literal>Conversation</literal> API. But some other Web Beans have a " +"lifecycle which depends completely upon another object." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:173 +#, no-c-format +msgid "Conversation propagation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:175 +#, no-c-format +msgid "" +"The conversation context automatically propagates with any JSF faces request " +"(JSF form submission). It does not automatically propagate with non-faces " +"requests, for example, navigation via a link." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:179 +#, no-c-format +msgid "" +"We can force the conversation to propagate with a non-faces request by " +"including the unique identifier of the conversation as a request parameter. " +"The Web Beans specification reserves the request parameter named " +"<literal>cid</literal> for this use. The unique identifier of the " +"conversation may be obtained from the <literal>Conversation</literal> " +"object, which has the Web Beans name <literal>conversation</literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:186 +#, no-c-format +msgid "Therefore, the following link propagates the conversation:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:188 +#, no-c-format +msgid "" +"<![CDATA[<a href=\"/addProduct.jsp?cid=#{conversation.id}\">Add Product</a>]]" +">" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:190 +#, no-c-format +msgid "" +"The Web Bean manager is also required to propagate conversations across any " +"redirect, even if the conversation is not marked long-running. This makes it " +"very easy to implement the common POST-then-redirect pattern, without resort " +"to fragile constructs such as a \"flash\" object. In this case, the Web Bean " +"manager automatically adds a request parameter to the redirect URL." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:200 +#, no-c-format +msgid "Conversation timeout" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:202 +#, no-c-format +msgid "" +"The Web Bean manager is permitted to destroy a conversation and all state " +"held in its context at any time in order to preserve resources. A Web Bean " +"manager implementation will normally do this on the basis of some kind of " +"timeoutthough this is not required by the Web Beans specification. The " +"timeout is the period of inactivity before the conversation is destroyed." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:208 +#, no-c-format +msgid "" +"The <literal>Conversation</literal> object provides a method to set the " +"timeout. This is a hint to the Web Bean manager, which is free to ignore the " +"setting." +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:212 +#, no-c-format +msgid "conversation.setTimeout(timeoutInMillis);" +msgstr "" + +#. Tag: title +#: scopescontexts.xml:219 +#, no-c-format +msgid "The dependent pseudo-scope" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:221 +#, no-c-format +msgid "" +"In addition to the four built-in scopes, Web Beans features the so-called " +"<emphasis>dependent pseudo-scope</emphasis>. This is the default scope for a " +"Web Bean which does not explicitly declare a scope type." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:225 +#, no-c-format +msgid "" +"For example, this Web Bean has the scope type <literal>@Dependent</literal>:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:227 +#, no-c-format +msgid "<![CDATA[public class Calculator { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:229 +#, no-c-format +msgid "" +"When an injection point of a Web Bean resolves to a dependent Web Bean, a " +"new instance of the dependent Web Bean is created every time the first Web " +"Bean is instantiated. Instances of dependent Web Beans are never shared " +"between different Web Beans or different injection points. They are " +"<emphasis>dependent objects</emphasis> of some other Web Bean instance." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:235 +#, no-c-format +msgid "" +"Dependent Web Bean instances are destroyed when the instance they depend " +"upon is destroyed." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:243 +#, no-c-format +msgid "" +"Web Beans makes it easy to obtain a dependent instance of a Java class or " +"EJB bean, even if the class or EJB bean is already declared as a Web Bean " +"with some other scope type." +msgstr "" + +#. Tag: title +#: scopescontexts.xml:248 +#, no-c-format +msgid "The <literal>@New</literal> annotation" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:250 +#, no-c-format +msgid "" +"The built-in <literal>@New</literal> binding annotation allows " +"<emphasis>implicit</emphasis> definition of a dependent Web Bean at an " +"injection point. Suppose we declare the following injected field:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:254 +#, no-c-format +msgid "<![CDATA[@New Calculator calculator;]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:256 +#, no-c-format +msgid "" +"Then a Web Bean with scope <literal>@Dependent</literal>, binding type " +"<literal>@New</literal>, API type <literal>Calculator</literal>, " +"implementation class <literal>Calculator</literal> and deployment type " +"<literal>@Standard</literal> is implicitly defined." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:261 +#, no-c-format +msgid "" +"This is true even if <literal>Calculator</literal> is <emphasis>already</" +"emphasis> declared with a different scope type, for example:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:264 +#, no-c-format +msgid "" +"<![CDATA[@ConversationScoped\n" +"public class Calculator { ... }]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:266 +#, no-c-format +msgid "" +"So the following injected attributes each get a different instance of " +"<literal>Calculator</literal>:" +msgstr "" + +#. Tag: programlisting +#: scopescontexts.xml:269 +#, no-c-format +msgid "" +"<![CDATA[public class PaymentCalc {\n" +"\n" +" @Current Calculator calculator;\n" +" @New Calculator newCalculator;\n" +"\n" +"}]]>" +msgstr "" + +#. Tag: para +#: scopescontexts.xml:271 +#, no-c-format +msgid "" +"The <literal>calculator</literal> field has a conversation-scoped instance " +"of <literal>Calculator</literal> injected. The <literal>newCalculator</" +"literal> field has a new instance of <literal>Calculator</literal> injected, " +"with a lifecycle that is bound to the owning <literal>PaymentCalc</literal>." +msgstr "" + +#. Tag: para +#: scopescontexts.xml:276 +#, no-c-format +msgid "" +"This feature is particularly useful with producer methods, as we'll see in " +"the next chapter." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/specialization.po =================================================================== --- doc/trunk/reference/zh-CN/modules/specialization.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/specialization.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,291 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: specialization.xml:4 +#, no-c-format +msgid "Specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:6 +#, no-c-format +msgid "" +"We've already seen how the Web Beans dependency injection model lets us " +"<emphasis>override</emphasis> the implementation of an API at deployment " +"time. For example, the following enterprise Web Bean provides an " +"implementation of the API <literal>PaymentProcessor</literal> in production:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:11 +#, no-c-format +msgid "" +"@CreditCard @Stateless\n" +"public class CreditCardPaymentProcessor \n" +" implements PaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:13 +#, no-c-format +msgid "" +"But in our staging environment, we override that implementation of " +"<literal>PaymentProcessor</literal> with a different Web Bean:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:16 +#, no-c-format +msgid "" +"@CreditCard @Stateless @Staging\n" +"public class StagingCreditCardPaymentProcessor \n" +" implements PaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:18 +#, no-c-format +msgid "" +"What we've tried to do with <literal>StagingCreditCardPaymentProcessor</" +"literal> is to completely replace <literal>AsyncPaymentProcessor</literal> " +"in a particular deployment of the system. In that deployment, the deployment " +"type <literal>@Staging</literal> would have a higher priority than the " +"default deployment type <literal>@Production</literal>, and therefore " +"clients with the following injection point:" +msgstr "" + +#. Tag: programlisting +#: specialization.xml:24 +#, no-c-format +msgid "@CreditCard PaymentProcessor ccpp" +msgstr "" + +#. Tag: para +#: specialization.xml:26 +#, no-c-format +msgid "" +"Would receive an instance of <literal>StagingCreditCardPaymentProcessor</" +"literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:28 +#, no-c-format +msgid "Unfortunately, there are several traps we can easily fall into:" +msgstr "" + +#. Tag: para +#: specialization.xml:32 +#, no-c-format +msgid "" +"the higher-priority Web Bean may not implement all the API types of the Web " +"Bean that it attempts to override," +msgstr "" + +#. Tag: para +#: specialization.xml:36 +#, no-c-format +msgid "" +"the higher-priority Web Bean may not declare all the binding types of the " +"Web Bean that it attempts to override," +msgstr "" + +#. Tag: para +#: specialization.xml:40 +#, no-c-format +msgid "" +"the higher-priority Web Bean might not have the same name as the Web Bean " +"that it attempts to override, or" +msgstr "" + +#. Tag: para +#: specialization.xml:44 +#, no-c-format +msgid "" +"the Web Bean that it attempts to override might declare a producer method, " +"disposal method or observer method." +msgstr "" + +#. Tag: para +#: specialization.xml:49 +#, no-c-format +msgid "" +"In each of these cases, the Web Bean that we tried to override could still " +"be called at runtime. Therefore, overriding is somewhat prone to developer " +"error." +msgstr "" + +#. Tag: para +#: specialization.xml:52 +#, no-c-format +msgid "" +"Web Beans provides a special feature, called <emphasis>specialization</" +"emphasis>, that helps the developer avoid these traps. Specialization looks " +"a little esoteric at first, but it's easy to use in practice, and you'll " +"really appreciate the extra security it provides." +msgstr "" + +#. Tag: title +#: specialization.xml:58 +#, no-c-format +msgid "Using specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:60 +#, no-c-format +msgid "" +"Specialization is a feature that is specific to simple and enterprise Web " +"Beans. To make use of specialization, the higher-priority Web Bean must:" +msgstr "" + +#. Tag: para +#: specialization.xml:65 +#, no-c-format +msgid "be a direct subclass of the Web Bean it overrides, and" +msgstr "" + +#. Tag: para +#: specialization.xml:68 +#, no-c-format +msgid "" +"be a simple Web Bean if the Web Bean it overrides is a simple Web Bean or an " +"enterprise Web Bean if the Web Bean it overrides is an enterprise Web Bean, " +"and" +msgstr "" + +#. Tag: para +#: specialization.xml:73 +#, no-c-format +msgid "be annotated <literal>@Specializes</literal>." +msgstr "" + +#. Tag: programlisting +#: specialization.xml:77 +#, no-c-format +msgid "" +"@Stateless @Staging @Specializes\n" +"public class StagingCreditCardPaymentProcessor \n" +" extends CreditCardPaymentProcessor {\n" +" ...\n" +"}" +msgstr "" + +#. Tag: para +#: specialization.xml:79 +#, no-c-format +msgid "" +"We say that the higher-priority Web Bean <emphasis>specializes</emphasis> " +"its superclass." +msgstr "" + +#. Tag: title +#: specialization.xml:85 +#, no-c-format +msgid "Advantages of specialization" +msgstr "" + +#. Tag: para +#: specialization.xml:87 +#, no-c-format +msgid "When specialization is used:" +msgstr "" + +#. Tag: para +#: specialization.xml:91 +#, no-c-format +msgid "" +"the binding types of the superclass are automatically inherited by the Web " +"Bean annotated <literal>@Specializes</literal>, and" +msgstr "" + +#. Tag: para +#: specialization.xml:95 +#, no-c-format +msgid "" +"the Web Bean name of the superclass is automatically inherited by the Web " +"Bean annotated <literal>@Specializes</literal>, and" +msgstr "" + +#. Tag: para +#: specialization.xml:99 +#, no-c-format +msgid "" +"producer methods, disposal methods and observer methods declared by the " +"superclass are called upon an instance of the Web Bean annotated " +"<literal>@Specializes</literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:105 +#, no-c-format +msgid "" +"In our example, the binding type <literal>@CreditCard</literal> of " +"<literal>CreditCardPaymentProcessor</literal> is inherited by " +"<literal>StagingCreditCardPaymentProcessor</literal>." +msgstr "" + +#. Tag: para +#: specialization.xml:109 +#, no-c-format +msgid "Furthermore, the Web Bean manager will validate that:" +msgstr "" + +#. Tag: para +#: specialization.xml:113 +#, no-c-format +msgid "" +"all API types of the superclass are API types of the Web Bean annotated " +"<literal>@Specializes</literal> (all local interfaces of the superclass " +"enterprise bean are also local interfaces of the subclass)," +msgstr "" + +#. Tag: para +#: specialization.xml:119 +#, no-c-format +msgid "" +"the deployment type of the Web Bean annotated <literal>@Specializes</" +"literal> has a higher precedence than the deployment type of the superclass, " +"and" +msgstr "" + +#. Tag: para +#: specialization.xml:124 +#, no-c-format +msgid "" +"there is no other enabled Web Bean that also specializes the superclass." +msgstr "" + +#. Tag: para +#: specialization.xml:129 +#, no-c-format +msgid "" +"If any of these conditions are violated, the Web Bean manager throws an " +"exception at initialization time." +msgstr "" + +#. Tag: para +#: specialization.xml:132 +#, no-c-format +msgid "" +"Therefore, we can be certain that the superclass with <emphasis>never</" +"emphasis> be called in any deployment of the system where the Web Bean " +"annotated <literal>@Specializes</literal> is deployed and enabled." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/stereotypes.po =================================================================== --- doc/trunk/reference/zh-CN/modules/stereotypes.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/stereotypes.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,352 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: stereotypes.xml:4 +#, no-c-format +msgid "Stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:6 +#, no-c-format +msgid "According to the Web Beans specification:" +msgstr "" + +#. Tag: para +#: stereotypes.xml:10 +#, no-c-format +msgid "" +"In many systems, use of architectural patterns produces a set of recurring " +"Web Bean roles. A stereotype allows a framework developer to identify such a " +"role and declare some common metadata for Web Beans with that role in a " +"central place." +msgstr "" + +#. Tag: para +#: stereotypes.xml:14 +#, no-c-format +msgid "A stereotype encapsulates any combination of:" +msgstr "" + +#. Tag: para +#: stereotypes.xml:18 +#, no-c-format +msgid "a default deployment type," +msgstr "" + +#. Tag: para +#: stereotypes.xml:21 +#, no-c-format +msgid "a default scope type," +msgstr "" + +#. Tag: para +#: stereotypes.xml:24 +#, no-c-format +msgid "a restriction upon the Web Bean scope," +msgstr "" + +#. Tag: para +#: stereotypes.xml:27 +#, no-c-format +msgid "a requirement that the Web Bean implement or extend a certain type, and" +msgstr "" + +#. Tag: para +#: stereotypes.xml:30 +#, no-c-format +msgid "a set of interceptor binding annotations." +msgstr "" + +#. Tag: para +#: stereotypes.xml:34 +#, no-c-format +msgid "" +"A stereotype may also specify that all Web Beans with the stereotype have " +"defaulted Web Bean names." +msgstr "" + +#. Tag: para +#: stereotypes.xml:37 +#, no-c-format +msgid "A Web Bean may declare zero, one or multiple stereotypes." +msgstr "" + +#. Tag: para +#: stereotypes.xml:41 +#, no-c-format +msgid "" +"A stereotype is a Java annotation type. This stereotype identifies action " +"classes in some MVC framework:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:44 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:46 +#, no-c-format +msgid "We use the stereotype by applying the annotation to a Web Bean." +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:48 +#, no-c-format +msgid "" +"<![CDATA[@Action \n" +"public class LoginAction { ... }]]>" +msgstr "" + +#. Tag: title +#: stereotypes.xml:51 +#, no-c-format +msgid "Default scope and deployment type for a stereotype" +msgstr "" + +#. Tag: para +#: stereotypes.xml:53 +#, no-c-format +msgid "" +"A stereotype may specify a default scope and/or default deployment type for " +"Web Beans with that stereotype. For example, if the deployment type " +"<literal>@WebTier</literal> identifies Web Beans that should only be " +"deployed when the system executes as a web application, we might specify the " +"following defaults for action classes:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:59 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:61 +#, no-c-format +msgid "" +"Of course, a particular action may still override these defaults if " +"necessary:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:64 +#, no-c-format +msgid "" +"<![CDATA[@Dependent @Mock @Action \n" +"public class MockLoginAction { ... }]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:66 +#, no-c-format +msgid "" +"If we want to force all actions to a particular scope, we can do that too." +msgstr "" + +#. Tag: title +#: stereotypes.xml:72 +#, no-c-format +msgid "Restricting scope and type with a stereotype" +msgstr "" + +#. Tag: para +#: stereotypes.xml:74 +#, no-c-format +msgid "" +"Suppose that we wish to prevent actions from declaring certain scopes. Web " +"Beans lets us explicitly specify the set of allowed scopes for Web Beans " +"with a certain stereotype. For example:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:78 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype(supportedScopes=RequestScoped.class)\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:80 +#, no-c-format +msgid "" +"If a particular action class attempts to specify a scope other than the Web " +"Beans request scope, an exception will be thrown by the Web Bean manager at " +"initialization time." +msgstr "" + +#. Tag: para +#: stereotypes.xml:84 +#, no-c-format +msgid "" +"We can also force all Web Bean with a certain stereotype to implement an " +"interface or extend a class:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:87 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@WebTier\n" +"@Stereotype(requiredTypes=AbstractAction.class)\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:89 +#, no-c-format +msgid "" +"If a particular action class does not extend the class " +"<literal>AbstractAction</literal>, an exception will be thrown by the Web " +"Bean manager at initialization time." +msgstr "" + +#. Tag: title +#: stereotypes.xml:96 +#, no-c-format +msgid "Interceptor bindings for stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:98 +#, no-c-format +msgid "" +"A stereotype may specify a set of interceptor bindings to be inherited by " +"all Web Beans with that stereotype." +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:101 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@Transactional(requiresNew=true)\n" +"@Secure\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:103 +#, no-c-format +msgid "" +"This helps us get technical concerns even further away from the business " +"code!" +msgstr "" + +#. Tag: title +#: stereotypes.xml:109 +#, no-c-format +msgid "Name defaulting with stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:111 +#, no-c-format +msgid "" +"Finally, we can specify that all Web Beans with a certain stereotype have a " +"Web Bean name, defaulted by the Web Bean manager. Actions are often " +"referenced in JSP pages, so they're a perfect use case for this feature. All " +"we need to do is add an empty <literal>@Named</literal> annotation:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:116 +#, no-c-format +msgid "" +"<![CDATA[@Retention(RUNTIME)\n" +"@Target(TYPE)\n" +"@RequestScoped\n" +"@Transactional(requiresNew=true)\n" +"@Secure\n" +"@Named\n" +"@WebTier\n" +"@Stereotype\n" +"public @interface Action {}]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:118 +#, no-c-format +msgid "" +"Now, <literal>LoginAction</literal> will have the name <literal>loginAction</" +"literal>." +msgstr "" + +#. Tag: title +#: stereotypes.xml:124 +#, no-c-format +msgid "Standard stereotypes" +msgstr "" + +#. Tag: para +#: stereotypes.xml:126 +#, no-c-format +msgid "" +"We've already met two standard stereotypes defined by the Web Beans " +"specification: <literal>@Interceptor</literal> and <literal>@Decorator</" +"literal>." +msgstr "" + +#. Tag: para +#: stereotypes.xml:129 +#, no-c-format +msgid "Web Beans defines one further standard stereotype:" +msgstr "" + +#. Tag: programlisting +#: stereotypes.xml:131 +#, no-c-format +msgid "" +"<![CDATA[@Named \n" +"@RequestScoped \n" +"@Stereotype \n" +"@Target({TYPE, METHOD}) \n" +"@Retention(RUNTIME) \n" +"public @interface Model {} ]]>" +msgstr "" + +#. Tag: para +#: stereotypes.xml:133 +#, no-c-format +msgid "" +"This stereotype is intended for use with JSF. Instead of using JSF managed " +"beans, just annotate a Web Bean <literal>@Model</literal>, and use it " +"directly in your JSF page." +msgstr "" Added: doc/trunk/reference/zh-CN/modules/xml.po =================================================================== --- doc/trunk/reference/zh-CN/modules/xml.po (rev 0) +++ doc/trunk/reference/zh-CN/modules/xml.po 2008-12-19 20:31:50 UTC (rev 602) @@ -0,0 +1,352 @@ +# Language zh-CN translations for master.xml package. +# Automatically generated, 2008. +# +msgid "" +msgstr "" +"Project-Id-Version: master.xml \n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2008-12-19 20:26+0000\n" +"PO-Revision-Date: 2008-12-19 20:26+0000\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: xml.xml:4 +#, no-c-format +msgid "Defining Web Beans using XML" +msgstr "" + +#. Tag: para +#: xml.xml:6 +#, no-c-format +msgid "" +"So far, we've seen plenty of examples of Web Beans declared using " +"annotations. However, there are a couple of occasions when we can't use " +"annotations to define the Web Bean:" +msgstr "" + +#. Tag: para +#: xml.xml:12 +#, no-c-format +msgid "when the implementation class comes from some preexisting library, or" +msgstr "" + +#. Tag: para +#: xml.xml:15 +#, no-c-format +msgid "" +"when there should be multiple Web Beans with the same implementation class." +msgstr "" + +#. Tag: para +#: xml.xml:20 +#, no-c-format +msgid "In either of these cases, Web Beans gives us two options:" +msgstr "" + +#. Tag: para +#: xml.xml:23 +#, no-c-format +msgid "write a producer method, or" +msgstr "" + +#. Tag: para +#: xml.xml:24 +#, no-c-format +msgid "declare the Web Bean using XML." +msgstr "" + +#. Tag: para +#: xml.xml:27 +#, no-c-format +msgid "" +"Many frameworks use XML to provide metadata relating to Java classes. " +"However, Web Beans uses a very different approach to specifying the names of " +"Java classes, fields or methods to most other frameworks. Instead of writing " +"class and member names as the string values of XML elements and attributes, " +"Web Beans lets you use the class or member name as the name of the XML " +"element." +msgstr "" + +#. Tag: para +#: xml.xml:33 +#, no-c-format +msgid "" +"The advantage of this approach is that you can write an XML schema that " +"prevents spelling errors in your XML document. It's even possible for a tool " +"to generate the XML schema automatically from the compiled Java code. Or, an " +"integrated development environment could perform the same validation without " +"the need for the explicit intermediate generation step." +msgstr "" + +#. Tag: title +#: xml.xml:40 +#, no-c-format +msgid "Declaring Web Bean classes" +msgstr "" + +#. Tag: para +#: xml.xml:42 +#, no-c-format +msgid "" +"For each Java package, Web Beans defines a corresponding XML namespace. The " +"namespace is formed by prepending <literal>urn:java:</literal> to the Java " +"package name. For the package <literal>com.mydomain.myapp</literal>, the XML " +"namespace is <literal>urn:java:com.mydomain.myapp</literal>." +msgstr "" + +#. Tag: para +#: xml.xml:47 +#, no-c-format +msgid "" +"Java types belonging to a package are referred to using an XML element in " +"the namespace corresponding to the package. The name of the element is the " +"name of the Java type. Fields and methods of the type are specified by child " +"elements in the same namespace. If the type is an annotation, members are " +"specified by attributes of the element." +msgstr "" + +#. Tag: para +#: xml.xml:53 +#, no-c-format +msgid "" +"For example, the element <literal><util:Date/></literal> in the " +"following XML fragment refers to the class <literal>java.util.Date</literal>:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:56 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans xmlns=\"urn:java:javax.webbeans\"\n" +" xmlns:util=\"urn:java:java.util\">\n" +"\n" +" <util:Date/>\n" +"\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:58 +#, no-c-format +msgid "" +"And this is all the code we need to declare that <literal>Date</literal> is " +"a simple Web Bean! An instance of <literal>Date</literal> may now be " +"injected by any other Web Bean:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:62 +#, no-c-format +msgid "<![CDATA[@Current Date date]]>" +msgstr "" + +#. Tag: title +#: xml.xml:67 +#, no-c-format +msgid "Declaring Web Bean metadata" +msgstr "" + +#. Tag: para +#: xml.xml:69 +#, no-c-format +msgid "" +"We can declare the scope, deployment type and interceptor binding types " +"using direct child elements of the Web Bean declaration:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:72 +#, no-c-format +msgid "" +"<![CDATA[<myapp:ShoppingCart>\n" +" <SessionScoped/>\n" +" <myfwk:Transactional requiresNew=\"true\"/>\n" +" <myfwk:Secure/>\n" +"</myapp:ShoppingCart>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:74 +#, no-c-format +msgid "We use exactly the same approach to specify names and binding type:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:76 +#, no-c-format +msgid "" +"<![CDATA[<util:Date>\n" +" <Named>currentTime</Named>\n" +"</util:Date>\n" +"\n" +"<util:Date>\n" +" <SessionScoped/>\n" +" <myapp:Login/>\n" +" <Named>loginTime</Named>\n" +"</util:Date>\n" +"\n" +"<util:Date>\n" +" <ApplicationScoped/>\n" +" <myapp:SystemStart/>\n" +" <Named>systemStartTime</Named>\n" +"</util:Date>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:78 +#, no-c-format +msgid "" +"Where <literal>@Login</literal> and <literal>@SystemStart</literal> are " +"binding annotations types." +msgstr "" + +#. Tag: programlisting +#: xml.xml:81 +#, no-c-format +msgid "" +"<![CDATA[@Current Date currentTime;\n" +"@Login Date loginTime;\n" +"@SystemStart Date systemStartTime;]]>" +msgstr "" + +#. Tag: para +#: xml.xml:83 +#, no-c-format +msgid "As usual, a Web Bean may support multiple binding types:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:85 +#, no-c-format +msgid "" +"<![CDATA[<myapp:AsynchronousChequePaymentProcessor>\n" +" <myapp:PayByCheque/>\n" +" <myapp:Asynchronous/>\n" +"</myapp:AsynchronousChequePaymentProcessor>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:87 +#, no-c-format +msgid "" +"Interceptors and decorators are just simple Web Beans, so they may be " +"declared just like any other simple Web Bean:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:90 +#, no-c-format +msgid "" +"<![CDATA[<myfwk:TransactionInterceptor>\n" +" <Interceptor/>\n" +" <myfwk:Transactional/>\n" +"</myfwk:TransactionInterceptor>]]>" +msgstr "" + +#. Tag: title +#: xml.xml:95 +#, no-c-format +msgid "Declaring Web Bean members" +msgstr "" + +#. Tag: para +#: xml.xml:97 +#, no-c-format +msgid "TODO!" +msgstr "" + +#. Tag: title +#: xml.xml:104 +#, no-c-format +msgid "Declaring inline Web Beans" +msgstr "" + +#. Tag: para +#: xml.xml:106 +#, no-c-format +msgid "Web Beans lets us define a Web Bean at an injection point. For example:" +msgstr "" + +#. Tag: programlisting +#: xml.xml:108 +#, no-c-format +msgid "" +"<![CDATA[<myapp:System>\n" +" <ApplicationScoped/>\n" +" <myapp:admin>\n" +" <myapp:Name>\n" +" <myapp:firstname>Gavin</myapp:firstname>\n" +" <myapp:lastname>King</myapp:lastname>\n" +" <myapp:email>gavin(a)hibernate.org</myapp:email>\n" +" </myapp:Name>\n" +" </myapp:admin>\n" +"</myapp:System>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:110 +#, no-c-format +msgid "" +"The <literal><Name></literal> element declares a simple Web Bean of " +"scope <literal>@Dependent</literal> and class <literal>Name</literal>, with " +"a set of initial field values. This Web Bean has a special, container-" +"generated binding and is therefore injectable only to the specific injection " +"point at which it is declared." +msgstr "" + +#. Tag: para +#: xml.xml:116 +#, no-c-format +msgid "" +"This simple but powerful feature allows the Web Beans XML format to be used " +"to specify whole graphs of Java objects. It's not quite a full databinding " +"solution, but it's close!" +msgstr "" + +#. Tag: title +#: xml.xml:123 +#, no-c-format +msgid "Using a schema" +msgstr "" + +#. Tag: para +#: xml.xml:125 +#, no-c-format +msgid "" +"If we want our XML document format to be authored by people who aren't Java " +"developers, or who don't have access to our code, we need to provide a " +"schema. There's nothing specific to Web Beans about writing or using the " +"schema." +msgstr "" + +#. Tag: programlisting +#: xml.xml:130 +#, no-c-format +msgid "" +"<![CDATA[<WebBeans xmlns=\"urn:java:javax.webbeans\"\n" +" xmlns:myapp=\"urn:java:com.mydomain.myapp\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"urn:java:javax.webbeans http://java.sun.com/" +"jee/web-beans-1.0.xsd\n" +" urn:java:com.mydomain.myapp http://mydomain." +"com/xsd/myapp-1.2.xsd\">\n" +"\n" +" <myapp:System>\n" +" ...\n" +" </myapp:System>\n" +"\n" +"</WebBeans>]]>" +msgstr "" + +#. Tag: para +#: xml.xml:132 +#, no-c-format +msgid "" +"Writing an XML schema is quite tedious. Therefore, the Web Beans RI project " +"will provide a tool which automatically generates the XML schema from " +"compiled Java code." +msgstr ""

15 years, 6 months

1
0
0 / 0

[webbeans-commits] Webbeans SVN: r601 - doc/trunk/reference.

by webbeans-commits＠lists.jboss.org

Author: pete.muir(a)jboss.org Date: 2008-12-19 15:24:06 -0500 (Fri, 19 Dec 2008) New Revision: 601 Added: doc/trunk/reference/Makefile Log: Add publican make file Added: doc/trunk/reference/Makefile =================================================================== --- doc/trunk/reference/Makefile (rev 0) +++ doc/trunk/reference/Makefile 2008-12-19 20:24:06 UTC (rev 601) @@ -0,0 +1,15 @@ +#Makefile for Red Hat Documentation +#Created by Jeff Fearn <jfearn(a)redhat.com> +#Copyright Red Hat Inc. 2006 + +XML_LANG = en-US +DOCNAME = master.xml +PRODUCT = WebBeansReferenceManual +BRAND = JBoss + +TRANSLATIONS = $(XML_LANG) +OTHER_LANGS = es-ES fr-FR it-IT ja-JP zh-CN +#TRANSLATIONS = $(XML_LANG) $(OTHER_LANGS) + +COMMON_CONFIG = /usr/share/publican +include $(COMMON_CONFIG)/make/Makefile.common Property changes on: doc/trunk/reference/Makefile ___________________________________________________________________ Name: svn:executable + *

15 years, 6 months

1
0
0 / 0

[webbeans-commits] Webbeans SVN: r600 - doc/trunk/reference.

by webbeans-commits＠lists.jboss.org

Author: dallen6 Date: 2008-12-19 15:17:35 -0500 (Fri, 19 Dec 2008) New Revision: 600 Modified: doc/trunk/reference/pom.xml Log: Set default goal to package to build complete reference document by default Modified: doc/trunk/reference/pom.xml =================================================================== --- doc/trunk/reference/pom.xml 2008-12-19 20:16:06 UTC (rev 599) +++ doc/trunk/reference/pom.xml 2008-12-19 20:17:35 UTC (rev 600) @@ -26,6 +26,7 @@ </repositories> <build> + <defaultGoal>package</defaultGoal> <plugins> <plugin> <groupId>org.jboss.maven.plugins</groupId>

15 years, 6 months

1
0
0 / 0

[webbeans-commits] Webbeans SVN: r599 - ri/trunk/webbeans-ri.

by webbeans-commits＠lists.jboss.org

Author: dallen6 Date: 2008-12-19 15:16:06 -0500 (Fri, 19 Dec 2008) New Revision: 599 Modified: ri/trunk/webbeans-ri/pom.xml Log: Changed default goal of build to install (compile, test, package and install in local repository). Modified: ri/trunk/webbeans-ri/pom.xml =================================================================== --- ri/trunk/webbeans-ri/pom.xml 2008-12-19 20:13:49 UTC (rev 598) +++ ri/trunk/webbeans-ri/pom.xml 2008-12-19 20:16:06 UTC (rev 599) @@ -79,7 +79,8 @@ </dependencies> <build> - <plugins> + <defaultGoal>install</defaultGoal> + <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId>

15 years, 6 months

1
0
0 / 0

[webbeans-commits] Webbeans SVN: r598 - ri/trunk/examples/numberguess/WebContent and 1 other directories.

by webbeans-commits＠lists.jboss.org

Author: pete.muir(a)jboss.org Date: 2008-12-19 15:13:49 -0500 (Fri, 19 Dec 2008) New Revision: 598 Removed: ri/trunk/examples/translator/webbeans-translator-war/WebContent/WEB-INF/web-beans.xml Modified: doc/trunk/reference/en/modules/ri.xml ri/trunk/examples/numberguess/WebContent/home.xhtml Log: Doc the translator example, tidy up Modified: doc/trunk/reference/en/modules/ri.xml =================================================================== --- doc/trunk/reference/en/modules/ri.xml 2008-12-19 19:33:21 UTC (rev 597) +++ doc/trunk/reference/en/modules/ri.xml 2008-12-19 20:13:49 UTC (rev 598) @@ -432,8 +432,7 @@ <programlisting role="JAVA"><![CDATA[@Named @SessionScoped -public class Game -{ +public class Game { private int number; private int guess; @@ -441,13 +440,10 @@ private int biggest; private int remainingGuesses; - public Game() - { - } + public Game() {} @Initializer - Game(@Random int number, @MaxNumber int maxNumber) - { + Game(@Random int number, @MaxNumber int maxNumber) { this.number = number; this.smallest = 1; this.biggest = maxNumber; @@ -456,18 +452,14 @@ // Getters and setters for fields - public String check() - { - if (guess>number) - { + public String check() { + if (guess>number) { biggest = guess - 1; } - if (guess<number) - { + if (guess<number) { smallest = guess + 1; } - if (guess == number) - { + if (guess == number) { FacesContext.getCurrentInstance().addMessage(null, new FacesMessage("Correct!")); } remainingGuesses--; @@ -484,6 +476,241 @@ The translator example will take any sentences you enter, and translate them to Latin. </para> + + <para> + The translator example is built as an ear, and contains EJBs and + enterprise beans. As a result, it's structure is more complex than + the numberguess example. + </para> + + <note> + <para> + EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will + make this structure much simpler! + </para> + </note> + + <para> + First, let's take a look at the ear aggregator, which is located in + <literal>webbeans-translator-ear</literal> module. Maven automatically + generates the <literal>application.xml</literal> and + <literal>jboss-app.xml</literal> for us: + </para> + + <programlisting role="XML"><![CDATA[<plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-ear-plugin</artifactId> + <configuration> + <modules> + <webModule> + <groupId>org.jboss.webbeans.examples.translator</groupId> + <artifactId>webbeans-translator-war</artifactId> + <contextRoot>/webbeans-translator</contextRoot> + </webModule> + </modules> + <jboss> + <loader-repository>webbeans.jboss.org:loader=webbeans-translator</loader-repository> + </jboss> + </configuration> +</plugin>]]></programlisting> + + <para> + We're doing a couple of things here - firstly we set the context path, + which gives us a nice url + (<ulink url="http://localhost:8080/webbeans-translator">http://localhost:8080/webbeans-translator</ulink>) + and we also enable class loader isolation for JBoss AS. + </para> + + <tip> + <para> + If you aren't using Maven to generate these files, you would need + <literal>META-INF/jboss-app.xml</literal>: + </para> + + <programlisting role="XML"><![CDATA[<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE jboss-app + PUBLIC "-//JBoss//DTD J2EE Application 4.2//EN" + "http://www.jboss.org/j2ee/dtd/jboss-app_4_2.dtd"> +<jboss-app> + <loader-repository>webbeans.jboss.org:loader=webbeans-translator</loader-repository> +</jboss-app>]]></programlisting> + + <para> + and <literal>META-INF/application.xml</literal>: + </para> + + <programlisting role="XML"><![CDATA[<?xml version="1.0" encoding="UTF-8"?> +<application xmlns="http://java.sun.com/xml/ns/javaee" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/application_5.xsd" + version="5"> + <display-name>webbeans-translator-ear</display-name> + <description>Ear Example for the reference implementation of JSR 299: Web Beans</description> + + <module> + <web> + <web-uri>webbeans-translator.war</web-uri> + <context-root>/webbeans-translator</context-root> + </web> + </module> + <module> + <ejb>webbeans-translator.jar</ejb> + </module> +</application>]]></programlisting> + </tip> + + <para> + Next, lets look at the war. Just as in the numberguess example, we have + a <literal>faces-config.xml</literal> (to enabled Facelets) and a + <literal>web.xml</literal> (to enable JSF and attach Web Beans services + to the servlet container) in <literal>WebContent/WEB-INF</literal>. + </para> + + <para> + More intersting is the facelet used to translate text. Just as in + the numberguess example we have a template, which surrounds the form + (ommitted here for brevity): + </para> + + <programlisting role="XML"><![CDATA[<h:form id="NumberGuessMain"> + + <table> + <tr align="center" style="font-weight: bold" > + <td> + Your text + </td> + <td> + Translation + </td> + </tr> + <tr> + <td> + <h:inputTextarea id="text" value="#{translator.text}" required="true" rows="5" cols="80" /> + </td> + <td> + <h:outputText value="#{translator.translatedText}" /> + </td> + </tr> + </table> + <div> + <h:commandButton id="button" value="Translate" action="#{translator.translate}"/> + </div> + +</h:form>]]></programlisting> + + <para> + The user can enter some text in the lefthand textarea, and hit the + translate button to see the result to the right. + </para> + + <para> + Finally, let's look at the ejb module, + <literal>webbeans-translator-ejb</literal>. + There are two configuration files in + <literal>src/main/resources/META-INF</literal>, an empty + <literal>web-beans.xml</literal>, used to mark the archive as + containing Web Beans, and <literal>ejb-jar.xml</literal>. Web Beans + provides injection and initializtion services for all EJBs, and uses + <literal>ejb-jar.xml</literal> to enable this, you'll need this in any + EJB project which uses Web Beans: + </para> + + <programlisting role="XML"><![CDATA[<?xml version="1.0" encoding="UTF-8"?> +<ejb-jar xmlns="http://java.sun.com/xml/ns/javaee" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/ejb-jar_3_0.xsd" + version="3.0"> + + <interceptors> + <interceptor> + <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</interceptor-class> + </interceptor> + </interceptors> + + <assembly-descriptor> + <interceptor-binding> + <ejb-name>*</ejb-name> + <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</interceptor-class> + </interceptor-binding> + </assembly-descriptor> + +</ejb-jar>]]></programlisting> + + <para> + We've saved the most interesting bit to last, the code! The project has + two simple beans, <literal>SentanceParser</literal> and + <literal>TextTranslator</literal> and two enterprise beans, + <literal>TanslatorControllerBean</literal> and + <literal>SentenceTranslator</literal>. You should be getting quite + familiar with what a Web Bean looks like by now, so we'll just + highlight the most interesting bits here. + </para> + + <para> + Both <literal>SentanceParser</literal> and + <literal>TextTranslator</literal> are dependent beans, and + <literal>TextTranslator</literal> uses constructor initialization: + </para> + + <programlisting role="JAVA"><![CDATA[public class TextTranslator { + private SentenceParser sentenceParser; + private Translator sentenceTranslator; + + @Initializer + TextTranslator(SentenceParser sentenceParser, Translator sentenceTranslator) + { + this.sentenceParser = sentenceParser; + this.sentenceTranslator = sentenceTranslator;]]></programlisting> + + <para> + <literal>TextTranslator</literal> is a stateless bean (with a local + business interface), where the magic happens - of course, we couldn't + develop a full translator, but we gave it a good go! + </para> + + <para> + Finally, there is UI orientated controller, that collects the text from + the user, and dispatches it to the translator. This is a request + scoped, named, stateful session bean, which injects the translator. + </para> + + <programlisting role="JAVA"><![CDATA[@Stateful +@RequestScoped +@Named("translator") +public class TranslatorControllerBean implements TranslatorController +{ + + @Current TextTranslator translator;]]></programlisting> + + <para> + The bean also has getters and setters for all the fields on the page. + </para> + + <para> + As this is a stateful session bean, we have to have a remove method: + </para> + + <programlisting role="JAVA"><![CDATA[ @Remove + public void remove() + { + + }]]></programlisting> + + <para> + The Web Beans manager will call the remove method for you when the bean + is destroyed; in this case at the end of the request. + </para> </section> + + <para> + That concludes our short tour of the Web Beans RI examples. For more on + the RI, or to help out, please visit + <ulink url="http://www.seamframework.org/WebBeans/Development">http://www.seamframework.org/WebBeans/Development</ulink>. + </para> + + <para> + We need help in all areas - bug fixing, writing new features, writing + examples and translating this reference guide. + </para> </chapter> \ No newline at end of file Modified: ri/trunk/examples/numberguess/WebContent/home.xhtml =================================================================== --- ri/trunk/examples/numberguess/WebContent/home.xhtml 2008-12-19 19:33:21 UTC (rev 597) +++ ri/trunk/examples/numberguess/WebContent/home.xhtml 2008-12-19 20:13:49 UTC (rev 598) @@ -10,7 +10,7 @@ <h1>Guess a number...</h1> <h:form id="NumberGuessMain"> <div style="color: red"> - <h:messages id="messages" globalOnly="true"/> + <h:messages id="messages" globalOnly="false"/> <h:outputText id="Higher" value="Higher!" rendered="#{game.number gt game.guess}"/> <h:outputText id="Lower" value="Lower!" rendered="#{game.number lt game.guess}"/> </div> @@ -26,10 +26,6 @@ </h:inputText> <h:commandButton id="GuessButton" value="Guess" action="#{game.check}"/> </div> - - <div> - <h:message id="message" for="inputGuess" style="color: red"/> - </div> </h:form> </ui:define> </ui:composition> Deleted: ri/trunk/examples/translator/webbeans-translator-war/WebContent/WEB-INF/web-beans.xml ===================================================================

15 years, 6 months

1
0
0 / 0

[webbeans-commits] Webbeans SVN: r597 - doc/trunk/reference/en/modules.

by webbeans-commits＠lists.jboss.org

Author: pete.muir(a)jboss.org Date: 2008-12-19 14:33:21 -0500 (Fri, 19 Dec 2008) New Revision: 597 Modified: doc/trunk/reference/en/modules/ri.xml Log: Document numberguess example Modified: doc/trunk/reference/en/modules/ri.xml =================================================================== --- doc/trunk/reference/en/modules/ri.xml 2008-12-19 18:41:20 UTC (rev 596) +++ doc/trunk/reference/en/modules/ri.xml 2008-12-19 19:33:21 UTC (rev 597) @@ -65,7 +65,7 @@ Now, you're ready to deploy your first example! </para> - <note> + <tip> <para> The build scripts for the examples offer a number of targets, these are: @@ -99,7 +99,7 @@ </para> </listitem> </itemizedlist> - </note> + </tip> <para> To deploy the numberguess example: @@ -127,5 +127,363 @@ Wait for the application to deploy, and visit <ulink url="http://localhost:8080/webbeans-translator" />! </para> + + <section> + <title>The numberguess example</title> + + <para> + In the numberguess application you get given 10 attempts to guess a + number between 1 and 100. After each attempt, you will be told whether + you are too high, or too low. + </para> + + <para> + The numberguess example is comprised of a number of Web Beans, + configuration files, and Facelet JSF pages, packaged as a war. Let's + start with the configuration files. + </para> + + <para> + All the configuration files for this example are located in + <literal>WEB-INF/</literal>, which is stored in + <literal>WebContent</literal> in the source tree. First, we have + <literal>faces-config.xml</literal>, in which we tell JSF to use + Facelets: + </para> + + <programlisting role="XML"><![CDATA[<?xml version='1.0' encoding='UTF-8'?> +<faces-config version="1.2" + xmlns="http://java.sun.com/xml/ns/javaee" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd"> + + <application> + <view-handler>com.sun.facelets.FaceletViewHandler</view-handler> + </application> +</faces-config>]]></programlisting> + + <para> + There is an empty <literal>web-beans.xml</literal> file, which marks + this application as a Web Beans application. + </para> + + <para> + Finally there is <literal>web.xml</literal>: + </para> + + <programlistingco> + <areaspec> + <area id="faces.servlet" coords="12" /> + <area id="faces.servlet.mapping" coords="18" /> + <area id="faces.default.suffix" coords="23" /> + <area id="session.timeout" coords="28" /> + <area id="webbeans.listener" coords="32" /> + </areaspec> + <programlisting><![CDATA[<?xml version="1.0" encoding="UTF-8"?> + +<web-app version="2.5" + xmlns="http://java.sun.com/xml/ns/javaee" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> + + <display-name>Web Beans Numbergues example</display-name> + +  + + <servlet> + <servlet-name>Faces Servlet</servlet-name> + <servlet-class>javax.faces.webapp.FacesServlet</servlet-class> + <load-on-startup>1</load-on-startup> + </servlet> + + <servlet-mapping> + <servlet-name>Faces Servlet</servlet-name> + <url-pattern>*.jsf</url-pattern> + </servlet-mapping> + + <context-param> + <param-name>javax.faces.DEFAULT_SUFFIX</param-name> + <param-value>.xhtml</param-value> + </context-param> + + <session-config> + <session-timeout>10</session-timeout> + </session-config> + + <listener> + <listener-class>org.jboss.webbeans.servlet.WebBeansListener</listener-class> + </listener> + +</web-app>]]></programlisting> + <calloutlist> + <callout arearefs="faces.servlet"> + <para> + Enable and load the JSF servlet + </para> + </callout> + <callout arearefs="faces.servlet.mapping"> + <para> + Configure requests to <literal>.jsf</literal> pages to be + handled by JSF + </para> + </callout> + <callout arearefs="faces.default.suffix"> + <para> + Tell JSF that we will be giving our source files (facelets) an + extension of <literal>.jsf</literal> + </para> + </callout> + <callout arearefs="session.timeout"> + <para> + Configure a session timeout of 10 minutes + </para> + </callout> + <callout arearefs="webbeans.listener"> + <para> + Configure the Web Beans listener, so that Web Beans services + can be used in the servlet request + </para> + </callout> + </calloutlist> + </programlistingco> + + <note> + <para> + The only configuration required by the Web Beans RI in + <literal>web.xml</literal> is to add the Web Beans listener. + </para> + <para> + Whilst this demo is a JSF demo, you can use the Web Beans RI with + any Servlet based web framework; just configure the Web Beans + listener. + </para> + </note> + + <para> + Let's take a look at the Facelet view: + </para> + + <programlistingco> + <areaspec> + <area id="template" coords="8" /> + <area id="messages" coords="12" /> + <area id="instructions" coords="19" /> + <area id="guess" coords="25" /> + <area id="validator" coords="29" /> + <area id="submit" coords="32" /> + </areaspec> + <programlisting><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" + xmlns:ui="http://java.sun.com/jsf/facelets" + xmlns:h="http://java.sun.com/jsf/html" + xmlns:f="http://java.sun.com/jsf/core" + xmlns:s="http://jboss.com/products/seam/taglib"> + + <ui:composition template="template.xhtml"> + <ui:define name="content"> + <h1>Guess a number...</h1> + <h:form id="NumberGuessMain"> + <div style="color: red"> + <h:messages id="messages" globalOnly="false"/> + <h:outputText id="Higher" value="Higher!" rendered="#{game.number gt game.guess}"/> + <h:outputText id="Lower" value="Lower!" rendered="#{game.number lt game.guess}"/> + </div> + + <div> + I'm thinking of a number between #{game.smallest} and #{game.biggest}. + You have #{game.remainingGuesses} guesses. + </div> + + <div> + Your guess: + <h:inputText id="inputGuess" + value="#{game.guess}" + required="true" + size="3"> + <f:validateLongRange maximum="#{game.biggest}" + minimum="#{game.smallest}"/> + </h:inputText> + <h:commandButton id="GuessButton" + value="Guess" + action="#{game.check}"/> + </div> + + </h:form> + </ui:define> + </ui:composition> +</html>]]></programlisting> + <calloutlist> + <callout arearefs="template"> + <para> + Facelets is a templating language for JSF, here we are + wrapping our page in a template which defines the header. + </para> + </callout> + <callout arearefs="messages"> + <para> + There are a number of messages which can be sent to the user, + "Higher!", "Lower!" and "Correct!" + </para> + </callout> + <callout arearefs="instructions"> + <para> + As the user guesses, the range of numbers they can guess gets + smaller - this sentance changes to make sure they know what + range to guess in. + </para> + </callout> + <callout arearefs="guess"> + <para> + This input field is bound to a Web Bean, using the value + expression. + </para> + </callout> + <callout arearefs="validator"> + <para> + A range validator is used to make sure the user doesn't + accidentally input a number outside of the range in which they + can guess - if the validator wasn't here, the user might use + up a guess on an out of range number. + </para> + </callout> + <callout arearefs="submit"> + <para> + And, of course, there must be a way for the user to send their + guess to the server. Here we bind to an action method on the + Web Bean. + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + The example exists of 4 classes, the first two of which are binding + types. First, there is the <literal>@Random</literal> binding type, + used for injecting a random number: + </para> + + <programlisting role="JAVA"><![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD }) +@Retention(RUNTIME) +@Documented +@BindingType +public @interface Random {}]]></programlisting> + + <para> + There is also the <literal>@MaxNumber</literal> binding type, used for + injecting the maximum number that can be injected: + </para> + + <programlisting role="JAVA"><![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD }) +@Retention(RUNTIME) +@Documented +@BindingType +public @interface MaxNumber {} +]]></programlisting> + + <para> + The <literal>Generator</literal> class is responsible for creating the + random number, via a producer method. It also exposes the maximum + possible number via a producer method: + </para> + + <programlisting role="JAVA"><![CDATA[@ApplicationScoped +public class Generator { + + private java.util.Random random = new java.util.Random( System.currentTimeMillis() ); + + private int maxNumber = 100; + + java.util.Random getRandom() + { + return random; + } + + @Produces @Random int next() { + return getRandom().nextInt(maxNumber); + } + + @Produces @MaxNumber int getMaxNumber() + { + return maxNumber; + } + +}]]></programlisting> + + <para> + You'll notice that the <literal>Generator</literal> is application + scoped; therefore we don't get a different random each time. + </para> + + <para> + The final Web Bean in the application is the session scoped + <literal>Game</literal>. By making <literal>Game</literal> session + scoped, you can only play the game once per browser session. You could + easily add a reset button - a good exercise for the reader :-) + </para> + + <para> + You'll also note that we've used the <literal>@Named</literal> + annotation, so that we can use the bean through EL in the JSF page. + Finally, we've used constructor injection to initialize the game with + a random number. And of course, we need to tell the player when they've + won, so we give feedback with a <literal>FacesMessage</literal>. + </para> + + <programlisting role="JAVA"><![CDATA[@Named +@SessionScoped +public class Game +{ + private int number; + + private int guess; + private int smallest; + private int biggest; + private int remainingGuesses; + + public Game() + { + } + + @Initializer + Game(@Random int number, @MaxNumber int maxNumber) + { + this.number = number; + this.smallest = 1; + this.biggest = maxNumber; + this.remainingGuesses = 10; + } + + // Getters and setters for fields + + public String check() + { + if (guess>number) + { + biggest = guess - 1; + } + if (guess<number) + { + smallest = guess + 1; + } + if (guess == number) + { + FacesContext.getCurrentInstance().addMessage(null, new FacesMessage("Correct!")); + } + remainingGuesses--; + return null; + } + +}]]></programlisting> + </section> + + <section> + <title>The translator example</title> + + <para> + The translator example will take any sentences you enter, and translate + them to Latin. + </para> + </section> + </chapter> \ No newline at end of file

15 years, 6 months

1
0
0 / 0

[webbeans-commits] Webbeans SVN: r596 - in ri/trunk: jboss-as and 1 other directory.

by webbeans-commits＠lists.jboss.org

Author: pete.muir(a)jboss.org Date: 2008-12-19 13:41:20 -0500 (Fri, 19 Dec 2008) New Revision: 596 Modified: ri/trunk/ ri/trunk/jboss-as/ Log: ignores Property changes on: ri/trunk ___________________________________________________________________ Name: svn:ignore - Web Beans 20080605.pdf + target Property changes on: ri/trunk/jboss-as ___________________________________________________________________ Name: svn:ignore + target

15 years, 6 months

1
0
0 / 0

[webbeans-commits] Webbeans SVN: r595 - in doc/trunk/reference: en and 1 other directories.

by webbeans-commits＠lists.jboss.org

Author: pete.muir(a)jboss.org Date: 2008-12-19 13:33:45 -0500 (Fri, 19 Dec 2008) New Revision: 595 Added: doc/trunk/reference/en/modules/ri.xml Modified: doc/trunk/reference/ doc/trunk/reference/en/master.xml doc/trunk/reference/en/modules/intro.xml Log: Move RI to it's own chapter, update for new location of jboss installer Property changes on: doc/trunk/reference ___________________________________________________________________ Name: svn:ignore - target .project + target .project webbeans_reference.pdf Modified: doc/trunk/reference/en/master.xml =================================================================== --- doc/trunk/reference/en/master.xml 2008-12-19 18:32:52 UTC (rev 594) +++ doc/trunk/reference/en/master.xml 2008-12-19 18:33:45 UTC (rev 595) @@ -36,6 +36,7 @@ <xi:include href="modules/part1.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="modules/intro.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="modules/ri.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="modules/example.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="modules/injection.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="modules/scopescontexts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> Modified: doc/trunk/reference/en/modules/intro.xml =================================================================== --- doc/trunk/reference/en/modules/intro.xml 2008-12-19 18:32:52 UTC (rev 594) +++ doc/trunk/reference/en/modules/intro.xml 2008-12-19 18:33:45 UTC (rev 595) @@ -535,134 +535,4 @@ </section> -<section> - <title>Using the Web Beans Reference Implementation</title> - - <para> - The Web Beans RI comes with a two examples, - <literal>webbeans-numberguess</literal> (a war example, containing only - simple beans) and <literal>webbeans-translator</literal> (an ear example, - containing enterprise beans). - </para> - - <para> - Currently, the Web Beans RI only runs on JBoss Application Server 5. - You'll need to download JBoss AS 5.0.0.GA from - <ulink url="http://www.jboss.org/jbossas/downloads/">jboss.org</ulink>, - and unzip it. For example: - </para> - - <programlisting><![CDATA[$ cd /Applications -$ unzip ~/jboss-5.0.0.GA.zip]]></programlisting> - - <para> - Next, download the Web Beans RI from - <ulink url="http://seamframework.org/WebBeans">seamframework.org</ulink>, - and unzip it. For example - </para> - - <programlisting><![CDATA[$ cd ~/ -$ unzip ~/webbeans-1.0.0.ALPHA1.zip]]></programlisting> - - <para> - As Web Beans is a new piece of software, you need to update JBoss AS to - run the Web Beans RI. Future versions of JBoss AS will include these - updates, and this step won't be necessary. - </para> - - <note> - <para> - Currently, two updates are needed. Firstly, a new deployer, - <literal>webbeans.deployer</literal> is added. This adds supports for - Web Bean archives to JBoss AS, and allows the Web Beans RI to query the - EJB3 container and discover which EJBs are installed in your - application. Secondly, an update to JBoss EJB3 is needed. - </para> - </note> - - <para> - To install the update, you'll need ant 1.7.0 installed, and the - <literal>ANT_HOME</literal> environment variable set. For example: - </para> - - <programlisting>$ unzip apache-ant-1.7.0.zip -$ export ANT_HOME=~/apache-ant-1.7.0</programlisting> - - <para> - Then, you can install the update. The update script will use Maven to - download the Web Beans and EJB3 automatically. - </para> - - <programlisting>$ cd webbeans-1.0.0.ALPHA1 -$ ant install-jboss5-update</programlisting> - - <para> - Now, you're ready to deploy your first example! - </para> - - <note> - <para> - The build scripts for the examples offer a number of targets, these - are: - </para> - <itemizedlist> - <listitem> - <para> - <literal>ant restart</literal> - deploy the example in exploded - format - </para> - </listitem> - <listitem> - <para> - <literal>ant explode</literal> - update an exploded example, without - restarting the deployment - </para> - </listitem> - <listitem> - <para> - <literal>ant deploy</literal> - deploy the example in compressed jar format - </para> - </listitem> - <listitem> - <para> - <literal>ant undeploy</literal> - remove the example from the server - </para> - </listitem> - <listitem> - <para> - <literal>ant clean</literal> - clean the example - </para> - </listitem> - </itemizedlist> - </note> - - <para> - To deploy the numberguess example: - </para> - - <programlisting>$ cd examples/numberguess -ant deploy</programlisting> - - <para> - Wait for the application to deploy, and enjoy hours of fun at - <ulink url="http://localhost:8080/webbeans-numberguess" />! - </para> - - <para> - The Web Beans RI includes a second simple example that will translate your text - into Latin. The numberguess example is a war example, and uses only simple - beans; the translator example is an ear example, and includes enterprise - beans, packaged in an EJB module. To try it out: - </para> - - <programlisting>$ cd examples/traslator -ant deploy</programlisting> - - <para> - Wait for the application to deploy, and visit - <ulink url="http://localhost:8080/webbeans-translator" />! - </para> - -</section> - </chapter> \ No newline at end of file Added: doc/trunk/reference/en/modules/ri.xml =================================================================== --- doc/trunk/reference/en/modules/ri.xml (rev 0) +++ doc/trunk/reference/en/modules/ri.xml 2008-12-19 18:33:45 UTC (rev 595) @@ -0,0 +1,131 @@ +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ ]> + +<chapter id="ri"> + <title>Using the Web Beans Reference Implementation</title> + + <para> + The Web Beans RI comes with a two examples, + <literal>webbeans-numberguess</literal> (a war example, containing only + simple beans) and <literal>webbeans-translator</literal> (an ear example, + containing enterprise beans). + </para> + + <para> + Currently, the Web Beans RI only runs on JBoss Application Server 5. + You'll need to download JBoss AS 5.0.0.GA from + <ulink url="http://www.jboss.org/jbossas/downloads/">jboss.org</ulink>, + and unzip it. For example: + </para> + + <programlisting><![CDATA[$ cd /Applications +$ unzip ~/jboss-5.0.0.GA.zip]]></programlisting> + + <para> + Next, download the Web Beans RI from + <ulink url="http://seamframework.org/WebBeans">seamframework.org</ulink>, + and unzip it. For example + </para> + + <programlisting><![CDATA[$ cd ~/ +$ unzip ~/webbeans-1.0.0.ALPHA1.zip]]></programlisting> + + <para> + As Web Beans is a new piece of software, you need to update JBoss AS to + run the Web Beans RI. Future versions of JBoss AS will include these + updates, and this step won't be necessary. + </para> + + <note> + <para> + Currently, two updates are needed. Firstly, a new deployer, + <literal>webbeans.deployer</literal> is added. This adds supports for + Web Bean archives to JBoss AS, and allows the Web Beans RI to query the + EJB3 container and discover which EJBs are installed in your + application. Secondly, an update to JBoss EJB3 is needed. + </para> + </note> + + <para> + To install the update, you'll need ant 1.7.0 installed, and the + <literal>ANT_HOME</literal> environment variable set. For example: + </para> + + <programlisting>$ unzip apache-ant-1.7.0.zip +$ export ANT_HOME=~/apache-ant-1.7.0</programlisting> + + <para> + Then, you can install the update. The update script will use Maven to + download the Web Beans and EJB3 automatically. + </para> + + <programlisting>$ cd webbeans-1.0.0.ALPHA1/jboss-as +$ ant update</programlisting> + + <para> + Now, you're ready to deploy your first example! + </para> + + <note> + <para> + The build scripts for the examples offer a number of targets, these + are: + </para> + <itemizedlist> + <listitem> + <para> + <literal>ant restart</literal> - deploy the example in exploded + format + </para> + </listitem> + <listitem> + <para> + <literal>ant explode</literal> - update an exploded example, without + restarting the deployment + </para> + </listitem> + <listitem> + <para> + <literal>ant deploy</literal> - deploy the example in compressed jar format + </para> + </listitem> + <listitem> + <para> + <literal>ant undeploy</literal> - remove the example from the server + </para> + </listitem> + <listitem> + <para> + <literal>ant clean</literal> - clean the example + </para> + </listitem> + </itemizedlist> + </note> + + <para> + To deploy the numberguess example: + </para> + + <programlisting>$ cd examples/numberguess +ant deploy</programlisting> + + <para> + Wait for the application to deploy, and enjoy hours of fun at + <ulink url="http://localhost:8080/webbeans-numberguess" />! + </para> + + <para> + The Web Beans RI includes a second simple example that will translate your text + into Latin. The numberguess example is a war example, and uses only simple + beans; the translator example is an ear example, and includes enterprise + beans, packaged in an EJB module. To try it out: + </para> + + <programlisting>$ cd examples/traslator +ant deploy</programlisting> + + <para> + Wait for the application to deploy, and visit + <ulink url="http://localhost:8080/webbeans-translator" />! + </para> + +</chapter> \ No newline at end of file Property changes on: doc/trunk/reference/en/modules/ri.xml ___________________________________________________________________ Name: svn:mime-type + text/plain

15 years, 6 months

1
0
0 / 0

← Newer
1
...
12
13
14
15
16
17
18
...
37
Older →

Jump to page:

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

weld-commits December 2008