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

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&gt; #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&gt;(a)Decorator&lt;/literal&gt;.&quot; +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>&lt;Interceptors&gt;</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 WARs&#151;any 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&gt;(a)Observes&lt;/literal&gt;.&quot; +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 bindings&#151;in 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&lt;T&gt; {\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&lt;Class&gt; getTypes();\n" +" public abstract Set&lt;Annotation&gt; getBindingTypes();\n" +" public abstract Class&lt;? extends Annotation&gt; getScopeType();\n" +" public abstract Class&lt;? extends Annotation&gt; 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&lt;? extends Annotation&gt; getScopeType();\n" +" \n" +" public &lt;T&gt; T get(Bean&lt;T&gt; 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&gt;(a)NonBinding&lt;/literal&gt;.&quot; +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&gt;(a)Production&lt;/literal&gt;.&quot; +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&#151;<literal>ExternalPaymentProcessor</" +"literal> or <literal>MockPaymentProcessor</literal>&#151;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 point&#151;or 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 " +&quot;&lt;literal&gt;(a)Dependent&lt;/literal&gt;.&quot; +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>&#151;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 " +&quot;&lt;literal&gt;(a)PersistenceContext(type=EXTENDED)&lt;/literal&gt;.&quot; +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 objects&#151;Web Beans with scope " +"<literal>@Dependent</literal>&#151;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 " +&quot;&lt;literal&gt;(a)NonBinding.&lt;/literal&gt;)&quot; +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&gt;(a)Transactional&lt;/literal&gt;.&quot; +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 transitive&#151;any 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 "" +&quot;&lt;![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-global&#151;it 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 Beans&#151;injecting them " +"into other Web Beans, configuring them via the Web Beans XML configuration " +"facility, even adding interceptors and decorators to them&#151;without " +"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&gt;(a)Initializer&lt;/literal&gt;.&quot; +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> " +"available&#151;if the <literal>SentenceTranslator</literal> EJB was not " +"deployed&#151;the 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 Beans&#151;which are by nature not injectable, " +"contextual objects&#151;may 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>&#151;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" +&quot;(a)Interceptors(TransactionInterceptor.class)\n&quot; +"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 " +&quot;&lt;literal&gt;(a)Initializer&lt;/literal&gt;.&quot; +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 " +"Beans&#151;since they are not intended to be injected into other " +"objects&#151;but 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&gt;(a)Singleton&lt;/literal&gt;.&quot; +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 rules&#151;so-" +"called \"configuration by convention\"&#151;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&gt;(a)RequestScoped&lt;/literal&gt;.&quot; +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" +" <!-- JSF -->\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 " +"timeout&#151;though 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&gt;(a)Specializes&lt;/literal&gt;.&quot; +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 " +&quot;&lt;literal&gt;(a)Specializes&lt;/literal&gt;.&quot; +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" +&quot;(a)Stereotype(supportedScopes=RequestScoped.class)\n&quot; +"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" +&quot;(a)Stereotype(requiredTypes=AbstractAction.class)\n&quot; +"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>&lt;util:Date/&gt;</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@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>&lt;Name&gt;</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&gt;(a)Decorator&lt;/literal&gt;.&quot; +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>&lt;Interceptors&gt;</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 WARs&#151;any 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&gt;(a)Observes&lt;/literal&gt;.&quot; +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 bindings&#151;in 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&lt;T&gt; {\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&lt;Class&gt; getTypes();\n" +" public abstract Set&lt;Annotation&gt; getBindingTypes();\n" +" public abstract Class&lt;? extends Annotation&gt; getScopeType();\n" +" public abstract Class&lt;? extends Annotation&gt; 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&lt;? extends Annotation&gt; getScopeType();\n" +" \n" +" public &lt;T&gt; T get(Bean&lt;T&gt; 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&gt;(a)NonBinding&lt;/literal&gt;.&quot; +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&gt;(a)Production&lt;/literal&gt;.&quot; +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&#151;<literal>ExternalPaymentProcessor</" +"literal> or <literal>MockPaymentProcessor</literal>&#151;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 point&#151;or 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 " +&quot;&lt;literal&gt;(a)Dependent&lt;/literal&gt;.&quot; +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>&#151;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 " +&quot;&lt;literal&gt;(a)PersistenceContext(type=EXTENDED)&lt;/literal&gt;.&quot; +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 objects&#151;Web Beans with scope " +"<literal>@Dependent</literal>&#151;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 " +&quot;&lt;literal&gt;(a)NonBinding.&lt;/literal&gt;)&quot; +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&gt;(a)Transactional&lt;/literal&gt;.&quot; +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 transitive&#151;any 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 "" +&quot;&lt;![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-global&#151;it 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 Beans&#151;injecting them " +"into other Web Beans, configuring them via the Web Beans XML configuration " +"facility, even adding interceptors and decorators to them&#151;without " +"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&gt;(a)Initializer&lt;/literal&gt;.&quot; +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> " +"available&#151;if the <literal>SentenceTranslator</literal> EJB was not " +"deployed&#151;the 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 Beans&#151;which are by nature not injectable, " +"contextual objects&#151;may 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>&#151;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" +&quot;(a)Interceptors(TransactionInterceptor.class)\n&quot; +"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 " +&quot;&lt;literal&gt;(a)Initializer&lt;/literal&gt;.&quot; +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 " +"Beans&#151;since they are not intended to be injected into other " +"objects&#151;but 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&gt;(a)Singleton&lt;/literal&gt;.&quot; +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 rules&#151;so-" +"called \"configuration by convention\"&#151;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&gt;(a)RequestScoped&lt;/literal&gt;.&quot; +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" +" <!-- JSF -->\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 " +"timeout&#151;though 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&gt;(a)Specializes&lt;/literal&gt;.&quot; +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 " +&quot;&lt;literal&gt;(a)Specializes&lt;/literal&gt;.&quot; +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" +&quot;(a)Stereotype(supportedScopes=RequestScoped.class)\n&quot; +"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" +&quot;(a)Stereotype(requiredTypes=AbstractAction.class)\n&quot; +"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>&lt;util:Date/&gt;</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@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>&lt;Name&gt;</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&gt;(a)Decorator&lt;/literal&gt;.&quot; +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>&lt;Interceptors&gt;</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 WARs&#151;any 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&gt;(a)Observes&lt;/literal&gt;.&quot; +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 bindings&#151;in 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&lt;T&gt; {\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&lt;Class&gt; getTypes();\n" +" public abstract Set&lt;Annotation&gt; getBindingTypes();\n" +" public abstract Class&lt;? extends Annotation&gt; getScopeType();\n" +" public abstract Class&lt;? extends Annotation&gt; 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&lt;? extends Annotation&gt; getScopeType();\n" +" \n" +" public &lt;T&gt; T get(Bean&lt;T&gt; 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&gt;(a)NonBinding&lt;/literal&gt;.&quot; +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&gt;(a)Production&lt;/literal&gt;.&quot; +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&#151;<literal>ExternalPaymentProcessor</" +"literal> or <literal>MockPaymentProcessor</literal>&#151;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 point&#151;or 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 " +&quot;&lt;literal&gt;(a)Dependent&lt;/literal&gt;.&quot; +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>&#151;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 " +&quot;&lt;literal&gt;(a)PersistenceContext(type=EXTENDED)&lt;/literal&gt;.&quot; +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 objects&#151;Web Beans with scope " +"<literal>@Dependent</literal>&#151;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 " +&quot;&lt;literal&gt;(a)NonBinding.&lt;/literal&gt;)&quot; +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&gt;(a)Transactional&lt;/literal&gt;.&quot; +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 transitive&#151;any 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 "" +&quot;&lt;![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-global&#151;it 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 Beans&#151;injecting them " +"into other Web Beans, configuring them via the Web Beans XML configuration " +"facility, even adding interceptors and decorators to them&#151;without " +"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&gt;(a)Initializer&lt;/literal&gt;.&quot; +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> " +"available&#151;if the <literal>SentenceTranslator</literal> EJB was not " +"deployed&#151;the 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 Beans&#151;which are by nature not injectable, " +"contextual objects&#151;may 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>&#151;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" +&quot;(a)Interceptors(TransactionInterceptor.class)\n&quot; +"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 " +&quot;&lt;literal&gt;(a)Initializer&lt;/literal&gt;.&quot; +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 " +"Beans&#151;since they are not intended to be injected into other " +"objects&#151;but 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&gt;(a)Singleton&lt;/literal&gt;.&quot; +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 rules&#151;so-" +"called \"configuration by convention\"&#151;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&gt;(a)RequestScoped&lt;/literal&gt;.&quot; +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" +" <!-- JSF -->\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 " +"timeout&#151;though 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&gt;(a)Specializes&lt;/literal&gt;.&quot; +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 " +&quot;&lt;literal&gt;(a)Specializes&lt;/literal&gt;.&quot; +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" +&quot;(a)Stereotype(supportedScopes=RequestScoped.class)\n&quot; +"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" +&quot;(a)Stereotype(requiredTypes=AbstractAction.class)\n&quot; +"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>&lt;util:Date/&gt;</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@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>&lt;Name&gt;</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&gt;(a)Decorator&lt;/literal&gt;.&quot; +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>&lt;Interceptors&gt;</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 WARs&#151;any 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&gt;(a)Observes&lt;/literal&gt;.&quot; +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 bindings&#151;in 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&lt;T&gt; {\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&lt;Class&gt; getTypes();\n" +" public abstract Set&lt;Annotation&gt; getBindingTypes();\n" +" public abstract Class&lt;? extends Annotation&gt; getScopeType();\n" +" public abstract Class&lt;? extends Annotation&gt; 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&lt;? extends Annotation&gt; getScopeType();\n" +" \n" +" public &lt;T&gt; T get(Bean&lt;T&gt; 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&gt;(a)NonBinding&lt;/literal&gt;.&quot; +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&gt;(a)Production&lt;/literal&gt;.&quot; +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&#151;<literal>ExternalPaymentProcessor</" +"literal> or <literal>MockPaymentProcessor</literal>&#151;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 point&#151;or 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 " +&quot;&lt;literal&gt;(a)Dependent&lt;/literal&gt;.&quot; +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>&#151;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 " +&quot;&lt;literal&gt;(a)PersistenceContext(type=EXTENDED)&lt;/literal&gt;.&quot; +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 objects&#151;Web Beans with scope " +"<literal>@Dependent</literal>&#151;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 " +&quot;&lt;literal&gt;(a)NonBinding.&lt;/literal&gt;)&quot; +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&gt;(a)Transactional&lt;/literal&gt;.&quot; +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 transitive&#151;any 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 "" +&quot;&lt;![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-global&#151;it 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 Beans&#151;injecting them " +"into other Web Beans, configuring them via the Web Beans XML configuration " +"facility, even adding interceptors and decorators to them&#151;without " +"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&gt;(a)Initializer&lt;/literal&gt;.&quot; +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> " +"available&#151;if the <literal>SentenceTranslator</literal> EJB was not " +"deployed&#151;the 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 Beans&#151;which are by nature not injectable, " +"contextual objects&#151;may 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>&#151;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" +&quot;(a)Interceptors(TransactionInterceptor.class)\n&quot; +"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 " +&quot;&lt;literal&gt;(a)Initializer&lt;/literal&gt;.&quot; +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 " +"Beans&#151;since they are not intended to be injected into other " +"objects&#151;but 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&gt;(a)Singleton&lt;/literal&gt;.&quot; +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 rules&#151;so-" +"called \"configuration by convention\"&#151;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&gt;(a)RequestScoped&lt;/literal&gt;.&quot; +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" +" <!-- JSF -->\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 " +"timeout&#151;though 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&gt;(a)Specializes&lt;/literal&gt;.&quot; +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 " +&quot;&lt;literal&gt;(a)Specializes&lt;/literal&gt;.&quot; +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" +&quot;(a)Stereotype(supportedScopes=RequestScoped.class)\n&quot; +"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" +&quot;(a)Stereotype(requiredTypes=AbstractAction.class)\n&quot; +"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>&lt;util:Date/&gt;</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@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>&lt;Name&gt;</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&gt;\n&quot; +"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&gt;\n&quot; +"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&gt;\n&quot; +"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&gt;(a)Decorator&lt;/literal&gt;.&quot; +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>&lt;Interceptors&gt;</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&gt;\n&quot; +"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 WARs&#151;any 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&gt;\n&quot; +"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&gt;(a)Observes&lt;/literal&gt;.&quot; +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 bindings&#151;in 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&gt;\n&quot; +"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&gt;\n&quot; +"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&lt;T&gt; {\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&lt;Class&gt; getTypes();\n" +" public abstract Set&lt;Annotation&gt; getBindingTypes();\n" +" public abstract Class&lt;? extends Annotation&gt; getScopeType();\n" +" public abstract Class&lt;? extends Annotation&gt; 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&lt;? extends Annotation&gt; getScopeType();\n" +" \n" +" public &lt;T&gt; T get(Bean&lt;T&gt; 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&gt;\n&quot; +"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&gt;(a)NonBinding&lt;/literal&gt;.&quot; +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&gt;(a)Production&lt;/literal&gt;.&quot; +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&#151;<literal>ExternalPaymentProcessor</" +"literal> or <literal>MockPaymentProcessor</literal>&#151;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 point&#151;or 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 " +&quot;&lt;literal&gt;(a)Dependent&lt;/literal&gt;.&quot; +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>&#151;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 " +&quot;&lt;literal&gt;(a)PersistenceContext(type=EXTENDED)&lt;/literal&gt;.&quot; +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 objects&#151;Web Beans with scope " +"<literal>@Dependent</literal>&#151;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 " +&quot;&lt;literal&gt;(a)NonBinding.&lt;/literal&gt;)&quot; +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&gt;\n&quot; +"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&gt;(a)Transactional&lt;/literal&gt;.&quot; +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 transitive&#151;any 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 "" +&quot;&lt;![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-global&#151;it 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&gt;\n&quot; +"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 Beans&#151;injecting them " +"into other Web Beans, configuring them via the Web Beans XML configuration " +"facility, even adding interceptors and decorators to them&#151;without " +"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&gt;(a)Initializer&lt;/literal&gt;.&quot; +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> " +"available&#151;if the <literal>SentenceTranslator</literal> EJB was not " +"deployed&#151;the 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 Beans&#151;which are by nature not injectable, " +"contextual objects&#151;may 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>&#151;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" +&quot;(a)Interceptors(TransactionInterceptor.class)\n&quot; +"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 " +&quot;&lt;literal&gt;(a)Initializer&lt;/literal&gt;.&quot; +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 " +"Beans&#151;since they are not intended to be injected into other " +"objects&#151;but 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&gt;(a)Singleton&lt;/literal&gt;.&quot; +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&gt;\n&quot; +"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&gt;\n&quot; +"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&gt;\n&quot; +"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&gt;\n&quot; +"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 rules&#151;so-" +"called \"configuration by convention\"&#151;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&gt;\n&quot; +"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&gt;\n&quot; +"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&gt;(a)RequestScoped&lt;/literal&gt;.&quot; +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&gt;\n&quot; +"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" +" <!-- JSF -->\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&gt;\n&quot; +"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 " +"timeout&#151;though 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&gt;\n&quot; +"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&gt;(a)Specializes&lt;/literal&gt;.&quot; +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 " +&quot;&lt;literal&gt;(a)Specializes&lt;/literal&gt;.&quot; +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&gt;\n&quot; +"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" +&quot;(a)Stereotype(supportedScopes=RequestScoped.class)\n&quot; +"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" +&quot;(a)Stereotype(requiredTypes=AbstractAction.class)\n&quot; +"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&gt;\n&quot; +"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>&lt;util:Date/&gt;</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@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>&lt;Name&gt;</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&gt;(a)Decorator&lt;/literal&gt;.&quot; +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>&lt;Interceptors&gt;</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 WARs&#151;any 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&gt;(a)Observes&lt;/literal&gt;.&quot; +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 bindings&#151;in 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&lt;T&gt; {\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&lt;Class&gt; getTypes();\n" +" public abstract Set&lt;Annotation&gt; getBindingTypes();\n" +" public abstract Class&lt;? extends Annotation&gt; getScopeType();\n" +" public abstract Class&lt;? extends Annotation&gt; 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&lt;? extends Annotation&gt; getScopeType();\n" +" \n" +" public &lt;T&gt; T get(Bean&lt;T&gt; 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&gt;(a)NonBinding&lt;/literal&gt;.&quot; +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&gt;(a)Production&lt;/literal&gt;.&quot; +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&#151;<literal>ExternalPaymentProcessor</" +"literal> or <literal>MockPaymentProcessor</literal>&#151;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 point&#151;or 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 " +&quot;&lt;literal&gt;(a)Dependent&lt;/literal&gt;.&quot; +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>&#151;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 " +&quot;&lt;literal&gt;(a)PersistenceContext(type=EXTENDED)&lt;/literal&gt;.&quot; +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 objects&#151;Web Beans with scope " +"<literal>@Dependent</literal>&#151;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 " +&quot;&lt;literal&gt;(a)NonBinding.&lt;/literal&gt;)&quot; +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&gt;(a)Transactional&lt;/literal&gt;.&quot; +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 transitive&#151;any 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 "" +&quot;&lt;![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-global&#151;it 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 Beans&#151;injecting them " +"into other Web Beans, configuring them via the Web Beans XML configuration " +"facility, even adding interceptors and decorators to them&#151;without " +"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&gt;(a)Initializer&lt;/literal&gt;.&quot; +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> " +"available&#151;if the <literal>SentenceTranslator</literal> EJB was not " +"deployed&#151;the 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 Beans&#151;which are by nature not injectable, " +"contextual objects&#151;may 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>&#151;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" +&quot;(a)Interceptors(TransactionInterceptor.class)\n&quot; +"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 " +&quot;&lt;literal&gt;(a)Initializer&lt;/literal&gt;.&quot; +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 " +"Beans&#151;since they are not intended to be injected into other " +"objects&#151;but 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&gt;(a)Singleton&lt;/literal&gt;.&quot; +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 rules&#151;so-" +"called \"configuration by convention\"&#151;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&gt;(a)RequestScoped&lt;/literal&gt;.&quot; +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" +" <!-- JSF -->\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 " +"timeout&#151;though 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&gt;(a)Specializes&lt;/literal&gt;.&quot; +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 " +&quot;&lt;literal&gt;(a)Specializes&lt;/literal&gt;.&quot; +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" +&quot;(a)Stereotype(supportedScopes=RequestScoped.class)\n&quot; +"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" +&quot;(a)Stereotype(requiredTypes=AbstractAction.class)\n&quot; +"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>&lt;util:Date/&gt;</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@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>&lt;Name&gt;</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 ""