[webbeans-commits] Webbeans SVN: r1403 - doc/trunk/reference/zh-CN.

Author: alartin Date: 2009-02-03 23:10:08 -0500 (Tue, 03 Feb 2009) New Revision: 1403 Modified: doc/trunk/reference/zh-CN/intro.po doc/trunk/reference/zh-CN/ri-spi.po doc/trunk/reference/zh-CN/ri.po Log: Modified: doc/trunk/reference/zh-CN/intro.po =================================================================== --- doc/trunk/reference/zh-CN/intro.po 2009-02-04 04:09:41 UTC (rev 1402) +++ doc/trunk/reference/zh-CN/intro.po 2009-02-04 04:10:08 UTC (rev 1403) @@ -6,7 +6,7 @@ "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-23 16:43+0800\n" +"PO-Revision-Date: 2009-02-03 15:24+0800\n" "Last-Translator: Sean Wu <alartin(a)gmail.com&gt;\n&quot; "Language-Team: none\n" "MIME-Version: 1.0\n" @@ -34,7 +34,7 @@ #. 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." +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 "除非特殊情况，每个具有一个非参构造器的Java类都可以是一个Web Bean。这包括了每个JavaBean, 并且每个EJB3的会话Bean都是一个Web Bean。当然，你每天已经写过的JavaBean和EJB无法使用Web Beans规范定义的新服务，但是你能够通过Web Beans的XML配置将这些组件配置为Web Bean，然后将其注入到其他Web Bean中。你甚至可以不用修改已有代码就可以为其添加拦截器和装饰器。" #. Tag: para @@ -194,8 +194,8 @@ #. 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 "在系统初始化的时候，Web Bean管理器必须验证只存在一个Web Bean能够满足每个注入点。在我们的例子中，如果没有<literal>Translator</literal>实现 &#151; 如果<literal>SentenceTranslator</literal> EJB没有被部署 &#151; Web Bean管理器将会抛出一个<literal>UnsatisfiedDependencyException</literal>异常。如果多于一个<literal>Translator</literal>实现，Web Bean管理器将会抛出一个<literal>AmbiguousDependencyException</literal>异常。" +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 "在系统初始化的时候，Web Bean管理器必须验证只存在一个Web Bean能够满足每个注入点。在我们的例子中，如果没有<literal>Translator</literal>实现&#151;如果<literal>SentenceTranslator</literal> EJB没有被部署&#151;Web Bean管理器将会抛出一个<literal>UnsatisfiedDependencyException</literal>异常。如果多于一个<literal>Translator</literal>实现，Web Bean管理器将会抛出一个<literal>AmbiguousDependencyException</literal>异常。" #. Tag: title #: intro.xml:80 @@ -278,8 +278,8 @@ #. 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 "需要注意的是并非所有的Web Bean的客户端都是Web Bean。其他对象诸如Servlet或者消息驱动Bean#151;天生不可注入的, 具备上下文的对象 &#151; 也可以通过注入获得Web Bean的引用。" +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 "需要注意的是并非所有的Web Bean的客户端都是Web Bean。其他对象诸如Servlet或者消息驱动Bean#151;天生不可注入的, 具备上下文的对象&#151;也可以通过注入获得Web Bean的引用。" #. Tag: para #: intro.xml:149 @@ -584,8 +584,8 @@ #. 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 "在这种情况下，Web Bean的名字默认为<literal>shoppingCart</literal> &#151; 非完整的类名，首字母改为小写" +msgid "In this case, the name defaults to <literal>shoppingCart</literal>&#151;the unqualified class name, with the first character changed to lowercase." +msgstr "在这种情况下，Web Bean的名字默认为<literal>shoppingCart</literal>&#151;非完整的类名，首字母改为小写" #. Tag: title #: intro.xml:295 @@ -673,7 +673,7 @@ #: intro.xml:338 #, no-c-format msgid "it is not a non-static static inner class," -msgstr "她不是一个非静态的静态内嵌类，" +msgstr "它不是一个非静态的静态内嵌类，" #. Tag: para #: intro.xml:341 @@ -708,8 +708,8 @@ #. 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 "规范指出所有EJB3类型的会话Bean或者单例Bean都是<emphasis>企业级</emphasis>Web Bean。消息驱动Bean不是Web Beans &#151; 因为它们不能被注入到其他对象中#151;但是它们可以使用大部分Web Bean的功能，包括依赖注入和拦截器。" +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 "规范指出所有EJB3类型的会话Bean或者单例Bean都是<emphasis>企业级</emphasis>Web Bean。消息驱动Bean不是Web Beans&#151;因为它们不能被注入到其他对象中#151;但是它们可以使用大部分Web Bean的功能，包括依赖注入和拦截器。" #. Tag: para #: intro.xml:366 Modified: doc/trunk/reference/zh-CN/ri-spi.po =================================================================== --- doc/trunk/reference/zh-CN/ri-spi.po 2009-02-04 04:09:41 UTC (rev 1402) +++ doc/trunk/reference/zh-CN/ri-spi.po 2009-02-04 04:10:08 UTC (rev 1403) @@ -3,11 +3,11 @@ # msgid "" msgstr "" -"Project-Id-Version: master.xml \n" +"Project-Id-Version: master.xml\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-02-01 21:16+0000\n" -"PO-Revision-Date: 2008-12-20 22:07+0000\n" -"Last-Translator: Automatically generated\n" +"POT-Creation-Date: 2008-12-20 22:07+0000\n" +"PO-Revision-Date: 2008-12-23 18:18+0800\n" +"Last-Translator: Sean Wu <alartin(a)gmail.com&gt;\n&quot; "Language-Team: none\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -17,77 +17,45 @@ #: ri-spi.xml:4 #, no-c-format msgid "Integrating the Web Beans RI into other environments" -msgstr "" +msgstr "将Web Bean参考实现整合到其他环境中" #. Tag: para #: ri-spi.xml:6 #, no-c-format -msgid "" -"Currently the Web Beans RI only runs in JBoss AS 5; integrating the RI into " -"other EE environments (for example another application server like " -"Glassfish), into a servlet container (like Tomcat), or with an Embedded " -"EJB3.1 implementation is fairly easy. In this Appendix we will briefly " -"discuss the steps needed." -msgstr "" +msgid "Currently the Web Beans RI only runs in JBoss AS 5; integrating the RI into other EE environments (for example another application server like Glassfish), into a servlet container (like Tomcat), or with an Embedded EJB3.1 implementation is fairly easy. In this Appendix we will briefly discuss the steps needed." +msgstr "目前，Web Bean的参考实现只能运行在JBoss AS5中；将参考实现整合到其他EE环境中（例如像Glassfish的其他的应用服务器）以及一个Servlet容器（像Tomcat）中或者一个内嵌的EJB3.1实现中相当容易。在附录中我们将简要的讨论所需的步骤。" #. Tag: para #: ri-spi.xml:15 #, no-c-format -msgid "" -"It should be possible to run Web Beans in an SE environment, but you'll to " -"do more work, adding your own contexts and lifecycle. The Web Beans RI " -"currently doesn't expose lifecycle extension points, so you would have to " -"code directly against Web Beans RI classes." -msgstr "" +msgid "It should be possible to run Web Beans in an SE environment, but you'll to do more work, adding your own contexts and lifecycle. The Web Beans RI currently doesn't expose lifecycle extension points, so you would have to code directly against Web Beans RI classes." +msgstr "Web Bean可以在SE环境中运行，但是你需要做更多的工作，添加你自己的上下文和生命周期。Web Bean参考实现目前没有暴露生命周期扩展点，所以你不得不直接编写Web Bean参考实现的类。" #. Tag: title #: ri-spi.xml:24 #, no-c-format msgid "The Web Beans RI SPI" -msgstr "" +msgstr "Web Bean的参考实现SPI" #. Tag: para #: ri-spi.xml:26 #, no-c-format -msgid "" -"The Web Beans SPI is located in <literal>webbeans-ri-spi</literal> module, " -"and packaged as <literal>webbeans-ri-spi.jar</literal>. Some SPIs are " -"optional, if you need to override the default behavior, others are required." -msgstr "" +msgid "The Web Beans SPI is located in <literal>webbeans-ri-spi</literal> module, and packaged as <literal>webbeans-ri-spi.jar</literal>." +msgstr "Web Bean的SPI位于<literal>webbeans-ri-spi</literal>模块中，打包为<literal>webbeans-ri-spi.jar</literal>。" #. Tag: para -#: ri-spi.xml:33 +#: ri-spi.xml:31 #, no-c-format -msgid "" -"You can specify the implementation of an SPI either as a system property, or " -"in a properties file <literal>META-INF/web-beans-ri.properties</literal>. " -"All property names are the fully qualified class name of the implemented " -"interface; all property values are the fully qualified class name of the " -"implementation class." -msgstr "" +msgid "Currently, the only SPI to implement is the bootstrap spi:" +msgstr "目前，只有bootstrap SPI可以实现：" -#. Tag: para -#: ri-spi.xml:42 -#, no-c-format -msgid "" -"All interfaces in the SPI support the decorator pattern and provide a " -"<literal>Forwarding</literal> class." -msgstr "" - -#. Tag: title -#: ri-spi.xml:48 -#, no-c-format -msgid "Web Bean Discovery" -msgstr "" - #. Tag: programlisting -#: ri-spi.xml:50 +#: ri-spi.xml:35 #, no-c-format msgid "" "<![CDATA[public interface WebBeanDiscovery {\n" " /**\n" -" * Gets list of all classes in classpath archives with web-beans.xml " -"files\n" +" * Gets list of all classes in classpath archives with web-beans.xml files\n" " * \n" " * @return An iterable over the classes \n" " */\n" @@ -100,84 +68,31 @@ " */\n" " public Iterable<URL> discoverWebBeansXml();\n" " \n" +" /**\n" +" * Gets a descriptor for each EJB in the application\n" +" * \n" +" * @return The bean class to descriptor map \n" +" */\n" +" public Iterable<EjbDescriptor<?>> discoverEjbs();\n" +" \n" "}]]>" msgstr "" - -#. Tag: para -#: ri-spi.xml:52 -#, no-c-format -msgid "" -"The discovery of Web Bean classes and <literal>web-bean.xml</literal> files " -"is self-explanatory (the algorithm is described in Section 11.1 of the JSR-" -"299 specification, and isn't repeated here)." -msgstr "" - -#. Tag: para -#: ri-spi.xml:58 -#, no-c-format -msgid "" -"The Web Beans RI can be told to load your implementation of " -"<literal>WebBeanDiscovery</literal> using the property <literal>org.jboss." -"webbeans.bootstrap.spi.WebBeanDiscovery</literal> with the fully qualified " -"class name as the value. For example:" -msgstr "" - -#. Tag: programlisting -#: ri-spi.xml:65 -#, no-c-format -msgid "" -"org.jboss.webbeans.bootstrap.spi.WebBeanDiscovery= \\ \n" -" org.jboss.webbeans.integration.jbossas.WebBeanDiscoveryImpl" -msgstr "" - -#. Tag: para -#: ri-spi.xml:67 ri-spi.xml:113 ri-spi.xml:146 ri-spi.xml:179 -#, no-c-format -msgid "" -"If the Web Beans RI is being used in a servlet container, it expects a " -"constructor of the form:" -msgstr "" - -#. Tag: programlisting -#: ri-spi.xml:72 -#, no-c-format -msgid "" -"<![CDATA[public WebBeanDiscoveryImpl(ServletContext servletContext) {}]]>" -msgstr "" - -#. Tag: para -#: ri-spi.xml:74 -#, no-c-format -msgid "" -"The servlet context can be used to allow your implementation of " -"<literal>WebBeanDiscovery</literal> to interact with the container." -msgstr "" - -#. Tag: title -#: ri-spi.xml:82 -#, no-c-format -msgid "EJB Discovery" -msgstr "" - -#. Tag: para -#: ri-spi.xml:84 -#, no-c-format -msgid "" -"The Web Beans RI also delegates EJB3 bean discovery to the container so that " -"it doesn't have to scan for EJB3 annotations or parse <literal>ejb-jar.xml</" -"literal>. For each EJB in the application an EJBDescriptor should be " -"discovered:" -msgstr "" - -#. Tag: programlisting -#: ri-spi.xml:91 -#, no-c-format -msgid "" -"<![CDATA[public interface EjbDiscovery\n" -"{\n" -" public static final String PROPERTY_NAME = EjbDiscovery.class.getName();\n" +"<![CDATA[public interface WebBeanDiscovery {\n" +" /**\n" +" * Gets list of all classes in classpath archives with web-beans.xml files\n" +" * \n" +" * @return An iterable over the classes \n" +" */\n" +" public Iterable<Class<?>> discoverWebBeanClasses();\n" " \n" " /**\n" +" * Gets a list of all web-beans.xml files in the app classpath\n" +" * \n" +" * @return An iterable over the web-beans.xml files \n" +" */\n" +" public Iterable<URL> discoverWebBeansXml();\n" +" \n" +" /**\n" " * Gets a descriptor for each EJB in the application\n" " * \n" " * @return The bean class to descriptor map \n" @@ -185,10 +100,21 @@ " public Iterable<EjbDescriptor<?>> discoverEjbs();\n" " \n" "}]]>" + +#. Tag: para +#: ri-spi.xml:37 +#, no-c-format +msgid "The discovery of Web Bean classes and <literal>web-bean.xml</literal> files is self-explanatory (the algorithm is described in Section 11.1 of the JSR-299 specification, and isn't repeated here)." msgstr "" +#. Tag: para +#: ri-spi.xml:43 +#, no-c-format +msgid "The Web Beans RI also delegates EJB3 bean discovery to the container so that it doesn't have to scan for EJB3 annotations or parse <literal>ejb-jar.xml</literal>. For each EJB in the application an EJBDescriptor should be discovered:" +msgstr "" + #. Tag: programlisting -#: ri-spi.xml:93 +#: ri-spi.xml:50 #, no-c-format msgid "" "<![CDATA[public interface EjbDescriptor<T> {\n" @@ -205,23 +131,21 @@ " * \n" " * @return An iterator over the local business interfaces\n" " */\n" -" public Iterable<BusinessInterfaceDescriptor<?>> getLocalBusinessInterfaces" -"();\n" +" public Iterable<BusinessInterfaceDescriptor<?>> getLocalBusinessInterfaces();\n" " \n" " /**\n" " * Gets the remote business interfaces of the EJB\n" " * \n" " * @return An iterator over the remote business interfaces\n" " */\n" -" public Iterable<BusinessInterfaceDescriptor<?>> " -"getRemoteBusinessInterfaces();\n" +" public Iterable<BusinessInterfaceDescriptor<?>> getRemoteBusinessInterfaces();\n" " \n" " /**\n" " * Get the remove methods of the EJB\n" " * \n" " * @return An iterator over the remove methods\n" " */\n" -" public Iterable<Method> getRemoveMethods();\n" +" public Iterable<MethodDescriptor> getRemoveMethods();\n" "\n" " /**\n" " * Indicates if the bean is stateless\n" @@ -258,270 +182,73 @@ " */\n" " public String getEjbName();\n" " \n" -" \n" -"}]]>" -msgstr "" - -#. Tag: para -#: ri-spi.xml:95 -#, no-c-format -msgid "" -"The <literal>EjbDescriptor</literal> is fairly self-explanatory, and should " -"return the relevant metadata as defined in the EJB specification. In " -"addition to these two interfaces, there is " -"<literal>BusinessInterfaceDescriptor</literal> which represents a local " -"business interface (encapsulating the interface class and jndi name used to " -"look up an instance of the EJB)." -msgstr "" - -#. Tag: para -#: ri-spi.xml:104 -#, no-c-format -msgid "" -"The Web Beans RI can be told to load your implementation of " -"<literal>EjbDiscovery</literal> using the property <literal>org.jboss." -"webbeans.bootstrap.spi.EjbDiscovery</literal> with the fully qualified class " -"name as the value. For example:" -msgstr "" - -#. Tag: programlisting -#: ri-spi.xml:111 -#, no-c-format -msgid "" -"org.jboss.webbeans.bootstrap.spi.EjbDiscovery= \\\n" -" org.jboss.webbeans.integration.jbossas.EjbDiscoveryImpl" -msgstr "" - -#. Tag: programlisting -#: ri-spi.xml:118 -#, no-c-format -msgid "<![CDATA[public EjbDiscoveryImpl(ServletContext servletContext) {}]]>" -msgstr "" - -#. Tag: para -#: ri-spi.xml:120 -#, no-c-format -msgid "" -"The servlet context can be used to allow your implementation of " -"<literal>EjbDiscovery</literal> to interact with the container." -msgstr "" - -#. Tag: title -#: ri-spi.xml:128 -#, no-c-format -msgid "JNDI" -msgstr "" - -#. Tag: para -#: ri-spi.xml:130 -#, no-c-format -msgid "" -"The Web Beans RI implements JNDI binding and lookup according to standards, " -"however you may want to alter the binding and lookup (for example in an " -"environment where JNDI isn't available). To do this, implement <literal>org." -"jboss.webbeans.spi.resources.NamingContext</literal>:" -msgstr "" - -#. Tag: programlisting -#: ri-spi.xml:138 -#, no-c-format -msgid "" -"<![CDATA[public interface NamingContext extends Serializable {\n" -" \n" " /**\n" -" * Typed JNDI lookup\n" +" * @return The JNDI string which can be used to lookup a proxy which \n" +" * implements all local business interfaces \n" " * \n" -" * @param <T> The type\n" -" * @param name The JNDI name\n" -" * @param expectedType The expected type\n" -" * @return The object\n" " */\n" -" public <T> T lookup(String name, Class<? extends T> expectedType);\n" -"\n" -" /**\n" -" * Binds an item to JNDI\n" -" * \n" -" * @param name The key to bind under\n" -" * @param value The item to bind\n" -" */\n" -" public void bind(String name, Object value);\n" +" public String getLocalJndiName();\n" " \n" "}]]>" msgstr "" #. Tag: para -#: ri-spi.xml:140 ri-spi.xml:173 +#: ri-spi.xml:52 #, no-c-format -msgid "and tell the RI to use it:" +msgid "The contract described the JavaDoc is enough to implement an EJBDescriptor. In addition to these two interfaces, there is <literal>BusinessInterfaceDescriptor</literal> which represents a local business interface (encapsulating the interface class and jndi name), and <literal>MethodDescriptor</literal> which encapsulates the method name and parameter types (allowing it to be invoked on any instance of the EJB, proxy or otherwise)." msgstr "" -#. Tag: programlisting -#: ri-spi.xml:144 -#, no-c-format -msgid "org.jboss.webbeans.resources.spi.NamingContext=com.acme.MyNamingContext" -msgstr "" - -#. Tag: programlisting -#: ri-spi.xml:151 -#, no-c-format -msgid "<![CDATA[public MyNamingContext(ServletContext servletContext) {}]]>" -msgstr "" - #. Tag: para -#: ri-spi.xml:153 +#: ri-spi.xml:62 #, no-c-format -msgid "" -"The servlet context can be used to allow your implementation of " -"<literal>NamingContext</literal> to interact with the container." +msgid "The Web Beans RI can be told to load your implementation of <literal>WebBeanDiscovery</literal> using the property <literal>org.jboss.webbeans.bootstrap.webBeanDiscovery</literal> with the fully qualified class name as the value. For example:" msgstr "" -#. Tag: title -#: ri-spi.xml:161 -#, no-c-format -msgid "Resource loading" -msgstr "" - -#. Tag: para -#: ri-spi.xml:163 -#, no-c-format -msgid "" -"The Web Beans RI needs to load classes and resources from the classpath at " -"various times. By default, they are loaded from the same classloader that " -"was used to load the RI, however this may not be correct for some " -"environments. If this is case, you can implement <literal>org.jboss.webbeans." -"spi.ResourceLoader</literal>:" -msgstr "" - #. Tag: programlisting -#: ri-spi.xml:171 +#: ri-spi.xml:69 #, no-c-format -msgid "" -"<![CDATA[\n" -" public interface ResourceLoader {\n" -" \n" -" /**\n" -" * Creates a class from a given FQCN\n" -" * \n" -" * @param name The name of the clsas\n" -" * @return The class\n" -" */\n" -" public Class<?> classForName(String name);\n" -" \n" -" /**\n" -" * Gets a resource as a URL by name\n" -" * \n" -" * @param name The name of the resource\n" -" * @return An URL to the resource\n" -" */\n" -" public URL getResource(String name);\n" -" \n" -" /**\n" -" * Gets resources as URLs by name\n" -" * \n" -" * @param name The name of the resource\n" -" * @return An iterable reference to the URLS\n" -" */\n" -" public Iterable<URL> getResources(String name);\n" -" \n" -"}\n" -" ]]>" +msgid "org.jboss.webbeans.bootstrap.webBeanDiscovery=org.jboss.webbeans.integration.jbossas.WebBeanDiscoveryImpl" msgstr "" -#. Tag: programlisting -#: ri-spi.xml:177 -#, no-c-format -msgid "org.jboss.webbeans.resources.spi.ResourceLoader=com.acme.ResourceLoader" -msgstr "" - -#. Tag: programlisting -#: ri-spi.xml:184 -#, no-c-format -msgid "<![CDATA[public MyResourceLoader(ServletContext servletContext) {}]]>" -msgstr "" - #. Tag: para -#: ri-spi.xml:186 +#: ri-spi.xml:71 #, no-c-format -msgid "" -"The servlet context can be used to allow your implementation of " -"<literal>ResourceLoader</literal> to interact with the container." +msgid "The property can either be specified as a system property, or in a properties file <literal>META-INF/web-beans-ri.properties</literal>." msgstr "" #. Tag: title -#: ri-spi.xml:196 +#: ri-spi.xml:79 #, no-c-format msgid "The contract with the container" msgstr "" #. Tag: para -#: ri-spi.xml:198 +#: ri-spi.xml:81 #, no-c-format -msgid "" -"There are a number of requirements that the Web Beans RI places on the " -"container for correct functioning that fall outside implementation of APIs" +msgid "There are a number of requirements that the Web Beans RI places on the container for correct functioning that fall outside implementation of APIs" msgstr "" #. Tag: term -#: ri-spi.xml:206 +#: ri-spi.xml:89 #, no-c-format msgid "Classloader isolation" msgstr "" #. Tag: para -#: ri-spi.xml:210 +#: ri-spi.xml:93 #, no-c-format -msgid "" -"If you are integrating the Web Beans RI into an environment that supports " -"deployment of multiple applications, you must enable, automatically, or " -"through user configuation, classloader isolation for each Web Beans " -"application." +msgid "If you are integrating the Web Beans into an environment that supports deployment of applications, you must enable, automatically, or through user configuation, classloader isolation for each Web Beans application" msgstr "" #. Tag: term -#: ri-spi.xml:219 +#: ri-spi.xml:102 #, no-c-format -msgid "Servlet listener" -msgstr "" - -#. Tag: para -#: ri-spi.xml:223 -#, no-c-format -msgid "" -"If you are integrating the Web Beans into a Servlet environment you must " -"register <literal>org.jboss.webbeans.servlet.WebBeansListener</literal> as a " -"Servlet listener, either automatically, or through user configuration, for " -"each Web Beans application which uses Servlet." -msgstr "" - -#. Tag: term -#: ri-spi.xml:234 -#, no-c-format -msgid "Session Bean Interceptor" -msgstr "" - -#. Tag: para -#: ri-spi.xml:238 -#, no-c-format -msgid "" -"If you are integrating the Web Beans into an EJB environment you must " -"register <literal>org.jboss.webbeans.ejb.SessionBeanInterceptor</literal> as " -"a EJB interceptor for all EJBs in the application, either automatically, or " -"through user configuration, for each Web Beans application which uses " -"enterprise beans." -msgstr "" - -#. Tag: term -#: ri-spi.xml:249 -#, no-c-format msgid "The <literal>webbeans-ri.jar</literal>" msgstr "" #. Tag: para -#: ri-spi.xml:253 +#: ri-spi.xml:106 #, no-c-format -msgid "" -"If you are integrating the Web Beans into an environment that supports " -"deployment of applications, you must insert the <literal>webbeans-ri.jar</" -"literal> into the applications isolated classloader. It cannot be loaded " -"from a shared classloader." +msgid "If you are integrating the Web Beans into an environment that supports deployment of applications, you must insert the <literal>webbeans-ri.jar</literal> into the applications isolated classloader. It cannot be loaded from a shared classloader." msgstr "" + Modified: doc/trunk/reference/zh-CN/ri.po =================================================================== --- doc/trunk/reference/zh-CN/ri.po 2009-02-04 04:09:41 UTC (rev 1402) +++ doc/trunk/reference/zh-CN/ri.po 2009-02-04 04:10:08 UTC (rev 1403) @@ -3,11 +3,11 @@ # msgid "" msgstr "" -"Project-Id-Version: master.xml \n" +"Project-Id-Version: master.xml\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-02-01 21:16+0000\n" -"PO-Revision-Date: 2008-12-19 20:26+0000\n" -"Last-Translator: Automatically generated\n" +"POT-Creation-Date: 2008-12-20 22:08+0000\n" +"PO-Revision-Date: 2009-02-04 11:41+0800\n" +"Last-Translator: Sean Wu <alartin(a)gmail.com&gt;\n&quot; "Language-Team: none\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -16,303 +16,222 @@ #. Tag: title #: ri.xml:4 #, no-c-format -msgid "The Web Beans Reference Implementation" -msgstr "" +msgid "Using the Web Beans Reference Implementation" +msgstr "使用Web Beans的参考实现" #. Tag: para #: ri.xml:6 #, no-c-format -msgid "" -"The Web Beans Reference Implementation is being developed at <ulink url=" -"\"http://seamframework.org/WebBeans\">the Seam project</ulink>. You can " -"download the latest developer release of Web Beans from the <ulink url=" -"\"http://seamframework.org/Download\">the downloads page</ulink>." -msgstr "" +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 "Web Beans RI自带了两个例子：<literal>webbeans-numberguess</literal> (一个仅包含一个简单Bean的WAR应用例子)和<literal>webbeans-translator</literal> (一个包含企业Bean的EAR应用例子)。" #. Tag: para #: ri.xml:13 #, no-c-format -msgid "" -"The Web Beans RI comes with a two deployable example applications: " -"<literal>webbeans-numberguess</literal>, a war example, containing only " -"simple beans, and <literal>webbeans-translator</literal> an ear example, " -"containing enterprise beans. To run the examples you'll need the following:" -msgstr "" +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<...;, and unzip it. For example:" +msgstr "当前，Web Beans参考实现只能运行在JBoss AS 5之上。你需要从<ulink url=\"http://www.jboss.org/jbossas/downloads/\">jboss.org<... AS 5.0.0.GA, 然后解压。例如：" -#. Tag: para -#: ri.xml:22 -#, no-c-format -msgid "the latest release of the Web Beans RI," -msgstr "" - -#. Tag: para -#: ri.xml:25 -#, no-c-format -msgid "JBoss AS 5.0.0.GA, and" -msgstr "" - -#. Tag: para -#: ri.xml:28 -#, no-c-format -msgid "Ant 1.7.0." -msgstr "" - -#. Tag: para -#: ri.xml:32 -#, 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:39 +#: ri.xml:20 #, no-c-format msgid "" "<![CDATA[$ cd /Applications\n" "$ unzip ~/jboss-5.0.0.GA.zip]]>" msgstr "" +"<![CDATA[$ cd /Applications\n" +"$ unzip ~/jboss-5.0.0.GA.zip]]>" #. Tag: para -#: ri.xml:41 +#: ri.xml:22 #, no-c-format -msgid "" -"Next, download the Web Beans RI from <ulink url=\"http://seamframework.org/" -"Download\">seamframework.org</ulink>, and unzip it. For example" -msgstr "" +msgid "Next, download the Web Beans RI from <ulink url=\"http://seamframework.org/WebBeans\">seamframework.org&...;, and unzip it. For example" +msgstr "然后从<ulink url=\"http://seamframework.org/WebBeans\">seamframework.org&... Beans的参考实现，然后解压。例如：" #. Tag: programlisting -#: ri.xml:47 +#: ri.xml:28 #, no-c-format msgid "" "<![CDATA[$ cd ~/\n" -"$ unzip ~/webbeans-$VERSION.zip]]>" +"$ unzip ~/webbeans-1.0.0.ALPHA1.zip]]>" msgstr "" +"<![CDATA[$ cd ~/\n" +"$ unzip ~/webbeans-1.0.0.ALPHA1.zip]]>" #. Tag: para -#: ri.xml:50 +#: ri.xml:31 #, no-c-format -msgid "" -"Next, we need to tell Web Beans where JBoss is located. Edit <literal>jboss-" -"as/build.properties</literal> and set the <literal>jboss.home</literal> " -"property. For example:" -msgstr "" +msgid "Next, we need to tell Web Beans where JBoss is located. Edit <literal>jboss-as/build.properties</literal> and set the <literal>jboss.home</literal> property. For example:" +msgstr "然后，我们需要告诉Web Beans JBoss的位置。编辑<literal>jboss-as/build.properties</literal>，设置<literal>jboss.home</literal>属性。例如：" #. Tag: programlisting -#: ri.xml:56 +#: ri.xml:37 #, no-c-format msgid "jboss.home=/Applications/jboss-5.0.0.GA" -msgstr "" +msgstr "jboss.home=/Applications/jboss-5.0.0.GA" #. Tag: para -#: ri.xml:58 +#: ri.xml:39 #, 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 "" +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 "因为Web Beans是新的软件，你需要更新JBoss AS来运行Web Beans的参考实现。JBoss AS未来的版本将包括这些更新，这些步骤将不再是必须的。" #. Tag: para -#: ri.xml:65 +#: ri.xml:46 #, 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 "" +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 "当前，我们需要两个更新。首先，需要添加一个新的部署器<literal>webbeans.deployer</literal>。这个部署器提供JBoss AS对Web Bean档案包的支持，能够让Web Beans参考实现查询EJB3容器，发现应用中安装的EJB。第二，需要更新JBoss EJB3。" #. Tag: para -#: ri.xml:74 +#: ri.xml:55 #, 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 "" +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 "为了安装更新，你需要安装Ant 1.7.0，设置<literal>ANT_HOME</literal>环境变量。例如：" #. Tag: programlisting -#: ri.xml:79 +#: ri.xml:60 #, no-c-format msgid "" "$ unzip apache-ant-1.7.0.zip\n" "$ export ANT_HOME=~/apache-ant-1.7.0" msgstr "" +"$ unzip apache-ant-1.7.0.zip\n" +"$ export ANT_HOME=~/apache-ant-1.7.0" #. Tag: para -#: ri.xml:81 +#: ri.xml:62 #, 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 "" +msgid "Then, you can install the update. The update script will use Maven to download the Web Beans and EJB3 automatically." +msgstr "然后，你需要安装更新，更新脚本使用Maven来自动下载Web Beans和EJB3。" #. Tag: programlisting -#: ri.xml:86 +#: ri.xml:67 #, no-c-format msgid "" -"$ cd webbeans-$VERSION/jboss-as\n" +"$ cd webbeans-1.0.0.ALPHA1/jboss-as\n" "$ ant update" msgstr "" +"$ cd webbeans-1.0.0.ALPHA1/jboss-as\n" +"$ ant update" #. Tag: para -#: ri.xml:88 +#: ri.xml:69 #, no-c-format msgid "Now, you're ready to deploy your first example!" -msgstr "" +msgstr "现在，你可以部署你的第一个例子了！" #. Tag: para -#: ri.xml:93 +#: ri.xml:74 #, no-c-format -msgid "" -"The build scripts for the examples offer a number of targets, these are:" -msgstr "" +msgid "The build scripts for the examples offer a number of targets, these are:" +msgstr "例子的构建脚本包含多个目标：" #. Tag: para -#: ri.xml:99 +#: ri.xml:80 #, no-c-format msgid "<literal>ant restart</literal> - deploy the example in exploded format" -msgstr "" +msgstr "<literal>ant restart</literal> - 以exploded形式部署例子" #. Tag: para -#: ri.xml:105 +#: ri.xml:86 #, no-c-format -msgid "" -"<literal>ant explode</literal> - update an exploded example, without " -"restarting the deployment" -msgstr "" +msgid "<literal>ant explode</literal> - update an exploded example, without restarting the deployment" +msgstr "<literal>ant explode</literal> - 无需重新部署，更新一个exploded形式部署的例子" #. Tag: para -#: ri.xml:111 +#: ri.xml:92 #, no-c-format -msgid "" -"<literal>ant deploy</literal> - deploy the example in compressed jar format" -msgstr "" +msgid "<literal>ant deploy</literal> - deploy the example in compressed jar format" +msgstr "<literal>ant deploy</literal> - 以压缩jar包形式部署例子" #. Tag: para -#: ri.xml:116 +#: ri.xml:97 #, no-c-format msgid "<literal>ant undeploy</literal> - remove the example from the server" -msgstr "" +msgstr "<literal>ant undeploy</literal> - 将例子从服务器中移除" #. Tag: para -#: ri.xml:121 +#: ri.xml:102 #, no-c-format msgid "<literal>ant clean</literal> - clean the example" -msgstr "" +msgstr "<literal>ant clean</literal> - 清除例子" #. Tag: para -#: ri.xml:128 +#: ri.xml:109 #, no-c-format msgid "To deploy the numberguess example:" -msgstr "" +msgstr "部署猜数字(numberguess)例子：" #. Tag: programlisting -#: ri.xml:132 +#: ri.xml:113 #, no-c-format msgid "" "$ cd examples/numberguess\n" "ant deploy" msgstr "" +"$ cd examples/numberguess\n" +"ant deploy" #. Tag: para -#: ri.xml:134 +#: ri.xml:115 #, no-c-format -msgid "Start JBoss AS:" -msgstr "" +msgid "Wait for the application to deploy, and enjoy hours of fun at <ulink url=\"http://localhost:8080/webbeans-numberguess\"></ulink>!" +msgstr "等待应用部署完毕，好好体验一下<ulink url=\"http://localhost:8080/webbeans-numberguess\"></ulink>！" -#. Tag: programlisting -#: ri.xml:138 -#, no-c-format -msgid "$ /Application/jboss-5.0.0.GA/bin/run.sh" -msgstr "" - #. Tag: para -#: ri.xml:141 +#: ri.xml:120 #, no-c-format -msgid "If you use Windows, use the <literal>run.bat</literal>script." -msgstr "" +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 "Web Bean参考实现的第二个简单例子能够将你的文本翻译为拉丁文。猜数字例子是一个WAR应用，仅仅使用了一个简单Beans；翻译器例子是一个EAR应用，包含了打包在EJB模块中的企业Beans。试一下：" -#. Tag: para -#: ri.xml:146 -#, 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:151 -#, 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:158 +#: ri.xml:127 #, no-c-format msgid "" -"$ cd examples/translator\n" +"$ cd examples/traslator\n" "ant deploy" msgstr "" +"$ cd examples/traslator\n" +"ant deploy" #. Tag: para -#: ri.xml:160 +#: ri.xml:129 #, no-c-format -msgid "" -"Wait for the application to deploy, and visit <ulink url=\"http://" -"localhost:8080/webbeans-translator\"></ulink>!" -msgstr "" +msgid "Wait for the application to deploy, and visit <ulink url=\"http://localhost:8080/webbeans-translator\"></ulink>!" +msgstr "等待应用部署，试一下<ulink url=\"http://localhost:8080/webbeans-translator\"></ulink>！" #. Tag: title -#: ri.xml:166 +#: ri.xml:135 #, no-c-format msgid "The numberguess example" -msgstr "" +msgstr "猜数字例子" #. Tag: para -#: ri.xml:168 +#: ri.xml:137 #, 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 "" +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 "在猜数字应用中，你有十次机会来猜一个1到100之间的数字。每次猜测之后，应用都会告诉你你猜的数字是高了还是低了。" #. Tag: para -#: ri.xml:174 +#: ri.xml:143 #, 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 "" +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 "猜数字应用由Web Beans，配置文件，Facelete JSF页面组成，打包为一个WAR。我们先看一下配置文件。" #. Tag: para -#: ri.xml:180 +#: ri.xml:149 #, 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 "" +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 "猜数字应用的所有的配置文件位于<literal>WEB-INF/</literal>，这个目录位于源码树的<literal>WebContent</literal>中。首先，我们在faces-config.xml文件中告诉JSF使用Faceletes：" #. Tag: programlisting -#: ri.xml:188 +#: ri.xml:157 #, 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" +" 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" @@ -320,36 +239,40 @@ "\n" "</faces-config>]]>" msgstr "" +"<![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>]]>" #. Tag: para -#: ri.xml:190 +#: ri.xml:159 #, no-c-format -msgid "" -"There is an empty <literal>web-beans.xml</literal> file, which marks this " -"application as a Web Beans application." -msgstr "" +msgid "There is an empty <literal>web-beans.xml</literal> file, which marks this application as a Web Beans application." +msgstr "这有一个空的<literal>web-beans.xml</literal>文件，标识这个应用是一个Web Beans应用。" #. Tag: para -#: ri.xml:195 +#: ri.xml:164 #, no-c-format msgid "Finally there is <literal>web.xml</literal>:" -msgstr "" +msgstr "最后，这有一个 <literal>web.xml</literal>：" #. Tag: section -#: ri.xml:197 +#: ri.xml:166 #, 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" +"<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" +" 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" @@ -374,24 +297,12 @@ " <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> </calloutlist> </" -"programlistingco> <note> <para> Whilst this demo is a JSF demo, you can use " -"the Web Beans RI with any Servlet based web framework. </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=\"30\"/> <area id=\"submit\" coords=" -"\"33\"/> </areaspec> <programlisting><![CDATA[<!DOCTYPE html PUBLIC \"-//" -"W3C//DTD XHTML 1.0 Transitional//EN\" \"http://www.w3.org/TR/xhtml1/DTD/" -"xhtml1-transitional.dtd\">\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" @@ -404,15 +315,12 @@ " <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 and game.guess ne 0}\"/>\n" -" <h:outputText id=\"Lower\" value=\"Lower!\" rendered=\"#{game." -"number lt game.guess and game.guess ne 0}\"/>\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" +" I'm thinking of a number between #{game.smallest} and #{game.biggest}.\n" " You have #{game.remainingGuesses} guesses.\n" " </div>\n" " \n" @@ -421,53 +329,104 @@ " <h:inputText id=\"inputGuess\" \n" " value=\"#{game.guess}\" \n" " required=\"true\" \n" -" size=\"3\" \n" -" disabled=\"#{game.number eq game.guess}\">\n" +" size=\"3\">\n" " <f:validateLongRange maximum=\"#{game.biggest}\" \n" " minimum=\"#{game.smallest}\"/>\n" " </h:inputText>\n" -" <h:commandButton id=\"GuessButton\" \n" +" <h:commandButton id=\"GuessButton\" \n" " value=\"Guess\" \n" -" action=\"#{game.check}\" \n" -" disabled=\"#{game.number eq game.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 "" +"<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" -" <h:commandButton id=\"RestartButton\" value=\"Reset\" action=\"#" -"{game.reset}\" immediate=\"true\" />\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 "" +"</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>" #. Tag: para -#: ri.xml:299 +#: ri.xml:279 #, 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 "" +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 "这个例子包括4个类，前面两个是绑定类型。首先，这有一个<literal>@Random</literal>绑定类型，用来注入一个随机数：" #. Tag: programlisting -#: ri.xml:305 +#: ri.xml:285 #, no-c-format msgid "" "<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" @@ -476,17 +435,20 @@ "@BindingType\n" "public @interface Random {}]]>" msgstr "" +"<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" +"@Retention(RUNTIME)\n" +"@Documented\n" +"@BindingType\n" +"public @interface Random {}]]>" #. Tag: para -#: ri.xml:307 +#: ri.xml:287 #, no-c-format -msgid "" -"There is also the <literal>@MaxNumber</literal> binding type, used for " -"injecting the maximum number that can be injected:" -msgstr "" +msgid "There is also the <literal>@MaxNumber</literal> binding type, used for injecting the maximum number that can be injected:" +msgstr "这还有一个<literal>@MaxNumber</literal>绑定类型，用来注入一个最大值：" #. Tag: programlisting -#: ri.xml:312 +#: ri.xml:292 #, no-c-format msgid "" "<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" @@ -496,25 +458,27 @@ "public @interface MaxNumber {}\n" "]]>" msgstr "" +"<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n" +"@Retention(RUNTIME)\n" +"@Documented\n" +"@BindingType\n" +"public @interface MaxNumber {}\n" +"]]>" #. Tag: para -#: ri.xml:314 +#: ri.xml:294 #, 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 "" +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 "<literal>Generator</literal>类通过一个生产者(producer)方法创建一个随机数。它也通过一个生产者方法暴露可能的最大值：" #. Tag: programlisting -#: ri.xml:320 +#: ri.xml:300 #, no-c-format msgid "" "<![CDATA[@ApplicationScoped\n" "public class Generator {\n" " \n" -" private java.util.Random random = new java.util.Random( System." -"currentTimeMillis() );\n" +" private java.util.Random random = new java.util.Random( System.currentTimeMillis() );\n" " \n" " private int maxNumber = 100;\n" " \n" @@ -534,55 +498,54 @@ "\n" "}]]>" msgstr "" +"<![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" +"}]]>" #. Tag: para -#: ri.xml:322 +#: ri.xml:302 #, 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 "" +msgid "You'll notice that the <literal>Generator</literal> is application scoped; therefore we don't get a different random each time." +msgstr "你会注意到<literal>Generator</literal>是应用范围的；因此我们不会每次都得到一个不同的随机对象。" #. Tag: para -#: ri.xml:327 +#: ri.xml:307 #, no-c-format -msgid "" -"The final Web Bean in the application is the session scoped <literal>Game</" -"literal>." -msgstr "" +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 "最后，应用的Web Bean是会话范围的 <literal>Game</literal>。通过将 <literal>Game</literal>的范围设为会话范围，你可以为每个浏览器会话启动一个猜数字游戏。你可以简单地添加一个复位按钮-对于读者来说是一个很好的练习 ：）" #. Tag: para -#: ri.xml:332 +#: ri.xml:314 #, no-c-format -msgid "" -"You'll 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 "" +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 "你也许注意到我们使用了 <literal>@Named</literal>注释，以便我们能够通过EL（表达式语言）在JSF页面中使用Bean。最后，我们通过构造器注入来初始化猜数字游戏并给它设一个随机数。当然，在玩家猜对数字后，我们需要告诉玩家他赢了，所以我们通过<literal>FacesMessage</literal>反馈给玩家一条信息。" #. Tag: programlisting -#: ri.xml:340 +#: ri.xml:322 #, no-c-format msgid "" -"<![CDATA[package org.jboss.webbeans.examples.numberguess;\n" -"\n" -"\n" -"import javax.annotation.PostConstruct;\n" -"import javax.faces.application.FacesMessage;\n" -"import javax.faces.context.FacesContext;\n" -"import javax.webbeans.AnnotationLiteral;\n" -"import javax.webbeans.Current;\n" -"import javax.webbeans.Initializer;\n" -"import javax.webbeans.Named;\n" -"import javax.webbeans.SessionScoped;\n" -"import javax.webbeans.manager.Manager;\n" -"\n" -"@Named\n" +"<![CDATA[@Named\n" "@SessionScoped\n" -"public class Game\n" -"{\n" +"public class Game {\n" " private int number;\n" " \n" " private int guess;\n" @@ -590,121 +553,104 @@ " private int biggest;\n" " private int remainingGuesses;\n" " \n" -" @Current Manager manager;\n" +" public Game() {}\n" " \n" -" public Game()\n" -" {\n" -" }\n" -" \n" " @Initializer\n" -" Game(@MaxNumber int maxNumber)\n" -" { \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" -" public int getNumber()\n" -" {\n" -" return number;\n" -" }\n" +" // Getters and setters for fields\n" " \n" -" public int getGuess()\n" -" {\n" -" return guess;\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" -" public void setGuess(int guess)\n" -" {\n" -" this.guess = guess;\n" -" }\n" +"}]]>" +msgstr "" +"<![CDATA[@Named\n" +"@SessionScoped\n" +"public class Game {\n" +" private int number;\n" " \n" -" public int getSmallest()\n" -" {\n" -" return smallest;\n" -" }\n" +" private int guess;\n" +" private int smallest;\n" +" private int biggest;\n" +" private int remainingGuesses;\n" " \n" -" public int getBiggest()\n" -" {\n" -" return biggest;\n" -" }\n" +" public Game() {}\n" " \n" -" public int getRemainingGuesses()\n" -" {\n" -" return remainingGuesses;\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" -" {\n" -" if (guess>number)\n" -" {\n" +" public String check() {\n" +" if (guess>number) {\n" " biggest = guess - 1;\n" " }\n" -" if (guess<number)\n" -" {\n" +" if (guess<number) {\n" " smallest = guess + 1;\n" " }\n" -" if (guess == number)\n" -" {\n" -" FacesContext.getCurrentInstance().addMessage(null, new FacesMessage" -"(\"Correct!\"));\n" +" if (guess == number) {\n" +" FacesContext.getCurrentInstance().addMessage(null, new FacesMessage(\"Correct!\"));\n" " }\n" " remainingGuesses--;\n" " return null;\n" " }\n" " \n" -" @PostConstruct\n" -" public void reset()\n" -" {\n" -" this.smallest = 0;\n" -" this.guess = 0;\n" -" this.remainingGuesses = 10;\n" -" this.number = manager.getInstanceByType(Integer.class, new " -"AnnotationLiteral<Random>(){});\n" -" }\n" -" \n" "}]]>" -msgstr "" #. Tag: title -#: ri.xml:344 +#: ri.xml:326 #, no-c-format msgid "The translator example" -msgstr "" +msgstr "翻译器例子" #. Tag: para -#: ri.xml:346 +#: ri.xml:328 #, no-c-format -msgid "" -"The translator example will take any sentences you enter, and translate them " -"to Latin." -msgstr "" +msgid "The translator example will take any sentences you enter, and translate them to Latin." +msgstr "翻译器例子能够将你输入的句子翻译为拉丁文。" #. Tag: para -#: ri.xml:351 +#: ri.xml:333 #, no-c-format -msgid "" -"The translator example is built as an ear, and contains EJBs. As a result, " -"it's structure is more complex than the numberguess example." -msgstr "" +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 "翻译器例子是一个EAR应用，包含EJBs和企业Beans。因此，它的结构比猜数字例子复杂。" #. Tag: para -#: ri.xml:357 +#: ri.xml:340 #, 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 "" +msgid "EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will make this structure much simpler!" +msgstr "EJB3.1和Java EE 6允许你在WAR包中打包EJBs, 这将让这个结构更加简单！" #. Tag: para -#: ri.xml:363 +#: ri.xml:346 #, 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> for us:" -msgstr "" +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 "首先，让我们看一下EAR聚合器，它位于<literal>webbeans-translator-ear</literal>模块下。Maven将为我们自动生成<literal>application.xml</literal>和<literal>jboss-app.xml</literal>文件：" #. Tag: programlisting -#: ri.xml:369 +#: ri.xml:353 #, no-c-format msgid "" "<![CDATA[<plugin>\n" @@ -718,40 +664,78 @@ " <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 "" +"<![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>]]>" #. Tag: para -#: ri.xml:371 +#: ri.xml:355 #, no-c-format -msgid "" -"Here we set the context path, which gives us a nice url (<ulink url=\"http://" -"localhost:8080/webbeans-translator\">http://localhost:8080/webbeans-" -"translator</ulink>)." -msgstr "" +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 "我们需要在这里做些事情-首先我们需要设置上下文路径为一个不错的URL(<ulink url=\"http://localhost:8080/webbeans-translator\">http://localhost:8080/webbeans-translator</ulink>)，我们还需要将JBoss AS的类加载器隔离配置激活。" #. Tag: para -#: ri.xml:377 +#: ri.xml:363 #, 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 "如果你不使用Maven来生成这些文件，你将需要<literal>META-INF/jboss-app.xml</literal>：" + +#. Tag: programlisting +#: ri.xml:368 +#, no-c-format msgid "" -"If you aren't using Maven to generate these files, you would need " -"<literal>META-INF/application.xml</literal>:" +"<![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 "" +"<![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>]]>" +#. Tag: para +#: ri.xml:370 +#, no-c-format +msgid "and <literal>META-INF/application.xml</literal>:" +msgstr "和 <literal>META-INF/application.xml</literal>:" + #. Tag: programlisting -#: ri.xml:382 +#: ri.xml:374 #, 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" +" 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" +" <description>Ear Example for the reference implementation of JSR 299: Web Beans</description>\n" " \n" " <module>\n" " <web>\n" @@ -764,27 +748,39 @@ " </module>\n" "</application>]]>" msgstr "" +"<![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>]]>" #. Tag: para -#: ri.xml:385 +#: ri.xml:377 #, 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) in <literal>WebContent/WEB-INF</literal>." -msgstr "" +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 "然后，我们看一下WAR包。在猜数字例子中，我们需要<literal>faces-config.xml</literal>（配置Facelets）和一个位于<literal>WebContent/WEB-INF</literal>下的<literal>web.xml</literal>（配置JSF并将Web Beans服务加入Servlet容器中）。" #. Tag: para -#: ri.xml:392 +#: ri.xml:384 #, 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 "" +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 "更有意思的是用来翻译文本的facelet。在猜数字应用中我们有一个模板，这个模板套着表单（省略了表单）：" #. Tag: programlisting -#: ri.xml:398 +#: ri.xml:390 #, no-c-format msgid "" "<![CDATA[<h:form id=\"NumberGuessMain\">\n" @@ -800,8 +796,7 @@ " </tr>\n" " <tr>\n" " <td>\n" -" <h:inputTextarea id=\"text\" value=\"#{translator.text}\" " -"required=\"true\" rows=\"5\" cols=\"80\" />\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" @@ -809,54 +804,109 @@ " </tr>\n" " </table>\n" " <div>\n" -" <h:commandButton id=\"button\" value=\"Translate\" action=\"#" -"{translator.translate}\"/>\n" +" <h:commandButton id=\"button\" value=\"Translate\" action=\"#{translator.translate}\"/>\n" " </div>\n" " \n" "</h:form>]]>" msgstr "" +"<![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>]]>" #. Tag: para -#: ri.xml:400 +#: ri.xml:392 #, 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 "" +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:405 +#: ri.xml:397 #, 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 "最后，我们看一下EJB模块，<literal>webbeans-translator-ejb</literal>。在<literal>src/main/resources/META-INF</literal>下有两个配置文件，一个是空的<literal>web-beans.xml</literal>，用来标识这个档案包包含Web Beans，一个是<literal>ejb-jar.xml</literal>。Web Beans为所有的EJB提供注入和初始化服务，使用<literal>ejb-jar.xml</literal>文件来配置。你将在使用Web Beans的EJB项目中需要这些配置：" + +#. Tag: programlisting +#: ri.xml:409 +#, no-c-format msgid "" -"Finally, let's look at the ejb module, <literal>webbeans-translator-ejb</" -"literal>. In <literal>src/main/resources/META-INF</literal> there is just an " -"empty <literal>web-beans.xml</literal>, used to mark the archive as " -"containing Web Beans." +"<![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 "" +"<![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>]]>" #. Tag: para -#: ri.xml:413 +#: ri.xml:411 #, no-c-format -msgid "" -"We've saved the most interesting bit to last, the code! The project has two " -"simple beans, <literal>SentenceParser</literal> and <literal>TextTranslator</" -"literal> and two enterprise beans, <literal>TranslatorControllerBean</" -"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 "" +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 "我们将最有意思的部分放在最后，那就是代码！这个例子有两个简单Beans, <literal>SentanceParser</literal>和<literal>TextTranslator</literal>，还有两个企业Beans，<literal>TanslatorControllerBean</literal>和<literal>SentenceTranslator</literal>。现在你应该对Web Beans有点熟悉了，我们在这里着重最有意思的部分。" #. Tag: para -#: ri.xml:423 +#: ri.xml:421 #, no-c-format -msgid "" -"Both <literal>SentenceParser</literal> and <literal>TextTranslator</literal> " -"are dependent beans, and <literal>TextTranslator</literal> uses constructor " -"initialization:" -msgstr "" +msgid "Both <literal>SentanceParser</literal> and <literal>TextTranslator</literal> are dependent beans, and <literal>TextTranslator</literal> uses constructor initialization:" +msgstr "<literal>SentanceParser</literal>和<literal>TextTranslator</literal>是相互依赖的Beans，<literal>TextTranslator</literal>使用构造器初始化：" #. Tag: programlisting -#: ri.xml:429 +#: ri.xml:427 #, no-c-format msgid "" "<![CDATA[public class TextTranslator { \n" @@ -864,33 +914,35 @@ " private Translator sentenceTranslator; \n" " \n" " @Initializer\n" -" TextTranslator(SentenceParser sentenceParser, Translator " -"sentenceTranslator) \n" +" TextTranslator(SentenceParser sentenceParser, Translator sentenceTranslator) \n" " { \n" " this.sentenceParser = sentenceParser; \n" " this.sentenceTranslator = sentenceTranslator;]]>" msgstr "" +"<![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;]]>" #. Tag: para -#: ri.xml:431 +#: ri.xml:429 #, 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 "" +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 "<literal>TextTranslator</literal>是一个无状态Bean（拥有一个本地业务接口），这里是魔术展现的地方-当然，我们不会开发一个完整的翻译器，但我们可以开发一个不错的小玩意！" #. Tag: para -#: ri.xml:437 +#: ri.xml:435 #, 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 "" +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 "最后，这里又要一个面向UI的控制器，从用户输入处搜集文本，转发给翻译器。这个控制器是请求范围的，具名的，有状态的会话Bean，它可以将翻译器注入进来。" #. Tag: programlisting -#: ri.xml:443 +#: ri.xml:441 #, no-c-format msgid "" "<![CDATA[@Stateful\n" @@ -901,21 +953,28 @@ " \n" " @Current TextTranslator translator;]]>" msgstr "" +"<![CDATA[@Stateful\n" +"@RequestScoped\n" +"@Named(\"translator\")\n" +"public class TranslatorControllerBean implements TranslatorController\n" +"{\n" +" \n" +" @Current TextTranslator translator;]]>" #. Tag: para -#: ri.xml:445 +#: ri.xml:443 #, no-c-format msgid "The bean also has getters and setters for all the fields on the page." -msgstr "" +msgstr "这个Bean也拥有页面上所有域的getter和setter方法。" #. Tag: para -#: ri.xml:449 +#: ri.xml:447 #, no-c-format msgid "As this is a stateful session bean, we have to have a remove method:" -msgstr "" +msgstr "这个Bean是有状态会话Bean，我们需要有一个remove方法：" #. Tag: programlisting -#: ri.xml:453 +#: ri.xml:451 #, no-c-format msgid "" "<![CDATA[ @Remove\n" @@ -924,29 +983,27 @@ " \n" " }]]>" msgstr "" +"<![CDATA[ @Remove\n" +" public void remove()\n" +" {\n" +" \n" +" }]]>" #. Tag: para -#: ri.xml:455 +#: ri.xml:453 #, 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 "" +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 "Web Beans管理器在这个bean销毁的时候调用remove方法；在这个例子中是请求结束的时候。" #. Tag: para -#: ri.xml:461 +#: ri.xml:459 #, 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 "" +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\">ht... +msgstr "Web Beans参考实现的例子到此结束。想要获得关于参考实现更多的知识或者帮助，请访问<ulink url=\"http://www.seamframework.org/WebBeans/Development\">ht... #. Tag: para -#: ri.xml:467 +#: ri.xml:465 #, no-c-format -msgid "" -"We need help in all areas - bug fixing, writing new features, writing " -"examples and translating this reference guide." -msgstr "" +msgid "We need help in all areas - bug fixing, writing new features, writing examples and translating this reference guide." +msgstr "我们在各个方面都需要帮助-bug修复，新特性开发，例子开发和参考指南的翻译等等。" +