seam-commits August 2009

seam-commits@lists.jboss.org

1 participants
124 discussions

Seam SVN: r11417 - in branches/community/Seam_2_2/doc/Seam_Reference_Guide: bn-IN and 22 other directories.

by seam-commits＠lists.jboss.org

Author: nico.ben Date: 2009-08-22 09:32:07 -0400 (Sat, 22 Aug 2009) New Revision: 11417 Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/as-IN/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/as-IN/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/as-IN/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/bn-IN/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/bn-IN/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/bn-IN/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/de-DE/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/de-DE/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/de-DE/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-ES/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-ES/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-ES/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-MX/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-MX/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-MX/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/fr-FR/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/fr-FR/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/fr-FR/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/gu-IN/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/gu-IN/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/gu-IN/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/hi-IN/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/hi-IN/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/hi-IN/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ja-JP/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ja-JP/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ja-JP/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/kn-IN/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/kn-IN/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/kn-IN/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ko-KR/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ko-KR/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ko-KR/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ml-IN/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ml-IN/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ml-IN/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/mr-IN/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/mr-IN/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/mr-IN/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/or-IN/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/or-IN/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/or-IN/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/pa-IN/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/pa-IN/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/pa-IN/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Annotations.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Author_Group.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Book_Info.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Cache.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/ClusteringAndEJBPassivation.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Components.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Concepts.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Configuration.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Controls.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Conversations.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Dependencies.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Drools.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Elenhancements.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Events.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Excel.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Feedback.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Framework.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Getting_Started_With_JBoss_Tools.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Gettingstarted.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Glassfish.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Groovy.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Guice.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Gwt.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Hsearch.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/I18n.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Itext.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Jbpm.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Jms.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Mail.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Performance.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Persistence.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Preface.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Remoting.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Revision_History.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Rss.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Security.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Spring.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Testing.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Text.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Tools.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Tutorial.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Validation.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Weblogic.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Webservices.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Websphere.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Wicket.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Xml.pot branches/community/Seam_2_2/doc/Seam_Reference_Guide/pt-BR/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/pt-BR/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/pt-BR/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ru-RU/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ru-RU/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ru-RU/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/si-LK/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/si-LK/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/si-LK/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/sl-SL/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/sl-SL/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/sl-SL/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ta-IN/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ta-IN/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/ta-IN/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/te-IN/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/te-IN/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/te-IN/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-CN/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-CN/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-CN/Websphere.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-TW/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-TW/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-TW/Websphere.po Log: POT and PO update Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/as-IN/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/as-IN/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/as-IN/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/as-IN/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/as-IN/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/as-IN/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/as-IN/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/as-IN/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/as-IN/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/bn-IN/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/bn-IN/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/bn-IN/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/bn-IN/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/bn-IN/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/bn-IN/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/bn-IN/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/bn-IN/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/bn-IN/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/de-DE/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/de-DE/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/de-DE/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/de-DE/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/de-DE/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/de-DE/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/de-DE/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/de-DE/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/de-DE/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-ES/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-ES/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-ES/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-ES/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-ES/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-ES/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-ES/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-ES/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-ES/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-MX/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-MX/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-MX/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_-_Contextual_Components VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-11-06 00:08+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-MX/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-MX/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-MX/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_-_Contextual_Components VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-11-06 00:09+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-MX/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-MX/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/es-MX/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_-_Contextual_Components VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-11-06 00:10+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/fr-FR/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/fr-FR/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/fr-FR/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/fr-FR/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/fr-FR/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/fr-FR/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/fr-FR/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/fr-FR/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/fr-FR/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/gu-IN/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/gu-IN/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/gu-IN/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/gu-IN/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/gu-IN/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/gu-IN/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/gu-IN/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/gu-IN/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/gu-IN/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/hi-IN/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/hi-IN/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/hi-IN/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/hi-IN/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/hi-IN/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/hi-IN/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/hi-IN/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/hi-IN/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/hi-IN/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ja-JP/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ja-JP/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ja-JP/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2009-03-19 18:46+0900\n" "Last-Translator: minamoto <minamoto(a)redhat.com>\n" "Language-Team: none\n" @@ -109,90 +109,96 @@ #. Tag: author #: Author_Group.xml:66 +#, fuzzy, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "<firstname>Dan</firstname> <surname>Allen</surname>" + +#. Tag: author +#: Author_Group.xml:70 #, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "<firstname>Marek</firstname> <surname>Novotny</surname>" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "<firstname>James</firstname> <surname>Cobb</surname>" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "グラフィックデザイン" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "<firstname>Mark</firstname> <surname>Newton</surname>" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "<firstname>Steve</firstname> <surname>Ebersole</surname>" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "<firstname>Michael</firstname> <surname>Courcy</surname>" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "フランス語翻訳" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "<firstname>Nicola</firstname> <surname>Benaglia</surname>" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "イタリア語翻訳" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "<firstname>Stefano</firstname> <surname>Travelli</surname>" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, fuzzy, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "<firstname>Dan</firstname> <surname>Allen</surname>" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "日本語翻訳" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "<firstname>Samson</firstname> <surname>Kittoli</surname>" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ja-JP/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ja-JP/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ja-JP/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -4,7 +4,7 @@ msgstr "" "Project-Id-Version: Tools\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2009-02-25 16:25+0900\n" "Last-Translator: Daisuke Sano <d-sano(a)nri.co.jp>\n" "Language-Team: Japanese <fedora-trans-ja(a)redhat.com>\n" @@ -1324,12 +1324,12 @@ #. Tag: programlisting #: Excel.xml:876 -#, no-c-format +#, fuzzy, no-c-format msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ja-JP/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ja-JP/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ja-JP/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -4,7 +4,7 @@ msgstr "" "Project-Id-Version: Tools\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-12-14 05:13+0900\n" "Last-Translator: Shinobu NOGAMI <s-nogami(a)sourceforge.jp>\n" "Language-Team: Japanese <fedora-trans-ja(a)redhat.com>\n" @@ -16,685 +16,651 @@ #. Tag: title #: Websphere.xml:2 #, fuzzy, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "IBM Websphere 上の Seam" -#. Tag: para -#: Websphere.xml:4 -#, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." -msgstr "" +#. Tag: title +#: Websphere.xml:5 +#, fuzzy, no-c-format +msgid "WebSphere AS environment and version recommendation" +msgstr "Websphere 環境とデプロイメント情報" #. Tag: para #: Websphere.xml:7 -#, fuzzy, no-c-format +#, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -"最初に、サンプルのために使用する WebSphere 環境に関しての基礎的な情報を詳しく" -"述べます。たくさんの調査と作業の末に、EJB3 アプリケーションを正しく動作させる" -"ことができるようになりました。jee5 サンプルでそれらのステップの詳細を説明しま" -"す。次に、JPA サンプルアプリケーションをデプロイします。" -#. Tag: title -#: Websphere.xml:13 -#, fuzzy, no-c-format -msgid "Websphere AS environment and deployment information" -msgstr "Websphere 環境とデプロイメント情報" - #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:12 #, fuzzy, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" "WebSphere は商用製品なので、特定のインストールタイプやライセンスについて提供" "される手順などのインストールの詳細については説明しません。ここでは、すべての" "サンプルを動作させるのに必要となる使用したサーバの正確なバージョンと、インス" "トールのヒント、カスタムプロパティについて詳しく述べます。" -#. Tag: title -#: Websphere.xml:23 +#. Tag: para +#: Websphere.xml:18 #, fuzzy, no-c-format -msgid "Installation versions" -msgstr "インストールするバージョンとヒント" +msgid "" +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." +msgstr "" +"最初に、サンプルのために使用する WebSphere 環境に関しての基礎的な情報を詳しく" +"述べます。たくさんの調査と作業の末に、EJB3 アプリケーションを正しく動作させる" +"ことができるようになりました。jee5 サンプルでそれらのステップの詳細を説明しま" +"す。次に、JPA サンプルアプリケーションをデプロイします。" #. Tag: para #: Websphere.xml:24 -#, fuzzy, no-c-format +#, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -"この章のサンプルと情報は、すべて執筆時の Websphere のバージョン 6.1 に基づい" -"ています。" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 -#, fuzzy, no-c-format -msgid "Websphere Application Server V7" -msgstr "Websphere Application Server 6.1" +#, no-c-format +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." +msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "<literal>jee5/booking</literal> サンプル" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" -"<literal>jee5/booking</literal> サンプルは、(JBoss AS 上で動作する) ホテル予" -"約サンプルに基づいています。そのままで GlassFish 上で動作するように設計されて" -"いますが、以下の手順で Websphere 上でも動作させることができます。このサンプル" -"は <literal>$SEAM_DIST/examples/jee5/booking</literal> にあります。" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" -msgstr "<title>構成ファイルの変更</title>" +msgid "Configuring the WebSphere Web Container" +msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." -msgstr "雛形のサンプルに対して必要となる構成ファイルの変更点は以下の通りです。" +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." +msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" -msgstr "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" +msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, fuzzy, no-c-format +msgid "Open the WebSphere administration console" +msgstr "管理コンソールへログインしてください。" + +#. Tag: listitem +#: Websphere.xml:64 +#, no-c-format msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -"WebSphere では EJB をルックアップする際の名前を変更する必要があります。" -"<literal>jndi-pattern</literal> 属性の最後から <literal>/local</literal> を取" -"り除く必要があります。以下のように変更します。" -#. Tag: programlisting +#. Tag: listitem +#: Websphere.xml:67 +#, no-c-format +msgid "Click on the server name (<literal>server1</literal>)" +msgstr "" + +#. Tag: listitem #: Websphere.xml:70 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +#. Tag: listitem +#: Websphere.xml:73 +#, no-c-format +msgid "" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" +msgstr "" + #. Tag: literal -#: Websphere.xml:76 +#: Websphere.xml:77 +#, no-c-format +msgid "prependSlashToResource = true" +msgstr "" + +#. Tag: literal +#: Websphere.xml:80 +#, no-c-format +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" +msgstr "" + +#. Tag: listitem +#: Websphere.xml:84 #, fuzzy, no-c-format -msgid "resources/META-INF/ejb-jar.xml" -msgstr "resources/META-INF/jboss-app.xml" +msgid "Save and restart the server" +msgstr "サーバの再起動についてのメモ" +#. Tag: title +#: Websphere.xml:92 +#, no-c-format +msgid "Seam and the WebSphere JNDI name space" +msgstr "" + #. Tag: para -#: Websphere.xml:79 +#: Websphere.xml:93 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#. Tag: para +#: Websphere.xml:102 +#, fuzzy, no-c-format +msgid "The <literal>@JndiName</literal> annotation" +msgstr "<literal>Next</literal> ボタンを選択してください。" + +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/WEB-INF/web.xml" -msgstr "resources/WEB-INF/web.xml" +msgid "gives detailed explanations on how those mechanisms work." +msgstr "" #. Tag: para -#: Websphere.xml:91 -#, fuzzy, no-c-format +#: Websphere.xml:112 +#, no-c-format msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -"次に、<literal>web.xml</literal> の EJB 参照について変更を行う必要がありま" -"す。これらは、WebSphere が Web モジュール内の EJB2 参照を、実際には EAR モ" -"ジュール内にある EJB3 の Bean にバインドすることを可能にするための変更です。" -"すべての <literal>ejb-local-refs</literal> を以下の値で置き換えてください。" -#. Tag: programlisting -#: Websphere.xml:100 -#, fuzzy, no-c-format +#. Tag: para +#: Websphere.xml:117 +#, no-c-format msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local> \n" -" </ejb-local-ref>\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>\n" -"]]>" #. Tag: para -#: Websphere.xml:102 -#, fuzzy, no-c-format +#: Websphere.xml:120 +#, no-c-format msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -"<literal>EjbSynchronizations</literal> は Seam の組み込みEJB であって、ホテル" -"予約サンプルの一部ではないことにも注意してください。このことにより、アプリ" -"ケーションの <literal>components.xml</literal> の中で <literal>transaction:" -"ejb-transaction</literal> を指定すれば、web.xml の中に以下の設定を含めなけれ" -"ばならないことになります。" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>\n" -"]]>" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" -msgstr "web.xml の中で上記の設定を行わなければ、以下のエラーが発生します。" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" +msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" -msgstr "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "Use EJB references" +msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "resources/META-INF/persistence.xml" -msgstr "resources/META-INF/persistence.xml" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" +msgstr "" #. Tag: para -#: Websphere.xml:117 -#, fuzzy, no-c-format +#: Websphere.xml:138 +#, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -"このサンプルでは、Websphere のデフォルトのデータソースを使用します。そのた" -"め、<literal>jta-data-source</literal> 要素を変更します。" -#. Tag: programlisting -#: Websphere.xml:120 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -"]]>" #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -"Hibernate プロパティを設定する必要があります。まず最初に GlassFish プロパティ" -"をコメントアウトします。次に以下のプロパティを追加修正する必要があります。" #. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" +#: Websphere.xml:147 Websphere.xml:220 +#, fuzzy, no-c-format +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" "<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" +"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" +"\"true\"/>\n" " ]]>" #. Tag: para -#: Websphere.xml:130 -#, fuzzy, no-c-format +#: Websphere.xml:151 +#, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Websphere 6.X 用の標準 Hibernate トランザクションマネージャ" +#. Tag: programlisting +#: Websphere.xml:153 +#, no-c-format +msgid "" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" +msgstr "" + #. Tag: para -#: Websphere.xml:136 +#: Websphere.xml:157 #, fuzzy, no-c-format +msgid "At the end of <literal>web.xml</literal>, add the following lines:" +msgstr "<literal>build.xml</literal> ファイルの更新" + +#. Tag: programlisting +#: Websphere.xml:159 +#, fuzzy, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -"<literal>hibernate.transaction.flush_before_completion</literal> — コメ" -"ントアウトします。コンテナ管理トランザクションを使用するためです。これを " -"<literal>true</literal> に設定すると、EJBContext をルックアップした時に、" -"Websphere が例外をスローします。" +"<![CDATA[\n" +" <ejb-local-ref>\n" +" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>\n" +"]]>" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: para +#: Websphere.xml:164 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" #. Tag: para -#: Websphere.xml:148 -#, fuzzy, no-c-format +#: Websphere.xml:167 +#, no-c-format msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" -"<literal>hibernate.dialect</literal> — WebSphere 6.1.0.9 から組み込み " -"DB は、GlassFish と同じ Derby DB に変更されました。 " -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 -#, fuzzy, no-c-format -msgid "src/GlassfishDerbyDialect.java" -msgstr "resources/GlassfishDerbyDialect.class" +#. Tag: title +#: Websphere.xml:174 +#, no-c-format +msgid "Strategy 2: Override the default names generated by WebSphere" +msgstr "" +#. Tag: section +#: Websphere.xml:174 +#, no-c-format +msgid "" +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." +msgstr "" + #. Tag: para -#: Websphere.xml:161 -#, fuzzy, no-c-format +#: Websphere.xml:177 +#, no-c-format +msgid "To use this strategy:" +msgstr "" + +#. Tag: para +#: Websphere.xml:181 +#, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -"<literal>GlassfishDerbyDialect.class</literal> を入手して <literal>/" -"resources</literal> ディレクトリにコピーしなければなりません。このクラスは " -"JPA サンプルの中にあり、<literal>jee5/booking</literal> ディレクトリから以下" -"のコマンドを使用してコピーできます。" #. Tag: programlisting -#: Websphere.xml:169 +#: Websphere.xml:190 #, fuzzy, no-c-format -msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" "<![CDATA[\n" -"cp ../../jpa/resources-websphere61/WEB-INF/classes/GlassfishDerbyDialect." -"class\n" -" ./resources]]>" +"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" +"\"true\"/>\n" +" ]]>" #. Tag: para -#: Websphere.xml:170 -#, fuzzy, no-c-format +#: Websphere.xml:194 +#, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" -"後で説明するように、このクラスを <literal>jboss-seam-jee5.jar</literal> ファ" -"イルの中に入れるように、build.xml を変更しなければなりません。" -#. Tag: literal -#: Websphere.xml:175 -#, no-c-format -msgid "resources/import.sql" -msgstr "resources/import.sql" - #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:199 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -"Derby DB とダイアレクトのいずれも <literal>ID</literal> カラムの生成をサポー" -"トしないので、JPA サンプルからこのファイルをコピーしなければなりません。ファ" -"イルは、ID カラムの違い以外は同一です。以下のコマンドを使用してコピーしてく" -"ださい" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:201 #, fuzzy, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" "<![CDATA[\n" -"cp ../../jpa/resources-websphere61/import.sql ./resources]]>" +" <ejb-local-ref>\n" +" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>\n" +"]]>" +#. Tag: para +#: Websphere.xml:206 +#, no-c-format +msgid "" +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." +msgstr "" + #. Tag: title -#: Websphere.xml:194 +#: Websphere.xml:215 #, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "<literal>jee5/booking</literal> サンプルのビルド" +msgid "Strategy 3: Use EJB references" +msgstr "" -#. Tag: para -#: Websphere.xml:197 -#, fuzzy, no-c-format +#. Tag: section +#: Websphere.xml:215 +#, no-c-format msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -"アプリケーションに行った変更を有効にするには、<literal>build.xml</literal> を" -"変更する必要があります。アプリケーションを Websphere で動作させるためには、" -"jar を追加する必要があります。ここでは、 <literal>build.xml</literal> で必要" -"となる変更点を説明します。" -#. Tag: title -#: Websphere.xml:204 -#, fuzzy, no-c-format -msgid "Library dependency changes" -msgstr "Hibernate 依存関係を追加してください。" +#. Tag: listitem +#: Websphere.xml:218 +#, no-c-format +msgid "" +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" +msgstr "" #. Tag: para -#: Websphere.xml:205 -#, fuzzy, no-c-format +#: Websphere.xml:223 +#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" -"最後に、アプリケーションからのログ出力すべてが WebSphere のログに追加されるよ" -"うにするために、<literal>log4j.jar</literal> を削除します。log4j を完全に構成" -"するには追加の手順が必要ですが、それはこのドキュメントの範囲を越えます。" +#. Tag: para +#: Websphere.xml:228 +#, no-c-format +msgid "" +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" +msgstr "" + #. Tag: title -#: Websphere.xml:213 +#: Websphere.xml:239 #, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "<literal>build.xml</literal> ファイルの更新" +msgid "Configuring timeouts for Stateful Session Beans" +msgstr "" #. Tag: para -#: Websphere.xml:215 -#, fuzzy, no-c-format +#: Websphere.xml:240 +#, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -"以下のエントリを <literal>build.xml</literal> ファイルの最後に追加してくださ" -"い。これは、 <literal>jboss-seam-jee5.jar</literal> に含めるのに使用するデ" -"フォルトの fileset を再設定します。主な変更点は、 " -"<literal>GlassfishDerbyDialect.class</literal> の追加です。" #. Tag: programlisting -#: Websphere.xml:223 +#: Websphere.xml:246 #, fuzzy, no-c-format msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" "<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"GlassfishDerbyDialect.class\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>\n" -"]]>" +"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<web-app version=\"2.4\" \n" +" xmlns=\"http://java.sun.com/xml/ns/j2ee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/j2ee \n" +" http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" +"\">\n" +" ]]>" #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:248 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -"最後に残された作業は、 <literal>ant archive</literal> タスクを実行することで" -"す。アプリケーションは、<literal>jee5/booking/dist</literal> ディレクトリにビ" -"ルドされます。" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:257 #, no-c-format -msgid "Deploying the application to Websphere" -msgstr "Websphere へのアプリケーションのデプロイ" +msgid "The <literal>jee5/booking</literal> example" +msgstr "<literal>jee5/booking</literal> サンプル" #. Tag: para -#: Websphere.xml:236 -#, no-c-format +#: Websphere.xml:259 +#, fuzzy, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" -"必要なものはすべて所定の位置に揃いました。残されたことはデプロイすることです " -"- あとわずか数ステップの手順です。" +"<literal>jee5/booking</literal> サンプルは、(JBoss AS 上で動作する) ホテル予" +"約サンプルに基づいています。そのままで GlassFish 上で動作するように設計されて" +"いますが、以下の手順で Websphere 上でも動作させることができます。このサンプル" +"は <literal>$SEAM_DIST/examples/jee5/booking</literal> にあります。" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:265 #, no-c-format msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -"デプロイには、WebSphere の管理コンソールを使用します。従来どおり従われなけれ" -"ばならない手順とヒントがあります。" +#. Tag: title +#: Websphere.xml:271 +#, no-c-format +msgid "Building the <literal>jee5/booking</literal> example" +msgstr "<literal>jee5/booking</literal> サンプルのビルド" + #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:273 #, fuzzy, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Building it only requires running the correct ant command: " +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" +"ビルドに必要なことは、正しく ant コマンドを実行することです。 " +"<programlisting>ant websphere61</programlisting> これは、コンテナに対応した" +"アーカイブと、<literal>websphere61</literal> という名前の展開形式のディレクト" +"リアーカイブを作成します。" + +#. Tag: title +#: Websphere.xml:280 +#, fuzzy, no-c-format +msgid "Deploying the <literal>jee5/booking</literal> example" +msgstr "<literal>jee5/booking</literal> サンプルのビルド" + +#. Tag: para +#: Websphere.xml:281 +#, fuzzy, no-c-format +msgid "" +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." +msgstr "" "以下の手順は、上記で述べたバージョンの WebSphere での手順です。それ以外の環境" "では、わずかに異なるかもしれません。" -#. Tag: para -#: Websphere.xml:245 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" -#. Tag: programlisting -#: Websphere.xml:250 -#, fuzzy, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" -msgstr "" -"<![CDATA[\n" -"https://localhost:9043/ibm/console]]>" - #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:291 #, fuzzy, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " +"Go to the <literal>WebSphere enterprise applications</literal> menu option " "under the <literal>Applications --> Application Type</literal> left side " "menu." msgstr "" @@ -703,7 +669,7 @@ "literal> メニューオプションにアクセスしてください。" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:298 #, fuzzy, no-c-format msgid "" "At the top of the <literal>Enterprise Applications</literal> table select " @@ -715,76 +681,91 @@ "い。以下はインストールウィザードページの各々で、実行すべき手順です。" #. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#: Websphere.xml:304 #, no-c-format msgid "Preparing for the application installation" msgstr "アプリケーションのインストール準備" #. Tag: para -#: Websphere.xml:269 -#, no-c-format +#: Websphere.xml:307 +#, fuzzy, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" "ファイルアップロードのウィジェットを使用して、ブラウザで <literal>examples/" "jee5/booking/dist/jboss-seam-jee5.ear</literal> ファイルを指定してください。" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format msgid "Select the <literal>Next</literal> button." msgstr "<literal>Next</literal> ボタンを選択してください。" #. Tag: para -#: Websphere.xml:280 Websphere.xml:471 +#: Websphere.xml:318 #, fuzzy, no-c-format msgid "Select the <literal>Fast Path</literal> button." msgstr "<literal>Next</literal> ボタンを選択してください。" #. Tag: literal -#: Websphere.xml:292 +#: Websphere.xml:332 #, no-c-format msgid "Select installation options" msgstr "インストールオプションの選択" #. Tag: para -#: Websphere.xml:296 +#: Websphere.xml:335 #, fuzzy, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" "<literal>Deploy enterprise beans</literal> チェックボックスを選択してくださ" "い。アプリケーションのパッケージングに WebSphere ツールを使用していなければ、" "これが必要となります。" #. Tag: literal -#: Websphere.xml:313 +#: Websphere.xml:350 #, no-c-format msgid "Map modules to servers" msgstr "サーバへモジュールのマップ" #. Tag: para -#: Websphere.xml:317 -#, no-c-format +#: Websphere.xml:353 +#, fuzzy, no-c-format msgid "" "No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"literal>button." msgstr "" "一台のサーバで使用する限りでは変更は必要ありません。<literal>Next</literal> " "ボタンを選択してください。" #. Tag: literal -#: Websphere.xml:325 +#: Websphere.xml:362 +#, fuzzy, no-c-format +msgid "Map virtual hosts for Web modules" +msgstr "仮想ホストへの Web モジュールのマップ" + +#. Tag: para +#: Websphere.xml:365 +#, fuzzy, no-c-format +msgid "" +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." +msgstr "" +"一台のサーバで使用する限りでは変更は必要ありません。<literal>Next</literal> " +"ボタンを選択してください。" + +#. Tag: literal +#: Websphere.xml:374 #, no-c-format msgid "Summary" msgstr "Summary (要約)" #. Tag: para -#: Websphere.xml:328 +#: Websphere.xml:377 #, no-c-format msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" @@ -792,144 +773,163 @@ "さい。" #. Tag: literal -#: Websphere.xml:335 +#: Websphere.xml:384 #, no-c-format msgid "Installation" msgstr "Installation (インストール)" #. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." +#: Websphere.xml:387 +#, fuzzy, no-c-format +msgid "Now you will see WebSphere installing and deploying your application." msgstr "アプリケーションがインストールされてデプロイされます。" #. Tag: para -#: Websphere.xml:343 +#: Websphere.xml:390 #, fuzzy, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" "<literal>Save (保存)</literal> リンクを選択すると、<literal>Enterprise " "Applications (エンタープライズアプリケーション)</literal> テーブルに戻りま" "す。" #. Tag: para -#: Websphere.xml:355 -#, no-c-format +#: Websphere.xml:399 +#, fuzzy, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -"アプリケーションのインストールが完了しましたが、実行の前にいくつかの調整をす" -"る必要があります。" +"アプリケーションを開始するために <literal>Enterprise Applications (エンタープ" +"ライズアプリケーション)</literal> テーブルに戻って、リストの中からサンプルの" +"アプリケーションを選択してください。テーブルの先頭で <literal>Start</" +"literal> ボタンを選択してください。" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:409 +#, fuzzy, no-c-format +msgid "" +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" +msgstr "" +"<literal>http://localhost:9080/seam-jee5/</literal> からアプリケーションにア" +"クセスできます。" + +#. Tag: title +#: Websphere.xml:418 #, no-c-format +msgid "Deviation from the original base files" +msgstr "" + +#. Tag: section +#: Websphere.xml:418 +#, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" -"<literal>Enterprise Applications (エンタープライズアプリケーション)</" -"literal> テーブルで <literal>Seam Booking</literal> リンクを選択するところか" -"ら始めてください。" #. Tag: para -#: Websphere.xml:365 +#: Websphere.xml:422 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." -msgstr "<literal>Manage Modules</literal> リンクを選択してください。" +msgid "" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" +msgstr "" #. Tag: para -#: Websphere.xml:369 -#, fuzzy, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "<literal>jboss-seam-jee5.war</literal> リンクを選択してください。" - -#. Tag: para -#: Websphere.xml:374 -#, fuzzy, no-c-format +#: Websphere.xml:428 +#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -"<literal>Class loader order</literal> コンボボックスを <literal>Classes " -"loaded with application class loader first</literal> に変更してください。" #. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#: Websphere.xml:435 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" -"<literal>Apply (適用)</literal> を選択し、<literal>Save (保存)</literal> オプ" -"ションを選択してください。" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:441 #, fuzzy, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "<literal>Seam Booking</literal> ページに戻ります。" +msgid "" +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" +msgstr "" +"<literal>META-INF/persistence.xml</literal> — 必要な主な変更点は、デー" +"タソース JNDI の変更、トランザクションマネージャのルックアップクラスを " +"Websphere 6.1 トランザクションマネージャのルックアップクラスに変更、" +"Hibernate ダイアレクトを <literal>GlassFishDerbyDialect</literal> に変更する" +"ことです。" #. Tag: para -#: Websphere.xml:387 -#, no-c-format +#: Websphere.xml:451 +#, fuzzy, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -"このページで <literal>Class loading and update detection</literal> リンクを選" -"択してください。" +"<literal>WEB-INF/web.xml</literal> — 唯一の重要な変更点は、Websphere " +"6.1 が <literal>Servlet 2.4</literal> のみしかサポートしないために、ファイル" +"の先頭を変更することです。" #. Tag: para -#: Websphere.xml:392 +#: Websphere.xml:459 #, no-c-format msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" -"ラジオボタンで <literal>Classes loaded with application class loader first</" -"literal> を選択してください。" #. Tag: para -#: Websphere.xml:403 -#, no-c-format +#: Websphere.xml:467 Websphere.xml:549 +#, fuzzy, no-c-format msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" -"アプリケーションを開始するために <literal>Enterprise Applications (エンタープ" -"ライズアプリケーション)</literal> テーブルに戻って、リストの中からサンプルの" -"アプリケーションを選択してください。テーブルの先頭で <literal>Start</" -"literal> ボタンを選択してください。" +"<literal>import.sql</literal> — ダイアレクトと Derby DB のいずれでも " +"<literal>ID</literal> カラムは生成されないので、このファイルから削除されてい" +"ます。" #. Tag: para -#: Websphere.xml:410 -#, fuzzy, no-c-format +#: Websphere.xml:474 +#, no-c-format msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -"<literal>http://localhost:9080/seam-jee5/</literal> からアプリケーションにア" -"クセスできます。" #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:486 #, no-c-format msgid "The <literal>jpa</literal> booking example" msgstr "<literal>jpa</literal> booking サンプル" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:488 #, fuzzy, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" "幸いなことに <literal>jpa</literal> サンプルを動作させるのは、 " "<literal>jee5</literal> サンプルよりも簡単です。これはホテル予約サンプルを " @@ -937,33 +937,33 @@ "します。実行には EJB3 サポートを必要としません。" #. Tag: para -#: Websphere.xml:437 -#, no-c-format +#: Websphere.xml:493 +#, fuzzy, no-c-format msgid "" "The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"many of the common containers including WebSphere." msgstr "" "サンプルには、Websphere も含めた多くのコンテナ用の構成とビルドスクリプトが既" "に用意されています。" #. Tag: para -#: Websphere.xml:440 -#, no-c-format +#: Websphere.xml:498 +#, fuzzy, no-c-format msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " +"First thing, we are going to do is build and deploy that example. Then we'll " "go over some key changes that we needed." msgstr "" "最初に行うことは、サンプルのビルトとデプロイです。そのあとに必要な設定変更を" "行います。" #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:504 #, no-c-format msgid "Building the <literal>jpa</literal> example" msgstr "<literal>jpa</literal> サンプルのビルド" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:505 #, fuzzy, no-c-format msgid "" "Building it only requires running the correct ant command: " @@ -977,1279 +977,1530 @@ "リアーカイブを作成します。" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:514 #, no-c-format msgid "Deploying the <literal>jpa</literal> example" msgstr "<literal>jpa</literal> サンプルのデプロイ" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:515 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" -"これは <literal>jee5</literal> サンプルの <xref linkend=\"jee5-websphere-" -"deploy\"/> と類似していますが、多くの手順は必要ありません。" #. Tag: para -#: Websphere.xml:457 +#: Websphere.xml:521 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -"<literal>Enterprise Applications (エンタープライズアプリケーション)</" -"literal> テーブルから <literal>Install (インストール)</literal> ボタンを選択" -"してください。" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:528 #, fuzzy, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -"ファイルアップロードのウィジェットを使用して、ブラウザで <literal>examples/" -"jpa/dist-websphere61/jboss-seam-jpa.war</literal> ファイルを指定してくださ" -"い。" +"<literal>http://localhost:9080/jboss-seam-jpa/index.html</literal> からアプリ" +"ケーションにアクセスできます。" -#. Tag: para -#: Websphere.xml:483 +#. Tag: title +#: Websphere.xml:534 #, no-c-format -msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +msgid "Deviation from the generic base files" msgstr "" -"<literal>Next</literal> ボタンを選択して、3 ページ先まで進んでください。そこ" -"まで変更は必要ありません。" -#. Tag: literal -#: Websphere.xml:488 -#, fuzzy, no-c-format -msgid "Map context roots for Web modules" -msgstr "仮想ホストへの Web モジュールのマップ" - -#. Tag: para -#: Websphere.xml:491 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" -"<literal>Context root</literal> テキストボックスに <literal>jboss-seam-jpa</" -"literal>を入力してください。" #. Tag: para -#: Websphere.xml:502 -#, no-c-format -msgid "<literal>Summary</literal> page" -msgstr "<literal>Summary (要約)</literal> ページ" - -#. Tag: para -#: Websphere.xml:505 -#, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." -msgstr "" -"お望みなら設定を確認して、<literal>Finish (完了)</literal> ボタンを選択してア" -"プリケーションのインストールを完了してください。インストールが完了して " -"<literal> Save (保存)</literal> リンクを選択すると <literal>Enterprise " -"Applications (エンタープライズアプリケーション)</literal>テーブルに戻ります。" - -#. Tag: para -#: Websphere.xml:519 +#: Websphere.xml:539 #, fuzzy, no-c-format msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -"<literal>jee5</literal> サンプルについては、アプリケーションの実行に前にクラ" -"スローダを変更する必要があります。<xref linkend=\"websphere-app-adj-after-" -"install\"/> の手順に従ってください。但し、<literal>Seam Booking</literal> を" -"<literal>jboss-seam-jpa</literal> と置き換えて使用してください。" +"<literal>META-INF/persistence.xml</literal> — 必要な主な変更点は、デー" +"タソース JNDI の変更、トランザクションマネージャのルックアップクラスを " +"Websphere 6.1 トランザクションマネージャのルックアップクラスに変更、" +"Hibernate ダイアレクトを <literal>GlassFishDerbyDialect</literal> に変更する" +"ことです。" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:556 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -"最後にアプリケーションを開始するには、<literal>Enterprise Applications (エン" -"タープライズアプリケーション)</literal> テーブルでアプリケーションを選択して " -"<literal>Start (開始)</literal> ボタンをクリックしてください。" -#. Tag: para -#: Websphere.xml:532 -#, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." -msgstr "" -"<literal>http://localhost:9080/jboss-seam-jpa/index.html</literal> からアプリ" -"ケーションにアクセスできます。" +#, fuzzy +#~ msgid "Installation versions" +#~ msgstr "インストールするバージョンとヒント" -#. Tag: title -#: Websphere.xml:540 -#, fuzzy, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "Websphere 6.1 での変更点" +#, fuzzy +#~ msgid "" +#~ "All of the examples and information in this chapter are based on the " +#~ "version V7 of Websphere AS at the time of this writing." +#~ msgstr "" +#~ "この章のサンプルと情報は、すべて執筆時の Websphere のバージョン 6.1 に基づ" +#~ "いています。" -#. Tag: para -#: Websphere.xml:541 -#, fuzzy, no-c-format -msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." -msgstr "" -"JBoss 4.2 と Websphere 6.1 にデプロイされる JPA サンプルの相違点は、多くがラ" -"イブラリと構成ファイルです。" +#, fuzzy +#~ msgid "Websphere Application Server V7" +#~ msgstr "Websphere Application Server 6.1" -#. Tag: para -#: Websphere.xml:546 -#, no-c-format -msgid "<para>Configuration file changes</para>" -msgstr "<para>構成ファイルの変更</para>" +#~ msgid "<title>Configuration file changes</title>" +#~ msgstr "<title>構成ファイルの変更</title>" -#. Tag: para -#: Websphere.xml:549 -#, fuzzy, no-c-format -msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." -msgstr "" -"<literal>META-INF/persistence.xml</literal> — 必要な主な変更点は、デー" -"タソース JNDI の変更、トランザクションマネージャのルックアップクラスを " -"Websphere 6.1 トランザクションマネージャのルックアップクラスに変更、" -"Hibernate ダイアレクトを <literal>GlassFishDerbyDialect</literal> に変更する" -"ことです。" +#~ msgid "" +#~ "Below are the configuration file changes that are need to the base " +#~ "example." +#~ msgstr "" +#~ "雛形のサンプルに対して必要となる構成ファイルの変更点は以下の通りです。" -#. Tag: para -#: Websphere.xml:559 -#, fuzzy, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." -msgstr "" -"<literal>WEB-INF/web.xml</literal> — 唯一の重要な変更点は、Websphere " -"6.1 が <literal>Servlet 2.4</literal> のみしかサポートしないために、ファイル" -"の先頭を変更することです。" +#~ msgid "resources/WEB-INF/components.xml" +#~ msgstr "resources/WEB-INF/components.xml" -#. Tag: para -#: Websphere.xml:565 -#, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." -msgstr "" +#, fuzzy +#~ msgid "" +#~ "We need to change the way that we look up EJBs for WAS. We need to remove " +#~ "the <literal>/local</literal> from the end of the <literal>jndi-pattern</" +#~ "literal> attribute. It should look like this:" +#~ msgstr "" +#~ "WebSphere では EJB をルックアップする際の名前を変更する必要があります。" +#~ "<literal>jndi-pattern</literal> 属性の最後から <literal>/local</literal> " +#~ "を取り除く必要があります。以下のように変更します。" -#. Tag: para -#: Websphere.xml:572 -#, fuzzy, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" -"<literal>WEB-INF/classes/GlassFishDerbyDialect.class</literal> — このク" -"ラスは、Hibernate ダイアレクトを <literal>GlassFishDerbyDialect</literal> に" -"変更するのに必要です。" +#, fuzzy +#~ msgid "resources/META-INF/ejb-jar.xml" +#~ msgstr "resources/META-INF/jboss-app.xml" -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" -"<literal>import.sql</literal> — ダイアレクトと Derby DB のいずれでも " -"<literal>ID</literal> カラムは生成されないので、このファイルから削除されてい" -"ます。" +#~ msgid "resources/WEB-INF/web.xml" +#~ msgstr "resources/WEB-INF/web.xml" -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "依存ライブラリの変更" +#, fuzzy +#~ msgid "" +#~ "We have to make some changes to the EJB references in the <literal>web." +#~ "xml</literal>. These changes are what will allow WAS to bind " +#~ "automatically the EJB3 references in the web module to the the actual " +#~ "EJB3 beans in the EAR module. Replace all of the /local strings in " +#~ "<literal>ejb-local-refs</literal> when the values below." +#~ msgstr "" +#~ "次に、<literal>web.xml</literal> の EJB 参照について変更を行う必要があり" +#~ "ます。これらは、WebSphere が Web モジュール内の EJB2 参照を、実際には EAR " +#~ "モジュール内にある EJB3 の Bean にバインドすることを可能にするための変更で" +#~ "す。すべての <literal>ejb-local-refs</literal> を以下の値で置き換えてくだ" +#~ "さい。" -#. Tag: para -#: Websphere.xml:590 -#, fuzzy, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" -"<literal>WEB-INF/lib</literal> — Websphere には、JBoss AS に含まれてい" -"たライブラリのうちでないものがあるので、いくつかのライブラリパッケージが必要" -"となります。これらは、主に Hibernate や JSF-RI サポートのためのライブラリとそ" -"の依存ライブラリです。以下は、JBoss <literal>JPA</literal> サンプルに必要な追" -"加の jar のリストです。" +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.Authenticator</local>\n" +#~ " </ejb-local-ref> \n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.BookingList</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.Register</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.ChangePassword</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.HotelBooking</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.HotelSearching</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +#~ " </ejb-local-ref>]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local-home></local-home>\n" +#~ " <local>org.jboss.seam.example.booking.Authenticator</local>\n" +#~ " </ejb-local-ref>\n" +#~ " \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local-home></local-home>\n" +#~ " <local>org.jboss.seam.example.booking.BookingList</local>\n" +#~ " </ejb-local-ref>\n" +#~ " \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local-home></local-home>\n" +#~ " <local>org.jboss.seam.example.booking.Register</local>\n" +#~ " </ejb-local-ref>\n" +#~ " \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local-home></local-home>\n" +#~ " <local>org.jboss.seam.example.booking.ChangePassword</local>\n" +#~ " </ejb-local-ref>\n" +#~ " \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local-home></local-home>\n" +#~ " <local>org.jboss.seam.example.booking.HotelBooking</local>\n" +#~ " </ejb-local-ref>\n" +#~ " \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local-home></local-home>\n" +#~ " <local>org.jboss.seam.example.booking.HotelSearching</local> \n" +#~ " </ejb-local-ref>\n" +#~ " \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local-home></local-home>\n" +#~ " <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +#~ " </ejb-local-ref>\n" +#~ "]]>" -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" -"Hibernate を JPA provider プロバイダとして使用するためには、以下の jar が必要" -"です。" +#, fuzzy +#~ msgid "" +#~ "Note also that <literal>EjbSynchronizations</literal> is a built-in Seam " +#~ "EJB and not part of the Hotel Booking example. This means that if your " +#~ "application's <literal>components.xml</literal> specifies " +#~ "<literal>transaction:ejb-transaction</literal>, then you must include:" +#~ msgstr "" +#~ "<literal>EjbSynchronizations</literal> は Seam の組み込みEJB であって、ホ" +#~ "テル予約サンプルの一部ではないことにも注意してください。このことにより、ア" +#~ "プリケーションの <literal>components.xml</literal> の中で " +#~ "<literal>transaction:ejb-transaction</literal> を指定すれば、web.xml の中" +#~ "に以下の設定を含めなければならないことになります。" -#. Tag: literal -#: Websphere.xml:602 -#, no-c-format -msgid "hibernate.jar" -msgstr "hibernate.jar" +#~ msgid "" +#~ "in your web.xml. If you don't include it, you'll get the following error:" +#~ msgstr "web.xml の中で上記の設定を行わなければ、以下のエラーが発生します。" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "hibernate-annotations.jar" +#~ msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +#~ msgstr "Name comp/env/myapp/EjbSynchronizations not found in context java:" -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "hibernate-commons-annotations.jar" +#~ msgid "resources/META-INF/persistence.xml" +#~ msgstr "resources/META-INF/persistence.xml" -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "hibernate-entitymanager.jar" +#, fuzzy +#~ msgid "" +#~ "For this example we will be using the default datasource that comes with " +#~ "WAS. To do this change the <literal>jta-data-source</literal> element:" +#~ msgstr "" +#~ "このサンプルでは、Websphere のデフォルトのデータソースを使用します。そのた" +#~ "め、<literal>jta-data-source</literal> 要素を変更します。" -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "hibernate-validator.jar" +#~ msgid "" +#~ "<![CDATA[\n" +#~ "<jta-data-source>DefaultDatasource</jta-data-source>\n" +#~ " ]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "<jta-data-source>DefaultDatasource</jta-data-source>\n" +#~ "]]>" -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "commons-collections.jar" +#~ msgid "" +#~ "Then we need to adjust some of the hibernate properties. First comment " +#~ "out the Glassfish properties. Next you need to add/change the properties:" +#~ msgstr "" +#~ "Hibernate プロパティを設定する必要があります。まず最初に GlassFish プロパ" +#~ "ティをコメントアウトします。次に以下のプロパティを追加修正する必要がありま" +#~ "す。" -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "jboss-common-core.jar" +#~ msgid "" +#~ "<![CDATA[\n" +#~ "\n" +#~ "<property name=\"hibernate.cache.provider_class\" \n" +#~ " value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" +#~ "<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" +#~ "<property name=\"hibernate.transaction.manager_lookup_class\" \n" +#~ " value=\"org.hibernate.transaction." +#~ "WebSphereExtendedJTATransactionLookup\"/>\n" +#~ " ]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "\n" +#~ "<property name=\"hibernate.cache.provider_class\" \n" +#~ " value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" +#~ "<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" +#~ "<property name=\"hibernate.transaction.manager_lookup_class\" \n" +#~ " value=\"org.hibernate.transaction." +#~ "WebSphereExtendedJTATransactionLookup\"/>\n" +#~ " ]]>" -#. Tag: para -#: Websphere.xml:638 -#, no-c-format -msgid "Various third party jars that Websphere needs:" -msgstr "WebSphere が必要とするさまざまなサードパーティ jar。" +#, fuzzy +#~ msgid "" +#~ "<literal>hibernate.transaction.manager_lookup_class</literal> — " +#~ "Standard Hibernate transaction manager property for WAS 6.X and 7" +#~ msgstr "" +#~ "<literal>hibernate.transaction.manager_lookup_class</literal> — " +#~ "Websphere 6.X 用の標準 Hibernate トランザクションマネージャ" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "antlr.jar" +#, fuzzy +#~ msgid "" +#~ "<literal>hibernate.transaction.flush_before_completion</literal> — " +#~ "This is commented out because we want the container to manage the " +#~ "transactions. Also if this is set to <literal>true</literal> an exception " +#~ "will be thrown by WAS when the EJBContext is looked up." +#~ msgstr "" +#~ "<literal>hibernate.transaction.flush_before_completion</literal> — " +#~ "コメントアウトします。コンテナ管理トランザクションを使用するためです。これ" +#~ "を <literal>true</literal> に設定すると、EJBContext をルックアップした時" +#~ "に、Websphere が例外をスローします。" -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "cglib.jar" +#~ msgid "" +#~ "<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" +#~ " EJBContext may only be looked up by or injected into an " +#~ "EJB]]>" +#~ msgstr "" +#~ "<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" +#~ " EJBContext may only be looked up by or injected into an " +#~ "EJB]]>" -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "asm.jar" +#, fuzzy +#~ msgid "" +#~ "<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " +#~ "embedded DB was switched to the same Derby DB as is in Glassfish v2." +#~ msgstr "" +#~ "<literal>hibernate.dialect</literal> — WebSphere 6.1.0.9 から組み込" +#~ "み DB は、GlassFish と同じ Derby DB に変更されました。 " -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "dom4j.jar" +#, fuzzy +#~ msgid "src/GlassfishDerbyDialect.java" +#~ msgstr "resources/GlassfishDerbyDialect.class" -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "javassist.jar" +#, fuzzy +#~ msgid "" +#~ "You will need to get the <literal>GlassfishDerbyDialect.java</literal> " +#~ "and copy it into the <literal>/src</literal> directory. The java class " +#~ "exists in the JPA example source directory and can be copied using the " +#~ "command below assuming you are in <literal>jee5/booking</literal> " +#~ "directory:" +#~ msgstr "" +#~ "<literal>GlassfishDerbyDialect.class</literal> を入手して <literal>/" +#~ "resources</literal> ディレクトリにコピーしなければなりません。このクラス" +#~ "は JPA サンプルの中にあり、<literal>jee5/booking</literal> ディレクトリか" +#~ "ら以下のコマンドを使用してコピーできます。" -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "concurrent.jar" +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "cp ../../jpa/src/GlassfishDerbyDialect.java\n" +#~ " ./src]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "cp ../../jpa/resources-websphere61/WEB-INF/classes/GlassfishDerbyDialect." +#~ "class\n" +#~ " ./resources]]>" -#. Tag: title -#: Websphere.xml:678 -#, fuzzy, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" -"<literal>seam-gen</literal> により生成されたアプリケーションの Websphere " -"6.1.0.13 へのデプロイ" +#, fuzzy +#~ msgid "" +#~ "This class will be put into the <literal>jboss-seam-jee5.jar</literal> " +#~ "file." +#~ msgstr "" +#~ "後で説明するように、このクラスを <literal>jboss-seam-jee5.jar</literal> " +#~ "ファイルの中に入れるように、build.xml を変更しなければなりません。" -#. Tag: para -#: Websphere.xml:681 -#, no-c-format -msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." -msgstr "" -"<literal>seam-gen</literal> は、開発者が素早くアプリケーションを準備して動作" -"させるのにとても役に立つツールで、独自の機能を追加するための雛形を用意しま" -"す。<literal>seam-gen</literal> はそのままで JBoss AS で動作するように構成さ" -"れたアプリケーションを生成します。以下の手順では、Websphere 上で動作させるた" -"めに必要なステップを示します。<xref linkend=\"jee5-websphere-section\"/> で述" -"べたように、EJB3 アプリケーションを動作させるには変更が必要です。このセクショ" -"ンでは、その正確な手順を示します。" +#~ msgid "resources/import.sql" +#~ msgstr "resources/import.sql" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "<literal>seam-gen</literal> セットアップの実行" +#~ msgid "" +#~ "This file must also be copied from the JPA example because either the " +#~ "Derby DB or the dialect does not support changes to the <literal>ID</" +#~ "literal> column. The files are identical except for the column " +#~ "difference. Use the following command to make the copy" +#~ msgstr "" +#~ "Derby DB とダイアレクトのいずれも <literal>ID</literal> カラムの生成をサ" +#~ "ポートしないので、JPA サンプルからこのファイルをコピーしなければなりませ" +#~ "ん。ファイルは、ID カラムの違い以外は同一です。以下のコマンドを使用してコ" +#~ "ピーしてください" -#. Tag: para -#: Websphere.xml:692 -#, no-c-format -msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." -msgstr "" -"第一ステップは、雛形となるプロジェクトを生成できるように <literal>seam-gen</" -"literal> をセットアップすることです。以下に実行したように、設定すべき項目がい" -"くつかあります。特に、データソースと Hibernate の設定値は、プロジェクトを生成" -"する環境に合わせて設定します。" +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "cp ../../jpa/resources-websphere61/import.sql ./resources]]>" -#. Tag: programlisting -#: Websphere.xml:698 -#, fuzzy, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_0/jboss-seam-2_0/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" +#, fuzzy +#~ msgid "" +#~ "In order to get the changes we have made into our application we need to " +#~ "make some changes to the <literal>build.xml</literal>. There are also " +#~ "some additional jars that are required by our application in order to " +#~ "work with WAS. This section will cover what changes are needed to the " +#~ "<literal>build.xml</literal>." +#~ msgstr "" +#~ "アプリケーションに行った変更を有効にするには、<literal>build.xml</" +#~ "literal> を変更する必要があります。アプリケーションを Websphere で動作させ" +#~ "るためには、jar を追加する必要があります。ここでは、 <literal>build.xml</" +#~ "literal> で必要となる変更点を説明します。" -#. Tag: para -#: Websphere.xml:700 -#, no-c-format -msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." -msgstr "" -"プロジェクトを作成するためには、<literal>$ ./seam new-project</literal> と入" -"力してください。そして <literal>cd /home/jbalunas/workspace/" -"websphere_example</literal> と入力して新しく作成されたディレクトリへ移動して" -"ください。" +#, fuzzy +#~ msgid "Library dependency changes" +#~ msgstr "Hibernate 依存関係を追加してください。" -#. Tag: title -#: Websphere.xml:707 -#, no-c-format -msgid "Changes needed for deployment to Websphere" -msgstr "Websphere へのデプロイに必要な変更点" +#, fuzzy +#~ msgid "" +#~ "We remove the <literal>log4j.jar</literal> so that all of the log output " +#~ "from our application will be added to the WAS log. Additional steps are " +#~ "required to fully configure log4j and those are outside of the scope of " +#~ "this document." +#~ msgstr "" +#~ "最後に、アプリケーションからのログ出力すべてが WebSphere のログに追加され" +#~ "るようにするために、<literal>log4j.jar</literal> を削除します。log4j を完" +#~ "全に構成するには追加の手順が必要ですが、それはこのドキュメントの範囲を越え" +#~ "ます。" -#. Tag: para -#: Websphere.xml:708 -#, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "生成されたプロジェクトに変更を行う必要があります。" +#, fuzzy +#~ msgid "" +#~ "Add the following entry to the bottom of the <literal>build.xml</literal> " +#~ "file. This overrides the default fileset that is used to populate the " +#~ "<literal>jboss-seam-jee5.jar</literal>. :" +#~ msgstr "" +#~ "以下のエントリを <literal>build.xml</literal> ファイルの最後に追加してくだ" +#~ "さい。これは、 <literal>jboss-seam-jee5.jar</literal> に含めるのに使用する" +#~ "デフォルトの fileset を再設定します。主な変更点は、 " +#~ "<literal>GlassfishDerbyDialect.class</literal> の追加です。" -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "resources/META-INF/persistence-dev.xml" +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ " <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" +#~ " <include name=\"import.sql\" />\n" +#~ " <include name=\"seam.properties\" />\n" +#~ " <include name=\"META-INF/persistence.xml\" />\n" +#~ " <include name=\"META-INF/ejb-jar.xml\" />\n" +#~ " </fileset>]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ " <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" +#~ " <include name=\"import.sql\" />\n" +#~ " <include name=\"seam.properties\" />\n" +#~ " <include name=\"GlassfishDerbyDialect.class\" />\n" +#~ " <include name=\"META-INF/persistence.xml\" />\n" +#~ " <include name=\"META-INF/ejb-jar.xml\" />\n" +#~ " </fileset>\n" +#~ "]]>" -#. Tag: para -#: Websphere.xml:719 -#, no-c-format -msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." -msgstr "" -"<literal>jta-data-source</literal> を <literal>DefaultDatasource</literal> に" -"修正してください。組み込みの Websphere DB を使用します。" +#~ msgid "" +#~ "Now all that is left is to execute the <literal>ant archive</literal> " +#~ "task and the built application will be in the <literal>jee5/booking/dist</" +#~ "literal> directory." +#~ msgstr "" +#~ "最後に残された作業は、 <literal>ant archive</literal> タスクを実行すること" +#~ "です。アプリケーションは、<literal>jee5/booking/dist</literal> ディレクト" +#~ "リにビルドされます。" -#. Tag: para -#: Websphere.xml:726 -#, no-c-format -msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" -msgstr "" -"以下のプロパティを追加修正してください。<xref linkend=\"jee5-websphere-" -"section\"/> に詳細が説明されています。" +#~ msgid "Deploying the application to Websphere" +#~ msgstr "Websphere へのアプリケーションのデプロイ" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" +#~ msgid "" +#~ "So now we have everything we need in place. All that is left is to deploy " +#~ "it - just a few steps more." +#~ msgstr "" +#~ "必要なものはすべて所定の位置に揃いました。残されたことはデプロイすることで" +#~ "す - あとわずか数ステップの手順です。" -#. Tag: para -#: Websphere.xml:734 -#, no-c-format -msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" -msgstr "" -"EntityManagerFactory を定義する JBoss AS 固有のメソッドを取り除いてください。" +#~ msgid "" +#~ "For this we will use Websphere's administration console. As before there " +#~ "are some tricks and tips that must be followed." +#~ msgstr "" +#~ "デプロイには、WebSphere の管理コンソールを使用します。従来どおり従われなけ" +#~ "ればならない手順とヒントがあります。" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">\n" -"]]>" +#, fuzzy +#~ msgid "<![CDATA[http://localhost:9060/admin]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "https://localhost:9043/ibm/console]]>" -#. Tag: para -#: Websphere.xml:740 -#, no-c-format -msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." -msgstr "" -"prod プロファイルを使用して Websphere にデプロイしたければ、" -"<literal>persistence-prod.xml</literal> も同様に修正する必要があります。" +#~ msgid "" +#~ "Now that we have our application installed we need to make some " +#~ "adjustments to it before we can start it:" +#~ msgstr "" +#~ "アプリケーションのインストールが完了しましたが、実行の前にいくつかの調整を" +#~ "する必要があります。" -#. Tag: para -#: Websphere.xml:753 -#, fuzzy, no-c-format -msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." -msgstr "" -"他のサンプルと同様に、データベースサポートのためのこのクラスを含める必要があ" -"ります。<literal>jpa</literal> サンプルから <literal>websphere_example/" -"resources</literal> ディレクトリへコピーしてください。" +#~ msgid "" +#~ "Starting from the <literal>Enterprise Applications</literal> table select " +#~ "the <literal>Seam Booking</literal> link." +#~ msgstr "" +#~ "<literal>Enterprise Applications (エンタープライズアプリケーション)</" +#~ "literal> テーブルで <literal>Seam Booking</literal> リンクを選択するところ" +#~ "から始めてください。" -#. Tag: programlisting -#: Websphere.xml:759 -#, fuzzy, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/resources-websphere61/WEB-INF/classes/" -"GlassfishDerbyDialect.class\n" -" ./resources]]>" +#~ msgid "Select the <literal>Manage Modules</literal> link." +#~ msgstr "<literal>Manage Modules</literal> リンクを選択してください。" -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "resources/META-INF/jboss-app.xml" +#, fuzzy +#~ msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." +#~ msgstr "<literal>jboss-seam-jee5.war</literal> リンクを選択してください。" -#. Tag: para -#: Websphere.xml:768 -#, no-c-format -msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" -msgstr "" -"JBoss AS にはデプロイしないのでこのファイルを削除できます (JBoss AS では " -"<literal>jboss-app.xml</literal> を使用して、クラスローディングの分離を有効に" -"します)" +#, fuzzy +#~ msgid "" +#~ "Change the <literal>Class loader order</literal> combo box to " +#~ "<literal>Classes loaded with application class loader first (parent last)" +#~ "</literal>." +#~ msgstr "" +#~ "<literal>Class loader order</literal> コンボボックスを <literal>Classes " +#~ "loaded with application class loader first</literal> に変更してください。" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "resources/*-ds.xml" +#~ msgid "" +#~ "Select <literal>Apply</literal> and then <literal>Save</literal> options." +#~ msgstr "" +#~ "<literal>Apply (適用)</literal> を選択し、<literal>Save (保存)</literal> " +#~ "オプションを選択してください。" -#. Tag: para -#: Websphere.xml:777 -#, no-c-format -msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" -msgstr "" -"JBoss AS にはデプロイしないのでこのファイルを削除できます (これらのファイル" -"は、JBoss AS ではデータソースを定義していますが、Websphere ではデフォルトの" -"データソースを使用しています)" +#, fuzzy +#~ msgid "Return to the <literal>Seam Booking</literal> page." +#~ msgstr "<literal>Seam Booking</literal> ページに戻ります。" -#. Tag: para -#: Websphere.xml:789 -#, no-c-format -msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" -msgstr "" -"コンテナ管理トランザクション統合を有効にします - <literal> <transaction:" -"ejb-transaction /> </literal> コンポーネントと、その名前空間宣言 " -"<literal>xmlns:transaction=\"http://jboss.com/products/seam/transaction\"</" -"literal> を追記してください" +#~ msgid "" +#~ "On this page select the <literal>Class loading and update detection</" +#~ "literal> link." +#~ msgstr "" +#~ "このページで <literal>Class loading and update detection</literal> リンク" +#~ "を選択してください。" -#. Tag: para -#: Websphere.xml:798 -#, no-c-format -msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" -msgstr "" -"<literal>jndi-pattern</literal> を <literal>java:comp/env/websphere_example/#" -"{ejbName}</literal> に修正します" +#~ msgid "" +#~ "Select the radio button for <literal>Classes loaded with application " +#~ "class loader first</literal>." +#~ msgstr "" +#~ "ラジオボタンで <literal>Classes loaded with application class loader " +#~ "first</literal> を選択してください。" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" -"このサンプルでは、<literal>managed-persistence-context</literal> は必要ではな" -"いので、そのエントリは削除します。" +#~ msgid "" +#~ "This is similar to the <literal>jee5</literal> example at <xref linkend=" +#~ "\"jee5-websphere-deploy\"/>, but without so many steps." +#~ msgstr "" +#~ "これは <literal>jee5</literal> サンプルの <xref linkend=\"jee5-websphere-" +#~ "deploy\"/> と類似していますが、多くの手順は必要ありません。" -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" +#~ msgid "" +#~ "From the <literal>Enterprise Applications</literal> table select the " +#~ "<literal>Install</literal> button." +#~ msgstr "" +#~ "<literal>Enterprise Applications (エンタープライズアプリケーション)</" +#~ "literal> テーブルから <literal>Install (インストール)</literal> ボタンを選" +#~ "択してください。" -#. Tag: para -#: Websphere.xml:819 -#, fuzzy, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" -"<literal>jee5/booking</literal> サンプルと同様に、web.xml に EJB 参照を加える" -"必要があります。これらの EJB 参照には、Websphere が適切なバインディングを実行" -"するために空の <literal>local-home</literal> を設定することが必要となります。" +#, fuzzy +#~ msgid "" +#~ "Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +#~ "literal> file using the file upload widget." +#~ msgstr "" +#~ "ファイルアップロードのウィジェットを使用して、ブラウザで " +#~ "<literal>examples/jpa/dist-websphere61/jboss-seam-jpa.war</literal> ファイ" +#~ "ルを指定してください。" -#. Tag: programlisting -#: Websphere.xml:826 -#, fuzzy, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref>\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>\n" -"]]>" +#~ msgid "" +#~ "Select the <literal>Next</literal> button for the next three pages, no " +#~ "changes are needed." +#~ msgstr "" +#~ "<literal>Next</literal> ボタンを選択して、3 ページ先まで進んでください。そ" +#~ "こまで変更は必要ありません。" -#. Tag: title -#: Websphere.xml:832 -#, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" -msgstr "<literal>AuthenticatorAction</literal> EJB の作成" +#~ msgid "" +#~ "In the <literal>Context root</literal> text box enter <literal>jboss-seam-" +#~ "jpa</literal>." +#~ msgstr "" +#~ "<literal>Context root</literal> テキストボックスに <literal>jboss-seam-" +#~ "jpa</literal>を入力してください。" -#. Tag: para -#: Websphere.xml:834 -#, no-c-format -msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." -msgstr "" -"既存の <literal>Authenticator</literal> Seam POJO コンポーネントを利用して、" -"EJB3 を作成します。" +#~ msgid "<literal>Summary</literal> page" +#~ msgstr "<literal>Summary (要約)</literal> ページ" -#. Tag: para -#: Websphere.xml:837 -#, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" +#~ msgid "" +#~ "Review the settings if you wish and select the <literal>Finish</literal> " +#~ "button to install the application. When installation finished select the " +#~ "<literal> Save</literal> link and you will be returned to the " +#~ "<literal>Enterprise Applications</literal> table." +#~ msgstr "" +#~ "お望みなら設定を確認して、<literal>Finish (完了)</literal> ボタンを選択し" +#~ "てアプリケーションのインストールを完了してください。インストールが完了し" +#~ "て <literal> Save (保存)</literal> リンクを選択すると <literal>Enterprise " +#~ "Applications (エンタープライズアプリケーション)</literal>テーブルに戻りま" +#~ "す。" -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "クラス名を <literal>AuthenticatorAction</literal> に変更します" +#, fuzzy +#~ msgid "" +#~ "As with the <literal>jee5</literal> example there are some class loader " +#~ "changes needed before we start the application. Follow the instructions " +#~ "at <xref linkend=\"websphere-app-adj-after-install\"/> but exchange " +#~ "<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +#~ msgstr "" +#~ "<literal>jee5</literal> サンプルについては、アプリケーションの実行に前にク" +#~ "ラスローダを変更する必要があります。<xref linkend=\"websphere-app-adj-" +#~ "after-install\"/> の手順に従ってください。但し、<literal>Seam Booking</" +#~ "literal> を<literal>jboss-seam-jpa</literal> と置き換えて使用してくださ" +#~ "い。" -#. Tag: para -#: Websphere.xml:844 -#, no-c-format -msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." -msgstr "" -"<literal>@Stateless</literal> アノテーションを新しい " -"<literal>AuthenticatorAction</literal> クラスに付与します。" +#~ msgid "" +#~ "Finally start the application by selecting it in the <literal>Enterprise " +#~ "Applications</literal> table and clicking the <literal>Start</literal> " +#~ "button." +#~ msgstr "" +#~ "最後にアプリケーションを開始するには、<literal>Enterprise Applications (エ" +#~ "ンタープライズアプリケーション)</literal> テーブルでアプリケーションを選択" +#~ "して <literal>Start (開始)</literal> ボタンをクリックしてください。" -#. Tag: para -#: Websphere.xml:850 -#, no-c-format -msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." -msgstr "" -"<literal>AuthenticatorAction</literal> が実装する <literal>Authenticator</" -"literal> という名前のインタフェースを作成してください (EJB3 ではセッション " -"Bean にローカルインタフェースが必要)。インタフェースに <literal>@Local</" -"literal> アノテーションを付与し、<literal>AuthenticatorAction</literal> の " -"<literal>authenticate</literal> と同じシグニチャのメソッドを一つ追加してくだ" -"さい。" +#, fuzzy +#~ msgid "What's different for Websphere AS V7" +#~ msgstr "Websphere 6.1 での変更点" -#. Tag: programlisting -#: Websphere.xml:863 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" -msgstr "" -"<![CDATA[\n" -"@Name(\"authenticator\")\n" -"@Stateless\n" -"public class AuthenticatorAction implements Authenticator {]]>" +#, fuzzy +#~ msgid "" +#~ "The differences between the JPA examples that deploys to JBoss 4.2 and " +#~ "Websphere AS V7 are mostly expected; library and configuration file " +#~ "changes." +#~ msgstr "" +#~ "JBoss 4.2 と Websphere 6.1 にデプロイされる JPA サンプルの相違点は、多くが" +#~ "ライブラリと構成ファイルです。" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" -"<![CDATA[\n" -"@Local\n" -"public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" +#~ msgid "<para>Configuration file changes</para>" +#~ msgstr "<para>構成ファイルの変更</para>" -#. Tag: para -#: Websphere.xml:869 -#, no-c-format -msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." -msgstr "" -"すでに <literal>web.xml</literal> ファイルには EJB 参照を追加したので、次に進" -"めます。" +#, fuzzy +#~ msgid "" +#~ "<literal>src/GlassfishDerbyDialect.java </literal> — this class is " +#~ "needed for the hibernate dialect change to " +#~ "<literal>GlassfishDerbyDialect</literal>" +#~ msgstr "" +#~ "<literal>WEB-INF/classes/GlassFishDerbyDialect.class</literal> — こ" +#~ "のクラスは、Hibernate ダイアレクトを <literal>GlassFishDerbyDialect</" +#~ "literal> に変更するのに必要です。" -#. Tag: title -#: Websphere.xml:875 -#, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" -msgstr "<literal>build.xml</literal> への jar 依存関係の追加とその他の変更点" +#~ msgid "Changes for dependent libraries" +#~ msgstr "依存ライブラリの変更" -#. Tag: para -#: Websphere.xml:877 -#, no-c-format -msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." -msgstr "" -"このアプリケーションは、<literal>jee5/booking</literal> サンプルと同様の変更" -"が必要となります。" +#, fuzzy +#~ msgid "" +#~ "The Websphere version requires several library packages because they are " +#~ "not included as they are with JBoss AS. These are primarily for hibernate " +#~ "and their dependencies. Below are listed only the additional jars needed " +#~ "above and beyond the JBoss <literal>JPA</literal> example." +#~ msgstr "" +#~ "<literal>WEB-INF/lib</literal> — Websphere には、JBoss AS に含まれて" +#~ "いたライブラリのうちでないものがあるので、いくつかのライブラリパッケージが" +#~ "必要となります。これらは、主に Hibernate や JSF-RI サポートのためのライブ" +#~ "ラリとその依存ライブラリです。以下は、JBoss <literal>JPA</literal> サンプ" +#~ "ルに必要な追加の jar のリストです。" -#. Tag: para -#: Websphere.xml:882 -#, no-c-format -msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." -msgstr "" -"デフォルトのターゲットを <literal>archive</literal> に変更します (Websphere " -"への自動的なデプロイを行いません)。" +#~ msgid "To use Hibernate as your JPA provider you need the following jars:" +#~ msgstr "" +#~ "Hibernate を JPA provider プロバイダとして使用するためには、以下の jar が" +#~ "必要です。" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">\n" -"]]>" +#~ msgid "hibernate.jar" +#~ msgstr "hibernate.jar" -#. Tag: para -#: Websphere.xml:892 -#, no-c-format -msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." -msgstr "" -"Websphere は、<literal>websphere_example.jar</literal> のルートではなく " -"<literal>war</literal> ファイルのルートで drools の <literal>/security.drl</" -"literal> ファイルを探すので、ビルド時には正しい場所へ移動させるように " -"<literal>build.xml</literal> に設定する必要があります。以下の変更は、" -"<literal> <target name=\"war\" depends=\"compile\" description=\"Build " -"the distribution .war file\"> </literal> ターゲットの先頭に追加しなければ" -"なりません。" +#~ msgid "hibernate-annotations.jar" +#~ msgstr "hibernate-annotations.jar" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>\n" -"]]>" +#~ msgid "hibernate-commons-annotations.jar" +#~ msgstr "hibernate-commons-annotations.jar" -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" -"追加の jar を <literal>build.xml</literal> に入れる必要があります。以下のタス" -"クの <literal><fileset dir=\"${basedir}\"></literal> セクションを探して" -"ください。fileset の最後に新しい include を追加してください。" +#~ msgid "hibernate-entitymanager.jar" +#~ msgstr "hibernate-entitymanager.jar" -#. Tag: programlisting -#: Websphere.xml:914 -#, fuzzy, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -" <fileset dir=\"${lib.dir}\">\n" -" <include name=\"jboss-seam.jar\" />\n" -" </fileset>\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>\n" -"]]>" +#~ msgid "hibernate-validator.jar" +#~ msgstr "hibernate-validator.jar" -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "Hibernate 依存関係を追加してください。" +#~ msgid "commons-collections.jar" +#~ msgstr "commons-collections.jar" -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" +#~ msgid "jboss-common-core.jar" +#~ msgstr "jboss-common-core.jar" -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "サードパーティ依存関係を追加してください。" +#~ msgid "Various third party jars that Websphere needs:" +#~ msgstr "WebSphere が必要とするさまざまなサードパーティ jar。" -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" +#~ msgid "antlr.jar" +#~ msgstr "antlr.jar" -#. Tag: para -#: Websphere.xml:925 -#, fuzzy, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" -"<literal>jboss-seam.jar</literal> - これは <literal>ear</literal> のベースと " -"<literal>/lib</literal> ディレクトリの両方で必要となります。" +#~ msgid "cglib.jar" +#~ msgstr "cglib.jar" -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" +#~ msgid "asm.jar" +#~ msgstr "asm.jar" -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "最後には以下のようになります。" +#~ msgid "dom4j.jar" +#~ msgstr "dom4j.jar" -#. Tag: programlisting -#: Websphere.xml:933 -#, fuzzy, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jsf-api.jar\" />\n" -" <include name=\"lib/jsf-impl.jar\" />\n" -" <include name=\"lib/el-api.jar\" />\n" -" <include name=\"lib/el-ri.jar\"/>\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>\n" -"]]>" +#~ msgid "javassist.jar" +#~ msgstr "javassist.jar" -#. Tag: title -#: Websphere.xml:940 -#, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" -msgstr "seam-gen 生成アプリケーションのビルドと WebSphere へのデプロイ" +#~ msgid "concurrent.jar" +#~ msgstr "concurrent.jar" -#. Tag: para -#: Websphere.xml:945 -#, no-c-format -msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." -msgstr "" -"プロジェクトのベースディレクトリ (例えば <literal>/home/jbalunas/workspace/" -"websphere_example</literal>) で <literal>ant</literal> を実行してアプリケー" -"ションをビルドしてください。ビルドされるターゲットファイルは <literal>dist/" -"websphere_example.ear</literal> です。" +#, fuzzy +#~ msgid "" +#~ "Deploying an application created using <literal>seam-gen</literal> on " +#~ "Websphere V7" +#~ msgstr "" +#~ "<literal>seam-gen</literal> により生成されたアプリケーションの Websphere " +#~ "6.1.0.13 へのデプロイ" -#. Tag: para -#: Websphere.xml:954 -#, no-c-format -msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." -msgstr "" -"アプリケーションをデプロイするには、 <xref linkend=\"jee5-websphere-deploy\"/" -"> の手順に従ってください。但し、<literal>jboss-seam-jee5</literal> の代わり" -"にこのプロジェクト <literal>websphere_example</literal> へ置き換えて使用して" -"ください。" +#~ msgid "" +#~ "<literal>seam-gen</literal> is a very useful tool for developers to " +#~ "quickly get an application up and running, and provides a foundation to " +#~ "add your own functionality. Out of box <literal>seam-gen</literal> will " +#~ "produce applications configured to run on JBoss AS. These instructions " +#~ "will show the steps needed to get it to run on Websphere. As stated above " +#~ "in <xref linkend=\"jee5-websphere-section\"/> there are some tricky " +#~ "changes needed to get an EJB3 application running. This section will take " +#~ "you through the exact steps." +#~ msgstr "" +#~ "<literal>seam-gen</literal> は、開発者が素早くアプリケーションを準備して動" +#~ "作させるのにとても役に立つツールで、独自の機能を追加するための雛形を用意し" +#~ "ます。<literal>seam-gen</literal> はそのままで JBoss AS で動作するように構" +#~ "成されたアプリケーションを生成します。以下の手順では、Websphere 上で動作さ" +#~ "せるために必要なステップを示します。<xref linkend=\"jee5-websphere-section" +#~ "\"/> で述べたように、EJB3 アプリケーションを動作させるには変更が必要です。" +#~ "このセクションでは、その正確な手順を示します。" -#. Tag: para -#: Websphere.xml:960 -#, no-c-format -msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" -msgstr "" -"<literal>http://localhost:9080/websphere_example/index.html</literal> をブラ" -"ウズしてアプリケーションを確認してください。" +#~ msgid "Running <literal>seam-gen</literal> Setup" +#~ msgstr "<literal>seam-gen</literal> セットアップの実行" #~ msgid "" +#~ "The first step is setting up <literal>seam-gen</literal> to construct the " +#~ "base project. There are several choices made below, specifically the " +#~ "datasource and hibernate values that we will adjust once the project is " +#~ "created." +#~ msgstr "" +#~ "第一ステップは、雛形となるプロジェクトを生成できるように <literal>seam-" +#~ "gen</literal> をセットアップすることです。以下に実行したように、設定すべき" +#~ "項目がいくつかあります。特に、データソースと Hibernate の設定値は、プロ" +#~ "ジェクトを生成する環境に合わせて設定します。" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "./seam setup\n" +#~ "Buildfile: build.xml\n" +#~ "\n" +#~ "init:\n" +#~ "\n" +#~ "setup:\n" +#~ " [echo] Welcome to seam-gen :-)\n" +#~ " [input] Enter your Java project workspace (the directory that " +#~ "contains your \n" +#~ "Seam projects) [C:/Projects] [C:/Projects]\n" +#~ "/home/jbalunas/workspace\n" +#~ " [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." +#~ "GA] \n" +#~ "[C:/Program Files/jboss-4.2.3.GA]\n" +#~ "/home/jbalunas/jboss/jboss-4.2.3.GA\n" +#~ " [input] Enter the project name [myproject] [myproject]\n" +#~ "websphere_example\n" +#~ " [echo] Accepted project name as: websphere_example\n" +#~ " [input] Do you want to use ICEFaces instead of RichFaces [n] (y, " +#~ "[n], )\n" +#~ "\n" +#~ " [input] skipping input as property icefaces.home.new has already been " +#~ "set.\n" +#~ " [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " +#~ "wine, \n" +#~ "deepMarine, emeraldTown, sakura, DEFAULT)\n" +#~ "\n" +#~ " [input] Is this project deployed as an EAR (with EJB components) or a " +#~ "WAR \n" +#~ "(with no EJB support) [ear] ([ear], war, )\n" +#~ "\n" +#~ " [input] Enter the Java package name for your session beans [org.jboss." +#~ "seam.\n" +#~ "tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" +#~ "org.jboss.seam.tutorial.websphere.action \n" +#~ " [input] Enter the Java package name for your entity beans [org.jboss." +#~ "seam.\n" +#~ "tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" +#~ "org.jboss.seam.tutorial.websphere.model \n" +#~ " [input] Enter the Java package name for your test cases [org.jboss." +#~ "seam.\n" +#~ "tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." +#~ "test]\n" +#~ "org.jboss.seam.tutorial.websphere.test\n" +#~ " [input] What kind of database are you using? [hsql] ([hsql], mysql, " +#~ "oracle,\n" +#~ " postgres, mssql, db2, sybase, enterprisedb, h2)\n" +#~ "\n" +#~ " [input] Enter the Hibernate dialect for your database [org." +#~ "hibernate.\n" +#~ "dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" +#~ "\n" +#~ " [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/" +#~ "lib/hsqldb.jar] \n" +#~ "[/tmp/seam/lib/hsqldb.jar]\n" +#~ "\n" +#~ " [input] Enter JDBC driver class for your database [org.hsqldb." +#~ "jdbcDriver] \n" +#~ "[org.hsqldb.jdbcDriver]\n" +#~ "\n" +#~ " [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" +#~ "[jdbc:hsqldb:.]\n" +#~ "\n" +#~ " [input] Enter database username [sa] [sa]\n" +#~ "\n" +#~ " [input] Enter database password [] []\n" +#~ "\n" +#~ " [input] Enter the database schema name (it is OK to leave this blank) " +#~ "[] []\n" +#~ "\n" +#~ " [input] Enter the database catalog name (it is OK to leave this " +#~ "blank) [] []\n" +#~ "\n" +#~ " [input] Are you working with tables that already exist in the " +#~ "database? [n]\n" +#~ " (y, [n], )\n" +#~ "\n" +#~ " [input] Do you want to drop and recreate the database tables and data " +#~ "in \n" +#~ "import.sql each time you deploy? [n] (y, [n], )\n" +#~ "\n" +#~ "[propertyfile] Creating new property file: \n" +#~ "/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." +#~ "properties\n" +#~ " [echo] Installing JDBC driver jar to JBoss server\n" +#~ " [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" +#~ "default/lib\n" +#~ " [echo] Type 'seam create-project' to create the new project\n" +#~ "\n" +#~ "BUILD SUCCESSFUL\n" +#~ "Total time: 3 minutes 5 seconds]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "./seam setup\n" +#~ "Buildfile: build.xml\n" +#~ "\n" +#~ "init:\n" +#~ "\n" +#~ "setup:\n" +#~ " [echo] Welcome to seam-gen :-)\n" +#~ " [input] Enter your Java project workspace (the directory that " +#~ "contains your \n" +#~ "Seam projects) [C:/Projects] [C:/Projects]\n" +#~ "/home/jbalunas/workspace\n" +#~ " [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." +#~ "GA] \n" +#~ "[C:/Program Files/jboss-4.2.3.GA]\n" +#~ "/home/jbalunas/jboss/jboss-4.2.3.GA\n" +#~ " [input] Enter the project name [myproject] [myproject]\n" +#~ "websphere_example\n" +#~ " [echo] Accepted project name as: websphere_example\n" +#~ " [input] Do you want to use ICEFaces instead of RichFaces [n] (y, " +#~ "[n], )\n" +#~ "\n" +#~ " [input] skipping input as property icefaces.home.new has already been " +#~ "set.\n" +#~ " [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " +#~ "wine, \n" +#~ "deepMarine, emeraldTown, sakura, DEFAULT)\n" +#~ "\n" +#~ " [input] Is this project deployed as an EAR (with EJB components) or a " +#~ "WAR \n" +#~ "(with no EJB support) [ear] ([ear], war, )\n" +#~ "\n" +#~ " [input] Enter the Java package name for your session beans [org.jboss." +#~ "seam.\n" +#~ "tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" +#~ "org.jboss.seam.tutorial.websphere.action \n" +#~ " [input] Enter the Java package name for your entity beans [org.jboss." +#~ "seam.\n" +#~ "tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" +#~ "org.jboss.seam.tutorial.websphere.model \n" +#~ " [input] Enter the Java package name for your test cases [org.jboss." +#~ "seam.\n" +#~ "tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." +#~ "test]\n" +#~ "org.jboss.seam.tutorial.websphere.test\n" +#~ " [input] What kind of database are you using? [hsql] ([hsql], mysql, " +#~ "oracle,\n" +#~ " postgres, mssql, db2, sybase, enterprisedb, h2)\n" +#~ "\n" +#~ " [input] Enter the Hibernate dialect for your database [org." +#~ "hibernate.\n" +#~ "dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" +#~ "\n" +#~ " [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/" +#~ "lib/hsqldb.jar] \n" +#~ "[/tmp/seam/lib/hsqldb.jar]\n" +#~ "\n" +#~ " [input] Enter JDBC driver class for your database [org.hsqldb." +#~ "jdbcDriver] \n" +#~ "[org.hsqldb.jdbcDriver]\n" +#~ "\n" +#~ " [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" +#~ "[jdbc:hsqldb:.]\n" +#~ "\n" +#~ " [input] Enter database username [sa] [sa]\n" +#~ "\n" +#~ " [input] Enter database password [] []\n" +#~ "\n" +#~ " [input] Enter the database schema name (it is OK to leave this blank) " +#~ "[] []\n" +#~ "\n" +#~ " [input] Enter the database catalog name (it is OK to leave this " +#~ "blank) [] []\n" +#~ "\n" +#~ " [input] Are you working with tables that already exist in the " +#~ "database? [n]\n" +#~ " (y, [n], )\n" +#~ "\n" +#~ " [input] Do you want to drop and recreate the database tables and data " +#~ "in \n" +#~ "import.sql each time you deploy? [n] (y, [n], )\n" +#~ "\n" +#~ "[propertyfile] Creating new property file: \n" +#~ "/rhdev/projects/jboss-seam/svn-seam_2_0/jboss-seam-2_0/seam-gen/build." +#~ "properties\n" +#~ " [echo] Installing JDBC driver jar to JBoss server\n" +#~ " [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" +#~ "default/lib\n" +#~ " [echo] Type 'seam create-project' to create the new project\n" +#~ "\n" +#~ "BUILD SUCCESSFUL\n" +#~ "Total time: 3 minutes 5 seconds]]>" + +#~ msgid "" +#~ "Type <literal>./seam new-project</literal> to create your project and " +#~ "<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " +#~ "newly created structure." +#~ msgstr "" +#~ "プロジェクトを作成するためには、<literal>$ ./seam new-project</literal> と" +#~ "入力してください。そして <literal>cd /home/jbalunas/workspace/" +#~ "websphere_example</literal> と入力して新しく作成されたディレクトリへ移動し" +#~ "てください。" + +#~ msgid "Changes needed for deployment to Websphere" +#~ msgstr "Websphere へのデプロイに必要な変更点" + +#~ msgid "We now need to make some changes to the generated project." +#~ msgstr "生成されたプロジェクトに変更を行う必要があります。" + +#~ msgid "resources/META-INF/persistence-dev.xml" +#~ msgstr "resources/META-INF/persistence-dev.xml" + +#~ msgid "" +#~ "Alter the <literal>jta-data-source</literal> to be " +#~ "<literal>DefaultDatasource</literal>. We are going to be using the " +#~ "integrated Websphere DB." +#~ msgstr "" +#~ "<literal>jta-data-source</literal> を <literal>DefaultDatasource</" +#~ "literal> に修正してください。組み込みの Websphere DB を使用します。" + +#~ msgid "" +#~ "Add or change the properties below. These are described in detail at " +#~ "<xref linkend=\"jee5-websphere-section\"/>:" +#~ msgstr "" +#~ "以下のプロパティを追加修正してください。<xref linkend=\"jee5-websphere-" +#~ "section\"/> に詳細が説明されています。" + +#~ msgid "" +#~ "<![CDATA[\n" +#~ "<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" +#~ "<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" +#~ "<property name=\"hibernate.show_sql\" value=\"true\"/>\n" +#~ "<property name=\"hibernate.format_sql\" value=\"true\"/>\n" +#~ "<property name=\"hibernate.cache.provider_class\" \n" +#~ " value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" +#~ "<property name=\"hibernate.transaction.manager_lookup_class\" \n" +#~ " value=\"org.hibernate.transaction." +#~ "WebSphereExtendedJTATransactionLookup\"/>]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" +#~ "<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" +#~ "<property name=\"hibernate.show_sql\" value=\"true\"/>\n" +#~ "<property name=\"hibernate.format_sql\" value=\"true\"/>\n" +#~ "<property name=\"hibernate.cache.provider_class\" \n" +#~ " value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" +#~ "<property name=\"hibernate.transaction.manager_lookup_class\" \n" +#~ " value=\"org.hibernate.transaction." +#~ "WebSphereExtendedJTATransactionLookup\"/>]]>" + +#~ msgid "" +#~ "Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +#~ msgstr "" +#~ "EntityManagerFactory を定義する JBoss AS 固有のメソッドを取り除いてくださ" +#~ "い。" + +#~ msgid "" +#~ "<![CDATA[<property \n" +#~ " name=\"jboss.entity.manager.factory.jndi.name\" \n" +#~ " value=\"java:/websphere_exampleEntityManagerFactory\">]]>" +#~ msgstr "" +#~ "<![CDATA[<property \n" +#~ " name=\"jboss.entity.manager.factory.jndi.name\" \n" +#~ " value=\"java:/websphere_exampleEntityManagerFactory\">\n" +#~ "]]>" + +#~ msgid "" +#~ "You'll need to alter <literal>persistence-prod.xml</literal> as well if " +#~ "you want to deploy to Websphere using the prod profile." +#~ msgstr "" +#~ "prod プロファイルを使用して Websphere にデプロイしたければ、" +#~ "<literal>persistence-prod.xml</literal> も同様に修正する必要があります。" + +#, fuzzy +#~ msgid "" +#~ "As with other examples we need to include this java class for DB support. " +#~ "It can be copied from the <literal>jpa</literal> example into the " +#~ "<literal>websphere_example/src</literal> directory." +#~ msgstr "" +#~ "他のサンプルと同様に、データベースサポートのためのこのクラスを含める必要が" +#~ "あります。<literal>jpa</literal> サンプルから <literal>websphere_example/" +#~ "resources</literal> ディレクトリへコピーしてください。" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" +#~ " ./src]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "cp $SEAM/examples/jpa/resources-websphere61/WEB-INF/classes/" +#~ "GlassfishDerbyDialect.class\n" +#~ " ./resources]]>" + +#~ msgid "resources/META-INF/jboss-app.xml" +#~ msgstr "resources/META-INF/jboss-app.xml" + +#~ msgid "" +#~ "You can delete this file as we aren't deploying to JBoss AS " +#~ "( <literal>jboss-app.xml</literal> is used to enable classloading " +#~ "isolation in JBoss AS)" +#~ msgstr "" +#~ "JBoss AS にはデプロイしないのでこのファイルを削除できます (JBoss AS では " +#~ "<literal>jboss-app.xml</literal> を使用して、クラスローディングの分離を有" +#~ "効にします)" + +#~ msgid "resources/*-ds.xml" +#~ msgstr "resources/*-ds.xml" + +#~ msgid "" +#~ "You can delete these file as we aren't deploying to JBoss AS (these files " +#~ "define datasources in JBoss AS, we are using Websphere's default " +#~ "datasource)" +#~ msgstr "" +#~ "JBoss AS にはデプロイしないのでこのファイルを削除できます (これらのファイ" +#~ "ルは、JBoss AS ではデータソースを定義していますが、Websphere ではデフォル" +#~ "トのデータソースを使用しています)" + +#~ msgid "" +#~ "Enable container managed transaction integration - add the <literal> <" +#~ "transaction:ejb-transaction /> </literal> component, and it's " +#~ "namespace declaration <literal> xmlns:transaction=\"http://jboss.com/" +#~ "products/seam/transaction\" </literal>" +#~ msgstr "" +#~ "コンテナ管理トランザクション統合を有効にします - <literal> <" +#~ "transaction:ejb-transaction /> </literal> コンポーネントと、その名前空" +#~ "間宣言 <literal>xmlns:transaction=\"http://jboss.com/products/seam/" +#~ "transaction\"</literal> を追記してください" + +#~ msgid "" +#~ "Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" +#~ "websphere_example/#{ejbName} </literal>" +#~ msgstr "" +#~ "<literal>jndi-pattern</literal> を <literal>java:comp/env/" +#~ "websphere_example/#{ejbName}</literal> に修正します" + +#~ msgid "" +#~ "We do not need <literal>managed-persistence-context</literal> for this " +#~ "example and so can delete its entry." +#~ msgstr "" +#~ "このサンプルでは、<literal>managed-persistence-context</literal> は必要で" +#~ "はないので、そのエントリは削除します。" + +#~ msgid "" +#~ "<![CDATA[\n" +#~ "<persistence:managed-persistence-context name=\"entityManager\"\n" +#~ " auto-create=\"true\"\n" +#~ " persistence-unit-jndi-name=\"java:/" +#~ "websphere_exampleEntityManagerFactory\"/> ]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "<persistence:managed-persistence-context name=\"entityManager\"\n" +#~ " auto-create=\"true\"\n" +#~ " persistence-unit-jndi-name=\"java:/" +#~ "websphere_exampleEntityManagerFactory\"/> ]]>" + +#, fuzzy +#~ msgid "" +#~ "As with the <literal>jee5/booking</literal> example we need to add EJB " +#~ "references to the web.xml. These references require replacing /local " +#~ "string in <literal>ejb-ref-name</literal> to flag them for Websphere to " +#~ "perform the proper binding." +#~ msgstr "" +#~ "<literal>jee5/booking</literal> サンプルと同様に、web.xml に EJB 参照を加" +#~ "える必要があります。これらの EJB 参照には、Websphere が適切なバインディン" +#~ "グを実行するために空の <literal>local-home</literal> を設定することが必要" +#~ "となります。" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.tutorial.websphere.action.Authenticator</" +#~ "local>\n" +#~ " </ejb-local-ref> \n" +#~ " \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +#~ " </ejb-local-ref>]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local-home></local-home>\n" +#~ " <local>org.jboss.seam.tutorial.websphere.action.Authenticator</" +#~ "local>\n" +#~ " </ejb-local-ref>\n" +#~ " \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local-home></local-home>\n" +#~ " <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +#~ " </ejb-local-ref>\n" +#~ "]]>" + +#~ msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +#~ msgstr "<literal>AuthenticatorAction</literal> EJB の作成" + +#~ msgid "" +#~ "We want to take the existing <literal>Authenticator</literal> Seam POJO " +#~ "component and create an EJB3 out of it." +#~ msgstr "" +#~ "既存の <literal>Authenticator</literal> Seam POJO コンポーネントを利用し" +#~ "て、EJB3 を作成します。" + +#~ msgid "Rename the class to <literal>AuthenticatorAction</literal>" +#~ msgstr "クラス名を <literal>AuthenticatorAction</literal> に変更します" + +#~ msgid "" +#~ "Add the <literal>@Stateless</literal> annotation to the new " +#~ "<literal>AuthenticatorAction</literal> class." +#~ msgstr "" +#~ "<literal>@Stateless</literal> アノテーションを新しい " +#~ "<literal>AuthenticatorAction</literal> クラスに付与します。" + +#~ msgid "" +#~ "Create an interface called <literal>Authenticator</literal> which " +#~ "<literal>AuthenticatorAction</literal> implements (EJB3 requires session " +#~ "beans to have a local interface). Annotate the interface with " +#~ "<literal>@Local</literal> , and add a single method with same signature " +#~ "as the <literal>authenticate</literal> in <literal>AuthenticatorAction</" +#~ "literal> ." +#~ msgstr "" +#~ "<literal>AuthenticatorAction</literal> が実装する <literal>Authenticator</" +#~ "literal> という名前のインタフェースを作成してください (EJB3 ではセッショ" +#~ "ン Bean にローカルインタフェースが必要)。インタフェースに " +#~ "<literal>@Local</literal> アノテーションを付与し、" +#~ "<literal>AuthenticatorAction</literal> の <literal>authenticate</literal> " +#~ "と同じシグニチャのメソッドを一つ追加してください。" + +#~ msgid "" +#~ "<![CDATA[\n" +#~ "@Name(\"authenticator\") @Stateless public class\n" +#~ " AuthenticatorAction implements Authenticator {]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "@Name(\"authenticator\")\n" +#~ "@Stateless\n" +#~ "public class AuthenticatorAction implements Authenticator {]]>" + +#~ msgid "" +#~ "<![CDATA[\n" +#~ "@Local public interface Authenticator { \n" +#~ " public boolean authenticate(); \n" +#~ "}]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "@Local\n" +#~ "public interface Authenticator { \n" +#~ " public boolean authenticate(); \n" +#~ "}]]>" + +#~ msgid "" +#~ "We've already added its reference to the <literal>web.xml</literal> file " +#~ "so are good to go." +#~ msgstr "" +#~ "すでに <literal>web.xml</literal> ファイルには EJB 参照を追加したので、次" +#~ "に進めます。" + +#~ msgid "" +#~ "Extra jar dependencies and other changes to the <literal>build.xml</" +#~ "literal>" +#~ msgstr "" +#~ "<literal>build.xml</literal> への jar 依存関係の追加とその他の変更点" + +#~ msgid "" +#~ "This application has similar requirements as the <literal>jee5/booking</" +#~ "literal> example." +#~ msgstr "" +#~ "このアプリケーションは、<literal>jee5/booking</literal> サンプルと同様の変" +#~ "更が必要となります。" + +#~ msgid "" +#~ "Change the default target to <literal>archive</literal> (we aren't going " +#~ "to cover automatic deployment to Websphere)." +#~ msgstr "" +#~ "デフォルトのターゲットを <literal>archive</literal> に変更します " +#~ "(Websphere への自動的なデプロイを行いません)。" + +#~ msgid "" +#~ "<![CDATA[\n" +#~ "<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "<project name=\"websphere_example\" default=\"archive\" basedir=\".\">\n" +#~ "]]>" + +#~ msgid "" +#~ "Websphere looks for the drools <literal>/security.drl</literal> file in " +#~ "the root of the <literal>war</literal> file instead of the root of the " +#~ "<literal>websphere_example.jar</literal> so we need to have the " +#~ "<literal>build.xml</literal> move it to the correct location at build " +#~ "time. The following must be added at the top of the <literal> <target " +#~ "name=\"war\" depends=\"compile\" description=\"Build the distribution ." +#~ "war file\"> </literal> target." +#~ msgstr "" +#~ "Websphere は、<literal>websphere_example.jar</literal> のルートではなく " +#~ "<literal>war</literal> ファイルのルートで drools の <literal>/security." +#~ "drl</literal> ファイルを探すので、ビルド時には正しい場所へ移動させるよう" +#~ "に <literal>build.xml</literal> に設定する必要があります。以下の変更は、" +#~ "<literal> <target name=\"war\" depends=\"compile\" description=\"Build " +#~ "the distribution .war file\"> </literal> ターゲットの先頭に追加しなけれ" +#~ "ばなりません。" + +#~ msgid "" +#~ "<![CDATA[\n" +#~ "<copy todir=\"${war.dir}\">\n" +#~ " <fileset dir=\"${basedir}/resources\" >\n" +#~ " <include name=\"*.drl\" />\n" +#~ " </fileset>\n" +#~ "</copy>]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "<copy todir=\"${war.dir}\">\n" +#~ " <fileset dir=\"${basedir}/resources\" >\n" +#~ " <include name=\"*.drl\" />\n" +#~ " </fileset>\n" +#~ "</copy>\n" +#~ "]]>" + +#~ msgid "" +#~ "Now we need to get extra jars into the <literal>build.xml</literal>. Look " +#~ "for the <literal><fileset dir=\"${basedir}\"></literal> section of " +#~ "the task below. Add the new includes at the bottom of the fileset." +#~ msgstr "" +#~ "追加の jar を <literal>build.xml</literal> に入れる必要があります。以下の" +#~ "タスクの <literal><fileset dir=\"${basedir}\"></literal> セクション" +#~ "を探してください。fileset の最後に新しい include を追加してください。" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "<target name=\"ear\" description=\"Build the EAR\">\n" +#~ " <copy todir=\"${ear.dir}\">\n" +#~ " <fileset dir=\"${basedir}/resources\">\n" +#~ " <include name=\"*jpdl.xml\" />\n" +#~ " <include name=\"*hibernate.cfg.xml\" />\n" +#~ " <include name=\"jbpm.cfg.xml\" />\n" +#~ " </fileset>\n" +#~ "\n" +#~ " <fileset dir=\"${basedir}\">\n" +#~ " <include name=\"lib/jbpm*.jar\" />\n" +#~ " <include name=\"lib/jboss-el.jar\" />\n" +#~ " <include name=\"lib/drools-*.jar\"/>\n" +#~ " <include name=\"lib/core.jar\"/>\n" +#~ " <include name=\"lib/janino*.jar\"/>\n" +#~ " <include name=\"lib/antlr-*.jar\"/>\n" +#~ " <include name=\"lib/mvel*.jar\"/>\n" +#~ " <include name=\"lib/richfaces-api*.jar\" />\n" +#~ " </fileset>\n" +#~ " </copy>\n" +#~ " <copy todir=\"${ear.dir}/META-INF\">\n" +#~ " <fileset dir=\"${basedir}/resources/META-INF\">\n" +#~ " <include name=\"application.xml\" />\n" +#~ " <include name=\"jboss-app.xml\" />\n" +#~ " </fileset>\n" +#~ " </copy>\n" +#~ "</target>]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "<target name=\"ear\" description=\"Build the EAR\">\n" +#~ " <copy todir=\"${ear.dir}\">\n" +#~ " <fileset dir=\"${basedir}/resources\">\n" +#~ " <include name=\"*jpdl.xml\" />\n" +#~ " <include name=\"*hibernate.cfg.xml\" />\n" +#~ " <include name=\"jbpm.cfg.xml\" />\n" +#~ " </fileset>\n" +#~ " <fileset dir=\"${lib.dir}\">\n" +#~ " <include name=\"jboss-seam.jar\" />\n" +#~ " </fileset>\n" +#~ " <fileset dir=\"${basedir}\">\n" +#~ " <include name=\"lib/jbpm*.jar\" />\n" +#~ " <include name=\"lib/jboss-el.jar\" />\n" +#~ " <include name=\"lib/drools-*.jar\"/>\n" +#~ " <include name=\"lib/core.jar\"/>\n" +#~ " <include name=\"lib/janino*.jar\"/>\n" +#~ " <include name=\"lib/antlr-*.jar\"/>\n" +#~ " <include name=\"lib/mvel*.jar\"/>\n" +#~ " <include name=\"lib/richfaces-api*.jar\" />\n" +#~ " </fileset>\n" +#~ " </copy>\n" +#~ " <copy todir=\"${ear.dir}/META-INF\">\n" +#~ " <fileset dir=\"${basedir}/resources/META-INF\">\n" +#~ " <include name=\"application.xml\" />\n" +#~ " <include name=\"jboss-app.xml\" />\n" +#~ " </fileset>\n" +#~ " </copy>\n" +#~ "</target>\n" +#~ "]]>" + +#~ msgid "Hibernate dependencies" +#~ msgstr "Hibernate 依存関係を追加してください。" + +#~ msgid "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " <include name=\"lib/hibernate.jar\"/>\n" +#~ " <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-entitymanager.jar\"/>\n" +#~ " <include name=\"lib/hibernate-validator.jar\"/>\n" +#~ " <include name=\"lib/jboss-common-core.jar\" />]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " <include name=\"lib/hibernate.jar\"/>\n" +#~ " <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-entitymanager.jar\"/>\n" +#~ " <include name=\"lib/hibernate-validator.jar\"/>\n" +#~ " <include name=\"lib/jboss-common-core.jar\" />]]>" + +#~ msgid "Third party dependencies." +#~ msgstr "サードパーティ依存関係を追加してください。" + +#~ msgid "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " \n" +#~ " <include name=\"lib/javassist.jar\"/>\n" +#~ " <include name=\"lib/dom4j.jar\" />\n" +#~ " <include name=\"lib/concurrent.jar\" />\n" +#~ " <include name=\"lib/cglib.jar\"/>\n" +#~ " <include name=\"lib/asm.jar\"/>\n" +#~ " <include name=\"lib/antlr.jar\" />\n" +#~ " <include name=\"lib/commons-logging.jar\" />\n" +#~ " <include name=\"lib/commons-collections.jar\" />]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " \n" +#~ " <include name=\"lib/javassist.jar\"/>\n" +#~ " <include name=\"lib/dom4j.jar\" />\n" +#~ " <include name=\"lib/concurrent.jar\" />\n" +#~ " <include name=\"lib/cglib.jar\"/>\n" +#~ " <include name=\"lib/asm.jar\"/>\n" +#~ " <include name=\"lib/antlr.jar\" />\n" +#~ " <include name=\"lib/commons-logging.jar\" />\n" +#~ " <include name=\"lib/commons-collections.jar\" />]]>" + +#, fuzzy +#~ msgid "" +#~ "<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" +#~ "literal> base directory." +#~ msgstr "" +#~ "<literal>jboss-seam.jar</literal> - これは <literal>ear</literal> のベース" +#~ "と <literal>/lib</literal> ディレクトリの両方で必要となります。" + +#~ msgid "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " <include name=\"lib/jboss-seam.jar\" />]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " <include name=\"lib/jboss-seam.jar\" />]]>" + +#~ msgid "You should end up with something like:" +#~ msgstr "最後には以下のようになります。" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<fileset dir=\"${basedir}\">\n" +#~ " \n" +#~ " <include name=\"lib/jbpm*.jar\" />\n" +#~ " <include name=\"lib/jboss-el.jar\" />\n" +#~ " <include name=\"lib/drools-*.jar\"/>\n" +#~ " <include name=\"lib/core.jar\"/>\n" +#~ " <include name=\"lib/janino*.jar\"/>\n" +#~ " <include name=\"lib/antlr-*.jar\"/>\n" +#~ " <include name=\"lib/mvel*.jar\"/>\n" +#~ " <include name=\"lib/richfaces-api*.jar\" />\n" +#~ " \n" +#~ " \n" +#~ " <include name=\"lib/hibernate.jar\"/>\n" +#~ " <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-entitymanager.jar\"/>\n" +#~ " <include name=\"lib/hibernate-validator.jar\"/>\n" +#~ " <include name=\"lib/jboss-common-core.jar\" />\n" +#~ "\n" +#~ " \n" +#~ " <include name=\"lib/javassist.jar\"/>\n" +#~ " <include name=\"lib/dom4j.jar\" />\n" +#~ " <include name=\"lib/concurrent.jar\" />\n" +#~ " <include name=\"lib/cglib.jar\"/>\n" +#~ " <include name=\"lib/asm.jar\"/>\n" +#~ " <include name=\"lib/antlr.jar\" />\n" +#~ " <include name=\"lib/commons-logging.jar\" />\n" +#~ " <include name=\"lib/commons-collections.jar\" />\n" +#~ " \n" +#~ " \n" +#~ " <include name=\"lib/jboss-seam.jar\" />\n" +#~ " \n" +#~ "</fileset>]]>" +#~ msgstr "" +#~ "<![CDATA[<fileset dir=\"${basedir}\">\n" +#~ " \n" +#~ " <include name=\"lib/jbpm*.jar\" />\n" +#~ " <include name=\"lib/jboss-el.jar\" />\n" +#~ " <include name=\"lib/drools-*.jar\"/>\n" +#~ " <include name=\"lib/core.jar\"/>\n" +#~ " <include name=\"lib/janino*.jar\"/>\n" +#~ " <include name=\"lib/antlr-*.jar\"/>\n" +#~ " <include name=\"lib/mvel*.jar\"/>\n" +#~ " <include name=\"lib/richfaces-api*.jar\" />\n" +#~ " \n" +#~ " \n" +#~ " <include name=\"lib/hibernate.jar\"/>\n" +#~ " <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-entitymanager.jar\"/>\n" +#~ " <include name=\"lib/hibernate-validator.jar\"/>\n" +#~ " <include name=\"lib/jboss-common-core.jar\" />\n" +#~ " \n" +#~ " \n" +#~ " <include name=\"lib/jsf-api.jar\" />\n" +#~ " <include name=\"lib/jsf-impl.jar\" />\n" +#~ " <include name=\"lib/el-api.jar\" />\n" +#~ " <include name=\"lib/el-ri.jar\"/>\n" +#~ " \n" +#~ " \n" +#~ " <include name=\"lib/javassist.jar\"/>\n" +#~ " <include name=\"lib/dom4j.jar\" />\n" +#~ " <include name=\"lib/concurrent.jar\" />\n" +#~ " <include name=\"lib/cglib.jar\"/>\n" +#~ " <include name=\"lib/asm.jar\"/>\n" +#~ " <include name=\"lib/antlr.jar\" />\n" +#~ " <include name=\"lib/commons-logging.jar\" />\n" +#~ " <include name=\"lib/commons-collections.jar\" />\n" +#~ " \n" +#~ " \n" +#~ " <include name=\"lib/jboss-seam.jar\" />\n" +#~ " \n" +#~ "</fileset>\n" +#~ "]]>" + +#~ msgid "Building and deploying the seam-gen'd application to Websphere" +#~ msgstr "seam-gen 生成アプリケーションのビルドと WebSphere へのデプロイ" + +#~ msgid "" +#~ "Build your application by calling <literal>ant</literal> in the base " +#~ "directory of your project (ex. <literal>/home/jbalunas/workspace/" +#~ "websphere_example</literal> ). The target of the build will be " +#~ "<literal>dist/websphere_example.ear</literal> ." +#~ msgstr "" +#~ "プロジェクトのベースディレクトリ (例えば <literal>/home/jbalunas/" +#~ "workspace/websphere_example</literal>) で <literal>ant</literal> を実行し" +#~ "てアプリケーションをビルドしてください。ビルドされるターゲットファイルは " +#~ "<literal>dist/websphere_example.ear</literal> です。" + +#~ msgid "" +#~ "To deploy the application follow the instructions here : <xref linkend=" +#~ "\"jee5-websphere-deploy\"/> but use references to this project " +#~ "<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" +#~ "literal>." +#~ msgstr "" +#~ "アプリケーションをデプロイするには、 <xref linkend=\"jee5-websphere-deploy" +#~ "\"/> の手順に従ってください。但し、<literal>jboss-seam-jee5</literal> の" +#~ "代わりにこのプロジェクト <literal>websphere_example</literal> へ置き換えて" +#~ "使用してください。" + +#~ msgid "" +#~ "Checkout the app at: <literal>http://localhost:9080/websphere_example/" +#~ "index.html</literal>" +#~ msgstr "" +#~ "<literal>http://localhost:9080/websphere_example/index.html</literal> をブ" +#~ "ラウズしてアプリケーションを確認してください。" + +#~ msgid "" #~ "Websphere 6.1.x is IBM's application server offering. The latest release " #~ "is 6.1.0.19 which does not have <literal>EJB3</literal> or <literal>JEE5</" #~ "literal> support. There is a recently released (Nov 07) <literal>EJB3</" @@ -2299,9 +2550,6 @@ #~ "WebSphere には最新の fix pack を適用することを強く推奨します。執筆時点での" #~ "最新の fix pack は、6.1.0.19 です。" -#~ msgid "A note about restarting the server" -#~ msgstr "サーバの再起動についてのメモ" - #~ msgid "" #~ "There are times that restarting the server will be required after " #~ "deploying or changes the examples in this chapter. Its does not seem like " @@ -2545,9 +2793,6 @@ #~ "ジュールが初期化されるときには、ear の lib ディレクトリにある jar が利用で" #~ "きません。" -#~ msgid "Log in to the administration console" -#~ msgstr "管理コンソールへログインしてください。" - #~ msgid "" #~ "<literal>Map EJB references to beans</literal> This page will list all of " #~ "the beans that we entered in the web.xml." @@ -2664,27 +2909,6 @@ #~ "あります。" #~ msgid "" -#~ "<![CDATA[\n" -#~ "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" -#~ "<web-app version=\"2.4\" \n" -#~ " xmlns=\"http://java.sun.com/xml/ns/j2ee\"\n" -#~ " xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" -#~ " xsi:schemaLocation=\"http://java.sun.com/xml/ns/j2ee \n" -#~ " http://java.sun.com/xml/ns/j2ee/web-app_2_4." -#~ "xsd\">\n" -#~ " ]]>" -#~ msgstr "" -#~ "<![CDATA[\n" -#~ "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" -#~ "<web-app version=\"2.4\" \n" -#~ " xmlns=\"http://java.sun.com/xml/ns/j2ee\"\n" -#~ " xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" -#~ " xsi:schemaLocation=\"http://java.sun.com/xml/ns/j2ee \n" -#~ " http://java.sun.com/xml/ns/j2ee/web-app_2_4." -#~ "xsd\">\n" -#~ " ]]>" - -#~ msgid "" #~ "We need to ge the <literal>GlassfishDerbyDialect.class</literal> into our " #~ "application jar. To do that find the <literal>jar</literal> task and " #~ "modify the top of it so that it looks like this:" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/kn-IN/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/kn-IN/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/kn-IN/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/kn-IN/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/kn-IN/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/kn-IN/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/kn-IN/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/kn-IN/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/kn-IN/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ko-KR/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ko-KR/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ko-KR/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ko-KR/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ko-KR/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ko-KR/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ko-KR/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ko-KR/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ko-KR/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ml-IN/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ml-IN/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ml-IN/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ml-IN/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ml-IN/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ml-IN/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ml-IN/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ml-IN/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ml-IN/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/mr-IN/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/mr-IN/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/mr-IN/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/mr-IN/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/mr-IN/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/mr-IN/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/mr-IN/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/mr-IN/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/mr-IN/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/or-IN/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/or-IN/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/or-IN/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/or-IN/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/or-IN/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/or-IN/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/or-IN/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/or-IN/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/or-IN/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pa-IN/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pa-IN/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pa-IN/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pa-IN/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pa-IN/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pa-IN/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pa-IN/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pa-IN/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pa-IN/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Annotations.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Annotations.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Annotations.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Author_Group.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Author_Group.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Author_Group.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" @@ -109,89 +109,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Book_Info.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Book_Info.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Book_Info.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Cache.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Cache.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Cache.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/ClusteringAndEJBPassivation.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/ClusteringAndEJBPassivation.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/ClusteringAndEJBPassivation.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Components.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Components.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Components.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Concepts.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Concepts.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Concepts.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Configuration.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Configuration.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Configuration.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Controls.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Controls.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Controls.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Conversations.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Conversations.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Conversations.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Dependencies.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Dependencies.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Dependencies.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Drools.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Drools.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Drools.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Elenhancements.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Elenhancements.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Elenhancements.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Events.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Events.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Events.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Excel.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Excel.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Excel.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" @@ -1039,8 +1039,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Feedback.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Feedback.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Feedback.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Framework.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Framework.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Framework.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Getting_Started_With_JBoss_Tools.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Getting_Started_With_JBoss_Tools.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Getting_Started_With_JBoss_Tools.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Gettingstarted.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Gettingstarted.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Gettingstarted.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Glassfish.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Glassfish.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Glassfish.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Groovy.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Groovy.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Groovy.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Guice.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Guice.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Guice.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Gwt.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Gwt.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Gwt.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Hsearch.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Hsearch.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Hsearch.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/I18n.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/I18n.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/I18n.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Itext.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Itext.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Itext.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Jbpm.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Jbpm.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Jbpm.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Jms.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Jms.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Jms.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Mail.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Mail.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Mail.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Performance.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Performance.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Performance.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Persistence.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Persistence.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Persistence.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:34+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Preface.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Preface.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Preface.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Remoting.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Remoting.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Remoting.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Revision_History.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Revision_History.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Revision_History.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Rss.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Rss.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Rss.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Security.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Security.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Security.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Spring.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Spring.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Spring.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Testing.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Testing.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Testing.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Text.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Text.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Text.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Tools.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Tools.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Tools.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Tutorial.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Tutorial.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Tutorial.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Validation.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Validation.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Validation.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Weblogic.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Weblogic.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Weblogic.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Webservices.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Webservices.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Webservices.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Websphere.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Websphere.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Websphere.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" @@ -17,1653 +17,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Wicket.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Wicket.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Wicket.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Xml.pot =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Xml.pot 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pot/Xml.pot 2009-08-22 13:32:07 UTC (rev 11417) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-08-01 18:35+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pt-BR/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pt-BR/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pt-BR/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pt-BR/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pt-BR/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pt-BR/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/pt-BR/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/pt-BR/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/pt-BR/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ru-RU/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ru-RU/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ru-RU/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ru-RU/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ru-RU/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ru-RU/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ru-RU/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ru-RU/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ru-RU/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/si-LK/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/si-LK/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/si-LK/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/si-LK/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/si-LK/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/si-LK/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/si-LK/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/si-LK/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/si-LK/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/sl-SL/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/sl-SL/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/sl-SL/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/sl-SL/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/sl-SL/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/sl-SL/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/sl-SL/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/sl-SL/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/sl-SL/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-21 00:37+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ta-IN/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ta-IN/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ta-IN/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ta-IN/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ta-IN/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ta-IN/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/ta-IN/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/ta-IN/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/ta-IN/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/te-IN/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/te-IN/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/te-IN/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/te-IN/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/te-IN/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/te-IN/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/te-IN/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/te-IN/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/te-IN/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-CN/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-CN/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-CN/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:31+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-CN/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-CN/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-CN/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-CN/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-CN/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-CN/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-TW/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-TW/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-TW/Author_Group.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-05-03 11:34+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -108,89 +108,95 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:74 Author_Group.xml:81 +#: Author_Group.xml:78 Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117 +#: Author_Group.xml:107 Author_Group.xml:114 Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-TW/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-TW/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-TW/Excel.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide \n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-10-14 11:38+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1038,8 +1038,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-TW/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-TW/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/zh-TW/Websphere.po 2009-08-22 13:32:07 UTC (rev 11417) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,1653 +16,935 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" +msgid "Seam on IBM's WebSphere AS v7" msgstr "" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "" -"Websphere AS V7 is IBM's application server offering. This release is fully " -"Java EE 5 certified." +msgid "WebSphere AS environment and version recommendation" msgstr "" #. Tag: para #: Websphere.xml:7 #, no-c-format msgid "" -"First we will go over some basic information about the Websphere AS " -"environment that we used for these examples. We will go over the details of " -"those steps with the JEE5 booking example. We will also deploy the JPA " -"example application." +"WebSphere Application Server v7 is IBM's application server offering. This " +"release is fully Java EE 5 certified." msgstr "" -#. Tag: title -#: Websphere.xml:13 +#. Tag: para +#: Websphere.xml:12 #, no-c-format -msgid "Websphere AS environment and deployment information" +msgid "" +"WebSphere AS being a commercial product, we will not discuss the details of " +"its installation. At best, we will instruct you to follow the directions " +"provided by your particular installation type and license." msgstr "" #. Tag: para -#: Websphere.xml:15 +#: Websphere.xml:18 #, no-c-format msgid "" -"Websphere AS is a commercial product and so we will not discuss the details " -"of its installation other than to say follow the directions provided by your " -"particular installation type and license. This section will detail the exact " -"server versions used, installation tips, and some custom properties that are " -"needed for all of the examples." +"First, we will go over some basic considerations on how to run Seam " +"applications under WebSphere AS v7. We will go over the details of these " +"steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) " +"example application." msgstr "" -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "" - #. Tag: para #: Websphere.xml:24 #, no-c-format msgid "" -"All of the examples and information in this chapter are based on the version " -"V7 of Websphere AS at the time of this writing." +"All of the examples and information in this chapter are based on WebSphere " +"AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm." +"com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</" +"ulink>" msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" +msgid "" +"WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use " +"with Seam. Earlier versions of WebSphere have bugs in the EJB container that " +"will cause various exceptions to occur at runtime." msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format msgid "" -"After installing Websphere AS, create server profile with Profile Management " -"Tool, if you didn't create profile in installation process." +"The following sections in this chapter assume that WebSphere is correctly " +"installed and is functional, and a profile has been successfully created." msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format msgid "" -"The <literal>jee5/booking</literal> example is based on the Hotel Booking " -"example (which runs on JBoss AS). Out of the box it is designed to run on " -"Glassfish, but with the steps below it can be deployed to Websphere. It is " -"located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +"This chapter explain how to compile, deploy and run some sample applications " +"in WebSphere. These sample applications require a database. WebSphere comes " +"by default with a set of sample applications called \"Default Application\". " +"This set of sample applications use a Derby database running on the Derby " +"instance installed with WebSphere. In order to keep this simple we'll use " +"this Derby database created for the \"Default Applications\". However, to " +"run the sample application with the Derby database \"as-is\", a patched " +"Hibernate dialect must be used (The patch changes the default \"auto\" key " +"generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you " +"want to use another database, it's just a matter of creating a connection " +"pool in WebSphere pointing to this database, declare the correct Hibernate " +"dialect and set the correct JNDI name in <literal>persistence.xml</literal>." msgstr "" #. Tag: title -#: Websphere.xml:52 Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" +msgid "Configuring the WebSphere Web Container" msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format msgid "" -"Below are the configuration file changes that are need to the base example." +"This step is mandatory in order to have Seam applications run with WebSphere " +"v7. Two extra properties must be added to the Web Container. Please refer to " +"the IBM WebSphere Information Center for further explanations on those " +"properties." msgstr "" -#. Tag: literal -#: Websphere.xml:60 Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "" -"We need to change the way that we look up EJBs for WAS. We need to remove " -"the <literal>/local</literal> from the end of the <literal>jndi-pattern</" -"literal> attribute. It should look like this:" +msgid "Open the WebSphere administration console" msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=" -"\"true\"/>\n" -" ]]>" +"Select the <literal>Servers/Server Types/WebSphere Application Servers</" +"literal> in the left navigation menu" msgstr "" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format msgid "" -"We need to replace the /local string from <literal>ejb-ref-name</literal>. " -"See at the following final code:" +"On the right navigation menu, select <literal>Web Container Settings/Web " +"container</literal>)" msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" -"name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +"On the right navigation menu, select <literal>custom properties</literal>) " +"and add the following properties:" msgstr "" #. Tag: literal -#: Websphere.xml:88 Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "" -"We have to make some changes to the EJB references in the <literal>web.xml</" -"literal>. These changes are what will allow WAS to bind automatically the " -"EJB3 references in the web module to the the actual EJB3 beans in the EAR " -"module. Replace all of the /local strings in <literal>ejb-local-refs</" -"literal> when the values below." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -#. Tag: para -#: Websphere.xml:102 +#. Tag: title +#: Websphere.xml:92 #, no-c-format -msgid "" -"Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB " -"and not part of the Hotel Booking example. This means that if your " -"application's <literal>components.xml</literal> specifies " -"<literal>transaction:ejb-transaction</literal>, then you must include:" +msgid "Seam and the WebSphere JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: para +#: Websphere.xml:93 #, no-c-format msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +"In order to use component injection, Seam needs to know how to lookup for " +"session beans bound to the JNDI name space. Seam provides two mechanisms to " +"configure the way it will search for such resources:" msgstr "" -#. Tag: para -#: Websphere.xml:108 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format msgid "" -"in your web.xml. If you don't include it, you'll get the following error:" +"The global <literal>jndi-pattern</literal> switch on the <literal><core:" +"init></literal>. in <literal>components.xml</literal>. The switch can use " +"a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the " +"unqualified name of the EJB" msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:102 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "The <literal>@JndiName</literal> annotation" msgstr "" -#. Tag: literal -#: Websphere.xml:114 +#. Tag: para +#: Websphere.xml:108 #, no-c-format -msgid "resources/META-INF/persistence.xml" +msgid "gives detailed explanations on how those mechanisms work." msgstr "" #. Tag: para -#: Websphere.xml:117 +#: Websphere.xml:112 #, no-c-format msgid "" -"For this example we will be using the default datasource that comes with " -"WAS. To do this change the <literal>jta-data-source</literal> element:" +"By default, WebSphere will bind the session bean in its local JNDI name " +"space under a \"short\" binding name that adheres to the following pattern " +"<literal>ejblocal:<package.qualified.local.interface.name></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:120 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:121 +#: Websphere.xml:117 #, no-c-format msgid "" -"Then we need to adjust some of the hibernate properties. First comment out " -"the Glassfish properties. Next you need to add/change the properties:" +"For a detailed description on how WebSphere v7 organizes and binds EJBs in " +"its JNDI name spaces, please refer to the WebSphere Information Center." msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 -#, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:130 +#: Websphere.xml:120 #, no-c-format msgid "" -"<literal>hibernate.transaction.manager_lookup_class</literal> — " -"Standard Hibernate transaction manager property for WAS 6.X and 7" +"As explained before, Seam needs to lookup for session bean as they appear in " +"JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -#. Tag: para -#: Websphere.xml:136 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format msgid "" -"<literal>hibernate.transaction.flush_before_completion</literal> — " -"This is commented out because we want the container to manage the " -"transactions. Also if this is set to <literal>true</literal> an exception " -"will be thrown by WAS when the EJBContext is looked up." +"Specify which JNDI name Seam must use for each session bean using the " +"<literal>@JndiName</literal> annotation in the java source file" msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an " -"EJB]]>" +"Override the default session bean names generated by WebSphere to conform to " +"the <literal>jndi-pattern</literal> attribute" msgstr "" -#. Tag: para -#: Websphere.xml:148 +#. Tag: listitem +#: Websphere.xml:130 #, no-c-format -msgid "" -"<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " -"embedded DB was switched to the same Derby DB as is in Glassfish v2." +msgid "Use EJB references" msgstr "" -#. Tag: literal -#: Websphere.xml:158 Websphere.xml:750 +#. Tag: title +#: Websphere.xml:137 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" msgstr "" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:138 #, no-c-format msgid "" -"You will need to get the <literal>GlassfishDerbyDialect.java</literal> and " -"copy it into the <literal>/src</literal> directory. The java class exists in " -"the JPA example source directory and can be copied using the command below " -"assuming you are in <literal>jee5/booking</literal> directory:" +"This strategy is the simplest and fastest one regarding development. It uses " +"the WebSphere v7 default binding mechanism. To use this strategy:" msgstr "" -#. Tag: programlisting -#: Websphere.xml:169 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface." +"name>)</literal> annotation to each session bean that is a Seam component." msgstr "" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:145 Websphere.xml:188 #, no-c-format msgid "" -"This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." +"<para>In <literal>components.xml</literal>, add the following line:</para>" msgstr "" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: programlisting +#: Websphere.xml:147 Websphere.xml:220 #, no-c-format -msgid "resources/import.sql" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:151 #, no-c-format msgid "" -"This file must also be copied from the JPA example because either the Derby " -"DB or the dialect does not support changes to the <literal>ID</literal> " -"column. The files are identical except for the column difference. Use the " -"following command to make the copy" +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in " +"the web module with the following content:" msgstr "" #. Tag: programlisting -#: Websphere.xml:185 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util." +"DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming." +"WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util." +"WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -#. Tag: title -#: Websphere.xml:194 -#, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "" - #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:157 #, no-c-format -msgid "" -"In order to get the changes we have made into our application we need to " -"make some changes to the <literal>build.xml</literal>. There are also some " -"additional jars that are required by our application in order to work with " -"WAS. This section will cover what changes are needed to the <literal>build." -"xml</literal>." +msgid "At the end of <literal>web.xml</literal>, add the following lines:" msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "Library dependency changes" -msgstr "" - -#. Tag: para -#: Websphere.xml:205 -#, no-c-format msgid "" -"We remove the <literal>log4j.jar</literal> so that all of the log output " -"from our application will be added to the WAS log. Additional steps are " -"required to fully configure log4j and those are outside of the scope of this " -"document." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" -#. Tag: title -#: Websphere.xml:213 -#, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "" - #. Tag: para -#: Websphere.xml:215 +#: Websphere.xml:164 #, no-c-format msgid "" -"Add the following entry to the bottom of the <literal>build.xml</literal> " -"file. This overrides the default fileset that is used to populate the " -"<literal>jboss-seam-jee5.jar</literal>. :" +"That's all folks! No need to update any file during the development, nor to " +"define any EJB to EJB or web to EJB reference!" msgstr "" -#. Tag: programlisting -#: Websphere.xml:223 -#, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:167 #, no-c-format msgid "" -"Now all that is left is to execute the <literal>ant archive</literal> task " -"and the built application will be in the <literal>jee5/booking/dist</" -"literal> directory." +"Compared to the other strategies, this strategy has the advantage not to " +"have to manage any EJBs reference and also not to have to maintain extra " +"files. The only drawback is one extra line in the java source code with the " +"<literal>@JndiName</literal> annotation" msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:174 #, no-c-format -msgid "Deploying the application to Websphere" +msgid "Strategy 2: Override the default names generated by WebSphere" msgstr "" -#. Tag: para -#: Websphere.xml:236 +#. Tag: section +#: Websphere.xml:174 #, no-c-format msgid "" -"So now we have everything we need in place. All that is left is to deploy it " -"- just a few steps more." +"There is no simple way to globally override the default naming strategy for " +"session beans in WebSphere. However, WebSphere provides a way to override " +"the name of each bean." msgstr "" #. Tag: para -#: Websphere.xml:238 +#: Websphere.xml:177 #, no-c-format -msgid "" -"For this we will use Websphere's administration console. As before there are " -"some tricks and tips that must be followed." +msgid "To use this strategy:" msgstr "" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:181 #, no-c-format msgid "" -"The steps below are for the WAS version stated above. The ports are default " -"values, if you changed them substitute your values." +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB " +"module and add an entry for each session bean like this: <programlisting " +"role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=" +"\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction" +"\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the " +"<literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:" +"AuthenticatorAction</literal> JNDI name" msgstr "" -#. Tag: para -#: Websphere.xml:245 -#, no-c-format -msgid "" -"Log in to the administration console <programlisting><![CDATA[https://" -"localhost:9043/admin]]></programlisting> or" -msgstr "" - #. Tag: programlisting -#: Websphere.xml:250 +#: Websphere.xml:190 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" msgstr "" #. Tag: para -#: Websphere.xml:254 +#: Websphere.xml:194 #, no-c-format msgid "" -"Access the <literal>Websphere enterprise applications</literal> menu option " -"under the <literal>Applications --> Application Type</literal> left side " -"menu." +"Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as " +"described in strategy 1" msgstr "" #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:199 #, no-c-format msgid "" -"At the top of the <literal>Enterprise Applications</literal> table select " -"<literal>Install</literal>. Below are installation wizard pages and what " -"needs to done on each:" +"In <literal>web.xml</literal>, add the following lines (Note the different " +"<literal>ejb-ref-name</literal> value):" msgstr "" -#. Tag: literal -#: Websphere.xml:265 Websphere.xml:461 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Preparing for the application installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:269 -#, no-c-format msgid "" -"Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</" -"literal> file using the file upload widget." +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" msgstr "" #. Tag: para -#: Websphere.xml:275 Websphere.xml:285 Websphere.xml:304 Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:206 #, no-c-format -msgid "Select the <literal>Next</literal> button." -msgstr "" - -#. Tag: para -#: Websphere.xml:280 Websphere.xml:471 -#, no-c-format -msgid "Select the <literal>Fast Path</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:292 -#, no-c-format -msgid "Select installation options" -msgstr "" - -#. Tag: para -#: Websphere.xml:296 -#, no-c-format msgid "" -"Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB " -"reference targets to resolve automatically</literal> check boxes. This is " -"needed unless you used a Websphere AS tool to package the application." +"Compared to the first strategy, this strategy requires to maintain an extra " +"file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be " +"added each time a new session bean is added to the application), but still " +"does not require to maintain EJB reference between beans." msgstr "" -#. Tag: literal -#: Websphere.xml:313 +#. Tag: title +#: Websphere.xml:215 #, no-c-format -msgid "Map modules to servers" +msgid "Strategy 3: Use EJB references" msgstr "" -#. Tag: para -#: Websphere.xml:317 +#. Tag: section +#: Websphere.xml:215 #, no-c-format msgid "" -"No changes needed here as we only have one server. Select the <literal>Next</" -"literal> button." +"This strategy is based on the usage of EJB references, from EJB to EJB and " +"from the web module to EJB. To use it:" msgstr "" -#. Tag: literal -#: Websphere.xml:325 +#. Tag: listitem +#: Websphere.xml:218 #, no-c-format -msgid "Summary" -msgstr "" - -#. Tag: para -#: Websphere.xml:328 -#, no-c-format -msgid "No changes needed here. Select the <literal>Finish</literal> button." -msgstr "" - -#. Tag: literal -#: Websphere.xml:335 -#, no-c-format -msgid "Installation" -msgstr "" - -#. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." -msgstr "" - -#. Tag: para -#: Websphere.xml:343 -#, no-c-format msgid "" -"When it finishes select the <literal>Save</literal> link and you will be " -"returned to the <literal>Enterprise Applications</literal> table." +"<listitem>In <literal>components.xml</literal>, add the following line:</" +"listitem>" msgstr "" #. Tag: para -#: Websphere.xml:355 +#: Websphere.xml:223 #, no-c-format msgid "" -"Now that we have our application installed we need to make some adjustments " -"to it before we can start it:" +"Follow the instructions in <xref linkend=\"config.integration.ejb.container" +"\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:228 #, no-c-format msgid "" -"Starting from the <literal>Enterprise Applications</literal> table select " -"the <literal>Seam Booking</literal> link." +"This is the most tedious strategy as each session bean referenced by another " +"session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</" +"literal> file. Also, each new session bean has to be added to the list of " +"referenced bean in <literal>web.xml</literal>" msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: title +#: Websphere.xml:239 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." +msgid "Configuring timeouts for Stateful Session Beans" msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:240 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "" - -#. Tag: para -#: Websphere.xml:374 -#, no-c-format msgid "" -"Change the <literal>Class loader order</literal> combo box to " -"<literal>Classes loaded with application class loader first (parent last)</" -"literal>." +"A timeout value has to be set for each stateful session bean used in the " +"application because stateful bean must not expire in WebSphere while Seam " +"might still need thenm. At the time of writing this document, WebSphere does " +"not provide a way to configure a global timeout at neither the cluster, " +"server, application nor ejb-jar level. It has to be done for each stateful " +"bean individually. This is done by adding a file named <literal>META-INF/ibm-" +"ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value " +"for each bean:" msgstr "" -#. Tag: para -#: Websphere.xml:380 Websphere.xml:397 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format msgid "" -"Select <literal>Apply</literal> and then <literal>Save</literal> options." +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-" +"ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></" +"session>\n" +" \n" +"</ejb-jar-ext>]]>" msgstr "" #. Tag: para -#: Websphere.xml:384 +#: Websphere.xml:248 #, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "" - -#. Tag: para -#: Websphere.xml:387 -#, no-c-format msgid "" -"On this page select the <literal>Class loading and update detection</" -"literal> link." +"The <literal>time-out</literal> is expressed in seconds and must be higher " +"than the Seam conversation expiration timeout and a few minutes higher than " +"the user's HTTP session timeout (The session expiration timeout can trigger " +"a few minutes after the number of minutes declared to expire s for the HTTP " +"session expiration)." msgstr "" -#. Tag: para -#: Websphere.xml:392 -#, no-c-format -msgid "" -"Select the radio button for <literal>Classes loaded with application class " -"loader first</literal>." -msgstr "" - -#. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "" -"To start the application return to the <literal>Enterprise Applications</" -"literal> table and select our application in the list. Then choose the " -"<literal>Start</literal> button at the top of the table." -msgstr "" - -#. Tag: para -#: Websphere.xml:410 -#, no-c-format -msgid "" -"You can now access the application at <literal>http://localhost:9080/seam-" -"jee5-booking/index.html</literal> ." -msgstr "" - #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:257 #, no-c-format -msgid "The <literal>jpa</literal> booking example" +msgid "The <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:432 +#: Websphere.xml:259 #, no-c-format msgid "" -"Thankfully getting the <literal>jpa</literal> example to work is much easier " -"than the <literal>jee5</literal> example. This is the Hotel Booking example " -"implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It " -"does not use EJB3." +"The<literal>jee5/booking</literal>example is based on the Hotel Booking " +"example (which runs on JBoss AS). Out of the box, it is designed to run on " +"Glassfish, but with the following steps, it can be deployed on WebSphere. It " +"is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:437 +#: Websphere.xml:265 #, no-c-format msgid "" -"The example already has a breakout of configurations and build scripts for " -"many of the common containers including Websphere." +"For running this example, we'll use the second JNDI mapping strategy " +"(\"Override the default names generated by WebSphere\") as we don't want to " +"change the java code to add the <literal>@JndiName</literal> annotation as " +"in the first strategy." msgstr "" -#. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "" -"First thing we are going to do is build and deploy that example. Then we'll " -"go over some key changes that we needed." -msgstr "" - #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:271 #, no-c-format -msgid "Building the <literal>jpa</literal> example" +msgid "Building the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:273 #, no-c-format msgid "" "Building it only requires running the correct ant command: " -"<programlisting>ant websphere7</programlisting> This will create container " -"specific distribution and exploded archive directories with the " -"<literal>websphere7</literal> label." +"<programlisting>ant -f build-websphere7.xml</programlisting> This will " +"create container specific distribution and exploded archive directories with " +"the <literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:280 #, no-c-format -msgid "Deploying the <literal>jpa</literal> example" +msgid "Deploying the <literal>jee5/booking</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:281 #, no-c-format msgid "" -"This is similar to the <literal>jee5</literal> example at <xref linkend=" -"\"jee5-websphere-deploy\"/>, but without so many steps." +"The steps below are for the WAS version stated above.The ports are default " +"values, if you changed them, you must substitute the values." msgstr "" -#. Tag: para -#: Websphere.xml:457 +#. Tag: listitem +#: Websphere.xml:284 #, no-c-format msgid "" -"From the <literal>Enterprise Applications</literal> table select the " -"<literal>Install</literal> button." +"Log in to the administration console <programlisting><![CDATA[http://" +"localhost:9060/admin]]></programlisting> Enter your userid annd/or your " +"password if security is enabled for the console." msgstr "" #. Tag: para -#: Websphere.xml:465 +#: Websphere.xml:291 #, no-c-format msgid "" -"Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" -"literal> file using the file upload widget." +"Go to the <literal>WebSphere enterprise applications</literal> menu option " +"under the <literal>Applications --> Application Type</literal> left side " +"menu." msgstr "" #. Tag: para -#: Websphere.xml:483 +#: Websphere.xml:298 #, no-c-format msgid "" -"Select the <literal>Next</literal> button for the next three pages, no " -"changes are needed." +"At the top of the <literal>Enterprise Applications</literal> table select " +"<literal>Install</literal>. Below are installation wizard pages and what " +"needs to done on each:" msgstr "" #. Tag: literal -#: Websphere.xml:488 +#: Websphere.xml:304 #, no-c-format -msgid "Map context roots for Web modules" +msgid "Preparing for the application installation" msgstr "" #. Tag: para -#: Websphere.xml:491 +#: Websphere.xml:307 #, no-c-format msgid "" -"In the <literal>Context root</literal> text box enter <literal>jboss-seam-" -"jpa</literal>." +"Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5." +"ear</literal> file using the file upload widget." msgstr "" #. Tag: para -#: Websphere.xml:502 +#: Websphere.xml:313 Websphere.xml:323 Websphere.xml:341 #, no-c-format -msgid "<literal>Summary</literal> page" +msgid "Select the <literal>Next</literal> button." msgstr "" #. Tag: para -#: Websphere.xml:505 +#: Websphere.xml:318 #, no-c-format -msgid "" -"Review the settings if you wish and select the <literal>Finish</literal> " -"button to install the application. When installation finished select the " -"<literal> Save</literal> link and you will be returned to the " -"<literal>Enterprise Applications</literal> table." +msgid "Select the <literal>Fast Path</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:519 +#. Tag: literal +#: Websphere.xml:332 #, no-c-format -msgid "" -"As with the <literal>jee5</literal> example there are some class loader " -"changes needed before we start the application. Follow the instructions at " -"<xref linkend=\"websphere-app-adj-after-install\"/> but exchange " -"<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +msgid "Select installation options" msgstr "" #. Tag: para -#: Websphere.xml:526 +#: Websphere.xml:335 #, no-c-format msgid "" -"Finally start the application by selecting it in the <literal>Enterprise " -"Applications</literal> table and clicking the <literal>Start</literal> " -"button." +"Select the <literal>Deploy enterprise beans and Allow EJB reference targets " +"to resolve automatically</literal> check boxes at the bottom of the page. " +"This will let WebSphere use its simplified JNDI reference mapping." msgstr "" -#. Tag: para -#: Websphere.xml:532 +#. Tag: literal +#: Websphere.xml:350 #, no-c-format -msgid "" -"You can now access the application at the <literal>http://localhost:9080/" -"jboss-seam-jpa/index.html</literal>." +msgid "Map modules to servers" msgstr "" -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "" - #. Tag: para -#: Websphere.xml:541 +#: Websphere.xml:353 #, no-c-format msgid "" -"The differences between the JPA examples that deploys to JBoss 4.2 and " -"Websphere AS V7 are mostly expected; library and configuration file changes." +"No changes needed here as we only have one server. Select the <literal>Next</" +"literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:546 +#. Tag: literal +#: Websphere.xml:362 #, no-c-format -msgid "<para>Configuration file changes</para>" +msgid "Map virtual hosts for Web modules" msgstr "" #. Tag: para -#: Websphere.xml:549 +#: Websphere.xml:365 #, no-c-format msgid "" -"<literal>META-INF/persistence.xml</literal> — the main changes here " -"are for the datasource JNDI path, switching to the Websphere transaction " -"manager look up class, and changing the hibernate dialect to be " -"<literal>GlassfishDerbyDialect</literal> ." +"No changes needed here as we only have one virtual host. Select the " +"<literal>Next</literal>button." msgstr "" -#. Tag: para -#: Websphere.xml:559 +#. Tag: literal +#: Websphere.xml:374 #, no-c-format -msgid "" -"<literal>WEB-INF/components.xml</literal> — the change here is " -"<literal>jndi-pattern</literal> without /local string." +msgid "Summary" msgstr "" #. Tag: para -#: Websphere.xml:565 +#: Websphere.xml:377 #, no-c-format -msgid "" -"<literal>META-INF/ejb-jar.xml</literal> — the same change in " -"<literal>ejb-ref-name</literal>, where is replace /local string in " -"<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "" -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "" -"<literal>src/GlassfishDerbyDialect.java </literal> — this class is " -"needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</" -"literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "" -"<literal>import.sql</literal> — either for the dialect or Derby DB the " -"<literal>ID</literal> column can not be populated by this file and was " -"removed." -msgstr "" - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "" -"The Websphere version requires several library packages because they are not " -"included as they are with JBoss AS. These are primarily for hibernate and " -"their dependencies. Below are listed only the additional jars needed above " -"and beyond the JBoss <literal>JPA</literal> example." -msgstr "" - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "" - #. Tag: literal -#: Websphere.xml:602 +#: Websphere.xml:384 #, no-c-format -msgid "hibernate.jar" +msgid "Installation" msgstr "" -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "" - #. Tag: para -#: Websphere.xml:638 +#: Websphere.xml:387 #, no-c-format -msgid "Various third party jars that Websphere needs:" +msgid "Now you will see WebSphere installing and deploying your application." msgstr "" -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "" -"Deploying an application created using <literal>seam-gen</literal> on " -"Websphere V7" -msgstr "" - #. Tag: para -#: Websphere.xml:681 +#: Websphere.xml:390 #, no-c-format msgid "" -"<literal>seam-gen</literal> is a very useful tool for developers to quickly " -"get an application up and running, and provides a foundation to add your own " -"functionality. Out of box <literal>seam-gen</literal> will produce " -"applications configured to run on JBoss AS. These instructions will show the " -"steps needed to get it to run on Websphere. As stated above in <xref linkend=" -"\"jee5-websphere-section\"/> there are some tricky changes needed to get an " -"EJB3 application running. This section will take you through the exact steps." +"When done, select the <literal>Save</literal> link and you will be returned " +"to the <literal>Enterprise Applications</literal> table." msgstr "" -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "" - #. Tag: para -#: Websphere.xml:692 +#: Websphere.xml:399 #, no-c-format msgid "" -"The first step is setting up <literal>seam-gen</literal> to construct the " -"base project. There are several choices made below, specifically the " -"datasource and hibernate values that we will adjust once the project is " -"created." +"To start the application select our application in the list, then click on " +"the <literal>Start</literal> button at the top of the table." msgstr "" -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains " -"your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." -"GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been " -"set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " -"wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a " -"WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss." -"seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss." -"seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss." -"seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." -"test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, " -"oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/" -"hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb." -"jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] " -"[]\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) " -"[] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? " -"[n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data " -"in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." -"properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" -"default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:409 #, no-c-format msgid "" -"Type <literal>./seam new-project</literal> to create your project and " -"<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " -"newly created structure." +"You can now access the application at <literal>http://localhost:9080/seam-" +"jee5-booking</literal>" msgstr "" #. Tag: title -#: Websphere.xml:707 +#: Websphere.xml:418 #, no-c-format -msgid "Changes needed for deployment to Websphere" +msgid "Deviation from the original base files" msgstr "" -#. Tag: para -#: Websphere.xml:708 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "" - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format msgid "" -"Alter the <literal>jta-data-source</literal> to be " -"<literal>DefaultDatasource</literal>. We are going to be using the " -"integrated Websphere DB." +"Below are the differences between the base configuration files and the " +"WebSphere specific files held in the <literal>resources-websphere7</literal> " +"directory." msgstr "" #. Tag: para -#: Websphere.xml:726 +#: Websphere.xml:422 #, no-c-format msgid "" -"Add or change the properties below. These are described in detail at <xref " -"linkend=\"jee5-websphere-section\"/>:" +"<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB " +"references" msgstr "" -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction." -"WebSphereExtendedJTATransactionLookup\"/>]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:734 +#: Websphere.xml:428 #, no-c-format msgid "" -"Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +"<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere " +"specific file has been added as we use the second JNDI mapping strategy. It " +"defines, for each session bean, the name WebSphere will use to bind it its " +"JNDI name space" msgstr "" -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:740 +#: Websphere.xml:435 #, no-c-format msgid "" -"You'll need to alter <literal>persistence-prod.xml</literal> as well if you " -"want to deploy to Websphere using the prod profile." +"<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere " +"specific file defines to WebSphere, the timeout value for each stateful bean" msgstr "" #. Tag: para -#: Websphere.xml:753 +#: Websphere.xml:441 #, no-c-format msgid "" -"As with other examples we need to include this java class for DB support. It " -"can be copied from the <literal>jpa</literal> example into the " -"<literal>websphere_example/src</literal> directory." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager lookup class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:768 +#: Websphere.xml:451 #, no-c-format msgid "" -"You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-" -"app.xml</literal> is used to enable classloading isolation in JBoss AS)" +"<literal>WEB-INF/components.xml</literal> — the change here is " +"<literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</" +"literal> as using the second JNDI matching strategy" msgstr "" -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "" - #. Tag: para -#: Websphere.xml:777 +#: Websphere.xml:459 #, no-c-format msgid "" -"You can delete these file as we aren't deploying to JBoss AS (these files " -"define datasources in JBoss AS, we are using Websphere's default datasource)" +"<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local " +"ref</literal> except the one for <literal>EjbSynchronizations</literal> " +"bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</" +"literal>" msgstr "" #. Tag: para -#: Websphere.xml:789 +#: Websphere.xml:467 Websphere.xml:549 #, no-c-format msgid "" -"Enable container managed transaction integration - add the <literal> <" -"transaction:ejb-transaction /> </literal> component, and it's namespace " -"declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/" -"transaction\" </literal>" +"<literal>import.sql</literal> — due to the cutomized hibernate Derby " +"dialect, the <literal>ID</literal> column can not be populated by this file " +"and was removed." msgstr "" #. Tag: para -#: Websphere.xml:798 +#: Websphere.xml:474 #, no-c-format msgid "" -"Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" -"websphere_example/#{ejbName} </literal>" +"Also the build procedure has been changed to include the <literal>log4j.jar</" +"literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr "" -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "" -"We do not need <literal>managed-persistence-context</literal> for this " -"example and so can delete its entry." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/" -"websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "" -"As with the <literal>jee5/booking</literal> example we need to add EJB " -"references to the web.xml. These references require replacing /local string " -"in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the " -"proper binding." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:486 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +msgid "The <literal>jpa</literal> booking example" msgstr "" #. Tag: para -#: Websphere.xml:834 +#: Websphere.xml:488 #, no-c-format msgid "" -"We want to take the existing <literal>Authenticator</literal> Seam POJO " -"component and create an EJB3 out of it." +"This is the Hotel Booking example implemented in Seam POJOs and using " +"Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "" #. Tag: para -#: Websphere.xml:837 +#: Websphere.xml:493 #, no-c-format -msgid "Change the generated Authenticator class" -msgstr "" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format msgid "" -"Add the <literal>@Stateless</literal> annotation to the new " -"<literal>AuthenticatorAction</literal> class." +"The example already has a breakout of configurations and build scripts for " +"many of the common containers including WebSphere." msgstr "" #. Tag: para -#: Websphere.xml:850 +#: Websphere.xml:498 #, no-c-format msgid "" -"Create an interface called <literal>Authenticator</literal> which " -"<literal>AuthenticatorAction</literal> implements (EJB3 requires session " -"beans to have a local interface). Annotate the interface with " -"<literal>@Local</literal> , and add a single method with same signature as " -"the <literal>authenticate</literal> in <literal>AuthenticatorAction</" -"literal> ." +"First thing, we are going to do is build and deploy that example. Then we'll " +"go over some key changes that we needed." msgstr "" -#. Tag: programlisting -#: Websphere.xml:863 +#. Tag: title +#: Websphere.xml:504 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Building the <literal>jpa</literal> example" msgstr "" -#. Tag: programlisting -#: Websphere.xml:866 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:869 +#: Websphere.xml:505 #, no-c-format msgid "" -"We've already added its reference to the <literal>web.xml</literal> file so " -"are good to go." +"Building it only requires running the correct ant command: " +"<programlisting>ant websphere7</programlisting> This will create container " +"specific distribution and exploded archive directories with the " +"<literal>websphere7</literal> label." msgstr "" #. Tag: title -#: Websphere.xml:875 +#: Websphere.xml:514 #, no-c-format -msgid "" -"Extra jar dependencies and other changes to the <literal>build.xml</literal>" +msgid "Deploying the <literal>jpa</literal> example" msgstr "" #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:515 #, no-c-format msgid "" -"This application has similar requirements as the <literal>jee5/booking</" -"literal> example." +"Deploying <literal>jpa</literal> application is very similar to the " +"<literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-" +"deploy\"/>. The main difference is, that this time, we will deploy a war " +"file instead of an ear file, and we'll have to manually specify the context " +"root of the application." msgstr "" #. Tag: para -#: Websphere.xml:882 +#: Websphere.xml:521 #, no-c-format msgid "" -"Change the default target to <literal>archive</literal> (we aren't going to " -"cover automatic deployment to Websphere)." +"Follow the same instructions as for the <literal>jee5/booking</literal> " +"sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +"literal> file on the first page and on the <literal>Map context roots for " +"Web modules</literal> page (after the <literal>Map virtual host for Web " +"module</literal>), enter the context root you want to use for your " +"application in the <literal>Contect Root</literal> input field." msgstr "" -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -msgstr "" - #. Tag: para -#: Websphere.xml:892 +#: Websphere.xml:528 #, no-c-format msgid "" -"Websphere looks for the drools <literal>/security.drl</literal> file in the " -"root of the <literal>war</literal> file instead of the root of the " -"<literal>websphere_example.jar</literal> so we need to have the " -"<literal>build.xml</literal> move it to the correct location at build time. " -"The following must be added at the top of the <literal> <target name=\"war" -"\" depends=\"compile\" description=\"Build the distribution .war file\"> " -"</literal> target." +"When started, you can now access the application at the <literal>http://" +"localhost:9080/<context root></literal>." msgstr "" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "" -"Now we need to get extra jars into the <literal>build.xml</literal>. Look " -"for the <literal><fileset dir=\"${basedir}\"></literal> section of the " -"task below. Add the new includes at the bottom of the fileset." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "" -"<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" -"literal> base directory." -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" - #. Tag: title -#: Websphere.xml:940 +#: Websphere.xml:534 #, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" +msgid "Deviation from the generic base files" msgstr "" -#. Tag: para -#: Websphere.xml:945 +#. Tag: section +#: Websphere.xml:534 #, no-c-format msgid "" -"Build your application by calling <literal>ant</literal> in the base " -"directory of your project (ex. <literal>/home/jbalunas/workspace/" -"websphere_example</literal> ). The target of the build will be <literal>dist/" -"websphere_example.ear</literal> ." +"Below are the configuration file differences between the base configuration " +"files and the files customized for WebSphere held in the <literal>resources-" +"websphere7</literal> directory." msgstr "" #. Tag: para -#: Websphere.xml:954 +#: Websphere.xml:539 #, no-c-format msgid "" -"To deploy the application follow the instructions here : <xref linkend=" -"\"jee5-websphere-deploy\"/> but use references to this project " -"<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" -"literal>." +"<literal>META-INF/persistence.xml</literal> — The main changes here " +"are for the datasource JNDI path, switching to the WebSphere transaction " +"manager look up class, turning off the <literal>hibernate.transaction." +"flush_before_completion</literal> toggle, and forcing the Hibernate dialect " +"to be <literal>GlassfishDerbyDialect</literal> how as using the integrated " +"Derby database" msgstr "" #. Tag: para -#: Websphere.xml:960 +#: Websphere.xml:556 #, no-c-format msgid "" -"Checkout the app at: <literal>http://localhost:9080/websphere_example/index." -"html</literal>" +"Also the build procedure have been changed to include the <literal>log4j." +"jar</literal> file and exclude the <literal>concurrent.jar</literal> and " +"<literal>jboss-common-core.jar</literal> files." msgstr ""

15 years, 4 months

1
0
0 / 0

Seam SVN: r11416 - branches/community/Seam_2_2/doc/Seam_Reference_Guide/it-IT.

by seam-commits＠lists.jboss.org

Author: nico.ben Date: 2009-08-22 09:26:23 -0400 (Sat, 22 Aug 2009) New Revision: 11416 Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/it-IT/Author_Group.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/it-IT/Excel.po branches/community/Seam_2_2/doc/Seam_Reference_Guide/it-IT/Websphere.po Log: Italian translation Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/it-IT/Author_Group.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/it-IT/Author_Group.po 2009-08-21 08:45:14 UTC (rev 11415) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/it-IT/Author_Group.po 2009-08-22 13:26:23 UTC (rev 11416) @@ -5,8 +5,8 @@ msgstr "" "Project-Id-Version: seam 2_0\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:18+0000\n" -"PO-Revision-Date: 2009-05-16 21:24+0100\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" +"PO-Revision-Date: 2009-08-22 15:23+0100\n" "Last-Translator: Nicola Benaglia <nico.benaz(a)gmail.com>\n" "Language-Team: none\n" "MIME-Version: 1.0\n" @@ -106,92 +106,98 @@ #. Tag: author #: Author_Group.xml:66 #, no-c-format +msgid "<firstname>Denis</firstname> <surname>Forveille</surname>" +msgstr "<firstname>Denis</firstname> <surname>Forveille</surname>" + +#. Tag: author +#: Author_Group.xml:70 +#, no-c-format msgid "<firstname>Marek</firstname> <surname>Novotny</surname>" msgstr "<firstname>Marek</firstname> <surname>Novotny</surname>" #. Tag: othercredit -#: Author_Group.xml:70 +#: Author_Group.xml:74 #, no-c-format msgid "<firstname>James</firstname> <surname>Cobb</surname>" msgstr "<firstname>James</firstname> <surname>Cobb</surname>" #. Tag: shortaffil -#: Author_Group.xml:74 -#: Author_Group.xml:81 +#: Author_Group.xml:78 +#: Author_Group.xml:85 #, no-c-format msgid "Graphic Design" msgstr "Design Grafico" #. Tag: othercredit -#: Author_Group.xml:77 +#: Author_Group.xml:81 #, no-c-format msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" msgstr "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" #. Tag: othercredit -#: Author_Group.xml:84 +#: Author_Group.xml:88 #, no-c-format msgid "<firstname>Mark</firstname> <surname>Newton</surname>" msgstr "<firstname>Mark</firstname> <surname>Newton</surname>" #. Tag: othercredit -#: Author_Group.xml:88 +#: Author_Group.xml:92 #, no-c-format msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" msgstr "<firstname>Steve</firstname> <surname>Ebersole</surname>" #. Tag: othercredit -#: Author_Group.xml:92 +#: Author_Group.xml:96 #, no-c-format msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" msgstr "<firstname>Michael</firstname> <surname>Courcy</surname>" #. Tag: shortaffil -#: Author_Group.xml:96 +#: Author_Group.xml:100 #, no-c-format msgid "French Translation" msgstr "Traduzione in francese" #. Tag: othercredit -#: Author_Group.xml:99 +#: Author_Group.xml:103 #, no-c-format msgid "<firstname>Nicola</firstname> <surname>Benaglia</surname>" msgstr "<firstname>Nicola</firstname> <surname>Benaglia</surname>" #. Tag: shortaffil -#: Author_Group.xml:103 -#: Author_Group.xml:110 -#: Author_Group.xml:117 +#: Author_Group.xml:107 +#: Author_Group.xml:114 +#: Author_Group.xml:121 #, no-c-format msgid "Italian Translation" msgstr "Traduzione in italiano" #. Tag: othercredit -#: Author_Group.xml:106 +#: Author_Group.xml:110 #, no-c-format msgid "<firstname>Stefano</firstname> <surname>Travelli</surname>" msgstr "<firstname>Stefano</firstname> <surname>Travelli</surname>" #. Tag: othercredit -#: Author_Group.xml:113 +#: Author_Group.xml:117 #, no-c-format msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>" msgstr "<firstname>Francesco</firstname> <surname>Milesi</surname>" #. Tag: othercredit -#: Author_Group.xml:120 +#: Author_Group.xml:124 #, no-c-format msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" msgstr "<firstname>Japan</firstname> <surname>JBoss User Group</surname>" #. Tag: shortaffil -#: Author_Group.xml:124 +#: Author_Group.xml:128 #, no-c-format msgid "Japanese Translation" msgstr "Traduzione in giapponese" #. Tag: editor -#: Author_Group.xml:127 +#: Author_Group.xml:131 #, no-c-format msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>" msgstr "<firstname>Samson</firstname> <surname>Kittoli</surname>" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/it-IT/Excel.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/it-IT/Excel.po 2009-08-21 08:45:14 UTC (rev 11415) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/it-IT/Excel.po 2009-08-22 13:26:23 UTC (rev 11416) @@ -5,8 +5,8 @@ msgstr "" "Project-Id-Version: Seam_Reference_Guide\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-07-03 07:29+0000\n" -"PO-Revision-Date: 2009-07-08 16:29+0100\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" +"PO-Revision-Date: 2009-08-22 15:23+0100\n" "Last-Translator: Nicola Benaglia <nico.benaz(a)gmail.com>\n" "Language-Team: none\n" "MIME-Version: 1.0\n" @@ -888,8 +888,8 @@ msgid "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" @@ -901,8 +901,8 @@ msgstr "" "<![CDATA[\n" " <e:workbook>\n" -" <e:worksheet>\n" -" <e:column value=\"#{personList}\" var=\"person\">\n" +" <e:worksheet value=\"#{personList}\" var=\"person\">\n" +" <e:column>\n" " <f:facet name=\"header\">\n" " <e:cell value=\"Last name\"/>\n" " </f:facet>\n" Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/it-IT/Websphere.po =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/it-IT/Websphere.po 2009-08-21 08:45:14 UTC (rev 11415) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/it-IT/Websphere.po 2009-08-22 13:26:23 UTC (rev 11416) @@ -5,8 +5,8 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-25 15:02+0000\n" -"PO-Revision-Date: 2009-06-25 17:06+0100\n" +"POT-Creation-Date: 2009-08-22 13:17+0000\n" +"PO-Revision-Date: 2009-08-22 15:25+0100\n" "Last-Translator: Nicola Benaglia <nico.benaz(a)gmail.com>\n" "Language-Team: none\n" "MIME-Version: 1.0\n" @@ -16,1679 +16,2032 @@ #. Tag: title #: Websphere.xml:2 #, no-c-format -msgid "Seam on IBM's Websphere AS" -msgstr "Seam su Websphere AS di IBM" +msgid "Seam on IBM's WebSphere AS v7" +msgstr "Seam su Websphere AS di IBM v7" -#. Tag: para -#: Websphere.xml:4 +#. Tag: title +#: Websphere.xml:5 #, no-c-format -msgid "Websphere AS V7 is IBM's application server offering. This release is fully Java EE 5 certified." -msgstr "Websphere AS V7 è l'application server di IBM. Questa release è pienamente certificata Java EE 5." +msgid "WebSphere AS environment and version recommendation" +msgstr "Informazioni sull'ambiente e raccomandazioni sulle versioni di Websphere AS" #. Tag: para #: Websphere.xml:7 #, no-c-format -msgid "First we will go over some basic information about the Websphere AS environment that we used for these examples. We will go over the details of those steps with the JEE5 booking example. We will also deploy the JPA example application." -msgstr "Innanzitutto procediamo con alcune informazioni base sull'ambiente Websphere AS che useremo negli esempi. Andremo a fondo nei dettagli con l'esempio JEE5 Prenotazione. Procederemo anche nel deploy di un'applicazione d'esempio JPA." +msgid "WebSphere Application Server v7 is IBM's application server offering. This release is fully Java EE 5 certified." +msgstr "Websphere Application Server v7 è l'application server di IBM. Questa release è pienamente certificata Java EE 5." -#. Tag: title -#: Websphere.xml:13 -#, no-c-format -msgid "Websphere AS environment and deployment information" -msgstr "Informazioni sull'ambiente ed il deploy in Websphere AS" - #. Tag: para -#: Websphere.xml:15 -#, no-c-format -msgid "Websphere AS is a commercial product and so we will not discuss the details of its installation other than to say follow the directions provided by your particular installation type and license. This section will detail the exact server versions used, installation tips, and some custom properties that are needed for all of the examples." +#: Websphere.xml:12 +#, fuzzy, no-c-format +msgid "WebSphere AS being a commercial product, we will not discuss the details of its installation. At best, we will instruct you to follow the directions provided by your particular installation type and license." msgstr "Websphere AS è un prodotto commerciale e quindi non si discuteranno i dettagli della sua installazione, basta dire di seguire le istruzioni fornite dal particolare tipo di installazione e dalla licenza. Questa sezione dettaglierà le versioni del server, i suggerimenti sull'installazione ed alcune proprietà specifiche necessarie negli esempi." -#. Tag: title -#: Websphere.xml:23 -#, no-c-format -msgid "Installation versions" -msgstr "Versioni delle installazioni" +#. Tag: para +#: Websphere.xml:18 +#, fuzzy, no-c-format +msgid "First, we will go over some basic considerations on how to run Seam applications under WebSphere AS v7. We will go over the details of these steps using the JEE5 booking example. We will also deploy the JPA (non-EJB3) example application." +msgstr "Innanzitutto procediamo con alcune informazioni base sull'ambiente Websphere AS che useremo negli esempi. Andremo a fondo nei dettagli con l'esempio JEE5 Prenotazione. Procederemo anche nel deploy di un'applicazione d'esempio JPA." #. Tag: para #: Websphere.xml:24 #, no-c-format -msgid "All of the examples and information in this chapter are based on the version V7 of Websphere AS at the time of this writing." -msgstr "Tutti gli esempi e le informazioni in questo capitolo sono basate sulla versione V7 di Websphere AS al momento della scrittura." +msgid "All of the examples and information in this chapter are based on WebSphere AS v7. A trial version can be downloaded here : <ulink url=\"http://www.ibm.com/developerworks/downloads/ws/was\"> WebSphere Application Server V7</ulink>" +msgstr "" -#. Tag: ulink +#. Tag: para #: Websphere.xml:29 #, no-c-format -msgid "Websphere Application Server V7" -msgstr "Websphere Application Server V7" +msgid "WebSphere v7.0.0.3 is the minimal recommended version of WebSphere v7 to use with Seam. Earlier versions of WebSphere have bugs in the EJB container that will cause various exceptions to occur at runtime." +msgstr "" #. Tag: para -#: Websphere.xml:34 +#: Websphere.xml:35 #, no-c-format -msgid "After installing Websphere AS, create server profile with Profile Management Tool, if you didn't create profile in installation process." -msgstr "Dopo l'installazione di Websphere AS, creare il profile del server con il Profile Management Tool, qualora non si sia creato il profile in fase di installazione." +msgid "The following sections in this chapter assume that WebSphere is correctly installed and is functional, and a profile has been successfully created." +msgstr "" -#. Tag: title -#: Websphere.xml:42 -#, no-c-format -msgid "The <literal>jee5/booking</literal> example" -msgstr "L'esempio <literal>jee5/booking</literal>" - #. Tag: para -#: Websphere.xml:44 +#: Websphere.xml:40 #, no-c-format -msgid "The <literal>jee5/booking</literal> example is based on the Hotel Booking example (which runs on JBoss AS). Out of the box it is designed to run on Glassfish, but with the steps below it can be deployed to Websphere. It is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." -msgstr "L'esempio <literal>jee5/booking</literal> è basato sull'esempio PrenotazioneHotel (che gira su JBoss AS). E' stato progettato per girare anche su Glassfish, ma con i passi descritti sotto può essere deployato in Websphere. E' collocato nella directory <literal>$SEAM_DIST/examples/jee5/booking</literal>." +msgid "This chapter explain how to compile, deploy and run some sample applications in WebSphere. These sample applications require a database. WebSphere comes by default with a set of sample applications called \"Default Application\". This set of sample applications use a Derby database running on the Derby instance installed with WebSphere. In order to keep this simple we'll use this Derby database created for the \"Default Applications\". However, to run the sample application with the Derby database \"as-is\", a patched Hibernate dialect must be used (The patch changes the default \"auto\" key generation strategy) as explained in <xref linkend=\"glassfish\"/>. If you want to use another database, it's just a matter of creating a connection pool in WebSphere pointing to this database, declare the correct Hibernate dialect and set the correct JNDI name in <literal>persistence.xml</literal>." +msgstr "" #. Tag: title -#: Websphere.xml:52 -#: Websphere.xml:710 +#: Websphere.xml:53 #, no-c-format -msgid "<title>Configuration file changes</title>" -msgstr "<title>Cambiamenti al file di configurazione</title>" +msgid "Configuring the WebSphere Web Container" +msgstr "" #. Tag: para #: Websphere.xml:54 #, no-c-format -msgid "Below are the configuration file changes that are need to the base example." -msgstr "Sotto sono riportate le modifiche al file di configurazione necessarie all'esempio base." +msgid "This step is mandatory in order to have Seam applications run with WebSphere v7. Two extra properties must be added to the Web Container. Please refer to the IBM WebSphere Information Center for further explanations on those properties." +msgstr "" -#. Tag: literal -#: Websphere.xml:60 -#: Websphere.xml:784 +#. Tag: para +#: Websphere.xml:58 #, no-c-format -msgid "resources/WEB-INF/components.xml" -msgstr "resources/WEB-INF/components.xml" +msgid "To add the extra properties:" +msgstr "" -#. Tag: para -#: Websphere.xml:63 +#. Tag: listitem +#: Websphere.xml:61 #, no-c-format -msgid "We need to change the way that we look up EJBs for WAS. We need to remove the <literal>/local</literal> from the end of the <literal>jndi-pattern</literal> attribute. It should look like this:" -msgstr "Occorre cambiare il modo di ricerca EJB per WAS. Bisogna rimuovere <literal>/local</literal> dalla fine dell'attributo <literal>jndi-pattern</literal>. Dovrebbe apparire così:" +msgid "Open the WebSphere administration console" +msgstr "" -#. Tag: programlisting -#: Websphere.xml:70 +#. Tag: listitem +#: Websphere.xml:64 #, no-c-format -msgid "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=\"true\"/>\n" -" ]]>" +msgid "Select the <literal>Servers/Server Types/WebSphere Application Servers</literal> in the left navigation menu" msgstr "" -"<![CDATA[\n" -"<core:init jndi-pattern=\"java:comp/env/jboss-seam-jee5/#{ejbName}\" debug=\"true\"/>\n" -" ]]>" -#. Tag: literal -#: Websphere.xml:76 +#. Tag: listitem +#: Websphere.xml:67 #, no-c-format -msgid "resources/META-INF/ejb-jar.xml" -msgstr "resources/META-INF/ejb-jar.xml" +msgid "Click on the server name (<literal>server1</literal>)" +msgstr "" -#. Tag: para -#: Websphere.xml:79 +#. Tag: listitem +#: Websphere.xml:70 #, no-c-format -msgid "We need to replace the /local string from <literal>ejb-ref-name</literal>. See at the following final code:" -msgstr "Sostituire la stringa /local da <literal>ejb-ref-name</literal>. Vedere il seguente codice finale:" +msgid "On the right navigation menu, select <literal>Web Container Settings/Web container</literal>)" +msgstr "" -#. Tag: programlisting -#: Websphere.xml:82 +#. Tag: listitem +#: Websphere.xml:73 #, no-c-format -msgid "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" +msgid "On the right navigation menu, select <literal>custom properties</literal>) and add the following properties:" msgstr "" -"<![CDATA[\n" -" <enterprise-beans>\n" -" \n" -" \n" -" <session>\n" -" <ejb-name>RegisterAction</ejb-name>\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref>\n" -" </session>\n" -" </enterprise-beans>]]>" #. Tag: literal -#: Websphere.xml:88 -#: Websphere.xml:816 +#: Websphere.xml:77 #, no-c-format -msgid "resources/WEB-INF/web.xml" -msgstr "resources/WEB-INF/web.xml" +msgid "prependSlashToResource = true" +msgstr "" -#. Tag: para -#: Websphere.xml:91 +#. Tag: literal +#: Websphere.xml:80 #, no-c-format -msgid "We have to make some changes to the EJB references in the <literal>web.xml</literal>. These changes are what will allow WAS to bind automatically the EJB3 references in the web module to the the actual EJB3 beans in the EAR module. Replace all of the /local strings in <literal>ejb-local-refs</literal> when the values below." -msgstr "Occorre apportare alcumi cambiamenti ai riferimenti EJB in <literal>web.xml</literal>. Queste modifiche consentono a WAS di associare automaticamente i riferimenti EJB3 nel modulo web ai bean EJB3 nel modulo EAR. Sostituire tutte le stringhe /local in <literal>ejb-local-refs</literal>." +msgid "com.ibm.ws.webcontainer.invokefilterscompatibility = true" +msgstr "" -#. Tag: programlisting -#: Websphere.xml:100 +#. Tag: listitem +#: Websphere.xml:84 #, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "Save and restart the server" msgstr "" -"<![CDATA[\n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Authenticator</local>\n" -" </ejb-local-ref> \n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.BookingList</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.Register</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.ChangePassword</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelBooking</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.example.booking.HotelSearching</local>\n" -" </ejb-local-ref>\n" -"\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +#. Tag: title +#: Websphere.xml:92 +#, no-c-format +msgid "Seam and the WebSphere JNDI name space" +msgstr "" + #. Tag: para -#: Websphere.xml:102 +#: Websphere.xml:93 #, no-c-format -msgid "Note also that <literal>EjbSynchronizations</literal> is a built-in Seam EJB and not part of the Hotel Booking example. This means that if your application's <literal>components.xml</literal> specifies <literal>transaction:ejb-transaction</literal>, then you must include:" -msgstr "Si noti che <literal>EjbSynchronizations</literal> è un EJB predefinito in Seam e non è parte dell'esempio Prenotazione Hotel. Questo significa che se <literal>components.xml</literal> specifica <literal>transaction:ejb-transaction</literal>, allora occorre includere:" +msgid "In order to use component injection, Seam needs to know how to lookup for session beans bound to the JNDI name space. Seam provides two mechanisms to configure the way it will search for such resources:" +msgstr "" -#. Tag: programlisting -#: Websphere.xml:107 +#. Tag: listitem +#: Websphere.xml:97 #, no-c-format -msgid "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" +msgid "The global <literal>jndi-pattern</literal> switch on the <literal><core:init></literal>. in <literal>components.xml</literal>. The switch can use a special placeholder \"<literal>#{ejbName}</literal>\" that resolves to the unqualified name of the EJB" msgstr "" -"<![CDATA[\n" -" <ejb-local-ref>\n" -" <ejb-ref-name>myapp/EjbSynchronizations</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local-home></local-home>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" #. Tag: para +#: Websphere.xml:102 +#, fuzzy, no-c-format +msgid "The <literal>@JndiName</literal> annotation" +msgstr "Selezionare il pulsante <literal>Next</literal>." + +#. Tag: para #: Websphere.xml:108 #, no-c-format -msgid "in your web.xml. If you don't include it, you'll get the following error:" -msgstr "in web.xml. Se non viene incluso, si ottiene il seguente errore:" +msgid "gives detailed explanations on how those mechanisms work." +msgstr "" -#. Tag: programlisting -#: Websphere.xml:109 +#. Tag: para +#: Websphere.xml:112 #, no-c-format -msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" -msgstr "Name comp/env/myapp/EjbSynchronizations not found in context java:" +msgid "By default, WebSphere will bind the session bean in its local JNDI name space under a \"short\" binding name that adheres to the following pattern <literal>ejblocal:<package.qualified.local.interface.name></literal>." +msgstr "" -#. Tag: literal -#: Websphere.xml:114 -#, no-c-format -msgid "resources/META-INF/persistence.xml" -msgstr "resources/META-INF/persistence.xml" - #. Tag: para #: Websphere.xml:117 #, no-c-format -msgid "For this example we will be using the default datasource that comes with WAS. To do this change the <literal>jta-data-source</literal> element:" -msgstr "Per questo esempio useremo il datasource di default che è presente in WAS. Cambiare l'elemento <literal>jta-data-source</literal>:" +msgid "For a detailed description on how WebSphere v7 organizes and binds EJBs in its JNDI name spaces, please refer to the WebSphere Information Center." +msgstr "" -#. Tag: programlisting +#. Tag: para #: Websphere.xml:120 #, no-c-format -msgid "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" +msgid "As explained before, Seam needs to lookup for session bean as they appear in JNDI. Basically, there are three strategies, in order of complexity:" msgstr "" -"<![CDATA[\n" -"<jta-data-source>DefaultDatasource</jta-data-source>\n" -" ]]>" -#. Tag: para -#: Websphere.xml:121 +#. Tag: listitem +#: Websphere.xml:124 #, no-c-format -msgid "Then we need to adjust some of the hibernate properties. First comment out the Glassfish properties. Next you need to add/change the properties:" -msgstr "Poi occorre sistemare alcune proprietà Hibernate. Innanzitutto commentare le proprietà Glassfish. Poi occorre aggiungere/modificare le proprietà:" +msgid "Specify which JNDI name Seam must use for each session bean using the <literal>@JndiName</literal> annotation in the java source file" +msgstr "" -#. Tag: programlisting -#: Websphere.xml:126 +#. Tag: listitem +#: Websphere.xml:127 #, no-c-format -msgid "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction.WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" +msgid "Override the default session bean names generated by WebSphere to conform to the <literal>jndi-pattern</literal> attribute" msgstr "" -"<![CDATA[\n" -"\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction.WebSphereExtendedJTATransactionLookup\"/>\n" -" ]]>" -#. Tag: para +#. Tag: listitem #: Websphere.xml:130 #, no-c-format -msgid "<literal>hibernate.transaction.manager_lookup_class</literal> — Standard Hibernate transaction manager property for WAS 6.X and 7" -msgstr "<literal>hibernate.transaction.manager_lookup_class</literal> — proprietà del gestore di transazioni standard Hibernate per WAS 6.X e 7" +msgid "Use EJB references" +msgstr "" +#. Tag: title +#: Websphere.xml:137 +#, no-c-format +msgid "Strategy 1: Specify which JNDI name Seam must use for each Session Bean" +msgstr "" + #. Tag: para -#: Websphere.xml:136 +#: Websphere.xml:138 #, no-c-format -msgid "<literal>hibernate.transaction.flush_before_completion</literal> — This is commented out because we want the container to manage the transactions. Also if this is set to <literal>true</literal> an exception will be thrown by WAS when the EJBContext is looked up." -msgstr "<literal>hibernate.transaction.flush_before_completion</literal> — questo è commentato poiché si vuole che il container gestisce le transazioni. Inoltre se questo viene impostato a <literal>true</literal>, viene lanciata un'eccezione da WAS quando viene cercato l'EJBContext." +msgid "This strategy is the simplest and fastest one regarding development. It uses the WebSphere v7 default binding mechanism. To use this strategy:" +msgstr "" -#. Tag: programlisting -#: Websphere.xml:145 +#. Tag: listitem +#: Websphere.xml:141 #, no-c-format -msgid "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an EJB]]>" +msgid "Add a <literal>@JndiName(\"ejblocal:<package.qualified.local.interface.name>)</literal> annotation to each session bean that is a Seam component." msgstr "" -"<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" -" EJBContext may only be looked up by or injected into an EJB]]>" #. Tag: para -#: Websphere.xml:148 +#: Websphere.xml:145 +#: Websphere.xml:188 #, no-c-format -msgid "<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the embedded DB was switched to the same Derby DB as is in Glassfish v2." -msgstr "<literal>hibernate.dialect</literal> — a partire da WAS 6.1.0.9 l'embedded DB è stato cambiato al Derby DB come in Glassfish v2." +msgid "<para>In <literal>components.xml</literal>, add the following line:</para>" +msgstr "" -#. Tag: literal -#: Websphere.xml:158 -#: Websphere.xml:750 +#. Tag: programlisting +#: Websphere.xml:147 +#: Websphere.xml:220 #, no-c-format -msgid "src/GlassfishDerbyDialect.java" -msgstr "src/GlassfishDerbyDialect.java" +msgid "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" +msgstr "<![CDATA[<core:init jndi-name=\"java:comp/env/#{ejbName}\" />]]>" #. Tag: para -#: Websphere.xml:161 +#: Websphere.xml:151 #, no-c-format -msgid "You will need to get the <literal>GlassfishDerbyDialect.java</literal> and copy it into the <literal>/src</literal> directory. The java class exists in the JPA example source directory and can be copied using the command below assuming you are in <literal>jee5/booking</literal> directory:" -msgstr "Occorre prendere <literal>GlassfishDerbyDialect.java</literal> e copiarlo nella directory <literal>/src</literal>. La classe java è presente nella directory dei sorgenti dell'esempio JPA e può essere copiata usando il comando sottostante assumendo di essere nella directory <literal>jee5/booking</literal>:" +msgid "Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> in the web module with the following content:" +msgstr "" #. Tag: programlisting -#: Websphere.xml:169 +#: Websphere.xml:153 #, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" +"com.ibm.websphere.naming.hostname.normalizer=com.ibm.ws.naming.util.DefaultHostnameNormalizer\n" +"java.naming.factory.initial=com.ibm.websphere.naming.WsnInitialContextFactory\n" +"com.ibm.websphere.naming.name.syntax=jndi\n" +"com.ibm.websphere.naming.namespace.connection=lazy\n" +"com.ibm.ws.naming.ldap.ldapinitctxfactory=com.sun.jndi.ldap.LdapCtxFactory\n" +"com.ibm.websphere.naming.jndicache.cacheobject=populated\n" +"com.ibm.websphere.naming.namespaceroot=defaultroot\n" +"com.ibm.ws.naming.wsn.factory.initial=com.ibm.ws.naming.util.WsnInitCtxFactory\n" +"com.ibm.websphere.naming.jndicache.maxcachelife=0\n" +"com.ibm.websphere.naming.jndicache.maxentrylife=0\n" +"com.ibm.websphere.naming.jndicache.cachename=providerURL\n" +"java.naming.provider.url=corbaloc:rir:/NameServiceServerRoot\n" +"java.naming.factory.url.pkgs=com.ibm.ws.runtime:com.ibm.ws.naming" msgstr "" -"<![CDATA[\n" -"cp ../../jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" #. Tag: para -#: Websphere.xml:170 +#: Websphere.xml:157 +#, fuzzy, no-c-format +msgid "At the end of <literal>web.xml</literal>, add the following lines:" +msgstr "Aggiornamento del file <literal>build.xml</literal>" + +#. Tag: programlisting +#: Websphere.xml:159 #, no-c-format -msgid "This class will be put into the <literal>jboss-seam-jee5.jar</literal> file." -msgstr "Questa classe verrà messa nel file <literal>jboss-seam-jee5.jar</literal>." +msgid "" +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" +msgstr "" +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" -#. Tag: literal -#: Websphere.xml:175 +#. Tag: para +#: Websphere.xml:164 #, no-c-format -msgid "resources/import.sql" -msgstr "resources/import.sql" +msgid "That's all folks! No need to update any file during the development, nor to define any EJB to EJB or web to EJB reference!" +msgstr "" #. Tag: para -#: Websphere.xml:178 +#: Websphere.xml:167 #, no-c-format -msgid "This file must also be copied from the JPA example because either the Derby DB or the dialect does not support changes to the <literal>ID</literal> column. The files are identical except for the column difference. Use the following command to make the copy" -msgstr "Questo file deve essere copiato dall'esempio JPA poiché sia Derby DB od il dialetto non supportano non supportano modifiche alla colonna <literal>ID</literal>. I file sono identici tranne per questa colonna. Usare il seguente comando per eseguire la copia:" +msgid "Compared to the other strategies, this strategy has the advantage not to have to manage any EJBs reference and also not to have to maintain extra files. The only drawback is one extra line in the java source code with the <literal>@JndiName</literal> annotation" +msgstr "" -#. Tag: programlisting -#: Websphere.xml:185 +#. Tag: title +#: Websphere.xml:174 #, no-c-format +msgid "Strategy 2: Override the default names generated by WebSphere" +msgstr "" + +#. Tag: section +#: Websphere.xml:174 +#, no-c-format +msgid "There is no simple way to globally override the default naming strategy for session beans in WebSphere. However, WebSphere provides a way to override the name of each bean." +msgstr "" + +#. Tag: para +#: Websphere.xml:177 +#, no-c-format +msgid "To use this strategy:" +msgstr "" + +#. Tag: para +#: Websphere.xml:181 +#, no-c-format msgid "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +"Add a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB module and add an entry for each session bean like this: <programlisting role=\"XML\"><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-bnd\n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-bnd_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"AuthenticatorAction\" simple-binding-name=\"AuthenticatorAction\" />\n" +" <session name=\"BookingListAction\" simple-binding-name=\"BookingListAction\" />\n" +" \n" +"</ejb-jar-bnd>]]></programlisting> WebSphere will then bind the <literal>AuthenticatorAction</literal> EJB to the <literal>ejblocal:AuthenticatorAction</literal> JNDI name" msgstr "" -"<![CDATA[\n" -"cp ../../jpa/resources-websphere7/import.sql ./resources]]>" -#. Tag: title +#. Tag: programlisting +#: Websphere.xml:190 +#, no-c-format +msgid "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" +msgstr "<![CDATA[<core:init jndi-name=\"ejblocal:#{ejbName}\" />]]>" + +#. Tag: para #: Websphere.xml:194 #, no-c-format -msgid "Building the <literal>jee5/booking</literal> example" -msgstr "Build dell'esempio <literal>jee5/booking</literal>" +msgid "Add a file named <literal>WEB-INF/classes/seam-jndi.properties</literal> as described in strategy 1" +msgstr "" #. Tag: para -#: Websphere.xml:197 +#: Websphere.xml:199 #, no-c-format -msgid "In order to get the changes we have made into our application we need to make some changes to the <literal>build.xml</literal>. There are also some additional jars that are required by our application in order to work with WAS. This section will cover what changes are needed to the <literal>build.xml</literal>." -msgstr "Per ottenere le modifiche applicate occorre apportare dei cambiamenti a <literal>build.xml</literal>. Ci sono dei jar aggiuntivi richiesti dall'applicazione per funzionare con WAS. Questa sezione coprirà i cambiamenti da fare a <literal>build.xml</literal>." +msgid "In <literal>web.xml</literal>, add the following lines (Note the different <literal>ejb-ref-name</literal> value):" +msgstr "" -#. Tag: title -#: Websphere.xml:204 +#. Tag: programlisting +#: Websphere.xml:201 #, no-c-format -msgid "Library dependency changes" -msgstr "Modifiche alle dipendenze di libreria" +msgid "" +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" +msgstr "" +"<![CDATA[<ejb-local-ref>\n" +" <ejb-ref-name>ejblocal:EjbSynchronizations</ejb-ref-name>\n" +" <ejb-ref-type>Session</ejb-ref-type>\n" +" <local-home></local-home>\n" +" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +" </ejb-local-ref>]]>" #. Tag: para -#: Websphere.xml:205 +#: Websphere.xml:206 #, no-c-format -msgid "We remove the <literal>log4j.jar</literal> so that all of the log output from our application will be added to the WAS log. Additional steps are required to fully configure log4j and those are outside of the scope of this document." -msgstr "SI rimuova <literal>log4j.jar</literal> affinché tutto l'output di log dell'applicazione venga aggiunto al log di WAS. Sono richiesti ulteriori passi per configurare log4j ma questi esulano dagli scopi di questo documento." +msgid "Compared to the first strategy, this strategy requires to maintain an extra file (<literal>META-INF/ibm-ejb-jar-ext.xml</literal>), where a line must be added each time a new session bean is added to the application), but still does not require to maintain EJB reference between beans." +msgstr "" #. Tag: title -#: Websphere.xml:213 +#: Websphere.xml:215 #, no-c-format -msgid "Updating the <literal>build.xml</literal> file" -msgstr "Aggiornamento del file <literal>build.xml</literal>" +msgid "Strategy 3: Use EJB references" +msgstr "" -#. Tag: para +#. Tag: section #: Websphere.xml:215 #, no-c-format -msgid "Add the following entry to the bottom of the <literal>build.xml</literal> file. This overrides the default fileset that is used to populate the <literal>jboss-seam-jee5.jar</literal>. :" -msgstr "Aggiungere la seguente riga alla fine del file <literal>build.xml</literal>. Questa sovrascrivere il fileset di default che viene usato per popolare <literal>jboss-seam-jee5.jar</literal>:" +msgid "This strategy is based on the usage of EJB references, from EJB to EJB and from the web module to EJB. To use it:" +msgstr "" -#. Tag: programlisting +#. Tag: listitem +#: Websphere.xml:218 +#, no-c-format +msgid "<listitem>In <literal>components.xml</literal>, add the following line:</listitem>" +msgstr "" + +#. Tag: para #: Websphere.xml:223 #, no-c-format -msgid "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" +msgid "Follow the instructions in <xref linkend=\"config.integration.ejb.container\"/> to declare the references from web to EJB and from EJB to EJB" msgstr "" -"<![CDATA[\n" -" <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" -" <include name=\"import.sql\" />\n" -" <include name=\"seam.properties\" />\n" -" <include name=\"META-INF/persistence.xml\" />\n" -" <include name=\"META-INF/ejb-jar.xml\" />\n" -" </fileset>]]>" #. Tag: para -#: Websphere.xml:225 +#: Websphere.xml:228 #, no-c-format -msgid "Now all that is left is to execute the <literal>ant archive</literal> task and the built application will be in the <literal>jee5/booking/dist</literal> directory." -msgstr "Ora ciò che manca è eseguire il task <literal>ant archive</literal> ed il built dell'applicazione verrà messo nella directory <literal>jee5/booking/dist</literal>." +msgid "This is the most tedious strategy as each session bean referenced by another session bean (i.e. \"injected\") as to be declared in <literal>ejb-jar.xml</literal> file. Also, each new session bean has to be added to the list of referenced bean in <literal>web.xml</literal>" +msgstr "" #. Tag: title -#: Websphere.xml:234 +#: Websphere.xml:239 #, no-c-format -msgid "Deploying the application to Websphere" -msgstr "Deploy dell'applicazione in Websphere" +msgid "Configuring timeouts for Stateful Session Beans" +msgstr "" #. Tag: para -#: Websphere.xml:236 +#: Websphere.xml:240 #, no-c-format -msgid "So now we have everything we need in place. All that is left is to deploy it - just a few steps more." -msgstr "Ora ogni cosa è al posto giusto. Ciò che manca è il deploy - qualche passo in più." +msgid "A timeout value has to be set for each stateful session bean used in the application because stateful bean must not expire in WebSphere while Seam might still need thenm. At the time of writing this document, WebSphere does not provide a way to configure a global timeout at neither the cluster, server, application nor ejb-jar level. It has to be done for each stateful bean individually. This is done by adding a file named <literal>META-INF/ibm-ejb-jar-ext.xml</literal> in the EJB module, and declare the timeout value for each bean:" +msgstr "" -#. Tag: para -#: Websphere.xml:238 +#. Tag: programlisting +#: Websphere.xml:246 #, no-c-format -msgid "For this we will use Websphere's administration console. As before there are some tricks and tips that must be followed." -msgstr "Per questo si userà la console di amministrazione di Websphere. Come prima ecco alcuni trucchi e suggerimenti da seguire." +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></session>\n" +" \n" +"</ejb-jar-ext>]]>" +msgstr "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<ejb-jar-ext \n" +" xmlns=\"http://websphere.ibm.com/xml/ns/javaee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://websphere.ibm.com/xml/ns/javaee \n" +" http://websphere.ibm.com/xml/ns/javaee/ibm-ejb-jar-ext_1_0.xsd\"\n" +" version=\"1.0\">\n" +"\n" +" <session name=\"BookingListAction\"><time-out value=\"605\"/></session>\n" +" <session name=\"ChangePasswordAction\"><time-out value=\"605\"/></session>\n" +" \n" +"</ejb-jar-ext>]]>" #. Tag: para -#: Websphere.xml:241 +#: Websphere.xml:248 #, no-c-format -msgid "The steps below are for the WAS version stated above. The ports are default values, if you changed them substitute your values." -msgstr "I passi sottostanti riguardano la versione WAS dichiarata all'inizio. Le porte sono ai valori di default, se vengono cambiati occorre sostituire i valori." +msgid "The <literal>time-out</literal> is expressed in seconds and must be higher than the Seam conversation expiration timeout and a few minutes higher than the user's HTTP session timeout (The session expiration timeout can trigger a few minutes after the number of minutes declared to expire s for the HTTP session expiration)." +msgstr "" +#. Tag: title +#: Websphere.xml:257 +#, no-c-format +msgid "The <literal>jee5/booking</literal> example" +msgstr "L'esempio <literal>jee5/booking</literal>" + #. Tag: para -#: Websphere.xml:245 +#: Websphere.xml:259 +#, fuzzy, no-c-format +msgid "The<literal>jee5/booking</literal>example is based on the Hotel Booking example (which runs on JBoss AS). Out of the box, it is designed to run on Glassfish, but with the following steps, it can be deployed on WebSphere. It is located in the <literal>$SEAM_DIST/examples/jee5/booking</literal> directory." +msgstr "L'esempio <literal>jee5/booking</literal> è basato sull'esempio PrenotazioneHotel (che gira su JBoss AS). E' stato progettato per girare anche su Glassfish, ma con i passi descritti sotto può essere deployato in Websphere. E' collocato nella directory <literal>$SEAM_DIST/examples/jee5/booking</literal>." + +#. Tag: para +#: Websphere.xml:265 #, no-c-format -msgid "Log in to the administration console <programlisting><![CDATA[https://localhost:9043/admin]]></programlisting> or" -msgstr "Fare il login nella console di amministrazione <programlisting><![CDATA[https://localhost:9043/admin]]></programlisting> oppure" +msgid "For running this example, we'll use the second JNDI mapping strategy (\"Override the default names generated by WebSphere\") as we don't want to change the java code to add the <literal>@JndiName</literal> annotation as in the first strategy." +msgstr "" -#. Tag: programlisting -#: Websphere.xml:250 +#. Tag: title +#: Websphere.xml:271 #, no-c-format -msgid "<![CDATA[http://localhost:9060/admin]]>" -msgstr "<![CDATA[http://localhost:9060/admin]]>" +msgid "Building the <literal>jee5/booking</literal> example" +msgstr "Build dell'esempio <literal>jee5/booking</literal>" #. Tag: para -#: Websphere.xml:254 -#, no-c-format -msgid "Access the <literal>Websphere enterprise applications</literal> menu option under the <literal>Applications --> Application Type</literal> left side menu." +#: Websphere.xml:273 +#, fuzzy, no-c-format +msgid "Building it only requires running the correct ant command: <programlisting>ant -f build-websphere7.xml</programlisting> This will create container specific distribution and exploded archive directories with the <literal>websphere7</literal> label." +msgstr "Il building richiede l'esecuzione del corretto comando ant: <programlisting>ant websphere7</programlisting>. Questo creerà una distribuzione specifica per il container e le directory esplose per l'archivio con etichetta <literal>websphere7</literal>." + +#. Tag: title +#: Websphere.xml:280 +#, fuzzy, no-c-format +msgid "Deploying the <literal>jee5/booking</literal> example" +msgstr "Build dell'esempio <literal>jee5/booking</literal>" + +#. Tag: para +#: Websphere.xml:281 +#, fuzzy, no-c-format +msgid "The steps below are for the WAS version stated above.The ports are default values, if you changed them, you must substitute the values." +msgstr "I passi sottostanti riguardano la versione WAS dichiarata all'inizio. Le porte sono ai valori di default, se vengono cambiati occorre sostituire i valori." + +#. Tag: listitem +#: Websphere.xml:284 +#, fuzzy, no-c-format +msgid "Log in to the administration console <programlisting><![CDATA[http://localhost:9060/admin]]></programlisting> Enter your userid annd/or your password if security is enabled for the console." +msgstr "Fare il login nella console di amministrazione <programlisting><![CDATA[https://localhost:9043/admin]]></programlisting> oppure" + +#. Tag: para +#: Websphere.xml:291 +#, fuzzy, no-c-format +msgid "Go to the <literal>WebSphere enterprise applications</literal> menu option under the <literal>Applications --> Application Type</literal> left side menu." msgstr "Accedere all'opzione menu <literal>Websphere enterprise applications</literal> sotto il menu a sinistra <literal>Applications --> Application Type</literal>." #. Tag: para -#: Websphere.xml:259 +#: Websphere.xml:298 #, no-c-format msgid "At the top of the <literal>Enterprise Applications</literal> table select <literal>Install</literal>. Below are installation wizard pages and what needs to done on each:" msgstr "In cima alla tabella <literal>Enterprise Applications</literal> selezionare <literal>Install</literal>. Sotto sono visualizzate le pagine del wizard con ciò che va fatto su ciascuna:" #. Tag: literal -#: Websphere.xml:265 -#: Websphere.xml:461 +#: Websphere.xml:304 #, no-c-format msgid "Preparing for the application installation" msgstr "Preparazione per l'installazione dell'applicazione" #. Tag: para -#: Websphere.xml:269 -#, no-c-format -msgid "Browse to the <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</literal> file using the file upload widget." +#: Websphere.xml:307 +#, fuzzy, no-c-format +msgid "Browse to the <literal>examples/jee5/booking/dist-websphere7/jboss-seam-jee5.ear</literal> file using the file upload widget." msgstr "Andare fino al file <literal>examples/jee5/booking/dist/jboss-seam-jee5.ear</literal> usando il widget di upload dei file." #. Tag: para -#: Websphere.xml:275 -#: Websphere.xml:285 -#: Websphere.xml:304 -#: Websphere.xml:476 -#: Websphere.xml:496 +#: Websphere.xml:313 +#: Websphere.xml:323 +#: Websphere.xml:341 #, no-c-format msgid "Select the <literal>Next</literal> button." msgstr "Selezionare il pulsante <literal>Next</literal>." #. Tag: para -#: Websphere.xml:280 -#: Websphere.xml:471 +#: Websphere.xml:318 #, no-c-format msgid "Select the <literal>Fast Path</literal> button." msgstr "Selezionare il pulsante <literal>Fast Path</literal>." #. Tag: literal -#: Websphere.xml:292 +#: Websphere.xml:332 #, no-c-format msgid "Select installation options" msgstr "Selezionare le opzioni di installazione" #. Tag: para -#: Websphere.xml:296 -#, no-c-format -msgid "Select the <literal>Deploy enterprise beans</literal> and <literal>Allow EJB reference targets to resolve automatically</literal> check boxes. This is needed unless you used a Websphere AS tool to package the application." +#: Websphere.xml:335 +#, fuzzy, no-c-format +msgid "Select the <literal>Deploy enterprise beans and Allow EJB reference targets to resolve automatically</literal> check boxes at the bottom of the page. This will let WebSphere use its simplified JNDI reference mapping." msgstr "Selezionare i check box <literal>Deploy enterprise beans</literal> e <literal>Allow EJB reference targets to resolve automatically</literal>. Queso serve amenoché si usi il tool di Websphere AS per impacchettare l'applicazione." #. Tag: literal -#: Websphere.xml:313 +#: Websphere.xml:350 #, no-c-format msgid "Map modules to servers" msgstr "Mappare i moduli sul server" #. Tag: para -#: Websphere.xml:317 -#, no-c-format -msgid "No changes needed here as we only have one server. Select the <literal>Next</literal> button." +#: Websphere.xml:353 +#, fuzzy, no-c-format +msgid "No changes needed here as we only have one server. Select the <literal>Next</literal>button." msgstr "Avendo un solo server non sono necessarie modifiche. Selezionare il pulsante <literal>Next</literal>." #. Tag: literal -#: Websphere.xml:325 +#: Websphere.xml:362 +#, fuzzy, no-c-format +msgid "Map virtual hosts for Web modules" +msgstr "Mappare context roots per i moduli Web" + +#. Tag: para +#: Websphere.xml:365 +#, fuzzy, no-c-format +msgid "No changes needed here as we only have one virtual host. Select the <literal>Next</literal>button." +msgstr "Avendo un solo server non sono necessarie modifiche. Selezionare il pulsante <literal>Next</literal>." + +#. Tag: literal +#: Websphere.xml:374 #, no-c-format msgid "Summary" msgstr "Sommario" #. Tag: para -#: Websphere.xml:328 +#: Websphere.xml:377 #, no-c-format msgid "No changes needed here. Select the <literal>Finish</literal> button." msgstr "Non sono necessarie modifiche. Selezionare il pulsante <literal>Finish</literal>." #. Tag: literal -#: Websphere.xml:335 +#: Websphere.xml:384 #, no-c-format msgid "Installation" msgstr "Installazione" #. Tag: para -#: Websphere.xml:338 -#, no-c-format -msgid "Now you will see it installing and deploying your application." +#: Websphere.xml:387 +#, fuzzy, no-c-format +msgid "Now you will see WebSphere installing and deploying your application." msgstr "Ora si vedra l'installazione ed il deploy dell'applicazione." #. Tag: para -#: Websphere.xml:343 -#, no-c-format -msgid "When it finishes select the <literal>Save</literal> link and you will be returned to the <literal>Enterprise Applications</literal> table." +#: Websphere.xml:390 +#, fuzzy, no-c-format +msgid "When done, select the <literal>Save</literal> link and you will be returned to the <literal>Enterprise Applications</literal> table." msgstr "Quando termina selezionare il link <literal>Save</literal> e si verrà reindirizzati alla tabella <literal>Enterprise Applications</literal>." #. Tag: para -#: Websphere.xml:355 -#, no-c-format -msgid "Now that we have our application installed we need to make some adjustments to it before we can start it:" -msgstr "Ora che si è installata l'applicazione occorre fare degli aggiustamenti ad essa prima di avviarla:" +#: Websphere.xml:399 +#, fuzzy, no-c-format +msgid "To start the application select our application in the list, then click on the <literal>Start</literal> button at the top of the table." +msgstr "Per avviare l'applicazione ritornare alla tabella <literal>Enterprise Applications</literal> e selezionare l'applicazione nella lista. Quindi scegliere il pulsante <literal>Start</literal> in cima alla tabella." #. Tag: para -#: Websphere.xml:359 +#: Websphere.xml:409 +#, fuzzy, no-c-format +msgid "You can now access the application at <literal>http://localhost:9080/seam-jee5-booking</literal>" +msgstr "Ora si può accedere all'applicazione all'indirizzo <literal>http://localhost:9080/seam-jee5-booking/index.html</literal>." + +#. Tag: title +#: Websphere.xml:418 #, no-c-format -msgid "Starting from the <literal>Enterprise Applications</literal> table select the <literal>Seam Booking</literal> link." -msgstr "Partendo dalla tabella <literal>Enterprise Applications</literal> selezionare il link <literal>Seam Booking</literal>." +msgid "Deviation from the original base files" +msgstr "" -#. Tag: para -#: Websphere.xml:365 +#. Tag: section +#: Websphere.xml:418 #, no-c-format -msgid "Select the <literal>Manage Modules</literal> link." -msgstr "Selezionare il link <literal>Manage Modules</literal>." +msgid "Below are the differences between the base configuration files and the WebSphere specific files held in the <literal>resources-websphere7</literal> directory." +msgstr "" #. Tag: para -#: Websphere.xml:369 +#: Websphere.xml:422 #, no-c-format -msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." -msgstr "Selezionare il link <literal>jboss-seam-jee5-booking.war</literal>." +msgid "<literal>META-INF/ejb-jar.xml</literal> — Removed all the EJB references" +msgstr "" #. Tag: para -#: Websphere.xml:374 +#: Websphere.xml:428 #, no-c-format -msgid "Change the <literal>Class loader order</literal> combo box to <literal>Classes loaded with application class loader first (parent last)</literal>." -msgstr "Cambiare il combo box <literal>Class loader order</literal> in <literal>Classes loaded with application class loader first (parent last)</literal>." +msgid "<literal>META-INF/ibm-ejb-jar-bnd.xml</literal> — This WebSphere specific file has been added as we use the second JNDI mapping strategy. It defines, for each session bean, the name WebSphere will use to bind it its JNDI name space" +msgstr "" #. Tag: para -#: Websphere.xml:380 -#: Websphere.xml:397 +#: Websphere.xml:435 #, no-c-format -msgid "Select <literal>Apply</literal> and then <literal>Save</literal> options." -msgstr "Selezionare <literal>Apply</literal> poi l'opzione <literal>Save</literal>." +msgid "<literal>META-INF/ibm-ejb-jar-ext.xml</literal> — This WebSphere specific file defines to WebSphere, the timeout value for each stateful bean" +msgstr "" #. Tag: para -#: Websphere.xml:384 -#, no-c-format -msgid "Return to the <literal>Seam Booking</literal> page." -msgstr "Ritornare alla pagina <literal>Seam Booking</literal>." +#: Websphere.xml:441 +#, fuzzy, no-c-format +msgid "<literal>META-INF/persistence.xml</literal> — The main changes here are for the datasource JNDI path, switching to the WebSphere transaction manager lookup class, turning off the <literal>hibernate.transaction.flush_before_completion</literal> toggle, and forcing the Hibernate dialect to be <literal>GlassfishDerbyDialect</literal> how as using the integrated Derby database" +msgstr "<literal>META-INF/persistence.xml</literal> — le maggiori modifiche sono per il path JNDI del datasource, passando alla classe di ricerca del gestore di transazioni Websphere e cambiando il dialetto Hibernate a <literal>GlassfishDerbyDialect</literal>." #. Tag: para -#: Websphere.xml:387 -#, no-c-format -msgid "On this page select the <literal>Class loading and update detection</literal> link." -msgstr "Su questa pagina selezionare il link <literal>Class loading and update detection</literal>." +#: Websphere.xml:451 +#, fuzzy, no-c-format +msgid "<literal>WEB-INF/components.xml</literal> — the change here is <literal>jndi-pattern</literal> to use <literal>ejblocal:#{ejbname}</literal> as using the second JNDI matching strategy" +msgstr "<literal>WEB-INF/components.xml</literal> — qua la modifica è <literal>jndi-pattern</literal> senza la stringa /local." #. Tag: para -#: Websphere.xml:392 +#: Websphere.xml:459 #, no-c-format -msgid "Select the radio button for <literal>Classes loaded with application class loader first</literal>." -msgstr "Selezionare il pulsante radio <literal>Classes loaded with application class loader first</literal>." +msgid "<literal>WEB-INF/web.xml</literal> — Remove all the <literal>ejb-local ref</literal> except the one for <literal>EjbSynchronizations</literal> bean. Changed the ref fo this bean to <literal>ejblocal:EjbSynchronizations</literal>" +msgstr "" #. Tag: para -#: Websphere.xml:403 -#, no-c-format -msgid "To start the application return to the <literal>Enterprise Applications</literal> table and select our application in the list. Then choose the <literal>Start</literal> button at the top of the table." -msgstr "Per avviare l'applicazione ritornare alla tabella <literal>Enterprise Applications</literal> e selezionare l'applicazione nella lista. Quindi scegliere il pulsante <literal>Start</literal> in cima alla tabella." +#: Websphere.xml:467 +#: Websphere.xml:549 +#, fuzzy, no-c-format +msgid "<literal>import.sql</literal> — due to the cutomized hibernate Derby dialect, the <literal>ID</literal> column can not be populated by this file and was removed." +msgstr "<literal>import.sql</literal> — la colonna <literal>ID</literal> sia del dialetto sia del Derby DB non può essere popolata ed è stata rimossa." #. Tag: para -#: Websphere.xml:410 +#: Websphere.xml:474 #, no-c-format -msgid "You can now access the application at <literal>http://localhost:9080/seam-jee5-booking/index.html</literal> ." -msgstr "Ora si può accedere all'applicazione all'indirizzo <literal>http://localhost:9080/seam-jee5-booking/index.html</literal>." +msgid "Also the build procedure has been changed to include the <literal>log4j.jar</literal> file and exclude the <literal>concurrent.jar</literal> and <literal>jboss-common-core.jar</literal> files." +msgstr "" #. Tag: title -#: Websphere.xml:431 +#: Websphere.xml:486 #, no-c-format msgid "The <literal>jpa</literal> booking example" msgstr "Esempio Prenotazione <literal>jpa</literal>" #. Tag: para -#: Websphere.xml:432 -#, no-c-format -msgid "Thankfully getting the <literal>jpa</literal> example to work is much easier than the <literal>jee5</literal> example. This is the Hotel Booking example implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It does not use EJB3." +#: Websphere.xml:488 +#, fuzzy, no-c-format +msgid "This is the Hotel Booking example implemented in Seam POJOs and using Hibernate JPA with JPA transactions. It does not use EJB3." msgstr "Fortunatamente far funzionare l'esempio <literal>jpa</literal> è molto più semplice che per l'esempio <literal>jee5</literal>. Questo è l'esempio Prenotazione Hotel implementato in Seam POJOs usando Hibernate JPA con le transazioni JPA. Non usa EJB3." #. Tag: para -#: Websphere.xml:437 -#, no-c-format -msgid "The example already has a breakout of configurations and build scripts for many of the common containers including Websphere." +#: Websphere.xml:493 +#, fuzzy, no-c-format +msgid "The example already has a breakout of configurations and build scripts for many of the common containers including WebSphere." msgstr "L'esempio ha già un pò di configurazioni e build script per molti comuni container incluso Websphere." #. Tag: para -#: Websphere.xml:440 -#, no-c-format -msgid "First thing we are going to do is build and deploy that example. Then we'll go over some key changes that we needed." +#: Websphere.xml:498 +#, fuzzy, no-c-format +msgid "First thing, we are going to do is build and deploy that example. Then we'll go over some key changes that we needed." msgstr "La prima cosa da fare è costruire e deployare quell'esempio. Poi verranno apportate delle modifiche chiave necessarie." #. Tag: title -#: Websphere.xml:444 +#: Websphere.xml:504 #, no-c-format msgid "Building the <literal>jpa</literal> example" msgstr "Build dell'esempio <literal>jpa</literal>" #. Tag: para -#: Websphere.xml:445 +#: Websphere.xml:505 #, no-c-format msgid "Building it only requires running the correct ant command: <programlisting>ant websphere7</programlisting> This will create container specific distribution and exploded archive directories with the <literal>websphere7</literal> label." msgstr "Il building richiede l'esecuzione del corretto comando ant: <programlisting>ant websphere7</programlisting>. Questo creerà una distribuzione specifica per il container e le directory esplose per l'archivio con etichetta <literal>websphere7</literal>." #. Tag: title -#: Websphere.xml:451 +#: Websphere.xml:514 #, no-c-format msgid "Deploying the <literal>jpa</literal> example" msgstr "Deploy dell'esempio <literal>jpa</literal>" #. Tag: para -#: Websphere.xml:452 +#: Websphere.xml:515 #, no-c-format -msgid "This is similar to the <literal>jee5</literal> example at <xref linkend=\"jee5-websphere-deploy\"/>, but without so many steps." -msgstr "Questo è simile all'esempio <literal>jee5</literal> all'indirizzo <xref linkend=\"jee5-websphere-deploy\"/>, ma senza molti passi." - -#. Tag: para -#: Websphere.xml:457 -#, no-c-format -msgid "From the <literal>Enterprise Applications</literal> table select the <literal>Install</literal> button." -msgstr "Dalla tabella <literal>Enterprise Applications</literal> selezionare il pulsante <literal>Install</literal>." - -#. Tag: para -#: Websphere.xml:465 -#, no-c-format -msgid "Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</literal> file using the file upload widget." -msgstr "Navigare fino al file <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</literal> usando il widget per l'upload dei file." - -#. Tag: para -#: Websphere.xml:483 -#, no-c-format -msgid "Select the <literal>Next</literal> button for the next three pages, no changes are needed." -msgstr "Selezionare il pulsante <literal>Next</literal> per le prossime tre pagine, non servono modifiche." - -#. Tag: literal -#: Websphere.xml:488 -#, no-c-format -msgid "Map context roots for Web modules" -msgstr "Mappare context roots per i moduli Web" - -#. Tag: para -#: Websphere.xml:491 -#, no-c-format -msgid "In the <literal>Context root</literal> text box enter <literal>jboss-seam-jpa</literal>." -msgstr "Nel text box <literal>Context root</literal> inserire <literal>jboss-seam-jpa</literal>." - -#. Tag: para -#: Websphere.xml:502 -#, no-c-format -msgid "<literal>Summary</literal> page" -msgstr "Pagina <literal>Summario</literal>" - -#. Tag: para -#: Websphere.xml:505 -#, no-c-format -msgid "Review the settings if you wish and select the <literal>Finish</literal> button to install the application. When installation finished select the <literal> Save</literal> link and you will be returned to the <literal>Enterprise Applications</literal> table." -msgstr "Rivedere le impostazioni e selezionare il pulsante <literal>Finish</literal> per installre l'applicazione. Quando l'installazione è terminata selezionare il link <literal> Save</literal> e si ritornerà alla tabella <literal>Enterprise Applications</literal>." - -#. Tag: para -#: Websphere.xml:519 -#, no-c-format -msgid "As with the <literal>jee5</literal> example there are some class loader changes needed before we start the application. Follow the instructions at <xref linkend=\"websphere-app-adj-after-install\"/> but exchange <literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." -msgstr "Come per l'esempio <literal>jee5</literal> ci sono alcuni cambiamenti necessari al class loader prima di avviare l'applicazione. Seguire le istruzioni in <xref linkend=\"websphere-app-adj-after-install\"/> e cambiare <literal>jboss-seam-jpa_war</literal> per <literal>Seam Booking</literal>." - -#. Tag: para -#: Websphere.xml:526 -#, no-c-format -msgid "Finally start the application by selecting it in the <literal>Enterprise Applications</literal> table and clicking the <literal>Start</literal> button." -msgstr "Infine avviare l'applicazione selezionandola nella tabella <literal>Enterprise Applications</literal> e cliccando il pulsante <literal>Start</literal>." - -#. Tag: para -#: Websphere.xml:532 -#, no-c-format -msgid "You can now access the application at the <literal>http://localhost:9080/jboss-seam-jpa/index.html</literal>." -msgstr "Si può ora accedere all'applicazione all'indirizzo <literal>http://localhost:9080/jboss-seam-jpa/index.html</literal>." - -#. Tag: title -#: Websphere.xml:540 -#, no-c-format -msgid "What's different for Websphere AS V7" -msgstr "Cosa c'è di diverso in Websphere AS V7" - -#. Tag: para -#: Websphere.xml:541 -#, no-c-format -msgid "The differences between the JPA examples that deploys to JBoss 4.2 and Websphere AS V7 are mostly expected; library and configuration file changes." -msgstr "Le differenze tra gli esempi JPA che eseguono il deploy in JBoss 4.2 e Websphere AS V7 sono perlopiù attese; cambiamenti alle librerie ed al file di configurazione." - -#. Tag: para -#: Websphere.xml:546 -#, no-c-format -msgid "<para>Configuration file changes</para>" -msgstr "<para>Cambiamenti al file di configurazione</para>" - -#. Tag: para -#: Websphere.xml:549 -#, no-c-format -msgid "<literal>META-INF/persistence.xml</literal> — the main changes here are for the datasource JNDI path, switching to the Websphere transaction manager look up class, and changing the hibernate dialect to be <literal>GlassfishDerbyDialect</literal> ." -msgstr "<literal>META-INF/persistence.xml</literal> — le maggiori modifiche sono per il path JNDI del datasource, passando alla classe di ricerca del gestore di transazioni Websphere e cambiando il dialetto Hibernate a <literal>GlassfishDerbyDialect</literal>." - -#. Tag: para -#: Websphere.xml:559 -#, no-c-format -msgid "<literal>WEB-INF/components.xml</literal> — the change here is <literal>jndi-pattern</literal> without /local string." -msgstr "<literal>WEB-INF/components.xml</literal> — qua la modifica è <literal>jndi-pattern</literal> senza la stringa /local." - -#. Tag: para -#: Websphere.xml:565 -#, no-c-format -msgid "<literal>META-INF/ejb-jar.xml</literal> — the same change in <literal>ejb-ref-name</literal>, where is replace /local string in <literal>jboss-seam-jee5/AuthenticatorAction</literal>." -msgstr "<literal>META-INF/ejb-jar.xml</literal> — stessa modifica in <literal>ejb-ref-name</literal>, dove la stringa /local diventa <literal>jboss-seam-jee5/AuthenticatorAction</literal>." - -#. Tag: para -#: Websphere.xml:572 -#, no-c-format -msgid "<literal>src/GlassfishDerbyDialect.java </literal> — this class is needed for the hibernate dialect change to <literal>GlassfishDerbyDialect</literal>" -msgstr "<literal>src/GlassfishDerbyDialect.java </literal> — questa classe serve per la modifica del dialetto Hibernate a <literal>GlassfishDerbyDialect</literal>" - -#. Tag: para -#: Websphere.xml:580 -#, no-c-format -msgid "<literal>import.sql</literal> — either for the dialect or Derby DB the <literal>ID</literal> column can not be populated by this file and was removed." -msgstr "<literal>import.sql</literal> — la colonna <literal>ID</literal> sia del dialetto sia del Derby DB non può essere popolata ed è stata rimossa." - -#. Tag: para -#: Websphere.xml:589 -#, no-c-format -msgid "Changes for dependent libraries" -msgstr "Modifiche per le librerie dipendenti" - -#. Tag: para -#: Websphere.xml:590 -#, no-c-format -msgid "The Websphere version requires several library packages because they are not included as they are with JBoss AS. These are primarily for hibernate and their dependencies. Below are listed only the additional jars needed above and beyond the JBoss <literal>JPA</literal> example." -msgstr "La versione di Websphere richiede parecchi pacchetti di libreria inclusi invece in JBoss AS. Questi servono principalmente per Hibernate e le sue dipendenze. Sotto appare la lista dei jar addizionali necessari sopra e a prescindere dall'esempio JBoss <literal>JPA</literal>." - -#. Tag: para -#: Websphere.xml:597 -#, no-c-format -msgid "To use Hibernate as your JPA provider you need the following jars:" -msgstr "Per usare Hibernate come provider JPA occorrono i seguenti jar:" - -#. Tag: literal -#: Websphere.xml:602 -#, no-c-format -msgid "hibernate.jar" -msgstr "hibernate.jar" - -#. Tag: literal -#: Websphere.xml:607 -#, no-c-format -msgid "hibernate-annotations.jar" -msgstr "hibernate-annotations.jar" - -#. Tag: literal -#: Websphere.xml:612 -#, no-c-format -msgid "hibernate-commons-annotations.jar" -msgstr "hibernate-commons-annotations.jar" - -#. Tag: literal -#: Websphere.xml:617 -#, no-c-format -msgid "hibernate-entitymanager.jar" -msgstr "hibernate-entitymanager.jar" - -#. Tag: literal -#: Websphere.xml:622 -#, no-c-format -msgid "hibernate-validator.jar" -msgstr "hibernate-validator.jar" - -#. Tag: literal -#: Websphere.xml:627 -#, no-c-format -msgid "commons-collections.jar" -msgstr "commons-collections.jar" - -#. Tag: literal -#: Websphere.xml:632 -#, no-c-format -msgid "jboss-common-core.jar" -msgstr "jboss-common-core.jar" - -#. Tag: para -#: Websphere.xml:638 -#, no-c-format -msgid "Various third party jars that Websphere needs:" -msgstr "Websphere richiede vari jar di Terze Parti:" - -#. Tag: literal -#: Websphere.xml:641 -#, no-c-format -msgid "antlr.jar" -msgstr "antlr.jar" - -#. Tag: literal -#: Websphere.xml:645 -#, no-c-format -msgid "cglib.jar" -msgstr "cglib.jar" - -#. Tag: literal -#: Websphere.xml:649 -#, no-c-format -msgid "asm.jar" -msgstr "asm.jar" - -#. Tag: literal -#: Websphere.xml:653 -#, no-c-format -msgid "dom4j.jar" -msgstr "dom4j.jar" - -#. Tag: literal -#: Websphere.xml:658 -#, no-c-format -msgid "javassist.jar" -msgstr "javassist.jar" - -#. Tag: literal -#: Websphere.xml:663 -#, no-c-format -msgid "concurrent.jar" -msgstr "concurrent.jar" - -#. Tag: title -#: Websphere.xml:678 -#, no-c-format -msgid "Deploying an application created using <literal>seam-gen</literal> on Websphere V7" -msgstr "Deploy dell'applicazione creata usando <literal>seam-gen</literal> su Websphere V7" - -#. Tag: para -#: Websphere.xml:681 -#, no-c-format -msgid "<literal>seam-gen</literal> is a very useful tool for developers to quickly get an application up and running, and provides a foundation to add your own functionality. Out of box <literal>seam-gen</literal> will produce applications configured to run on JBoss AS. These instructions will show the steps needed to get it to run on Websphere. As stated above in <xref linkend=\"jee5-websphere-section\"/> there are some tricky changes needed to get an EJB3 application running. This section will take you through the exact steps." -msgstr "<literal>seam-gen</literal> è un tool molto utile per gli sviluppatori per ottenere velocemente applicazioni pronte per l'esecuzione e fornisce un fondamento per aggiungere proprie funzionalità. Di base <literal>seam-gen</literal> produrrà applicazioni configurate per girare su JBoss AS. Queste istruzioni mostreranno i passi necessari per farle funzionare su Websphere. Come dichiarato sopra in <xref linkend=\"jee5-websphere-section\"/> ci sono alcune modifiche sottili necessarie per avere un'applicazione EJB3 funzionante. Questa sezione mostrerà gli esatti passi da compiere." - -#. Tag: title -#: Websphere.xml:691 -#, no-c-format -msgid "Running <literal>seam-gen</literal> Setup" -msgstr "Eseguire il setup in <literal>seam-gen</literal>" - -#. Tag: para -#: Websphere.xml:692 -#, no-c-format -msgid "The first step is setting up <literal>seam-gen</literal> to construct the base project. There are several choices made below, specifically the datasource and hibernate values that we will adjust once the project is created." -msgstr "Il primo passo è impostare <literal>seam-gen</literal> per costruire il progetto base. Ci sono parecchie scelte fatte sotto, in particolar modo il datasource ed i valori Hibernate che occorre aggiustare una volta che il progetto è creato." - -#. Tag: programlisting -#: Websphere.xml:698 -#, no-c-format -msgid "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3.GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss.seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss.seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss.seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action.test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb.jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] []\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) [] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? [n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build.properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" +msgid "Deploying <literal>jpa</literal> application is very similar to the <literal>jee5/booking</literal> example at <xref linkend=\"jee5-websphere-deploy\"/>. The main difference is, that this time, we will deploy a war file instead of an ear file, and we'll have to manually specify the context root of the application." msgstr "" -"<![CDATA[\n" -"./seam setup\n" -"Buildfile: build.xml\n" -"\n" -"init:\n" -"\n" -"setup:\n" -" [echo] Welcome to seam-gen :-)\n" -" [input] Enter your Java project workspace (the directory that contains your \n" -"Seam projects) [C:/Projects] [C:/Projects]\n" -"/home/jbalunas/workspace\n" -" [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3.GA] \n" -"[C:/Program Files/jboss-4.2.3.GA]\n" -"/home/jbalunas/jboss/jboss-4.2.3.GA\n" -" [input] Enter the project name [myproject] [myproject]\n" -"websphere_example\n" -" [echo] Accepted project name as: websphere_example\n" -" [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], )\n" -"\n" -" [input] skipping input as property icefaces.home.new has already been set.\n" -" [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, wine, \n" -"deepMarine, emeraldTown, sakura, DEFAULT)\n" -"\n" -" [input] Is this project deployed as an EAR (with EJB components) or a WAR \n" -"(with no EJB support) [ear] ([ear], war, )\n" -"\n" -" [input] Enter the Java package name for your session beans [org.jboss.seam.\n" -"tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" -"org.jboss.seam.tutorial.websphere.action \n" -" [input] Enter the Java package name for your entity beans [org.jboss.seam.\n" -"tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" -"org.jboss.seam.tutorial.websphere.model \n" -" [input] Enter the Java package name for your test cases [org.jboss.seam.\n" -"tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action.test]\n" -"org.jboss.seam.tutorial.websphere.test\n" -" [input] What kind of database are you using? [hsql] ([hsql], mysql, oracle,\n" -" postgres, mssql, db2, sybase, enterprisedb, h2)\n" -"\n" -" [input] Enter the Hibernate dialect for your database [org.hibernate.\n" -"dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" -"\n" -" [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/hsqldb.jar] \n" -"[/tmp/seam/lib/hsqldb.jar]\n" -"\n" -" [input] Enter JDBC driver class for your database [org.hsqldb.jdbcDriver] \n" -"[org.hsqldb.jdbcDriver]\n" -"\n" -" [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" -"[jdbc:hsqldb:.]\n" -"\n" -" [input] Enter database username [sa] [sa]\n" -"\n" -" [input] Enter database password [] []\n" -"\n" -" [input] Enter the database schema name (it is OK to leave this blank) [] []\n" -"\n" -" [input] Enter the database catalog name (it is OK to leave this blank) [] []\n" -"\n" -" [input] Are you working with tables that already exist in the database? [n]\n" -" (y, [n], )\n" -"\n" -" [input] Do you want to drop and recreate the database tables and data in \n" -"import.sql each time you deploy? [n] (y, [n], )\n" -"\n" -"[propertyfile] Creating new property file: \n" -"/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build.properties\n" -" [echo] Installing JDBC driver jar to JBoss server\n" -" [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/default/lib\n" -" [echo] Type 'seam create-project' to create the new project\n" -"\n" -"BUILD SUCCESSFUL\n" -"Total time: 3 minutes 5 seconds]]>" #. Tag: para -#: Websphere.xml:700 +#: Websphere.xml:521 #, no-c-format -msgid "Type <literal>./seam new-project</literal> to create your project and <literal>cd /home/jbalunas/workspace/websphere_example</literal> to the newly created structure." -msgstr "Digitare <literal>./seam new-project</literal> per creare il progetto e <literal>cd /home/jbalunas/workspace/websphere_example</literal> per la nuova struttura creata." - -#. Tag: title -#: Websphere.xml:707 -#, no-c-format -msgid "Changes needed for deployment to Websphere" -msgstr "Cambiamenti richiesti per il deploy in Websphere" - -#. Tag: para -#: Websphere.xml:708 -#, no-c-format -msgid "We now need to make some changes to the generated project." -msgstr "Ora serve apportare alcuni cambiamenti al progetto generato." - -#. Tag: literal -#: Websphere.xml:714 -#, no-c-format -msgid "resources/META-INF/persistence-dev.xml" -msgstr "resources/META-INF/persistence-dev.xml" - -#. Tag: para -#: Websphere.xml:719 -#, no-c-format -msgid "Alter the <literal>jta-data-source</literal> to be <literal>DefaultDatasource</literal>. We are going to be using the integrated Websphere DB." -msgstr "Modificare <literal>jta-data-source</literal> in <literal>DefaultDatasource</literal>. Verrà usato il DB integrato di Websphere." - -#. Tag: para -#: Websphere.xml:726 -#, no-c-format -msgid "Add or change the properties below. These are described in detail at <xref linkend=\"jee5-websphere-section\"/>:" -msgstr "Aggiungere o modificare le proprietà sotto. Queste sono descritte in dettaglio in <xref linkend=\"jee5-websphere-section\"/>:" - -#. Tag: programlisting -#: Websphere.xml:731 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction.WebSphereExtendedJTATransactionLookup\"/>]]>" +msgid "Follow the same instructions as for the <literal>jee5/booking</literal> sample. Select the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</literal> file on the first page and on the <literal>Map context roots for Web modules</literal> page (after the <literal>Map virtual host for Web module</literal>), enter the context root you want to use for your application in the <literal>Contect Root</literal> input field." msgstr "" -"<![CDATA[\n" -"<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" -"<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" -"<property name=\"hibernate.show_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.format_sql\" value=\"true\"/>\n" -"<property name=\"hibernate.cache.provider_class\" \n" -" value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" -"<property name=\"hibernate.transaction.manager_lookup_class\" \n" -" value=\"org.hibernate.transaction.WebSphereExtendedJTATransactionLookup\"/>]]>" #. Tag: para -#: Websphere.xml:734 -#, no-c-format -msgid "Remove the JBoss AS specific method of exposing the EntityManagerFactory:" -msgstr "Rimuovere i metodi specifici di JBoss AS per esporre EntityManagerFactory:" +#: Websphere.xml:528 +#, fuzzy, no-c-format +msgid "When started, you can now access the application at the <literal>http://localhost:9080/<context root></literal>." +msgstr "Si può ora accedere all'applicazione all'indirizzo <literal>http://localhost:9080/jboss-seam-jpa/index.html</literal>." -#. Tag: programlisting -#: Websphere.xml:737 -#, no-c-format -msgid "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" -msgstr "" -"<![CDATA[<property \n" -" name=\"jboss.entity.manager.factory.jndi.name\" \n" -" value=\"java:/websphere_exampleEntityManagerFactory\">]]>" - -#. Tag: para -#: Websphere.xml:740 -#, no-c-format -msgid "You'll need to alter <literal>persistence-prod.xml</literal> as well if you want to deploy to Websphere using the prod profile." -msgstr "Serve modificare <literal>persistence-prod.xml</literal> anche se si vuole eseguire il deploy in Websphere usando il profile prod." - -#. Tag: para -#: Websphere.xml:753 -#, no-c-format -msgid "As with other examples we need to include this java class for DB support. It can be copied from the <literal>jpa</literal> example into the <literal>websphere_example/src</literal> directory." -msgstr "Come per gli altri esempi occorre includere questa classe java per il supporto DB. Può essere copiata dall'esempio <literal>jpa</literal> nella directory <literal>websphere_example/src</literal>." - -#. Tag: programlisting -#: Websphere.xml:759 -#, no-c-format -msgid "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" -msgstr "" -"<![CDATA[\n" -"cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" -" ./src]]>" - -#. Tag: literal -#: Websphere.xml:765 -#, no-c-format -msgid "resources/META-INF/jboss-app.xml" -msgstr "resources/META-INF/jboss-app.xml" - -#. Tag: para -#: Websphere.xml:768 -#, no-c-format -msgid "You can delete this file as we aren't deploying to JBoss AS ( <literal>jboss-app.xml</literal> is used to enable classloading isolation in JBoss AS)" -msgstr "Si può cancellare questo file poiché non si eseguirà il deploy in JBoss AS (<literal>jboss-app.xml</literal> viene usato per abilitare l'isolamento del classloading in JBoss AS)" - -#. Tag: literal -#: Websphere.xml:774 -#, no-c-format -msgid "resources/*-ds.xml" -msgstr "resources/*-ds.xml" - -#. Tag: para -#: Websphere.xml:777 -#, no-c-format -msgid "You can delete these file as we aren't deploying to JBoss AS (these files define datasources in JBoss AS, we are using Websphere's default datasource)" -msgstr "Si possono cancellare questi file poiché non si eseguirà il deploy in JBoss AS (questi file definiscono i datasource in JBoss AS, si userà invece il datasource di default di Websphere)" - -#. Tag: para -#: Websphere.xml:789 -#, no-c-format -msgid "Enable container managed transaction integration - add the <literal> <transaction:ejb-transaction /> </literal> component, and it's namespace declaration <literal> xmlns:transaction=\"http://jboss.com/products/seam/transaction\" </literal>" -msgstr "Abilitare l'integrazione delle transazioni gestite dal container - aggiungere il componente <literal><transaction:ejb-transaction /></literal> ed la sua dichiarazione di namespace <literal>xmlns:transaction=\"http://jboss.com/products/seam/transaction\"</literal>" - -#. Tag: para -#: Websphere.xml:798 -#, no-c-format -msgid "Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/websphere_example/#{ejbName} </literal>" -msgstr "Modificare <literal>jndi-pattern</literal> in <literal>java:comp/env/websphere_example/#{ejbName}</literal>" - -#. Tag: para -#: Websphere.xml:804 -#, no-c-format -msgid "We do not need <literal>managed-persistence-context</literal> for this example and so can delete its entry." -msgstr "Non serve <literal>managed-persistence-context</literal> per quest'esempio e quindi si può cancellare questa riga." - -#. Tag: programlisting -#: Websphere.xml:810 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/websphere_exampleEntityManagerFactory\"/> ]]>" -msgstr "" -"<![CDATA[\n" -"<persistence:managed-persistence-context name=\"entityManager\"\n" -" auto-create=\"true\"\n" -" persistence-unit-jndi-name=\"java:/websphere_exampleEntityManagerFactory\"/> ]]>" - -#. Tag: para -#: Websphere.xml:819 -#, no-c-format -msgid "As with the <literal>jee5/booking</literal> example we need to add EJB references to the web.xml. These references require replacing /local string in <literal>ejb-ref-name</literal> to flag them for Websphere to perform the proper binding." -msgstr "Come per l'esempio <literal>jee5/booking</literal> occorre aggiungere i riferimenti EJB a web.xml. Questi riferimenti richiedono di sostituire la stringa /local in <literal>ejb-ref-name</literal> e selezionarli affinché Websphere esegua il corretto binding." - -#. Tag: programlisting -#: Websphere.xml:826 -#, no-c-format -msgid "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" -msgstr "" -"<![CDATA[ \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local>\n" -" </ejb-local-ref> \n" -" \n" -" <ejb-local-ref>\n" -" <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" -" <ejb-ref-type>Session</ejb-ref-type>\n" -" <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" -" </ejb-local-ref>]]>" - #. Tag: title -#: Websphere.xml:832 +#: Websphere.xml:534 #, no-c-format -msgid "Creating the <literal>AuthenticatorAction</literal> EJB" -msgstr "Creazione dell'EJB <literal>AuthenticatorAction</literal>" - -#. Tag: para -#: Websphere.xml:834 -#, no-c-format -msgid "We want to take the existing <literal>Authenticator</literal> Seam POJO component and create an EJB3 out of it." -msgstr "Si vuole prendere il componente POJO Seam <literal>Authenticator</literal> e creare da questo un EJB3." - -#. Tag: para -#: Websphere.xml:837 -#, no-c-format -msgid "Change the generated Authenticator class" -msgstr "Cambiare la classe Authenticator generata" - -#. Tag: para -#: Websphere.xml:840 -#, no-c-format -msgid "Rename the class to <literal>AuthenticatorAction</literal>" -msgstr "Rinominare la classe in <literal>AuthenticatorAction</literal>" - -#. Tag: para -#: Websphere.xml:844 -#, no-c-format -msgid "Add the <literal>@Stateless</literal> annotation to the new <literal>AuthenticatorAction</literal> class." -msgstr "Aggiungere l'annotazione <literal>@Stateless</literal> alla nuova classe <literal>AuthenticatorAction</literal>." - -#. Tag: para -#: Websphere.xml:850 -#, no-c-format -msgid "Create an interface called <literal>Authenticator</literal> which <literal>AuthenticatorAction</literal> implements (EJB3 requires session beans to have a local interface). Annotate the interface with <literal>@Local</literal> , and add a single method with same signature as the <literal>authenticate</literal> in <literal>AuthenticatorAction</literal> ." -msgstr "Creare un'interfaccia chiamata <literal>Authenticator</literal> ed implementata da <literal>AuthenticatorAction</literal> (EJB3 richiede che i bean di sessione abbiano un'interfaccia locale). Annotare l'interfaccia con <literal>@Local</literal>, ed aggiungere un singolo metodo con la stessa firma come <literal>authenticate</literal> in <literal>AuthenticatorAction</literal>." - -#. Tag: programlisting -#: Websphere.xml:863 -#, no-c-format -msgid "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" +msgid "Deviation from the generic base files" msgstr "" -"<![CDATA[\n" -"@Name(\"authenticator\") @Stateless public class\n" -" AuthenticatorAction implements Authenticator {]]>" -#. Tag: programlisting -#: Websphere.xml:866 +#. Tag: section +#: Websphere.xml:534 #, no-c-format -msgid "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" +msgid "Below are the configuration file differences between the base configuration files and the files customized for WebSphere held in the <literal>resources-websphere7</literal> directory." msgstr "" -"<![CDATA[\n" -"@Local public interface Authenticator { \n" -" public boolean authenticate(); \n" -"}]]>" #. Tag: para -#: Websphere.xml:869 -#, no-c-format -msgid "We've already added its reference to the <literal>web.xml</literal> file so are good to go." -msgstr "Abbiamo già aggiunto il suo riferimento al file <literal>web.xml</literal> e quindi si può procedere." +#: Websphere.xml:539 +#, fuzzy, no-c-format +msgid "<literal>META-INF/persistence.xml</literal> — The main changes here are for the datasource JNDI path, switching to the WebSphere transaction manager look up class, turning off the <literal>hibernate.transaction.flush_before_completion</literal> toggle, and forcing the Hibernate dialect to be <literal>GlassfishDerbyDialect</literal> how as using the integrated Derby database" +msgstr "<literal>META-INF/persistence.xml</literal> — le maggiori modifiche sono per il path JNDI del datasource, passando alla classe di ricerca del gestore di transazioni Websphere e cambiando il dialetto Hibernate a <literal>GlassfishDerbyDialect</literal>." -#. Tag: title -#: Websphere.xml:875 -#, no-c-format -msgid "Extra jar dependencies and other changes to the <literal>build.xml</literal>" -msgstr "Dipendenze extra ed altre modifiche a <literal>build.xml</literal>" - #. Tag: para -#: Websphere.xml:877 +#: Websphere.xml:556 #, no-c-format -msgid "This application has similar requirements as the <literal>jee5/booking</literal> example." -msgstr "Quest'applicazione ha requisiti simili come nell'esempio <literal>jee5/booking</literal>." - -#. Tag: para -#: Websphere.xml:882 -#, no-c-format -msgid "Change the default target to <literal>archive</literal> (we aren't going to cover automatic deployment to Websphere)." -msgstr "Modificare il target di default a <literal>archive</literal> (non si tratterà il deploy automatico in Websphere)." - -#. Tag: programlisting -#: Websphere.xml:888 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" +msgid "Also the build procedure have been changed to include the <literal>log4j.jar</literal> file and exclude the <literal>concurrent.jar</literal> and <literal>jboss-common-core.jar</literal> files." msgstr "" -"<![CDATA[\n" -"<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" -#. Tag: para -#: Websphere.xml:892 -#, no-c-format -msgid "Websphere looks for the drools <literal>/security.drl</literal> file in the root of the <literal>war</literal> file instead of the root of the <literal>websphere_example.jar</literal> so we need to have the <literal>build.xml</literal> move it to the correct location at build time. The following must be added at the top of the <literal> <target name=\"war\" depends=\"compile\" description=\"Build the distribution .war file\"> </literal> target." -msgstr "Websphere cerca il file drools <literal>/security.drl</literal> nella radice di file <literal>war</literal> invece che nella radice di <literal>websphere_example.jar</literal> e quindi serve spostare <literal>build.xml</literal> nella corretta posizione al momento del build. La seguente riga deve essere aggiunta in cima al target <literal> <target name=\"war\" depends=\"compile\" description=\"Build the distribution .war file\"> </literal>." +#~ msgid "Installation versions" +#~ msgstr "Versioni delle installazioni" +#~ msgid "" +#~ "All of the examples and information in this chapter are based on the " +#~ "version V7 of Websphere AS at the time of this writing." +#~ msgstr "" +#~ "Tutti gli esempi e le informazioni in questo capitolo sono basate sulla " +#~ "versione V7 di Websphere AS al momento della scrittura." +#~ msgid "Websphere Application Server V7" +#~ msgstr "Websphere Application Server V7" +#~ msgid "" +#~ "After installing Websphere AS, create server profile with Profile " +#~ "Management Tool, if you didn't create profile in installation process." +#~ msgstr "" +#~ "Dopo l'installazione di Websphere AS, creare il profile del server con il " +#~ "Profile Management Tool, qualora non si sia creato il profile in fase di " +#~ "installazione." +#~ msgid "<title>Configuration file changes</title>" +#~ msgstr "<title>Cambiamenti al file di configurazione</title>" +#~ msgid "" +#~ "Below are the configuration file changes that are need to the base " +#~ "example." +#~ msgstr "" +#~ "Sotto sono riportate le modifiche al file di configurazione necessarie " +#~ "all'esempio base." +#~ msgid "resources/WEB-INF/components.xml" +#~ msgstr "resources/WEB-INF/components.xml" +#~ msgid "" +#~ "We need to change the way that we look up EJBs for WAS. We need to remove " +#~ "the <literal>/local</literal> from the end of the <literal>jndi-pattern</" +#~ "literal> attribute. It should look like this:" +#~ msgstr "" +#~ "Occorre cambiare il modo di ricerca EJB per WAS. Bisogna rimuovere " +#~ "<literal>/local</literal> dalla fine dell'attributo <literal>jndi-" +#~ "pattern</literal>. Dovrebbe apparire così:" +#~ msgid "resources/META-INF/ejb-jar.xml" +#~ msgstr "resources/META-INF/ejb-jar.xml" +#~ msgid "" +#~ "We need to replace the /local string from <literal>ejb-ref-name</" +#~ "literal>. See at the following final code:" +#~ msgstr "" +#~ "Sostituire la stringa /local da <literal>ejb-ref-name</literal>. Vedere " +#~ "il seguente codice finale:" +#~ msgid "" +#~ "<![CDATA[\n" +#~ " <enterprise-beans>\n" +#~ " \n" +#~ " \n" +#~ " <session>\n" +#~ " <ejb-name>RegisterAction</ejb-name>\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" +#~ "name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.Authenticator</local>\n" +#~ " </ejb-local-ref>\n" +#~ " </session>\n" +#~ " </enterprise-beans>]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ " <enterprise-beans>\n" +#~ " \n" +#~ " \n" +#~ " <session>\n" +#~ " <ejb-name>RegisterAction</ejb-name>\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-" +#~ "name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.Authenticator</local>\n" +#~ " </ejb-local-ref>\n" +#~ " </session>\n" +#~ " </enterprise-beans>]]>" +#~ msgid "resources/WEB-INF/web.xml" +#~ msgstr "resources/WEB-INF/web.xml" +#~ msgid "" +#~ "We have to make some changes to the EJB references in the <literal>web." +#~ "xml</literal>. These changes are what will allow WAS to bind " +#~ "automatically the EJB3 references in the web module to the the actual " +#~ "EJB3 beans in the EAR module. Replace all of the /local strings in " +#~ "<literal>ejb-local-refs</literal> when the values below." +#~ msgstr "" +#~ "Occorre apportare alcumi cambiamenti ai riferimenti EJB in <literal>web." +#~ "xml</literal>. Queste modifiche consentono a WAS di associare " +#~ "automaticamente i riferimenti EJB3 nel modulo web ai bean EJB3 nel modulo " +#~ "EAR. Sostituire tutte le stringhe /local in <literal>ejb-local-refs</" +#~ "literal>." +#~ msgid "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.Authenticator</local>\n" +#~ " </ejb-local-ref> \n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.BookingList</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.Register</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.ChangePassword</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.HotelBooking</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.HotelSearching</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +#~ " </ejb-local-ref>]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/AuthenticatorAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.Authenticator</local>\n" +#~ " </ejb-local-ref> \n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/BookingListAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.BookingList</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/RegisterAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.Register</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/ChangePasswordAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.ChangePassword</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/HotelBookingAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.HotelBooking</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/HotelSearchingAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.example.booking.HotelSearching</local>\n" +#~ " </ejb-local-ref>\n" +#~ "\n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>jboss-seam-jee5/EjbSynchronizations</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +#~ " </ejb-local-ref>]]>" +#~ msgid "" +#~ "Note also that <literal>EjbSynchronizations</literal> is a built-in Seam " +#~ "EJB and not part of the Hotel Booking example. This means that if your " +#~ "application's <literal>components.xml</literal> specifies " +#~ "<literal>transaction:ejb-transaction</literal>, then you must include:" +#~ msgstr "" +#~ "Si noti che <literal>EjbSynchronizations</literal> è un EJB predefinito " +#~ "in Seam e non è parte dell'esempio Prenotazione Hotel. Questo significa " +#~ "che se <literal>components.xml</literal> specifica <literal>transaction:" +#~ "ejb-transaction</literal>, allora occorre includere:" +#~ msgid "" +#~ "in your web.xml. If you don't include it, you'll get the following error:" +#~ msgstr "in web.xml. Se non viene incluso, si ottiene il seguente errore:" +#~ msgid "Name comp/env/myapp/EjbSynchronizations not found in context java:" +#~ msgstr "Name comp/env/myapp/EjbSynchronizations not found in context java:" +#~ msgid "resources/META-INF/persistence.xml" +#~ msgstr "resources/META-INF/persistence.xml" +#~ msgid "" +#~ "For this example we will be using the default datasource that comes with " +#~ "WAS. To do this change the <literal>jta-data-source</literal> element:" +#~ msgstr "" +#~ "Per questo esempio useremo il datasource di default che è presente in " +#~ "WAS. Cambiare l'elemento <literal>jta-data-source</literal>:" +#~ msgid "" +#~ "<![CDATA[\n" +#~ "<jta-data-source>DefaultDatasource</jta-data-source>\n" +#~ " ]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "<jta-data-source>DefaultDatasource</jta-data-source>\n" +#~ " ]]>" +#~ msgid "" +#~ "Then we need to adjust some of the hibernate properties. First comment " +#~ "out the Glassfish properties. Next you need to add/change the properties:" +#~ msgstr "" +#~ "Poi occorre sistemare alcune proprietà Hibernate. Innanzitutto commentare " +#~ "le proprietà Glassfish. Poi occorre aggiungere/modificare le proprietà:" +#~ msgid "" +#~ "<![CDATA[\n" +#~ "\n" +#~ "<property name=\"hibernate.cache.provider_class\" \n" +#~ " value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" +#~ "<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" +#~ "<property name=\"hibernate.transaction.manager_lookup_class\" \n" +#~ " value=\"org.hibernate.transaction." +#~ "WebSphereExtendedJTATransactionLookup\"/>\n" +#~ " ]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "\n" +#~ "<property name=\"hibernate.cache.provider_class\" \n" +#~ " value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" +#~ "<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" +#~ "<property name=\"hibernate.transaction.manager_lookup_class\" \n" +#~ " value=\"org.hibernate.transaction." +#~ "WebSphereExtendedJTATransactionLookup\"/>\n" +#~ " ]]>" +#~ msgid "" +#~ "<literal>hibernate.transaction.manager_lookup_class</literal> — " +#~ "Standard Hibernate transaction manager property for WAS 6.X and 7" +#~ msgstr "" +#~ "<literal>hibernate.transaction.manager_lookup_class</literal> — " +#~ "proprietà del gestore di transazioni standard Hibernate per WAS 6.X e 7" +#~ msgid "" +#~ "<literal>hibernate.transaction.flush_before_completion</literal> — " +#~ "This is commented out because we want the container to manage the " +#~ "transactions. Also if this is set to <literal>true</literal> an exception " +#~ "will be thrown by WAS when the EJBContext is looked up." +#~ msgstr "" +#~ "<literal>hibernate.transaction.flush_before_completion</literal> — " +#~ "questo è commentato poiché si vuole che il container gestisce le " +#~ "transazioni. Inoltre se questo viene impostato a <literal>true</literal>, " +#~ "viene lanciata un'eccezione da WAS quando viene cercato l'EJBContext." +#~ msgid "" +#~ "<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" +#~ " EJBContext may only be looked up by or injected into an " +#~ "EJB]]>" +#~ msgstr "" +#~ "<![CDATA[com.ibm.wsspi.injectionengine.InjectionException: \n" +#~ " EJBContext may only be looked up by or injected into an " +#~ "EJB]]>" +#~ msgid "" +#~ "<literal>hibernate.dialect</literal> — From WAS 6.1.0.9 on the " +#~ "embedded DB was switched to the same Derby DB as is in Glassfish v2." +#~ msgstr "" +#~ "<literal>hibernate.dialect</literal> — a partire da WAS 6.1.0.9 " +#~ "l'embedded DB è stato cambiato al Derby DB come in Glassfish v2." +#~ msgid "src/GlassfishDerbyDialect.java" +#~ msgstr "src/GlassfishDerbyDialect.java" +#~ msgid "" +#~ "You will need to get the <literal>GlassfishDerbyDialect.java</literal> " +#~ "and copy it into the <literal>/src</literal> directory. The java class " +#~ "exists in the JPA example source directory and can be copied using the " +#~ "command below assuming you are in <literal>jee5/booking</literal> " +#~ "directory:" +#~ msgstr "" +#~ "Occorre prendere <literal>GlassfishDerbyDialect.java</literal> e copiarlo " +#~ "nella directory <literal>/src</literal>. La classe java è presente nella " +#~ "directory dei sorgenti dell'esempio JPA e può essere copiata usando il " +#~ "comando sottostante assumendo di essere nella directory <literal>jee5/" +#~ "booking</literal>:" +#~ msgid "" +#~ "<![CDATA[\n" +#~ "cp ../../jpa/src/GlassfishDerbyDialect.java\n" +#~ " ./src]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "cp ../../jpa/src/GlassfishDerbyDialect.java\n" +#~ " ./src]]>" +#~ msgid "" +#~ "This class will be put into the <literal>jboss-seam-jee5.jar</literal> " +#~ "file." +#~ msgstr "" +#~ "Questa classe verrà messa nel file <literal>jboss-seam-jee5.jar</literal>." +#~ msgid "resources/import.sql" +#~ msgstr "resources/import.sql" +#~ msgid "" +#~ "This file must also be copied from the JPA example because either the " +#~ "Derby DB or the dialect does not support changes to the <literal>ID</" +#~ "literal> column. The files are identical except for the column " +#~ "difference. Use the following command to make the copy" +#~ msgstr "" +#~ "Questo file deve essere copiato dall'esempio JPA poiché sia Derby DB od " +#~ "il dialetto non supportano non supportano modifiche alla colonna " +#~ "<literal>ID</literal>. I file sono identici tranne per questa colonna. " +#~ "Usare il seguente comando per eseguire la copia:" +#~ msgid "" +#~ "<![CDATA[\n" +#~ "cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "cp ../../jpa/resources-websphere7/import.sql ./resources]]>" +#~ msgid "" +#~ "In order to get the changes we have made into our application we need to " +#~ "make some changes to the <literal>build.xml</literal>. There are also " +#~ "some additional jars that are required by our application in order to " +#~ "work with WAS. This section will cover what changes are needed to the " +#~ "<literal>build.xml</literal>." +#~ msgstr "" +#~ "Per ottenere le modifiche applicate occorre apportare dei cambiamenti a " +#~ "<literal>build.xml</literal>. Ci sono dei jar aggiuntivi richiesti " +#~ "dall'applicazione per funzionare con WAS. Questa sezione coprirà i " +#~ "cambiamenti da fare a <literal>build.xml</literal>." +#~ msgid "Library dependency changes" +#~ msgstr "Modifiche alle dipendenze di libreria" +#~ msgid "" +#~ "We remove the <literal>log4j.jar</literal> so that all of the log output " +#~ "from our application will be added to the WAS log. Additional steps are " +#~ "required to fully configure log4j and those are outside of the scope of " +#~ "this document." +#~ msgstr "" +#~ "SI rimuova <literal>log4j.jar</literal> affinché tutto l'output di log " +#~ "dell'applicazione venga aggiunto al log di WAS. Sono richiesti ulteriori " +#~ "passi per configurare log4j ma questi esulano dagli scopi di questo " +#~ "documento." +#~ msgid "" +#~ "Add the following entry to the bottom of the <literal>build.xml</literal> " +#~ "file. This overrides the default fileset that is used to populate the " +#~ "<literal>jboss-seam-jee5.jar</literal>. :" +#~ msgstr "" +#~ "Aggiungere la seguente riga alla fine del file <literal>build.xml</" +#~ "literal>. Questa sovrascrivere il fileset di default che viene usato per " +#~ "popolare <literal>jboss-seam-jee5.jar</literal>:" +#~ msgid "" +#~ "<![CDATA[\n" +#~ " <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" +#~ " <include name=\"import.sql\" />\n" +#~ " <include name=\"seam.properties\" />\n" +#~ " <include name=\"META-INF/persistence.xml\" />\n" +#~ " <include name=\"META-INF/ejb-jar.xml\" />\n" +#~ " </fileset>]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ " <fileset id=\"jar.resources\" dir=\"${resources.dir}\">\n" +#~ " <include name=\"import.sql\" />\n" +#~ " <include name=\"seam.properties\" />\n" +#~ " <include name=\"META-INF/persistence.xml\" />\n" +#~ " <include name=\"META-INF/ejb-jar.xml\" />\n" +#~ " </fileset>]]>" +#~ msgid "" +#~ "Now all that is left is to execute the <literal>ant archive</literal> " +#~ "task and the built application will be in the <literal>jee5/booking/dist</" +#~ "literal> directory." +#~ msgstr "" +#~ "Ora ciò che manca è eseguire il task <literal>ant archive</literal> ed il " +#~ "built dell'applicazione verrà messo nella directory <literal>jee5/booking/" +#~ "dist</literal>." +#~ msgid "Deploying the application to Websphere" +#~ msgstr "Deploy dell'applicazione in Websphere" +#~ msgid "" +#~ "So now we have everything we need in place. All that is left is to deploy " +#~ "it - just a few steps more." +#~ msgstr "" +#~ "Ora ogni cosa è al posto giusto. Ciò che manca è il deploy - qualche " +#~ "passo in più." +#~ msgid "" +#~ "For this we will use Websphere's administration console. As before there " +#~ "are some tricks and tips that must be followed." +#~ msgstr "" +#~ "Per questo si userà la console di amministrazione di Websphere. Come " +#~ "prima ecco alcuni trucchi e suggerimenti da seguire." +#~ msgid "<![CDATA[http://localhost:9060/admin]]>" +#~ msgstr "<![CDATA[http://localhost:9060/admin]]>" +#~ msgid "" +#~ "Now that we have our application installed we need to make some " +#~ "adjustments to it before we can start it:" +#~ msgstr "" +#~ "Ora che si è installata l'applicazione occorre fare degli aggiustamenti " +#~ "ad essa prima di avviarla:" +#~ msgid "" +#~ "Starting from the <literal>Enterprise Applications</literal> table select " +#~ "the <literal>Seam Booking</literal> link." +#~ msgstr "" +#~ "Partendo dalla tabella <literal>Enterprise Applications</literal> " +#~ "selezionare il link <literal>Seam Booking</literal>." +#~ msgid "Select the <literal>Manage Modules</literal> link." +#~ msgstr "Selezionare il link <literal>Manage Modules</literal>." +#~ msgid "Select the <literal>jboss-seam-jee5-booking.war</literal> link." +#~ msgstr "Selezionare il link <literal>jboss-seam-jee5-booking.war</literal>." +#~ msgid "" +#~ "Change the <literal>Class loader order</literal> combo box to " +#~ "<literal>Classes loaded with application class loader first (parent last)" +#~ "</literal>." +#~ msgstr "" +#~ "Cambiare il combo box <literal>Class loader order</literal> in " +#~ "<literal>Classes loaded with application class loader first (parent last)" +#~ "</literal>." +#~ msgid "" +#~ "Select <literal>Apply</literal> and then <literal>Save</literal> options." +#~ msgstr "" +#~ "Selezionare <literal>Apply</literal> poi l'opzione <literal>Save</" +#~ "literal>." +#~ msgid "Return to the <literal>Seam Booking</literal> page." +#~ msgstr "Ritornare alla pagina <literal>Seam Booking</literal>." +#~ msgid "" +#~ "On this page select the <literal>Class loading and update detection</" +#~ "literal> link." +#~ msgstr "" +#~ "Su questa pagina selezionare il link <literal>Class loading and update " +#~ "detection</literal>." +#~ msgid "" +#~ "Select the radio button for <literal>Classes loaded with application " +#~ "class loader first</literal>." +#~ msgstr "" +#~ "Selezionare il pulsante radio <literal>Classes loaded with application " +#~ "class loader first</literal>." +#~ msgid "" +#~ "This is similar to the <literal>jee5</literal> example at <xref linkend=" +#~ "\"jee5-websphere-deploy\"/>, but without so many steps." +#~ msgstr "" +#~ "Questo è simile all'esempio <literal>jee5</literal> all'indirizzo <xref " +#~ "linkend=\"jee5-websphere-deploy\"/>, ma senza molti passi." +#~ msgid "" +#~ "From the <literal>Enterprise Applications</literal> table select the " +#~ "<literal>Install</literal> button." +#~ msgstr "" +#~ "Dalla tabella <literal>Enterprise Applications</literal> selezionare il " +#~ "pulsante <literal>Install</literal>." +#~ msgid "" +#~ "Browse to the <literal>examples/jpa/dist-websphere7/jboss-seam-jpa.war</" +#~ "literal> file using the file upload widget." +#~ msgstr "" +#~ "Navigare fino al file <literal>examples/jpa/dist-websphere7/jboss-seam-" +#~ "jpa.war</literal> usando il widget per l'upload dei file." +#~ msgid "" +#~ "Select the <literal>Next</literal> button for the next three pages, no " +#~ "changes are needed." +#~ msgstr "" +#~ "Selezionare il pulsante <literal>Next</literal> per le prossime tre " +#~ "pagine, non servono modifiche." +#~ msgid "" +#~ "In the <literal>Context root</literal> text box enter <literal>jboss-seam-" +#~ "jpa</literal>." +#~ msgstr "" +#~ "Nel text box <literal>Context root</literal> inserire <literal>jboss-seam-" +#~ "jpa</literal>." +#~ msgid "<literal>Summary</literal> page" +#~ msgstr "Pagina <literal>Summario</literal>" +#~ msgid "" +#~ "Review the settings if you wish and select the <literal>Finish</literal> " +#~ "button to install the application. When installation finished select the " +#~ "<literal> Save</literal> link and you will be returned to the " +#~ "<literal>Enterprise Applications</literal> table." +#~ msgstr "" +#~ "Rivedere le impostazioni e selezionare il pulsante <literal>Finish</" +#~ "literal> per installre l'applicazione. Quando l'installazione è terminata " +#~ "selezionare il link <literal> Save</literal> e si ritornerà alla tabella " +#~ "<literal>Enterprise Applications</literal>." +#~ msgid "" +#~ "As with the <literal>jee5</literal> example there are some class loader " +#~ "changes needed before we start the application. Follow the instructions " +#~ "at <xref linkend=\"websphere-app-adj-after-install\"/> but exchange " +#~ "<literal>jboss-seam-jpa_war</literal> for <literal>Seam Booking</literal>." +#~ msgstr "" +#~ "Come per l'esempio <literal>jee5</literal> ci sono alcuni cambiamenti " +#~ "necessari al class loader prima di avviare l'applicazione. Seguire le " +#~ "istruzioni in <xref linkend=\"websphere-app-adj-after-install\"/> e " +#~ "cambiare <literal>jboss-seam-jpa_war</literal> per <literal>Seam Booking</" +#~ "literal>." +#~ msgid "" +#~ "Finally start the application by selecting it in the <literal>Enterprise " +#~ "Applications</literal> table and clicking the <literal>Start</literal> " +#~ "button." +#~ msgstr "" +#~ "Infine avviare l'applicazione selezionandola nella tabella " +#~ "<literal>Enterprise Applications</literal> e cliccando il pulsante " +#~ "<literal>Start</literal>." +#~ msgid "What's different for Websphere AS V7" +#~ msgstr "Cosa c'è di diverso in Websphere AS V7" +#~ msgid "" +#~ "The differences between the JPA examples that deploys to JBoss 4.2 and " +#~ "Websphere AS V7 are mostly expected; library and configuration file " +#~ "changes." +#~ msgstr "" +#~ "Le differenze tra gli esempi JPA che eseguono il deploy in JBoss 4.2 e " +#~ "Websphere AS V7 sono perlopiù attese; cambiamenti alle librerie ed al " +#~ "file di configurazione." +#~ msgid "<para>Configuration file changes</para>" +#~ msgstr "<para>Cambiamenti al file di configurazione</para>" +#~ msgid "" +#~ "<literal>META-INF/ejb-jar.xml</literal> — the same change in " +#~ "<literal>ejb-ref-name</literal>, where is replace /local string in " +#~ "<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +#~ msgstr "" +#~ "<literal>META-INF/ejb-jar.xml</literal> — stessa modifica in " +#~ "<literal>ejb-ref-name</literal>, dove la stringa /local diventa " +#~ "<literal>jboss-seam-jee5/AuthenticatorAction</literal>." +#~ msgid "" +#~ "<literal>src/GlassfishDerbyDialect.java </literal> — this class is " +#~ "needed for the hibernate dialect change to " +#~ "<literal>GlassfishDerbyDialect</literal>" +#~ msgstr "" +#~ "<literal>src/GlassfishDerbyDialect.java </literal> — questa classe " +#~ "serve per la modifica del dialetto Hibernate a " +#~ "<literal>GlassfishDerbyDialect</literal>" +#~ msgid "Changes for dependent libraries" +#~ msgstr "Modifiche per le librerie dipendenti" +#~ msgid "" +#~ "The Websphere version requires several library packages because they are " +#~ "not included as they are with JBoss AS. These are primarily for hibernate " +#~ "and their dependencies. Below are listed only the additional jars needed " +#~ "above and beyond the JBoss <literal>JPA</literal> example." +#~ msgstr "" +#~ "La versione di Websphere richiede parecchi pacchetti di libreria inclusi " +#~ "invece in JBoss AS. Questi servono principalmente per Hibernate e le sue " +#~ "dipendenze. Sotto appare la lista dei jar addizionali necessari sopra e a " +#~ "prescindere dall'esempio JBoss <literal>JPA</literal>." +#~ msgid "To use Hibernate as your JPA provider you need the following jars:" +#~ msgstr "Per usare Hibernate come provider JPA occorrono i seguenti jar:" +#~ msgid "hibernate.jar" +#~ msgstr "hibernate.jar" +#~ msgid "hibernate-annotations.jar" +#~ msgstr "hibernate-annotations.jar" +#~ msgid "hibernate-commons-annotations.jar" +#~ msgstr "hibernate-commons-annotations.jar" +#~ msgid "hibernate-entitymanager.jar" +#~ msgstr "hibernate-entitymanager.jar" +#~ msgid "hibernate-validator.jar" +#~ msgstr "hibernate-validator.jar" +#~ msgid "commons-collections.jar" +#~ msgstr "commons-collections.jar" +#~ msgid "jboss-common-core.jar" +#~ msgstr "jboss-common-core.jar" +#~ msgid "Various third party jars that Websphere needs:" +#~ msgstr "Websphere richiede vari jar di Terze Parti:" +#~ msgid "antlr.jar" +#~ msgstr "antlr.jar" +#~ msgid "cglib.jar" +#~ msgstr "cglib.jar" +#~ msgid "asm.jar" +#~ msgstr "asm.jar" +#~ msgid "dom4j.jar" +#~ msgstr "dom4j.jar" +#~ msgid "javassist.jar" +#~ msgstr "javassist.jar" +#~ msgid "concurrent.jar" +#~ msgstr "concurrent.jar" +#~ msgid "" +#~ "Deploying an application created using <literal>seam-gen</literal> on " +#~ "Websphere V7" +#~ msgstr "" +#~ "Deploy dell'applicazione creata usando <literal>seam-gen</literal> su " +#~ "Websphere V7" +#~ msgid "" +#~ "<literal>seam-gen</literal> is a very useful tool for developers to " +#~ "quickly get an application up and running, and provides a foundation to " +#~ "add your own functionality. Out of box <literal>seam-gen</literal> will " +#~ "produce applications configured to run on JBoss AS. These instructions " +#~ "will show the steps needed to get it to run on Websphere. As stated above " +#~ "in <xref linkend=\"jee5-websphere-section\"/> there are some tricky " +#~ "changes needed to get an EJB3 application running. This section will take " +#~ "you through the exact steps." +#~ msgstr "" +#~ "<literal>seam-gen</literal> è un tool molto utile per gli sviluppatori " +#~ "per ottenere velocemente applicazioni pronte per l'esecuzione e fornisce " +#~ "un fondamento per aggiungere proprie funzionalità. Di base <literal>seam-" +#~ "gen</literal> produrrà applicazioni configurate per girare su JBoss AS. " +#~ "Queste istruzioni mostreranno i passi necessari per farle funzionare su " +#~ "Websphere. Come dichiarato sopra in <xref linkend=\"jee5-websphere-section" +#~ "\"/> ci sono alcune modifiche sottili necessarie per avere " +#~ "un'applicazione EJB3 funzionante. Questa sezione mostrerà gli esatti " +#~ "passi da compiere." +#~ msgid "Running <literal>seam-gen</literal> Setup" +#~ msgstr "Eseguire il setup in <literal>seam-gen</literal>" +#~ msgid "" +#~ "The first step is setting up <literal>seam-gen</literal> to construct the " +#~ "base project. There are several choices made below, specifically the " +#~ "datasource and hibernate values that we will adjust once the project is " +#~ "created." +#~ msgstr "" +#~ "Il primo passo è impostare <literal>seam-gen</literal> per costruire il " +#~ "progetto base. Ci sono parecchie scelte fatte sotto, in particolar modo " +#~ "il datasource ed i valori Hibernate che occorre aggiustare una volta che " +#~ "il progetto è creato." +#~ msgid "" +#~ "<![CDATA[\n" +#~ "./seam setup\n" +#~ "Buildfile: build.xml\n" +#~ "\n" +#~ "init:\n" +#~ "\n" +#~ "setup:\n" +#~ " [echo] Welcome to seam-gen :-)\n" +#~ " [input] Enter your Java project workspace (the directory that " +#~ "contains your \n" +#~ "Seam projects) [C:/Projects] [C:/Projects]\n" +#~ "/home/jbalunas/workspace\n" +#~ " [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." +#~ "GA] \n" +#~ "[C:/Program Files/jboss-4.2.3.GA]\n" +#~ "/home/jbalunas/jboss/jboss-4.2.3.GA\n" +#~ " [input] Enter the project name [myproject] [myproject]\n" +#~ "websphere_example\n" +#~ " [echo] Accepted project name as: websphere_example\n" +#~ " [input] Do you want to use ICEFaces instead of RichFaces [n] (y, " +#~ "[n], )\n" +#~ "\n" +#~ " [input] skipping input as property icefaces.home.new has already been " +#~ "set.\n" +#~ " [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " +#~ "wine, \n" +#~ "deepMarine, emeraldTown, sakura, DEFAULT)\n" +#~ "\n" +#~ " [input] Is this project deployed as an EAR (with EJB components) or a " +#~ "WAR \n" +#~ "(with no EJB support) [ear] ([ear], war, )\n" +#~ "\n" +#~ " [input] Enter the Java package name for your session beans [org.jboss." +#~ "seam.\n" +#~ "tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" +#~ "org.jboss.seam.tutorial.websphere.action \n" +#~ " [input] Enter the Java package name for your entity beans [org.jboss." +#~ "seam.\n" +#~ "tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" +#~ "org.jboss.seam.tutorial.websphere.model \n" +#~ " [input] Enter the Java package name for your test cases [org.jboss." +#~ "seam.\n" +#~ "tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." +#~ "test]\n" +#~ "org.jboss.seam.tutorial.websphere.test\n" +#~ " [input] What kind of database are you using? [hsql] ([hsql], mysql, " +#~ "oracle,\n" +#~ " postgres, mssql, db2, sybase, enterprisedb, h2)\n" +#~ "\n" +#~ " [input] Enter the Hibernate dialect for your database [org." +#~ "hibernate.\n" +#~ "dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" +#~ "\n" +#~ " [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/" +#~ "lib/hsqldb.jar] \n" +#~ "[/tmp/seam/lib/hsqldb.jar]\n" +#~ "\n" +#~ " [input] Enter JDBC driver class for your database [org.hsqldb." +#~ "jdbcDriver] \n" +#~ "[org.hsqldb.jdbcDriver]\n" +#~ "\n" +#~ " [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" +#~ "[jdbc:hsqldb:.]\n" +#~ "\n" +#~ " [input] Enter database username [sa] [sa]\n" +#~ "\n" +#~ " [input] Enter database password [] []\n" +#~ "\n" +#~ " [input] Enter the database schema name (it is OK to leave this blank) " +#~ "[] []\n" +#~ "\n" +#~ " [input] Enter the database catalog name (it is OK to leave this " +#~ "blank) [] []\n" +#~ "\n" +#~ " [input] Are you working with tables that already exist in the " +#~ "database? [n]\n" +#~ " (y, [n], )\n" +#~ "\n" +#~ " [input] Do you want to drop and recreate the database tables and data " +#~ "in \n" +#~ "import.sql each time you deploy? [n] (y, [n], )\n" +#~ "\n" +#~ "[propertyfile] Creating new property file: \n" +#~ "/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." +#~ "properties\n" +#~ " [echo] Installing JDBC driver jar to JBoss server\n" +#~ " [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" +#~ "default/lib\n" +#~ " [echo] Type 'seam create-project' to create the new project\n" +#~ "\n" +#~ "BUILD SUCCESSFUL\n" +#~ "Total time: 3 minutes 5 seconds]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "./seam setup\n" +#~ "Buildfile: build.xml\n" +#~ "\n" +#~ "init:\n" +#~ "\n" +#~ "setup:\n" +#~ " [echo] Welcome to seam-gen :-)\n" +#~ " [input] Enter your Java project workspace (the directory that " +#~ "contains your \n" +#~ "Seam projects) [C:/Projects] [C:/Projects]\n" +#~ "/home/jbalunas/workspace\n" +#~ " [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3." +#~ "GA] \n" +#~ "[C:/Program Files/jboss-4.2.3.GA]\n" +#~ "/home/jbalunas/jboss/jboss-4.2.3.GA\n" +#~ " [input] Enter the project name [myproject] [myproject]\n" +#~ "websphere_example\n" +#~ " [echo] Accepted project name as: websphere_example\n" +#~ " [input] Do you want to use ICEFaces instead of RichFaces [n] (y, " +#~ "[n], )\n" +#~ "\n" +#~ " [input] skipping input as property icefaces.home.new has already been " +#~ "set.\n" +#~ " [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, " +#~ "wine, \n" +#~ "deepMarine, emeraldTown, sakura, DEFAULT)\n" +#~ "\n" +#~ " [input] Is this project deployed as an EAR (with EJB components) or a " +#~ "WAR \n" +#~ "(with no EJB support) [ear] ([ear], war, )\n" +#~ "\n" +#~ " [input] Enter the Java package name for your session beans [org.jboss." +#~ "seam.\n" +#~ "tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action]\n" +#~ "org.jboss.seam.tutorial.websphere.action \n" +#~ " [input] Enter the Java package name for your entity beans [org.jboss." +#~ "seam.\n" +#~ "tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model]\n" +#~ "org.jboss.seam.tutorial.websphere.model \n" +#~ " [input] Enter the Java package name for your test cases [org.jboss." +#~ "seam.\n" +#~ "tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action." +#~ "test]\n" +#~ "org.jboss.seam.tutorial.websphere.test\n" +#~ " [input] What kind of database are you using? [hsql] ([hsql], mysql, " +#~ "oracle,\n" +#~ " postgres, mssql, db2, sybase, enterprisedb, h2)\n" +#~ "\n" +#~ " [input] Enter the Hibernate dialect for your database [org." +#~ "hibernate.\n" +#~ "dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect]\n" +#~ "\n" +#~ " [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/" +#~ "lib/hsqldb.jar] \n" +#~ "[/tmp/seam/lib/hsqldb.jar]\n" +#~ "\n" +#~ " [input] Enter JDBC driver class for your database [org.hsqldb." +#~ "jdbcDriver] \n" +#~ "[org.hsqldb.jdbcDriver]\n" +#~ "\n" +#~ " [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] \n" +#~ "[jdbc:hsqldb:.]\n" +#~ "\n" +#~ " [input] Enter database username [sa] [sa]\n" +#~ "\n" +#~ " [input] Enter database password [] []\n" +#~ "\n" +#~ " [input] Enter the database schema name (it is OK to leave this blank) " +#~ "[] []\n" +#~ "\n" +#~ " [input] Enter the database catalog name (it is OK to leave this " +#~ "blank) [] []\n" +#~ "\n" +#~ " [input] Are you working with tables that already exist in the " +#~ "database? [n]\n" +#~ " (y, [n], )\n" +#~ "\n" +#~ " [input] Do you want to drop and recreate the database tables and data " +#~ "in \n" +#~ "import.sql each time you deploy? [n] (y, [n], )\n" +#~ "\n" +#~ "[propertyfile] Creating new property file: \n" +#~ "/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build." +#~ "properties\n" +#~ " [echo] Installing JDBC driver jar to JBoss server\n" +#~ " [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/" +#~ "default/lib\n" +#~ " [echo] Type 'seam create-project' to create the new project\n" +#~ "\n" +#~ "BUILD SUCCESSFUL\n" +#~ "Total time: 3 minutes 5 seconds]]>" +#~ msgid "" +#~ "Type <literal>./seam new-project</literal> to create your project and " +#~ "<literal>cd /home/jbalunas/workspace/websphere_example</literal> to the " +#~ "newly created structure." +#~ msgstr "" +#~ "Digitare <literal>./seam new-project</literal> per creare il progetto e " +#~ "<literal>cd /home/jbalunas/workspace/websphere_example</literal> per la " +#~ "nuova struttura creata." +#~ msgid "Changes needed for deployment to Websphere" +#~ msgstr "Cambiamenti richiesti per il deploy in Websphere" +#~ msgid "We now need to make some changes to the generated project." +#~ msgstr "Ora serve apportare alcuni cambiamenti al progetto generato." +#~ msgid "resources/META-INF/persistence-dev.xml" +#~ msgstr "resources/META-INF/persistence-dev.xml" +#~ msgid "" +#~ "Alter the <literal>jta-data-source</literal> to be " +#~ "<literal>DefaultDatasource</literal>. We are going to be using the " +#~ "integrated Websphere DB." +#~ msgstr "" +#~ "Modificare <literal>jta-data-source</literal> in " +#~ "<literal>DefaultDatasource</literal>. Verrà usato il DB integrato di " +#~ "Websphere." +#~ msgid "" +#~ "Add or change the properties below. These are described in detail at " +#~ "<xref linkend=\"jee5-websphere-section\"/>:" +#~ msgstr "" +#~ "Aggiungere o modificare le proprietà sotto. Queste sono descritte in " +#~ "dettaglio in <xref linkend=\"jee5-websphere-section\"/>:" +#~ msgid "" +#~ "<![CDATA[\n" +#~ "<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" +#~ "<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" +#~ "<property name=\"hibernate.show_sql\" value=\"true\"/>\n" +#~ "<property name=\"hibernate.format_sql\" value=\"true\"/>\n" +#~ "<property name=\"hibernate.cache.provider_class\" \n" +#~ " value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" +#~ "<property name=\"hibernate.transaction.manager_lookup_class\" \n" +#~ " value=\"org.hibernate.transaction." +#~ "WebSphereExtendedJTATransactionLookup\"/>]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "<property name=\"hibernate.dialect\" value=\"GlassfishDerbyDialect\"/>\n" +#~ "<property name=\"hibernate.hbm2ddl.auto\" value=\"update\"/>\n" +#~ "<property name=\"hibernate.show_sql\" value=\"true\"/>\n" +#~ "<property name=\"hibernate.format_sql\" value=\"true\"/>\n" +#~ "<property name=\"hibernate.cache.provider_class\" \n" +#~ " value=\"org.hibernate.cache.HashtableCacheProvider\"/>\n" +#~ "<property name=\"hibernate.transaction.manager_lookup_class\" \n" +#~ " value=\"org.hibernate.transaction." +#~ "WebSphereExtendedJTATransactionLookup\"/>]]>" +#~ msgid "" +#~ "Remove the JBoss AS specific method of exposing the EntityManagerFactory:" +#~ msgstr "" +#~ "Rimuovere i metodi specifici di JBoss AS per esporre EntityManagerFactory:" +#~ msgid "" +#~ "<![CDATA[<property \n" +#~ " name=\"jboss.entity.manager.factory.jndi.name\" \n" +#~ " value=\"java:/websphere_exampleEntityManagerFactory\">]]>" +#~ msgstr "" +#~ "<![CDATA[<property \n" +#~ " name=\"jboss.entity.manager.factory.jndi.name\" \n" +#~ " value=\"java:/websphere_exampleEntityManagerFactory\">]]>" +#~ msgid "" +#~ "You'll need to alter <literal>persistence-prod.xml</literal> as well if " +#~ "you want to deploy to Websphere using the prod profile." +#~ msgstr "" +#~ "Serve modificare <literal>persistence-prod.xml</literal> anche se si " +#~ "vuole eseguire il deploy in Websphere usando il profile prod." +#~ msgid "" +#~ "As with other examples we need to include this java class for DB support. " +#~ "It can be copied from the <literal>jpa</literal> example into the " +#~ "<literal>websphere_example/src</literal> directory." +#~ msgstr "" +#~ "Come per gli altri esempi occorre includere questa classe java per il " +#~ "supporto DB. Può essere copiata dall'esempio <literal>jpa</literal> nella " +#~ "directory <literal>websphere_example/src</literal>." +#~ msgid "" +#~ "<![CDATA[\n" +#~ "cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" +#~ " ./src]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java\n" +#~ " ./src]]>" +#~ msgid "resources/META-INF/jboss-app.xml" +#~ msgstr "resources/META-INF/jboss-app.xml" +#~ msgid "" +#~ "You can delete this file as we aren't deploying to JBoss AS " +#~ "( <literal>jboss-app.xml</literal> is used to enable classloading " +#~ "isolation in JBoss AS)" +#~ msgstr "" +#~ "Si può cancellare questo file poiché non si eseguirà il deploy in JBoss " +#~ "AS (<literal>jboss-app.xml</literal> viene usato per abilitare " +#~ "l'isolamento del classloading in JBoss AS)" +#~ msgid "resources/*-ds.xml" +#~ msgstr "resources/*-ds.xml" +#~ msgid "" +#~ "You can delete these file as we aren't deploying to JBoss AS (these files " +#~ "define datasources in JBoss AS, we are using Websphere's default " +#~ "datasource)" +#~ msgstr "" +#~ "Si possono cancellare questi file poiché non si eseguirà il deploy in " +#~ "JBoss AS (questi file definiscono i datasource in JBoss AS, si userà " +#~ "invece il datasource di default di Websphere)" +#~ msgid "" +#~ "Enable container managed transaction integration - add the <literal> <" +#~ "transaction:ejb-transaction /> </literal> component, and it's " +#~ "namespace declaration <literal> xmlns:transaction=\"http://jboss.com/" +#~ "products/seam/transaction\" </literal>" +#~ msgstr "" +#~ "Abilitare l'integrazione delle transazioni gestite dal container - " +#~ "aggiungere il componente <literal><transaction:ejb-transaction /></" +#~ "literal> ed la sua dichiarazione di namespace <literal>xmlns:transaction=" +#~ "\"http://jboss.com/products/seam/transaction\"</literal>" +#~ msgid "" +#~ "Alter the <literal>jndi-pattern</literal> to <literal> java:comp/env/" +#~ "websphere_example/#{ejbName} </literal>" +#~ msgstr "" +#~ "Modificare <literal>jndi-pattern</literal> in <literal>java:comp/env/" +#~ "websphere_example/#{ejbName}</literal>" +#~ msgid "" +#~ "We do not need <literal>managed-persistence-context</literal> for this " +#~ "example and so can delete its entry." +#~ msgstr "" +#~ "Non serve <literal>managed-persistence-context</literal> per " +#~ "quest'esempio e quindi si può cancellare questa riga." +#~ msgid "" +#~ "<![CDATA[\n" +#~ "<persistence:managed-persistence-context name=\"entityManager\"\n" +#~ " auto-create=\"true\"\n" +#~ " persistence-unit-jndi-name=\"java:/" +#~ "websphere_exampleEntityManagerFactory\"/> ]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "<persistence:managed-persistence-context name=\"entityManager\"\n" +#~ " auto-create=\"true\"\n" +#~ " persistence-unit-jndi-name=\"java:/" +#~ "websphere_exampleEntityManagerFactory\"/> ]]>" +#~ msgid "" +#~ "As with the <literal>jee5/booking</literal> example we need to add EJB " +#~ "references to the web.xml. These references require replacing /local " +#~ "string in <literal>ejb-ref-name</literal> to flag them for Websphere to " +#~ "perform the proper binding." +#~ msgstr "" +#~ "Come per l'esempio <literal>jee5/booking</literal> occorre aggiungere i " +#~ "riferimenti EJB a web.xml. Questi riferimenti richiedono di sostituire la " +#~ "stringa /local in <literal>ejb-ref-name</literal> e selezionarli affinché " +#~ "Websphere esegua il corretto binding." +#~ msgid "" +#~ "<![CDATA[ \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.tutorial.websphere.action.Authenticator</" +#~ "local>\n" +#~ " </ejb-local-ref> \n" +#~ " \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +#~ " </ejb-local-ref>]]>" +#~ msgstr "" +#~ "<![CDATA[ \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name>\n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.tutorial.websphere.action.Authenticator</" +#~ "local>\n" +#~ " </ejb-local-ref> \n" +#~ " \n" +#~ " <ejb-local-ref>\n" +#~ " <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> \n" +#~ " <ejb-ref-type>Session</ejb-ref-type>\n" +#~ " <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>\n" +#~ " </ejb-local-ref>]]>" +#~ msgid "Creating the <literal>AuthenticatorAction</literal> EJB" +#~ msgstr "Creazione dell'EJB <literal>AuthenticatorAction</literal>" +#~ msgid "" +#~ "We want to take the existing <literal>Authenticator</literal> Seam POJO " +#~ "component and create an EJB3 out of it." +#~ msgstr "" +#~ "Si vuole prendere il componente POJO Seam <literal>Authenticator</" +#~ "literal> e creare da questo un EJB3." +#~ msgid "Change the generated Authenticator class" +#~ msgstr "Cambiare la classe Authenticator generata" +#~ msgid "Rename the class to <literal>AuthenticatorAction</literal>" +#~ msgstr "Rinominare la classe in <literal>AuthenticatorAction</literal>" +#~ msgid "" +#~ "Add the <literal>@Stateless</literal> annotation to the new " +#~ "<literal>AuthenticatorAction</literal> class." +#~ msgstr "" +#~ "Aggiungere l'annotazione <literal>@Stateless</literal> alla nuova classe " +#~ "<literal>AuthenticatorAction</literal>." +#~ msgid "" +#~ "Create an interface called <literal>Authenticator</literal> which " +#~ "<literal>AuthenticatorAction</literal> implements (EJB3 requires session " +#~ "beans to have a local interface). Annotate the interface with " +#~ "<literal>@Local</literal> , and add a single method with same signature " +#~ "as the <literal>authenticate</literal> in <literal>AuthenticatorAction</" +#~ "literal> ." +#~ msgstr "" +#~ "Creare un'interfaccia chiamata <literal>Authenticator</literal> ed " +#~ "implementata da <literal>AuthenticatorAction</literal> (EJB3 richiede che " +#~ "i bean di sessione abbiano un'interfaccia locale). Annotare l'interfaccia " +#~ "con <literal>@Local</literal>, ed aggiungere un singolo metodo con la " +#~ "stessa firma come <literal>authenticate</literal> in " +#~ "<literal>AuthenticatorAction</literal>." +#~ msgid "" +#~ "<![CDATA[\n" +#~ "@Name(\"authenticator\") @Stateless public class\n" +#~ " AuthenticatorAction implements Authenticator {]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "@Name(\"authenticator\") @Stateless public class\n" +#~ " AuthenticatorAction implements Authenticator {]]>" +#~ msgid "" +#~ "<![CDATA[\n" +#~ "@Local public interface Authenticator { \n" +#~ " public boolean authenticate(); \n" +#~ "}]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "@Local public interface Authenticator { \n" +#~ " public boolean authenticate(); \n" +#~ "}]]>" +#~ msgid "" +#~ "We've already added its reference to the <literal>web.xml</literal> file " +#~ "so are good to go." +#~ msgstr "" +#~ "Abbiamo già aggiunto il suo riferimento al file <literal>web.xml</" +#~ "literal> e quindi si può procedere." +#~ msgid "" +#~ "Extra jar dependencies and other changes to the <literal>build.xml</" +#~ "literal>" +#~ msgstr "Dipendenze extra ed altre modifiche a <literal>build.xml</literal>" +#~ msgid "" +#~ "This application has similar requirements as the <literal>jee5/booking</" +#~ "literal> example." +#~ msgstr "" +#~ "Quest'applicazione ha requisiti simili come nell'esempio <literal>jee5/" +#~ "booking</literal>." +#~ msgid "" +#~ "Change the default target to <literal>archive</literal> (we aren't going " +#~ "to cover automatic deployment to Websphere)." +#~ msgstr "" +#~ "Modificare il target di default a <literal>archive</literal> (non si " +#~ "tratterà il deploy automatico in Websphere)." +#~ msgid "" +#~ "<![CDATA[\n" +#~ "<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "<project name=\"websphere_example\" default=\"archive\" basedir=\".\">]]>" +#~ msgid "" +#~ "Websphere looks for the drools <literal>/security.drl</literal> file in " +#~ "the root of the <literal>war</literal> file instead of the root of the " +#~ "<literal>websphere_example.jar</literal> so we need to have the " +#~ "<literal>build.xml</literal> move it to the correct location at build " +#~ "time. The following must be added at the top of the <literal> <target " +#~ "name=\"war\" depends=\"compile\" description=\"Build the distribution ." +#~ "war file\"> </literal> target." +#~ msgstr "" +#~ "Websphere cerca il file drools <literal>/security.drl</literal> nella " +#~ "radice di file <literal>war</literal> invece che nella radice di " +#~ "<literal>websphere_example.jar</literal> e quindi serve spostare " +#~ "<literal>build.xml</literal> nella corretta posizione al momento del " +#~ "build. La seguente riga deve essere aggiunta in cima al target <literal> " +#~ "<target name=\"war\" depends=\"compile\" description=\"Build the " +#~ "distribution .war file\"> </literal>." +#~ msgid "" +#~ "<![CDATA[\n" +#~ "<copy todir=\"${war.dir}\">\n" +#~ " <fileset dir=\"${basedir}/resources\" >\n" +#~ " <include name=\"*.drl\" />\n" +#~ " </fileset>\n" +#~ "</copy>]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "<copy todir=\"${war.dir}\">\n" +#~ " <fileset dir=\"${basedir}/resources\" >\n" +#~ " <include name=\"*.drl\" />\n" +#~ " </fileset>\n" +#~ "</copy>]]>" +#~ msgid "" +#~ "Now we need to get extra jars into the <literal>build.xml</literal>. Look " +#~ "for the <literal><fileset dir=\"${basedir}\"></literal> section of " +#~ "the task below. Add the new includes at the bottom of the fileset." +#~ msgstr "" +#~ "Ora occorre inserire i jar extra in <literal>build.xml</literal>. Cercare " +#~ "la sezione <literal><fileset dir=\"${basedir}\"></literal> del task " +#~ "sotto. Aggiungere nuovi include in fondo al fileset." +#~ msgid "" +#~ "<![CDATA[\n" +#~ "<target name=\"ear\" description=\"Build the EAR\">\n" +#~ " <copy todir=\"${ear.dir}\">\n" +#~ " <fileset dir=\"${basedir}/resources\">\n" +#~ " <include name=\"*jpdl.xml\" />\n" +#~ " <include name=\"*hibernate.cfg.xml\" />\n" +#~ " <include name=\"jbpm.cfg.xml\" />\n" +#~ " </fileset>\n" +#~ "\n" +#~ " <fileset dir=\"${basedir}\">\n" +#~ " <include name=\"lib/jbpm*.jar\" />\n" +#~ " <include name=\"lib/jboss-el.jar\" />\n" +#~ " <include name=\"lib/drools-*.jar\"/>\n" +#~ " <include name=\"lib/core.jar\"/>\n" +#~ " <include name=\"lib/janino*.jar\"/>\n" +#~ " <include name=\"lib/antlr-*.jar\"/>\n" +#~ " <include name=\"lib/mvel*.jar\"/>\n" +#~ " <include name=\"lib/richfaces-api*.jar\" />\n" +#~ " </fileset>\n" +#~ " </copy>\n" +#~ " <copy todir=\"${ear.dir}/META-INF\">\n" +#~ " <fileset dir=\"${basedir}/resources/META-INF\">\n" +#~ " <include name=\"application.xml\" />\n" +#~ " <include name=\"jboss-app.xml\" />\n" +#~ " </fileset>\n" +#~ " </copy>\n" +#~ "</target>]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ "<target name=\"ear\" description=\"Build the EAR\">\n" +#~ " <copy todir=\"${ear.dir}\">\n" +#~ " <fileset dir=\"${basedir}/resources\">\n" +#~ " <include name=\"*jpdl.xml\" />\n" +#~ " <include name=\"*hibernate.cfg.xml\" />\n" +#~ " <include name=\"jbpm.cfg.xml\" />\n" +#~ " </fileset>\n" +#~ "\n" +#~ " <fileset dir=\"${basedir}\">\n" +#~ " <include name=\"lib/jbpm*.jar\" />\n" +#~ " <include name=\"lib/jboss-el.jar\" />\n" +#~ " <include name=\"lib/drools-*.jar\"/>\n" +#~ " <include name=\"lib/core.jar\"/>\n" +#~ " <include name=\"lib/janino*.jar\"/>\n" +#~ " <include name=\"lib/antlr-*.jar\"/>\n" +#~ " <include name=\"lib/mvel*.jar\"/>\n" +#~ " <include name=\"lib/richfaces-api*.jar\" />\n" +#~ " </fileset>\n" +#~ " </copy>\n" +#~ " <copy todir=\"${ear.dir}/META-INF\">\n" +#~ " <fileset dir=\"${basedir}/resources/META-INF\">\n" +#~ " <include name=\"application.xml\" />\n" +#~ " <include name=\"jboss-app.xml\" />\n" +#~ " </fileset>\n" +#~ " </copy>\n" +#~ "</target>]]>" +#~ msgid "Hibernate dependencies" +#~ msgstr "Dipendenze Hibernate" +#~ msgid "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " <include name=\"lib/hibernate.jar\"/>\n" +#~ " <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-entitymanager.jar\"/>\n" +#~ " <include name=\"lib/hibernate-validator.jar\"/>\n" +#~ " <include name=\"lib/jboss-common-core.jar\" />]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " <include name=\"lib/hibernate.jar\"/>\n" +#~ " <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-entitymanager.jar\"/>\n" +#~ " <include name=\"lib/hibernate-validator.jar\"/>\n" +#~ " <include name=\"lib/jboss-common-core.jar\" />]]>" +#~ msgid "Third party dependencies." +#~ msgstr "Dipendenze di terze parti" +#~ msgid "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " \n" +#~ " <include name=\"lib/javassist.jar\"/>\n" +#~ " <include name=\"lib/dom4j.jar\" />\n" +#~ " <include name=\"lib/concurrent.jar\" />\n" +#~ " <include name=\"lib/cglib.jar\"/>\n" +#~ " <include name=\"lib/asm.jar\"/>\n" +#~ " <include name=\"lib/antlr.jar\" />\n" +#~ " <include name=\"lib/commons-logging.jar\" />\n" +#~ " <include name=\"lib/commons-collections.jar\" />]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " \n" +#~ " <include name=\"lib/javassist.jar\"/>\n" +#~ " <include name=\"lib/dom4j.jar\" />\n" +#~ " <include name=\"lib/concurrent.jar\" />\n" +#~ " <include name=\"lib/cglib.jar\"/>\n" +#~ " <include name=\"lib/asm.jar\"/>\n" +#~ " <include name=\"lib/antlr.jar\" />\n" +#~ " <include name=\"lib/commons-logging.jar\" />\n" +#~ " <include name=\"lib/commons-collections.jar\" />]]>" +#~ msgid "" +#~ "<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</" +#~ "literal> base directory." +#~ msgstr "" +#~ "<literal>jboss-seam.jar</literal> - questo è richiesto nella directory " +#~ "base <literal>ear</literal>." +#~ msgid "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " <include name=\"lib/jboss-seam.jar\" />]]>" +#~ msgstr "" +#~ "<![CDATA[\n" +#~ " \n" +#~ " <include name=\"lib/jboss-seam.jar\" />]]>" +#~ msgid "You should end up with something like:" +#~ msgstr "Si dovrebbe terminare con qualcosa di simile a:" +#~ msgid "" +#~ "<![CDATA[<fileset dir=\"${basedir}\">\n" +#~ " \n" +#~ " <include name=\"lib/jbpm*.jar\" />\n" +#~ " <include name=\"lib/jboss-el.jar\" />\n" +#~ " <include name=\"lib/drools-*.jar\"/>\n" +#~ " <include name=\"lib/core.jar\"/>\n" +#~ " <include name=\"lib/janino*.jar\"/>\n" +#~ " <include name=\"lib/antlr-*.jar\"/>\n" +#~ " <include name=\"lib/mvel*.jar\"/>\n" +#~ " <include name=\"lib/richfaces-api*.jar\" />\n" +#~ " \n" +#~ " \n" +#~ " <include name=\"lib/hibernate.jar\"/>\n" +#~ " <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-entitymanager.jar\"/>\n" +#~ " <include name=\"lib/hibernate-validator.jar\"/>\n" +#~ " <include name=\"lib/jboss-common-core.jar\" />\n" +#~ "\n" +#~ " \n" +#~ " <include name=\"lib/javassist.jar\"/>\n" +#~ " <include name=\"lib/dom4j.jar\" />\n" +#~ " <include name=\"lib/concurrent.jar\" />\n" +#~ " <include name=\"lib/cglib.jar\"/>\n" +#~ " <include name=\"lib/asm.jar\"/>\n" +#~ " <include name=\"lib/antlr.jar\" />\n" +#~ " <include name=\"lib/commons-logging.jar\" />\n" +#~ " <include name=\"lib/commons-collections.jar\" />\n" +#~ " \n" +#~ " \n" +#~ " <include name=\"lib/jboss-seam.jar\" />\n" +#~ " \n" +#~ "</fileset>]]>" +#~ msgstr "" +#~ "<![CDATA[<fileset dir=\"${basedir}\">\n" +#~ " \n" +#~ " <include name=\"lib/jbpm*.jar\" />\n" +#~ " <include name=\"lib/jboss-el.jar\" />\n" +#~ " <include name=\"lib/drools-*.jar\"/>\n" +#~ " <include name=\"lib/core.jar\"/>\n" +#~ " <include name=\"lib/janino*.jar\"/>\n" +#~ " <include name=\"lib/antlr-*.jar\"/>\n" +#~ " <include name=\"lib/mvel*.jar\"/>\n" +#~ " <include name=\"lib/richfaces-api*.jar\" />\n" +#~ " \n" +#~ " \n" +#~ " <include name=\"lib/hibernate.jar\"/>\n" +#~ " <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-annotations.jar\"/>\n" +#~ " <include name=\"lib/hibernate-entitymanager.jar\"/>\n" +#~ " <include name=\"lib/hibernate-validator.jar\"/>\n" +#~ " <include name=\"lib/jboss-common-core.jar\" />\n" +#~ "\n" +#~ " \n" +#~ " <include name=\"lib/javassist.jar\"/>\n" +#~ " <include name=\"lib/dom4j.jar\" />\n" +#~ " <include name=\"lib/concurrent.jar\" />\n" +#~ " <include name=\"lib/cglib.jar\"/>\n" +#~ " <include name=\"lib/asm.jar\"/>\n" +#~ " <include name=\"lib/antlr.jar\" />\n" +#~ " <include name=\"lib/commons-logging.jar\" />\n" +#~ " <include name=\"lib/commons-collections.jar\" />\n" +#~ " \n" +#~ " \n" +#~ " <include name=\"lib/jboss-seam.jar\" />\n" +#~ " \n" +#~ "</fileset>]]>" +#~ msgid "Building and deploying the seam-gen'd application to Websphere" +#~ msgstr "Build e deploy di un'applicazione seam-gen in Websphere" +#~ msgid "" +#~ "Build your application by calling <literal>ant</literal> in the base " +#~ "directory of your project (ex. <literal>/home/jbalunas/workspace/" +#~ "websphere_example</literal> ). The target of the build will be " +#~ "<literal>dist/websphere_example.ear</literal> ." +#~ msgstr "" +#~ "Eseguire il build dell'applicazione chiamando <literal>ant</literal> " +#~ "nella directory base del progetto (es. <literal>/home/jbalunas/workspace/" +#~ "websphere_example</literal>). Il target del build sarà <literal>dist/" +#~ "websphere_example.ear</literal>." +#~ msgid "" +#~ "To deploy the application follow the instructions here : <xref linkend=" +#~ "\"jee5-websphere-deploy\"/> but use references to this project " +#~ "<literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</" +#~ "literal>." +#~ msgstr "" +#~ "Per fare il deploy dell'applicazione seguire le istruzioni in <xref " +#~ "linkend=\"jee5-websphere-deploy\"/> ma usare i riferimenti a questo " +#~ "progetto <literal>websphere_example</literal> invece che a <literal>jboss-" +#~ "seam-jee5</literal>." +#~ msgid "" +#~ "Checkout the app at: <literal>http://localhost:9080/websphere_example/" +#~ "index.html</literal>" +#~ msgstr "" +#~ "Controllare l'applicazione all'indirizzo: <literal>http://localhost:9080/" +#~ "websphere_example/index.html</literal>" -#. Tag: programlisting -#: Websphere.xml:903 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" -msgstr "" -"<![CDATA[\n" -"<copy todir=\"${war.dir}\">\n" -" <fileset dir=\"${basedir}/resources\" >\n" -" <include name=\"*.drl\" />\n" -" </fileset>\n" -"</copy>]]>" - -#. Tag: para -#: Websphere.xml:906 -#, no-c-format -msgid "Now we need to get extra jars into the <literal>build.xml</literal>. Look for the <literal><fileset dir=\"${basedir}\"></literal> section of the task below. Add the new includes at the bottom of the fileset." -msgstr "Ora occorre inserire i jar extra in <literal>build.xml</literal>. Cercare la sezione <literal><fileset dir=\"${basedir}\"></literal> del task sotto. Aggiungere nuovi include in fondo al fileset." - -#. Tag: programlisting -#: Websphere.xml:914 -#, no-c-format -msgid "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" -msgstr "" -"<![CDATA[\n" -"<target name=\"ear\" description=\"Build the EAR\">\n" -" <copy todir=\"${ear.dir}\">\n" -" <fileset dir=\"${basedir}/resources\">\n" -" <include name=\"*jpdl.xml\" />\n" -" <include name=\"*hibernate.cfg.xml\" />\n" -" <include name=\"jbpm.cfg.xml\" />\n" -" </fileset>\n" -"\n" -" <fileset dir=\"${basedir}\">\n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" </fileset>\n" -" </copy>\n" -" <copy todir=\"${ear.dir}/META-INF\">\n" -" <fileset dir=\"${basedir}/resources/META-INF\">\n" -" <include name=\"application.xml\" />\n" -" <include name=\"jboss-app.xml\" />\n" -" </fileset>\n" -" </copy>\n" -"</target>]]>" - -#. Tag: para -#: Websphere.xml:917 -#, no-c-format -msgid "Hibernate dependencies" -msgstr "Dipendenze Hibernate" - -#. Tag: programlisting -#: Websphere.xml:918 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" -msgstr "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />]]>" - -#. Tag: para -#: Websphere.xml:921 -#, no-c-format -msgid "Third party dependencies." -msgstr "Dipendenze di terze parti" - -#. Tag: programlisting -#: Websphere.xml:922 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" -msgstr "" -"<![CDATA[\n" -" \n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />]]>" - -#. Tag: para -#: Websphere.xml:925 -#, no-c-format -msgid "<literal>jboss-seam.jar</literal> - this is needed in the <literal>ear</literal> base directory." -msgstr "<literal>jboss-seam.jar</literal> - questo è richiesto nella directory base <literal>ear</literal>." - -#. Tag: programlisting -#: Websphere.xml:928 -#, no-c-format -msgid "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" -msgstr "" -"<![CDATA[\n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />]]>" - -#. Tag: para -#: Websphere.xml:932 -#, no-c-format -msgid "You should end up with something like:" -msgstr "Si dovrebbe terminare con qualcosa di simile a:" - -#. Tag: programlisting -#: Websphere.xml:933 -#, no-c-format -msgid "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" -msgstr "" -"<![CDATA[<fileset dir=\"${basedir}\">\n" -" \n" -" <include name=\"lib/jbpm*.jar\" />\n" -" <include name=\"lib/jboss-el.jar\" />\n" -" <include name=\"lib/drools-*.jar\"/>\n" -" <include name=\"lib/core.jar\"/>\n" -" <include name=\"lib/janino*.jar\"/>\n" -" <include name=\"lib/antlr-*.jar\"/>\n" -" <include name=\"lib/mvel*.jar\"/>\n" -" <include name=\"lib/richfaces-api*.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/hibernate.jar\"/>\n" -" <include name=\"lib/hibernate-commons-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-annotations.jar\"/>\n" -" <include name=\"lib/hibernate-entitymanager.jar\"/>\n" -" <include name=\"lib/hibernate-validator.jar\"/>\n" -" <include name=\"lib/jboss-common-core.jar\" />\n" -"\n" -" \n" -" <include name=\"lib/javassist.jar\"/>\n" -" <include name=\"lib/dom4j.jar\" />\n" -" <include name=\"lib/concurrent.jar\" />\n" -" <include name=\"lib/cglib.jar\"/>\n" -" <include name=\"lib/asm.jar\"/>\n" -" <include name=\"lib/antlr.jar\" />\n" -" <include name=\"lib/commons-logging.jar\" />\n" -" <include name=\"lib/commons-collections.jar\" />\n" -" \n" -" \n" -" <include name=\"lib/jboss-seam.jar\" />\n" -" \n" -"</fileset>]]>" - -#. Tag: title -#: Websphere.xml:940 -#, no-c-format -msgid "Building and deploying the seam-gen'd application to Websphere" -msgstr "Build e deploy di un'applicazione seam-gen in Websphere" - -#. Tag: para -#: Websphere.xml:945 -#, no-c-format -msgid "Build your application by calling <literal>ant</literal> in the base directory of your project (ex. <literal>/home/jbalunas/workspace/websphere_example</literal> ). The target of the build will be <literal>dist/websphere_example.ear</literal> ." -msgstr "Eseguire il build dell'applicazione chiamando <literal>ant</literal> nella directory base del progetto (es. <literal>/home/jbalunas/workspace/websphere_example</literal>). Il target del build sarà <literal>dist/websphere_example.ear</literal>." - -#. Tag: para -#: Websphere.xml:954 -#, no-c-format -msgid "To deploy the application follow the instructions here : <xref linkend=\"jee5-websphere-deploy\"/> but use references to this project <literal>websphere_example</literal> instead of <literal>jboss-seam-jee5</literal>." -msgstr "Per fare il deploy dell'applicazione seguire le istruzioni in <xref linkend=\"jee5-websphere-deploy\"/> ma usare i riferimenti a questo progetto <literal>websphere_example</literal> invece che a <literal>jboss-seam-jee5</literal>." - -#. Tag: para -#: Websphere.xml:960 -#, no-c-format -msgid "Checkout the app at: <literal>http://localhost:9080/websphere_example/index.html</literal>" -msgstr "Controllare l'applicazione all'indirizzo: <literal>http://localhost:9080/websphere_example/index.html</literal>" -

15 years, 4 months

1
0
0 / 0

Seam SVN: r11415 - in branches/community/Seam_2_2/src/test/ftest: examples and 1 other directory.

by seam-commits＠lists.jboss.org

Author: oskutka(a)redhat.com Date: 2009-08-21 04:45:14 -0400 (Fri, 21 Aug 2009) New Revision: 11415 Modified: branches/community/Seam_2_2/src/test/ftest/examples/build.xml branches/community/Seam_2_2/src/test/ftest/ftest.ci.properties branches/community/Seam_2_2/src/test/ftest/ftest.properties Log: =JBSEAM-4293 Make JBoss restart after a specified number of ftests run to prevent OutOfMemoryError Modified: branches/community/Seam_2_2/src/test/ftest/examples/build.xml =================================================================== --- branches/community/Seam_2_2/src/test/ftest/examples/build.xml 2009-08-21 00:43:34 UTC (rev 11414) +++ branches/community/Seam_2_2/src/test/ftest/examples/build.xml 2009-08-21 08:45:14 UTC (rev 11415) @@ -231,9 +231,11 @@ <pathelement location="${container.home}/bin/shutdown.jar" />  </classpath> - <arg value="--server"/> - <arg value="jnp://localhost:1099"/> <arg value="--shutdown"/> + <arg value="-u"/> + <arg value="${jboss.jmx.username}"/> + <arg value="-p"/> + <arg value="${jboss.jmx.password}"/> </java> <waitfor maxwait="300" maxwaitunit="second"> <not> Modified: branches/community/Seam_2_2/src/test/ftest/ftest.ci.properties =================================================================== --- branches/community/Seam_2_2/src/test/ftest/ftest.ci.properties 2009-08-21 00:43:34 UTC (rev 11414) +++ branches/community/Seam_2_2/src/test/ftest/ftest.ci.properties 2009-08-21 08:45:14 UTC (rev 11415) @@ -55,6 +55,10 @@ run.container.per.suite=true jboss.deployments.restart=10 +# ${JBOSS_HOME}/server/${jboss.profile}/conf/props/jmx-console-users.properties +jboss.jmx.username=admin +jboss.jmx.password=admin + # seam-gen specific properties seamgen.delete.project=true Modified: branches/community/Seam_2_2/src/test/ftest/ftest.properties =================================================================== --- branches/community/Seam_2_2/src/test/ftest/ftest.properties 2009-08-21 00:43:34 UTC (rev 11414) +++ branches/community/Seam_2_2/src/test/ftest/ftest.properties 2009-08-21 08:45:14 UTC (rev 11415) @@ -68,6 +68,10 @@ run.container.per.suite=false jboss.deployments.restart=10 +# These credentials are needed for JBoss restart. See ${JBOSS_HOME}/server/${jboss.profile}/conf/props/jmx-console-users.properties +jboss.jmx.username=admin +jboss.jmx.password=admin + # seam-gen specific properties #seamgen.delete.project=true

15 years, 4 months

1
0
0 / 0

Seam SVN: r11414 - branches/community/Seam_2_2/build.

by seam-commits＠lists.jboss.org

Author: denis.forveille Date: 2009-08-20 20:43:34 -0400 (Thu, 20 Aug 2009) New Revision: 11414 Modified: branches/community/Seam_2_2/build/default.build.properties Log: Updated to v2.2.1-SNAPSHOT Modified: branches/community/Seam_2_2/build/default.build.properties =================================================================== --- branches/community/Seam_2_2/build/default.build.properties 2009-08-21 00:42:11 UTC (rev 11413) +++ branches/community/Seam_2_2/build/default.build.properties 2009-08-21 00:43:34 UTC (rev 11414) @@ -7,7 +7,7 @@ # ------------ major.version 2 minor.version .2 -patchlevel .0 +patchlevel .1 qualifier -SNAPSHOT # # Other program locations

15 years, 4 months

1
0
0 / 0

Seam SVN: r11413 - branches/community/Seam_2_2/doc/Seam_Reference_Guide/en-US.

by seam-commits＠lists.jboss.org

Author: denis.forveille Date: 2009-08-20 20:42:11 -0400 (Thu, 20 Aug 2009) New Revision: 11413 Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/en-US/Websphere.xml Log: JBSEAM-4324 Removed unusable section on seam-gen for WAS Modified: branches/community/Seam_2_2/doc/Seam_Reference_Guide/en-US/Websphere.xml =================================================================== --- branches/community/Seam_2_2/doc/Seam_Reference_Guide/en-US/Websphere.xml 2009-08-21 00:18:43 UTC (rev 11412) +++ branches/community/Seam_2_2/doc/Seam_Reference_Guide/en-US/Websphere.xml 2009-08-21 00:42:11 UTC (rev 11413) @@ -605,591 +605,4 @@ </section> </section> - - <section> - <title>Deploying an application created using <literal>seam-gen</literal> on WebSphere V7</title> - - <para> - <literal>seam-gen</literal> - is a very useful tool for developers - to quickly get an application up and running, and provides a foundation - to add your own functionality. Out of box - <literal>seam-gen</literal> - will produce applications configured to run on JBoss AS. These - instructions will show the steps needed to get it to run on - WebSphere. This section will take you through the exact steps. - </para> - - <section> - <title>Running <literal>seam-gen</literal> Setup </title> - <para> - The first step is setting up - <literal>seam-gen</literal> - to - construct the base project. There are several choices made below, - specifically the datasource and hibernate values that we will adjust - once the project is created. - </para> - - - <programlisting><![CDATA[ -./seam setup -Buildfile: build.xml - -init: - -setup: - [echo] Welcome to seam-gen :-) - [input] Enter your Java project workspace (the directory that contains your -Seam projects) [C:/Projects] [C:/Projects] -/home/jbalunas/workspace - [input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3.GA] -[C:/Program Files/jboss-4.2.3.GA] -/home/jbalunas/jboss/jboss-4.2.3.GA - [input] Enter the project name [myproject] [myproject] -websphere_example - [echo] Accepted project name as: websphere_example - [input] Do you want to use ICEFaces instead of RichFaces [n] (y, [n], ) - - [input] skipping input as property icefaces.home.new has already been set. - [input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, wine, -deepMarine, emeraldTown, sakura, DEFAULT) - - [input] Is this project deployed as an EAR (with EJB components) or a WAR -(with no EJB support) [ear] ([ear], war, ) - - [input] Enter the Java package name for your session beans [org.jboss.seam. -tutorial.websphere.action] [org.jboss.seam.tutorial.websphere.action] -org.jboss.seam.tutorial.websphere.action - [input] Enter the Java package name for your entity beans [org.jboss.seam. -tutorial.websphere.model] [org.jboss.seam.tutorial.websphere.model] -org.jboss.seam.tutorial.websphere.model - [input] Enter the Java package name for your test cases [org.jboss.seam. -tutorial.websphere.action.test] [org.jboss.seam.tutorial.websphere.action.test] -org.jboss.seam.tutorial.websphere.test - [input] What kind of database are you using? [hsql] ([hsql], mysql, oracle, - postgres, mssql, db2, sybase, enterprisedb, h2) - - [input] Enter the Hibernate dialect for your database [org.hibernate. -dialect.HSQLDialect] [org.hibernate.dialect.HSQLDialect] - - [input] Enter the filesystem path to the JDBC driver jar [/tmp/seam/lib/hsqldb.jar] -[/tmp/seam/lib/hsqldb.jar] - - [input] Enter JDBC driver class for your database [org.hsqldb.jdbcDriver] -[org.hsqldb.jdbcDriver] - - [input] Enter the JDBC URL for your database [jdbc:hsqldb:.] -[jdbc:hsqldb:.] - - [input] Enter database username [sa] [sa] - - [input] Enter database password [] [] - - [input] Enter the database schema name (it is OK to leave this blank) [] [] - - [input] Enter the database catalog name (it is OK to leave this blank) [] [] - - [input] Are you working with tables that already exist in the database? [n] - (y, [n], ) - - [input] Do you want to drop and recreate the database tables and data in -import.sql each time you deploy? [n] (y, [n], ) - -[propertyfile] Creating new property file: -/rhdev/projects/jboss-seam/svn-seam_2_2/jboss-seam-2_2/seam-gen/build.properties - [echo] Installing JDBC driver jar to JBoss server - [copy] Copying 1 file to /home/jbalunas/jboss/jboss-4.2.3.GA/server/default/lib - [echo] Type 'seam create-project' to create the new project - -BUILD SUCCESSFUL -Total time: 3 minutes 5 seconds]]></programlisting> - - <para> - Type - <literal>./seam new-project</literal> - to create your - project and - <literal>cd - /home/jbalunas/workspace/websphere_example</literal> - to the - newly created structure. - </para> - - </section> - <section> - <title>Changes needed for deployment to Websphere</title> - <para>We now need to make some changes to the generated project. - </para> - <section> - <title>Configuration file changes</title> - <variablelist> - <varlistentry> - <term> - <literal>resources/META-INF/persistence-dev.xml - </literal> - </term> - <listitem> - <itemizedlist> - <listitem> - <para> - Alter the - <literal>jta-data-source</literal> - to be - <literal>DefaultDatasource</literal> - . We are - going to be using the integrated Websphere - DB. - </para> - </listitem> - <listitem> - <para> - Add or change the properties below. - These are described in detail at - <xref linkend="jee5-websphere-section" /> - : - </para> - - <programlisting role="XML"><![CDATA[ -<property name="hibernate.dialect" value="GlassfishDerbyDialect"/> -<property name="hibernate.hbm2ddl.auto" value="update"/> -<property name="hibernate.show_sql" value="true"/> -<property name="hibernate.format_sql" value="true"/> -<property name="hibernate.cache.provider_class" - value="org.hibernate.cache.HashtableCacheProvider"/> -<property name="hibernate.transaction.manager_lookup_class" - value="org.hibernate.transaction.WebSphereExtendedJTATransactionLookup"/>]]></programlisting> - </listitem> - <listitem> - <para> Remove the JBoss AS specific method of exposing - the EntityManagerFactory: </para> - - <programlisting role="XML"><![CDATA[<property - name="jboss.entity.manager.factory.jndi.name" - value="java:/websphere_exampleEntityManagerFactory">]]></programlisting> - </listitem> - <listitem> - <para> - You'll need to alter - <literal>persistence-prod.xml</literal> - as - well if you want to deploy to Websphere using the - prod profile. - </para> - </listitem> - </itemizedlist> - </listitem> - </varlistentry> - <varlistentry> - <term> - <literal>src/GlassfishDerbyDialect.java - </literal> - </term> - <listitem> - <para> - As with other examples we need to include this java class for - DB support. It can be copied from the - <literal>jpa</literal> - example into the - <literal>websphere_example/src</literal> - directory. - - <programlisting><![CDATA[ -cp $SEAM/examples/jpa/src/GlassfishDerbyDialect.java - ./src]]></programlisting> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> - <literal>resources/META-INF/jboss-app.xml - </literal> - </term> - <listitem> - <para> - You can delete this file as we aren't deploying to JBoss - AS ( - <literal>jboss-app.xml</literal> - is used to enable - classloading isolation in JBoss AS) - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> - <literal>resources/*-ds.xml</literal> - </term> - <listitem> - <para> You can delete these file as we aren't deploying to - JBoss AS (these files define datasources in JBoss AS, we - are using Websphere's default datasource) </para> - </listitem> - </varlistentry> - <varlistentry> - <term> - <literal>resources/WEB-INF/components.xml - </literal> - </term> - <listitem> - <itemizedlist> - <listitem> - <para> - Enable container managed transaction - integration - add the - <literal> - <transaction:ejb-transaction /> </literal> - component, and it's namespace - declaration - <literal> - xmlns:transaction="http://jboss.com/products/seam/transaction" - </literal> - </para> - </listitem> - <listitem> - <para> - Alter the - <literal>jndi-pattern</literal> - to - <literal> - java:comp/env/websphere_example/#{ejbName} - </literal> - </para> - </listitem> - <listitem> - <para> - We do not need - <literal>managed-persistence-context - </literal> - for this example and so can delete its - entry. - </para> - - - <programlisting role="XML"><![CDATA[ -<persistence:managed-persistence-context name="entityManager" - auto-create="true" - persistence-unit-jndi-name="java:/websphere_exampleEntityManagerFactory"/> ]]></programlisting> - </listitem> - </itemizedlist> - </listitem> - </varlistentry> - <varlistentry> - <term> - <literal>resources/WEB-INF/web.xml - </literal> - </term> - <listitem> - <para> - As with the - <literal>jee5/booking</literal> - example we need to add EJB references to the web.xml. These - references require replacing /local string in - <literal>ejb-ref-name</literal> - to flag them for - Websphere to perform the proper binding. - </para> - - - <programlisting role="XML"><![CDATA[ - <ejb-local-ref> - <ejb-ref-name>websphere_example/AuthenticatorAction</ejb-ref-name> - <ejb-ref-type>Session</ejb-ref-type> - <local>org.jboss.seam.tutorial.websphere.action.Authenticator</local> - </ejb-local-ref> - - <ejb-local-ref> - <ejb-ref-name>websphere_example/EjbSynchronizations</ejb-ref-name> - <ejb-ref-type>Session</ejb-ref-type> - <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local> - </ejb-local-ref>]]></programlisting> - </listitem> - </varlistentry> - </variablelist> - </section> - <section> - <title> - Creating the - <literal>AuthenticatorAction</literal> - EJB - </title> - <para> - We want to take the existing - <literal>Authenticator</literal> - Seam POJO component and create an EJB3 out of it. - </para> - <orderedlist> - <listitem> - <para>Change the generated Authenticator class</para> - <itemizedlist> - <listitem> - <para> - Rename the class to - <literal>AuthenticatorAction</literal> - </para> - </listitem> - <listitem> - <para> - Add the - <literal>@Stateless</literal> - annotation to the new - <literal>AuthenticatorAction</literal> - class. - </para> - </listitem> - <listitem> - <para> - Create an interface called - <literal>Authenticator</literal> - which - <literal>AuthenticatorAction</literal> - implements (EJB3 requires session beans to have a - local interface). Annotate the interface with - <literal>@Local</literal> - , and add a single method - with same signature as the - <literal>authenticate</literal> - in - <literal>AuthenticatorAction</literal> - . - </para> - </listitem> - </itemizedlist> - - - <programlisting role="JAVA"><![CDATA[ -@Name("authenticator") @Stateless public class - AuthenticatorAction implements Authenticator {]]></programlisting> - - - <programlisting role="JAVA"><![CDATA[ -@Local public interface Authenticator { - public boolean authenticate(); -}]]></programlisting> - </listitem> - <listitem> - <para> - We've already added its reference to the - <literal>web.xml</literal> - file so are good to go. - </para> - </listitem> - </orderedlist> - </section> - <section> - <title> - Extra jar dependencies and other changes to the - <literal>build.xml</literal> - </title> - <para> - This application has similar requirements as the - <literal>jee5/booking</literal> - example. - </para> - - <itemizedlist> - <listitem> - <para> - Change the default target to - <literal>archive</literal> - (we aren't going to cover - automatic deployment to Websphere). - </para> - - - <programlisting role="XML"><![CDATA[ -<project name="websphere_example" default="archive" basedir=".">]]></programlisting> - - </listitem> - <listitem> - <para> - Websphere looks for the drools - <literal>/security.drl</literal> - file in the root of the - <literal>war</literal> - file instead of the root of the - <literal>websphere_example.jar</literal> - so we need - to have the - <literal>build.xml</literal> - move it to the - correct location at build time. The following must be added at - the top of the - <literal> <target name="war" - depends="compile" description="Build the distribution - .war file"> </literal> - target. - </para> - - <programlisting role="XML"><![CDATA[ -<copy todir="${war.dir}"> - <fileset dir="${basedir}/resources" > - <include name="*.drl" /> - </fileset> -</copy>]]></programlisting> - </listitem> - <listitem> - <para> - Now we need to get extra jars into the - <literal>build.xml</literal> - . Look for the - <literal><fileset dir="${basedir}"></literal> - section - of the task below. Add the new includes at the bottom of - the fileset. - </para> - - - <programlisting role="XML"><![CDATA[ -<target name="ear" description="Build the EAR"> - <copy todir="${ear.dir}"> - <fileset dir="${basedir}/resources"> - <include name="*jpdl.xml" /> - <include name="*hibernate.cfg.xml" /> - <include name="jbpm.cfg.xml" /> - </fileset> - - <fileset dir="${basedir}"> - <include name="lib/jbpm*.jar" /> - <include name="lib/jboss-el.jar" /> - <include name="lib/drools-*.jar"/> - <include name="lib/core.jar"/> - <include name="lib/janino*.jar"/> - <include name="lib/antlr-*.jar"/> - <include name="lib/mvel*.jar"/> - <include name="lib/richfaces-api*.jar" /> - </fileset> - </copy> - <copy todir="${ear.dir}/META-INF"> - <fileset dir="${basedir}/resources/META-INF"> - <include name="application.xml" /> - <include name="jboss-app.xml" /> - </fileset> - </copy> -</target>]]></programlisting> - <itemizedlist> - <listitem> - <para>Hibernate dependencies</para> - <programlisting role="XML"><![CDATA[ -  - <include name="lib/hibernate.jar"/> - <include name="lib/hibernate-commons-annotations.jar"/> - <include name="lib/hibernate-annotations.jar"/> - <include name="lib/hibernate-entitymanager.jar"/> - <include name="lib/hibernate-validator.jar"/> - <include name="lib/jboss-common-core.jar" />]]></programlisting> - </listitem> - <listitem> - <para> Third party dependencies.</para> - <programlisting role="XML"><![CDATA[ -  -  - <include name="lib/javassist.jar"/> - <include name="lib/dom4j.jar" /> - <include name="lib/concurrent.jar" /> - <include name="lib/cglib.jar"/> - <include name="lib/asm.jar"/> - <include name="lib/antlr.jar" /> - <include name="lib/commons-logging.jar" /> - <include name="lib/commons-collections.jar" />]]></programlisting> - </listitem> - <listitem> - <para> - <literal>jboss-seam.jar</literal> - - this is needed in - the - <literal>ear</literal> - base - directory. - </para> - <programlisting role="XML"><![CDATA[ -  - <include name="lib/jboss-seam.jar" />]]></programlisting> - </listitem> - </itemizedlist> - - <para>You should end up with something like:</para> - <programlisting role="XML"><![CDATA[<fileset dir="${basedir}"> - - <include name="lib/jbpm*.jar" /> - <include name="lib/jboss-el.jar" /> - <include name="lib/drools-*.jar"/> - <include name="lib/core.jar"/> - <include name="lib/janino*.jar"/> - <include name="lib/antlr-*.jar"/> - <include name="lib/mvel*.jar"/> - <include name="lib/richfaces-api*.jar" /> - -  - <include name="lib/hibernate.jar"/> - <include name="lib/hibernate-commons-annotations.jar"/> - <include name="lib/hibernate-annotations.jar"/> - <include name="lib/hibernate-entitymanager.jar"/> - <include name="lib/hibernate-validator.jar"/> - <include name="lib/jboss-common-core.jar" /> - -  - <include name="lib/javassist.jar"/> - <include name="lib/dom4j.jar" /> - <include name="lib/concurrent.jar" /> - <include name="lib/cglib.jar"/> - <include name="lib/asm.jar"/> - <include name="lib/antlr.jar" /> - <include name="lib/commons-logging.jar" /> - <include name="lib/commons-collections.jar" /> - -  - <include name="lib/jboss-seam.jar" /> - -</fileset>]]></programlisting> - - </listitem> - </itemizedlist> - - </section> - <section> - <title> Building and deploying the seam-gen'd application to - Websphere - </title> - - <itemizedlist> - <listitem> - <para> - Build your application by calling - <literal>ant</literal> - in the base directory of your - project (ex. - <literal>/home/jbalunas/workspace/websphere_example - </literal> - ). The target of the build will be - <literal>dist/websphere_example.ear - </literal> - . - </para> - </listitem> - - <listitem> - <para> - To deploy the application follow the instructions here : - <xref linkend="jee5-websphere-deploy" /> - but use references to - this project - <literal>websphere_example</literal> - instead of - <literal>jboss-seam-jee5</literal> - . - </para> - </listitem> - <listitem> - <para> - Checkout the app at: - <literal>http://localhost:9080/websphere_example/index.html - </literal> - </para> - </listitem> - </itemizedlist> - - </section> - </section> - </section> - </chapter>

15 years, 4 months

1
0
0 / 0

Seam SVN: r11412 - in branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam: drools and 1 other directory.

by seam-commits＠lists.jboss.org

Author: tsurdilovic Date: 2009-08-20 20:18:43 -0400 (Thu, 20 Aug 2009) New Revision: 11412 Added: branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools/WorkingMemoryEntryPoint.java Modified: branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools-2.2.xsd Log: Drools5 Integration CEP WM entry point. Added: branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools/WorkingMemoryEntryPoint.java =================================================================== --- branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools/WorkingMemoryEntryPoint.java (rev 0) +++ branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools/WorkingMemoryEntryPoint.java 2009-08-21 00:18:43 UTC (rev 11412) @@ -0,0 +1,53 @@ +package org.jboss.seam.drools; + +import org.jboss.seam.ScopeType; +import org.jboss.seam.annotations.Scope; +import org.jboss.seam.annotations.Unwrap; +import org.jboss.seam.annotations.intercept.BypassInterceptors; +import org.jboss.seam.core.Expressions.ValueExpression; +import org.jboss.seam.log.LogProvider; +import org.jboss.seam.log.Logging; + +/** + * A conversation-scoped Drools WorkingMemoryEntryPoint for a named StatefulKnowledgeSession + * + * @author Tihomir Surdilovic + * + */ +(a)Scope(ScopeType.CONVERSATION) +@BypassInterceptors +public class WorkingMemoryEntryPoint +{ + private static final LogProvider log = Logging.getLogProvider(WorkingMemoryEntryPoint.class); + + private ValueExpression<org.drools.runtime.StatefulKnowledgeSession> ksession; + private String entryPointName; + + @Unwrap + public org.drools.runtime.rule.WorkingMemoryEntryPoint getEntryPoint() throws Exception + { + if(ksession != null) { + log.info("Getting entry point: " + entryPointName); + return ksession.getValue().getWorkingMemoryEntryPoint(entryPointName); + } else { + throw new IllegalAccessException("Knowledge Session is null"); + } + } + + public ValueExpression<org.drools.runtime.StatefulKnowledgeSession> getKsession() + { + return ksession; + } + public void setKsession(ValueExpression<org.drools.runtime.StatefulKnowledgeSession> ksession) + { + this.ksession = ksession; + } + public String getEntryPointName() + { + return entryPointName; + } + public void setEntryPointName(String entryPointName) + { + this.entryPointName = entryPointName; + } +} Modified: branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools-2.2.xsd =================================================================== --- branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools-2.2.xsd 2009-08-20 17:16:26 UTC (rev 11411) +++ branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools-2.2.xsd 2009-08-21 00:18:43 UTC (rev 11412) @@ -131,6 +131,20 @@ </xs:attributeGroup> <xs:element name="change-sets" type="components:multiValuedProperty" /> + <xs:element name="Working-memory-entry-point"> + <xs:annotation> + <xs:documentation>WorkingMemory Entry Point Component</xs:documentation> + </xs:annotation> + <xs:complexType mixed="true"> + <xs:attributeGroup ref="components:attlist.component" /> + <xs:attributeGroup ref="drools:attlist.WorkingMemoryEntryPoint" /> + </xs:complexType> + </xs:element> + <xs:attributeGroup name="attlist.WorkingMemoryEntryPoint"> + <xs:attribute name="ksession" type="components:expressionType" /> + <xs:attribute name="entry-point-name" type="components:expressionType" /> + </xs:attributeGroup> + <xs:element name="batch-execution"> <xs:annotation> <xs:documentation>Batch Execution Component</xs:documentation>

15 years, 4 months

1
0
0 / 0

Seam SVN: r11411 - in branches/community/Seam_2_2_Drools5: src/main/org/jboss/seam and 1 other directories.

by seam-commits＠lists.jboss.org

Author: tsurdilovic Date: 2009-08-20 13:16:26 -0400 (Thu, 20 Aug 2009) New Revision: 11411 Modified: branches/community/Seam_2_2_Drools5/examples/drools/resources/WEB-INF/components.xml branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools-2.2.xsd branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools/StatefulKnowledgeSession.java Log: Drools5 Integration. Modified: branches/community/Seam_2_2_Drools5/examples/drools/resources/WEB-INF/components.xml =================================================================== --- branches/community/Seam_2_2_Drools5/examples/drools/resources/WEB-INF/components.xml 2009-08-20 16:40:30 UTC (rev 11410) +++ branches/community/Seam_2_2_Drools5/examples/drools/resources/WEB-INF/components.xml 2009-08-20 17:16:26 UTC (rev 11411) @@ -25,7 +25,8 @@ </drools:change-sets> </drools:knowledge-agent> - <drools:stateful-knowledge-session name="ksession" knowledge-base="#{kbase}" knowledge-session-config="ksessionconfig.properties"> + <drools:stateful-knowledge-session name="ksession" knowledge-base="#{kbase}" knowledge-session-config="ksessionconfig.properties" + audit-log="/home/tsurdilo/Desktop/ksession"> <drools:event-listeners> <value>org.drools.event.rule.DebugAgendaEventListener</value> <value>org.drools.event.rule.DebugWorkingMemoryEventListener</value> @@ -41,7 +42,8 @@ <drools:stateful-knowledge-session name="ksession2" knowledge-base="#{kbase2}" - knowledge-session-config="ksessionconfig.properties"> + knowledge-session-config="ksessionconfig.properties" + audit-log="/home/tsurdilo/Desktop/ksession2"> <drools:event-listeners> <value>org.drools.event.rule.DebugAgendaEventListener</value> <value>org.drools.event.rule.DebugWorkingMemoryEventListener</value> @@ -60,7 +62,8 @@ <drools:stateful-knowledge-session name="ksession3" knowledge-base="#{kbase3}" knowledge-session-config="ksessionconfig.properties" - fact-provider="#{testFactProvider}"> + fact-provider="#{testFactProvider}" + audit-log="/home/tsurdilo/Desktop/ksession3"> <drools:event-listeners> <value>org.drools.event.rule.DebugAgendaEventListener</value> <value>org.drools.event.rule.DebugWorkingMemoryEventListener</value> @@ -79,7 +82,8 @@ auto-create="true" knowledge-base="#{kbase4}" knowledge-session-config="ksessionconfig.properties" - fact-provider="#{testTemplateFactProvider}"> + fact-provider="#{testTemplateFactProvider}" + audit-log="/home/tsurdilo/Desktop/ksession4"> <drools:event-listeners> <value>org.drools.event.rule.DebugAgendaEventListener</value> <value>org.drools.event.rule.DebugWorkingMemoryEventListener</value> Modified: branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools/StatefulKnowledgeSession.java =================================================================== --- branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools/StatefulKnowledgeSession.java 2009-08-20 16:40:30 UTC (rev 11410) +++ branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools/StatefulKnowledgeSession.java 2009-08-20 17:16:26 UTC (rev 11411) @@ -90,6 +90,8 @@ } if(auditLog != null) { + auditLog+=System.currentTimeMillis(); + log.info("Setting auding log: " + auditLog); krLogger = KnowledgeRuntimeLoggerFactory.newFileLogger(ksession, auditLog); } } @@ -186,10 +188,5 @@ public void setAuditLog(String auditLog) { this.auditLog = auditLog; - } - - - - - + } } Modified: branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools-2.2.xsd =================================================================== --- branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools-2.2.xsd 2009-08-20 16:40:30 UTC (rev 11410) +++ branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools-2.2.xsd 2009-08-20 17:16:26 UTC (rev 11411) @@ -103,7 +103,7 @@ <xs:attribute name="event-listeners" type="components:string" /> <xs:attribute name="knowledge-session-config" type="components:string" /> <xs:attribute name="fact-provider" type="components:expressionType"/> - <xs:attribute name="audit-log" type="components:string"> + <xs:attribute name="audit-log" type="components:string"/> </xs:attributeGroup> <xs:element name="globals" type="components:multiValuedProperty" />

15 years, 4 months

1
0
0 / 0

Seam SVN: r11410 - in branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam: drools and 1 other directory.

by seam-commits＠lists.jboss.org

Author: tsurdilovic Date: 2009-08-20 12:40:30 -0400 (Thu, 20 Aug 2009) New Revision: 11410 Modified: branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools-2.2.xsd branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools/StatefulKnowledgeSession.java Log: Drools5 integration. Modified: branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools/StatefulKnowledgeSession.java =================================================================== --- branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools/StatefulKnowledgeSession.java 2009-08-20 14:41:07 UTC (rev 11409) +++ branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools/StatefulKnowledgeSession.java 2009-08-20 16:40:30 UTC (rev 11410) @@ -6,6 +6,8 @@ import java.util.Properties; import org.drools.KnowledgeBaseFactory; +import org.drools.logger.KnowledgeRuntimeLogger; +import org.drools.logger.KnowledgeRuntimeLoggerFactory; import org.drools.runtime.KnowledgeSessionConfiguration; import org.drools.spi.GlobalResolver; import org.drools.event.process.ProcessEventListener; @@ -38,12 +40,14 @@ private ValueExpression<org.jboss.seam.drools.FactProvider> factProvider; private String[] eventListeners; private String knowledgeSessionConfig; + private String auditLog; private org.drools.runtime.StatefulKnowledgeSession ksession; + private KnowledgeRuntimeLogger krLogger; @Unwrap public org.drools.runtime.StatefulKnowledgeSession getStatefulKnowledgeSession() throws Exception { - if(ksession == null) { + if(ksession == null) { KnowledgeSessionConfiguration ksessionconfig; if(knowledgeSessionConfig != null) { Properties ksessionProp = new Properties(); @@ -84,6 +88,10 @@ setEventListener(ksession, eventListener); } } + + if(auditLog != null) { + krLogger = KnowledgeRuntimeLoggerFactory.newFileLogger(ksession, auditLog); + } } return ksession; @@ -121,6 +129,10 @@ @Destroy public void destroy() { + if(krLogger != null) { + krLogger.close(); + } + if(ksession != null) { ksession.dispose(); } @@ -165,5 +177,19 @@ { this.factProvider = factProvider; } + + public String getAuditLog() + { + return auditLog; + } + + public void setAuditLog(String auditLog) + { + this.auditLog = auditLog; + } + + + + } Modified: branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools-2.2.xsd =================================================================== --- branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools-2.2.xsd 2009-08-20 14:41:07 UTC (rev 11409) +++ branches/community/Seam_2_2_Drools5/src/main/org/jboss/seam/drools-2.2.xsd 2009-08-20 16:40:30 UTC (rev 11410) @@ -103,6 +103,7 @@ <xs:attribute name="event-listeners" type="components:string" /> <xs:attribute name="knowledge-session-config" type="components:string" /> <xs:attribute name="fact-provider" type="components:expressionType"/> + <xs:attribute name="audit-log" type="components:string"> </xs:attributeGroup> <xs:element name="globals" type="components:multiValuedProperty" />

15 years, 4 months

1
0
0 / 0

Seam SVN: r11409 - branches/enterprise/JBPAPP_5_0/build.

by seam-commits＠lists.jboss.org

Author: manaRH Date: 2009-08-20 10:41:07 -0400 (Thu, 20 Aug 2009) New Revision: 11409 Modified: branches/enterprise/JBPAPP_5_0/build/core.pom.xml branches/enterprise/JBPAPP_5_0/build/root.pom.xml Log: JBPAPP-2489 Modified: branches/enterprise/JBPAPP_5_0/build/core.pom.xml =================================================================== --- branches/enterprise/JBPAPP_5_0/build/core.pom.xml 2009-08-20 13:31:49 UTC (rev 11408) +++ branches/enterprise/JBPAPP_5_0/build/core.pom.xml 2009-08-20 14:41:07 UTC (rev 11409) @@ -284,12 +284,6 @@ <artifactId>jbpm-jpdl</artifactId> <optional>true</optional> </dependency> - - <dependency> - <groupId>org.beanshell</groupId> - <artifactId>bsh</artifactId> - <optional>true</optional> - </dependency> <dependency> <groupId>org.jboss.el</groupId> @@ -322,7 +316,7 @@ </dependency> <dependency> - <groupId>oswego-concurrent</groupId> + <groupId>concurrent</groupId> <artifactId>concurrent</artifactId> <optional>true</optional> </dependency> Modified: branches/enterprise/JBPAPP_5_0/build/root.pom.xml =================================================================== --- branches/enterprise/JBPAPP_5_0/build/root.pom.xml 2009-08-20 13:31:49 UTC (rev 11408) +++ branches/enterprise/JBPAPP_5_0/build/root.pom.xml 2009-08-20 14:41:07 UTC (rev 11409) @@ -283,7 +283,7 @@ <dependency> <groupId>org.jboss.cache</groupId> <artifactId>jbosscache-core</artifactId> - <version>3.1.0.GA</version> + <version>3.2.0.GA</version> <exclusions> <exclusion> <groupId>org.jboss</groupId> @@ -786,7 +786,7 @@ <dependency> <groupId>quartz</groupId> <artifactId>quartz</artifactId> - <version>1.5.2</version> + <version>1.5.2-brew</version> </dependency> <dependency> @@ -1032,14 +1032,7 @@ </exclusions> </dependency> - <dependency> - <groupId>org.beanshell</groupId> - <artifactId>bsh</artifactId> - <version>2.0b4</version> - </dependency> - - <dependency> <groupId>org.tuckey</groupId> <artifactId>urlrewritefilter</artifactId> <version>3.0.4</version> @@ -1116,7 +1109,7 @@ </dependency> <dependency> - <groupId>oswego-concurrent</groupId> + <groupId>concurrent</groupId> <artifactId>concurrent</artifactId> <version>1.3.4</version> </dependency>

15 years, 4 months

1
0
0 / 0

Seam SVN: r11408 - branches/enterprise/JBPAPP_5_0/build.

by seam-commits＠lists.jboss.org

Author: manaRH Date: 2009-08-20 09:31:49 -0400 (Thu, 20 Aug 2009) New Revision: 11408 Modified: branches/enterprise/JBPAPP_5_0/build/root.pom.xml Log: JBPAPP-2489 Modified: branches/enterprise/JBPAPP_5_0/build/root.pom.xml =================================================================== --- branches/enterprise/JBPAPP_5_0/build/root.pom.xml 2009-08-20 12:06:00 UTC (rev 11407) +++ branches/enterprise/JBPAPP_5_0/build/root.pom.xml 2009-08-20 13:31:49 UTC (rev 11408) @@ -34,6 +34,12 @@ <name>JBoss Snapshot Repository</name> <url>http://snapshots.jboss.org/maven2</url> </repository> + <repository> + <id>maven_eap5</id> + <name>EAP5 Central Repository</name> + <url>http://repository.jboss.org/maven2-brew</url> + </repository> +    @@ -216,13 +222,13 @@ <dependency> <groupId>javax.faces</groupId> <artifactId>jsf-api</artifactId> - <version>1.2_12</version> + <version>1.2_13</version> </dependency> <dependency> <groupId>javax.faces</groupId> <artifactId>jsf-impl</artifactId> - <version>1.2_12</version> + <version>1.2_13</version> <exclusions> <exclusion> <groupId>commons-collections</groupId> @@ -293,7 +299,7 @@ <dependency> <groupId>jgroups</groupId> <artifactId>jgroups</artifactId> - <version>2.6.11.GA</version> + <version>2.6.12.GA</version> </dependency> <dependency> @@ -541,7 +547,13 @@ <dependency> <groupId>javax.mail</groupId> <artifactId>mail</artifactId> - <version>1.4</version> + <version>1.4.2</version> + <exclusions> + <exclusion> + <groupId>javax.activation</groupId> + <artifactId>activation</artifactId> + </exclusion> + </exclusions> </dependency> <dependency>

15 years, 4 months

1
0
0 / 0

← Newer
1
2
3
4
5
6
7
8
...
13
Older →

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

seam-commits August 2009